wesktop 0.1.1__tar.gz

wesktop-0.1.1/.claude/settings.json

@@ -0,0 +1,3 @@
+{
+  "hooks": {}
+}

wesktop-0.1.1/.github/workflows/ci.yml

@@ -0,0 +1,20 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@v6
+      - uses: astral-sh/setup-uv@v7
+      - run: uv python install ${{ matrix.python-version }}
+      - run: uv sync
+      - run: uv run python -c "import wesktop"

wesktop-0.1.1/.github/workflows/publish.yml

@@ -0,0 +1,18 @@
+name: Publish
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: astral-sh/setup-uv@v7
+      - run: uv build
+      - uses: pypa/gh-action-pypi-publish@release/v1

wesktop-0.1.1/.gitignore

@@ -0,0 +1,24 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.venv/
+.pytest_cache/
+*.egg
+.uv/
+
+node_modules/
+*.pyc
+*.log
+.DS_Store
+coverage/
+.rlsbl-notes-*.tmp
+.rlsbl/lock
+.credentials.json
+.*-cache.json
+.env
+.env.local
+*.local-only
+docs/_build/

wesktop-0.1.1/.rlsbl/bases/.claude/settings.json

@@ -0,0 +1,3 @@
+{
+  "hooks": {}
+}

wesktop-0.1.1/.rlsbl/bases/.github/workflows/ci.yml

