snail-lang 0.3.9__tar.gz → 0.4.0__tar.gz

{snail_lang-0.3.9 → snail_lang-0.4.0}/Cargo.lock

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

{snail_lang-0.3.9 → snail_lang-0.4.0}/PKG-INFO

@@ -1,6 +1,7 @@
 Metadata-Version: 2.4
 Name: snail-lang
-Version: 0.3.9
+Version: 0.4.0
+Requires-Dist: jmespath>=1.0.1
 Requires-Dist: maturin>=1.5 ; extra == 'dev'
 Requires-Dist: pytest ; extra == 'dev'
 Provides-Extra: dev
@@ -12,17 +13,11 @@ Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
 <p align="center">
   <img src="logo.png" alt="Snail logo" width="200">
 </p>
-
-<h1 align="center">Snail</h1>
 <p align="center"><em>What do you get when you shove a snake in a shell?</em></p>
 
-<h1>Snail, while I hope it is useful to myself and others, is my attempt at
-improving my knowledge of AI code developement. Things are probably broken
-in interesting and horrible ways.</h1>
-
----
+<h1 align="center">Snail</h1>
 
-**Snail** is a programming language that compiles to Python, combining Python's power with Perl/awk-inspired syntax for quick scripts and one-liners. No more whitespace sensitivity—just curly braces and concise expressions.
+**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.
 
 ## Installing Snail
 
@@ -62,7 +57,7 @@ BEGIN { total = 0 }
 END { print("Sum:", total); assert total == 15}
 ```
 
-Built-in variables: `$l` (line), `$f` (fields), `$n` (line number), `$fn` (per-file line number), `$p` (file path), `$m` (last match).
+Built-in variables: `$0` (line), `$1`, `$2` etc (access fields), `$n` (line number), `$fn` (per-file line number), `$p` (file path), `$m` (last match).
 
 
 ### Compact Error Handling
@@ -192,7 +187,7 @@ snail 'result = int("oops"):"bad int {$e}"?; print(result)'
 snail 'm = "user@example.com" in /^[\\w.]+@([\\w.]+)$/; if m { print(m[1]) }'
 
 # Awk mode: print line numbers for matches
-rg -n "TODO" README.md | snail --awk '/TODO/ { print("{$n}: {$l}") }'
+rg -n "TODO" README.md | snail --awk '/TODO/ { print("{$n}: {$0}") }'
 ```
 
 ## 🏗️ Architecture
