multilingualprogramming 0.2.0__tar.gz → 0.5.1__tar.gz

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

@@ -1,21 +1,23 @@
 Metadata-Version: 2.4
 Name: multilingualprogramming
-Version: 0.2.0
+Version: 0.5.1
 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.5.1/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.5.1}/multilingualprogramming/__init__.py

@@ -30,11 +30,19 @@ 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
 from multilingualprogramming.core.ir import CoreIRProgram
 from multilingualprogramming.core.lowering import lower_to_core_ir
+from multilingualprogramming.runtime.numeric_primitives import (
+    Vec2,
+    ComplexScalar,
+    FastRNG,
+    BoundedArray,
+    MinDistanceAccumulator,
+)
 from multilingualprogramming.imports import (
     enable_multilingual_imports, disable_multilingual_imports,
 )
@@ -63,12 +71,18 @@ __all__ = [
     "SemanticAnalyzer",
     "ErrorMessageRegistry",
     "PythonCodeGenerator",
+    "WATCodeGenerator",
     "RuntimeBuiltins",
     "ProgramExecutor",
     "ExecutionResult",
     "REPL",
     "CoreIRProgram",
     "lower_to_core_ir",
+    "Vec2",
+    "ComplexScalar",
+    "FastRNG",
+    "BoundedArray",
+    "MinDistanceAccumulator",
     "enable_multilingual_imports",
     "disable_multilingual_imports",
 ]