snail-lang 0.7.1__tar.gz → 0.7.2__tar.gz

{snail_lang-0.7.1 → snail_lang-0.7.2}/Cargo.lock

@@ -312,25 +312,25 @@ checksum = "67b1b7a3b5fe4f1376887184045fcf45c69e92af734b7aaddc05fb777b6fbd03"
 
 [[package]]
 name = "snail-ast"
-version = "0.7.1"
+version = "0.7.2"
 
 [[package]]
 name = "snail-error"
-version = "0.7.1"
+version = "0.7.2"
 dependencies = [
  "snail-ast",
 ]
 
 [[package]]
 name = "snail-lower"
-version = "0.7.1"
+version = "0.7.2"
 dependencies = [
  "snail-python",
 ]
 
 [[package]]
 name = "snail-parser"
-version = "0.7.1"
+version = "0.7.2"
 dependencies = [
  "pest",
  "pest_derive",
@@ -340,7 +340,7 @@ dependencies = [
 
 [[package]]
 name = "snail-python"
-version = "0.7.1"
+version = "0.7.2"
 dependencies = [
  "pyo3",
  "snail-ast",

{snail_lang-0.7.1 → snail_lang-0.7.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: snail-lang
-Version: 0.7.1
+Version: 0.7.2
 Requires-Dist: astunparse>=1.6.3 ; python_full_version < '3.9'
 Requires-Dist: jmespath>=1.0.1
 Requires-Dist: maturin>=1.5 ; extra == 'dev'
@@ -76,6 +76,7 @@ END { print("done") }
 | `$p` | Current file path |
 | `$m` | Last regex match object |
 
+
 Begin/end blocks can live in the source file (`BEGIN { ... }` / `END { ... }`) or be supplied
 via CLI flags (`-b`/`--begin`, `-e`/`--end`) for setup and teardown. CLI BEGIN blocks run
 before in-file BEGIN blocks; CLI END blocks run after in-file END blocks.
@@ -113,6 +114,13 @@ BEGIN/END blocks are regular Snail blocks, so awk/map-only `$` variables are not
 snail --map --begin "print('start')" --end "print('done')" "print($src)" *.txt
 ```
 
+### Built-in Variables (All Modes)
+
+| Variable | Description |
+|----------|-------------|
+| `$e` | Exception object in `expr:fallback?` |
+| `$env` | Environment map (wrapper around `os.environ`) |
+
 ### Compact Error Handling
 
 The `?` operator makes error handling terse yet expressive:
@@ -263,6 +271,9 @@ snail 'if let [_, user, domain] = "user@example.com" in /^[\w.]+@([\w.]+)$/ { pr
 
 # Awk mode: print line numbers for matches
 rg -n "TODO" README.md | snail --awk '/TODO/ { print("{$n}: {$0}") }'
+
+# Environment variables
+snail 'print($env.PATH)'
 ```
 
 ## 📚 Documentation

{snail_lang-0.7.1 → snail_lang-0.7.2}/README.md

@@ -63,6 +63,7 @@ END { print("done") }
 | `$p` | Current file path |
 | `$m` | Last regex match object |
 
+
 Begin/end blocks can live in the source file (`BEGIN { ... }` / `END { ... }`) or be supplied
 via CLI flags (`-b`/`--begin`, `-e`/`--end`) for setup and teardown. CLI BEGIN blocks run
 before in-file BEGIN blocks; CLI END blocks run after in-file END blocks.
@@ -100,6 +101,13 @@ BEGIN/END blocks are regular Snail blocks, so awk/map-only `$` variables are not
 snail --map --begin "print('start')" --end "print('done')" "print($src)" *.txt
 ```
 
+### Built-in Variables (All Modes)
+
+| Variable | Description |
+|----------|-------------|
+| `$e` | Exception object in `expr:fallback?` |
+| `$env` | Environment map (wrapper around `os.environ`) |
+
 ### Compact Error Handling
 
 The `?` operator makes error handling terse yet expressive:
@@ -250,6 +258,9 @@ snail 'if let [_, user, domain] = "user@example.com" in /^[\w.]+@([\w.]+)$/ { pr
 
 # Awk mode: print line numbers for matches
 rg -n "TODO" README.md | snail --awk '/TODO/ { print("{$n}: {$0}") }'
+
+# Environment variables
+snail 'print($env.PATH)'
 ```
 
 ## 📚 Documentation

{snail_lang-0.7.1 → snail_lang-0.7.2}/crates/snail-ast/Cargo.toml

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

{snail_lang-0.7.1 → snail_lang-0.7.2}/crates/snail-error/Cargo.toml

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

{snail_lang-0.7.1 → snail_lang-0.7.2}/crates/snail-parser/Cargo.toml

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

{snail_lang-0.7.1 → snail_lang-0.7.2}/crates/snail-parser/src/snail.pest

@@ -250,9 +250,9 @@ boolean = { "True" | "False" }
 none = { "None" }
 
 // Special variables: exception, AWK fields, map vars, injected vars
-exception_var = { "$e" }
+exception_var = { "$e" ~ !ident_continue }
 field_index_var = @{ "$" ~ ASCII_DIGIT+ }
-injected_var = { "$text" | "$src" | "$fn" | "$fd" | "$n" | "$p" | "$m" | "$f" }
+injected_var = { "$text" | "$src" | "$env" | "$fn" | "$fd" | "$n" | "$p" | "$m" | "$f" }
 
 // Number, string, and regex literals
 number = @{ ASCII_DIGIT+ ~ ("." ~ ASCII_DIGIT+)? }

{snail_lang-0.7.1 → snail_lang-0.7.2}/crates/snail-parser/tests/syntax_expressions.rs

@@ -293,6 +293,15 @@ fn parses_structured_accessor_with_pipeline() {
     }
 }
 
+#[test]
+fn parses_env_var() {
+    let program = parse_ok("value = $env");
+    assert_eq!(program.stmts.len(), 1);
+
+    let (_, value) = expect_assign(&program.stmts[0]);
+    expect_name(value, "$env");
+}
+
 #[test]
 fn parses_empty_structured_accessor() {
     let program = parse_ok("result = $[]");

{snail_lang-0.7.1 → snail_lang-0.7.2}/crates/snail-python/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "snail-python"
-version = "0.7.1"
+version = "0.7.2"
 edition.workspace = true
 build = "build.rs"
 

{snail_lang-0.7.1 → snail_lang-0.7.2}/crates/snail-python/src/lower/constants.rs

@@ -37,9 +37,11 @@ pub(crate) const SNAIL_AWK_MATCH_PYVAR: &str = "__snail_match";
 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_ENV: &str = "$env";
 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(crate) const SNAIL_ENV_PYVAR: &str = "__snail_env";
 pub const SNAIL_LAZY_TEXT_CLASS: &str = "__SnailLazyText";
 pub const SNAIL_LAZY_FILE_CLASS: &str = "__SnailLazyFile";
 
@@ -55,6 +57,7 @@ pub(crate) fn injected_py_name(name: &str) -> Option<&'static str> {
         SNAIL_MAP_SRC => Some(SNAIL_MAP_SRC_PYVAR),
         SNAIL_MAP_FD => Some(SNAIL_MAP_FD_PYVAR),
         SNAIL_MAP_TEXT => Some(SNAIL_MAP_TEXT_PYVAR),
+        SNAIL_ENV => Some(SNAIL_ENV_PYVAR),
         _ => None,
     }
 }

{snail_lang-0.7.1 → snail_lang-0.7.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "maturin"
 
 [project]
 name = "snail-lang"
-version = "0.7.1"
+version = "0.7.2"
 description = "Snail programming language interpreter"
 readme = "README.md"
 requires-python = ">=3.8"

{snail_lang-0.7.1 → snail_lang-0.7.2}/python/snail/cli.py

@@ -99,6 +99,7 @@ class _Args:
         self.no_auto_import = False
         self.debug = False
         self.debug_snail_ast = False
+        self.debug_python_ast = False
         self.version = False
         self.help = False
         self.begin_code: list[str] = []
@@ -132,6 +133,7 @@ def _print_help(file=None) -> None:
     print("  -I, --no-auto-import    disable auto-imports", file=file)
     print("  --debug                 parse and compile, then print, do not run", file=file)
     print("  --debug-snail-ast       parse and print Snail AST, do not run", file=file)
+    print("  --debug-python-ast      parse and print Python AST, do not run", file=file)
     print("  -v, --version           show version and exit", file=file)
     print("  -h, --help              show this help message and exit", file=file)
 
@@ -234,6 +236,10 @@ def _parse_args(argv: list[str]) -> _Args:
             args.debug_snail_ast = True
             idx += 1
             continue
+        if token == "--debug-python-ast":
+            args.debug_python_ast = True
+            idx += 1
+            continue
         if token == "-f":
             if idx + 1 >= len(argv):
                 raise ValueError("option -f requires an argument")
@@ -282,6 +288,18 @@ def _get_version() -> str:
     return version
 
 
+def _format_python_runtime() -> str:
+    version = (
+        f"{sys.version_info.major}."
+        f"{sys.version_info.minor}."
+        f"{sys.version_info.micro}"
+    )
+    executable = sys.executable or "<unknown>"
+    if executable != "<unknown>":
+        executable = os.path.abspath(executable)
+    return f"Python {version} ({executable})"
+
+
 def main(argv: Optional[list[str]] = None) -> int:
     if argv is None:
         _install_trimmed_excepthook()
@@ -299,6 +317,7 @@ def main(argv: Optional[list[str]] = None) -> int:
         return 0
     if namespace.version:
         print(_format_version(_get_version(), __build_info__))
+        print(_format_python_runtime())
         return 0
 
     # Validate --awk and --map are mutually exclusive
@@ -348,6 +367,24 @@ def main(argv: Optional[list[str]] = None) -> int:
         print(snail_ast)
         return 0
 
+    if namespace.debug_python_ast:
+        import ast
+
+        python_ast = compile_ast(
+            source,
+            mode=mode,
+            auto_print=not namespace.no_print,
+            filename=filename,
+            begin_code=namespace.begin_code,
+            end_code=namespace.end_code,
+        )
+        try:
+            output = ast.dump(python_ast, indent=2)
+        except TypeError:
+            output = ast.dump(python_ast)
+        print(output)
+        return 0
+
     if namespace.debug:
         import ast
         import builtins

{snail_lang-0.7.1 → snail_lang-0.7.2}/python/snail/runtime/__init__.py

@@ -48,6 +48,7 @@ _incr_attr = None
 _incr_index = None
 _aug_attr = None
 _aug_index = None
+_env_map = None
 
 
 def _get_compact_try():
@@ -131,6 +132,15 @@ def _get_lazy_file_class():
     return _lazy_file_class
 
 
+def _get_env_map():
+    global _env_map
+    if _env_map is None:
+        from .env import EnvMap
+
+        _env_map = EnvMap()
+    return _env_map
+
+
 def _get_incr_attr():
     global _incr_attr
     if _incr_attr is None:
@@ -245,6 +255,7 @@ def install_helpers(globals_dict: dict) -> None:
     globals_dict["__snail_incr_index"] = _lazy_incr_index
     globals_dict["__snail_aug_attr"] = _lazy_aug_attr
     globals_dict["__snail_aug_index"] = _lazy_aug_index
+    globals_dict["__snail_env"] = _get_env_map()
     globals_dict["js"] = _lazy_js
     globals_dict["__SnailLazyText"] = _get_lazy_text_class()
     globals_dict["__SnailLazyFile"] = _get_lazy_file_class()

snail_lang-0.7.2/python/snail/runtime/env.py

@@ -0,0 +1,26 @@
+from __future__ import annotations
+
+import os
+
+
+class EnvMap:
+    __slots__ = ("_env",)
+
+    def __init__(self, env=None) -> None:
+        self._env = os.environ if env is None else env
+
+    def __fallback__(self) -> str:
+        return ""
+
+    def _lookup(self, key):
+        try:
+            return self._env[key]
+        except KeyError as exc:
+            exc.__fallback__ = self.__fallback__
+            raise
+
+    def __getitem__(self, key):
+        return self._lookup(key)
+
+    def __getattr__(self, name):
+        return self._lookup(name)