@@ -239,8 +234,6 @@ Installation per platform:
 - **macOS**: `brew install python@3.12` (or use the system Python 3)
 - **Windows**: Download from [python.org](https://www.python.org/downloads/)
 
-**No Python packages required**: Snail vendors jmespath under `snail.vendor`.
-
 ### Build, Test, and Install
 
 ```bash

{snail_lang-0.3.9 → snail_lang-0.4.0}/README.md

@@ -1,17 +1,11 @@
 <p align="center">
   <img src="logo.png" alt="Snail logo" width="200">
 </p>
-
-<h1 align="center">Snail</h1>
 <p align="center"><em>What do you get when you shove a snake in a shell?</em></p>
 
-<h1>Snail, while I hope it is useful to myself and others, is my attempt at
-improving my knowledge of AI code developement. Things are probably broken
-in interesting and horrible ways.</h1>
-
----
+<h1 align="center">Snail</h1>
 
-**Snail** is a programming language that compiles to Python, combining Python's power with Perl/awk-inspired syntax for quick scripts and one-liners. No more whitespace sensitivity—just curly braces and concise expressions.
+**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.
 
 ## Installing Snail
 
@@ -51,7 +45,7 @@ BEGIN { total = 0 }
 END { print("Sum:", total); assert total == 15}
 ```
 
-Built-in variables: `$l` (line), `$f` (fields), `$n` (line number), `$fn` (per-file line number), `$p` (file path), `$m` (last match).
+Built-in variables: `$0` (line), `$1`, `$2` etc (access fields), `$n` (line number), `$fn` (per-file line number), `$p` (file path), `$m` (last match).
 
 
 ### Compact Error Handling
@@ -181,7 +175,7 @@ snail 'result = int("oops"):"bad int {$e}"?; print(result)'
 snail 'm = "user@example.com" in /^[\\w.]+@([\\w.]+)$/; if m { print(m[1]) }'
 
 # Awk mode: print line numbers for matches
-rg -n "TODO" README.md | snail --awk '/TODO/ { print("{$n}: {$l}") }'
+rg -n "TODO" README.md | snail --awk '/TODO/ { print("{$n}: {$0}") }'
 ```
 
 ## 🏗️ Architecture
@@ -228,8 +222,6 @@ Installation per platform:
 - **macOS**: `brew install python@3.12` (or use the system Python 3)
 - **Windows**: Download from [python.org](https://www.python.org/downloads/)
 
-**No Python packages required**: Snail vendors jmespath under `snail.vendor`.
-
 ### Build, Test, and Install
 
 ```bash

{snail_lang-0.3.9 → snail_lang-0.4.0}/crates/snail-ast/Cargo.toml

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

{snail_lang-0.3.9 → snail_lang-0.4.0}/crates/snail-core/Cargo.toml

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

{snail_lang-0.3.9 → snail_lang-0.4.0}/crates/snail-error/Cargo.toml

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

{snail_lang-0.3.9 → snail_lang-0.4.0}/crates/snail-lower/Cargo.toml

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

{snail_lang-0.3.9 → snail_lang-0.4.0}/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**: `$l`, `$f`, `$n`, `$fn`, `$p`, `$m` mapped to Python variable names
+- **Awk variables**: `$0`, `$<num>`, `$n`, `$fn`, `$p`, `$m` mapped to Python variable names
 
 ## Awk Mode Lowering
 
@@ -35,7 +35,7 @@ When lowering awk programs, generates a complete Python AST that:
 1. Imports `sys` for accessing command-line arguments and stdin
 2. Executes BEGIN blocks before processing input
 3. Creates a main loop that reads lines from files or stdin
-4. Updates awk variables (`$l`, `$f`, `$n`, etc.) for each line
+4. Updates awk variables (`$0`, `$<num>`, `$n`, etc.) for each line
 5. Evaluates patterns and executes actions for matching lines
 6. Executes END blocks after all input is processed
 

{snail_lang-0.3.9 → snail_lang-0.4.0}/crates/snail-lower/src/awk.rs

@@ -427,8 +427,8 @@ fn regex_pattern_components(pattern: &Expr) -> Option<(Expr, RegexPattern, Sourc
             span,
         } => Some((*value.clone(), pattern.clone(), span.clone())),
         Expr::Regex { pattern, span } => Some((
-            Expr::Name {
-                name: SNAIL_AWK_LINE.to_string(),
+            Expr::FieldIndex {
+                index: "0".to_string(),
                 span: span.clone(),
             },
             pattern.clone(),

{snail_lang-0.3.9 → snail_lang-0.4.0}/crates/snail-lower/src/constants.rs

@@ -9,8 +9,6 @@ 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";
-pub(crate) const SNAIL_AWK_FIELDS: &str = "$f";
 pub(crate) const SNAIL_AWK_NR: &str = "$n";
 pub(crate) const SNAIL_AWK_FNR: &str = "$fn";
 pub(crate) const SNAIL_AWK_PATH: &str = "$p";
@@ -24,8 +22,6 @@ pub(crate) const SNAIL_AWK_MATCH_PYVAR: &str = "__snail_match";
 
 pub(crate) fn injected_py_name(name: &str) -> Option<&'static str> {
     match name {
-        SNAIL_AWK_LINE => Some(SNAIL_AWK_LINE_PYVAR),
-        SNAIL_AWK_FIELDS => Some(SNAIL_AWK_FIELDS_PYVAR),
         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_lang-0.3.9 → snail_lang-0.4.0}/crates/snail-parser/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "snail-parser"
-version = "0.3.9"
+version = "0.4.0"
 edition = "2024"
 readme = "README.md"
 

{snail_lang-0.3.9 → snail_lang-0.4.0}/crates/snail-parser/src/lib.rs

@@ -86,7 +86,7 @@ pub fn parse_awk_program(source: &str) -> Result<AwkProgram, ParseError> {
     })
 }
 
-const AWK_ONLY_NAMES: [&str; 6] = ["$l", "$f", "$n", "$fn", "$p", "$m"];
+const AWK_ONLY_NAMES: [&str; 4] = ["$n", "$fn", "$p", "$m"];
 const AWK_ONLY_MESSAGE: &str = "awk variables are only valid in awk mode; use --awk";
 
 fn validate_no_awk_syntax(program: &Program, source: &str) -> Result<(), ParseError> {

{snail_lang-0.3.9 → snail_lang-0.4.0}/crates/snail-parser/src/snail.pest

@@ -206,7 +206,7 @@ none = { "None" }
 // Special variables: exception, AWK fields, injected vars
 exception_var = { "$e" }
 field_index_var = @{ "$" ~ ASCII_DIGIT+ }
-injected_var = { "$fn" | "$l" | "$f" | "$n" | "$p" | "$m" }
+injected_var = { "$fn" | "$n" | "$p" | "$m" }
 
 // Number, string, and regex literals
 number = @{ ASCII_DIGIT+ ~ ("." ~ ASCII_DIGIT+)? }

{snail_lang-0.3.9 → snail_lang-0.4.0}/crates/snail-parser/tests/errors.rs

@@ -22,9 +22,9 @@ fn rejects_user_defined_dollar_identifiers() {
 
 #[test]
 fn rejects_awk_only_variables_in_regular_mode() {
-    let err = parse_err("value = $l");
+    let err = parse_err("value = $n");
     let message = err.to_string();
-    assert!(message.contains("$l"));
+    assert!(message.contains("$n"));
     assert!(message.contains("--awk"));
     expect_err_span(&err, 1, 9);
 }

{snail_lang-0.3.9 → snail_lang-0.4.0}/crates/snail-python/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "snail-python"
-version = "0.3.9"
+version = "0.4.0"
 edition.workspace = true
 
 [lib]

{snail_lang-0.3.9 → snail_lang-0.4.0}/pyproject.toml

@@ -4,11 +4,14 @@ build-backend = "maturin"
 
 [project]
 name = "snail-lang"
-version = "0.3.9"
+version = "0.4.0"
 description = "Snail programming language interpreter"
 readme = "README.md"
 requires-python = ">=3.10"
 license = { file = "LICENSE" }
+dependencies = [
+    "jmespath>=1.0.1",
+]
 
 [project.optional-dependencies]
 dev = [

{snail_lang-0.3.9 → snail_lang-0.4.0}/python/snail/runtime/structured_accessor.py

@@ -4,7 +4,7 @@ import json as _json
 import os as _os
 import sys as _sys
 
-from ..vendor import jmespath
+import jmespath
 
 
 def __snail_jmespath_query(query: str):

snail_lang-0.3.9/python/snail/vendor/jmespath/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2013 Amazon.com, Inc. or its affiliates.  All Rights Reserved
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

snail_lang-0.3.9/python/snail/vendor/jmespath/__init__.py

@@ -1,12 +0,0 @@
-from . import parser
-from .visitor import Options
-
-__version__ = "1.0.1"
-
-
-def compile(expression):
-    return parser.Parser().parse(expression)
-
-
-def search(expression, data, options=None):
-    return parser.Parser().parse(expression).search(data, options=options)

snail_lang-0.3.9/python/snail/vendor/jmespath/ast.py

@@ -1,90 +0,0 @@
-# AST nodes have this structure:
-# {"type": <node type>", children: [], "value": ""}
-
-
-def comparator(name, first, second):
-    return {'type': 'comparator', 'children': [first, second], 'value': name}
-
-
-def current_node():
-    return {'type': 'current', 'children': []}
-
-
-def expref(expression):
-    return {'type': 'expref', 'children': [expression]}
-
-
-def function_expression(name, args):
-    return {'type': 'function_expression', 'children': args, 'value': name}
-
-
-def field(name):
-    return {"type": "field", "children": [], "value": name}
-
-
-def filter_projection(left, right, comparator):
-    return {'type': 'filter_projection', 'children': [left, right, comparator]}
-
-
-def flatten(node):
-    return {'type': 'flatten', 'children': [node]}
-
-
-def identity():
-    return {"type": "identity", 'children': []}
-
-
-def index(index):
-    return {"type": "index", "value": index, "children": []}
-
-
-def index_expression(children):
-    return {"type": "index_expression", 'children': children}
-
-
-def key_val_pair(key_name, node):
-    return {"type": "key_val_pair", 'children': [node], "value": key_name}
-
-
-def literal(literal_value):
-    return {'type': 'literal', 'value': literal_value, 'children': []}
-
-
-def multi_select_dict(nodes):
-    return {"type": "multi_select_dict", "children": nodes}
-
-
-def multi_select_list(nodes):
-    return {"type": "multi_select_list", "children": nodes}
-
-
-def or_expression(left, right):
-    return {"type": "or_expression", "children": [left, right]}
-
-
-def and_expression(left, right):
-    return {"type": "and_expression", "children": [left, right]}
-
-
-def not_expression(expr):
-    return {"type": "not_expression", "children": [expr]}
-
-
-def pipe(left, right):
-    return {'type': 'pipe', 'children': [left, right]}
-
-
-def projection(left, right):
-    return {'type': 'projection', 'children': [left, right]}
-
-
-def subexpression(children):
-    return {"type": "subexpression", 'children': children}
-
-
-def slice(start, end, step):
-    return {"type": "slice", "children": [start, end, step]}
-
-
-def value_projection(left, right):
-    return {'type': 'value_projection', 'children': [left, right]}

snail_lang-0.3.9/python/snail/vendor/jmespath/compat.py

@@ -1,19 +0,0 @@
-import sys
-import inspect
-from itertools import zip_longest
-
-
-text_type = str
-string_type = str
-
-
-def with_str_method(cls):
-    # In python3, we don't need to do anything, we return a str type.
-    return cls
-
-def with_repr_method(cls):
-    return cls
-
-def get_methods(cls):
-    for name, method in inspect.getmembers(cls, predicate=inspect.isfunction):
-        yield name, method

snail_lang-0.3.9/python/snail/vendor/jmespath/exceptions.py

@@ -1,137 +0,0 @@
-from .compat import with_str_method
-
-
-class JMESPathError(ValueError):
-    pass
-
-
-@with_str_method
-class ParseError(JMESPathError):
-    _ERROR_MESSAGE = "Invalid jmespath expression"
-
-    def __init__(self, lex_position, token_value, token_type, msg=_ERROR_MESSAGE):
-        super(ParseError, self).__init__(lex_position, token_value, token_type)
-        self.lex_position = lex_position
-        self.token_value = token_value
-        self.token_type = token_type.upper()
-        self.msg = msg
-        # Whatever catches the ParseError can fill in the full expression
-        self.expression = None
-
-    def __str__(self):
-        # self.lex_position +1 to account for the starting double quote char.
-        underline = " " * (self.lex_position + 1) + "^"
-        return (
-            "%s: Parse error at column %s, "
-            'token "%s" (%s), for expression:\n"%s"\n%s'
-            % (
-                self.msg,
-                self.lex_position,
-                self.token_value,
-                self.token_type,
-                self.expression,
-                underline,
-            )
-        )
-
-
-@with_str_method
-class IncompleteExpressionError(ParseError):
-    def set_expression(self, expression):
-        self.expression = expression
-        self.lex_position = len(expression)
-        self.token_type = None
-        self.token_value = None
-
-    def __str__(self):
-        # self.lex_position +1 to account for the starting double quote char.
-        underline = " " * (self.lex_position + 1) + "^"
-        return 'Invalid jmespath expression: Incomplete expression:\n"%s"\n%s' % (
-            self.expression,
-            underline,
-        )
-
-
-@with_str_method
-class LexerError(ParseError):
-    def __init__(self, lexer_position, lexer_value, message, expression=None):
-        self.lexer_position = lexer_position
-        self.lexer_value = lexer_value
-        self.message = message
-        super(LexerError, self).__init__(lexer_position, lexer_value, message)
-        # Whatever catches LexerError can set this.
-        self.expression = expression
-
-    def __str__(self):
-        underline = " " * self.lexer_position + "^"
-        return "Bad jmespath expression: %s:\n%s\n%s" % (
-            self.message,
-            self.expression,
-            underline,
-        )
-
-
-@with_str_method
-class ArityError(ParseError):
-    def __init__(self, expected, actual, name):
-        self.expected_arity = expected
-        self.actual_arity = actual
-        self.function_name = name
-        self.expression = None
-
-    def __str__(self):
-        return "Expected %s %s for function %s(), received %s" % (
-            self.expected_arity,
-            self._pluralize("argument", self.expected_arity),
-            self.function_name,
-            self.actual_arity,
-        )
-
-    def _pluralize(self, word, count):
-        if count == 1:
-            return word
-        else:
-            return word + "s"
-
-
-@with_str_method
-class VariadictArityError(ArityError):
-    def __str__(self):
-        return "Expected at least %s %s for function %s(), received %s" % (
-            self.expected_arity,
-            self._pluralize("argument", self.expected_arity),
-            self.function_name,
-            self.actual_arity,
-        )
-
-
-@with_str_method
-class JMESPathTypeError(JMESPathError):
-    def __init__(self, function_name, current_value, actual_type, expected_types):
-        self.function_name = function_name
-        self.current_value = current_value
-        self.actual_type = actual_type
-        self.expected_types = expected_types
-
-    def __str__(self):
-        return (
-            "In function %s(), invalid type for value: %s, "
-            'expected one of: %s, received: "%s"'
-            % (
-                self.function_name,
-                self.current_value,
-                self.expected_types,
-                self.actual_type,
-            )
-        )
-
-
-class EmptyExpressionError(JMESPathError):
-    def __init__(self):
-        super(EmptyExpressionError, self).__init__(
-            "Invalid JMESPath expression: cannot be empty."
-        )
-
-
-class UnknownFunctionError(JMESPathError):
-    pass