tina4-python 3.13.14__tar.gz → 3.13.16__tar.gz

{tina4_python-3.13.14 → tina4_python-3.13.16}/PKG-INFO

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

{tina4_python-3.13.14 → tina4_python-3.13.16}/pyproject.toml

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

{tina4_python-3.13.14 → tina4_python-3.13.16}/tina4_python/CLAUDE.md

@@ -282,8 +282,9 @@ Queue(topic="tasks").push({"action": "send_email"})
     - **Macro imports**: `{% from "macros/forms.twig" import field_group %}` — macros do NOT inherit parent context, pass variables explicitly
 4. **DatabaseResult**: `dba.fetch()` returns a `DatabaseResult` object, NOT a plain list
     - Use `.records` to get list of dicts: `result.records`
-    - Use `.count` for row count (no `len()` support)
+    - Use `.count` for total row count; `len(result)` also works
     - Iteration works: `for row in result` or `list(result)`
+    - Index/slice access works: `result[0]`, `result[1:3]`
     - Other methods: `.to_json()`, `.to_array()`, `.to_csv()`, `.to_paginate()`
 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`
@@ -356,7 +357,7 @@ tina4_python/               # Core framework package (v3.0.0)
 ├── dotenv/                 # .env file loader
 ├── cli/                    # CLI commands
 ├── HtmlElement.py          # Programmatic HTML builder (HTMLElement, add_html_helpers)
-├── Testing.py              # Inline testing framework (tests, assert_equal, run_all_tests)
+├── Testing.py              # Inline testing framework (tests, assert_equal, run_all)
 ├── templates/              # Built-in framework templates (Twig)
 ├── public/                 # Built-in static assets
 └── scss/                   # Built-in SCSS
@@ -853,17 +854,17 @@ user.save()
 user.delete()
 
 # Query
-result = User().select(filter="name = ?", params=["Alice"], limit=10)
+result = User().select(sql="name = ?", params=["Alice"], limit=10)
 
 # Convert to dict
 user.to_dict()
 
-# NoSQL support: to_mongo() generates MongoDB query documents from the same fluent API
-result.to_mongo()
+# NoSQL support: to_mongo() lives on QueryBuilder and generates MongoDB query documents from the same fluent API
+User.query().where("name = ?", ["Alice"]).to_mongo()
 ```
 
 ### Available field types
-`IntegerField`, `StringField`, `TextField`, `DateTimeField`, `NumericField`, `BlobField`, `JSONBField`, `ForeignKeyField`
+`IntegerField`, `StringField`, `TextField`, `DateTimeField`, `NumericField`, `BlobField`, `BooleanField`, `FloatField`, `ForeignKeyField`
 
 Import from `tina4_python` or `tina4_python.orm.fields`.
 
@@ -1187,7 +1188,8 @@ from tina4_python.graphql import GraphQL
 gql = GraphQL()
 gql.schema.from_orm(User)
 gql.schema.from_orm(Product)
-gql.register_route("/graphql")  # POST = queries, GET = GraphiQL IDE
+# The engine serves HTTP at gql.endpoint (default "/graphql", set via TINA4_GRAPHQL_ENDPOINT).
+# To wire it manually, call gql.execute_json(...) from a @post route.
 ```
 
 `from_orm()` creates: type, single query (`user(id: ID)`), list query (`users(limit, offset)`), create/update/delete mutations.
@@ -1196,16 +1198,18 @@ gql.register_route("/graphql")  # POST = queries, GET = GraphiQL IDE
 
 ```python
 gql.schema.add_type("Widget", {"id": "ID", "name": "String", "price": "Float"})
