multilingualprogramming 0.2.0__tar.gz → 0.4.0__tar.gz

{multilingualprogramming-0.2.0/multilingualprogramming.egg-info → multilingualprogramming-0.4.0}/PKG-INFO

@@ -1,21 +1,23 @@
 Metadata-Version: 2.4
 Name: multilingualprogramming
-Version: 0.2.0
+Version: 0.4.0
 Summary: Python application for multilingual programming
 Author-email: John Samuel <johnsamuelwrites@example.com>
 License: GPL-3.0-or-later
 Project-URL: Homepage, https://github.com/johnsamuelwrites/multilingual
-Project-URL: Documentation, https://johnsamuelwrites.github.io/multilingual/
+Project-URL: Documentation, https://johnsamuel.info/multilingual/
 Project-URL: Repository, https://github.com/johnsamuelwrites/multilingual
 Project-URL: Issues, https://github.com/johnsamuelwrites/multilingual/issues
 Project-URL: Changelog, https://github.com/johnsamuelwrites/multilingual/blob/main/CHANGELOG.md
 Keywords: programming-language,multilingual,compiler,transpiler,education
-Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
 Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Compilers
+Classifier: Topic :: Software Development :: Interpreters
+Classifier: Development Status :: 4 - Beta
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
@@ -25,6 +27,11 @@ Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
 Requires-Dist: pylint; extra == "dev"
+Provides-Extra: wasm
+Requires-Dist: wasmtime>=1.0.0; extra == "wasm"
+Provides-Extra: performance
+Requires-Dist: wasmtime>=1.0.0; extra == "performance"
+Requires-Dist: numpy>=1.20.0; extra == "performance"
 Dynamic: license-file
 
 # multilingual
@@ -89,11 +96,47 @@ Details:
 Source files for this language use the `.ml` extension (for example: `hello.ml`).
 Requires Python 3.12 or newer.
 
+### Try The Playground (No Install Required)
+
+You can try `multilingual` directly in your browser:
+
+- Playground: https://johnsamuel.info/multilingual/playground.html
+
+The playground lets you:
+
+- Write code in supported human languages
+- Run full execution in Pyodide
+- Inspect generated Python
+- Inspect generated WAT/WASM output
+- Inspect generated Rust bridge code (Wasmtime workflow)
+
+If you are evaluating the project, please test the playground with your language and open an issue with feedback:
+
+- Issues: https://github.com/johnsamuelwrites/multilingual/issues
+
 ### 1. Install
 
+PyPI package: https://pypi.org/project/multilingualprogramming/
+
+Option 1 (recommended): install in a virtual environment.
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+python -m pip install --upgrade pip
+python -m pip install multilingualprogramming
+```
+
+Option 2: install with `pipx` (isolated CLI install).
+
+```bash
+pipx install multilingualprogramming
+```
+
+For local development from source, use:
+
 ```bash
 pip install -r requirements.txt
-# or
 pip install .
 ```
 
@@ -119,7 +162,10 @@ imprimir("Hola mundo")
 Start REPL:
 
 ```bash
-# 1) Default mode (English keywords)
+# 0) Direct interactive mode (like `python`)
+multilingual
+
+# 1) Explicit REPL command (same behavior as above)
 multilingual repl
 
 # 2) French mode
@@ -127,9 +173,16 @@ multilingual repl --lang fr
 
 # Optional: show generated Python while executing
 multilingual repl --show-python
+
+# Optional: show generated WAT (WebAssembly Text) code while executing
+multilingual repl --show-wat
+
+# Optional: show generated Rust/Wasmtime bridge code while executing
+multilingual repl --show-rust
 ```
 
 Inside the REPL, type code and press Enter to execute.
+Both `multilingual` and `multilingual repl` start the same REPL.
 
 Default mode example (English):
 
@@ -170,6 +223,8 @@ REPL commands:
 - `:help` show commands
 - `:language <code>` switch language
 - `:python` toggle generated Python display
+- `:wat` toggle generated WAT (WebAssembly Text) display
+- `:rust` toggle generated Rust/Wasmtime bridge code display
 - `:reset` clear session state
 - `:kw [XX]` show language keywords
 - `:ops [XX]` show operators and symbols
@@ -191,6 +246,12 @@ print("Hello world")
 
 Run it:
 
+```bash
+multilingual hello.ml
+```
+
+Equivalent explicit form:
+
 ```bash
 multilingual run hello.ml
 ```
@@ -198,6 +259,7 @@ multilingual run hello.ml
 Optional (force language instead of auto-detect):
 
 ```bash
