pyrite-web 0.1.0__tar.gz

pyrite_web-0.1.0/LICENSE

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

pyrite_web-0.1.0/PKG-INFO

@@ -0,0 +1,219 @@
+Metadata-Version: 2.4
+Name: pyrite-web
+Version: 0.1.0
+Summary: Code websites in Python 3, without writing JavaScript or CSS.
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Pyrite
+
+Code websites in Python 3, for JavaScript and CSS haters.
+
+Pyrite is a small, dependency-free starting point: compose Python components,
+return a page, and serve HTML with built-in responsive styling. Requires Python 3.10+.
+
+## Run the example
+
+```sh
+python3 example.py
+```
+
+Open http://127.0.0.1:8000. The example is Pyrite's first website: a homepage
+with a code/output comparison, quickstart, expandable FAQ, and a component
+guide at `/guide`. Try `/playground` for a Python-powered calculator.
+Its application source uses only Python components.
+No installation is required when running from this repository.
+
+## Build a page
+
+```python
+from pyrite import App, Column, Heading, Page, Text
+
+app = App()
+
+@app.page("/")
+def home():
+    return Page(
+        Column(Heading("Hello, Pyrite."), Text("Just Python.")),
+        title="My website",
+    )
+
+if __name__ == "__main__":
+    app.run()
+```
+
+Available components: `Heading`, `Text`, `Column`, `Row`, `Card`, `Link`, and
+`Button`, `Section`, `Nav`, `Code`, and `Details`. Nest components directly.
+`Section(..., id="start")` creates an anchor target. `Code(source, label="Python")`
+displays escaped source. `Details(question, ...)` provides a native expandable answer.
+`Heading` accepts `level=1` through `6`.
+`Link(label, href)` and `Button(label, href)` navigate to another URL.
+Text and HTML attributes are escaped automatically.
+
+Register exact paths with `@app.page("/about")`. Handlers take no arguments and
+return a `Page`. Query strings do not affect route matching. `Page` accepts
+`title` and `language`; `app.run` accepts `host` and `port`.
+
+## Current scope
+
+This version serves server-rendered pages with native GET forms and JSON POST
+callbacks through `LiveForm` and `Chat`. It does not include server sessions,
+token streaming, live reload, or a production server. The built-in
+HTTP server is for local development. Styling is supplied by Pyrite; applications
+do not need CSS files or JavaScript tooling.
+
+## Styling in Python
+
+Edit the root `styles.py` to change the example website's shared theme. Restart
+the server after editing. `Theme` supports six-digit hex colors, `sans`, `serif`,
+or `mono` fonts, page width, corner radius, and spacing. Apply a theme to any page:
+
+```python
+from pyrite import Theme
+
+theme = Theme(background="#111820", text="#eef3f8", heading_font="sans")
+page = Page(Heading("Your style."), theme=theme)
+```
+
+## Forms without JavaScript
+
+```python
+from pyrite import Form, Input, Submit, query
+
+@app.page("/hello")
+def hello():
+    return Page(Column(
+        Form(Input("name", "Your name", value=query("name")), Submit("Say hello")),
+        Text(f"Hello, {query('name', 'world')}!"),
+    ))
+```
+
+`Slider(name, label, value=5, minimum=1, maximum=10)` and
+`Select(name, label, {"value": "Label"}, value="value")` also work in forms.
+Submission reloads the page; `query` reads request-local URL parameters. GET forms
+are for read-only calculations and searches; their values appear in the URL.
+
+## Try Pyrite in Browser
+
+Visit `/try` to edit Python and render a real `Page` without installing Python.
+Assign your result to `page`; do not call `app.run()`. The editor loads Pyodide
+from jsDelivr and runs code in a disposable Web Worker, with a 10-second execution
+limit and an isolated preview. First download can take up to two minutes.
+Code is not executed on the application server. Browser networking follows CORS
+rules; the standard-library HTTP client below is for server-side Python.
+
+## Images and motion
+
+```python
+from pyrite import Image, Motion
+from styles import hero_image
+
+banner = Motion(Image(hero_image, "Mountain landscape"), effect="rise")
+```
+
+Choose `rise`, `fade`, or `float`. In `styles.py`, set `motion=False` to disable
+component animations, or change `motion_duration` (100–5000 milliseconds) for
+entrances. Reduced-motion browser preferences disable animations automatically.
+`Theme(background_image="https://example.com/background.jpg")` attaches a page
+background. `Image` accepts relative or HTTP(S) URLs and requires alt text.
+External images load directly from their host; local file serving is not included.
+
+## Requests and changing API data
+
+```python
+from pyrite import requests
+
+data = requests.get(
+    "https://api.mymemory.translated.net/get",
+    params={"q": "Good morning", "langpair": "en|uk"},
+).json()
+
+# For an API you control, with the authentication it requires:
+# requests.post("https://your-api.example/items", json={"name": "New"})
+# requests.put("https://your-api.example/items/1", json={"name": "Changed"})
+# requests.delete("https://your-api.example/items/1")
+```
+
+The dependency-free client supports `get`, `post`, `put`, and `delete`, optional
+headers, JSON bodies, query parameters, and a timeout (8 seconds by default).
+Responses expose `status_code`, `text`, and `json()`. Catch `requests.RequestError`
+for HTTP/network/decoding failures. Responses are limited to 1 MiB. Supply trusted
+URLs in application code; do not forward visitor-provided URLs to this client.
+GET page handlers should only read data. POST actions can make remote writes;
+add application authentication and authorization before exposing private data or
+operations. Pyrite's local development server does not provide authentication.
+
+`/translate` demonstrates input, a real free MyMemory request, and updated page
+content. No API key required; availability, translation quality, and quotas depend
+on MyMemory. Submitted text is sent to that service.
+
+## Corners and gradients
+
+```python
+from pyrite import Gradient, Theme
+
+theme = Theme(
+    radius=20,              # Panels, code blocks, images, details
+    button_radius=999,      # Pill buttons; 0 gives square corners
+    input_radius=12,        # Inputs and dropdowns
+    gradient=Gradient(
+        colors=("#101923", "#214a42", "#17283d"),
+        angle=120,
+        moving=True,
+        duration=14,       # Seconds per cycle
+    ),
+)
+```
+
+`button_radius` and `input_radius` inherit `radius` when omitted. Gradients accept
+2–8 hex colors; set `moving=False` for a static gradient or `gradient=None` for
+the usual background. A fixed background layer animates independently of page
+length. `motion=False` or the browser's reduced-motion preference stops its movement.
+The gradient layer sits over a background image when both are configured.
+
+## In-page requests and chat
+
+```python
+from pyrite import App, Chat, Page
+
+app = App()
+
+@app.action("/api/reply")
+def reply(data):
+    message = data["message"]
+    history = data.get("history", [])
+    # Call a model here with pyrite.requests; keep API keys on the server.
+    return {"reply": "You said: " + message}
+
+@app.page("/")
+def home():
+    return Page(Chat(action="/api/reply"))
+```
+
+Visit `/chat` for a working local rule-based chatbot and a live translation form.
+`Chat` sends `{message, history}` and displays `reply` without a page reload.
+History stays in this page's browser memory (last 20 messages), is sent with each
+request, and clears on reload. It is untrusted input; validate it in callbacks.
+This is completed-response chat, not token streaming. The demo uses no AI service.
+
+For other interfaces, use `LiveForm(Input(...), Submit(...), action="/api/action")`
+and return `{"text": "Updated result"}` from the action. All field values arrive
+as strings. Pyrite supplies the JavaScript, pending state, errors, 30-second
+client timeout, and safe text rendering. The callback can use `requests` to reach
+external APIs without exposing credentials to the browser. Aborting a request
+does not cancel Python work already running.
+
+Actions accept JSON objects up to 16 KiB and reject cross-origin browser requests.
+These checks do not authenticate users. Use application validation and authorization
+for sensitive actions. Live components require JavaScript; ordinary pages and GET
+forms continue working without it. Browser playground previews remain isolated and
+cannot call server actions.
+
+## Tests
+
+```sh
+python3 -m unittest discover -s tests -v
+```

