snail-lang 0.5.3__tar.gz → 0.6.1__tar.gz

{snail_lang-0.5.3 → snail_lang-0.6.1}/Cargo.lock

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

{snail_lang-0.5.3 → snail_lang-0.6.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: snail-lang
-Version: 0.5.3
+Version: 0.6.1
 Requires-Dist: jmespath>=1.0.1
 Requires-Dist: maturin>=1.5 ; extra == 'dev'
 Requires-Dist: pytest ; extra == 'dev'
@@ -13,11 +13,10 @@ Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
 <p align="center">
   <img src="logo.png" alt="Snail logo" width="200">
 </p>
-<p align="center"><em>What do you get when you shove a snake in a shell?</em></p>
 
 <h1 align="center">Snail</h1>
 
-**Snail** is a programming language that compiles to Python, combining Python's familiarity and extensive libraries with Perl/awk-inspired syntax for quick scripts and one-liners.
+**Snail** is a programming language that compiles to Python, combining Python's familiarity and extensive libraries with Perl/awk-inspired syntax for quick scripts and one-liners. Its what you get when you shove a snake in a shell.
 
 ## AI Slop!
 
@@ -62,11 +61,43 @@ Process files line-by-line with familiar awk semantics:
 { print($1, "->", $2) }
 ```
 
-Built-in variables: `$0` (line), `$1`, `$2` etc (access fields), `$n` (line number), `$fn` (per-file line number), `$p` (file path), `$m` (last match).
+**Built-in variables:**
 
-Begin/end blocks use CLI flags for setup and teardown:
+| Variable | Description |
+|----------|-------------|
+| `$0` | Current line (with newline stripped) |
+| `$1`, `$2`, ... | Individual fields (whitespace-split) |
+| `$f` | All fields as a list |
+| `$n` | Global line number (across all files) |
+| `$fn` | Per-file line number |
+| `$p` | Current file path |
+| `$m` | Last regex match object |
+
+Begin/end blocks use CLI flags (`-b`/`--begin`, `-e`/`--end`) for setup and teardown:
+```bash
+echo -e "5\n4\n3\n2\n1" | snail --awk --begin 'total = 0' --end 'print("Sum:", total)' '/^[0-9]+/ { total = total + int($1) }'
+```
+
+### Map Mode
+
+Process files one at a time instead of line-by-line:
+
+```snail-map
+print("File:", $src)
+print("Size:", len($text), "bytes")
+```
+
+**Built-in variables:**
+
+| Variable | Description |
+|----------|-------------|
+| `$src` | Current file path |
+| `$fd` | Open file handle for the current file |
+| `$text` | Lazy text view of the current file contents |
+
+Begin/end blocks use CLI flags (`-b`/`--begin`, `-e`/`--end`) for setup and teardown:
 ```bash
-echo -e "5\n4\n3\n2\n1" | snail --awk -b 'total = 0' -e 'print("Sum:", total)' '/^[0-9]+/ { total = total + int($1) }'
+snail --map --begin "print('start')" --end "print('done')" "print($src)" *.txt
 ```
 
 ### Compact Error Handling
@@ -228,6 +259,7 @@ Documentation is WIP
 - **[Language Reference](docs/REFERENCE.md)** — Complete syntax and semantics
 - **[examples/all_syntax.snail](examples/all_syntax.snail)** — Every feature in one file
 - **[examples/awk.snail](examples/awk.snail)** — Awk mode examples
+- **[examples/map.snail](examples/map.snail)** — Map mode examples
 
 ## 🔌 Editor Support
 

{snail_lang-0.5.3 → snail_lang-0.6.1}/README.md

@@ -1,11 +1,10 @@
 <p align="center">
   <img src="logo.png" alt="Snail logo" width="200">
 </p>
-<p align="center"><em>What do you get when you shove a snake in a shell?</em></p>
 
 <h1 align="center">Snail</h1>
 
-**Snail** is a programming language that compiles to Python, combining Python's familiarity and extensive libraries with Perl/awk-inspired syntax for quick scripts and one-liners.
+**Snail** is a programming language that compiles to Python, combining Python's familiarity and extensive libraries with Perl/awk-inspired syntax for quick scripts and one-liners. Its what you get when you shove a snake in a shell.
 
 ## AI Slop!
 
@@ -50,11 +49,43 @@ Process files line-by-line with familiar awk semantics:
 { print($1, "->", $2) }
 ```
 
-Built-in variables: `$0` (line), `$1`, `$2` etc (access fields), `$n` (line number), `$fn` (per-file line number), `$p` (file path), `$m` (last match).
+**Built-in variables:**
 
-Begin/end blocks use CLI flags for setup and teardown:
+| Variable | Description |
+|----------|-------------|
+| `$0` | Current line (with newline stripped) |
+| `$1`, `$2`, ... | Individual fields (whitespace-split) |
+| `$f` | All fields as a list |
+| `$n` | Global line number (across all files) |
+| `$fn` | Per-file line number |
+| `$p` | Current file path |
+| `$m` | Last regex match object |
+
+Begin/end blocks use CLI flags (`-b`/`--begin`, `-e`/`--end`) for setup and teardown:
+```bash
+echo -e "5\n4\n3\n2\n1" | snail --awk --begin 'total = 0' --end 'print("Sum:", total)' '/^[0-9]+/ { total = total + int($1) }'
+```
+
+### Map Mode
+
+Process files one at a time instead of line-by-line:
+
+```snail-map
+print("File:", $src)
+print("Size:", len($text), "bytes")
+```
+
+**Built-in variables:**
+
+| Variable | Description |
+|----------|-------------|
+| `$src` | Current file path |
+| `$fd` | Open file handle for the current file |
+| `$text` | Lazy text view of the current file contents |
+
+Begin/end blocks use CLI flags (`-b`/`--begin`, `-e`/`--end`) for setup and teardown:
 ```bash
-echo -e "5\n4\n3\n2\n1" | snail --awk -b 'total = 0' -e 'print("Sum:", total)' '/^[0-9]+/ { total = total + int($1) }'
+snail --map --begin "print('start')" --end "print('done')" "print($src)" *.txt
 ```
 
 ### Compact Error Handling
@@ -216,6 +247,7 @@ Documentation is WIP
 - **[Language Reference](docs/REFERENCE.md)** — Complete syntax and semantics
 - **[examples/all_syntax.snail](examples/all_syntax.snail)** — Every feature in one file
 - **[examples/awk.snail](examples/awk.snail)** — Awk mode examples
+- **[examples/map.snail](examples/map.snail)** — Map mode examples
 
 ## 🔌 Editor Support
 

{snail_lang-0.5.3 → snail_lang-0.6.1}/crates/snail-ast/Cargo.toml

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

{snail_lang-0.5.3 → snail_lang-0.6.1}/crates/snail-ast/src/ast.rs

@@ -216,6 +216,22 @@ pub enum Expr {
         right: Box<Expr>,
         span: SourceSpan,
     },
+    AugAssign {
+        target: Box<AssignTarget>,
+        op: AugAssignOp,
+        value: Box<Expr>,
+        span: SourceSpan,
+    },
+    PrefixIncr {
+        op: IncrOp,
+        target: Box<AssignTarget>,
+        span: SourceSpan,
+    },
+    PostfixIncr {
+        op: IncrOp,
+        target: Box<AssignTarget>,
+        span: SourceSpan,
+    },
     Compare {
         left: Box<Expr>,
         ops: Vec<CompareOp>,
@@ -403,6 +419,23 @@ pub enum BinaryOp {
     Pipeline,
 }
 
+#[derive(Debug, Clone, Copy, PartialEq, Eq)]
+pub enum AugAssignOp {
+    Add,
+    Sub,
+    Mul,
+    Div,
+    FloorDiv,
+    Mod,
+    Pow,
+}
+
+#[derive(Debug, Clone, Copy, PartialEq, Eq)]
+pub enum IncrOp {
+    Increment,
+    Decrement,
+}
+
 #[derive(Debug, Clone, Copy, PartialEq, Eq)]
 pub enum CompareOp {
     Eq,

{snail_lang-0.5.3 → snail_lang-0.6.1}/crates/snail-ast/src/awk.rs

@@ -4,6 +4,7 @@ use crate::ast::{Expr, SourceSpan, Stmt};
 pub enum CompileMode {
     Snail,
     Awk,
+    Map,
 }
 
 #[derive(Debug, Clone, PartialEq)]

{snail_lang-0.5.3 → snail_lang-0.6.1}/crates/snail-core/Cargo.toml

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

{snail_lang-0.5.3 → snail_lang-0.6.1}/crates/snail-core/src/lib.rs

@@ -32,6 +32,11 @@ pub fn compile_snail_source_with_auto_print(
             let module = lower_awk_program_with_auto_print(py, &program, auto_print_last)?;
             Ok(module)
         }
+        CompileMode::Map => {
+            let program = parse_map_program(source)?;
+            let module = lower_map_program_with_auto_print(py, &program, auto_print_last)?;
+            Ok(module)
+        }
     }
 }
 
@@ -48,3 +53,37 @@ pub fn compile_awk_source_with_begin_end(
     let module = lower_awk_program_with_auto_print(py, &program, auto_print_last)?;
     Ok(module)
 }
+
+/// Compile a map program with separate begin and end code blocks.
+/// Each begin/end source is parsed as a map program.
+pub fn compile_map_source_with_begin_end(
+    py: Python<'_>,
+    main_source: &str,
+    begin_sources: &[&str],
+    end_sources: &[&str],
+    auto_print_last: bool,
+) -> Result<PyObject, SnailError> {
+    let program = parse_map_program(main_source)?;
+    let mut begin_blocks = Vec::new();
+    for source in begin_sources {
+        let begin_program = parse_map_program(source)?;
+        if !begin_program.stmts.is_empty() {
+            begin_blocks.push(begin_program.stmts);
+        }
+    }
+    let mut end_blocks = Vec::new();
+    for source in end_sources {
+        let end_program = parse_map_program(source)?;
+        if !end_program.stmts.is_empty() {
+            end_blocks.push(end_program.stmts);
+        }
+    }
+    let module = lower_map_program_with_begin_end(
+        py,
+        &program,
+        &begin_blocks,
+        &end_blocks,
+        auto_print_last,
+    )?;
+    Ok(module)
+}

{snail_lang-0.5.3 → snail_lang-0.6.1}/crates/snail-error/Cargo.toml

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

{snail_lang-0.5.3 → snail_lang-0.6.1}/crates/snail-lower/Cargo.toml

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

{snail_lang-0.5.3 → snail_lang-0.6.1}/crates/snail-lower/README.md

@@ -27,7 +27,7 @@ This crate is the semantic transformation core of the Snail compiler. It takes S
 - **Regex expressions** (`/pattern/`): Transformed into `__snail_regex_compile(pattern)` call
 - **Regex matching** (`string in /pattern/`): Transformed into `__snail_regex_search(string, pattern)` call
 - **Structured accessors** (`$[query]`): Transformed into `__SnailStructuredAccessor(query)` instance
-- **Awk variables**: `$0`, `$<num>`, `$n`, `$fn`, `$p`, `$m` mapped to Python variable names
+- **Awk variables**: `$0`, `$<num>`, `$n`, `$fn`, `$f`, `$p`, `$m` mapped to Python variable names
 
 ## Awk Mode Lowering
 

{snail_lang-0.5.3 → snail_lang-0.6.1}/crates/snail-lower/src/constants.rs

@@ -9,17 +9,23 @@ pub const SNAIL_JMESPATH_QUERY: &str = "__snail_jmespath_query";
 pub const SNAIL_PARTIAL_HELPER: &str = "__snail_partial";
 pub const SNAIL_CONTAINS_HELPER: &str = "__snail_contains__";
 pub const SNAIL_CONTAINS_NOT_HELPER: &str = "__snail_contains_not__";
+pub const SNAIL_INCR_ATTR: &str = "__snail_incr_attr";
+pub const SNAIL_INCR_INDEX: &str = "__snail_incr_index";
+pub const SNAIL_AUG_ATTR: &str = "__snail_aug_attr";
+pub const SNAIL_AUG_INDEX: &str = "__snail_aug_index";
 pub(crate) const SNAIL_LET_VALUE: &str = "__snail_let_value";
 pub(crate) const SNAIL_LET_OK: &str = "__snail_let_ok";
 pub(crate) const SNAIL_LET_KEEP: &str = "__snail_let_keep";
 pub(crate) const SNAIL_COMPARE_LEFT: &str = "__snail_compare_left";
 pub(crate) const SNAIL_COMPARE_RIGHT: &str = "__snail_compare_right";
+pub(crate) const SNAIL_INCR_TMP: &str = "__snail_incr_tmp";
 
 // Awk-related constants (public within crate)
 pub(crate) const SNAIL_AWK_NR: &str = "$n";
 pub(crate) const SNAIL_AWK_FNR: &str = "$fn";
 pub(crate) const SNAIL_AWK_PATH: &str = "$p";
 pub(crate) const SNAIL_AWK_MATCH: &str = "$m";
+pub(crate) const SNAIL_AWK_FIELDS: &str = "$f";
 pub(crate) const SNAIL_AWK_LINE_PYVAR: &str = "__snail_line";
 pub(crate) const SNAIL_AWK_FIELDS_PYVAR: &str = "__snail_fields";
 pub(crate) const SNAIL_AWK_NR_PYVAR: &str = "__snail_nr_user";
@@ -27,12 +33,27 @@ pub(crate) const SNAIL_AWK_FNR_PYVAR: &str = "__snail_fnr_user";
 pub(crate) const SNAIL_AWK_PATH_PYVAR: &str = "__snail_path_user";
 pub(crate) const SNAIL_AWK_MATCH_PYVAR: &str = "__snail_match";
 
+// Map-related constants (public within crate)
+pub(crate) const SNAIL_MAP_SRC: &str = "$src";
+pub(crate) const SNAIL_MAP_FD: &str = "$fd";
+pub(crate) const SNAIL_MAP_TEXT: &str = "$text";
+pub(crate) const SNAIL_MAP_SRC_PYVAR: &str = "__snail_src";
+pub(crate) const SNAIL_MAP_FD_PYVAR: &str = "__snail_fd";
+pub(crate) const SNAIL_MAP_TEXT_PYVAR: &str = "__snail_text";
+pub const SNAIL_LAZY_TEXT_CLASS: &str = "__SnailLazyText";
+
 pub(crate) fn injected_py_name(name: &str) -> Option<&'static str> {
     match name {
+        // Awk variables
         SNAIL_AWK_NR => Some(SNAIL_AWK_NR_PYVAR),
         SNAIL_AWK_FNR => Some(SNAIL_AWK_FNR_PYVAR),
         SNAIL_AWK_PATH => Some(SNAIL_AWK_PATH_PYVAR),
         SNAIL_AWK_MATCH => Some(SNAIL_AWK_MATCH_PYVAR),
+        SNAIL_AWK_FIELDS => Some(SNAIL_AWK_FIELDS_PYVAR),
+        // Map variables
+        SNAIL_MAP_SRC => Some(SNAIL_MAP_SRC_PYVAR),
+        SNAIL_MAP_FD => Some(SNAIL_MAP_FD_PYVAR),
+        SNAIL_MAP_TEXT => Some(SNAIL_MAP_TEXT_PYVAR),
         _ => None,
     }
 }