snail-lang 0.3.6__tar.gz → 0.3.7__tar.gz

{snail_lang-0.3.6 → snail_lang-0.3.7}/Cargo.lock

@@ -485,11 +485,11 @@ checksum = "67b1b7a3b5fe4f1376887184045fcf45c69e92af734b7aaddc05fb777b6fbd03"
 
 [[package]]
 name = "snail-ast"
-version = "0.3.6"
+version = "0.3.7"
 
 [[package]]
 name = "snail-core"
-version = "0.3.6"
+version = "0.3.7"
 dependencies = [
  "pyo3",
  "snail-ast",
@@ -500,14 +500,14 @@ dependencies = [
 
 [[package]]
 name = "snail-error"
-version = "0.3.6"
+version = "0.3.7"
 dependencies = [
  "snail-ast",
 ]
 
 [[package]]
 name = "snail-lower"
-version = "0.3.6"
+version = "0.3.7"
 dependencies = [
  "pyo3",
  "snail-ast",
@@ -516,7 +516,7 @@ dependencies = [
 
 [[package]]
 name = "snail-parser"
-version = "0.3.6"
+version = "0.3.7"
 dependencies = [
  "pest",
  "pest_derive",
@@ -526,7 +526,7 @@ dependencies = [
 
 [[package]]
 name = "snail-proptest"
-version = "0.3.6"
+version = "0.3.7"
 dependencies = [
  "proptest",
  "pyo3",
@@ -540,7 +540,7 @@ dependencies = [
 
 [[package]]
 name = "snail-python"
-version = "0.3.6"
+version = "0.3.7"
 dependencies = [
  "pyo3",
  "snail-core",

{snail_lang-0.3.6 → snail_lang-0.3.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: snail-lang
-Version: 0.3.6
+Version: 0.3.7
 Requires-Dist: maturin>=1.5 ; extra == 'dev'
 Requires-Dist: pytest ; extra == 'dev'
 Provides-Extra: dev
@@ -64,7 +64,7 @@ The `?` operator makes error handling terse yet expressive:
 err = risky_operation()?
 
 # Provide a fallback value (exception available as $e)
-value = parse_json(data):{}?
+value = js(data):{}?
 details = fetch_url(url):"Error: {$e}"?
 
 # Access attributes directly
@@ -101,7 +101,7 @@ Built-in variables: `$l` (line), `$f` (fields), `$n` (line number), `$fn` (per-f
 
 ### Pipeline Operator
 
-The `|` operator enables data pipelining through objects that implement `__pipeline__`:
+The `|` operator enables data pipelining through pipeline-aware callables:
 
 ```snail
 # Pipe data to subprocess stdin
@@ -112,29 +112,37 @@ output = "foo\nbar" | $(grep foo) | $(wc -l)
 
 # Custom pipeline handlers
 class Doubler {
-    def __pipeline__(self, x) { return x * 2 }
+    def __call__(self, x) { return x * 2 }
 }
 doubled = 21 | Doubler()  # yields 42
 
-# Join list items with a separator
-joined = ["a", "b"] | join(" ")  # yields "a b"
+# Use placeholders to control where piped values land in calls
+greeting = "World" | greet("Hello ", _)  # greet("Hello ", "World")
+excited = "World" | greet(_, "!")        # greet("World", "!")
+formal = "World" | greet("Hello ", suffix=_)  # greet("Hello ", "World")
 ```
 
+When a pipeline targets a call expression, the left-hand value is passed to the
+resulting callable. If the call includes a single `_` placeholder, Snail substitutes
+the piped value at that position (including keyword arguments). Only one
+placeholder is allowed in a piped call. Outside of pipeline calls, `_` remains a
+normal identifier.
+
 ### JSON Queries with JMESPath
 
-Parse and query JSON data with the `json()` function and structured pipeline accessor:
+Parse and query JSON data with the `js()` function and structured pipeline accessor:
 
 ```snail
 # Parse JSON and query with $[jmespath]
-data = json($(curl -s api.example.com/users))
+data = js($(curl -s api.example.com/users))
 names = data | $[users[*].name]
 first_email = data | $[users[0].email]
 
 # Inline parsing and querying
-result = json('{"foo": 12}') | $[foo]
+result = js('{"foo": 12}') | $[foo]
 
 # JSONL parsing returns a list
-names = json('{"name": "Ada"}\n{"name": "Lin"}') | $[[*].name]
+names = js('{"name": "Ada"}\n{"name": "Lin"}') | $[[*].name]
 ```
 
 ### Full Python Interoperability

{snail_lang-0.3.6 → snail_lang-0.3.7}/README.md

@@ -53,7 +53,7 @@ The `?` operator makes error handling terse yet expressive:
 err = risky_operation()?
 
 # Provide a fallback value (exception available as $e)
-value = parse_json(data):{}?
+value = js(data):{}?
 details = fetch_url(url):"Error: {$e}"?
 
 # Access attributes directly
@@ -90,7 +90,7 @@ Built-in variables: `$l` (line), `$f` (fields), `$n` (line number), `$fn` (per-f
 
 ### Pipeline Operator
 
-The `|` operator enables data pipelining through objects that implement `__pipeline__`:
+The `|` operator enables data pipelining through pipeline-aware callables:
 
 ```snail
 # Pipe data to subprocess stdin
@@ -101,29 +101,37 @@ output = "foo\nbar" | $(grep foo) | $(wc -l)
 
 # Custom pipeline handlers
 class Doubler {
-    def __pipeline__(self, x) { return x * 2 }
+    def __call__(self, x) { return x * 2 }
 }
 doubled = 21 | Doubler()  # yields 42
 
-# Join list items with a separator
-joined = ["a", "b"] | join(" ")  # yields "a b"
+# Use placeholders to control where piped values land in calls
+greeting = "World" | greet("Hello ", _)  # greet("Hello ", "World")
+excited = "World" | greet(_, "!")        # greet("World", "!")
+formal = "World" | greet("Hello ", suffix=_)  # greet("Hello ", "World")
 ```
 
+When a pipeline targets a call expression, the left-hand value is passed to the
+resulting callable. If the call includes a single `_` placeholder, Snail substitutes
+the piped value at that position (including keyword arguments). Only one
+placeholder is allowed in a piped call. Outside of pipeline calls, `_` remains a
+normal identifier.
+
 ### JSON Queries with JMESPath
 
-Parse and query JSON data with the `json()` function and structured pipeline accessor:
+Parse and query JSON data with the `js()` function and structured pipeline accessor:
 
 ```snail
 # Parse JSON and query with $[jmespath]
-data = json($(curl -s api.example.com/users))
+data = js($(curl -s api.example.com/users))
 names = data | $[users[*].name]
 first_email = data | $[users[0].email]
 
 # Inline parsing and querying
-result = json('{"foo": 12}') | $[foo]
+result = js('{"foo": 12}') | $[foo]
 
 # JSONL parsing returns a list
-names = json('{"name": "Ada"}\n{"name": "Lin"}') | $[[*].name]
+names = js('{"name": "Ada"}\n{"name": "Lin"}') | $[[*].name]
 ```
 
 ### Full Python Interoperability

{snail_lang-0.3.6 → snail_lang-0.3.7}/crates/snail-ast/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "snail-ast"
-version = "0.3.6"
+version = "0.3.7"
 edition = "2024"
 readme = "README.md"
 

{snail_lang-0.3.6 → snail_lang-0.3.7}/crates/snail-ast/src/ast.rs

@@ -156,6 +156,9 @@ pub enum Expr {
         name: String,
         span: SourceSpan,
     },
+    Placeholder {
+        span: SourceSpan,
+    },
     Number {
         value: String,
         span: SourceSpan,

{snail_lang-0.3.6 → snail_lang-0.3.7}/crates/snail-core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "snail-core"
-version = "0.3.6"
+version = "0.3.7"
 edition.workspace = true
 readme = "README.md"
 

{snail_lang-0.3.6 → snail_lang-0.3.7}/crates/snail-error/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "snail-error"
-version = "0.3.6"
+version = "0.3.7"
 edition = "2024"
 readme = "README.md"
 

{snail_lang-0.3.6 → snail_lang-0.3.7}/crates/snail-error/src/lib.rs

@@ -42,21 +42,29 @@ impl fmt::Display for ParseError {
 impl Error for ParseError {}
 
 #[derive(Debug, Clone, PartialEq, Eq)]
-pub struct LowerError {
-    pub message: String,
+pub enum LowerError {
+    Message(String),
+    MultiplePlaceholders { span: SourceSpan },
 }
 
 impl LowerError {
     pub fn new(message: impl Into<String>) -> Self {
-        Self {
-            message: message.into(),
-        }
+        Self::Message(message.into())
+    }
+
+    pub fn multiple_placeholders(span: SourceSpan) -> Self {
+        Self::MultiplePlaceholders { span }
     }
 }
 
 impl fmt::Display for LowerError {
     fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
-        write!(f, "{}", self.message)
+        match self {
+            LowerError::Message(message) => write!(f, "{message}"),
+            LowerError::MultiplePlaceholders { .. } => {
+                write!(f, "pipeline calls may include at most one placeholder")
+            }
+        }
     }
 }
 
@@ -101,7 +109,7 @@ impl From<LowerError> for SnailError {
 pub fn format_snail_error(err: &SnailError, filename: &str) -> String {
     match err {
         SnailError::Parse(parse) => format_parse_error(parse, filename),
-        SnailError::Lower(lower) => format!("error: {}", lower.message),
+        SnailError::Lower(lower) => format!("error: {lower}"),
     }
 }
 

{snail_lang-0.3.6 → snail_lang-0.3.7}/crates/snail-lower/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "snail-lower"
-version = "0.3.6"
+version = "0.3.7"
 edition = "2024"
 readme = "README.md"
 

{snail_lang-0.3.6 → snail_lang-0.3.7}/crates/snail-lower/src/constants.rs

@@ -5,9 +5,8 @@ pub const SNAIL_SUBPROCESS_CAPTURE_CLASS: &str = "__SnailSubprocessCapture";
 pub const SNAIL_SUBPROCESS_STATUS_CLASS: &str = "__SnailSubprocessStatus";
 pub const SNAIL_REGEX_SEARCH: &str = "__snail_regex_search";
 pub const SNAIL_REGEX_COMPILE: &str = "__snail_regex_compile";
-pub const SNAIL_STRUCTURED_ACCESSOR_CLASS: &str = "__SnailStructuredAccessor";
-pub const SNAIL_JSON_OBJECT_CLASS: &str = "__SnailJsonObject";
-pub const SNAIL_JSON_PIPELINE_WRAPPER_CLASS: &str = "__SnailJsonPipelineWrapper";
+pub const SNAIL_JMESPATH_QUERY: &str = "__snail_jmespath_query";
+pub const SNAIL_PARTIAL_HELPER: &str = "__snail_partial";
 
 // Awk-related constants (public within crate)
 pub(crate) const SNAIL_AWK_LINE: &str = "$l";