pyrite_web-0.1.0/README.md

@@ -0,0 +1,209 @@
+# Pyrite
+
+Code websites in Python 3, for JavaScript and CSS haters.
+
+Pyrite is a small, dependency-free starting point: compose Python components,
+return a page, and serve HTML with built-in responsive styling. Requires Python 3.10+.
+
+## Run the example
+
+```sh
+python3 example.py
+```
+
+Open http://127.0.0.1:8000. The example is Pyrite's first website: a homepage
+with a code/output comparison, quickstart, expandable FAQ, and a component
+guide at `/guide`. Try `/playground` for a Python-powered calculator.
+Its application source uses only Python components.
+No installation is required when running from this repository.
+
+## Build a page
+
+```python
+from pyrite import App, Column, Heading, Page, Text
+
+app = App()
+
+@app.page("/")
+def home():
+    return Page(
+        Column(Heading("Hello, Pyrite."), Text("Just Python.")),
+        title="My website",
+    )
+
+if __name__ == "__main__":
+    app.run()
+```
+
+Available components: `Heading`, `Text`, `Column`, `Row`, `Card`, `Link`, and
+`Button`, `Section`, `Nav`, `Code`, and `Details`. Nest components directly.
+`Section(..., id="start")` creates an anchor target. `Code(source, label="Python")`
+displays escaped source. `Details(question, ...)` provides a native expandable answer.
+`Heading` accepts `level=1` through `6`.
+`Link(label, href)` and `Button(label, href)` navigate to another URL.
+Text and HTML attributes are escaped automatically.
+
+Register exact paths with `@app.page("/about")`. Handlers take no arguments and
+return a `Page`. Query strings do not affect route matching. `Page` accepts
+`title` and `language`; `app.run` accepts `host` and `port`.
+
+## Current scope
+
+This version serves server-rendered pages with native GET forms and JSON POST
+callbacks through `LiveForm` and `Chat`. It does not include server sessions,
+token streaming, live reload, or a production server. The built-in
+HTTP server is for local development. Styling is supplied by Pyrite; applications
+do not need CSS files or JavaScript tooling.
+
+## Styling in Python
+
+Edit the root `styles.py` to change the example website's shared theme. Restart
+the server after editing. `Theme` supports six-digit hex colors, `sans`, `serif`,
+or `mono` fonts, page width, corner radius, and spacing. Apply a theme to any page:
+
+```python
+from pyrite import Theme
+
+theme = Theme(background="#111820", text="#eef3f8", heading_font="sans")
+page = Page(Heading("Your style."), theme=theme)
+```
+
+## Forms without JavaScript
+
+```python
+from pyrite import Form, Input, Submit, query
+
+@app.page("/hello")
+def hello():
+    return Page(Column(
+        Form(Input("name", "Your name", value=query("name")), Submit("Say hello")),
+        Text(f"Hello, {query('name', 'world')}!"),
+    ))
+```
+
+`Slider(name, label, value=5, minimum=1, maximum=10)` and
+`Select(name, label, {"value": "Label"}, value="value")` also work in forms.
+Submission reloads the page; `query` reads request-local URL parameters. GET forms
+are for read-only calculations and searches; their values appear in the URL.
+
+## Try Pyrite in Browser
+
+Visit `/try` to edit Python and render a real `Page` without installing Python.
+Assign your result to `page`; do not call `app.run()`. The editor loads Pyodide
+from jsDelivr and runs code in a disposable Web Worker, with a 10-second execution
+limit and an isolated preview. First download can take up to two minutes.
+Code is not executed on the application server. Browser networking follows CORS
+rules; the standard-library HTTP client below is for server-side Python.
+
+## Images and motion
+
+```python
+from pyrite import Image, Motion
+from styles import hero_image
+
+banner = Motion(Image(hero_image, "Mountain landscape"), effect="rise")
+```
+
+Choose `rise`, `fade`, or `float`. In `styles.py`, set `motion=False` to disable
+component animations, or change `motion_duration` (100–5000 milliseconds) for
+entrances. Reduced-motion browser preferences disable animations automatically.
+`Theme(background_image="https://example.com/background.jpg")` attaches a page
+background. `Image` accepts relative or HTTP(S) URLs and requires alt text.
+External images load directly from their host; local file serving is not included.
+
+## Requests and changing API data
+
+```python
+from pyrite import requests
+
+data = requests.get(
+    "https://api.mymemory.translated.net/get",
+    params={"q": "Good morning", "langpair": "en|uk"},
+).json()
+
+# For an API you control, with the authentication it requires:
+# requests.post("https://your-api.example/items", json={"name": "New"})
+# requests.put("https://your-api.example/items/1", json={"name": "Changed"})
+# requests.delete("https://your-api.example/items/1")
+```
+
+The dependency-free client supports `get`, `post`, `put`, and `delete`, optional
+headers, JSON bodies, query parameters, and a timeout (8 seconds by default).
+Responses expose `status_code`, `text`, and `json()`. Catch `requests.RequestError`
+for HTTP/network/decoding failures. Responses are limited to 1 MiB. Supply trusted
+URLs in application code; do not forward visitor-provided URLs to this client.
+GET page handlers should only read data. POST actions can make remote writes;
+add application authentication and authorization before exposing private data or
+operations. Pyrite's local development server does not provide authentication.
+
+`/translate` demonstrates input, a real free MyMemory request, and updated page
+content. No API key required; availability, translation quality, and quotas depend
+on MyMemory. Submitted text is sent to that service.
+
+## Corners and gradients
+
+```python
+from pyrite import Gradient, Theme
+
+theme = Theme(
+    radius=20,              # Panels, code blocks, images, details
+    button_radius=999,      # Pill buttons; 0 gives square corners
+    input_radius=12,        # Inputs and dropdowns
+    gradient=Gradient(
+        colors=("#101923", "#214a42", "#17283d"),
+        angle=120,
+        moving=True,
+        duration=14,       # Seconds per cycle
+    ),
+)
+```
+
+`button_radius` and `input_radius` inherit `radius` when omitted. Gradients accept
+2–8 hex colors; set `moving=False` for a static gradient or `gradient=None` for
+the usual background. A fixed background layer animates independently of page
+length. `motion=False` or the browser's reduced-motion preference stops its movement.
+The gradient layer sits over a background image when both are configured.
+
+## In-page requests and chat
+
+```python
+from pyrite import App, Chat, Page
+
+app = App()
+
+@app.action("/api/reply")
+def reply(data):
+    message = data["message"]
+    history = data.get("history", [])
+    # Call a model here with pyrite.requests; keep API keys on the server.
+    return {"reply": "You said: " + message}
+
+@app.page("/")
+def home():
+    return Page(Chat(action="/api/reply"))
+```
+
+Visit `/chat` for a working local rule-based chatbot and a live translation form.
+`Chat` sends `{message, history}` and displays `reply` without a page reload.
+History stays in this page's browser memory (last 20 messages), is sent with each
+request, and clears on reload. It is untrusted input; validate it in callbacks.
+This is completed-response chat, not token streaming. The demo uses no AI service.
+
+For other interfaces, use `LiveForm(Input(...), Submit(...), action="/api/action")`
+and return `{"text": "Updated result"}` from the action. All field values arrive
+as strings. Pyrite supplies the JavaScript, pending state, errors, 30-second
+client timeout, and safe text rendering. The callback can use `requests` to reach
+external APIs without exposing credentials to the browser. Aborting a request
+does not cancel Python work already running.
+
+Actions accept JSON objects up to 16 KiB and reject cross-origin browser requests.
+These checks do not authenticate users. Use application validation and authorization
+for sensitive actions. Live components require JavaScript; ordinary pages and GET
+forms continue working without it. Browser playground previews remain isolated and
+cannot call server actions.
+
+## Tests
+
+```sh
+python3 -m unittest discover -s tests -v
+```

