tina4-python 3.13.59__tar.gz → 3.13.61__tar.gz

{tina4_python-3.13.59 → tina4_python-3.13.61}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tina4-python
-Version: 3.13.59
+Version: 3.13.61
 Summary: Tina4 Python v3 — Zero-dependency, lightweight web framework
 Author-email: Andre van Zuydam <andrevanzuydam@gmail.com>
 License: MIT
@@ -259,7 +259,7 @@ from tina4_python.core.router import get, post, noauth
 @get("/api/users")
 async def list_users(request, response):
     from src.orm.User import User
-    return response(User().select(limit=100).to_array())
+    return response(User.select(limit=100))
 
 @get("/api/users/{id:int}")
 async def get_user(id, request, response):
@@ -320,7 +320,7 @@ Render it from a route:
 @get("/")
 async def home(request, response):
     from src.orm.User import User
-    users = User().select(limit=20).to_array()
+    users = [u.to_dict() for u in User.select(limit=20)]
     return response.render("pages/home.twig", {"title": "Users", "users": users})
 ```
 
@@ -499,7 +499,7 @@ Auto-generated at `/swagger`:
 @tags(["users"])
 @get("/api/users")
 async def users(request, response):
-    return response(User().select().to_array())
+    return response(User.select())
 ```
 
 ### Event System
@@ -661,7 +661,7 @@ profile = user.has_one("Profile", "user_id")
 customer = order.belongs_to("Customer", "customer_id")
 
 # Eager loading with include=
-users = User().select(include=["orders", "profile"])
+users = User.select(include=["orders", "profile"])
 ```
 
 ### DB Query Caching

{tina4_python-3.13.59 → tina4_python-3.13.61}/README.md

@@ -227,7 +227,7 @@ from tina4_python.core.router import get, post, noauth
 @get("/api/users")
 async def list_users(request, response):
     from src.orm.User import User
-    return response(User().select(limit=100).to_array())
+    return response(User.select(limit=100))
 
 @get("/api/users/{id:int}")
 async def get_user(id, request, response):
@@ -288,7 +288,7 @@ Render it from a route:
 @get("/")
 async def home(request, response):
     from src.orm.User import User
-    users = User().select(limit=20).to_array()
+    users = [u.to_dict() for u in User.select(limit=20)]
     return response.render("pages/home.twig", {"title": "Users", "users": users})
 ```
 
@@ -467,7 +467,7 @@ Auto-generated at `/swagger`:
 @tags(["users"])
 @get("/api/users")
 async def users(request, response):
-    return response(User().select().to_array())
+    return response(User.select())
 ```
 
 ### Event System
@@ -629,7 +629,7 @@ profile = user.has_one("Profile", "user_id")
 customer = order.belongs_to("Customer", "customer_id")
 
 # Eager loading with include=
-users = User().select(include=["orders", "profile"])
+users = User.select(include=["orders", "profile"])
 ```
 
 ### DB Query Caching

