pawui 0.1.0__tar.gz

pawui-0.1.0/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: pawui
+Version: 0.1.0
+Summary: 轻量、直接运行的 Python 声明式 UI 层
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: User Interfaces
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: PySide6>=6.5
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-qt>=4.2; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: twine>=4.0; extra == "dev"
+
+# PawUI
+
+轻量、直接运行的 Python 声明式 UI 层。HTML 风格，Qt/PySide6 渲染（原生抗锯齿、QSS 圆角/悬停/聚焦、IME 组字正常），无构建。
+
+## 运行
+
+```bash
+pawui app.paw
+```
+
+也可以传统方式启动：
+
+```python
+import pawui
+pawui.run("app.paw")
+```
+
+## 语法（HTML 风格）
+
+```html
+<Window title="你好" width="460" height="840" theme="dark">
+  <Column padding="24" spacing="12">
+    <Text size="24" bold>欢迎使用 PawUI 👋</Text>
+    <Text size="13" color="subtext">副标题</Text>
+
+    <Text>{$greeting}</Text>
+
+    <Row spacing="8">
+      <Button on_click="increment">点我 +1</Button>
+      <Button on_click="reset">清空</Button>
+    </Row>
+
+    <Input placeholder="输入你的名字..." on_change="on_name"/>
+    <Text>你好，{$name}</Text>
+
+    <Card label="点击量" value="{$count}"/>
+  </Column>
+</Window>
+
+<!-- 自定义组件 -->
+<Component name="Card">
+  <Column padding="12" bg="surface">
+    <Text color="subtext">{$label}</Text>
+    <Text size="22" bold>{$value}</Text>
+  </Column>
+</Component>
+
+<script>
+def increment():
+    state.count = int(state.get("count", 0)) + 1
+</script>
+```
+
+## 要点
+
+- **状态绑定**：`{$count}` / `{count}` / `$count`，在 `<script>` 里改 `state.count = ...` 界面自动刷新。
+- **事件**：字符串引用 `<script>` / `main.py` 里的函数：`on_click="函数名"`。
+- **组件**：`<Component name="X">...</Component>` 定义，直接 `<X .../>` 使用。
+- **主题**：`theme="dark" | "light"`，颜色可直接引用：`color="subtext"`、`bg="surface"`。
+- **布局**：`Column` 纵排、`Row` 横排，`spacing` / `padding` 调节。
+
+## 内置组件
+
+`Window` `Column` `Row` `Text` `Button` `Input` `Checkbox`（开关） `Divider` `Spacer` `If`（条件渲染） `For`（列表循环）
+
+```html
+<For each="item" in="{$items}">
+  <If condition="{$item.done}">
+    <Text>{$item.name}</Text>
+  </If>
+</For>
+```
+
+## CLI
+
+```bash
+pawui run app.paw      # 运行（或直接 pawui app.paw）
+pawui check app.paw    # 仅语法检查
+pawui schema           # 输出组件 JSON Schema
+pawui render app.paw   # 离屏渲染自检
+pawui --version
+```

pawui-0.1.0/README.md