+multilingual hello.ml --lang fr
 multilingual run hello.ml --lang fr
 ```
 
@@ -316,6 +378,7 @@ afficher("a + b =", a + b)
 
 Use this README for setup and workflow; use `docs/` for design rationale and policy details.
 
+- Browser playground (interactive): https://johnsamuel.info/multilingual/playground.html
 - Usage guide: [USAGE.md](USAGE.md)
 - Examples guide: [examples/README.md](examples/README.md)
 - Detailed reference: [docs/reference.md](docs/reference.md)

multilingualprogramming-0.2.0/PKG-INFO → multilingualprogramming-0.4.0/README.md

@@ -1,32 +1,3 @@
-Metadata-Version: 2.4
-Name: multilingualprogramming
-Version: 0.2.0
-Summary: Python application for multilingual programming
-Author-email: John Samuel <johnsamuelwrites@example.com>
-License: GPL-3.0-or-later
-Project-URL: Homepage, https://github.com/johnsamuelwrites/multilingual
-Project-URL: Documentation, https://johnsamuelwrites.github.io/multilingual/
-Project-URL: Repository, https://github.com/johnsamuelwrites/multilingual
-Project-URL: Issues, https://github.com/johnsamuelwrites/multilingual/issues
-Project-URL: Changelog, https://github.com/johnsamuelwrites/multilingual/blob/main/CHANGELOG.md
-Keywords: programming-language,multilingual,compiler,transpiler,education
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.12
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: roman>=3.3
-Requires-Dist: python-dateutil>=2.8
-Provides-Extra: dev
-Requires-Dist: pytest; extra == "dev"
-Requires-Dist: pytest-cov; extra == "dev"
-Requires-Dist: pylint; extra == "dev"
-Dynamic: license-file
-
 # multilingual
 Not yet another programming language. A multilingual one.
 
@@ -89,11 +60,47 @@ Details:
 Source files for this language use the `.ml` extension (for example: `hello.ml`).
 Requires Python 3.12 or newer.
 
+### Try The Playground (No Install Required)
+
+You can try `multilingual` directly in your browser:
+
+- Playground: https://johnsamuel.info/multilingual/playground.html
+
+The playground lets you:
+
+- Write code in supported human languages
+- Run full execution in Pyodide
+- Inspect generated Python
+- Inspect generated WAT/WASM output
+- Inspect generated Rust bridge code (Wasmtime workflow)
+
+If you are evaluating the project, please test the playground with your language and open an issue with feedback:
+
+- Issues: https://github.com/johnsamuelwrites/multilingual/issues
+
 ### 1. Install
 
+PyPI package: https://pypi.org/project/multilingualprogramming/
+
+Option 1 (recommended): install in a virtual environment.
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+python -m pip install --upgrade pip
+python -m pip install multilingualprogramming
+```
+
+Option 2: install with `pipx` (isolated CLI install).
+
+```bash
+pipx install multilingualprogramming
+```
+
+For local development from source, use:
+
 ```bash
 pip install -r requirements.txt
-# or
 pip install .
 ```
 
@@ -119,7 +126,10 @@ imprimir("Hola mundo")
 Start REPL:
 
 ```bash
-# 1) Default mode (English keywords)
+# 0) Direct interactive mode (like `python`)
+multilingual
+
+# 1) Explicit REPL command (same behavior as above)
 multilingual repl
 
 # 2) French mode
@@ -127,9 +137,16 @@ multilingual repl --lang fr
 
 # Optional: show generated Python while executing
 multilingual repl --show-python
+
+# Optional: show generated WAT (WebAssembly Text) code while executing
+multilingual repl --show-wat
+
+# Optional: show generated Rust/Wasmtime bridge code while executing
+multilingual repl --show-rust
 ```
 
 Inside the REPL, type code and press Enter to execute.
+Both `multilingual` and `multilingual repl` start the same REPL.
 
 Default mode example (English):
 
@@ -170,6 +187,8 @@ REPL commands:
 - `:help` show commands
 - `:language <code>` switch language
 - `:python` toggle generated Python display
