velo-ui 0.1.0__tar.gz

velo_ui-0.1.0/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 Muhammad Rafay Shaikh
+
+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.

velo_ui-0.1.0/PKG-INFO

@@ -0,0 +1,225 @@
+Metadata-Version: 2.4
+Name: velo-ui
+Version: 0.1.0
+Summary: Beautiful, reactive Python web apps in minutes. Zero dependencies.
+Author: Muhammad Rafay Shaikh
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/rafay183/velo
+Project-URL: Issues, https://github.com/rafay183/velo/issues
+Project-URL: Changelog, https://github.com/rafay183/velo/blob/main/CHANGELOG.md
+Keywords: web,ui,dashboard,streamlit alternative,gradio alternative,data apps
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: Topic :: Software Development :: User Interfaces
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# ⚡ Velo
+
+[![tests](https://github.com/rafay183/velo/actions/workflows/tests.yml/badge.svg)](https://github.com/rafay183/velo/actions/workflows/tests.yml)
+[![PyPI](https://img.shields.io/pypi/v/velo-ui.svg)](https://pypi.org/project/velo-ui/)
+[![Python](https://img.shields.io/badge/python-3.9%2B-blue)](#)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![Zero dependencies](https://img.shields.io/badge/dependencies-0-brightgreen)](#)
+
+**Beautiful, reactive Python web apps in minutes. Zero dependencies.**
+
+Velo lets anyone turn a Python script into a polished web app, with dashboards, forms, data tools and chat UIs. It runs on your laptop and deploys anywhere with one command. The whole framework is about 140 KB of pure-stdlib Python plus a 16 KB (gzipped) client.
+
+```python
+import velo
+
+app = velo.App("Hello", accent="#6366f1")
+
+@app.page("/")
+def home(ui):
+    name = ui.input("Your name", placeholder="Ada")
+    n = ui.slider("How excited?", 1, 10, 7)
+    ui.title(f"Hello {name or 'world'}" + " 🎉" * n)
+
+app.run()
+```
+
+```bash
+python app.py          # or:  velo run app.py
+```
+
+![Dashboard](docs/dashboard.png)
+
+<p><img src="docs/dark.png" width="49%"> <img src="docs/data.png" width="49%"></p>
+
+---
+
+## Why Velo?
+
+| | **Velo** | Typical script-rerun frameworks |
+|---|---|---|
+| Install size | **0 dependencies**, ~140 KB | Dozens of transitive packages |
+| What re-runs on a click | **Only the page function** | Often the whole script |
+| UI updates | **DOM morphing**: no flicker, focus and caret kept | Partial or full re-paint |
+| Hot reload | **Keeps your state** (widgets and `ui.state` survive a save) | Session usually resets |
+| Syntax error while editing | Overlay in the browser; app keeps running | Varies |
+| Tables | Built-in search, sort and paging on the client | Varies |
+| Charts | Built-in SVG line, area, bar and donut with tooltips, no deps | Usually needs a plotting library |
+| Typing in inputs | Debounced; sliders throttled | Often one round trip per change |
+| Live push from Python | `app.push()` from any thread (SSE) | Limited |
+| Deploy | `velo docker` (vendors itself), honours `$PORT` | Extra setup |
+| Theme | Light and dark with a toggle; one accent colour themes everything | Config files |
+
+---
+
+## Install
+
+```bash
+pip install velo-ui
+velo new myapp && cd myapp && velo run app.py
+```
+
+Needs Python 3.9+. Nothing else.
+
+---
+
+## The 60-second tour
+
+### Pages and navigation
+Two or more pages give you an automatic sidebar nav with client-side routing.
+
+```python
+@app.page("/", title="Dashboard", icon="📊")
+def dashboard(ui): ...
+
+@app.page("/settings", title="Settings", icon="⚙️")
+def settings(ui): ...
+```
+
+### Widgets return values
+```python
+name   = ui.input("Name", placeholder="…")          # also: type="password" | "email"
+bio    = ui.textarea("Bio", rows=4)
+age    = ui.number("Age", 30, min=0, max=120)
+level  = ui.slider("Level", 0, 100, 50, suffix="%")
+city   = ui.select("City", ["Karachi", "Lahore"])    # returns the object, any type
+plan   = ui.radio("Plan", ["Free", "Pro", "Team"])   # segmented control
+tags   = ui.multiselect("Tags", ["a", "b", "c"])     # chips
+ok     = ui.checkbox("I agree");  dark = ui.toggle("Dark mode")
+day    = ui.date("Start");        col  = ui.color("Brand", "#6366f1")
+f      = ui.upload("CSV file", accept=".csv")        # UploadedFile(.name .data .text())
+if ui.button("Save", icon="💾"): ...                 # True on the click run
+ui.download("Export", data, "report.csv")
+```
+
+### State and callbacks
+```python
+@app.page("/")
+def counter(ui):
+    ui.init(count=0)                        # defaults, set once per browser session
+
+    def add(step):
+        ui.state.count += step
+
+    with ui.row():
+        ui.button("−", on_click=add, args=(-1,), kind="secondary")
+        ui.button("+", on_click=add, args=(1,))
+    ui.metric("Count", ui.state.count)
+```
+Callbacks run **before** the re-render, so the page always shows consistent state. Use `ui.get("key")` and `ui.set("key", v)` to read or write any widget that has a `key=`.
+
+### Layout
+```python
+a, b, c = ui.columns(3)               # or ui.columns([2, 1])
+a.metric("Revenue", "$12.4k", "+8%")  # containers proxy every component…
+with b.card("Settings", "Optional subtitle"):   # …or use `with`
+    ui.toggle("Enabled")
+t1, t2 = ui.tabs(["Chart", "Data"])   # tabs switch instantly on the client
+with ui.expander("Advanced"): ...
+with ui.sidebar: ui.select("Region", [...])
+with ui.row(): ...                    # horizontal button group
+```
+
+### Data and charts (pandas optional)
+```python
+ui.table(df)                                       # DataFrame, list of dicts, dict of lists…
+ui.line_chart(df, x="date", y=["sales", "cost"])
+ui.area_chart(rows, x="day", y="revenue", title="Revenue")
+ui.bar_chart(rows, x="day", y=["a", "b"], stacked=True)
+ui.pie_chart({"k": ["A", "B"], "v": [60, 40]})
+ui.metric("Users", 1520, delta=-12, inverse=True)  # inverse: down is good
+```
+
+### Text and feedback
+`ui.title`, `ui.header`, `ui.subheader`, `ui.text`, `ui.caption`, `ui.markdown` (safe), `ui.code`, `ui.json`, `ui.badge`, `ui.link`, `ui.image` (URL, path, bytes or PIL), `ui.progress`, `ui.info`, `ui.success`, `ui.warning`, `ui.error`, `ui.toast`, `ui.divider`, `ui.html` (trusted).
+
+### Chat apps
+```python
+ui.init(msgs=[])
+if q := ui.chat_input("Ask me…"):
+    ui.state.msgs += [("user", q), ("assistant", my_llm(q))]
+for role, text in ui.state.msgs:
+    ui.chat_message(role, text)
+```
+
+### Speed tools
+```python
+@velo.cache(ttl=300)          # shared across sessions, TTL + LRU
+def load_data(path): ...
+
+ui.autorefresh(5)             # live dashboards: re-run every 5 s while visible
+app.push()                    # from a background thread: refresh all open browsers
+app.push(ui.session_id)       # …or just one
+ui.rerun(); ui.navigate("/other")
+```
+
+---
+
+## Deploy
+
+```bash
+velo run app.py --prod          # 0.0.0.0, no reload, no tracebacks, gzip on
+velo docker app.py              # writes Dockerfile and vendors velo
+docker build -t myapp . && docker run -p 8000:8000 myapp
+```
+
+Velo reads `$PORT` and `$VELO_HOST`, so the same app runs unchanged on Render, Railway, Fly.io, Cloud Run, Koyeb, Heroku or a VPS. `/health` is there for load balancers. Behind nginx, turn off buffering for `/api/stream` (Velo already sends `X-Accel-Buffering: no`).
+
+## CLI
+
+| Command | What it does |
+|---|---|
+| `velo run app.py [--port N] [--host H] [--open] [--prod] [--no-reload]` | Run an app |
+| `velo new NAME` | Scaffold a starter app |
+| `velo docker [app.py] [--port N]` | Generate a Dockerfile and vendor Velo |
+| `velo version` | Print the version |
+
+## How it works
+
+1. The browser opens one SSE stream (used for hot reload and server push) and sends small JSON events (`set`, `click`, `submit`) to `/api/render`.
+2. The server applies the event to that browser's session, runs callbacks, then re-runs **only the page function**. That builds a compact component tree.
+3. The client morphs the live DOM to match the tree. Unchanged nodes aren't touched, so focus, caret, scroll position, open tabs and table sort all survive.
+4. When you save a file, the reloader re-executes your module, swaps the page functions into the running app and tells browsers to re-render. Sessions stay where they were.
+
+## Customising the look
+
+Pass `App(accent="#10b981", theme="dark", wide=True, icon="🚀")`, or override any CSS variable (`--accent`, `--radius`, `--font`…) with `ui.html("<style>:root{--r:6px}</style>")`.
+
+## Current limits
+
+- Sessions live in memory: use one process per app, or sticky sessions if you scale out.
+- Uploads travel as base64 JSON (practical up to roughly 25 MB).
+- No streaming of partial output inside a single run yet. For long jobs, use a background thread with `app.push()`.
+
+## Testing
+
+```bash
+python -m pytest -q        # or: python tests/test_velo.py
+```
+
+## Contributing
+
+Contributions are very welcome. Start with [CONTRIBUTING.md](CONTRIBUTING.md), pick a **good first issue**, and say hi in Discussions. Please follow the [Code of Conduct](CODE_OF_CONDUCT.md).
+
+MIT licensed. © 2026 Muhammad Rafay Shaikh

velo_ui-0.1.0/README.md

@@ -0,0 +1,204 @@
+# ⚡ Velo
+
+[![tests](https://github.com/rafay183/velo/actions/workflows/tests.yml/badge.svg)](https://github.com/rafay183/velo/actions/workflows/tests.yml)
+[![PyPI](https://img.shields.io/pypi/v/velo-ui.svg)](https://pypi.org/project/velo-ui/)
+[![Python](https://img.shields.io/badge/python-3.9%2B-blue)](#)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![Zero dependencies](https://img.shields.io/badge/dependencies-0-brightgreen)](#)
+
+**Beautiful, reactive Python web apps in minutes. Zero dependencies.**
+
+Velo lets anyone turn a Python script into a polished web app, with dashboards, forms, data tools and chat UIs. It runs on your laptop and deploys anywhere with one command. The whole framework is about 140 KB of pure-stdlib Python plus a 16 KB (gzipped) client.
+
+```python
+import velo
+
+app = velo.App("Hello", accent="#6366f1")
+
+@app.page("/")
+def home(ui):
+    name = ui.input("Your name", placeholder="Ada")
+    n = ui.slider("How excited?", 1, 10, 7)
+    ui.title(f"Hello {name or 'world'}" + " 🎉" * n)
+
+app.run()
+```
+
+```bash
+python app.py          # or:  velo run app.py
+```
+
+![Dashboard](docs/dashboard.png)
+
+<p><img src="docs/dark.png" width="49%"> <img src="docs/data.png" width="49%"></p>
+
+---
+
+## Why Velo?
+
+| | **Velo** | Typical script-rerun frameworks |
+|---|---|---|
+| Install size | **0 dependencies**, ~140 KB | Dozens of transitive packages |
+| What re-runs on a click | **Only the page function** | Often the whole script |
+| UI updates | **DOM morphing**: no flicker, focus and caret kept | Partial or full re-paint |
+| Hot reload | **Keeps your state** (widgets and `ui.state` survive a save) | Session usually resets |
+| Syntax error while editing | Overlay in the browser; app keeps running | Varies |
+| Tables | Built-in search, sort and paging on the client | Varies |
+| Charts | Built-in SVG line, area, bar and donut with tooltips, no deps | Usually needs a plotting library |
+| Typing in inputs | Debounced; sliders throttled | Often one round trip per change |
+| Live push from Python | `app.push()` from any thread (SSE) | Limited |
+| Deploy | `velo docker` (vendors itself), honours `$PORT` | Extra setup |
+| Theme | Light and dark with a toggle; one accent colour themes everything | Config files |
+
+---
+
+## Install
+
+```bash
+pip install velo-ui
+velo new myapp && cd myapp && velo run app.py
+```
+
+Needs Python 3.9+. Nothing else.
+
+---
+
+## The 60-second tour
+
+### Pages and navigation
+Two or more pages give you an automatic sidebar nav with client-side routing.
+
+```python
+@app.page("/", title="Dashboard", icon="📊")
+def dashboard(ui): ...
+
+@app.page("/settings", title="Settings", icon="⚙️")
+def settings(ui): ...
+```
+
+### Widgets return values
+```python
+name   = ui.input("Name", placeholder="…")          # also: type="password" | "email"
+bio    = ui.textarea("Bio", rows=4)
+age    = ui.number("Age", 30, min=0, max=120)
+level  = ui.slider("Level", 0, 100, 50, suffix="%")
+city   = ui.select("City", ["Karachi", "Lahore"])    # returns the object, any type
+plan   = ui.radio("Plan", ["Free", "Pro", "Team"])   # segmented control
+tags   = ui.multiselect("Tags", ["a", "b", "c"])     # chips
+ok     = ui.checkbox("I agree");  dark = ui.toggle("Dark mode")
+day    = ui.date("Start");        col  = ui.color("Brand", "#6366f1")
+f      = ui.upload("CSV file", accept=".csv")        # UploadedFile(.name .data .text())
+if ui.button("Save", icon="💾"): ...                 # True on the click run
+ui.download("Export", data, "report.csv")
+```
+
+### State and callbacks
+```python
+@app.page("/")
+def counter(ui):
+    ui.init(count=0)                        # defaults, set once per browser session
+
+    def add(step):
+        ui.state.count += step
+
+    with ui.row():
+        ui.button("−", on_click=add, args=(-1,), kind="secondary")
+        ui.button("+", on_click=add, args=(1,))
+    ui.metric("Count", ui.state.count)
+```
+Callbacks run **before** the re-render, so the page always shows consistent state. Use `ui.get("key")` and `ui.set("key", v)` to read or write any widget that has a `key=`.
+
+### Layout
+```python
+a, b, c = ui.columns(3)               # or ui.columns([2, 1])
+a.metric("Revenue", "$12.4k", "+8%")  # containers proxy every component…
+with b.card("Settings", "Optional subtitle"):   # …or use `with`
+    ui.toggle("Enabled")
+t1, t2 = ui.tabs(["Chart", "Data"])   # tabs switch instantly on the client
+with ui.expander("Advanced"): ...
+with ui.sidebar: ui.select("Region", [...])
+with ui.row(): ...                    # horizontal button group
+```
+
+### Data and charts (pandas optional)
+```python
+ui.table(df)                                       # DataFrame, list of dicts, dict of lists…
+ui.line_chart(df, x="date", y=["sales", "cost"])
+ui.area_chart(rows, x="day", y="revenue", title="Revenue")
+ui.bar_chart(rows, x="day", y=["a", "b"], stacked=True)
+ui.pie_chart({"k": ["A", "B"], "v": [60, 40]})
+ui.metric("Users", 1520, delta=-12, inverse=True)  # inverse: down is good
+```
+
+### Text and feedback
+`ui.title`, `ui.header`, `ui.subheader`, `ui.text`, `ui.caption`, `ui.markdown` (safe), `ui.code`, `ui.json`, `ui.badge`, `ui.link`, `ui.image` (URL, path, bytes or PIL), `ui.progress`, `ui.info`, `ui.success`, `ui.warning`, `ui.error`, `ui.toast`, `ui.divider`, `ui.html` (trusted).
+
+### Chat apps
+```python
+ui.init(msgs=[])
+if q := ui.chat_input("Ask me…"):
+    ui.state.msgs += [("user", q), ("assistant", my_llm(q))]
+for role, text in ui.state.msgs:
+    ui.chat_message(role, text)
+```
+
+### Speed tools
+```python
+@velo.cache(ttl=300)          # shared across sessions, TTL + LRU
+def load_data(path): ...
+
+ui.autorefresh(5)             # live dashboards: re-run every 5 s while visible
+app.push()                    # from a background thread: refresh all open browsers
+app.push(ui.session_id)       # …or just one
+ui.rerun(); ui.navigate("/other")
+```
+
+---
+
+## Deploy
+
+```bash
+velo run app.py --prod          # 0.0.0.0, no reload, no tracebacks, gzip on
+velo docker app.py              # writes Dockerfile and vendors velo
+docker build -t myapp . && docker run -p 8000:8000 myapp
+```
+
+Velo reads `$PORT` and `$VELO_HOST`, so the same app runs unchanged on Render, Railway, Fly.io, Cloud Run, Koyeb, Heroku or a VPS. `/health` is there for load balancers. Behind nginx, turn off buffering for `/api/stream` (Velo already sends `X-Accel-Buffering: no`).
+
+## CLI
+
+| Command | What it does |
+|---|---|
+| `velo run app.py [--port N] [--host H] [--open] [--prod] [--no-reload]` | Run an app |
+| `velo new NAME` | Scaffold a starter app |
+| `velo docker [app.py] [--port N]` | Generate a Dockerfile and vendor Velo |
+| `velo version` | Print the version |
+
+## How it works
+
+1. The browser opens one SSE stream (used for hot reload and server push) and sends small JSON events (`set`, `click`, `submit`) to `/api/render`.
+2. The server applies the event to that browser's session, runs callbacks, then re-runs **only the page function**. That builds a compact component tree.
+3. The client morphs the live DOM to match the tree. Unchanged nodes aren't touched, so focus, caret, scroll position, open tabs and table sort all survive.
+4. When you save a file, the reloader re-executes your module, swaps the page functions into the running app and tells browsers to re-render. Sessions stay where they were.
+
+## Customising the look
+
+Pass `App(accent="#10b981", theme="dark", wide=True, icon="🚀")`, or override any CSS variable (`--accent`, `--radius`, `--font`…) with `ui.html("<style>:root{--r:6px}</style>")`.
+
+## Current limits
+
+- Sessions live in memory: use one process per app, or sticky sessions if you scale out.
+- Uploads travel as base64 JSON (practical up to roughly 25 MB).
+- No streaming of partial output inside a single run yet. For long jobs, use a background thread with `app.push()`.
+
+## Testing
+
+```bash
+python -m pytest -q        # or: python tests/test_velo.py
+```
+
+## Contributing
+
+Contributions are very welcome. Start with [CONTRIBUTING.md](CONTRIBUTING.md), pick a **good first issue**, and say hi in Discussions. Please follow the [Code of Conduct](CODE_OF_CONDUCT.md).
+
+MIT licensed. © 2026 Muhammad Rafay Shaikh

velo_ui-0.1.0/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "velo-ui"
+version = "0.1.0"
+description = "Beautiful, reactive Python web apps in minutes. Zero dependencies."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Muhammad Rafay Shaikh" }]
+keywords = ["web", "ui", "dashboard", "streamlit alternative", "gradio alternative", "data apps"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Education",
+    "Topic :: Software Development :: User Interfaces",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/rafay183/velo"
+Issues = "https://github.com/rafay183/velo/issues"
+Changelog = "https://github.com/rafay183/velo/blob/main/CHANGELOG.md"
+
+[project.scripts]
+velo = "velo.cli:main"
+
+[tool.setuptools]
+packages = ["velo"]
+
+[tool.setuptools.package-data]
+velo = ["static/*"]

velo_ui-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

velo_ui-0.1.0/tests/test_velo.py

@@ -0,0 +1,157 @@
+"""Run:  python -m pytest -q   (or: python tests/test_velo.py)"""
+import json
+import os
+import sys
+import threading
+import time
+import urllib.request
+
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), ".."))
+import velo  # noqa: E402
+from velo import server  # noqa: E402
+from velo.markdown import render as md  # noqa: E402
+
+
+def make_app():
+    app = velo.App("Test")
+
+    @app.page("/")
+    def home(ui):
+        ui.init(n=0)
+
+        def inc(step=1):
+            ui.state.n += step
+
+        ui.button("Add", on_click=inc, args=(2,))
+        ui.text(f"n={ui.state.n}")
+        v = ui.slider("S", 0, 10, 5)
+        c = ui.select("C", [1, 2, 3], value=2)
+        m = ui.multiselect("M", ["a", "b", "c"], value=["a"])
+        t = ui.toggle("T")
+        ui.text(f"{v}|{c!r}|{m}|{t}")
+        if ui.button("Boom"):
+            raise RuntimeError("kaboom")
+        msg = ui.chat_input("say")
+        if msg:
+            ui.text(f"got:{msg}")
+
+    @app.page("/two", title="Two")
+    def two(ui):
+        ui.title("Page two")
+    return app
+
+
+def texts(out):
+    return [n["p"]["text"] for n in out["tree"] if n["t"] == "text"]
+
+
+def test_initial_render_and_nav():
+    out = make_app().dispatch("s", "/", None)
+    assert texts(out)[:2] == ["n=0", "5|2|['a']|False"]
+    assert [p["path"] for p in out["nav"]] == ["/", "/two"]
+
+
+def test_callbacks_and_values():
+    app = make_app()
+    app.dispatch("s", "/", None)
+    app.dispatch("s", "/", {"type": "click", "k": "button:Add"})
+    app.dispatch("s", "/", {"type": "set", "k": "slider:S", "v": 99})       # clamped to max
+    app.dispatch("s", "/", {"type": "set", "k": "select:C", "v": 2})        # index -> option
+    app.dispatch("s", "/", {"type": "set", "k": "multiselect:M", "v": [1, 2]})
+    out = app.dispatch("s", "/", {"type": "set", "k": "toggle:T", "v": True})
+    assert texts(out)[:2] == ["n=2", "10|3|['b', 'c']|True"]
+
+
+def test_sessions_are_isolated():
+    app = make_app()
+    app.dispatch("a", "/", None)
+    app.dispatch("a", "/", {"type": "click", "k": "button:Add"})
+    assert texts(app.dispatch("b", "/", None))[0] == "n=0"
+
+
+def test_invalid_values_ignored():
+    app = make_app()
+    app.dispatch("s", "/", None)
+    out = app.dispatch("s", "/", {"type": "set", "k": "select:C", "v": 99})
+    assert "5|2|" in texts(out)[1]
+
+
+def test_errors_are_contained():
+    app = make_app()
+    app.dispatch("s", "/", None)
+    out = app.dispatch("s", "/", {"type": "click", "k": "button:Boom"})
+    err = [n for n in out["tree"] if n["t"] == "error"]
+    assert err and "kaboom" in err[0]["p"]["text"]
+    assert "velo/core.py" not in err[0]["p"]["tb"]  # framework frames hidden
+
+
+def test_chat_input_returns_once():
+    app = make_app()
+    app.dispatch("s", "/", None)
+    out = app.dispatch("s", "/", {"type": "submit", "k": "chat_input:say", "v": "hi"})
+    assert "got:hi" in texts(out)
+    assert "got:hi" not in texts(app.dispatch("s", "/", None))
+
+
+def test_404():
+    out = make_app().dispatch("s", "/nope", None)
+    assert out["tree"][0]["t"] == "notfound"
+
+
+def test_cache():
+    calls = []
+
+    @velo.cache(ttl=60)
+    def f(x):
+        calls.append(x)
+        return x * 2
+
+    assert f(2) == 4 and f(2) == 4 and f(3) == 6
+    assert calls == [2, 3]
+
+
+def test_tabular_shapes():
+    from velo.core import _tabular, _chart_data
+    assert _tabular([{"a": 1}, {"a": 2, "b": 3}]) == (["a", "b"], [[1, None], [2, 3]])
+    assert _tabular({"x": [1, 2], "y": [3, 4]}) == (["x", "y"], [[1, 3], [2, 4]])
+    xs, s = _chart_data({"day": ["a", "b"], "v": [1, 2]})
+    assert xs == ["a", "b"] and s[0]["name"] == "v"
+    try:
+        import pandas as pd
+        cols, rows = _tabular(pd.DataFrame({"a": [1, 2], "b": [0.5, float("nan")]}))
+        assert cols == ["a", "b"] and rows[1] == [2, None]
+    except ImportError:
+        pass
+
+
+def test_markdown_escapes_html():
+    out = md("**hi** <script>x</script> [l](javascript:alert(1))")
+    assert "<strong>hi</strong>" in out and "<script>" not in out and "javascript:" not in out
+
+
+def test_http_roundtrip():
+    app = make_app()
+    httpd = server._Server(("127.0.0.1", 0), server._Handler)
+    httpd.app = app
+    threading.Thread(target=httpd.serve_forever, daemon=True).start()
+    base = f"http://127.0.0.1:{httpd.server_address[1]}"
+    try:
+        assert b"window.VELO" in urllib.request.urlopen(base + "/").read()
+        assert urllib.request.urlopen(base + "/_velo/app.js").status == 200
+        assert json.loads(urllib.request.urlopen(base + "/health").read())["ok"]
+        req = urllib.request.Request(base + "/api/render", data=json.dumps(
+            {"sid": "h", "path": "/", "event": {"type": "click", "k": "button:Add"}}).encode())
+        app.dispatch("h", "/", None)
+        out = json.loads(urllib.request.urlopen(req).read())
+        assert texts(out)[0] == "n=2"
+    finally:
+        httpd.shutdown()
+
+
+if __name__ == "__main__":
+    t0 = time.time()
+    fns = [v for k, v in dict(globals()).items() if k.startswith("test_")]
+    for fn in fns:
+        fn()
+        print("✓", fn.__name__)
+    print(f"\n{len(fns)} passed in {time.time() - t0:.2f}s")

velo_ui-0.1.0/velo/__init__.py

@@ -0,0 +1,18 @@
+"""Velo — beautiful, reactive Python web apps. Zero dependencies.
+
+    import velo
+
+    app = velo.App("Hello")
+
+    @app.page("/")
+    def home(ui):
+        name = ui.input("Your name")
+        ui.title(f"Hello, {name or 'world'} 👋")
+
+    app.run()
+"""
+__version__ = "0.1.0"
+
+from .core import App, UI, State, UploadedFile, Rerun, cache  # noqa: E402
+
+__all__ = ["App", "UI", "State", "UploadedFile", "Rerun", "cache", "__version__"]

velo_ui-0.1.0/velo/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    main()