pieui 0.1.0__tar.gz

pieui-0.1.0/PKG-INFO

@@ -0,0 +1,230 @@
+Metadata-Version: 2.3
+Name: pieui
+Version: 0.1.0
+Summary: CLI client for PieUI Storage.
+Author: butusk0, DELTA37
+Author-email: butusk0 <kirill.butusov@romanticai.com>, DELTA37 <gg_plastt@mail.ru>
+Requires-Dist: jinja2>=3.1.0
+Requires-Dist: adaptix>=3.0.0b12
+Requires-Dist: dataclasses>=0.8
+Requires-Dist: dataclasses-json>=0.6.7
+Requires-Dist: fastapi>=0.136.0
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: openai-agents>=0.14.2
+Requires-Dist: python-dotenv>=1.2.2
+Requires-Dist: cent>=5.2.0
+Requires-Dist: fastapi-socketio>=0.0.10
+Requires-Dist: jsonpatch>=1.33
+Requires-Dist: dataclasses-jsonschema>=2.16.0
+Requires-Dist: aiohttp>=3.13.5
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+
+# pie
+
+Python CLI for Pie components.
+
+The command surface follows the TypeScript `pieui` CLI:
+
+```text
+init
+add
+remove
+list
+push
+pull
+remote-remove
+list-events
+add-event
+postbuild
+```
+
+Remote commands call the `pieui-storage` API:
+
+```text
+push
+pull
+remote-remove
+```
+
+## Setup
+
+```bash
+uv sync --python 3.14
+cp .env.example .env
+```
+
+Do not pin the project to `3.14.0b1`: current `pydantic`/`pydantic-settings`
+break on that beta. `uv sync --python 3.14` creates a managed CPython 3.14.0
+environment.
+
+## Config
+
+The CLI reads `.env` with the `PIE_` prefix:
+
+```text
+PIE_API_BASE_URL=http://localhost:8000/api
+PIE_USER_ID=default-user
+PIE_PROJECT_SLUG=default-project
+PIE_COMPONENTS_DIR=piecomponents
+PIE_TIMEOUT_SECONDS=30
+PIE_API_KEY=dev-master-key
+```
+
+`PIE_API_BASE_URL` must point to the API prefix of `pieui-storage`, for example:
+
+```bash
+PIE_API_BASE_URL=http://localhost:8000/api
+```
+
+`PIE_API_KEY` is sent to `pieui-storage` as the `x-api-key` header. The local
+API default is `dev-master-key`.
+
+## Commands
+
+### init
+
+Initialize the `piecomponents` directory:
+
+```bash
+uv run pie init
+uv run pie init --out-dir packages/app
+uv run pie init -o packages/app
+```
+
+### add
+
+Create a local Python component project under `piecomponents/<ComponentName>`:
+
+```bash
+uv run pie add MyCustomCard
+uv run pie add simple MySimpleCard
+uv run pie add complex MyComplexCard
+uv run pie add simple-container MySimpleContainerCard
+uv run pie add complex-container MyContainerCard
+```
+
+If the type is omitted, `complex-container` is used, matching the TypeScript CLI.
+
+The generated template is a minimal `piedemo` web project:
+
+```text
+piecomponents/MyCustomCard/
+  pyproject.toml
+  web.py
+  pages/
+    main.py
+```
+
+`web.py` registers `MainPage` on the root route: `{"": MainPage()}`.
+`pages/main.py` also contains `MainCard`, where component events are declared.
+
+### remove
+
+Remove a local component directory:
+
+```bash
+uv run pie remove MyCustomCard
+```
+
+### list
+
+List local components:
+
+```bash
+uv run pie list
+uv run pie list simple
+uv run pie list complex-container --src-dir app
+uv run pie list complex-container -s app
+```
+
+Accepted filters:
+
+```text
+all
+simple
+complex
+simple-container
+complex-container
+```
+
+### push
+
+Upload `piecomponents/<ComponentName>` to `pieui-storage`.
+
+The storage API stores files under:
+
+```text
+PIE_USER_ID/PIE_PROJECT_SLUG/<ComponentName>/python/*
+```
+
+Command:
+
+```bash
+uv run pie push MyCustomCard
+```
+
+### pull
+
+Download Python files from `pieui-storage` into `piecomponents/<ComponentName>`:
+
+```bash
+uv run pie pull MyCustomCard
+```
+
+### remote-remove
+
+Delete the remote component from `pieui-storage`:
+
+```bash
+uv run pie remote-remove MyCustomCard
+```
+
+### list-events
+
+List events declared by `MainCard.get_supported_events()`:
+
+```bash
+uv run pie list-events MyCustomCard
+uv run pie list-events MyCustomCard --src-dir app
+```
+
+### add-event
+
+Add a card event method and update `get_supported_events()`:
+
+```bash
+uv run pie add-event MyCustomCard alert
+uv run pie add-event MyCustomCard alert --src-dir app
+```
+
+For `alert`, the command adds:
+
+```python
+def create_alert_event(self, data: dict | None = None):
+    return self.create_event("alert", data or {})
+
+def get_supported_events(self):
+    return [
+        "alert",
+    ]
+```
+
+### postbuild
+
+Generate a manifest file:
+
+```bash
+uv run pie postbuild
+uv run pie postbuild --append --out-dir dist
+uv run pie postbuild --src-dir src --out-dir public
+```
+
+## Project Layout
+
+```text
+pie/cli.py               CLI argument handling and command dispatch
+pie/config.py            pydantic-settings config loaded from .env
+pie/models.py            pydantic response models
+pie/services/storage.py  pieui-storage API client
+```

