claide-web 0.1.0__tar.gz

claide_web-0.1.0/.gitignore

@@ -0,0 +1,8 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+.venv/
+venv/
+.pytest_cache/

claide_web-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kurodaki
+
+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.

claide_web-0.1.0/PKG-INFO

@@ -0,0 +1,230 @@
+Metadata-Version: 2.5
+Name: claide-web
+Version: 0.1.0
+Summary: Build complete websites in Python: pages, routes, forms, APIs, sessions and Uiverse.io components.
+Project-URL: Homepage, https://github.com/kurodaki-dev/Claide
+Project-URL: Issues, https://github.com/kurodaki-dev/Claide/issues
+Author: kurodaki-dev
+License-Expression: MIT
+License-File: LICENSE
+Keywords: css,framework,html,uiverse,web,website,wsgi
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Application
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Python: >=3.9
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Claide ✦
+
+**Build complete websites in Python, from A to Z**: HTML pages, dynamic routes,
+forms, file uploads, JSON APIs, sessions, your own `style.css` / `script.js`, and
+the thousands of components from [cssbuttons.io](https://cssbuttons.io) / [Uiverse.io](https://uiverse.io)
+in a single line. Zero dependencies.
+
+```bash
+pip install claide-web
+```
+
+The package is published on PyPI as `claide-web`, but you import it as `claide`.
+
+## Quick start
+
+```bash
+claide new mysite
+cd mysite
+python app.py        # -> http://127.0.0.1:8000 (auto-reload)
+```
+
+```python
+from claide import App, Page, tags as t
+
+app = App(__name__)
+
+@app.route("/")
+def home():
+    return Page("Home", t.h1("Hello!"), t.p("My first Claide website."))
+
+app.run()
+```
+
+## Uiverse / cssbuttons.io components
+
+Copy the URL of an element on uiverse.io (cssbuttons.io redirects to uiverse.io/buttons):
+
+```python
+from claide import UITemplate          # or: from claide import uitemplate
+
+button = UITemplate("https://uiverse.io/0x-Sarthak/hungry-penguin-30")
+# or UITemplate("0x-Sarthak/hungry-penguin-30")
+
+page.add(
+    button
+      .text("Contact Us", "Write me")     # change the text
+      .attrs(id="send", onclick="go()")   # add attributes
+      .link("/contact")                   # turn it into a link
+)
+```
+
+- The component's CSS is **injected automatically** into the `<head>` (only once).
+- Tailwind-based components load Tailwind by themselves.
+- `.scoped()` / `.prefix("x-")` rename the CSS classes to avoid conflicts
+  (e.g. two components that both use `.button`).
+- `.add_css("...")` lets you override colors.
+- `UITemplate(html="...", css="...")` or `UITemplate.from_file("button.html")` for your own code.
+- `UITemplate.builtin("glow", "Send")`: bundled components that work offline
+  (`gradient`, `glow`, `slide`, `pushable`, `spinner`, `toggle`, `card`).
+- Components are downloaded from the official `uiverse-io/galaxy` repository
+  (MIT license) and cached in `~/.cache/claide`.
+
+From the command line: `claide ui author/name --preview` or `--save button.html`.
+
+## Linking your CSS / JS files
+
+```
+mysite/
+├── app.py
+└── static/
+    ├── style.css
+    ├── script.js
+    └── logo.png
+```
+
+```python
+app.css(app.static("style.css"))   # on every page
+app.js(app.static("script.js"))
+
+page = Page("Contact")
+page.css("/static/contact.css")    # on a single page
+page.js("https://cdn.jsdelivr.net/npm/chart.js")
+page.style("h1 { color: red }")    # inline CSS
+page.script("console.log('hi')")   # inline JS
+page.style_file("theme.css")       # inline the content of a file
+```
+
+## Building HTML in Python
+
+```python
+from claide import tags as t, raw
+
+t.div(
+    t.h1("Title", class_="big"),          # class_ -> class
+    t.a("Link", href="/x", data_id=3),    # data_id -> data-id
+    t.input(type="checkbox", checked=True),
+    t.ul([t.li(x) for x in ["a", "b"]]),
+    raw("<b>raw HTML</b>"),
+    style={"padding": "1rem"},
+)
+```
+
+Text is escaped automatically (XSS protection) except with `raw()`.
+
+### Layout components
+
+```python
+from claide.components import Navbar, Hero, Section, Grid, Card, Footer, Form, Field, Button, Alert
+
+Page("Home",
+    Navbar("My site", [("Home", "/"), ("Contact", "/contact")]),
+    Hero("Welcome", "Subtitle", Button("Get started", "/start")),
+    Section(Grid(Card("A", "text"), Card("B", "text", image="/static/b.jpg")), title="Services"),
+    Footer("© 2026"),
+)
+```
+
+## Dynamic server
+
+```python
+from claide import App, Page, Router, redirect, abort, send_file
+
+app = App(__name__, secret_key="change-me")
+
+@app.get("/user/<int:uid>")              # converters: str, int, float, slug, path
+def user(uid, request):
+    page = request.args.get("page", "1") # ?page=2
+    return Page(f"User {uid}", ...)
+
+@app.route("/contact", methods=["GET", "POST"])
+def contact(request):
+    if request.method == "POST":
+        name = request.form["name"]
+        request.files["cv"].save("uploads/")    # file upload
+        request.session["name"] = name          # session (signed cookie)
+        return redirect("/thanks")
+    return Page(...)
+
+@app.post("/api/items")
+def create(request):
+    data = request.json
+    return {"ok": True, "item": data}, 201   # dict/list -> JSON
+
+@app.errorhandler(404)
+def not_found():
+    return Page("Oops", t.h1("Page not found"))
+
+@app.layout                                  # applied to every Page
+def base(page):
+    page.body.children.insert(0, navbar)
+
+@app.before_request
+def auth(request):
+    if request.path.startswith("/admin") and not request.session.get("admin"):
+        return redirect("/login")
+
+api = Router("/api/v2")
+@api.get("/ping")
+def ping(): return {"pong": True}
+app.include(api)
+```
+
+A route can return: a `Page`, an element, a `UITemplate`, `str`, `dict`/`list` (JSON),
+a `Response`, a generator (streaming), or a `(body, status, headers)` tuple.
+
+### Production
+
+`App` is a standard **WSGI** application:
+
+```bash
+pip install gunicorn
+gunicorn app:app
+```
+
+### Static export (optional)
+
+```bash
+claide build app:app --out dist     # or app.build("dist")
+```
+
+## Testing
+
+```python
+client = app.test_client()
+assert client.get("/").status == 200
+assert client.post("/api/items", json_data={"a": 1}).json["ok"]
+```
+
+## Automatic PyPI publishing
+
+`.github/workflows/ci.yml` runs the tests, builds the package, then publishes it
+to PyPI on every push to `main` (and on `v*` tags). If the version already exists,
+nothing is uploaded: **bump `__version__` in `claide/__init__.py` to release.**
+
+One-time setup:
+
+1. On [pypi.org](https://pypi.org/manage/account/token/), create an API token.
+2. On GitHub: *Settings → Secrets and variables → Actions → New repository secret*,
+   name **`PYPI_API_TOKEN`**, value = the token (`pypi-...`).
+3. The job uses the `pypi` GitHub environment (created automatically; you can add
+   a manual approval in *Settings → Environments*).
+
+## License
+
+MIT. Uiverse.io components are MIT licensed; please credit their authors
+(Claide automatically adds a credit comment in the CSS).

claide_web-0.1.0/README.md

@@ -0,0 +1,206 @@
+# Claide ✦
+
+**Build complete websites in Python, from A to Z**: HTML pages, dynamic routes,
+forms, file uploads, JSON APIs, sessions, your own `style.css` / `script.js`, and
+the thousands of components from [cssbuttons.io](https://cssbuttons.io) / [Uiverse.io](https://uiverse.io)
+in a single line. Zero dependencies.
+
+```bash
+pip install claide-web
+```
+
+The package is published on PyPI as `claide-web`, but you import it as `claide`.
+
+## Quick start
+
+```bash
+claide new mysite
+cd mysite
+python app.py        # -> http://127.0.0.1:8000 (auto-reload)
+```
+
+```python
+from claide import App, Page, tags as t
+
+app = App(__name__)
+
+@app.route("/")
+def home():
+    return Page("Home", t.h1("Hello!"), t.p("My first Claide website."))
+
+app.run()
+```
+
+## Uiverse / cssbuttons.io components
+
+Copy the URL of an element on uiverse.io (cssbuttons.io redirects to uiverse.io/buttons):
+
+```python
+from claide import UITemplate          # or: from claide import uitemplate
+
+button = UITemplate("https://uiverse.io/0x-Sarthak/hungry-penguin-30")
+# or UITemplate("0x-Sarthak/hungry-penguin-30")
+
+page.add(
+    button
+      .text("Contact Us", "Write me")     # change the text
+      .attrs(id="send", onclick="go()")   # add attributes
+      .link("/contact")                   # turn it into a link
+)
+```
+
+- The component's CSS is **injected automatically** into the `<head>` (only once).
+- Tailwind-based components load Tailwind by themselves.
+- `.scoped()` / `.prefix("x-")` rename the CSS classes to avoid conflicts
+  (e.g. two components that both use `.button`).
+- `.add_css("...")` lets you override colors.
+- `UITemplate(html="...", css="...")` or `UITemplate.from_file("button.html")` for your own code.
+- `UITemplate.builtin("glow", "Send")`: bundled components that work offline
+  (`gradient`, `glow`, `slide`, `pushable`, `spinner`, `toggle`, `card`).
+- Components are downloaded from the official `uiverse-io/galaxy` repository
+  (MIT license) and cached in `~/.cache/claide`.
+
+From the command line: `claide ui author/name --preview` or `--save button.html`.
+
+## Linking your CSS / JS files
+
+```
+mysite/
+├── app.py
+└── static/
+    ├── style.css
+    ├── script.js
+    └── logo.png
+```
+
+```python
+app.css(app.static("style.css"))   # on every page
+app.js(app.static("script.js"))
+
+page = Page("Contact")
+page.css("/static/contact.css")    # on a single page
+page.js("https://cdn.jsdelivr.net/npm/chart.js")
+page.style("h1 { color: red }")    # inline CSS
+page.script("console.log('hi')")   # inline JS
+page.style_file("theme.css")       # inline the content of a file
+```
+
+## Building HTML in Python
+
+```python
+from claide import tags as t, raw
+
+t.div(
+    t.h1("Title", class_="big"),          # class_ -> class
+    t.a("Link", href="/x", data_id=3),    # data_id -> data-id
+    t.input(type="checkbox", checked=True),
+    t.ul([t.li(x) for x in ["a", "b"]]),
+    raw("<b>raw HTML</b>"),
+    style={"padding": "1rem"},
+)
+```
+
+Text is escaped automatically (XSS protection) except with `raw()`.
+
+### Layout components
+
+```python
+from claide.components import Navbar, Hero, Section, Grid, Card, Footer, Form, Field, Button, Alert
+
+Page("Home",
+    Navbar("My site", [("Home", "/"), ("Contact", "/contact")]),
+    Hero("Welcome", "Subtitle", Button("Get started", "/start")),
+    Section(Grid(Card("A", "text"), Card("B", "text", image="/static/b.jpg")), title="Services"),
+    Footer("© 2026"),
+)
+```
+
+## Dynamic server
+
+```python
+from claide import App, Page, Router, redirect, abort, send_file
+
+app = App(__name__, secret_key="change-me")
+
+@app.get("/user/<int:uid>")              # converters: str, int, float, slug, path
+def user(uid, request):
+    page = request.args.get("page", "1") # ?page=2
+    return Page(f"User {uid}", ...)
+
+@app.route("/contact", methods=["GET", "POST"])
+def contact(request):
+    if request.method == "POST":
+        name = request.form["name"]
+        request.files["cv"].save("uploads/")    # file upload
+        request.session["name"] = name          # session (signed cookie)
+        return redirect("/thanks")
+    return Page(...)
+
+@app.post("/api/items")
+def create(request):
+    data = request.json
+    return {"ok": True, "item": data}, 201   # dict/list -> JSON
+
+@app.errorhandler(404)
+def not_found():
+    return Page("Oops", t.h1("Page not found"))
+
+@app.layout                                  # applied to every Page
+def base(page):
+    page.body.children.insert(0, navbar)
+
+@app.before_request
+def auth(request):
+    if request.path.startswith("/admin") and not request.session.get("admin"):
+        return redirect("/login")
+
+api = Router("/api/v2")
+@api.get("/ping")
+def ping(): return {"pong": True}
+app.include(api)
+```
+
+A route can return: a `Page`, an element, a `UITemplate`, `str`, `dict`/`list` (JSON),
+a `Response`, a generator (streaming), or a `(body, status, headers)` tuple.
+
+### Production
+
+`App` is a standard **WSGI** application:
+
+```bash
+pip install gunicorn
+gunicorn app:app
+```
+
+### Static export (optional)
+
+```bash
+claide build app:app --out dist     # or app.build("dist")
+```
+
+## Testing
+
+```python
+client = app.test_client()
+assert client.get("/").status == 200
+assert client.post("/api/items", json_data={"a": 1}).json["ok"]
+```
+
+## Automatic PyPI publishing
+
+`.github/workflows/ci.yml` runs the tests, builds the package, then publishes it
+to PyPI on every push to `main` (and on `v*` tags). If the version already exists,
+nothing is uploaded: **bump `__version__` in `claide/__init__.py` to release.**
+
+One-time setup:
+
+1. On [pypi.org](https://pypi.org/manage/account/token/), create an API token.
+2. On GitHub: *Settings → Secrets and variables → Actions → New repository secret*,
+   name **`PYPI_API_TOKEN`**, value = the token (`pypi-...`).
+3. The job uses the `pypi` GitHub environment (created automatically; you can add
+   a manual approval in *Settings → Environments*).
+
+## License
+
+MIT. Uiverse.io components are MIT licensed; please credit their authors
+(Claide automatically adds a credit comment in the CSS).

claide_web-0.1.0/claide/__init__.py

@@ -0,0 +1,26 @@
+"""Claide — build complete websites in Python, from A to Z.
+
+    from claide import App, Page, UITemplate, tags as t
+
+See https://github.com/kurodaki-dev/Claide
+"""
+
+from .app import (
+    App, HTTPError, Request, Response, Router, UploadedFile, abort, redirect, send_file,
+)
+from .html import Element, Fragment, Raw, escape, raw, tags
+from .page import Page
+from .uitemplate import CATEGORIES, UITemplate, UITemplateError, builtin_templates
+
+# Also allows "from claide import uitemplate" then uitemplate.UITemplate(...)
+from . import components, uitemplate  # noqa: E402
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "App", "Router", "Request", "Response", "UploadedFile", "HTTPError",
+    "abort", "redirect", "send_file",
+    "Element", "Fragment", "Raw", "escape", "raw", "tags",
+    "Page", "UITemplate", "UITemplateError", "CATEGORIES", "builtin_templates",
+    "components", "uitemplate", "__version__",
+]

claide_web-0.1.0/claide/__main__.py

@@ -0,0 +1,3 @@
+from .cli import main
+
+main()