ASTpytcl 0.1.1__tar.gz

astpytcl-0.1.1/PKG-INFO

@@ -0,0 +1,88 @@
+Metadata-Version: 2.4
+Name: ASTpytcl
+Version: 0.1.1
+Summary: A zero-dependency, CPython-AST-powered Tcl environment with Python FFI and macro bridges
+Author: erider0x90
+Project-URL: Homepage, https://tclpy.github.io/TCLpy/
+Project-URL: Repository, https://github.com/TCLpy/TCLpy
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pyinstaller>=5.0.0; extra == "dev"
+
+<p align="center">
+  <img src="assets/LogoTCLpy.jpg" alt="TCLpy Astrolabe Snake Logo" width="220" style="border-radius: 12px;">
+</p>
+
+# TCLpy 🚀
+
+
+**A Lightweight, Zero-Dependency Tcl-to-Python Compiler & FFI Bridge**
+
+`tclpy` is a high-performance, open-source Tcl-to-Python bridge and execution engine. Instead of running a string-based interpreter, `tclpy` compiles Tcl source code directly into native CPython AST nodes (`ast.Assign`, `ast.If`, `ast.For`, `ast.Call`), delivering seamless Python interoperability while preserving Tcl's core "everything is a string" command semantics. `tclpy` was inspired by hylang. We want to bring the fun back to coding in TCL. 
+
+---
+
+## Key Features
+
+- **AST-Based Compilation**: Compiles Tcl control flow, variable bindings, and command calls directly into CPython Abstract Syntax Tree nodes for native execution speed.
+- **Direct Python Interop**: Import any Python module or standard library package via `py::import` and invoke functions using Tcl's double-colon notation (`math::sqrt`, `os::listdir`).
+- **Unified Scope Model**: Shares state transparently between Tcl `proc` definitions, variable namespaces, and Python objects.
+- **Tcl-First Presentation**: Internal storage leverages high-performance Python objects, while external output marshaling formats collections into traditional space-separated Tcl strings.
+- **Zero-Overhead Hybrid Execution**: Keeps Tcl managing high-level application state, event loops, and logic, while executing Python object-heavy operations smoothly.
+- **Minimalist Design Philosophy**: Avoids unnecessary AST bloat by providing `py_exec` for inline Python edge cases rather than polluting the core grammar.
+
+---
+
+## Recent Features & Capabilities
+
+- **TCP Socket Support**: Full support for client connections (`socket host port`) and background server listeners (`socket -server callback port`) using multithreading and environment-bound callback execution.
+- **Channel & Flush Operations**: Interoperable channel management (`_open_channels`) supporting `open`, `gets`, `puts`, `close`, and `flush` across both files and network streams.
+- **Extended String Command Suite**: Comprehensive implementation of Tcl `string` subcommands including `length`, `index`, `range`, `compare`, `equal`, `first`, `last`, `match`, `map`, `toupper`, `tolower`, `trim`, `replace`, and `is`.
+
+---
+
+## Core Command Set
+
+| Category | Commands |
+| :--- | :--- |
+| **Variables & Data** | `set`, `unset`, `incr` |
+| **Control Flow** | `if` / `elseif` / `else`, `while`, `foreach`, `break`, `continue` |
+| **Procedures & Logic** | `proc`, `return`, `expr` |
+| **Collections** | `llength`, `lindex`, `lappend` |
+| **I/O & Output** | `puts`, `read`, `gets`, `open`, `close`, `socket`, `flush` |
+| **Python Bridge** | `py::import` (access Python libraries), `py_exec` (run inline Python code) |
+
+---
+
+### String Operations Quick Reference
+
+| Operation | Syntax Example | Description | Result |
+| :--- | :--- | :--- | :--- |
+| **length** | `string length "Hello"` | Returns the number of characters. | `5` |
+| **index** | `string index "Tcl" 1` | Retrieves the character at a 0-based index. | `c` |
+| **range** | `string range "Python" 0 2` | Extracts a substring from start to end index. | `Pyt` |
+| **compare** | `string compare "abc" "def"` | Lexicographically compares two strings (-1, 0, 1). | `-1` |
+| **equal** | `string equal -nocase "A" "a"` | Returns 1 if identical, 0 otherwise. | `1` |
+| **first** | `string first "bc" "abcde"` | Finds first index of a substring. | `1` |
+| **last** | `string last "a" "banana"` | Finds last index of a substring. | `5` |
+| **match** | `string match "test*" "testing"` | Performs glob-style wildcard pattern matching. | `1` |
+| **map** | `string map {a 1 b 2} "abab"` | Replaces substrings based on key-value pairs. | `1212` |
+| **replace** | `string replace "I like Java" 7 10 "Tcl"` | Replaces a range of characters. | `"I like Tcl"` |
+| **tolower** | `string tolower "HELLO"` | Converts string to lowercase. | `"hello"` |
+| **toupper** | `string toupper "hello"` | Converts string to uppercase. | `"HELLO"` |
+| **trim** | `string trim "  abc  "` | Strips leading/trailing whitespaces. | `"abc"` |
+| **is** | `string is integer -strict "123"` | Validates character classes. | `1` |
+
+---
+
+## Quickstart & Installation
+
+```bash
+git clone [https://github.com/TCLpy/TCLpy.git](https://github.com/TCLpy/TCLpy.git)
+cd tclpy
+pip install -e .

astpytcl-0.1.1/README.md

@@ -0,0 +1,72 @@
+<p align="center">
+  <img src="assets/LogoTCLpy.jpg" alt="TCLpy Astrolabe Snake Logo" width="220" style="border-radius: 12px;">
+</p>
+
+# TCLpy 🚀
+
+
+**A Lightweight, Zero-Dependency Tcl-to-Python Compiler & FFI Bridge**
+
+`tclpy` is a high-performance, open-source Tcl-to-Python bridge and execution engine. Instead of running a string-based interpreter, `tclpy` compiles Tcl source code directly into native CPython AST nodes (`ast.Assign`, `ast.If`, `ast.For`, `ast.Call`), delivering seamless Python interoperability while preserving Tcl's core "everything is a string" command semantics. `tclpy` was inspired by hylang. We want to bring the fun back to coding in TCL. 
+
+---
+
+## Key Features
+
+- **AST-Based Compilation**: Compiles Tcl control flow, variable bindings, and command calls directly into CPython Abstract Syntax Tree nodes for native execution speed.
+- **Direct Python Interop**: Import any Python module or standard library package via `py::import` and invoke functions using Tcl's double-colon notation (`math::sqrt`, `os::listdir`).
+- **Unified Scope Model**: Shares state transparently between Tcl `proc` definitions, variable namespaces, and Python objects.
+- **Tcl-First Presentation**: Internal storage leverages high-performance Python objects, while external output marshaling formats collections into traditional space-separated Tcl strings.
+- **Zero-Overhead Hybrid Execution**: Keeps Tcl managing high-level application state, event loops, and logic, while executing Python object-heavy operations smoothly.
+- **Minimalist Design Philosophy**: Avoids unnecessary AST bloat by providing `py_exec` for inline Python edge cases rather than polluting the core grammar.
+
+---
+
+## Recent Features & Capabilities
+
+- **TCP Socket Support**: Full support for client connections (`socket host port`) and background server listeners (`socket -server callback port`) using multithreading and environment-bound callback execution.
+- **Channel & Flush Operations**: Interoperable channel management (`_open_channels`) supporting `open`, `gets`, `puts`, `close`, and `flush` across both files and network streams.
+- **Extended String Command Suite**: Comprehensive implementation of Tcl `string` subcommands including `length`, `index`, `range`, `compare`, `equal`, `first`, `last`, `match`, `map`, `toupper`, `tolower`, `trim`, `replace`, and `is`.
+
+---
+
+## Core Command Set
+
+| Category | Commands |
+| :--- | :--- |
+| **Variables & Data** | `set`, `unset`, `incr` |
+| **Control Flow** | `if` / `elseif` / `else`, `while`, `foreach`, `break`, `continue` |
+| **Procedures & Logic** | `proc`, `return`, `expr` |
+| **Collections** | `llength`, `lindex`, `lappend` |
+| **I/O & Output** | `puts`, `read`, `gets`, `open`, `close`, `socket`, `flush` |
+| **Python Bridge** | `py::import` (access Python libraries), `py_exec` (run inline Python code) |
+
+---
+
+### String Operations Quick Reference
+
+| Operation | Syntax Example | Description | Result |
+| :--- | :--- | :--- | :--- |
+| **length** | `string length "Hello"` | Returns the number of characters. | `5` |
+| **index** | `string index "Tcl" 1` | Retrieves the character at a 0-based index. | `c` |
+| **range** | `string range "Python" 0 2` | Extracts a substring from start to end index. | `Pyt` |
+| **compare** | `string compare "abc" "def"` | Lexicographically compares two strings (-1, 0, 1). | `-1` |
+| **equal** | `string equal -nocase "A" "a"` | Returns 1 if identical, 0 otherwise. | `1` |
+| **first** | `string first "bc" "abcde"` | Finds first index of a substring. | `1` |
+| **last** | `string last "a" "banana"` | Finds last index of a substring. | `5` |
+| **match** | `string match "test*" "testing"` | Performs glob-style wildcard pattern matching. | `1` |
+| **map** | `string map {a 1 b 2} "abab"` | Replaces substrings based on key-value pairs. | `1212` |
+| **replace** | `string replace "I like Java" 7 10 "Tcl"` | Replaces a range of characters. | `"I like Tcl"` |
+| **tolower** | `string tolower "HELLO"` | Converts string to lowercase. | `"hello"` |
+| **toupper** | `string toupper "hello"` | Converts string to uppercase. | `"HELLO"` |
+| **trim** | `string trim "  abc  "` | Strips leading/trailing whitespaces. | `"abc"` |
+| **is** | `string is integer -strict "123"` | Validates character classes. | `1` |
+
+---
+
+## Quickstart & Installation
+
+```bash
+git clone [https://github.com/TCLpy/TCLpy.git](https://github.com/TCLpy/TCLpy.git)
+cd tclpy
+pip install -e .

astpytcl-0.1.1/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["setuptools>=61.0.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ASTpytcl"
+version = "0.1.1"
+description = "A zero-dependency, CPython-AST-powered Tcl environment with Python FFI and macro bridges"
+readme = "README.md"
+requires-python = ">=3.10"
+authors = [
+    { name = "erider0x90" }
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    # Core engine is zero-dependency Python stdlib + CPython AST
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pyinstaller>=5.0.0",
+]
+
+[project.scripts]
+tclpy = "tclpy.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[project.urls]
+Homepage = "https://tclpy.github.io/TCLpy/"
+Repository = "https://github.com/TCLpy/TCLpy"
+# Bug Tracker = "https://github.com/TCLpy/TCLpy/issues"

astpytcl-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

astpytcl-0.1.1/src/ASTpytcl.egg-info/PKG-INFO

@@ -0,0 +1,88 @@
+Metadata-Version: 2.4
+Name: ASTpytcl
+Version: 0.1.1
+Summary: A zero-dependency, CPython-AST-powered Tcl environment with Python FFI and macro bridges
+Author: erider0x90
+Project-URL: Homepage, https://tclpy.github.io/TCLpy/
+Project-URL: Repository, https://github.com/TCLpy/TCLpy
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pyinstaller>=5.0.0; extra == "dev"
+
+<p align="center">
+  <img src="assets/LogoTCLpy.jpg" alt="TCLpy Astrolabe Snake Logo" width="220" style="border-radius: 12px;">
+</p>
+
+# TCLpy 🚀
+
+
+**A Lightweight, Zero-Dependency Tcl-to-Python Compiler & FFI Bridge**
+
+`tclpy` is a high-performance, open-source Tcl-to-Python bridge and execution engine. Instead of running a string-based interpreter, `tclpy` compiles Tcl source code directly into native CPython AST nodes (`ast.Assign`, `ast.If`, `ast.For`, `ast.Call`), delivering seamless Python interoperability while preserving Tcl's core "everything is a string" command semantics. `tclpy` was inspired by hylang. We want to bring the fun back to coding in TCL. 
+
+---
+
+## Key Features
+
+- **AST-Based Compilation**: Compiles Tcl control flow, variable bindings, and command calls directly into CPython Abstract Syntax Tree nodes for native execution speed.
+- **Direct Python Interop**: Import any Python module or standard library package via `py::import` and invoke functions using Tcl's double-colon notation (`math::sqrt`, `os::listdir`).
+- **Unified Scope Model**: Shares state transparently between Tcl `proc` definitions, variable namespaces, and Python objects.
+- **Tcl-First Presentation**: Internal storage leverages high-performance Python objects, while external output marshaling formats collections into traditional space-separated Tcl strings.
+- **Zero-Overhead Hybrid Execution**: Keeps Tcl managing high-level application state, event loops, and logic, while executing Python object-heavy operations smoothly.
+- **Minimalist Design Philosophy**: Avoids unnecessary AST bloat by providing `py_exec` for inline Python edge cases rather than polluting the core grammar.
+
+---
+
+## Recent Features & Capabilities
+
+- **TCP Socket Support**: Full support for client connections (`socket host port`) and background server listeners (`socket -server callback port`) using multithreading and environment-bound callback execution.
+- **Channel & Flush Operations**: Interoperable channel management (`_open_channels`) supporting `open`, `gets`, `puts`, `close`, and `flush` across both files and network streams.
+- **Extended String Command Suite**: Comprehensive implementation of Tcl `string` subcommands including `length`, `index`, `range`, `compare`, `equal`, `first`, `last`, `match`, `map`, `toupper`, `tolower`, `trim`, `replace`, and `is`.
+
+---
+
+## Core Command Set
+
+| Category | Commands |
+| :--- | :--- |
+| **Variables & Data** | `set`, `unset`, `incr` |
+| **Control Flow** | `if` / `elseif` / `else`, `while`, `foreach`, `break`, `continue` |
+| **Procedures & Logic** | `proc`, `return`, `expr` |
+| **Collections** | `llength`, `lindex`, `lappend` |
+| **I/O & Output** | `puts`, `read`, `gets`, `open`, `close`, `socket`, `flush` |
+| **Python Bridge** | `py::import` (access Python libraries), `py_exec` (run inline Python code) |
+
+---
+
+### String Operations Quick Reference
+
+| Operation | Syntax Example | Description | Result |
+| :--- | :--- | :--- | :--- |
+| **length** | `string length "Hello"` | Returns the number of characters. | `5` |
+| **index** | `string index "Tcl" 1` | Retrieves the character at a 0-based index. | `c` |
+| **range** | `string range "Python" 0 2` | Extracts a substring from start to end index. | `Pyt` |
+| **compare** | `string compare "abc" "def"` | Lexicographically compares two strings (-1, 0, 1). | `-1` |
+| **equal** | `string equal -nocase "A" "a"` | Returns 1 if identical, 0 otherwise. | `1` |
+| **first** | `string first "bc" "abcde"` | Finds first index of a substring. | `1` |
+| **last** | `string last "a" "banana"` | Finds last index of a substring. | `5` |
+| **match** | `string match "test*" "testing"` | Performs glob-style wildcard pattern matching. | `1` |
+| **map** | `string map {a 1 b 2} "abab"` | Replaces substrings based on key-value pairs. | `1212` |
+| **replace** | `string replace "I like Java" 7 10 "Tcl"` | Replaces a range of characters. | `"I like Tcl"` |
+| **tolower** | `string tolower "HELLO"` | Converts string to lowercase. | `"hello"` |
+| **toupper** | `string toupper "hello"` | Converts string to uppercase. | `"HELLO"` |
+| **trim** | `string trim "  abc  "` | Strips leading/trailing whitespaces. | `"abc"` |
+| **is** | `string is integer -strict "123"` | Validates character classes. | `1` |
+
+---
+
+## Quickstart & Installation
+
+```bash
+git clone [https://github.com/TCLpy/TCLpy.git](https://github.com/TCLpy/TCLpy.git)
+cd tclpy
+pip install -e .

astpytcl-0.1.1/src/ASTpytcl.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+README.md
+pyproject.toml
+src/ASTpytcl.egg-info/PKG-INFO
+src/ASTpytcl.egg-info/SOURCES.txt
+src/ASTpytcl.egg-info/dependency_links.txt
+src/ASTpytcl.egg-info/entry_points.txt
+src/ASTpytcl.egg-info/requires.txt
+src/ASTpytcl.egg-info/top_level.txt
+src/tclpy/__init__.py
+src/tclpy/cli.py
+src/tclpy/compiler.py
+src/tclpy/runtime.py
+src/tclpy/tcl_lexer.py
+tests/test_compiler.py
+tests/test_lexer.py
+tests/test_runtime.py

astpytcl-0.1.1/src/ASTpytcl.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

astpytcl-0.1.1/src/ASTpytcl.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+tclpy = tclpy.cli:main

astpytcl-0.1.1/src/ASTpytcl.egg-info/requires.txt

@@ -0,0 +1,4 @@
+
+[dev]
+pytest>=7.0.0
+pyinstaller>=5.0.0

astpytcl-0.1.1/src/ASTpytcl.egg-info/top_level.txt

@@ -0,0 +1 @@
+tclpy

astpytcl-0.1.1/src/tclpy/__init__.py

@@ -0,0 +1,21 @@
+# src/tclpy/__init__.py
+from .runtime import execute_tcl
+
+def eval(source: str, env: dict = None) -> any:
+    """
+    Evaluate a Tcl string or expression within an optional Python environment dict.
+    Returns the resulting Python object from the execution.
+    """
+    if env is None:
+        env = {}
+    return execute_tcl(source, env)
+
+def source(filepath: str, env: dict = None) -> any:
+    """
+    Load and execute a .tcl script file within an optional Python environment dict.
+    """
+    if env is None:
+        env = {}
+    with open(filepath, "r", encoding="utf-8") as f:
+        content = f.read()
+    return execute_tcl(content, env)

astpytcl-0.1.1/src/tclpy/cli.py

@@ -0,0 +1,116 @@
+# src/cli.py
+import sys
+import os
+
+try:
+    import readline
+except ImportError:
+    readline = None  # Fallback gracefully on Windows where readline isn't standard
+
+# Ensure current working directory is in sys.path for local module imports (e.g. windows_h.py)
+current_dir = os.getcwd()
+if current_dir not in sys.path:
+    sys.path.insert(0, current_dir)
+
+try:
+    # When running as part of the installed tclpy package or PyInstaller bundle
+    from tclpy.runtime import execute_tcl
+except ImportError:
+    try:
+        # Relative import fallback if running inside package context
+        from .runtime import execute_tcl
+    except ImportError:
+        # Fallback for direct local script execution
+        from runtime import execute_tcl
+        
+def is_balanced(source: str) -> bool:
+    """Check if Tcl braces {} and brackets [] are balanced to support multi-line input."""
+    brace_depth = 0
+    bracket_depth = 0
+    in_quote = False
+    escaped = False
+    
+    for char in source:
+        if escaped:
+            escaped = False
+            continue
+        if char == '\\':
+            escaped = True
+            continue
+        if char == '"' and not escaped:
+            in_quote = not in_quote
+            continue
+        if in_quote:
+            continue
+            
+        if char == '{':
+            brace_depth += 1
+        elif char == '}':
+            brace_depth -= 1
+        elif char == '[':
+            bracket_depth += 1
+        elif char == ']':
+            bracket_depth -= 1
+            
+    return brace_depth <= 0 and bracket_depth <= 0
+
+def run_repl():
+    """Run an interactive Tcl REPL shell with persistent environment and multi-line support."""
+    print("tclpy Interactive Shell (Powered by CPython AST & Tkinter Tcl)")
+    print("Type 'exit' or 'quit' to leave the shell.\n")
+    
+    env = {}
+    buffer = []
+    
+    while True:
+        try:
+            prompt = "... " if buffer else "tclpy> "
+            line = input(prompt)
+        except (KeyboardInterrupt, EOFError):
+            print("\nExiting tclpy shell. Goodbye!")
+            break
+            
+        stripped = line.strip()
+        if not buffer and stripped in ("exit", "quit"):
+            print("Goodbye!")
+            break
+            
+        if not buffer and not stripped:
+            continue
+            
+        buffer.append(line)
+        full_source = "\n".join(buffer)
+        
+        if is_balanced(full_source):
+            try:
+                execute_tcl(full_source, env)
+            except Exception as e:
+                print(f"Error: {e}")
+            buffer.clear()
+
+def main():
+    if len(sys.argv) > 1:
+        script_path = sys.argv[1]
+        if not os.path.exists(script_path):
+            print(f"Error: script '{script_path}' not found.", file=sys.stderr)
+            sys.exit(1)
+            
+        # Add the script's own directory to sys.path so local modules (e.g. testdump) resolve
+        script_dir = os.path.abspath(os.path.dirname(script_path))
+        if script_dir not in sys.path:
+            sys.path.insert(0, script_dir)
+            
+        with open(script_path, "r", encoding="utf-8") as f:
+            source = f.read()
+            
+        env = {}
+        try:
+            execute_tcl(source, env)
+        except Exception as e:
+            print(f"Error: {e}", file=sys.stderr)
+            sys.exit(1)
+    else:
+        run_repl()
+        
+if __name__ == "__main__":
+    main()