-gql.schema.add_query("widget", {
-    "type": "Widget",
-    "args": {"id": "ID"},
-    "resolve": lambda root, args, ctx: {"id": args["id"], "name": "Cog", "price": 5.0},
-})
-gql.schema.add_mutation("deleteWidget", {
-    "type": "Boolean",
-    "args": {"id": "ID!"},
-    "resolve": lambda root, args, ctx: True,
-})
+gql.schema.add_query(
+    "widget",
+    args={"id": "ID"},
+    return_type="Widget",
+    resolver=lambda root, args, ctx: {"id": args["id"], "name": "Cog", "price": 5.0},
+)
+gql.schema.add_mutation(
+    "deleteWidget",
+    args={"id": "ID!"},
+    return_type="Boolean",
+    resolver=lambda root, args, ctx: True,
+)
 ```
 
 ### Programmatic usage (no HTTP)
@@ -1322,8 +1326,8 @@ uv run tina4python test                     # Discovers @tests in src/**/*.py
 
 Or programmatically:
 ```python
-from tina4_python.Testing import run_all_tests
-run_all_tests(quiet=False, failfast=False)
+from tina4_python.Testing import run_all
+run_all(quiet=False, failfast=False)
 ```
 
 ## Events — Decoupled Communication
@@ -1374,7 +1378,7 @@ clear()                      # remove all listeners for all events
 Detect AI coding tools in a project and install Tina4-aware context files so any assistant understands the framework.
 
 ```python
-from tina4_python.ai import detect_ai, detect_ai_names, install_context, install_all, status_report
+from tina4_python.ai import detect_ai, detect_ai_names, install_context, install_selected, status_report
 
 # Detect which AI tools are present
 tools = detect_ai(".")
@@ -1383,12 +1387,15 @@ tools = detect_ai(".")
 # Just the names of detected tools
 names = detect_ai_names(".")   # ["claude-code", "cursor"]
 
-# Install context files for detected tools
-created = install_context(".", tools=None, force=False)
+# Install context for ALL known AI tools (tools=None default)
+created = install_context(".")
 # ["CLAUDE.md", ".cursorules"]
 
-# Install context for ALL known AI tools (not just detected)
-created = install_all(".", force=False)
+# Install context for specific tools only
+created = install_context(".", tools=["claude-code", "cursor"])
+
+# Or select by CSV/"all" string
+created = install_selected(".", "all")
 
 # Human-readable status report
 print(status_report("."))
@@ -1511,7 +1518,7 @@ HTMLElement("img", {"src": "/logo.png"})  # <img src="/logo.png">
 Attach test assertions directly to functions with the `@tests` decorator. Tests are registered globally and run via CLI or programmatically.
 
 ```python
-from tina4_python.Testing import tests, assert_equal, assert_raises, assert_true, assert_false, run_all_tests
+from tina4_python.Testing import tests, assert_equal, assert_raises, assert_true, assert_false, run_all
 
 @tests(
     assert_equal((5, 3), 8),           # add(5, 3) == 8
@@ -1534,7 +1541,7 @@ uv run tina4python test                  # Discovers @tests in src/**/*.py
 
 ```python
 # Programmatic execution
-results = run_all_tests(quiet=False, failfast=False)
+results = run_all(quiet=False, failfast=False)
 # {"passed": 5, "failed": 0, "errors": 0, "details": [...]}
 ```
 
@@ -1769,7 +1776,7 @@ async def invite(request, response):
 queue = Queue(topic="emails")
 for job in queue.consume("emails"):
     email = job.data
-    html = Template.render(f"emails/{email['template']}.twig", email["data"])
+    html = Frond().render(f"emails/{email['template']}.twig", email["data"])
     # ... send via SMTP
     job.complete()
 ```

{tina4_python-3.13.14 → tina4_python-3.13.16}/tina4_python/__init__.py

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

{tina4_python-3.13.14 → tina4_python-3.13.16}/tina4_python/database/adapter.py

@@ -27,6 +27,16 @@ class DatabaseResult:
     def __len__(self):
         return self.count
 
+    def __getitem__(self, index):
+        """Index / slice access into the result rows.
+
+        v3.13.16: ``result[0]`` (and slicing) are documented (book ch5 §4
+        "Index Access") but used to raise ``TypeError: 'DatabaseResult'
+        object is not subscriptable``. Delegate to the materialised rows so
+        index and slice access behave like a list.
+        """
+        return self.records[index]
+
     def __bool__(self):
         return self.error is None
 