+- `:wat` toggle generated WAT (WebAssembly Text) display
+- `:rust` toggle generated Rust/Wasmtime bridge code display
 - `:reset` clear session state
 - `:kw [XX]` show language keywords
 - `:ops [XX]` show operators and symbols
@@ -191,6 +210,12 @@ print("Hello world")
 
 Run it:
 
+```bash
+multilingual hello.ml
+```
+
+Equivalent explicit form:
+
 ```bash
 multilingual run hello.ml
 ```
@@ -198,6 +223,7 @@ multilingual run hello.ml
 Optional (force language instead of auto-detect):
 
 ```bash
+multilingual hello.ml --lang fr
 multilingual run hello.ml --lang fr
 ```
 
@@ -316,6 +342,7 @@ afficher("a + b =", a + b)
 
 Use this README for setup and workflow; use `docs/` for design rationale and policy details.
 
+- Browser playground (interactive): https://johnsamuel.info/multilingual/playground.html
 - Usage guide: [USAGE.md](USAGE.md)
 - Examples guide: [examples/README.md](examples/README.md)
 - Detailed reference: [docs/reference.md](docs/reference.md)

{multilingualprogramming-0.2.0 → multilingualprogramming-0.4.0}/multilingualprogramming/__init__.py

@@ -30,6 +30,7 @@ from multilingualprogramming.parser.semantic_analyzer import (
 )
 from multilingualprogramming.parser.error_messages import ErrorMessageRegistry
 from multilingualprogramming.codegen.python_generator import PythonCodeGenerator
+from multilingualprogramming.codegen.wat_generator import WATCodeGenerator
 from multilingualprogramming.codegen.runtime_builtins import RuntimeBuiltins
 from multilingualprogramming.codegen.executor import ProgramExecutor, ExecutionResult
 from multilingualprogramming.codegen.repl import REPL
