pyweb-stack 0.1.0__py3-none-any.whl

pyweb/compiler/ast.py

@@ -0,0 +1,45 @@
+"""Unified AST: Python logic (real `ast` nodes) + UI AST (markup nodes)."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+
+
+@dataclass
+class TextNode:
+    text: str
+    line: int = 0
+
+
+@dataclass
+class ExprNode:
+    code: str
+    line: int = 0
+
+
+@dataclass
+class Element:
+    tag: str
+    attrs: dict
+    children: list
+    line: int = 0
+
+    @property
+    def is_component(self):
+        return bool(self.tag[:1].isupper())
+
+
+@dataclass
+class ControlFor:
+    target: str
+    iterable: str
+    body: list
+    line: int = 0
+
+
+@dataclass
+class ControlIf:
+    test: str
+    body: list
+    orelse: list = field(default_factory=list)
+    line: int = 0

pyweb/compiler/codegen/__init__.py

@@ -0,0 +1,9 @@
+"""Codegen support: the app graph (PIR) used by ``pyweb inspect``.
+
+Browser JavaScript is emitted by :mod:`pyweb.compiler.lower`; HTML is
+rendered by :mod:`pyweb.ssr`.
+"""
+
+from .ir import AppGraph, build_graph
+
+__all__ = ["AppGraph", "build_graph"]

pyweb/compiler/codegen/ir.py

@@ -0,0 +1,50 @@
+"""PyWeb IR (PIR): typed app graph. Textual form is debug-only.
+
+Textual example:
+    page Home("/") signals [count@3] rpc [get_count()->Int@12]
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+
+
+@dataclass
+class IRNode:
+    kind: str
+    name: str
+    type: str = "Any"
+    line: int = 0
+    meta: dict = field(default_factory=dict)
+
+
+@dataclass
+class AppGraph:
+    pages: list = field(default_factory=list)
+    rpc: list = field(default_factory=list)
+    signals: dict = field(default_factory=dict)
+    computeds: dict = field(default_factory=dict)
+    placement: dict = field(default_factory=dict)
+    edges: list = field(default_factory=list)
+    sourcemap: list = field(default_factory=list)  # (generated_desc, source_line)
+
+
+def build_graph(pages, rpc_specs, signals, computeds, placement, edges):
+    g = AppGraph(pages=pages, rpc=rpc_specs, signals=signals,
+                 computeds=computeds, placement=placement, edges=edges)
+    for s in signals:
+        g.sourcemap.append((f"sig:{s}", 0))
+    for r in rpc_specs:
+        g.sourcemap.append((f"rpc:{r['name']}", r["line"]))
+    return g
+
+
+def to_text(g: AppGraph):
+    lines = []
+    for p in g.pages:
+        lines.append(f"page {p['name']}(\"{p['route']}\") signals {p.get('signals', [])} rpc {[r['name'] for r in g.rpc]}")
+    for s, c in g.computeds.items():
+        lines.append(f"  computed {s} = {c['code']} deps {c['deps']}")
+    for sym, (loc, why) in g.placement.items():
+        lines.append(f"  place {sym}: {loc}  # {why}")
+    return "\n".join(lines)

pyweb/compiler/errors.py

@@ -0,0 +1,29 @@
+"""Compiler errors that point at a `.pyweb` file and line."""
+
+from __future__ import annotations
+
+
+class CompileError(ValueError):
+    """A user-facing compile error.
+
+    ``str(err)`` is ``"<file>:<line>: <message>"`` so editors and CI logs
+    can jump to the source; ``err.lineno`` and ``err.msg`` are available
+    separately.
+    """
+
+    def __init__(self, msg, lineno=None, filename=None):
+        self.msg = msg
+        self.lineno = lineno
+        self.filename = filename
+        super().__init__(self._render())
+
+    def _render(self):
+        where = self.filename or "<pyweb>"
+        if self.lineno:
+            where += f":{self.lineno}"
+        return f"{where}: {self.msg}"
+
+    def with_file(self, filename):
+        self.filename = filename
+        self.args = (self._render(),)
+        return self