pyrite_web-0.1.0/pyproject.toml

@@ -0,0 +1,14 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pyrite-web"
+version = "0.1.0"
+description = "Code websites in Python 3, without writing JavaScript or CSS."
+readme = "README.md"
+requires-python = ">=3.10"
+license = {text = "MIT"}
+
+[tool.setuptools.packages.find]
+include = ["pyrite*"]

pyrite_web-0.1.0/pyrite/__init__.py

@@ -0,0 +1,17 @@
+"""Websites in Python, without handwritten JavaScript or CSS."""
+
+from .core import App, Button, Card, Code, Column, Details, Heading, Link, Nav, Page, Row, Section, Text
+from .core import Form, Input, Select, Slider, Submit, query
+from .styles import Theme
+from .core import Image, Motion
+from . import requests
+from .browser import BrowserPlayground
+from .styles import Gradient
+from .live import Chat, LiveForm
+
+__all__ = ["App", "Button", "Card", "Code", "Column", "Details", "Heading", "Link", "Nav", "Page", "Row", "Section", "Text"]
+__all__ += ["Form", "Input", "Select", "Slider", "Submit", "query"]
+__all__ += ["Theme"]
+__all__ += ["Image", "Motion", "requests"]
+__all__ += ["BrowserPlayground"]
+__all__ += ["Gradient", "Chat", "LiveForm"]

