varphi-interpreter 2.0.0__tar.gz

varphi_interpreter-2.0.0/PKG-INFO

@@ -0,0 +1,11 @@
+Metadata-Version: 2.3
+Name: varphi-interpreter
+Version: 2.0.0
+Summary: An all-in-one tool for compiling and interpreting Varphi programs.
+Author: Varphi
+Author-email: Varphi <support@varphi-lang.com>
+Requires-Dist: typer>=0.21.0
+Requires-Dist: varphi-python-dap>=1.0.1
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+

varphi_interpreter-2.0.0/pyproject.toml

@@ -0,0 +1,20 @@
+[project]
+name = "varphi-interpreter"
+version = "2.0.0"
+description = "An all-in-one tool for compiling and interpreting Varphi programs."
+readme = "README.md"
+authors = [
+    { name = "Varphi", email = "support@varphi-lang.com" }
+]
+requires-python = ">=3.13"
+dependencies = [
+    "typer>=0.21.0",
+    "varphi-python-dap>=1.0.1",
+]
+
+[project.scripts]
+vpi = "varphi_interpreter.cli:main"
+
+[build-system]
+requires = ["uv_build>=0.9.18,<0.10.0"]
+build-backend = "uv_build"

varphi_interpreter-2.0.0/src/varphi_interpreter/cli.py

@@ -0,0 +1,104 @@
+import typer
+from pathlib import Path
+
+app = typer.Typer(add_completion=False)
+
+@app.command(
+    context_settings={"allow_extra_args": True, "ignore_unknown_options": True},
+    help="Compile and execute a Varphi program."
+)
+def main_command(
+    ctx: typer.Context,
+    input_file: Path = typer.Argument(
+        ...,
+        exists=True,
+        file_okay=True,
+        dir_okay=False,
+        readable=True,
+        resolve_path=True,
+        help="Path to the .var source file"
+    ),
+    dap: bool = typer.Option(
+        False, 
+        "--dap", 
+        help="Run in Debug Adapter Protocol mode (for IDEs)."
+    ),
+    debug: bool = typer.Option(
+        False, 
+        "--debug", 
+        help="Enable verbose step-by-step logging (Standard mode only)."
+    ),
+    check: bool = typer.Option(
+        False, 
+        "--check", 
+        help="Compile only to verify syntax (does not execute)."
+    ),
+):
+    """
+    The Varphi Interpreter.
+    
+    Compiles Varphi source code to Python in-memory and executes it immediately.
+    Any extra arguments passed after the filename are forwarded to the program 
+    (e.g., used for setting initial tape values in DAP mode).
+    """
+    import sys
+    from varphi_python import VarphiToPythonCompiler
+    from varphi_python_dap import VarphiToPythonDAPCompiler
+    from varphi_devkit import VarphiSyntaxError
+
+    # Select the Compiler Backend
+    if dap:
+        compiler = VarphiToPythonDAPCompiler()
+        compiler.set_source_path(str(input_file))
+        if debug:
+            typer.echo("Warning: --debug flag is ignored in DAP mode.", err=True)
+    else:
+        compiler = VarphiToPythonCompiler()
+        if debug:
+            compiler.toggle_debug()
+
+    # Compile Source
+    try:
+        source_code = input_file.read_text(encoding="utf-8")
+        compiled_python_code = compiler.compile(source_code)
+
+        if check:
+            typer.echo("OK")
+            raise typer.Exit(code=0)
+
+    except VarphiSyntaxError as e:
+        typer.echo(f"Compilation Error: {e}", err=True)
+        raise typer.Exit(code=1)
+    
+    # We construct a new argv. 
+    # argv[0] should be the script name (we fake it as the input file).
+    # argv[1:] should be the extra arguments passed by the user (e.g., --tapes 101).
+    fake_argv = [str(input_file)] + ctx.args
+    
+    # Global scope for the executed code.
+    execution_globals = {
+        "__name__": "__main__",
+        "__file__": str(input_file),
+        "__builtins__": __builtins__,
+    }
+
+    # Execute (Interpret)
+    # We create a safe context where sys.argv is temporarily swapped.
+    original_argv = sys.argv
+    try:
+        sys.argv = fake_argv
+        exec(compiled_python_code, execution_globals)
+    except SystemExit as e:
+        raise typer.Exit(code=e.code)
+    except Exception as e:
+        typer.echo(f"Runtime Error: {e}", err=True)
+        raise typer.Exit(code=1)
+    finally:
+        # Restore sys.argv
+        sys.argv = original_argv
+
+def main():
+    app()
+
+if __name__ == "__main__":
+    main()