pyweb-stack 0.2.0__tar.gz → 0.3.0__tar.gz

{pyweb_stack-0.2.0 → pyweb_stack-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyweb-stack
-Version: 0.2.0
+Version: 0.3.0
 Summary: Full-stack web apps in one Python file: server-rendered pages, reactive browser UI, typed RPC.
 Author-email: MaanavKrishna <67054795+MaanavKrishna@users.noreply.github.com>, Claude <noreply@anthropic.com>
 Maintainer-email: MaanavKrishna <67054795+MaanavKrishna@users.noreply.github.com>
@@ -64,6 +64,9 @@ functions, without a JavaScript toolchain.
 ![PyPI](https://img.shields.io/pypi/v/pyweb-stack)
 ![License](https://img.shields.io/badge/license-MIT-lightgrey)
 
+**[Try it in your browser](https://maanavkrishna.github.io/PyWeb/playground.html)**: the playground runs
+the real PyWeb, server functions included, on Python compiled to WebAssembly.
+
 ```pyweb
 from pyweb import App, server
 
@@ -143,8 +146,8 @@ and [current limitations](docs/16-limitations-roadmap.md).
 ## Build it with AI
 
 PyWeb ships an MCP server so AI assistants can scaffold, check, inspect,
-render and test your app, with errors that come back as line numbers and
-fix hints:
+render, screenshot and test your app, with errors that come back as line
+numbers and fix hints:
 
 ```bash
 claude mcp add pyweb -- pyweb mcp          # Claude Code
@@ -185,7 +188,7 @@ a real browser by the test suite.
 | [`todo`](examples/todo/app.pyweb) | components, list mutation, filters, keyed lists |
 | [`blog`](examples/blog/app.pyweb) | SQL database, server functions, route params, 404s, validation errors |
 | [`auth`](examples/auth/app.pyweb) | registration, password hashing, sessions, protected pages |
-| [`chat`](examples/chat/app.pyweb) | route params, shared server state, polling with `on_mount` |
+| [`chat`](examples/chat/app.pyweb) | route params, shared server state, live updates with `publish`/`subscribe` |
 | [`showcase`](examples/showcase/app.pyweb) | everything on one page, with a stylesheet |
 
 ## Command line
@@ -198,13 +201,26 @@ pyweb check app.pyweb                            # compile + security checks for
 pyweb build app.pyweb --out dist --production    # self-contained, hashed, minified dist/
 pyweb serve dist                                 # production server (/healthz, CSP, graceful shutdown)
 pyweb mcp                                        # MCP server for AI assistants (stdio)
+pyweb lsp                                        # language server for editors (stdio)
 ```
 
+Editors: the [VS Code extension](editors/vscode) adds highlighting, errors as you
+type, hover that shows where code runs, completion and go to definition. Any
+other LSP editor can run `pyweb lsp` ([setup](docs/14-cli.md#editor-support)).
+
 ## Status
 
-PyWeb 0.1 is the first public release (beta). The language, server API,
-RPC protocol and CLI are documented and tested, and changes to them are
-announced in the changelog (see [stability](docs/15-toolkit.md#stability)). The test suite covers the
+PyWeb is in beta (0.x; see the PyPI badge above for the latest version).
+The language, server API, RPC protocol and CLI are documented and tested,
+and changes to them are announced in the [changelog](CHANGELOG.md) (see
+[stability](docs/15-toolkit.md#stability)). Upgrade with
+`pip install -U pyweb-stack`.
+
+| Version | Highlights |
+|---|---|
+| 0.3 | Hydration, live updates (SSE), multi-file apps, language server + VS Code extension, browser playground, faster rendering, screenshot/test MCP tools |
+| 0.2 | MCP server for AI assistants, AI guide, project templates, `AGENTS.md`/`CLAUDE.md`, `llms.txt` |
+| 0.1 | First public release: compiler, reactive runtime, server rendering, typed RPC, sessions, databases, CLI | The test suite covers the
 parser, the Python→JavaScript translation (differentially, against
 CPython), the reactive runtime, server rendering, RPC, sessions, every
 example app in Chromium, and the database/Redis layers against real

{pyweb_stack-0.2.0 → pyweb_stack-0.3.0}/README.md

@@ -10,6 +10,9 @@ functions, without a JavaScript toolchain.
 ![PyPI](https://img.shields.io/pypi/v/pyweb-stack)
 ![License](https://img.shields.io/badge/license-MIT-lightgrey)
 
+**[Try it in your browser](https://maanavkrishna.github.io/PyWeb/playground.html)**: the playground runs
+the real PyWeb, server functions included, on Python compiled to WebAssembly.
+
 ```pyweb
 from pyweb import App, server
 
@@ -89,8 +92,8 @@ and [current limitations](docs/16-limitations-roadmap.md).
 ## Build it with AI
 
 PyWeb ships an MCP server so AI assistants can scaffold, check, inspect,
-render and test your app, with errors that come back as line numbers and
-fix hints:
+render, screenshot and test your app, with errors that come back as line
+numbers and fix hints:
 
 ```bash
 claude mcp add pyweb -- pyweb mcp          # Claude Code
@@ -131,7 +134,7 @@ a real browser by the test suite.
 | [`todo`](examples/todo/app.pyweb) | components, list mutation, filters, keyed lists |
 | [`blog`](examples/blog/app.pyweb) | SQL database, server functions, route params, 404s, validation errors |
 | [`auth`](examples/auth/app.pyweb) | registration, password hashing, sessions, protected pages |
-| [`chat`](examples/chat/app.pyweb) | route params, shared server state, polling with `on_mount` |
+| [`chat`](examples/chat/app.pyweb) | route params, shared server state, live updates with `publish`/`subscribe` |
 | [`showcase`](examples/showcase/app.pyweb) | everything on one page, with a stylesheet |
 
 ## Command line
@@ -144,13 +147,26 @@ pyweb check app.pyweb                            # compile + security checks for
 pyweb build app.pyweb --out dist --production    # self-contained, hashed, minified dist/
 pyweb serve dist                                 # production server (/healthz, CSP, graceful shutdown)
 pyweb mcp                                        # MCP server for AI assistants (stdio)
+pyweb lsp                                        # language server for editors (stdio)
 ```
 
+Editors: the [VS Code extension](editors/vscode) adds highlighting, errors as you
+type, hover that shows where code runs, completion and go to definition. Any
+other LSP editor can run `pyweb lsp` ([setup](docs/14-cli.md#editor-support)).
+
 ## Status
 
-PyWeb 0.1 is the first public release (beta). The language, server API,
-RPC protocol and CLI are documented and tested, and changes to them are
-announced in the changelog (see [stability](docs/15-toolkit.md#stability)). The test suite covers the
+PyWeb is in beta (0.x; see the PyPI badge above for the latest version).
+The language, server API, RPC protocol and CLI are documented and tested,
+and changes to them are announced in the [changelog](CHANGELOG.md) (see
+[stability](docs/15-toolkit.md#stability)). Upgrade with
+`pip install -U pyweb-stack`.
+
+| Version | Highlights |
+|---|---|
+| 0.3 | Hydration, live updates (SSE), multi-file apps, language server + VS Code extension, browser playground, faster rendering, screenshot/test MCP tools |
+| 0.2 | MCP server for AI assistants, AI guide, project templates, `AGENTS.md`/`CLAUDE.md`, `llms.txt` |
+| 0.1 | First public release: compiler, reactive runtime, server rendering, typed RPC, sessions, databases, CLI | The test suite covers the
 parser, the Python→JavaScript translation (differentially, against
 CPython), the reactive runtime, server rendering, RPC, sessions, every
 example app in Chromium, and the database/Redis layers against real

{pyweb_stack-0.2.0 → pyweb_stack-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pyweb-stack"
-version = "0.2.0"
+version = "0.3.0"
 description = "Full-stack web apps in one Python file: server-rendered pages, reactive browser UI, typed RPC."
 readme = "README.md"
 license = { text = "MIT" }

{pyweb_stack-0.2.0 → pyweb_stack-0.3.0}/pyweb/__init__.py

@@ -10,6 +10,7 @@ from .jobs import task
 from .context import NotFound, redirect, request, session
 from .rpc import RPCError
 from .decorators import component, edge, server, worker
+from .realtime import channel, publish, subscribe
 
 __all__ = [
     "App",
@@ -22,6 +23,9 @@ __all__ = [
     "edge",
     "server",
     "worker",
+    "channel",
+    "publish",
+    "subscribe",
     "Email",
     "Model",
     "task",

{pyweb_stack-0.2.0 → pyweb_stack-0.3.0}/pyweb/ai/guide.md

@@ -135,8 +135,13 @@ def Home():
 
 Props are parameters (defaults = optional). Pass callbacks as props
 (`on_delete={lambda: delete(i)}`) and use them as handlers inside
-(`onclick={on_delete}`). Components must be in the same file and their
-initial state must be computable in the browser (pass server data as props).
+(`onclick={on_delete}`). A component's initial state must be computable in
+the browser (pass server data as props).
+
+Bigger apps can split into files: put components, `@server` functions and
+constants in e.g. `widgets.pyweb` (or `ui/cards.pyweb`) next to `app.pyweb`
+and `from widgets import Card, save`. Pages stay in `app.pyweb`; import
+server functions without `as`; each file keeps its own constants.
 
 ## 6. Server functions, sessions, routing
 
@@ -167,8 +172,12 @@ def Item(item_id: int):
   `db.execute("select ... where id = ?", (x,)).dicts()`; always use `?`
   parameters; `with db.transaction(): ...`.
 - In handlers, navigate with `window.location.href = "/path"`.
-- Run code after load with a handler named `on_mount` (e.g.
-  `setInterval(refresh, 2000)` for polling).
+- Run code after load with a handler named `on_mount`.
+- Live updates: in a server function `publish("room:1", data)`; in the
+  page `feed = channel("room:1")` (runs on the server); in `on_mount`
+  `subscribe(feed, handler)`, where `handler(message)` assigns page
+  variables. Import all three from `pyweb`. Never poll with
+  `setInterval` when `publish` fits.
 
 ## 7. Python that compiles to the browser
 
@@ -195,7 +204,7 @@ JS functions, server-only names. Move such code into `@server` functions.
 | `cannot assign to ... derived/read-only` | Assign to a variable the handler owns (make it state), not a computed/constant. |
 | `server secret ... would be sent to the browser` | Keep the value inside `@server` functions; don't read it in markup/handlers. |
 | `bind={x} must name a local variable` | Declare `x = ""` (or a number/bool) in the page before the markup. |
-| `unknown component <X>` | Define `def X(...)` with markup in the same file (capitalized). |
+| `unknown component <X>` | Define `def X(...)` with markup (capitalized) in this file, or import it: `from widgets import X`. |
 | `mismatched </tag>` / `is never closed` | Close every tag; void tags (`input`, `img`, `br`) need no close (`<input ... />`). |
 | `... is not supported in browser code` | Rewrite with supported constructs or move it to `@server`. |
 
@@ -208,8 +217,11 @@ JS functions, server-only names. Move such code into `@server` functions.
 3. Use `pyweb inspect` (MCP: `pyweb_inspect`) to confirm what runs in the
    browser vs server and what is sent to the browser.
 4. Verify behaviour: render pages (`pyweb_render`) and call server
-   functions (`pyweb_call`), or write tests with `pyweb.testing.TestClient`.
-5. Ship: `pyweb build app.pyweb --out dist --production` then
+   functions (`pyweb_call`). See the page and try interactions in a real
+   browser with `pyweb_screenshot` (steps: click, fill, press, ...).
+5. Test: new apps include `test_app.py` (`pyweb.testing.TestClient`); add
+   tests for what you change and run `pytest` (MCP: `pyweb_test`).
+6. Ship: `pyweb build app.pyweb --out dist --production` then
    `pyweb serve dist` (set `PYWEB_AUTH_SECRET` in production).
 
 Full docs: https://maanavkrishna.github.io/PyWeb/

{pyweb_stack-0.2.0 → pyweb_stack-0.3.0}/pyweb/app_loader.py

@@ -18,7 +18,7 @@ from .compiler import compile_source
 from .compiler import parser as P
 from .compiler.lower import is_ui_stmt
 from .context import NotFound, Redirect
-from .ssr import Renderer, page_html
+from .ssr import NS_KEY, Renderer, page_html
 
 STATE_PREFIX = "__pyweb_state_"
 
@@ -53,12 +53,30 @@ class LoadedApp:
         self.extra_stylesheets = list(stylesheets or [])
         self.compiled = compile_source(source, filename=self.filename)
         self.ctx = self.compiled["context"]
-        self.module = self._exec()
+        # Other .pyweb files the app imports run as real modules, registered
+        # under their import name so `from widgets import Card` works.
+        self.libraries = self.compiled["libraries"]
+        self.lib_modules = {}
+        for lib in self.libraries:
+            with open(lib.path, encoding="utf-8") as fh:
+                lib_source = fh.read()
+            infos = list(lib.components.values())
+            self.lib_modules[lib.path] = self._exec(lib_source, lib.path, infos, lib.name)
+        self.files = [os.path.abspath(path)] if path else []
+        self.files += [lib.path for lib in self.libraries]
+        infos = [p["info"] for p in self.compiled["pages"].values()]
+        infos += list(self.compiled["components"].values())
+        self.module = self._exec(source, self.filename, infos)
         self.rpc = {}
         for spec in self.compiled["rpc"]:
             fn = self.module.__dict__.get(spec["name"])
             if callable(fn):
                 self.rpc[spec["name"]] = fn
+        for lib in self.libraries:
+            for spec in lib.rpc:
+                fn = self.lib_modules[lib.path].__dict__.get(spec["name"])
+                if callable(fn):
+                    self.rpc[spec["name"]] = fn
         app_obj = next((v for v in self.module.__dict__.values()
                         if type(v).__name__ == "App" and type(v).__module__.startswith("pyweb")), None)
         self.app = app_obj
@@ -67,29 +85,42 @@ class LoadedApp:
         self.lang = getattr(app_obj, "lang", "en") or "en"
 
     # ----------------------------------------------------------- module
-    def _exec(self):
-        py_source, _ui = P.split_sources(self.source)
-        tree = ast.parse(py_source, filename=self.filename)
-        infos = [p["info"] for p in self.compiled["pages"].values()]
-        infos += list(self.compiled["components"].values())
+    def _exec(self, source, filename, infos, module_name=None):
+        py_source, _ui = P.split_sources(source)
+        tree = ast.parse(py_source, filename=filename)
         for info in infos:
             tree.body.append(_state_function(info.node))
-        stem = os.path.splitext(os.path.basename(self.filename))[0] or "app"
-        mod = types.ModuleType(f"pyweb_app_{stem}")
-        mod.__file__ = os.path.abspath(self.filename) if self.path else self.filename
+        stem = os.path.splitext(os.path.basename(filename))[0] or "app"
+        mod = types.ModuleType(module_name or f"pyweb_app_{stem}")
+        mod.__file__ = os.path.abspath(filename) if self.path else filename
         mod.__dict__["__pyweb_ui__"] = lambda *_a: None
         app_dir = os.path.dirname(os.path.abspath(self.path)) if self.path else None
         if app_dir and app_dir not in sys.path:
             sys.path.insert(0, app_dir)
         sys.modules[mod.__name__] = mod
-        exec(compile(tree, self.filename, "exec"), mod.__dict__)  # noqa: S102 - the app itself
+        exec(compile(tree, filename, "exec"), mod.__dict__)  # noqa: S102 - the app itself
         return mod
 
     # -------------------------------------------------------- rendering
-    def _component_state(self, name, props):
-        info = self.compiled["components"][name]
-        fn = self.module.__dict__[STATE_PREFIX + name]
-        env = fn(**{k: v for k, v in props.items() if k in info.params})
+    def _component_state(self, name, props, ns=None):
+        """Run component ``name`` as used by the file ``ns`` (None: the app)."""
+        ctx = ns or self.ctx
+        source = ctx.imported_components.get(name)
+        if source is not None:
+            lib, name = source
+            ctx, module = lib.ctx, self.lib_modules[lib.path]
+        else:
+            module = self.module if ctx is self.ctx else next(
+                self.lib_modules[lib.path] for lib in self.libraries if lib.ctx is ctx)
+        info = ctx.components[name]
+        fn = module.__dict__[STATE_PREFIX + name]
+        local = fn(**{k: v for k, v in props.items() if k in info.params})
+        if module is self.module:
+            return info.ui, local
+        # Markup in another file sees that file's globals.
+        env = {k: v for k, v in module.__dict__.items() if not k.startswith("__")}
+        env.update(local)
+        env[NS_KEY] = ctx
         return info.ui, env
 
     def renderer(self):

{pyweb_stack-0.2.0 → pyweb_stack-0.3.0}/pyweb/asgi.py

@@ -20,6 +20,27 @@ import asyncio
 from .hosting import Site
 
 
+async def _stream(stream, receive, send):
+    """Send an event stream until it ends or the client disconnects."""
+    async def watch():
+        while (await receive())["type"] != "http.disconnect":
+            pass
+        stream.close()
+
+    watcher = asyncio.ensure_future(watch())
+    try:
+        async for chunk in stream.aiter():
+            if watcher.done():
+                break
+            await send({"type": "http.response.body", "body": chunk, "more_body": True})
+        await send({"type": "http.response.body", "body": b""})
+    except OSError:
+        pass
+    finally:
+        stream.close()
+        watcher.cancel()
+
+
 def create_app(target="app.pyweb", *, debug=False, max_body=1_048_576, **server_kwargs):
     """Return an ASGI 3 application serving ``target`` (a `.pyweb` file or dist dir)."""
     site = Site(target, debug=debug, max_body=max_body, **server_kwargs)
@@ -62,6 +83,10 @@ def create_app(target="app.pyweb", *, debug=False, max_body=1_048_576, **server_
             status, hdrs, body = await asyncio.to_thread(
                 site.respond, scope.get("method", "GET"), path, headers, b"".join(chunks))
         raw_headers = [(k.lower().encode("latin-1"), v.encode("latin-1")) for k, v in hdrs]
+        if hasattr(body, "aiter"):  # Server-Sent Events
+            await send({"type": "http.response.start", "status": status, "headers": raw_headers})
+            await _stream(body, receive, send)
+            return
         if not any(k == b"content-length" for k, _ in raw_headers):
             raw_headers.append((b"content-length", str(len(body)).encode()))
         await send({"type": "http.response.start", "status": status, "headers": raw_headers})

{pyweb_stack-0.2.0 → pyweb_stack-0.3.0}/pyweb/auth.py

@@ -37,14 +37,36 @@ def _b64d(data: str) -> bytes:
     return base64.urlsafe_b64decode(data + "=" * (-len(data) % 4))
 
 
+def _pbkdf2_sha256(password: bytes, salt: bytes, iterations: int) -> bytes:
+    """PBKDF2-HMAC-SHA256 (32-byte key). Uses hashlib's C version when it
+    exists; Pythons built without OpenSSL (e.g. Pyodide) get this pure
+    Python one, which gives the same result."""
+    fast = getattr(hashlib, "pbkdf2_hmac", None)
+    if fast is not None:
+        return fast("sha256", password, salt, iterations)
+    mac = hmac.new(password, digestmod=hashlib.sha256)
+
+    def prf(data):
+        m = mac.copy()
+        m.update(data)
+        return m.digest()
+
+    u = prf(salt + b"\x00\x00\x00\x01")
+    acc = int.from_bytes(u, "big")
+    for _ in range(iterations - 1):
+        u = prf(u)
+        acc ^= int.from_bytes(u, "big")
+    return acc.to_bytes(32, "big")
+
+
 def hash_password(password, *, salt=None, rounds=None, iterations=_ITERATIONS):
     if salt is None:
         salt_bytes = secrets.token_bytes(16)
-        dk = hashlib.pbkdf2_hmac("sha256", password.encode(), salt_bytes, iterations)
+        dk = _pbkdf2_sha256(password.encode(), salt_bytes, iterations)
         return f"{_HASH_ALGO}${iterations}${_b64e(salt_bytes)}${_b64e(dk)}"
     salt_bytes = salt if isinstance(salt, bytes) else bytes.fromhex(salt)
     n = rounds if rounds is not None else iterations
-    dk = hashlib.pbkdf2_hmac("sha256", password.encode(), salt_bytes, n)
+    dk = _pbkdf2_sha256(password.encode(), salt_bytes, n)
     return f"pbkdf2${n}${salt_bytes.hex()}${dk.hex()}"
 
 
@@ -63,7 +85,7 @@ def verify_password(password, stored):
             expected = bytes.fromhex(dk_part)
     except (ValueError, base64.binascii.Error):
         return False
-    candidate = hashlib.pbkdf2_hmac("sha256", password.encode(), salt, iters_i)
+    candidate = _pbkdf2_sha256(password.encode(), salt, iters_i)
     if algo == _HASH_ALGO:
         return hmac.compare_digest(candidate, expected)
     return hmac.compare_digest(candidate.hex(), expected.hex() if isinstance(expected, bytes) else dk_part)

{pyweb_stack-0.2.0 → pyweb_stack-0.3.0}/pyweb/bench.py

@@ -87,15 +87,39 @@ def run(apps=None) -> dict:
     return {name: bench_app(name, src) for name, src in apps.items()}
 
 
-def main():
+def over_budget(results, *, max_ssr_ms=None, max_compile_ms=None) -> list:
+    """Lines describing every app that exceeds a budget."""
+    out = []
+    for r in results.values():
+        if max_ssr_ms is not None and r["ssr_ms"] > max_ssr_ms:
+            out.append(f"{r['app']}: server render {r['ssr_ms']} ms > {max_ssr_ms} ms")
+        if max_compile_ms is not None and r["compile_ms"] > max_compile_ms:
+            out.append(f"{r['app']}: compile {r['compile_ms']} ms > {max_compile_ms} ms")
+    return out
+
+
+def main(argv=None):
+    import argparse
+    import sys
+    ap = argparse.ArgumentParser(prog="python -m pyweb.bench", description="Measure compile time, "
+                                 "shipped JavaScript and server render time.")
+    ap.add_argument("--json", action="store_true", help="print only JSON")
+    ap.add_argument("--max-ssr-ms", type=float, help="fail if any server render is slower")
+    ap.add_argument("--max-compile-ms", type=float, help="fail if any compile is slower")
+    args = ap.parse_args(argv)
     results = run()
     print(json.dumps(results, indent=2))
-    rt = runtime_sizes()
-    print(f"\nshared runtime: {rt['bytes']} B minified, {rt['gzip_bytes']} B gzip "
-          "(downloaded once, cached across pages)")
-    for r in results.values():
-        print(f"{r['app']:>8}: page JS {r['page_js_gzip']} B gzip, server render {r['ssr_ms']} ms")
+    if not args.json:
+        rt = runtime_sizes()
+        print(f"\nshared runtime: {rt['bytes']} B minified, {rt['gzip_bytes']} B gzip "
+              "(downloaded once, cached across pages)")
+        for r in results.values():
+            print(f"{r['app']:>8}: page JS {r['page_js_gzip']} B gzip, server render {r['ssr_ms']} ms")
+    failed = over_budget(results, max_ssr_ms=args.max_ssr_ms, max_compile_ms=args.max_compile_ms)
+    for line in failed:
+        print("over budget:", line, file=sys.stderr)
+    return 1 if failed else 0
 
 
 if __name__ == "__main__":
-    main()
+    raise SystemExit(main())

{pyweb_stack-0.2.0 → pyweb_stack-0.3.0}/pyweb/build.py

@@ -235,6 +235,13 @@ def build(compiled: dict, out: str, *, minifier=None, extract_css=True,
     if source is not None:
         with open(f"{out}/app.pyweb", "w", encoding="utf-8") as fh:
             fh.write(source)
+        # Other .pyweb files the app imports, at the same relative paths.
+        for lib in compiled.get("libraries", []):
+            rel = os.path.relpath(lib.path, app_dir) if app_dir else os.path.basename(lib.path)
+            if rel.startswith(".."):
+                rel = os.path.basename(lib.path)
+            os.makedirs(os.path.dirname(os.path.join(out, rel)) or out, exist_ok=True)
+            shutil.copyfile(lib.path, os.path.join(out, rel))
     try:
         from pyweb import __version__ as pyweb_version
     except ImportError:  # pragma: no cover

{pyweb_stack-0.2.0 → pyweb_stack-0.3.0}/pyweb/cli/__init__.py

@@ -139,14 +139,8 @@ def cmd_dev(args):
 
     class H(http.server.BaseHTTPRequestHandler):
         def _send(self, status, headers, body):
-            self.send_response(status)
-            for k, v in headers:
-                if k.lower() != "content-length":
-                    self.send_header(k, v)
-            self.send_header("Content-Length", str(len(body)))
-            self.end_headers()
-            if self.command != "HEAD":
-                self.wfile.write(body)
+            from pyweb.hosting import write_http
+            write_http(self, status, headers, body, head=self.command == "HEAD")
 
         def _handle(self, method, body=b""):
             if self.path == "/__pyweb/dev/version":
@@ -157,7 +151,7 @@ def cmd_dev(args):
                 return self._send(500, [("Content-Type", "text/html; charset=utf-8")], html)
             status, headers, raw = state.site.respond(method, self.path, dict(self.headers), body)
             ctype = next((v for k, v in headers if k.lower() == "content-type"), "")
-            if ctype.startswith("text/html") and b"</body>" in raw:
+            if ctype.startswith("text/html") and isinstance(raw, bytes) and b"</body>" in raw:
                 raw = raw.replace(b"</body>", DEV_RELOAD_JS.encode() + b"</body>", 1)
             return self._send(status, headers, raw)
 
@@ -393,6 +387,12 @@ def cmd_new(args):
     print(f"next: cd {args.name} && pyweb dev app.pyweb")
 
 
+def cmd_lsp(args):
+    """Language server for editors (stdio)."""
+    from pyweb.lsp import serve_stdio
+    serve_stdio()
+
+
 def cmd_mcp(args):
     from pyweb.mcp import serve_stdio
     serve_stdio()
@@ -410,6 +410,7 @@ def main(argv=None):
     p = sub.add_parser("db"); p.add_argument("db_action", choices=["migrate", "new", "status", "rollback"]); p.add_argument("--database", default=None); p.add_argument("--migrations", default="migrations"); p.add_argument("--name", default="migration"); p.add_argument("--steps", type=int, default=1, help="rollback: how many applied migrations to revert"); p.add_argument("--to", default=None, help="rollback: revert everything applied after this label"); p.set_defaults(fn=cmd_db)
     p = sub.add_parser("new"); p.add_argument("name"); p.add_argument("--template", default="counter", choices=["blank", "counter", "todo", "blog", "auth", "chat"], help="starter app"); p.set_defaults(fn=cmd_new)
     p = sub.add_parser("mcp", help="run the MCP server (stdio) for AI assistants"); p.set_defaults(fn=cmd_mcp)
+    p = sub.add_parser("lsp", help="run the language server (stdio) for editors"); p.set_defaults(fn=cmd_lsp)
     p = sub.add_parser("check"); p.add_argument("file"); p.set_defaults(fn=cmd_check)
     p = sub.add_parser("npm"); p.add_argument("dts"); p.add_argument("-o", "--out", default=None); p.set_defaults(fn=cmd_npm)
     p = sub.add_parser("deploy")