@@ -0,0 +1,21 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        # requires-python: >= {{pypi.minRequiredPython}}
+        python-version: ["3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@v6
+      - uses: astral-sh/setup-uv@v7
+      - run: uv python install ${{ matrix.python-version }}
+      - run: uv sync
+      - run: uv run python -c "import wesktop"

wesktop-0.1.1/.rlsbl/bases/.github/workflows/publish.yml

@@ -0,0 +1,18 @@
+name: Publish
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: astral-sh/setup-uv@v7
+      - run: uv build
+      - uses: pypa/gh-action-pypi-publish@release/v1

wesktop-0.1.1/.rlsbl/bases/.gitignore

@@ -0,0 +1,15 @@
+node_modules/
+__pycache__/
+*.pyc
+*.log
+.DS_Store
+coverage/
+dist/
+*.egg-info/
+.rlsbl-notes-*.tmp
+.rlsbl/lock
+.credentials.json
+.*-cache.json
+.env
+.env.local
+*.local-only

wesktop-0.1.1/.rlsbl/bases/.rlsbl/hooks/post-release.sh

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+# Post-release hook. Runs after a successful release (non-fatal).
+# Environment: RLSBL_VERSION is set to the released version.
+# Customize this for your project (e.g., local install, deploy, notify).
+
+set -euo pipefail
+
+echo "Post-release: v$RLSBL_VERSION"

wesktop-0.1.1/.rlsbl/bases/.rlsbl/hooks/pre-checks.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+set -euo pipefail
+# This hook runs BEFORE built-in pre-release checks (tests, lint).
+# Use it for setup tasks: starting services, setting env vars, etc.
+# Built-in checks run after this hook. Custom validation goes in pre-release.sh.

wesktop-0.1.1/.rlsbl/bases/.rlsbl/hooks/pre-release.sh

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+# Project-specific pre-release checks.
+# Built-in checks (tests, lint) run automatically before this hook.
+# Add custom validation here, e.g.:
+#   - Check for uncommitted documentation
+#   - Verify external service connectivity
+#   - Run integration tests not covered by the test suite

wesktop-0.1.1/.rlsbl/bases/.rlsbl/lint/go.toml

@@ -0,0 +1,17 @@
+[forbidden-imports]
+modules = [
+    "net/http",
+    "github.com/spf13/cobra",
+    "github.com/urfave/cli",
+]
+
+[stdout]
+enabled = true
+ignore = []
+
+[entry-point]
+enabled = true
+ignore = []
+
+[files]
+exclude = []

wesktop-0.1.1/.rlsbl/bases/.rlsbl/lint/npm.toml

@@ -0,0 +1,19 @@
+[forbidden-imports]
+modules = [
+    "express",
+    "koa",
+    "hono",
+    "commander",
+    "yargs",
+]
+
+[stdout]
+enabled = true
+ignore = []
+
+[entry-point]
+enabled = true
+ignore = []
+
+[files]
+exclude = []

wesktop-0.1.1/.rlsbl/bases/.rlsbl/lint/python.toml

@@ -0,0 +1,25 @@
+[forbidden-imports]
+modules = [
+    "argparse",
+    "click",
+    "typer",
+    "flask",
+    "fastapi",
+    "django",
+    "uvicorn",
+    "granian",
+    "starlette",
+    "tornado",
+    "bottle",
+]
+
+[stdout]
+enabled = true
+ignore = []
+
+[entry-point]
+enabled = true
+ignore = []
+
+[files]
+exclude = []

wesktop-0.1.1/.rlsbl/bases/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+## 0.1.0
+
+- Initial release

wesktop-0.1.1/.rlsbl/bases/CLAUDE.md

@@ -0,0 +1,20 @@
+# wesktop
+
+## Release workflow
+
+This project uses [rlsbl](https://github.com/smm-h/rlsbl) for release orchestration.
+
+- Update CHANGELOG.md with a `## X.Y.Z` entry describing changes
+- Run `rlsbl release [patch|minor|major]` to bump version and create a GitHub Release
+- CI handles publishing automatically via the publish workflow
+- Never publish manually — always use `rlsbl release`
+- Configure Trusted Publishing on pypi.org for automated PyPI releases
+- Use `rlsbl release --dry-run` to preview a release without making changes
+
+## Conventions
+
+- No tokens or secrets in command-line arguments (use env vars or config files)
+- All file writes to shared state should be atomic (write to tmp, then rename)
+- External calls (APIs, CLI tools) must have timeouts and graceful fallbacks
+- Use `npm link` (npm) or `uv pip install -e .` (Python) for local development
+- CI runs smoke tests on every push; manual testing for UI/UX changes

wesktop-0.1.1/.rlsbl/bases/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 smm-h
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

wesktop-0.1.1/.rlsbl/changes/.validated

@@ -0,0 +1 @@
+3540d09fa802bb88537ce076800b9b0b2801ef79

wesktop-0.1.1/.rlsbl/changes/0.1.0.jsonl

@@ -0,0 +1,11 @@
+{"commits":["d00e0a314abbc6720b06864ad8a4014e653e9a33","53b83ce974becab9c7d3d20debd682d3abf9297d","0949e1ab49d7d24616f8173cadb6a646cd04bfba"],"user_facing":false}
+{"commits":["97e0ad7fe9f96f3a815b3f6138cd8dbd57c365df","3da18c78e2074da14a555ef30d8656b4b2c38ba2","4fe003a36934d1b53642c549a9e68936a279053f"],"user_facing":false}
+{"commits":["128679ea96ada6f978bf01aa78cab828694e503e","a4b37f708c9822b0658d592010a1b0bbde5df001","b12f712986de331350ba98daf2ec54db58fddeef"],"user_facing":true,"description":"**Initial release.** ASGI router, SSE broadcaster, and extracted server lifecycle.","type":"feature"}
+{"commits":["e6f466e1857c268c80f66a150d27b1e8fc0a064f","48d0d63b608e0f58ac817a4c322be5e28132f51b","e03976716edb4de95ba55122e0d00ed4ae8807de","ceb985a298b9d8b0510f6b49b6505203870450b9"],"user_facing":true,"description":"**Desktop integration.** pywebview, desktop entry creation, and public API exports.","type":"feature"}
+{"commits":["679c1bfcbc6db58d7143a807de6fa9ee4921d979","797fc29feda110bc8893439e2652d1118ef8cfa5"],"user_facing":false}
+{"commits":["a453cf8830b6d86e5d9bf32d540e069a5432adaf"],"user_facing":false}
+{"commits":["2ad42e3dc9e0153ed992771f48b60f5255d8db1b"],"user_facing":false}
+{"commits":["1e2274bfe5ae37f4b1649ee8a9c0e6228539baff"],"user_facing":false}
+{"commits":["7c4c6b89d705bad412bd89037cb61715a0932585","01edd549dd66b46d2907a8d3f36d44f969de71c2"],"user_facing":true,"description":"**npm shim.** Install via `npm i -g @smmh/wesktop` for a global `wesktop` CLI that delegates to Python.","type":"feature"}
+{"commits":["2c16194bae86e9398bd7083561c2aa53c37402a3"],"user_facing":false}
+{"commits":["8d7e8fd69b946abd58bebb51a60d55c0778d5366"],"user_facing":false}

wesktop-0.1.1/.rlsbl/changes/0.1.0.md

@@ -0,0 +1,7 @@
+## 0.1.0
+
+### Features
+
+- **Initial release.** ASGI router, SSE broadcaster, and extracted server lifecycle.
+- **Desktop integration.** pywebview, desktop entry creation, and public API exports.
+- **npm shim.** Install via `npm i -g @smmh/wesktop` for a global `wesktop` CLI that delegates to Python.

wesktop-0.1.1/.rlsbl/changes/0.1.1.jsonl

@@ -0,0 +1 @@
+{"commits":["e814207a9b87c4b742c70c2adf59246c38fdf804"],"user_facing":false}

wesktop-0.1.1/.rlsbl/changes/0.1.1.md

@@ -0,0 +1,3 @@
+## 0.1.1
+
+- No user-facing changes.

wesktop-0.1.1/.rlsbl/config.json

@@ -0,0 +1,5 @@
+{
+  "targets": [
+    "pypi"
+  ]
+}

wesktop-0.1.1/.rlsbl/hashes.json

@@ -0,0 +1,15 @@
+{
+  ".github/workflows/ci.yml": "c1c40dd67db0a91b305570028a0579ec03c747da0dd187f31de80a099b6fb516",
+  ".github/workflows/publish.yml": "55e2dba57d17218c2887ba90051d31aee15067cc0b69c8adebc2deab07aef76b",
+  "CHANGELOG.md": "7a6ec46141007c18090a0ff325e2dd68cd51588c4e0b5af7b580365e5eaaca85",
+  ".gitignore": "ce5391c115e249532a3bc27098546bb1ff2a32410b53b0d59ad7b54e765c0a04",
+  "LICENSE": "e958892abc1dd5d991fca6d528e695d335f25773d373d2e0be5f4a9507d8f8d5",
+  ".rlsbl/hooks/pre-checks.sh": "60c57d4563263124530e6f33aca77550ea2161ad3b33b3ba6ad1c03fea9eb6e2",
+  ".rlsbl/hooks/pre-release.sh": "b2dc17c243d0b1a2c1e23c1c25db6f94878596df81dc76c41b32d95f740a7d44",
+  ".rlsbl/hooks/post-release.sh": "b455f8511e0b2655509ecf5dcb0ab7da5bb7c961f47910ff8e00cab5bd51f833",
+  ".claude/settings.json": "78922a784ee78e9e50587e93628cd3b9d4dfbe49087adc4514e6781cea38cbb9",
+  ".rlsbl/lint/python.toml": "9cfbcef2e010d5fad243437bf2fd8df54a1fae70ee0762f9d11da70fe207501c",
+  ".rlsbl/lint/go.toml": "807d5cf760baad6d571a5bfd43cb163efe356f7462ba9f1918d72de45f62339f",
+  ".rlsbl/lint/npm.toml": "baa36014e65923d8cc5c8b83c77fa651da79351627570476402da66840027645",
+  ".rlsbl/changes/unreleased.jsonl": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
+}

wesktop-0.1.1/.rlsbl/hooks/post-release.sh

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+# Post-release hook. Runs after a successful release (non-fatal).
+# Environment: RLSBL_VERSION is set to the released version.
+# Customize this for your project (e.g., local install, deploy, notify).
+
+set -euo pipefail
+
+echo "Post-release: v$RLSBL_VERSION"

wesktop-0.1.1/.rlsbl/hooks/pre-checks.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+set -euo pipefail
+# This hook runs BEFORE built-in pre-release checks (tests, lint).
+# Use it for setup tasks: starting services, setting env vars, etc.
+# Built-in checks run after this hook. Custom validation goes in pre-release.sh.

wesktop-0.1.1/.rlsbl/hooks/pre-release.sh

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+# Project-specific pre-release checks.
+# Built-in checks (tests, lint) run automatically before this hook.
+# Add custom validation here, e.g.:
+#   - Check for uncommitted documentation
+#   - Verify external service connectivity
+#   - Run integration tests not covered by the test suite

wesktop-0.1.1/.rlsbl/lint/go.toml

@@ -0,0 +1,17 @@
+[forbidden-imports]
+modules = [
+    "net/http",
+    "github.com/spf13/cobra",
+    "github.com/urfave/cli",
+]
+
+[stdout]
+enabled = true
+ignore = []
+
+[entry-point]
+enabled = true
+ignore = []
+
+[files]
+exclude = []

wesktop-0.1.1/.rlsbl/lint/npm.toml

@@ -0,0 +1,19 @@
+[forbidden-imports]
+modules = [
+    "express",
+    "koa",
+    "hono",
+    "commander",
+    "yargs",
+]
+
+[stdout]
+enabled = true
+ignore = []
+
+[entry-point]
+enabled = true
+ignore = []
+
+[files]
+exclude = []

wesktop-0.1.1/.rlsbl/lint/python.toml

@@ -0,0 +1,25 @@
+[forbidden-imports]
+modules = [
+    "argparse",
+    "click",
+    "typer",
+    "flask",
+    "fastapi",
+    "django",
+    "uvicorn",
+    "granian",
+    "starlette",
+    "tornado",
+    "bottle",
+]
+
+[stdout]
+enabled = true
+ignore = []
+
+[entry-point]
+enabled = true
+ignore = []
+
+[files]
+exclude = []

wesktop-0.1.1/.rlsbl/version

@@ -0,0 +1 @@
+0.36.0

wesktop-0.1.1/.selfdoc/hashes/hashes.json

@@ -0,0 +1,10 @@
+{
+  "api.md": {
+    "content": "7a853df7d84d377b3026c46995c42747190bea4ef53a1b496c255dfeb09e77e2",
+    "description": "1c49db4136318e727bafdf1f66c2c763db8914038f6e1f5c31b680aef4687ed2"
+  },
+  "index.md": {
+    "content": "448279a5ee5b07cf889a65674ac848328f2ee88f40c6f3be4f8a0bf9087335fd",
+    "description": "e11c3c93cacc51bdb50b42c2b50d609a9f0f03665eeef92ade3c01df5b86bb5f"
+  }
+}

wesktop-0.1.1/CHANGELOG.md

@@ -0,0 +1,15 @@
+<!-- Generated by rlsbl from .rlsbl/changes/ — do not edit -->
+
+# Changelog
+
+## 0.1.1
+
+- No user-facing changes.
+
+## 0.1.0
+
+### Features
+
+- **Initial release.** ASGI router, SSE broadcaster, and extracted server lifecycle.
+- **Desktop integration.** pywebview, desktop entry creation, and public API exports.
+- **npm shim.** Install via `npm i -g @smmh/wesktop` for a global `wesktop` CLI that delegates to Python.

wesktop-0.1.1/CLAUDE.md

@@ -0,0 +1,77 @@
+# wesktop
+
+A Python framework for building web-based desktop applications. Uses granian (Rust-based ASGI server), pywebview (native OS windows), and msgspec (fast serialization).
+
+## Architecture
+
+wesktop was extracted from ProductEngine as a reusable library. It provides four layers:
+
+1. **ASGI micro-router** (`asgi.py`) -- minimal HTTP routing with `{param}` placeholders, response type dispatch (JSON, text, HTML, bytes, streaming), static file serving, SPA fallback, WebSocket route registry, middleware chain, and async lifespan support. Zero external dependencies beyond msgspec for JSON encoding.
+
+2. **SSE broadcaster** (`sse.py`) -- typed server-sent events with per-client async queues. Event types must be registered before broadcast (strict mode). Disconnected clients are pruned automatically when their queue fills up.
+
+3. **Server lifecycle** (`server.py`) -- granian integration with PID file management, port availability checks, process group leadership (so worker subprocesses die with the parent), and signal handling. Supports both blocking (`start_server`) and background-thread (`start_server_in_background`) modes.
+
+4. **Desktop window** (`desktop.py`) -- pywebview integration. Starts the server in a background thread, opens a native OS window, and blocks until the window is closed. Late-imports pywebview so headless mode has no GUI dependency.
+
+5. **Desktop entries** (`entries.py`) -- cross-platform desktop shortcut creation and removal (Linux `.desktop` files, macOS `.app` bundles, Windows Start Menu shortcuts via COM or PowerShell).
+
+## Module Layout
+
+```
+src/wesktop/
+  __init__.py     Public API: re-exports from all modules, __version__, __all__
+  asgi.py         ASGI router, request/response types, app factory, WebSocket registry
+  sse.py          SSE Broadcaster and sse_route helper
+  server.py       Granian lifecycle: PID files, port checks, start/stop
+  desktop.py      pywebview window: start server + open native window
+  entries.py      Cross-platform desktop entry creation/removal
+```
+
+## Dependencies
+
+| Package | Why |
+|---------|-----|
+| `granian` | Rust-based ASGI server. Faster than uvicorn for production, handles process management internally. |
+| `pywebview` | Opens native OS windows (WebKit on Linux/macOS, Edge WebView2 on Windows). Avoids Electron overhead. |
+| `msgspec` | Fast JSON serialization/deserialization. Used in the ASGI layer for request parsing and response encoding. |
+
+Dev dependencies: `pytest`, `httpx` (for async test client).
+
+## Consumer Patterns
+
+wesktop is a library, not a CLI tool. Consumers bring their own entry point and call either:
+
+- `wesktop.run("myapp:app")` -- desktop mode (server + native window)
+- `wesktop.serve("myapp:app")` -- headless mode (server only)
+
+The `target` argument is an ASGI import path (e.g., `"myapp.web:app"`). Consumers create a `Router`, register routes, call `create_app()`, and then pass the module path to `run()` or `serve()`.
+
+## Public API
+
+All public symbols are importable from `wesktop` directly:
+
+- **Router, Request** -- routing and request handling
+- **JSONResponse, TextResponse, HTMLResponse, BytesResponse, StreamResponse** -- response types
+- **create_app** -- ASGI app factory
+- **add_ws_route** -- WebSocket route registration
+- **Broadcaster, sse_route** -- SSE support
+- **create_entry, remove_entry** -- desktop shortcut management
+- **run, serve** -- entry points
+- **__version__** -- package version from metadata
+
+## Development
+
+```bash
+uv run pytest              # Run test suite
+selfdoc build              # Build documentation
+selfdoc serve              # Serve documentation locally
+```
+
+## Project Structure
+
+```
+src/wesktop/         Source code
+tests/               Test suite
+docs/                Documentation (selfdoc templates)
+```

wesktop-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 smm-h
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

wesktop-0.1.1/PKG-INFO

@@ -0,0 +1,12 @@
+Metadata-Version: 2.4
+Name: wesktop
+Version: 0.1.1
+Summary: A Python framework for building web-based desktop applications
+Author-email: smm-h <smmh72@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: asgi,desktop,granian,gui,pywebview,rlsbl,web
+Requires-Python: >=3.11
+Requires-Dist: granian>=2.7.4
+Requires-Dist: msgspec>=0.21.1
+Requires-Dist: pywebview>=6.2.1

wesktop-0.1.1/README.md

@@ -0,0 +1 @@
+# wesktop

wesktop-0.1.1/bin/cli.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+"use strict";
+
+const { execFileSync, spawnSync } = require("child_process");
+
+try {
+  execFileSync("python3", ["--version"], { stdio: "pipe" });
+} catch {
+  console.error("wesktop requires Python 3.11+. Install from https://python.org/");
+  process.exit(1);
+}
+
+const result = spawnSync("python3", ["-m", "wesktop", ...process.argv.slice(2)], {
+  stdio: "inherit",
+});
+process.exit(result.status ?? 1);