pyrite_web-0.1.0/pyrite/browser.py

@@ -0,0 +1,105 @@
+"""A browser-only Python editor, isolated from the application server."""
+import json
+from html import escape
+from pathlib import Path
+
+from .core import Element
+
+
+STARTER = '''from pyrite import Page, Column, Heading, Text, Card, Theme, Motion
+
+theme = Theme(
+    background="#111820", text="#eef3f8",
+    accent="#baf26b", heading_font="sans",
+)
+
+page = Page(
+    Motion(
+        Heading("I made this in Python."),
+        Card(Text("Change the words. Change the theme. Hit Run.")),
+        effect="rise",
+    ),
+    theme=theme,
+)
+'''
+
+
+class BrowserPlayground(Element):
+    """One editor per page. Pyodide runs user code in a disposable Web Worker."""
+
+    def __init__(self):
+        super().__init__("div", ())
+
+    def render(self):
+        # Ship this exact installed framework, rather than a second implementation.
+        sources = {path.name: path.read_text() for path in Path(__file__).parent.glob("*.py") if path.name != "browser.py"}
+        # The browser doesn't need to import its editor or the server-side HTTP client.
+        sources["__init__.py"] = sources["__init__.py"].replace("from .browser import BrowserPlayground", "")
+        sources["__init__.py"] = sources["__init__.py"].replace('__all__ += ["BrowserPlayground"]', "")
+        payload = json.dumps(sources).replace("<", "\\u003c")
+        return '''<div class="column">
+<label for="pyrite-editor">Python source</label>
+<textarea id="pyrite-editor" spellcheck="false">''' + escape(STARTER) + r'''</textarea>
+<div class="row"><button class="button" id="pyrite-run" type="button">Run Python</button>
+<button class="button" id="pyrite-reset" type="button">Reset example</button></div>
+<p id="pyrite-status" role="status">Ready. First run downloads Python from jsDelivr.</p>
+<iframe class="preview" id="pyrite-preview" title="Your Pyrite website" sandbox=""></iframe>
+<noscript>This editor needs JavaScript to run Python in your browser. All other pages work without it.</noscript>
+</div><script>
+(() => {
+const sources = ''' + payload + r''';
+const editor = document.getElementById('pyrite-editor');
+const initial = editor.value;
+const run = document.getElementById('pyrite-run');
+const status = document.getElementById('pyrite-status');
+const preview = document.getElementById('pyrite-preview');
+let worker, timer;
+const workerSource = `
+importScripts('https://cdn.jsdelivr.net/pyodide/v0.27.7/full/pyodide.js');
+let runtime;
+self.onmessage = async ({data}) => {
+  try {
+    if (!runtime) {
+      runtime = await loadPyodide();
+      runtime.FS.mkdirTree('/home/pyodide/pyrite');
+      for (const [name, source] of Object.entries(data.sources)) {
+        runtime.FS.writeFile('/home/pyodide/pyrite/' + name, source);
+      }
+    }
+    self.postMessage({ready: true});
+    runtime.globals.set('_editor_source', data.code);
+    const html = await runtime.runPythonAsync(\`
+from pyrite import Page
+_editor_scope = {"__name__": "__playground__"}
+exec(compile(_editor_source, "playground.py", "exec"), _editor_scope)
+_editor_page = _editor_scope.get("page")
+if not isinstance(_editor_page, Page):
+    raise TypeError("Create a Page and assign it to a variable named page. Do not call app.run().")
+_editor_page.render()
+\`);
+    self.postMessage({html});
+  } catch (error) { self.postMessage({error: String(error)}); }
+};`;
+function stop() { if (worker) worker.terminate(); clearTimeout(timer); run.disabled = false; }
+run.onclick = () => {
+  stop();
+  const url = URL.createObjectURL(new Blob([workerSource], {type: 'text/javascript'}));
+  worker = new Worker(url); URL.revokeObjectURL(url);
+  run.disabled = true; status.textContent = 'Loading Python…';
+  timer = setTimeout(() => { stop(); status.textContent = 'Python download timed out. Check your connection and try again.'; }, 120000);
+  worker.onmessage = ({data}) => {
+    if (data.ready) {
+      clearTimeout(timer); status.textContent = 'Running Python…';
+      timer = setTimeout(() => { stop(); status.textContent = 'Stopped: execution exceeded 10 seconds.'; }, 10000);
+      return;
+    }
+    if (data.html) { preview.srcdoc = data.html; status.textContent = 'Rendered. Edit and run again.'; }
+    else status.textContent = data.error;
+    stop();
+  };
+  worker.onerror = (event) => { status.textContent = event.message || 'Unable to load Python. Check your connection.'; stop(); };
+  worker.postMessage({sources, code: editor.value});
+};
+document.getElementById('pyrite-reset').onclick = () => { stop(); editor.value = initial; preview.srcdoc = ''; status.textContent = 'Example reset.'; };
+})();
+</script>'''