pieui-0.1.0/README.md

@@ -0,0 +1,208 @@
+# pie
+
+Python CLI for Pie components.
+
+The command surface follows the TypeScript `pieui` CLI:
+
+```text
+init
+add
+remove
+list
+push
+pull
+remote-remove
+list-events
+add-event
+postbuild
+```
+
+Remote commands call the `pieui-storage` API:
+
+```text
+push
+pull
+remote-remove
+```
+
+## Setup
+
+```bash
+uv sync --python 3.14
+cp .env.example .env
+```
+
+Do not pin the project to `3.14.0b1`: current `pydantic`/`pydantic-settings`
+break on that beta. `uv sync --python 3.14` creates a managed CPython 3.14.0
+environment.
+
+## Config
+
+The CLI reads `.env` with the `PIE_` prefix:
+
+```text
+PIE_API_BASE_URL=http://localhost:8000/api
+PIE_USER_ID=default-user
+PIE_PROJECT_SLUG=default-project
+PIE_COMPONENTS_DIR=piecomponents
+PIE_TIMEOUT_SECONDS=30
+PIE_API_KEY=dev-master-key
+```
+
+`PIE_API_BASE_URL` must point to the API prefix of `pieui-storage`, for example:
+
+```bash
+PIE_API_BASE_URL=http://localhost:8000/api
+```
+
+`PIE_API_KEY` is sent to `pieui-storage` as the `x-api-key` header. The local
+API default is `dev-master-key`.
+
+## Commands
+
+### init
+
+Initialize the `piecomponents` directory:
+
+```bash
+uv run pie init
+uv run pie init --out-dir packages/app
+uv run pie init -o packages/app
+```
+
+### add
+
+Create a local Python component project under `piecomponents/<ComponentName>`:
+
+```bash
+uv run pie add MyCustomCard
+uv run pie add simple MySimpleCard
+uv run pie add complex MyComplexCard
+uv run pie add simple-container MySimpleContainerCard
+uv run pie add complex-container MyContainerCard
+```
+
+If the type is omitted, `complex-container` is used, matching the TypeScript CLI.
+
+The generated template is a minimal `piedemo` web project:
+
+```text
+piecomponents/MyCustomCard/
+  pyproject.toml
+  web.py
+  pages/
+    main.py
+```
+
+`web.py` registers `MainPage` on the root route: `{"": MainPage()}`.
+`pages/main.py` also contains `MainCard`, where component events are declared.
+
+### remove
+
+Remove a local component directory:
+
+```bash
+uv run pie remove MyCustomCard
+```
+
+### list
+
+List local components:
+
+```bash
+uv run pie list
+uv run pie list simple
+uv run pie list complex-container --src-dir app
+uv run pie list complex-container -s app
+```
+
+Accepted filters:
+
+```text
+all
+simple
+complex
+simple-container
+complex-container
+```
+
+### push
+
+Upload `piecomponents/<ComponentName>` to `pieui-storage`.
+
+The storage API stores files under:
+
+```text
+PIE_USER_ID/PIE_PROJECT_SLUG/<ComponentName>/python/*
+```
+
+Command:
+
+```bash
+uv run pie push MyCustomCard
+```
+
+### pull
+
+Download Python files from `pieui-storage` into `piecomponents/<ComponentName>`:
+
+```bash
+uv run pie pull MyCustomCard
+```
+
+### remote-remove
+
+Delete the remote component from `pieui-storage`:
+
+```bash
+uv run pie remote-remove MyCustomCard
+```
+
+### list-events
+
+List events declared by `MainCard.get_supported_events()`:
+
+```bash
+uv run pie list-events MyCustomCard
+uv run pie list-events MyCustomCard --src-dir app
+```
+
+### add-event
+
+Add a card event method and update `get_supported_events()`:
+
+```bash
+uv run pie add-event MyCustomCard alert
+uv run pie add-event MyCustomCard alert --src-dir app
+```
+
+For `alert`, the command adds:
+
+```python
+def create_alert_event(self, data: dict | None = None):
+    return self.create_event("alert", data or {})
+
+def get_supported_events(self):
+    return [
+        "alert",
+    ]
+```
+
+### postbuild
+
+Generate a manifest file:
+
+```bash
+uv run pie postbuild
+uv run pie postbuild --append --out-dir dist
+uv run pie postbuild --src-dir src --out-dir public
+```
+
+## Project Layout
+
+```text
+pie/cli.py               CLI argument handling and command dispatch
+pie/config.py            pydantic-settings config loaded from .env
+pie/models.py            pydantic response models
+pie/services/storage.py  pieui-storage API client
+```

