WASM build

Author: SamuelMarks

.github/workflows/release-wasm.yml

@@ -14,14 +14,19 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+      - name: Install dependencies
+        run: |
+          make install_deps
+          if [ -d .venv ]; then .venv/bin/pip install py2wasm; else pip install py2wasm; fi
+
       - name: Build WASM
         run: |
-          if [ -f Makefile ] && grep -q build_wasm Makefile; then
-            make build_wasm || true
-            cp bin/cdd-python-all.wasm . || echo -n -e '\x00asm\x01\x00\x00\x00' > cdd-python-all.wasm
-          else
-            echo -n -e '\x00asm\x01\x00\x00\x00' > cdd-python-all.wasm
-          fi
+          make build_wasm
+          cp bin/cdd-python-all.wasm .
       - name: Release WASM Artifact
         uses: softprops/action-gh-release@v2
         with:

Makefile

@@ -48,9 +48,9 @@ build:
 	uv build --wheel --out-dir $(BIN_DIR)
 
 build_wasm:
-	@echo "Building WASM to dist/wasm"
-	@mkdir -p dist/wasm
-	@echo "A full CPython WASM standalone build requires Pyodide. Stubbed for now." > dist/wasm/README.txt
+	@echo "Building WASM to bin/"
+	@mkdir -p bin
+	if [ -d .venv ]; then .venv/bin/python3 -m py2wasm src/openapi_client/cli.py -o bin/cdd-python-all.wasm; else py2wasm src/openapi_client/cli.py -o bin/cdd-python-all.wasm; fi
 
 test:
 	.venv/bin/python3 -m pytest tests/ || pytest tests/

WASM.md

@@ -4,7 +4,12 @@ Compiling a pure Python application to a standalone `.wasm` binary that can run
 
 ## Current Status
 
-**Is WASM support possible?** Yes, using Pyodide or similar tools.
-**Is it implemented?** Partial. A stub target `build_wasm` exists in `Makefile`, but true standalone WASM builds of this Python CLI are not fully implemented.
-
-To implement this fully in the future, we could compile a custom Pyodide environment using the Emscripten SDK (`emsdk`) found in `../emsdk`, bundle `openapi-python-client` into the virtual filesystem, and output a packaged JS/WASM bundle that exposes the `cdd-python` CLI via a JavaScript wrapper.
+**Is WASM support possible?** Yes, using `py2wasm`.
+**Is it implemented?** Yes. A `build_wasm` target exists in `Makefile` which compiles the CLI to a standalone `.wasm` binary.
+
+To build it manually:
+```bash
+pip install py2wasm
+make build_wasm
+```
+This produces `bin/cdd-python-all.wasm`.

make.bat

@@ -59,9 +59,13 @@ mkdir "%BIN_DIR%" 2>NUL
 goto :EOF
 
 :build_wasm
-echo Building WASM to dist\wasm
-mkdir dist\wasm 2>NUL
-echo A full CPython WASM standalone build requires Pyodide. Stubbed for now. > dist\wasm\README.txt
+echo Building WASM to bin\
+mkdir bin 2>NUL
+if exist .venv\Scripts\python.exe (
+    .venv\Scripts\python.exe -m py2wasm src\openapi_client\cli.py -o bin\cdd-python-all.wasm
+) else (
+    py2wasm src\openapi_client\cli.py -o bin\cdd-python-all.wasm
+)
 goto :EOF
 
 :test