tina4-python 3.8.2__tar.gz → 3.8.7__tar.gz

{tina4_python-3.8.2 → tina4_python-3.8.7}/.gitignore

@@ -54,7 +54,8 @@ __pycache__/
 /benchmarks/secrets/
 /benchmarks/results/
 /benchmarks/__pycache__/
-.claude/
+.claude/*
+!.claude/skills/
 *.c
 *.so
 build/
@@ -63,3 +64,5 @@ demo/.env
 example/.env
 demo/data/*.db
 demo/logs/*.log
+.claude/settings.local.json
+.claude/worktrees/

{tina4_python-3.8.2 → tina4_python-3.8.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tina4-python
-Version: 3.8.2
+Version: 3.8.7
 Summary: Tina4 Python v3 — Zero-dependency, lightweight web framework
 Author-email: Andre van Zuydam <andrevanzuydam@gmail.com>
 License: MIT
@@ -41,6 +41,14 @@ Description-Content-Type: text/markdown
   Laravel joy. Python speed. 10x less code. Zero third-party dependencies.
 </p>
 
+<p align="center">
+  <a href="https://pypi.org/project/tina4-python/"><img src="https://img.shields.io/pypi/v/tina4-python?color=7b1fa2&label=PyPI" alt="PyPI"></a>
+  <img src="https://img.shields.io/badge/tests-1%2C791%20passing-brightgreen" alt="Tests">
+  <img src="https://img.shields.io/badge/features-38-blue" alt="Features">
+  <img src="https://img.shields.io/badge/dependencies-0-brightgreen" alt="Zero Deps">
+  <a href="https://tina4.com"><img src="https://img.shields.io/badge/docs-tina4.com-7b1fa2" alt="Docs"></a>
+</p>
+
 <p align="center">
   <a href="https://tina4.com">Documentation</a> &bull;
   <a href="#getting-started">Getting Started</a> &bull;
@@ -49,15 +57,6 @@ Description-Content-Type: text/markdown
   <a href="https://tina4.com">tina4.com</a>
 </p>
 
-<p align="center">
-  <img src="https://img.shields.io/badge/version-3.0.0-blue" alt="Version 3.0.0">
-  <img src="https://img.shields.io/badge/tests-1633%20passing-brightgreen" alt="Tests">
-  <img src="https://img.shields.io/badge/carbonah-A%2B%20rated-00cc44" alt="Carbonah A+">
-  <img src="https://img.shields.io/badge/zero--dep-core-blue" alt="Zero Dependencies">
-  <img src="https://img.shields.io/badge/python-3.12%2B-blue" alt="Python 3.12+">
-  <img src="https://img.shields.io/badge/license-MIT-lightgrey" alt="MIT License">
-</p>
-
 ---
 
 ## Quick Start

{tina4_python-3.8.2 → tina4_python-3.8.7}/README.md

@@ -9,6 +9,14 @@
   Laravel joy. Python speed. 10x less code. Zero third-party dependencies.
 </p>
 
+<p align="center">
+  <a href="https://pypi.org/project/tina4-python/"><img src="https://img.shields.io/pypi/v/tina4-python?color=7b1fa2&label=PyPI" alt="PyPI"></a>
+  <img src="https://img.shields.io/badge/tests-1%2C791%20passing-brightgreen" alt="Tests">
+  <img src="https://img.shields.io/badge/features-38-blue" alt="Features">
+  <img src="https://img.shields.io/badge/dependencies-0-brightgreen" alt="Zero Deps">
+  <a href="https://tina4.com"><img src="https://img.shields.io/badge/docs-tina4.com-7b1fa2" alt="Docs"></a>
+</p>
+
 <p align="center">
   <a href="https://tina4.com">Documentation</a> &bull;
   <a href="#getting-started">Getting Started</a> &bull;
@@ -17,15 +25,6 @@
   <a href="https://tina4.com">tina4.com</a>
 </p>
 
-<p align="center">
-  <img src="https://img.shields.io/badge/version-3.0.0-blue" alt="Version 3.0.0">
-  <img src="https://img.shields.io/badge/tests-1633%20passing-brightgreen" alt="Tests">
-  <img src="https://img.shields.io/badge/carbonah-A%2B%20rated-00cc44" alt="Carbonah A+">
-  <img src="https://img.shields.io/badge/zero--dep-core-blue" alt="Zero Dependencies">
-  <img src="https://img.shields.io/badge/python-3.12%2B-blue" alt="Python 3.12+">
-  <img src="https://img.shields.io/badge/license-MIT-lightgrey" alt="MIT License">
-</p>
-
 ---
 
 ## Quick Start

{tina4_python-3.8.2 → tina4_python-3.8.7}/pyproject.toml

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

{tina4_python-3.8.2 → tina4_python-3.8.7}/tina4_python/__init__.py

@@ -8,7 +8,7 @@ Tina4 Python v3.0 — Zero-dependency, lightweight web framework.
 
 One import, everything works.
 """
-__version__ = "3.8.2"
+__version__ = "3.8.3"
 
 # ── HTTP Constants ──
 from tina4_python.core.constants import (  # noqa: E402, F401

{tina4_python-3.8.2 → tina4_python-3.8.7}/tina4_python/core/server.py

@@ -644,6 +644,22 @@ async def app(scope: dict, receive, send):
     request_id = request.headers.get("x-request-id", str(uuid.uuid4())[:8])
     set_request_id(request_id)
 
+    # Auto-start session — lazy, reads cookie, saves on response
+    try:
+        from tina4_python.session import Session
+        cookie_header = dict(scope.get("headers", [])).get(b"cookie", b"").decode()
+        sid_match = None
+        for part in cookie_header.split(";"):
+            part = part.strip()
+            if part.startswith("tina4_session="):
+                sid_match = part.split("=", 1)[1]
+                break
+        sess = Session()
+        sess.start(sid_match)
+        request.session = sess
+    except Exception:
+        pass  # Session module not available — session stays None
+
     response = Response()
     response.header("x-request-id", request_id)
 
@@ -764,17 +780,34 @@ async def app(scope: dict, receive, send):
             _sig = inspect.signature(route["handler"])
             _params = list(_sig.parameters.values())
             _pcount = len(_params)
-            if _pcount == 0:
-                result = await route["handler"]()
-            elif _pcount == 1:
-                # If type-hinted as Request, pass request; otherwise pass response
-                _ann = _params[0].annotation
+
+            # Build args: inject path params by name, then request/response
+            _args = []
+            _remaining = []
+            for p in _params:
+                name = p.name
+                if name in params:
+                    _args.append(params[name])
+                else:
+                    _remaining.append(p)
+
+            # Append request/response for remaining positional params
+            if len(_remaining) == 0:
+                pass  # All params were path params
+            elif len(_remaining) == 1:
+                _ann = _remaining[0].annotation
                 if _ann is Request or (isinstance(_ann, str) and _ann in ("Request", "request")):
-                    result = await route["handler"](request)
+                    _args.append(request)
                 else:
-                    result = await route["handler"](response)
+                    _args.append(response)
+            elif len(_remaining) >= 2:
+                _args.append(request)
+                _args.append(response)
+
+            if _pcount == 0:
+                result = await route["handler"]()
             else:
-                result = await route["handler"](request, response)
+                result = await route["handler"](*_args)
             if isinstance(result, Response):
                 response = result
         except Exception as e:
@@ -871,6 +904,17 @@ async def app(scope: dict, receive, send):
     # ETag check — 304 Not Modified
     if_none_match = request.headers.get("if-none-match", "")
 
+    # Save session and set cookie if session was used
+    if request.session is not None:
+        try:
+            request.session.save()
+            sid = request.session.session_id if hasattr(request.session, 'session_id') else getattr(request.session, 'id', None)
+            if sid:
+                ttl = int(os.environ.get("TINA4_SESSION_TTL", "3600"))
+                response.header("set-cookie", f"tina4_session={sid}; Path=/; HttpOnly; SameSite=Lax; Max-Age={ttl}")
+        except Exception:
+            pass
+
     # Build and send response
     accept_encoding = request.headers.get("accept-encoding", "")
     headers = response.build_headers(accept_encoding)

{tina4_python-3.8.2 → tina4_python-3.8.7}/tina4_python/orm/model.py

@@ -138,6 +138,19 @@ class ORM(metaclass=ORMMeta):
             data[db_col] = getattr(self, name)
         return data
 
+    @classmethod
+    def query(cls) -> "QueryBuilder":
+        """Create a fluent QueryBuilder pre-configured for this model's table and database.
+
+        Usage:
+            results = User.query().where("active = ?", [1]).order_by("name").get()
+
+        Returns:
+            A QueryBuilder instance bound to this model's table and database.
+        """
+        from tina4_python.query_builder import QueryBuilder
+        return QueryBuilder.from_table(cls._get_table(), cls._get_db())
+
     @classmethod
     def _get_table(cls) -> str:
         """Get table name — defaults to lowercase class name + 's'."""

tina4_python-3.8.7/tina4_python/query_builder/__init__.py

@@ -0,0 +1,280 @@
+# Tina4 QueryBuilder — Fluent SQL query builder.
+"""
+Fluent SQL query builder for Tina4 Python.
+
+Usage:
+    # Standalone
+    result = QueryBuilder.from_table("users", db) \\
+        .select("id", "name") \\
+        .where("active = ?", [1]) \\
+        .order_by("name ASC") \\
+        .limit(10) \\
+        .get()
+
+    # From ORM model
+    result = User.query() \\
+        .where("age > ?", [18]) \\
+        .order_by("name") \\
+        .get()
+"""
+
+
+class QueryBuilder:
+    """Fluent SQL query builder that produces and executes SQL statements."""
+
+    def __init__(self, table: str, db=None):
+        """Private-ish constructor. Use from_table() or ORM.query()."""
+        self._table = table
+        self._db = db
+        self._columns: list[str] = ["*"]
+        self._wheres: list[tuple[str, str]] = []
+        self._params: list = []
+        self._joins: list[str] = []
+        self._group_by_cols: list[str] = []
+        self._havings: list[str] = []
+        self._having_params: list = []
+        self._order_by_cols: list[str] = []
+        self._limit_val: int | None = None
+        self._offset_val: int | None = None
+
+    @staticmethod
+    def from_table(table_name: str, db=None) -> "QueryBuilder":
+        """Create a QueryBuilder for a table.
+
+        Args:
+            table_name: The database table name.
+            db: Optional database connection (Database or adapter).
+
+        Returns:
+            A new QueryBuilder instance.
+        """
+        return QueryBuilder(table_name, db)
+
+    def select(self, *columns: str) -> "QueryBuilder":
+        """Set the columns to select.
+
+        Args:
+            *columns: Column names (default is '*').
+
+        Returns:
+            self for chaining.
+        """
+        if columns:
+            self._columns = list(columns)
+        return self
+
+    def where(self, condition: str, params: list = None) -> "QueryBuilder":
+        """Add a WHERE condition with AND.
+
+        Args:
+            condition: SQL condition with ? placeholders.
+            params: Parameter values for placeholders.
+
+        Returns:
+            self for chaining.
+        """
+        self._wheres.append(("AND", condition))
+        if params:
+            self._params.extend(params)
+        return self
+
+    def or_where(self, condition: str, params: list = None) -> "QueryBuilder":
+        """Add a WHERE condition with OR.
+
+        Args:
+            condition: SQL condition with ? placeholders.
+            params: Parameter values for placeholders.
+
+        Returns:
+            self for chaining.
+        """
+        self._wheres.append(("OR", condition))
+        if params:
+            self._params.extend(params)
+        return self
+
+    def join(self, table: str, on_clause: str) -> "QueryBuilder":
+        """Add an INNER JOIN.
+
+        Args:
+            table: Table to join.
+            on_clause: Join condition.
+
+        Returns:
+            self for chaining.
+        """
+        self._joins.append(f"INNER JOIN {table} ON {on_clause}")
+        return self
+
+    def left_join(self, table: str, on_clause: str) -> "QueryBuilder":
+        """Add a LEFT JOIN.
+
+        Args:
+            table: Table to join.
+            on_clause: Join condition.
+
+        Returns:
+            self for chaining.
+        """
+        self._joins.append(f"LEFT JOIN {table} ON {on_clause}")
+        return self
+
+    def group_by(self, column: str) -> "QueryBuilder":
+        """Add a GROUP BY column.
+
+        Args:
+            column: Column name to group by.
+
+        Returns:
+            self for chaining.
+        """
+        self._group_by_cols.append(column)
+        return self
+
+    def having(self, expression: str, params: list = None) -> "QueryBuilder":
+        """Add a HAVING clause.
+
+        Args:
+            expression: HAVING expression with ? placeholders.
+            params: Parameter values.
+
+        Returns:
+            self for chaining.
+        """
+        self._havings.append(expression)
+        if params:
+            self._having_params.extend(params)
+        return self
+
+    def order_by(self, expression: str) -> "QueryBuilder":
+        """Add an ORDER BY clause.
+
+        Args:
+            expression: Column and direction (e.g. "name ASC").
+
+        Returns:
+            self for chaining.
+        """
+        self._order_by_cols.append(expression)
+        return self
+
+    def limit(self, count: int, offset: int = None) -> "QueryBuilder":
+        """Set LIMIT and optional OFFSET.
+
+        Args:
+            count: Maximum rows to return.
+            offset: Number of rows to skip.
+
+        Returns:
+            self for chaining.
+        """
+        self._limit_val = count
+        if offset is not None:
+            self._offset_val = offset
+        return self
+
+    def to_sql(self) -> str:
+        """Build and return the SQL string without executing.
+
+        Returns:
+            The constructed SQL query string.
+        """
+        sql = f"SELECT {', '.join(self._columns)} FROM {self._table}"
+
+        if self._joins:
+            sql += " " + " ".join(self._joins)
+
+        if self._wheres:
+            sql += " WHERE " + self._build_where()
+
+        if self._group_by_cols:
+            sql += " GROUP BY " + ", ".join(self._group_by_cols)
+
+        if self._havings:
+            sql += " HAVING " + " AND ".join(self._havings)
+
+        if self._order_by_cols:
+            sql += " ORDER BY " + ", ".join(self._order_by_cols)
+
+        return sql
+
+    def get(self):
+        """Execute the query and return the DatabaseResult.
+
+        Returns:
+            DatabaseResult from db.fetch().
+        """
+        self._ensure_db()
+        sql = self.to_sql()
+        all_params = self._params + self._having_params
+
+        return self._db.fetch(
+            sql,
+            all_params or None,
+            self._limit_val if self._limit_val is not None else 100,
+            self._offset_val if self._offset_val is not None else 0,
+        )
+
+    def first(self) -> dict | None:
+        """Execute the query and return a single row.
+
+        Returns:
+            A dict for the first matching row, or None.
+        """
+        self._ensure_db()
+        sql = self.to_sql()
+        all_params = self._params + self._having_params
+
+        return self._db.fetch_one(sql, all_params or None)
+
+    def count(self) -> int:
+        """Execute the query and return the row count.
+
+        Returns:
+            Number of matching rows.
+        """
+        self._ensure_db()
+
+        # Build a count query by replacing columns
+        original = self._columns
+        self._columns = ["COUNT(*) as cnt"]
+        sql = self.to_sql()
+        self._columns = original
+
+        all_params = self._params + self._having_params
+
+        row = self._db.fetch_one(sql, all_params or None)
+        if row is None:
+            return 0
+        # Handle case-insensitive column names
+        return int(row.get("cnt", row.get("CNT", 0)))
+
+    def exists(self) -> bool:
+        """Check whether any matching rows exist.
+
+        Returns:
+            True if at least one row matches.
+        """
+        return self.count() > 0
+
+    # -- Private helpers --
+
+    def _build_where(self) -> str:
+        """Build the WHERE clause from accumulated conditions."""
+        parts = []
+        for i, (connector, condition) in enumerate(self._wheres):
+            if i == 0:
+                parts.append(condition)
+            else:
+                parts.append(f"{connector} {condition}")
+        return " ".join(parts)
+
+    def _ensure_db(self):
+        """Ensure a database connection is available."""
+        if self._db is None:
+            # Try to use the global ORM database
+            from tina4_python.orm.model import _database
+            if _database is not None:
+                self._db = _database
+            else:
+                raise RuntimeError("QueryBuilder: No database connection provided.")

{tina4_python-3.8.2 → tina4_python-3.8.7}/tina4_python/session/__init__.py

@@ -208,11 +208,14 @@ class Session:
         self._data[key] = value
         self._dirty = True
 
-    def unset(self, key: str):
+    def delete(self, key: str):
         """Remove a session key."""
         self._data.pop(key, None)
         self._dirty = True
 
+    # Alias for backward compatibility
+    unset = delete
+
     def has(self, key: str) -> bool:
         return key in self._data