browser-py 0.1.0__py3-none-any.whl

browser_compile.py

@@ -0,0 +1,27 @@
+from pathlib import Path
+from shutil import copyfile
+from tempfile import TemporaryDirectory
+
+from javascript_output import write_javascript
+from numeric_ir import emit_module, load_ir
+from numeric_source import read_numeric_source
+
+
+def compile_modules(source: Path, output: Path, minified: bool) -> Path:
+   source = source.resolve()
+   if source.suffix == ".py" and source.stem.isidentifier() and not source.stem.startswith("__"):
+      admitted = read_numeric_source(source)
+   else:
+      raise ValueError("Expected a named Python module, not an entry file")
+   modules = load_ir(tuple(admitted.trees))
+   # Admission supplies checked schemas to emission; the build publishes staged files only after every module succeeds.
+   with TemporaryDirectory(prefix="browser-py-output-", dir="/tmp") as temporary:
+      staging = Path(temporary)
+      for path in admitted.trees:
+         compiled = emit_module(modules[path.stem], admitted.schemas[path])
+         write_javascript(compiled[0], staging / f"{path.stem}.js", minified)
+         (staging / f"{path.stem}.ir").write_text(compiled[1])
+      output.mkdir(parents=True, exist_ok=True)
+      for artifact in sorted(staging.iterdir()):
+         copyfile(artifact, output / artifact.name)
+   return output / f"{source.stem}.js"

browser_py-0.1.0.dist-info/METADATA

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: browser-py
+Version: 0.1.0
+Summary: An experimental Python-to-browser compiler and Transcrypt competitor
+Requires-Python: <3.13,>=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: rjsmin==1.2.5
+Requires-Dist: mypy==1.18.2
+Requires-Dist: setuptools>=68
+Provides-Extra: tools
+Requires-Dist: playwright<2,>=1.56; extra == "tools"
+Requires-Dist: pscript<0.9,>=0.8; extra == "tools"
+Requires-Dist: wgpu==0.29.0; extra == "tools"
+Requires-Dist: glfw<3,>=2.9; extra == "tools"
+Provides-Extra: test
+Requires-Dist: browser-py[tools]; extra == "test"
+Requires-Dist: pytest<10,>=9; extra == "test"
+Requires-Dist: ruff<1,>=0.14; extra == "test"
+
+# browser-py
+
+An experimental Python-to-browser compiler, built as a competitor to Transcrypt.
+Write Python and compile it for the browser.
+
+It supports typed numeric code and a small browser-facing subset, not arbitrary
+Python packages. Compilation, browser examples, and checks work without Transcrypt.
+
+Install with Python 3.12:
+
+```sh
+python -m pip install browser-py
+browser-py compile path/to/your_module.py
+browser-py --help
+```
+
+In a source checkout, the equivalent compiler command is:
+
+```sh
+python -B browser_py.py compile source/kernels.py
+```
+
+Compiled files are saved to temporary storage; the command prints their location.
+Compiler comparisons and the triangle demo are supporting tools, available in the
+source checkout or source distribution (not the compiler wheel). Install the `tools`
+extra to use them:
+
+```sh
+python -m pip install 'browser-py[tools]'
+python -B source/__comparison__.py --help
+```
+
+For development, install the `test` extra and run `python -B browser_py.py validate`
+from a source checkout.

browser_py-0.1.0.dist-info/RECORD

@@ -0,0 +1,12 @@
+browser_compile.py,sha256=hIN7dYpZKWP-jhQZTRvs-krDW04e0EvLsNCd4_Rq9RI,1281
+browser_source.py,sha256=_DSWhBAixRhgmMSoP0iiSQuOfVkflYFnEjgh_24G8DQ,25055
+compiler_command.py,sha256=NvRNkdKueKTdSMfkvF2FaO_uu_uJN0meKlmU5O90zfw,2347
+javascript_output.py,sha256=6YrZFEluD7kH47OMZlAEjAe5e4i3QOuSfanEH19tEqo,216
+numeric_ir.py,sha256=xrwNuicTiLiaX967z1ZQib4QbzzRjBYMWA8qH8XL9Zo,12234
+numeric_source.py,sha256=pSwxRP7k45zOFvAMBBoz8sLQAE6KnbtLZSdbuc36Lcs,10631
+webgpu_bindings.py,sha256=HygHTpUzbzcNtGgRaojnQulKrQg6oxGTlhGDw--zZUU,12420
+browser_py-0.1.0.dist-info/METADATA,sha256=sugmh6G75DB7ksVclVY-qQQ3Of_UVW2n2QINEcHHVGc,1701
+browser_py-0.1.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+browser_py-0.1.0.dist-info/entry_points.txt,sha256=39C6ZOQHCkpCRWuqm5aElJw24tz_ACf8ZY8sWKgST-0,53
+browser_py-0.1.0.dist-info/top_level.txt,sha256=NnxXBf2ODGK3hITzPj40Z3Z-KcCNFA9mrwfVMxbySYc,108
+browser_py-0.1.0.dist-info/RECORD,,

browser_py-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

browser_py-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+browser-py = compiler_command:main

browser_py-0.1.0.dist-info/top_level.txt

@@ -0,0 +1,7 @@
+browser_compile
+browser_source
+compiler_command
+javascript_output
+numeric_ir
+numeric_source
+webgpu_bindings