Files
python-editor/scripts/serve_static_editor.py
Jimmy ca0ca6fe7e Add local-mode workspace, ZIP import/export, and richer pin/ADC/serial sims
Boot:
- Editor now picks local vs server mode based on URL flag, sign-in
  state, and a stale local-mode flag. Signed-in users are no longer
  bounced to IndexedDB if they had previously clicked "Use locally".

Local mode:
- New LocalWorkspaceClient (src/static/local-workspace.js) with
  pluggable IndexedDB and File System Access backends. Picked folder
  handles persist across reloads with a Reconnect button when the
  permission lapses.
- Static-only host: scripts/serve_static_editor.py serves src/static/
  with COOP/COEP so SharedArrayBuffer-backed sims keep working.
- Bundled MicroPython stubs ship under src/static/bundled-lib/ for
  static hosting; FastAPI also exposes them at /api/public/lib-bundle.

Workspace import / export:
- Zero-dep ZIP encoder + reader (STORE + DEFLATE via
  DecompressionStream). Export/Import buttons in the workspace badge
  work in both local and server modes; imports are confined to code/.

Pin / ADC / Serial simulation:
- machine.py grows ADC, UART, expanded Pin, and PWM mocks, all driven
  by SharedArrayBuffer when cross-origin isolated and falling back to
  postMessage + [pin-out] stdout markers otherwise — pins, ADC slider,
  and serial input now keep working over plain HTTP / LAN-IP origins.
- NeoPixel pins are claimed via a [pin-claim] marker and dropped from
  the Pins panel so the data line doesn't flicker per write().
- New demos: adc_slider_demo.py, pin_demo.py, serial_demo.py.

Lib layout:
- Single source of truth at repo lib/; workspace/lib/ caching layer
  removed and the directory deleted. Filesystem service reads stubs
  directly from PROJECT_ROOT/lib.

UI:
- Home page slimmed to "Sign in" + "Use locally" with optional editor
  / manage-users links. Admin user/invite UI moved to /users.
- Workspace badge gains storage indicator, Folder…/Reconnect, Export,
  Import, and Exit controls.
- Mobile-friendly tweaks: safer-area padding, larger touch targets,
  iOS-zoom-proof serial input, file-tree highlight fix.

Tests:
- test_auth.py patches PROJECT_ROOT for the lib-shared test so the
  repo-root lib refactor stays green. test_api.py asserts the new
  "LED Editor" branding.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-05-10 06:16:02 +12:00

75 lines
2.9 KiB
Python

#!/usr/bin/env python3
"""Serve only the contents of `src/static/` (HTML, CSS, JS, bundled stubs).
Use this with **local mode** in the editor (`?local=1`): files live in IndexedDB,
so no FastAPI file API is required. Maps `/` and `/editor` to `home.html` /
`index.html` so links from the home page keep working.
Sends ``Cross-Origin-Opener-Policy: same-origin`` and
``Cross-Origin-Embedder-Policy: credentialless`` on every response so the page
can become cross-origin isolated (SharedArrayBuffer for live ADC / pins /
serial), matching the full FastAPI app.
Example:
python scripts/serve_static_editor.py
# open http://127.0.0.1:8765/ then "Use locally" → /editor?local=1
Note: Pyodide and CodeMirror still load from CDNs; you need network access.
"""
from __future__ import annotations
import argparse
from functools import partial
from http.server import SimpleHTTPRequestHandler, ThreadingHTTPServer
from pathlib import Path
def main() -> None:
parser = argparse.ArgumentParser(description=__doc__.split("\n\n")[0])
parser.add_argument("--host", default="127.0.0.1", help="Bind address (default 127.0.0.1)")
parser.add_argument("--port", type=int, default=8765, help="Port (default 8765)")
args = parser.parse_args()
static_root = (Path(__file__).resolve().parent.parent / "src" / "static").resolve()
if not static_root.is_dir():
raise SystemExit(f"Static directory not found: {static_root}")
class Handler(SimpleHTTPRequestHandler):
def __init__(self, *a, **kw):
super().__init__(*a, directory=str(static_root), **kw)
def end_headers(self):
self.send_header("Cross-Origin-Opener-Policy", "same-origin")
self.send_header("Cross-Origin-Embedder-Policy", "credentialless")
super().end_headers()
def translate_path(self, path: str) -> str:
clean = path.split("?", 1)[0].split("#", 1)[0]
if clean.startswith("/static/"):
clean = clean[len("/static") :] # e.g. /styles.css, /bundled-lib/machine.py
if clean in ("/", ""):
clean = "/home.html"
elif clean == "/editor" or clean.startswith("/editor/"):
clean = "/index.html"
elif clean == "/tutorial" or clean.startswith("/tutorial/"):
clean = "/tutorial.html"
elif clean == "/login" or clean.startswith("/login/"):
clean = "/login.html"
elif clean == "/register" or clean.startswith("/register/"):
clean = "/register.html"
return super().translate_path(clean)
httpd = ThreadingHTTPServer((args.host, args.port), Handler)
print(f"Serving {static_root} at http://{args.host}:{args.port}/")
print("Open / then use “Use locally” for IndexedDB workspace.")
try:
httpd.serve_forever()
except KeyboardInterrupt:
print("\nStopped.")
if __name__ == "__main__":
main()