@@ -63,6 +64,7 @@ __all__ = [
     "SemanticAnalyzer",
     "ErrorMessageRegistry",
     "PythonCodeGenerator",
+    "WATCodeGenerator",
     "RuntimeBuiltins",
     "ProgramExecutor",
     "ExecutionResult",

{multilingualprogramming-0.2.0 → multilingualprogramming-0.4.0}/multilingualprogramming/__main__.py

@@ -9,6 +9,7 @@ CLI entry point for the multilingual programming language.
 
 Usage:
     python -m multilingualprogramming                     # Start REPL
+    python -m multilingualprogramming <file>.ml          # Execute a source file
     python -m multilingualprogramming run <file>           # Execute a file
     python -m multilingualprogramming repl [--lang XX]     # Start REPL
     python -m multilingualprogramming compile <file>       # Show generated Python
@@ -58,7 +59,12 @@ def cmd_run(args):
 
 def cmd_repl(args):
     """Start the interactive REPL."""
-    repl = REPL(language=args.lang, show_python=args.show_python)
+    repl = REPL(
+        language=args.lang,
+        show_python=args.show_python,
+        show_wat=args.show_wat,
+        show_rust=args.show_rust,
+    )
     repl.run()
 
 
@@ -118,11 +124,44 @@ def cmd_smoke(args):
         sys.exit(1)
 
 
+def _maybe_dispatch_direct_file_run(argv):
+    """Dispatch `multilingual <file>.ml [--lang XX]` to `cmd_run`."""
+    if not argv:
+        return False
+
+    first = argv[0]
+    if first.startswith("-"):
+        return False
+    if not first.lower().endswith(".ml"):
+        return False
+
+    parser = argparse.ArgumentParser(
+        prog="multilingual",
+        description="Execute a multilingual source file",
+    )
+    parser.add_argument("file", help="Path to the source file")
+    parser.add_argument(
+        "--lang", default=None,
+        help="Source language code (e.g., en, fr, hi). Auto-detect if omitted.",
+    )
+    args = parser.parse_args(argv)
+    cmd_run(args)
+    return True
+
+
 def main():
     """Run the CLI entry point and dispatch subcommands."""
+    argv = sys.argv[1:]
+    if _maybe_dispatch_direct_file_run(argv):
+        return
+
     parser = argparse.ArgumentParser(
         prog="multilingual",
-        description="Multilingual Programming Language CLI",
+        description=(
+            "Multilingual Programming Language CLI "
+            "(default command starts interactive REPL; "
+            "pass <file>.ml to run directly)"
+        ),
     )
     parser.add_argument(
         "--version", action="version",
@@ -149,6 +188,14 @@ def main():
         "--show-python", action="store_true",
         help="Display generated Python code before execution",
     )
+    repl_parser.add_argument(
+        "--show-wat", action="store_true",
+        help="Display generated WAT (WebAssembly Text) code before execution",
+    )
+    repl_parser.add_argument(
+        "--show-rust", action="store_true",
+        help="Display generated Rust/Wasmtime bridge code before execution",
+    )
 
     # compile subcommand
     compile_parser = subparsers.add_parser(
@@ -187,6 +234,8 @@ def main():
         # Default: start REPL
         args.lang = None
         args.show_python = False
+        args.show_wat = False
+        args.show_rust = False
         cmd_repl(args)
 
 

{multilingualprogramming-0.2.0 → multilingualprogramming-0.4.0}/multilingualprogramming/codegen/repl.py

@@ -46,7 +46,8 @@ class REPL:
     _COMMAND_CATALOG = None
     _OPERATOR_CATALOG = None
 
-    def __init__(self, language=None, show_python=False):
+    def __init__(self, language=None, show_python=False, show_wat=False,
+                 show_rust=False):
         """
         Initialize the REPL.
 
@@ -54,9 +55,13 @@ class REPL:
             language: Source language code (e.g., "en", "fr").
                      If None, auto-detect from input.
             show_python: If True, display generated Python before execution.
+            show_wat: If True, display generated WAT code before execution.
+            show_rust: If True, display generated Rust/Wasmtime code before execution.
         """
         self.language = language
         self.show_python = show_python
+        self.show_wat = show_wat
+        self.show_rust = show_rust
         self._globals = {}
         self._init_globals()
 
@@ -258,12 +263,34 @@ class REPL:
             generator = PythonCodeGenerator()
             python_source = generator.generate(program)
 
+            prefix = ""
+
+            if self.show_wat:
+                try:
+                    # pylint: disable-next=import-outside-toplevel
+                    from multilingualprogramming.codegen.wat_generator import (
+                        WATCodeGenerator,
+                    )
+                    wat_source = WATCodeGenerator().generate(program)
+                    prefix += f"[WAT]\n{wat_source.strip()}\n"
+                except Exception as wat_exc:
+                    prefix += f"[WAT error] {wat_exc}\n"
+
+            if self.show_rust:
+                try:
+                    # pylint: disable-next=import-outside-toplevel
+                    from multilingualprogramming.codegen.wasm_generator import (
+                        WasmCodeGenerator,
+                    )
+                    rust_source = WasmCodeGenerator().generate(program)
+                    prefix += f"[Rust/Wasmtime]\n{rust_source.strip()}\n"
+                except Exception as rust_exc:
+                    prefix += f"[Rust/Wasmtime error] {rust_exc}\n"
+
             if self.show_python:
-                return f"[Python] {python_source.strip()}\n" + self._exec(
-                    python_source
-                )
+                prefix += f"[Python] {python_source.strip()}\n"
 
-            return self._exec(python_source)
+            return prefix + self._exec(python_source)
 
         except Exception as exc:
             return f"Error: {exc}\n"
@@ -399,6 +426,16 @@ class REPL:
             state = "on" if self.show_python else "off"
             print(f"Show Python: {state}")
             return True
+        if cmd == "wat":
+            self.show_wat = not self.show_wat
+            state = "on" if self.show_wat else "off"
+            print(f"Show WAT: {state}")
+            return True
+        if cmd == "rust":
+            self.show_rust = not self.show_rust
+            state = "on" if self.show_rust else "off"
+            print(f"Show Rust/Wasmtime: {state}")
+            return True
         if cmd == "reset":
             self._globals.clear()
             self._init_globals()
@@ -428,6 +465,7 @@ class REPL:
         print(f"Multilingual Programming REPL v{__version__} "
               f"[language={lang_label}]")
         print(
+            "Start with 'multilingual' (default) or 'multilingual repl'.\n"
             f"Type ':help' for commands. Use ':quit' (or Ctrl+C) to exit. "
             f"EOF key is terminal-dependent ({eof_hint}).\n"
         )