@@ -0,0 +1,82 @@
+# PawUI
+
+轻量、直接运行的 Python 声明式 UI 层。HTML 风格，Qt/PySide6 渲染（原生抗锯齿、QSS 圆角/悬停/聚焦、IME 组字正常），无构建。
+
+## 运行
+
+```bash
+pawui app.paw
+```
+
+也可以传统方式启动：
+
+```python
+import pawui
+pawui.run("app.paw")
+```
+
+## 语法（HTML 风格）
+
+```html
+<Window title="你好" width="460" height="840" theme="dark">
+  <Column padding="24" spacing="12">
+    <Text size="24" bold>欢迎使用 PawUI 👋</Text>
+    <Text size="13" color="subtext">副标题</Text>
+
+    <Text>{$greeting}</Text>
+
+    <Row spacing="8">
+      <Button on_click="increment">点我 +1</Button>
+      <Button on_click="reset">清空</Button>
+    </Row>
+
+    <Input placeholder="输入你的名字..." on_change="on_name"/>
+    <Text>你好，{$name}</Text>
+
+    <Card label="点击量" value="{$count}"/>
+  </Column>
+</Window>
+
+<!-- 自定义组件 -->
+<Component name="Card">
+  <Column padding="12" bg="surface">
+    <Text color="subtext">{$label}</Text>
+    <Text size="22" bold>{$value}</Text>
+  </Column>
+</Component>
+
+<script>
+def increment():
+    state.count = int(state.get("count", 0)) + 1
+</script>
+```
+
+## 要点
+
+- **状态绑定**：`{$count}` / `{count}` / `$count`，在 `<script>` 里改 `state.count = ...` 界面自动刷新。
+- **事件**：字符串引用 `<script>` / `main.py` 里的函数：`on_click="函数名"`。
+- **组件**：`<Component name="X">...</Component>` 定义，直接 `<X .../>` 使用。
+- **主题**：`theme="dark" | "light"`，颜色可直接引用：`color="subtext"`、`bg="surface"`。
+- **布局**：`Column` 纵排、`Row` 横排，`spacing` / `padding` 调节。
+
+## 内置组件
+
+`Window` `Column` `Row` `Text` `Button` `Input` `Checkbox`（开关） `Divider` `Spacer` `If`（条件渲染） `For`（列表循环）
+
+```html
+<For each="item" in="{$items}">
+  <If condition="{$item.done}">
+    <Text>{$item.name}</Text>
+  </If>
+</For>
+```
+
+## CLI
+
+```bash
+pawui run app.paw      # 运行（或直接 pawui app.paw）
+pawui check app.paw    # 仅语法检查
+pawui schema           # 输出组件 JSON Schema
+pawui render app.paw   # 离屏渲染自检
+pawui --version
+```

pawui-0.1.0/pawui/__init__.py

@@ -0,0 +1,6 @@
+"""PawUI - 轻量、直接运行的 Python 声明式 UI 层。"""
+
+from .cli import main, run
+
+__all__ = ["run", "main"]
+__version__ = "0.1.0"

pawui-0.1.0/pawui/__main__.py

@@ -0,0 +1,6 @@
+"""支持 ``python -m pyx app.pyx``。"""
+
+from .cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

pawui-0.1.0/pawui/animate.py