{tina4_python-3.13.14 → tina4_python-3.13.16}/tina4_python/database/postgres.py

@@ -207,6 +207,35 @@ class PostgreSQLAdapter(DatabaseAdapter):
         except Exception:
             pass
 
+    def _end_read_txn(self):
+        """v3.13.15 (issue #51): close the implicit transaction a read
+        opens, so the connection doesn't leak as ``idle in transaction``.
+
+        psycopg2 runs with ``autocommit = False`` (the framework's safe
+        default — writes must be committed explicitly). A bare ``SELECT``
+        therefore opens a transaction too, and with nothing to commit it
+        sits ``idle in transaction`` for the life of the connection,
+        holding a pool slot and any locks it touched. Short-lived boot
+        connections (the migration runner's ``MAX(batch)`` lookup) leak
+        one each, eventually exhausting ``max_connections`` — at which
+        point module autodiscovery fails mid-boot and every route 404s
+        while ``/health-check`` still passes ("ready but broken").
+
+        A read has nothing to persist, so a ROLLBACK is the safe close.
+        Inside an explicit ``start_transaction()`` the caller owns the
+        transaction, so we defer (mirrors the heal / error-path guards).
+        Writes go through :meth:`execute`, which is deliberately left
+        untouched — with autocommit off they must be committed explicitly,
+        so auto-closing them here would silently drop data.
+        """
+        if self._in_transaction or self._conn is None:
+            return
+        try:
+            self._conn.rollback()
+        except Exception:
+            # Never let bookkeeping mask the rows we already fetched.
+            pass
+
     def connect(self, connection_string: str, username: str = "", password: str = "", **kwargs):
         """Connect to PostgreSQL.
 
@@ -357,6 +386,10 @@ class PostgreSQLAdapter(DatabaseAdapter):
         self._exec_with_handling(cursor, paginated_sql, paginated_params)
         rows = [self._decode_blobs(dict(row)) for row in cursor.fetchall()]
 
+        # v3.13.15 (#51): rows are materialised above — close the implicit
+        # read transaction so the connection doesn't sit idle-in-transaction.
+        self._end_read_txn()
+
         return DatabaseResult(records=rows, count=total, limit=limit, offset=offset, sql=sql, adapter=self)
 
     def fetch_one(self, sql: str, params: list = None) -> dict | None:
@@ -368,7 +401,13 @@ class PostgreSQLAdapter(DatabaseAdapter):
         cursor = self._conn.cursor(cursor_factory=psycopg2.extras.RealDictCursor)
         self._exec_with_handling(cursor, sql, params)
         row = cursor.fetchone()
-        return self._decode_blobs(dict(row)) if row else None
+        result = self._decode_blobs(dict(row)) if row else None
+        # v3.13.15 (#51): close the implicit read transaction so the
+        # connection doesn't sit 'idle in transaction' (psycopg2 autocommit
+        # is off). This is the path the migration runner's MAX(batch)
+        # lookup leaked through.
+        self._end_read_txn()
+        return result
 
     @staticmethod
     def _decode_blobs(row: dict) -> dict:
@@ -496,7 +535,12 @@ class PostgreSQLAdapter(DatabaseAdapter):
         """
         sql = SQLTranslator.placeholder_style(sql, "%s")
         sql = SQLTranslator.auto_increment_syntax(sql, "postgresql")
-        sql = SQLTranslator.boolean_to_int(sql)
+        # v3.13.16: do NOT run boolean_to_int on PostgreSQL — PG has a native
+        # BOOLEAN type, so TRUE/FALSE are valid literals and 1/0 are NOT
+        # interchangeable with them. Converting (e.g. `DEFAULT FALSE` -> `DEFAULT 0`,
+        # or `WHERE active = TRUE` -> `= 1`) raises "column is of type boolean but
+        # expression is of type integer" / "operator does not exist: boolean = integer".
+        # boolean_to_int stays for INTEGER/BIT-backed engines (SQLite, Firebird, MSSQL).
         return sql
 
     def _supports_returning(self) -> bool:

{tina4_python-3.13.14 → tina4_python-3.13.16}/tina4_python/orm/model.py

@@ -748,7 +748,10 @@ class ORM(metaclass=ORMMeta):
         # where it's reliable. SQLite and Firebird stay on INTEGER —
         # SQLite has no native bool, and Firebird's driver round-trip
         # for native BOOLEAN is uneven across versions.
-        if engine == "postgres":
+        # v3.13.16: db.get_database_type() returns "postgresql" (with the -ql),
+        # so the old `== "postgres"` check never matched and BooleanField got
+        # INTEGER on PG — which then can't accept a Python bool on insert.
+        if engine in ("postgres", "postgresql"):
             bool_sql = "BOOLEAN"
         elif engine == "mysql":
             bool_sql = "BOOLEAN"  # MySQL alias for TINYINT(1)
@@ -758,6 +761,16 @@ class ORM(metaclass=ORMMeta):
             # sqlite, firebird, odbc, anything else
             bool_sql = "INTEGER"
 
+        # v3.13.16: DateTimeField was emitted as "DATETIME" unconditionally,
+        # but PostgreSQL and Firebird have no DATETIME type — CREATE TABLE blew
+        # up with `type "datetime" does not exist`. Emit each engine's real
+        # timestamp type. (MySQL/MSSQL/SQLite keep DATETIME: it's valid there,
+        # and on MySQL it avoids TIMESTAMP's auto-update + 2038 surprises.)
+        if engine in ("postgres", "postgresql", "firebird"):
+            datetime_sql = "TIMESTAMP"
+        else:
+            datetime_sql = "DATETIME"
+
         # Don't recreate if table already exists
         if db.table_exists(table):
             return True
@@ -781,7 +794,7 @@ class ORM(metaclass=ORMMeta):
             elif kind == "BooleanField":
                 sql_type = bool_sql
             elif kind == "DateTimeField":
-                sql_type = "DATETIME"
+                sql_type = datetime_sql
             elif kind == "BlobField":
                 sql_type = "BLOB"
             else:
@@ -809,7 +822,14 @@ class ORM(metaclass=ORMMeta):
                 if isinstance(default_val, str):
                     parts.append(f"DEFAULT '{default_val}'")
                 elif isinstance(default_val, bool):
-                    parts.append(f"DEFAULT {1 if default_val else 0}")
+                    # v3.13.16: a native BOOLEAN column (PG/MySQL) needs
+                    # TRUE/FALSE; INTEGER- and BIT-backed bools (SQLite,
+                    # Firebird, MSSQL) need 1/0. `DEFAULT 0` on a PG BOOLEAN
+                    # raises "default expression is of type integer".
+                    if bool_sql == "BOOLEAN":
+                        parts.append(f"DEFAULT {'TRUE' if default_val else 'FALSE'}")
+                    else:
+                        parts.append(f"DEFAULT {1 if default_val else 0}")
                 else:
                     parts.append(f"DEFAULT {default_val}")
 
@@ -821,8 +841,16 @@ class ORM(metaclass=ORMMeta):
         engine = db.get_database_type()
         sql = SQLTranslator.auto_increment_syntax(sql, engine)
 
-        db.execute(sql)
+        # v3.13.16: don't claim success when the DDL failed. db.execute()
+        # swallows the driver error into get_error() and returns False, so a
+        # bad type (or any DDL error) used to leave create_table() returning
+        # True while no table was actually created — a silent, misleading pass.
+        ok = db.execute(sql)
         db.commit()
+        if ok is False:
+            from tina4_python.debug import Log
+            Log.error(f"create_table failed for {table}: {db.get_error()}", sql=sql)
+            return False
         return True
 
     # ── Cached Queries ────────────────────────────────────────