{tina4_python-3.13.59 → tina4_python-3.13.61}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tina4-python"
-version = "3.13.59"
+version = "3.13.61"
 description = "Tina4 Python v3 — Zero-dependency, lightweight web framework"
 authors = [
     {name = "Andre van Zuydam", email = "andrevanzuydam@gmail.com"}

{tina4_python-3.13.59 → tina4_python-3.13.61}/tina4_python/CLAUDE.md

@@ -24,14 +24,14 @@ Every piece of repeated logic must be centralised. If two routes format a date,
 ```python
 @get("/api/orders")
 async def list_orders(request, response):
-    orders = Order().select().to_array()
+    orders = [o.to_dict() for o in Order.select()]
     for o in orders:
         o["total"] = f"${abs(float(o['total'])):,.2f}"  # duplicated
     return response(orders)
 
 @get("/api/invoices")
 async def list_invoices(request, response):
-    invoices = Invoice().select().to_array()
+    invoices = [i.to_dict() for i in Invoice.select()]
     for i in invoices:
         i["amount"] = f"${abs(float(i['amount'])):,.2f}"  # duplicated!
     return response(invoices)
@@ -262,16 +262,16 @@ Queue(topic="tasks").push({"action": "send_email"})
 ### 11. Key tina4_python Gotchas
 
 1. **Database import**: Use `from tina4_python.database import Database` (NOT `from tina4_python import Database`)
-2. **noauth/secured import**: Use `from tina4_python.core.router import noauth, secured` (there is NO `tina4_python.Decorators` module). **Never** import `noauth` from `tina4_python.swagger` — that version only affects documentation, not actual auth.
+2. **noauth/secured import**: Use `from tina4_python.core.router import noauth, secured` (there is NO `tina4_python.Decorators` module). `tina4_python.swagger` does **not** export `noauth` (importing it raises `ImportError`). The real docs-only trap is **`@security()`** (from `tina4_python.swagger`): it sets OpenAPI metadata only and does NOT gate a route — use `@secured()`/`@noauth()` for actual auth.
 2b. **Decorator ordering**: Route decorators (`@get`, `@post`, etc.) must be the **innermost** (closest to the function). Swagger/meta decorators (`@description`, `@tags`, `@noauth`, `@secured`) go above. Correct: `@noauth()` → `@description(...)` → `@post(...)` → `def handler`. Wrong: `@post(...)` → `@description(...)` → `def handler` (will crash).
-3. **Jinja2 template syntax** (common mistakes):
+3. **Frond template syntax** (Frond is Jinja2-*like*, not Jinja2 — note the differences):
     - **Ternary operator supported**: Both `{{ x ? 'a' : 'b' }}` and `{{ 'a' if x else 'b' }}` work
-    - **elif not elseif**: Use `{% elif %}` NOT `{% elseif %}`
+    - **elif or elseif**: Frond accepts **both** `{% elif %}` and `{% elseif %}`
     - **Unescaped output**: Both `{{ var | safe }}` and `{{ var | raw }}` work for unescaped output
     - **format filter**: Use `{{ "%.2f" | format(value) }}` for number formatting
     - **e() filter has NO arguments**: Use `{{ var|e }}` NOT `{{ var|e('js') }}` — Jinja2's `|e` is HTML-only with no mode parameter (that's PHP Twig syntax)
     - **JS string escaping**: Use `{{ var|replace("'", "\\'") }}` to escape single quotes for inline JS onclick handlers
-    - **No `|escape('js')` or `|e('js')`**: These will throw `escape() takes 1 positional argument but 2 were given`
+    - **`|e`/`|escape` are HTML-only**: a mode arg like `|e('js')` is **ignored** by Frond (not an error) — for inline-JS escaping use `{{ var|replace("'", "\\'") }}`
     - **Ternary inline**: Use `{{ 's' if count != 1 else '' }}` NOT `{{ count != 1 ? 's' : '' }}`
     - **Default values**: Use `{{ var|default('fallback') }}` — works on undefined and None
     - **Chaining filters**: `{{ var|default('')|replace("'", "\\'") }}` — left to right
@@ -289,7 +289,7 @@ Queue(topic="tasks").push({"action": "send_email"})
 4. **fetch_one()**: Returns a plain dict (or None), NOT a DatabaseResult
 5. **Dict access**: All query results use dict access `row["column"]` not attribute access `row.column`
 6. **Connection strings**: v3 uses standard URL format: `driver://host:port/database` with separate `username` and `password` parameters. Example: `Database("firebird://localhost:3050//path/to/db", "SYSDBA", "masterkey")`. Environment variable: `TINA4_DATABASE_URL`.
-7. **Running the app**: `uv run python app.py <port> <name>` — port and name are CLI args handled by tina4_python
+7. **Running the app**: use the `tina4` CLI — `tina4 serve`. The framework **refuses to boot via a plain `python app.py`** (it must be launched by the CLI; `TINA4_OVERRIDE_CLIENT=true` only for embedding). Port/name are CLI args.
 8. **SCSS**: Files in `src/scss/` are auto-compiled to `src/public/css/` on startup
 12. **Background tasks**: Use `background(fn, interval)` from `tina4_python.core.server` — never use `threading.Thread` for periodic work. The `background()` function runs tasks cooperatively in the asyncio event loop with proper shutdown handling.
 
@@ -890,8 +890,8 @@ user.save()
 # Delete
 user.delete()
 
-# Query
-result = User().select(sql="name = ?", params=["Alice"], limit=10)
+# Query (WHERE fragment -> use where(); select() takes FULL SQL, not a fragment)
+result = User.where("name = ?", params=["Alice"], limit=10)
 
 # Convert to dict
 user.to_dict()
@@ -1797,7 +1797,7 @@ uv run tina4python migrate
 ```python
 @get("/api/products")
 async def list_products(request, response):
-    return response(Product().select(limit=100).to_array())
+    return response(Product.select(limit=100))
 
 @post("/api/products")
 async def create_product(request, response):

{tina4_python-3.13.59 → tina4_python-3.13.61}/tina4_python/__init__.py

@@ -8,7 +8,7 @@ Tina4 Python v3.0 — Zero-dependency, lightweight web framework.
 
 One import, everything works.
 """
-__version__ = "3.13.59"
+__version__ = "3.13.61"
 
 # ── Route decorators ──
 from tina4_python.core.router import (  # noqa: E402, F401

{tina4_python-3.13.59 → tina4_python-3.13.61}/tina4_python/ai/__init__.py

@@ -36,6 +36,76 @@ AI_TOOLS = [
 ]
 
 
+# ── Skill files (the SKILL.md system) ───────────────────────────────────────
+# `tina4 ai` installs the actual skills — not just a CLAUDE.md pointer to them —
+# into BOTH the project (.claude/skills, so they travel with the repo) and the
+# user's global ~/.claude/skills (so they're available in every project). A
+# Python project needs the python developer skill plus the two shared skills;
+# all three are served from the tina4-python release tag.
+_DEV_SKILL = "tina4-developer-python"
+_SKILL_REPO = "tina4-python"
+_SKILLS = {
+    _DEV_SKILL: ["auth-and-services.md", "data-and-orm.md", "deployment.md",
+                 "routes-and-api.md", "templates-and-frontend.md", "realtime.md"],
+    "tina4-js": ["html-and-components.md", "signals-and-reactivity.md",
+                 "persistence.md", "rtc.md"],
+    "tina4-maintainer": ["cli-and-deployment.md", "frond-and-frontend.md",
+                         "routing-and-orm.md", "subsystems.md"],
+}
+
+
+def _skills_ref() -> str:
+    """Release tag to pull skills from — the installed framework version,
+    overridable with TINA4_SKILLS_REF (e.g. to test a branch)."""
+    ref = os.environ.get("TINA4_SKILLS_REF")
+    if ref:
+        return ref
+    try:
+        from tina4_python import __version__
+        return __version__
+    except Exception:
+        return "main"
+
+
+def _fetch_bytes(url: str) -> "bytes | None":
+    import urllib.error
+    import urllib.request
+    try:
+        with urllib.request.urlopen(url, timeout=15) as resp:
+            return resp.read()
+    except (urllib.error.URLError, OSError):
+        return None
+
+
+def install_skills(root: str = ".", targets: "list[Path] | None" = None) -> list[str]:
+    """Install the Tina4 SKILL.md skills into the project AND global
+    ~/.claude/skills, fetched from the release tag matching this framework
+    version. Returns the skills fully installed. Network-dependent."""
+    ref = _skills_ref()
+    base = f"https://raw.githubusercontent.com/tina4stack/{_SKILL_REPO}/{ref}/.claude/skills"
+    if targets is None:
+        targets = [Path(root).resolve() / ".claude" / "skills",
+                   Path.home() / ".claude" / "skills"]
+    installed = []
+    for skill, refs in _SKILLS.items():
+        skill_ok = True
+        for dest in targets:
+            skill_dir = dest / skill
+            (skill_dir / "references").mkdir(parents=True, exist_ok=True)
+            data = _fetch_bytes(f"{base}/{skill}/SKILL.md")
+            if data is None:
+                skill_ok = False
+                continue
+            (skill_dir / "SKILL.md").write_bytes(data)
+            for r in refs:
+                rd = _fetch_bytes(f"{base}/{skill}/references/{r}")
+                if rd is not None:
+                    (skill_dir / "references" / r).write_bytes(rd)
+        if skill_ok:
+            installed.append(skill)
+    return installed
+
+
 def is_installed(root: str, tool: dict) -> bool:
     """Check if a tool's context file already exists."""
     return (Path(root).resolve() / tool["context_file"]).exists()
@@ -197,7 +267,7 @@ def _skill_block(context_file: str) -> str:
             "## Tina4 Skills\n\n"
             "When working on this Tina4 project, these skills give the "
             "assistant project-aware behaviour:\n\n"
-            "- **tina4-developer** — Read `.claude/skills/tina4-developer/SKILL.md` before building features.\n"
+            f"- **{_DEV_SKILL}** — Read `.claude/skills/{_DEV_SKILL}/SKILL.md` before building features.\n"
             "- **tina4-js** — Read `.claude/skills/tina4-js/SKILL.md` for frontend work.\n"
             "- **tina4-maintainer** — Read `.claude/skills/tina4-maintainer/SKILL.md` for framework-level changes.\n\n"
             "If Tina4 behaves differently from what these skills describe, that is a bug in the skill. "
@@ -208,7 +278,7 @@ def _skill_block(context_file: str) -> str:
     else:
         body = (
             "Tina4 Skills — read these files before working on this project:\n"
-            "  .claude/skills/tina4-developer/SKILL.md   (feature development)\n"
+            f"  .claude/skills/{_DEV_SKILL}/SKILL.md   (feature development)\n"
             "  .claude/skills/tina4-js/SKILL.md          (frontend / tina4-js)\n"
             "  .claude/skills/tina4-maintainer/SKILL.md  (framework-level changes)\n"
             "Found a skill that disagrees with how Tina4 actually behaves? Tell the developer,\n"
@@ -367,21 +437,18 @@ def _install_claude_skills(root: Path) -> list[str]:
                 rel = str(target.relative_to(root))
                 created.append(rel)
 
-    # Copy skill directories from framework .claude/skills/
-    framework_root = pkg_dir.parent
-    framework_skills_dir = framework_root / ".claude" / "skills"
-    if framework_skills_dir.is_dir():
-        target_skills_dir = root / ".claude" / "skills"
-        target_skills_dir.mkdir(parents=True, exist_ok=True)
-        for skill_dir in framework_skills_dir.iterdir():
-            if skill_dir.is_dir():
-                target_dir = target_skills_dir / skill_dir.name
-                if target_dir.exists():
-                    shutil.rmtree(target_dir)
-                shutil.copytree(skill_dir, target_dir)
-                rel = str(target_dir.relative_to(root))
-                created.append(rel)
-                print(f"  \033[32m✓\033[0m Updated {rel}")
+    # Install the SKILL.md skills into the project AND the user's global
+    # ~/.claude/skills, fetched from the release tag matching this framework
+    # version. (The previous code copied from framework_root/.claude/skills,
+    # which exists only in a dev/editable checkout — NOT in an installed pip
+    # package, where .claude/skills sits outside the tina4_python package and
+    # is never shipped. So installed users got no skills at all.)
+    for skill in install_skills(str(root)):
+        created.append(f".claude/skills/{skill}/")
+        try:
+            print(f"  \033[32m✓\033[0m Installed .claude/skills/{skill}  (project + global)")
+        except UnicodeEncodeError:
+            print(f"  [OK] Installed .claude/skills/{skill} (project + global)")
 
     return created
 

{tina4_python-3.13.59 → tina4_python-3.13.61}/tina4_python/orm/model.py

@@ -437,7 +437,35 @@ class ORM(metaclass=ORMMeta):
             # which db.execute()/insert()/update() populate, falling back to
             # the exception text) on self.last_error so it survives, and log
             # it with model/table context. ──
-            self.last_error = db.get_error() or str(e)
+            cause = db.get_error() or str(e)
+            # ── DX hint (v3.13.60): turn a bare driver error into an
+            # actionable fix for the two commonest ORM write footguns. Match
+            # the message case-insensitively (SQLite says "no such table" /
+            # "no such column: is_deleted" / "has no column named is_deleted";
+            # Postgres/MySQL say "does not exist" / "doesn't exist"). Any
+            # OTHER error keeps its raw cause untouched so we never mask an
+            # unrelated failure (e.g. a NOT NULL / duplicate-PK violation). ──
+            low = cause.lower()
+            if self.soft_delete and "is_deleted" in low and (
+                "no such column" in low or "has no column" in low
+                or "does not exist" in low or "doesn't exist" in low
+                or "unknown column" in low
+            ):
+                cause += (
+                    " — soft_delete=True requires an is_deleted column; declare "
+                    "it (is_deleted = IntegerField(default=0)) or add a migration"
+                )
+            elif "no such table" in low or (
+                ("does not exist" in low or "doesn't exist" in low)
+                # exclude a column-not-found (e.g. Postgres 'column "x" does not exist')
+                # so a genuine missing-column error never gets a spurious table hint
+                and "column" not in low
+            ):
+                cause += (
+                    f" — table '{table}' does not exist; call "
+                    f"{type(self).__name__}.create_table() or run a migration"
+                )
+            self.last_error = cause
             Log.error(
                 f"{type(self).__name__}.save() failed for table "
                 f"'{table}': {self.last_error}"