@@ -0,0 +1,99 @@
+"""PawUI 动画：声明式入场动画 + 缓动曲线。
+
+用法（在 .paw 里）：
+    <Card animate="slide-up" duration="320" delay="60" easing="out-back"/>
+    <Column stagger="60"> ... </Column>   # 子元素逐个入场
+"""
+
+from __future__ import annotations
+
+from PySide6.QtCore import (
+    QEasingCurve,
+    QParallelAnimationGroup,
+    QPoint,
+    QPropertyAnimation,
+    QTimer,
+)
+from PySide6.QtWidgets import QGraphicsOpacityEffect, QWidget
+
+_EASINGS = {
+    "linear": QEasingCurve.Type.Linear,
+    "in-cubic": QEasingCurve.Type.InCubic,
+    "out-cubic": QEasingCurve.Type.OutCubic,
+    "in-out-cubic": QEasingCurve.Type.InOutCubic,
+    "out-quad": QEasingCurve.Type.OutQuad,
+    "out-quart": QEasingCurve.Type.OutQuart,
+    "out-back": QEasingCurve.Type.OutBack,
+    "out-elastic": QEasingCurve.Type.OutElastic,
+}
+
+_SLIDE = {
+    "slide-up": (0, 22),
+    "slide-down": (0, -22),
+    "slide-left": (22, 0),
+    "slide-right": (-22, 0),
+}
+
+_KINDS = {"fade", "reveal", "slide-up", "slide-down", "slide-left", "slide-right"}
+
+
+def easing(name: str) -> QEasingCurve.Type:
+    return _EASINGS.get(name, QEasingCurve.Type.OutCubic)
+
+
+def is_animation(kind: str) -> bool:
+    return kind in _KINDS
+
+
+def entrance(widget: QWidget, kind: str, duration: int = 260, delay: int = 0,
+             curve: str = "out-cubic") -> QParallelAnimationGroup:
+    """给一个控件做入场动画：淡入 + 可选位移/高度展开。"""
+    group = QParallelAnimationGroup(widget)
+
+    effect = QGraphicsOpacityEffect(widget)
+    effect.setOpacity(0.0)
+    widget.setGraphicsEffect(effect)
+    fade = QPropertyAnimation(effect, b"opacity")
+    fade.setDuration(duration)
+    fade.setStartValue(0.0)
+    fade.setEndValue(1.0)
+    fade.setEasingCurve(easing(curve))
+    group.addAnimation(fade)
+
+    pos_anim = None
+    height_anim = None
+    if kind in _SLIDE:
+        pos_anim = QPropertyAnimation(widget, b"pos")
+        pos_anim.setDuration(duration)
+        pos_anim.setEasingCurve(easing(curve))
+        group.addAnimation(pos_anim)
+    elif kind == "reveal":
+        height_anim = QPropertyAnimation(widget, b"maximumHeight")
+        height_anim.setDuration(duration)
+        height_anim.setEasingCurve(easing(curve))
+        group.addAnimation(height_anim)
+
+    def _start() -> None:
+        if pos_anim is not None:
+            end = widget.pos()
+            dx, dy = _SLIDE[kind]
+            pos_anim.setStartValue(end + QPoint(dx, dy))
+            pos_anim.setEndValue(end)
+        if height_anim is not None:
+            height_anim.setStartValue(0)
+            height_anim.setEndValue(max(widget.sizeHint().height(), widget.height()))
+        group.start()
+
+    QTimer.singleShot(max(0, delay), _start)
+    return group
+
+
+def fade_window(window: QWidget, duration: int = 200) -> QPropertyAnimation:
+    """主题切换时给窗口来一下淡入。"""
+    anim = QPropertyAnimation(window, b"windowOpacity")
+    anim.setDuration(duration)
+    anim.setStartValue(0.55)
+    anim.setEndValue(1.0)
+    anim.setEasingCurve(QEasingCurve.Type.OutCubic)
+    anim.start()
+    return anim

pawui-0.1.0/pawui/cli.py

