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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tina4-python
-Version: 3.13.60
+Version: 3.13.61
 Summary: Tina4 Python v3 — Zero-dependency, lightweight web framework
 Author-email: Andre van Zuydam <andrevanzuydam@gmail.com>
 License: MIT

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

@@ -1,6 +1,6 @@
 [project]
 name = "tina4-python"
-version = "3.13.60"
+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.60 → tina4_python-3.13.61}/tina4_python/CLAUDE.md

@@ -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.
 

{tina4_python-3.13.60 → 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.60"
+__version__ = "3.13.61"
 
 # ── Route decorators ──
 from tina4_python.core.router import (  # noqa: E402, F401

{tina4_python-3.13.60 → 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}"