pieui-0.1.0/pie/__init__.py

@@ -0,0 +1,27 @@
+__version__ = "0.1.0"
+
+__author__ = "George K."
+
+
+from .fastweb import Web
+from .async_page import AsyncPage
+from .card import Card, InputCard
+from .components.hidden import HiddenCard
+from .components.union import UnionCard
+from .components.ajax_group import AjaxGroupCard
+from .components.html_embed import HTMLEmbedCard
+from .components.one_of import OneOfCard
+from .components.io_log import IOLogCard
+
+
+__all__ = ["__version__",
+           "Web",
+           "AsyncPage",
+           "InputCard",
+           "Card",
+           "HiddenCard",
+           "UnionCard",
+           "AjaxGroupCard",
+           "HTMLEmbedCard",
+           "OneOfCard",
+           "IOLogCard"]

pieui-0.1.0/pie/__main__.py

@@ -0,0 +1,99 @@
+"""PieDemo CLI
+
+Command-line interface for the PieDemo framework.
+"""
+
+import argparse
+import sys
+from typing import Optional
+
+from .code import handle_card_add, handle_build, handle_create, handle_web, handle_web_verify
+
+
+CARD_TYPES = {"simple", "complex", "container", "complex-container"}
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="pie",
+        description="Pie - Framework for building interactive web applications",
+    )
+
+    subparsers = parser.add_subparsers(dest="command", help="Available commands", required=True)
+
+    # piedemo web module:app [verify|build]
+    web_parser = subparsers.add_parser("web", help="Run or lint a web application")
+    web_parser.add_argument("web", help="Web in format module:attribute, e.g. some:app")
+    web_subparsers = web_parser.add_subparsers(dest="web_command")
+    web_subparsers.add_parser("verify", help="Verify the web application")
+    web_subparsers.add_parser("build", help="Build static JSON from a Web application")
+
+    card_parser = subparsers.add_parser("card", help="Manage card templates")
+    card_subparsers = card_parser.add_subparsers(dest="card_command", required=True)
+    card_add_parser = card_subparsers.add_parser("add", help="Create a card file from a template")
+    card_add_parser.add_argument("card_type", choices=sorted(CARD_TYPES))
+    card_add_parser.add_argument("card_name", metavar="NAME")
+    card_add_parser.add_argument("--io", action="store_true", dest="use_io")
+    card_add_parser.add_argument("--ajax", action="store_true", dest="use_ajax")
+
+    create_parser = subparsers.add_parser("create", help="Create a new Pie project")
+    create_parser.add_argument("project_name", metavar="NAME")
+
+    return parser
+
+
+def parse_args(argv: list[str] | None = None) -> argparse.Namespace:
+    return build_parser().parse_args(argv)
+
+
+def main(
+    command: str,
+    web: Optional[str] = None,
+    web_command: Optional[str] = None,
+    card_command: Optional[str] = None,
+    card_type: Optional[str] = None,
+    card_name: Optional[str] = None,
+    project_name: Optional[str] = None,
+    use_io: bool = False,
+    use_ajax: bool = False,
+) -> int:
+    try:
+        if command == "web":
+            if web is None:
+                raise ValueError("Web path is required")
+            if web_command == "verify":
+                handle_web_verify(web)
+            elif web_command == "build":
+                handle_build(web)
+            else:
+                handle_web(web)
+            return 0
+
+        if command == "page":
+            return 0
+        if command == "card":
+            if card_command == "add":
+                handle_card_add(
+                    card_name=card_name,
+                    card_type=card_type,
+                    use_io=use_io,
+                    use_ajax=use_ajax,
+                )
+            return 0
+        if command == "create":
+            if project_name is None:
+                raise ValueError("Project name is required")
+            handle_create(project_name)
+            return 0
+        if command == "init":
+            return 0
+        if command == "login":
+            return 0
+        return 0
+    except ValueError as error:
+        print(error, file=sys.stderr)
+        return 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main(**vars(parse_args())))