@@ -0,0 +1,272 @@
+"""PawUI 命令行入口：``pawui app.paw`` 直接运行。"""
+
+from __future__ import annotations
+
+import json
+import sys
+from pathlib import Path
+from typing import Any
+
+from .errors import PyxError
+from .parser import parse
+from .runtime import Runtime
+
+USAGE = """\
+PawUI - 轻量、直接运行的 Python 声明式 UI 层
+
+用法:
+  pawui <file.paw>            直接运行一个 .paw 文件
+  pawui run <file.paw>        同上（显式子命令）
+  pawui check <file.paw>      语法检查，不运行
+  pawui schema                输出组件 Schema (JSON)
+  pawui render <file.paw>     离屏渲染并输出信息
+  pawui --version             打印版本
+  pawui --help                显示帮助
+
+示例:
+  pawui app.paw
+  pawui check app.paw
+  pawui schema
+  pawui render app.paw
+"""
+
+
+SCHEMA = {
+    "components": {
+        "Window": {
+            "props": {
+                "title": {"type": "string", "default": "PawUI"},
+                "width": {"type": "integer", "default": 480},
+                "height": {"type": "integer", "default": 640},
+                "theme": {"type": "string", "enum": ["dark", "light"], "default": "dark"},
+                "padding": {"type": "integer", "default": 0},
+                "spacing": {"type": "integer", "default": 8},
+            },
+            "description": "Root window (exactly one per file)",
+        },
+        "Column": {
+            "props": {
+                "padding": {"type": ["integer", "array"], "default": 12},
+                "spacing": {"type": "integer", "default": 8},
+                "bg": {"type": "string", "description": "Background color"},
+                "radius": {"type": "integer", "default": 24},
+                "expand": {"type": "boolean", "default": False},
+                "stagger": {"type": "integer", "default": 0},
+            },
+            "description": "Vertical container",
+        },
+        "Row": {
+            "props": {
+                "padding": {"type": ["integer", "array"], "default": 12},
+                "spacing": {"type": "integer", "default": 8},
+                "bg": {"type": "string", "description": "Background color"},
+                "radius": {"type": "integer", "default": 24},
+                "expand": {"type": "boolean", "default": False},
+                "stagger": {"type": "integer", "default": 0},
+            },
+            "description": "Horizontal container",
+        },
+        "Text": {
+            "props": {
+                "size": {"type": "integer", "default": 12},
+                "bold": {"type": "boolean", "default": False},
+                "italic": {"type": "boolean", "default": False},
+                "color": {"type": "string", "default": "text"},
+                "fg": {"type": "string", "default": "text"},
+            },
+            "description": "Text display (content between tags)",
+        },
+        "Button": {
+            "props": {
+                "on_click": {"type": "string", "description": "Handler function name"},
+                "bg": {"type": "string", "default": "accent"},
+                "fg": {"type": "string", "default": "background"},
+                "size": {"type": "integer", "default": 12},
+                "radius": {"type": "integer", "default": 17},
+                "disabled": {"type": "boolean", "default": False},
+            },
+            "description": "Clickable button (label between tags)",
+        },
+        "Input": {
+            "props": {
+                "placeholder": {"type": "string", "default": ""},
+                "value": {"type": "string", "default": ""},
+                "on_change": {"type": "string", "description": "Handler(text)"},
+                "on_enter": {"type": "string", "description": "Handler(text)"},
+                "size": {"type": "integer", "default": 14},
+                "show": {"type": "string", "enum": ["", "password"], "default": ""},
+            },
+            "description": "Text input (self-closing)",
+        },
+        "Checkbox": {
+            "props": {
+                "checked": {"type": "boolean", "default": False},
+                "on_change": {"type": "string", "description": "Handler(checked)"},
+                "size": {"type": "integer", "default": 12},
+            },
+            "description": "Toggle switch (label between tags)",
+        },
+        "Divider": {
+            "props": {
+                "color": {"type": "string", "default": "border"},
+                "thickness": {"type": "integer", "default": 2},
+            },
+            "description": "Horizontal divider (self-closing)",
+        },
+        "Spacer": {
+            "props": {
+                "width": {"type": "integer", "default": 1},
+                "height": {"type": "integer", "default": 1},
+            },
+            "description": "Empty space (self-closing)",
+        },
+    },
+    "animation_props": {
+        "animate": {
+            "type": "string",
+            "enum": ["fade", "reveal", "slide-up", "slide-down", "slide-left", "slide-right"],
+            "description": "Entrance animation type",
+        },
+        "duration": {"type": "integer", "default": 260, "description": "Animation duration (ms)"},
+        "delay": {"type": "integer", "default": 0, "description": "Initial delay (ms)"},
+        "easing": {
+            "type": "string",
+            "enum": ["linear", "in-cubic", "out-cubic", "in-out-cubic", "out-quad", "out-quart", "out-back", "out-elastic"],
+            "default": "out-cubic",
+            "description": "Easing curve",
+        },
+    },
+    "theme": {
+        "extends": {"type": "string", "enum": ["dark", "light"], "default": "dark"},
+        "colors": {
+            "background": {"type": "string", "default": "#1e1e2e"},
+            "surface": {"type": "string", "default": "#282a36"},
+            "text": {"type": "string", "default": "#f8f8f2"},
+            "subtext": {"type": "string", "default": "#a6adc8"},
+            "accent": {"type": "string", "default": "#7aa2f7"},
+            "border": {"type": "string", "default": "#44475a"},
+            "danger": {"type": "string", "default": "#f7768e"},
+        },
+        "custom_colors": {"type": "object", "description": "Additional named colors"},
+    },
+    "syntax": {
+        "interpolation": ["{$var}", "{var}", "$var"],
+        "events": "on_click=\"handler\" / on_change=\"handler\" / on_enter=\"handler\"",
+        "components": "<Component name=\"Name\">...<Component/>",
+        "script": "<script>def handler(): pass</script>",
+    },
+}
+
+
+def run(path: str | Path, context: dict[str, Any] | None = None, theme: str = "dark") -> None:
+    """读取并运行一个 .paw 文件（阻塞，直到窗口关闭）。"""
+    p = Path(path)
+    if not p.exists():
+        raise FileNotFoundError(f"PawUI: file not found: {p}")
+    source = p.read_text(encoding="utf-8")
+    rt = Runtime(source, str(p), context=context, theme=theme)
+    rt.run(block=True)
+
+
+def check(path: str | Path) -> int:
+    """语法检查 .paw 文件，不运行。"""
+    p = Path(path)
+    if not p.exists():
+        print(f"PawUI: file not found: {p}", file=sys.stderr)
+        return 1
+    source = p.read_text(encoding="utf-8")
+    try:
+        program = parse(source, str(p))
+        print(f"✓ {p}: syntax OK")
+        print(f"  Elements: {len(program.elements)}")
+        print(f"  Script: {'yes' if program.script else 'no'}")
+        for el in program.elements:
+            if el.tag == "component":
+                print(f"  Component: {el.name}")
+        return 0
+    except PyxError as e:
+        print(e.formatted(), file=sys.stderr)
+        return 1
+
+
+def schema_cmd() -> int:
+    """输出组件 Schema (JSON)。"""
+    print(json.dumps(SCHEMA, indent=2, ensure_ascii=False))
+    return 0
+
+
+def render(path: str | Path) -> int:
+    """离屏渲染并输出信息。"""
+    import os
+    os.environ.setdefault("QT_QPA_PLATFORM", "offscreen")
+
+    p = Path(path)
+    if not p.exists():
+        print(f"PawUI: file not found: {p}", file=sys.stderr)
+        return 1
+
+    source = p.read_text(encoding="utf-8")
+    try:
+        rt = Runtime(source, str(p))
+        rt.run(block=False)
+        print(f"✓ {p}: render OK")
+        if rt.root:
+            print(f"  Window: {rt.root.windowTitle()}")
+            size = rt.root.size()
+            print(f"  Size: {size.width()}x{size.height()}")
+            rt.root.close()
+        return 0
+    except PyxError as e:
+        print(e.formatted(), file=sys.stderr)
+        return 1
+    except Exception as e:
+        print(f"PawUI render error: {e}", file=sys.stderr)
+        return 1
+
+
+def main(argv: list[str] | None = None) -> int:
+    args = list(sys.argv[1:] if argv is None else argv)
+    if not args:
+        print(USAGE, file=sys.stderr)
+        return 2
+
+    cmd = args[0]
+    if cmd in ("-h", "--help", "help"):
+        print(USAGE)
+        return 0
+    if cmd in ("-v", "--version"):
+        from . import __version__
+        print(f"PawUI {__version__}")
+        return 0
+
+    if cmd == "check":
+        if len(args) < 2:
+            print("Usage: pawui check <file.paw>", file=sys.stderr)
+            return 2
+        return check(args[1])
+
+    if cmd == "schema":
+        return schema_cmd()
+
+    if cmd == "render":
+        if len(args) < 2:
+            print("Usage: pawui render <file.paw>", file=sys.stderr)
+            return 2
+        return render(args[1])
+
+    file = args[1] if cmd == "run" else cmd
+    if not file:
+        print(USAGE, file=sys.stderr)
+        return 2
+
+    try:
+        run(file)
+    except PyxError as e:
+        print(e.formatted(), file=sys.stderr)
+        return 1
+    except FileNotFoundError as e:
+        print(e, file=sys.stderr)
+        return 1
+    except KeyboardInterrupt:
+        return 130
+    return 0