pyronites 0.1.0__tar.gz

pyronites-0.1.0/.gitignore

@@ -0,0 +1,7 @@
+.venv/
+.pytest_cache/
+__pycache__/
+.vscode/
+# Local secrets / runtime env (keep .env.example tracked)
+.env
+.env.*.local

pyronites-0.1.0/CHANGELOG.md

@@ -0,0 +1,33 @@
+# Changelog
+
+All notable changes to the **pyronites** client package are documented here.
+
+Format based on [Keep a Changelog](https://keepachangelog.com/). Versioning follows [SemVer](https://semver.org/).
+
+## [0.1.0] — 2026-07-25
+
+### Added
+
+#### Phase P1 — Core client
+- `create_client()` with `PYRONITES_URL` / `PYRONITES_KEY` config
+- HTTP transport (`httpx`) with Bearer auth and typed errors
+- Auth: `sign_up`, `sign_in`, `sign_out`, `user`
+- Tables: `select`, `insert`, `update().eq("id", ...)`, `delete().eq("id", ...)`, `get`, `sql`
+- Errors: `ApiError`, `AuthError`, `NotFoundError`
+
+#### Phase P2 — Storage
+- `client.storage.upload` / `list` / `get` / `download` / `remove`
+
+#### Phase P3 — Local vs remote policy
+- `local_tables`, `cache_tables`, `remote_tables`, `local_db_path`
+- SQLite local store
+- `pull` / `push` / `sync` (v1 conflict policy: remote wins)
+
+#### Phase P4 — Polish
+- Changelog, expanded README, example script
+- PyPI-ready `pyproject.toml` metadata
+
+### Notes
+- Default table policy is **remote**
+- Minimum Python: 3.10
+- Runtime dependency: `httpx>=0.27.0`

pyronites-0.1.0/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: pyronites
+Version: 0.1.0
+Summary: Official Python client for the Pyronites (PyroCore) backend
+Project-URL: Homepage, https://github.com/Ashutosh3021/Pyronites
+Project-URL: Repository, https://github.com/Ashutosh3021/Pyronites
+Project-URL: Documentation, https://github.com/Ashutosh3021/Pyronites/tree/main/pyronites/docs
+Author: Ashutosh
+License: MIT
+Keywords: backend,client,pyrocore,pyronites,sqlite,supabase
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27.0
+Provides-Extra: dev
+Requires-Dist: build>=1.0; extra == 'dev'
+Requires-Dist: pytest-httpx>=0.30; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: twine>=5.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# pyronites
+
+Official Python client for the [Pyronites](https://github.com/Ashutosh3021/Pyronites) backend.
+
+Supabase-style API, zero mandatory paid services — point it at your own backend URL + API key.
+
+## Install
+
+```bash
+# Development (from this repo)
+pip install -e ./pyronites
+
+# From PyPI (after publish)
+pip install pyronites
+```
+
+Requires **Python 3.10+**.
+
+## 5-minute setup
+
+```bash
+export PYRONITES_URL="https://your-backend.example.com"
+export PYRONITES_KEY="pyro_live_..."
+```
+
+```python
+from pyronites import create_client
+
+client = create_client()
+
+# Auth (optional)
+client.auth.sign_in("user@example.com", "password")
+print(client.auth.user())
+
+# Tables
+note = client.table("notes").insert({"title": "Hello", "body": "World"})
+for row in client.table("notes").select().limit(10):
+    print(row)
+client.table("notes").update({"title": "Updated"}).eq("id", note["id"])
+client.table("notes").delete().eq("id", note["id"])
+
+# Storage
+meta = client.storage.upload("photo.jpg")
+data = client.storage.download(meta["id"])
+client.storage.remove(meta["id"])
+
+# Local-only / cache tables (optional)
+client = create_client(
+    local_tables=["settings"],
+    cache_tables=["catalog"],
+    local_db_path="./.pyronites_local.db",
+)
+client.table("settings").insert({"theme": "dark"})
+client.pull("catalog")
+```
+
+## Config
+
+| Source | Variables / args |
+|--------|------------------|
+| Env | `PYRONITES_URL`, `PYRONITES_KEY`, optional `PYRONITES_LOCAL_DB` |
+| Constructor | `create_client(url=..., key=..., timeout=30, local_tables=..., cache_tables=..., remote_tables=..., local_db_path=...)` |
+
+Args override env. Missing URL raises a clear error at create time.
+
+**Security:** never put a powerful service key in a public frontend.
+
+## Public API
+
+See [`docs/syntax.md`](docs/syntax.md).
+
+## Development
+
+```bash
+cd pyronites
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+MIT

pyronites-0.1.0/README.md

@@ -0,0 +1,82 @@
+# pyronites
+
+Official Python client for the [Pyronites](https://github.com/Ashutosh3021/Pyronites) backend.
+
+Supabase-style API, zero mandatory paid services — point it at your own backend URL + API key.
+
+## Install
+
+```bash
+# Development (from this repo)
+pip install -e ./pyronites
+
+# From PyPI (after publish)
+pip install pyronites
+```
+
+Requires **Python 3.10+**.
+
+## 5-minute setup
+
+```bash
+export PYRONITES_URL="https://your-backend.example.com"
+export PYRONITES_KEY="pyro_live_..."
+```
+
+```python
+from pyronites import create_client
+
+client = create_client()
+
+# Auth (optional)
+client.auth.sign_in("user@example.com", "password")
+print(client.auth.user())
+
+# Tables
+note = client.table("notes").insert({"title": "Hello", "body": "World"})
+for row in client.table("notes").select().limit(10):
+    print(row)
+client.table("notes").update({"title": "Updated"}).eq("id", note["id"])
+client.table("notes").delete().eq("id", note["id"])
+
+# Storage
+meta = client.storage.upload("photo.jpg")
+data = client.storage.download(meta["id"])
+client.storage.remove(meta["id"])
+
+# Local-only / cache tables (optional)
+client = create_client(
+    local_tables=["settings"],
+    cache_tables=["catalog"],
+    local_db_path="./.pyronites_local.db",
+)
+client.table("settings").insert({"theme": "dark"})
+client.pull("catalog")
+```
+
+## Config
+
+| Source | Variables / args |
+|--------|------------------|
+| Env | `PYRONITES_URL`, `PYRONITES_KEY`, optional `PYRONITES_LOCAL_DB` |
+| Constructor | `create_client(url=..., key=..., timeout=30, local_tables=..., cache_tables=..., remote_tables=..., local_db_path=...)` |
+
+Args override env. Missing URL raises a clear error at create time.
+
+**Security:** never put a powerful service key in a public frontend.
+
+## Public API
+
+See [`docs/syntax.md`](docs/syntax.md).
+
+## Development
+
+```bash
+cd pyronites
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+MIT

pyronites-0.1.0/docs/PUBLISH.md

@@ -0,0 +1,39 @@
+# Publishing pyronites to PyPI
+
+## Preconditions
+
+- [x] P1–P3 feature-complete
+- [x] Unit tests passing
+- [x] `CHANGELOG.md` updated
+- [x] Version in `pyproject.toml` and `pyronites/__init__.py` match
+- [ ] PyPI account + API token
+- [ ] Package name `pyronites` available (or use a scoped name if taken)
+
+## Steps
+
+```bash
+cd pyronites
+pip install build twine
+
+python -m build
+twine check dist/*
+
+# TestPyPI first (recommended)
+twine upload --repository testpypi dist/*
+# then
+twine upload dist/*
+```
+
+## After publish
+
+```bash
+pip install pyronites
+python -c "from pyronites import create_client, __version__; print(__version__)"
+```
+
+## Version bumps
+
+1. Update `__version__` in `pyronites/__init__.py`
+2. Update `version` in `pyproject.toml`
+3. Add a section to `CHANGELOG.md`
+4. Tag: `git tag v0.1.0 && git push --tags`

pyronites-0.1.0/docs/STRUCTURE.md

@@ -0,0 +1,25 @@
+# Package layout (canonical)
+
+```
+pyronites/                 # installable root → pip install -e ./pyronites
+├── docs/
+│   ├── architect.md
+│   ├── features.md
+│   ├── plan.md
+│   └── syntax.md
+├── pyproject.toml
+├── README.md
+├── pyronites/             # importable Python package
+│   ├── __init__.py
+│   ├── client.py
+│   ├── config.py
+│   ├── http.py
+│   ├── errors.py
+│   ├── auth.py
+│   ├── table.py
+│   └── …                  # storage.py (P2), local.py (P3)
+└── tests/
+```
+
+Install: `pip install -e ./pyronites`  
+Import: `from pyronites import create_client`

pyronites-0.1.0/docs/architect.md

@@ -0,0 +1,55 @@
+# pyronites — Client Package Architecture
+
+> See also `docs/syntax.md` (public API) and `docs/features.md` (checklist).
+
+Install: `pip install -e ./pyronites`
+
+## Module layout
+
+```text
+pyronites/                 # installable root
+  docs/                    # plan, features, architect, syntax
+  pyproject.toml
+  README.md
+  pyronites/               # importable package
+    __init__.py            # create_client, errors, __version__
+    client.py              # PyronitesClient façade
+    config.py
+    http.py
+    auth.py
+    table.py
+    storage.py             # P2
+    local.py               # P3
+    errors.py
+  tests/
+```
+
+Apps only need:
+
+```python
+from pyronites import create_client
+client = create_client()
+```
+
+## Design principles
+
+1. Thin over clever
+2. Backend is source of truth
+3. Env-first secrets (`PYRONITES_URL` / `PYRONITES_KEY`)
+4. Remote by default
+5. Zero cost (httpx only)
+6. Match existing backend API
+
+## Backend route mapping
+
+| Client | Backend |
+|--------|---------|
+| `auth.sign_up` | `POST /auth/signup` |
+| `auth.sign_in` | `POST /auth/login` |
+| `auth.sign_out` | `POST /auth/logout` |
+| `auth.user` | `GET /auth/me` |
+| `table(t).select` | `GET /tables/{t}` |
+| `table(t).insert` | `POST /tables/{t}` |
+| `table(t).update...` | `PATCH /tables/{t}/{id}` |
+| `table(t).delete...` | `DELETE /tables/{t}/{id}` |
+| `storage.*` | `/storage/*` (P2) |

pyronites-0.1.0/docs/features.md

@@ -0,0 +1,30 @@
+# pyronites — Client Package Features
+
+> Status: `[ ]` not started · `[~]` partial · `[x]` done
+
+Install: `pip install -e ./pyronites`
+
+---
+
+## F0 — Packaging
+
+- [x] Package name, installable layout, `pyproject.toml`, public import, version, changelog, PyPI metadata
+- [ ] Published on PyPI — needs maintainer token
+
+## F1–F4 — Core (P1)
+
+- [x] Config, HTTP, Auth, Tables, SQL escape hatch
+
+## F5 — Storage (P2)
+
+- [x] upload / list / get / download / remove
+
+## F6 — Local vs remote (P3)
+
+- [x] local / cache / remote policy, SQLite store, pull / push / sync
+
+## F7–F8 — DX & quality (P4)
+
+- [x] README, example script, 44 unit tests, PUBLISH.md
+- [ ] Live integration against Render (manual)
+- [ ] fluffy-spork migration

pyronites-0.1.0/docs/plan.md

@@ -0,0 +1,29 @@
+# pyronites — Client Package Plan
+
+> Reference & checklist for building the official Python client that talks to a self-hosted PyroCore / Pyronites backend.
+>
+> Goal: make using Pyronites feel as simple as `supabase-py`, with **zero cost** and clear control over what stays local vs remote.
+
+---
+
+## Document map
+
+| File | Use |
+|------|-----|
+| `docs/plan.md` | This file — phases, success criteria, non-goals |
+| `docs/features.md` | Feature-level checklist |
+| `docs/architect.md` | Architecture, modules, data flow, security |
+| `docs/syntax.md` | Public API contract & usage examples |
+
+Install: `pip install -e ./pyronites`
+
+---
+
+## Phases (summary)
+
+- **P1** Core client (config, http, auth, table) — done
+- **P2** Storage + ergonomics
+- **P3** Local vs remote policy
+- **P4** Polish & publish
+
+See the full plan history in git; this file is the living checklist. Update when phase decisions change.

pyronites-0.1.0/docs/syntax.md

@@ -0,0 +1,74 @@
+# pyronites — Syntax & Usage Guide
+
+> **Public contract.** Apps write against this surface.
+
+## Install & import
+
+```bash
+pip install -e ./pyronites
+# later: pip install pyronites
+```
+
+```python
+from pyronites import create_client, ApiError, AuthError, NotFoundError
+
+client = create_client()  # reads PYRONITES_URL + PYRONITES_KEY
+# or
+client = create_client(url="https://...", key="pyro_live_...")
+```
+
+## Config
+
+| Variable | Meaning |
+|----------|---------|
+| `PYRONITES_URL` | Backend base URL |
+| `PYRONITES_KEY` | API key (Bearer) |
+
+Args override env. Missing URL → clear error at create time.
+
+## Auth (P1)
+
+```python
+client.auth.sign_up(email, password) -> dict
+client.auth.sign_in(email, password) -> dict
+client.auth.sign_out() -> None
+client.auth.user() -> dict | None
+```
+
+## Tables (P1)
+
+```python
+client.table("notes").select()
+client.table("notes").select().eq("status", "open").limit(20)
+client.table("notes").insert({"title": "Hello"})
+client.table("notes").update({"title": "X"}).eq("id", "...")
+client.table("notes").delete().eq("id", "...")
+client.table("notes").get("id")
+client.sql("SELECT count(*) FROM notes")  # admin key
+```
+
+## Storage (P2)
+
+```python
+client.storage.upload(...)
+client.storage.list()
+client.storage.download(id)
+client.storage.remove(id)
+```
+
+## Errors
+
+```python
+ApiError
+├─ AuthError       # 401/403
+└─ NotFoundError   # 404
+```
+
+## Document map
+
+| File | Role |
+|------|------|
+| `docs/plan.md` | Phases |
+| `docs/features.md` | Checklist |
+| `docs/architect.md` | Internals |
+| `docs/syntax.md` | This file |

pyronites-0.1.0/examples/basic_usage.py

@@ -0,0 +1,44 @@
+#!/usr/bin/env python3
+"""Minimal example against a live or local Pyronites backend.
+
+Usage:
+  export PYRONITES_URL=https://pyrocore-backend.onrender.com
+  export PYRONITES_KEY=pyro_live_...
+  python examples/basic_usage.py
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+
+from pyronites import ApiError, create_client
+
+
+def main() -> int:
+    if not os.environ.get("PYRONITES_URL"):
+        print("Set PYRONITES_URL (and usually PYRONITES_KEY) first.", file=sys.stderr)
+        return 1
+
+    client = create_client()
+    try:
+        print("Inserting demo row into 'notes' (table must exist on backend)...")
+        try:
+            row = client.table("notes").insert(
+                {"title": "pyronites demo", "body": "hello from examples/basic_usage.py"}
+            )
+            print("Inserted:", row)
+            rid = row.get("id")
+            if rid:
+                client.table("notes").delete().eq("id", rid)
+                print("Deleted:", rid)
+        except ApiError as e:
+            print(f"Table operation failed ({e}). Create a 'notes' table in the dashboard first.")
+            return 1
+    finally:
+        client.close()
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

pyronites-0.1.0/pyproject.toml

@@ -0,0 +1,57 @@
+[project]
+name = "pyronites"
+version = "0.1.0"
+description = "Official Python client for the Pyronites (PyroCore) backend"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "Ashutosh" }]
+keywords = ["pyronites", "pyrocore", "sqlite", "backend", "client", "supabase"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Typing :: Typed",
+]
+dependencies = [
+    "httpx>=0.27.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/Ashutosh3021/Pyronites"
+Repository = "https://github.com/Ashutosh3021/Pyronites"
+Documentation = "https://github.com/Ashutosh3021/Pyronites/tree/main/pyronites/docs"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-httpx>=0.30",
+    "build>=1.0",
+    "twine>=5.0",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["pyronites"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "pyronites/",
+    "tests/",
+    "examples/",
+    "docs/",
+    "README.md",
+    "CHANGELOG.md",
+    "pyproject.toml",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["."]

pyronites-0.1.0/pyronites/__init__.py

@@ -0,0 +1,14 @@
+"""pyronites — official Python client for the Pyronites backend."""
+
+from pyronites.client import create_client
+from pyronites.errors import ApiError, AuthError, NotFoundError
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "create_client",
+    "ApiError",
+    "AuthError",
+    "NotFoundError",
+    "__version__",
+]

pyronites-0.1.0/pyronites/auth.py

@@ -0,0 +1,45 @@
+"""Auth methods for the pyronites client."""
+
+from __future__ import annotations
+
+from typing import Any, Dict, Optional
+
+from pyronites.errors import AuthError
+from pyronites.http import HttpTransport
+
+
+class AuthClient:
+    def __init__(self, transport: HttpTransport) -> None:
+        self._http = transport
+        self._user: Optional[Dict[str, Any]] = None
+
+    def sign_up(self, email: str, password: str) -> Dict[str, Any]:
+        data = self._http.request(
+            "POST", "/auth/signup",
+            json={"email": email, "password": password},
+        )
+        self._user = data
+        return data  # type: ignore[return-value]
+
+    def sign_in(self, email: str, password: str) -> Dict[str, Any]:
+        data = self._http.request(
+            "POST", "/auth/login",
+            json={"email": email, "password": password},
+        )
+        self._user = data
+        return data  # type: ignore[return-value]
+
+    def sign_out(self) -> None:
+        try:
+            self._http.request("POST", "/auth/logout")
+        finally:
+            self._user = None
+
+    def user(self) -> Optional[Dict[str, Any]]:
+        try:
+            data = self._http.request("GET", "/auth/me")
+            self._user = data
+            return data  # type: ignore[return-value]
+        except AuthError:
+            self._user = None
+            return None