tina4-python 3.10.40__tar.gz → 3.10.42__tar.gz

{tina4_python-3.10.40 → tina4_python-3.10.42}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: tina4-python
-Version: 3.10.40
-Summary: Tina4 Python v3 — Zero-dependency, lightweight web framework
+Version: 3.10.42
+Summary: Tina4 for Python — 54 built-in features, zero dependencies
 Author-email: Andre van Zuydam <andrevanzuydam@gmail.com>
 License: MIT
 Requires-Python: >=3.12
@@ -35,16 +35,15 @@ Description-Content-Type: text/markdown
 </p>
 
 <h1 align="center">Tina4 Python</h1>
-<h3 align="center">This Is Now A 4Framework</h3>
 
 <p align="center">
-  Laravel joy. Python speed. 10x less code. Zero third-party dependencies.
+  54 built-in features. Zero dependencies. One import, everything works.
 </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/tests-2%2C068%20passing-brightgreen" alt="Tests">
+  <img src="https://img.shields.io/badge/features-54-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>
@@ -54,6 +53,7 @@ Description-Content-Type: text/markdown
   <a href="#getting-started">Getting Started</a> &bull;
   <a href="#features">Features</a> &bull;
   <a href="#cli-reference">CLI Reference</a> &bull;
+  <a href="#cross-framework-parity">Parity</a> &bull;
   <a href="https://tina4.com">tina4.com</a>
 </p>
 
@@ -102,27 +102,24 @@ Open http://localhost:7145
 
 ---
 
-## What's Included
+## What's Built In (54 Features)
 
 Every feature is built from scratch -- no pip install, no node_modules, no third-party runtime dependencies in core.
 
 | Category | Features |
 |----------|----------|
-| **HTTP** | ASGI server, decorator routing, path params (`{id:int}`, `{p:path}`), middleware pipeline, CORS, rate limiting, graceful shutdown |
-| **Templates** | Frond engine (Twig-compatible), inheritance, partials, 35+ filters, macros, fragment caching, sandboxing |
-| **ORM** | Active Record, typed fields with validation, soft delete, relationships (`has_one`/`has_many`/`belongs_to`), scopes, result caching, multi-database |
-| **Database** | SQLite, PostgreSQL, MySQL, MSSQL, Firebird -- unified adapter interface, query caching (TINA4_DB_CACHE=true for 4x speedup) |
-| **Auth** | Zero-dep JWT (HS256), sessions (file/Redis/Valkey/MongoDB/database), password hashing, form tokens |
-| **API** | Swagger/OpenAPI auto-generation, GraphQL with ORM auto-schema and GraphiQL IDE, WSDL/SOAP with auto WSDL |
-| **Background** | Queue (SQLite/RabbitMQ/Kafka/MongoDB) with priority, delayed jobs, retry, batch processing |
-| **Real-time** | Native asyncio WebSocket (RFC 6455), per-path routing, connection manager |
-| **Frontend** | tina4-css (~24 KB), frond.js helper, SCSS compiler, live reload, CSS hot-reload |
-| **DX** | Dev admin dashboard (11 tabs), error overlay, request inspector, AI tool integration, Carbonah green benchmarks |
-| **Data** | Migrations with rollback, 50+ fake data generators, ORM and table seeders |
-| **Mail** | SMTP send (plain/HTML/attachments), IMAP read/search, dev mailbox capture |
-| **Other** | REST client, localization (6 languages), cache (memory/Redis/file), event system, inline testing, messenger (.env driven), configurable error pages, HTML element builder |
-
-**1,633 tests across 38 built-in features. Zero dependencies. All Carbonah benchmarks rated A+.**
+| **Core HTTP** (7) | Router with path params (`{id:int}`, `{p:path}`), Server, Request/Response, Middleware pipeline, Static file serving, CORS |
+| **Database** (6) | SQLite, PostgreSQL, MySQL, MSSQL, Firebird — unified adapter, connection pooling, query cache, transactions, race-safe ID generation, SQL dialect translation |
+| **ORM** (7) | Active Record with typed fields, relationships (`has_one`/`has_many`/`belongs_to`), soft delete, QueryBuilder + MongoDB support, Auto-CRUD generator, migrations with rollback |
+| **Auth & Security** (5) | JWT (HS256/RS256), password hashing (PBKDF2-SHA256), API key validation, rate limiting, CSRF form tokens |
+| **Templating** (3) | Frond engine (Twig/Jinja2-compatible, pre-compiled 2.8x faster), SCSS auto-compilation, built-in CSS (~24 KB) |
+| **API & Integration** (5) | HTTP client (zero-dep), GraphQL with ORM auto-schema + GraphiQL IDE, WSDL/SOAP with auto WSDL, WebSocket (RFC 6455) + Redis backplane, MCP server (24 dev tools) |
+| **Background** (3) | Job queue (File/RabbitMQ/Kafka/MongoDB) with priority, delay, retry, dead letters — service runner — event system (on/emit/once/off) |
+| **Data & Storage** (4) | Session (File/Redis/Valkey/MongoDB/DB), response cache (LRU, TTL), seeder + 50+ fake data generators, messenger (SMTP/IMAP) |
+| **Developer Tools** (7) | Dev dashboard (11 tabs), dev toolbar, error overlay (Catppuccin Mocha), dev mailbox, hot reload + CSS hot-reload, code metrics (complexity, coupling, maintainability), AI context installer (7 tools) |
+| **Utilities** (7) | DI container (transient + singleton), HtmlElement builder, inline testing (`@tests` decorator), i18n (6 languages), Swagger/OpenAPI auto-generation, CLI scaffolding (`generate model/route/migration/middleware`), structured logging |
+
+**2,066 tests. Zero dependencies. Full parity across Python, PHP, Ruby, and Node.js.**
 
 For full documentation visit **[tina4.com](https://tina4.com)**.
 
@@ -712,23 +709,43 @@ tina4python ai --all        # Install for ALL supported tools
 
 Supported: Claude Code, Cursor, GitHub Copilot, Windsurf, Aider, Cline, OpenAI Codex CLI. Generates framework-aware context so AI assistants understand Tina4's conventions.
 
-## Carbonah Green Benchmarks
+## Performance
 
-All 9 benchmarks rated **A+** (South Africa grid, 1000 iterations each):
+Benchmarked with `wrk` — 5,000 requests, 50 concurrent, median of 3 runs:
 
-| Benchmark | SCI (gCO2eq) | Grade |
-|-----------|-------------|-------|
-| JSON Hello World | 0.000864 | A+ |
-| Single DB Query | 0.000538 | A+ |
-| Multiple DB Queries | 0.001350 | A+ |
-| Template Rendering | 0.003237 | A+ |
-| Large JSON Payload | 0.000983 | A+ |
-| Plaintext Response | 0.000377 | A+ |
-| CRUD Cycle | 0.000456 | A+ |
-| Paginated Query | 0.000990 | A+ |
-| Framework Startup | 0.000801 | A+ |
+| Framework | JSON req/s | Deps | Features |
+|-----------|-----------|------|----------|
+| **Tina4 Python** | **6,508** | 0 | 54 |
+| FastAPI | 12,652 | 12+ | ~8 |
+| Flask | 4,928 | 6+ | ~7 |
+| Bottle | 4,355 | 0 | ~5 |
+| Django | 4,050 | 20+ | ~22 |
 
-Run locally: `python benchmarks/run_carbonah.py`
+Tina4 Python delivers competitive throughput with **zero dependencies and 54 features** — frameworks with higher req/s have a fraction of the functionality and require dozens of third-party packages.
+
+**Across all 4 Tina4 implementations:**
+
+| | Python | PHP | Ruby | Node.js |
+|---|--------|-----|------|---------|
+| **JSON req/s** | 6,508 | 29,293 | 10,243 | 84,771 |
+| **Dependencies** | 0 | 0 | 0 | 0 |
+| **Features** | 54 | 54 | 54 | 54 |
+
+Run benchmarks locally: `python benchmarks/benchmark.py --python`
+
+---
+
+## Cross-Framework Parity
+
+Tina4 ships identical features across four languages — same architecture, same conventions, same 54 features:
+
+| | Python | PHP | Ruby | Node.js |
+|---|--------|-----|------|---------|
+| **Package** | `tina4-python` | `tina4stack/tina4php` | `tina4ruby` | `tina4-nodejs` |
+| **Tests** | 2,066 | 1,427 | 1,793 | 1,950 |
+| **Default port** | 7145 | 7146 | 7147 | 7148 |
+
+**7,236 tests** across all 4 frameworks. See [tina4.com](https://tina4.com).
 
 ---
 

{tina4_python-3.10.40 → tina4_python-3.10.42}/README.md

@@ -3,16 +3,15 @@
 </p>
 
 <h1 align="center">Tina4 Python</h1>
-<h3 align="center">This Is Now A 4Framework</h3>
 
 <p align="center">
-  Laravel joy. Python speed. 10x less code. Zero third-party dependencies.
+  54 built-in features. Zero dependencies. One import, everything works.
 </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/tests-2%2C068%20passing-brightgreen" alt="Tests">
+  <img src="https://img.shields.io/badge/features-54-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>
@@ -22,6 +21,7 @@
   <a href="#getting-started">Getting Started</a> &bull;
   <a href="#features">Features</a> &bull;
   <a href="#cli-reference">CLI Reference</a> &bull;
+  <a href="#cross-framework-parity">Parity</a> &bull;
   <a href="https://tina4.com">tina4.com</a>
 </p>
 
@@ -70,27 +70,24 @@ Open http://localhost:7145
 
 ---
 
-## What's Included
+## What's Built In (54 Features)
 
 Every feature is built from scratch -- no pip install, no node_modules, no third-party runtime dependencies in core.
 
 | Category | Features |
 |----------|----------|
-| **HTTP** | ASGI server, decorator routing, path params (`{id:int}`, `{p:path}`), middleware pipeline, CORS, rate limiting, graceful shutdown |
-| **Templates** | Frond engine (Twig-compatible), inheritance, partials, 35+ filters, macros, fragment caching, sandboxing |
-| **ORM** | Active Record, typed fields with validation, soft delete, relationships (`has_one`/`has_many`/`belongs_to`), scopes, result caching, multi-database |
-| **Database** | SQLite, PostgreSQL, MySQL, MSSQL, Firebird -- unified adapter interface, query caching (TINA4_DB_CACHE=true for 4x speedup) |
-| **Auth** | Zero-dep JWT (HS256), sessions (file/Redis/Valkey/MongoDB/database), password hashing, form tokens |
-| **API** | Swagger/OpenAPI auto-generation, GraphQL with ORM auto-schema and GraphiQL IDE, WSDL/SOAP with auto WSDL |
-| **Background** | Queue (SQLite/RabbitMQ/Kafka/MongoDB) with priority, delayed jobs, retry, batch processing |
-| **Real-time** | Native asyncio WebSocket (RFC 6455), per-path routing, connection manager |
-| **Frontend** | tina4-css (~24 KB), frond.js helper, SCSS compiler, live reload, CSS hot-reload |
-| **DX** | Dev admin dashboard (11 tabs), error overlay, request inspector, AI tool integration, Carbonah green benchmarks |
-| **Data** | Migrations with rollback, 50+ fake data generators, ORM and table seeders |
-| **Mail** | SMTP send (plain/HTML/attachments), IMAP read/search, dev mailbox capture |
-| **Other** | REST client, localization (6 languages), cache (memory/Redis/file), event system, inline testing, messenger (.env driven), configurable error pages, HTML element builder |
-
-**1,633 tests across 38 built-in features. Zero dependencies. All Carbonah benchmarks rated A+.**
+| **Core HTTP** (7) | Router with path params (`{id:int}`, `{p:path}`), Server, Request/Response, Middleware pipeline, Static file serving, CORS |
+| **Database** (6) | SQLite, PostgreSQL, MySQL, MSSQL, Firebird — unified adapter, connection pooling, query cache, transactions, race-safe ID generation, SQL dialect translation |
+| **ORM** (7) | Active Record with typed fields, relationships (`has_one`/`has_many`/`belongs_to`), soft delete, QueryBuilder + MongoDB support, Auto-CRUD generator, migrations with rollback |
+| **Auth & Security** (5) | JWT (HS256/RS256), password hashing (PBKDF2-SHA256), API key validation, rate limiting, CSRF form tokens |
+| **Templating** (3) | Frond engine (Twig/Jinja2-compatible, pre-compiled 2.8x faster), SCSS auto-compilation, built-in CSS (~24 KB) |
+| **API & Integration** (5) | HTTP client (zero-dep), GraphQL with ORM auto-schema + GraphiQL IDE, WSDL/SOAP with auto WSDL, WebSocket (RFC 6455) + Redis backplane, MCP server (24 dev tools) |
+| **Background** (3) | Job queue (File/RabbitMQ/Kafka/MongoDB) with priority, delay, retry, dead letters — service runner — event system (on/emit/once/off) |
+| **Data & Storage** (4) | Session (File/Redis/Valkey/MongoDB/DB), response cache (LRU, TTL), seeder + 50+ fake data generators, messenger (SMTP/IMAP) |
+| **Developer Tools** (7) | Dev dashboard (11 tabs), dev toolbar, error overlay (Catppuccin Mocha), dev mailbox, hot reload + CSS hot-reload, code metrics (complexity, coupling, maintainability), AI context installer (7 tools) |
+| **Utilities** (7) | DI container (transient + singleton), HtmlElement builder, inline testing (`@tests` decorator), i18n (6 languages), Swagger/OpenAPI auto-generation, CLI scaffolding (`generate model/route/migration/middleware`), structured logging |
+
+**2,066 tests. Zero dependencies. Full parity across Python, PHP, Ruby, and Node.js.**
 
 For full documentation visit **[tina4.com](https://tina4.com)**.
 
@@ -680,23 +677,43 @@ tina4python ai --all        # Install for ALL supported tools
 
 Supported: Claude Code, Cursor, GitHub Copilot, Windsurf, Aider, Cline, OpenAI Codex CLI. Generates framework-aware context so AI assistants understand Tina4's conventions.
 
-## Carbonah Green Benchmarks
+## Performance
 
-All 9 benchmarks rated **A+** (South Africa grid, 1000 iterations each):
+Benchmarked with `wrk` — 5,000 requests, 50 concurrent, median of 3 runs:
 
-| Benchmark | SCI (gCO2eq) | Grade |
-|-----------|-------------|-------|
-| JSON Hello World | 0.000864 | A+ |
-| Single DB Query | 0.000538 | A+ |
-| Multiple DB Queries | 0.001350 | A+ |
-| Template Rendering | 0.003237 | A+ |
-| Large JSON Payload | 0.000983 | A+ |
-| Plaintext Response | 0.000377 | A+ |
-| CRUD Cycle | 0.000456 | A+ |
-| Paginated Query | 0.000990 | A+ |
-| Framework Startup | 0.000801 | A+ |
+| Framework | JSON req/s | Deps | Features |
+|-----------|-----------|------|----------|
+| **Tina4 Python** | **6,508** | 0 | 54 |
+| FastAPI | 12,652 | 12+ | ~8 |
+| Flask | 4,928 | 6+ | ~7 |
+| Bottle | 4,355 | 0 | ~5 |
+| Django | 4,050 | 20+ | ~22 |
 
-Run locally: `python benchmarks/run_carbonah.py`
+Tina4 Python delivers competitive throughput with **zero dependencies and 54 features** — frameworks with higher req/s have a fraction of the functionality and require dozens of third-party packages.
+
+**Across all 4 Tina4 implementations:**
+
+| | Python | PHP | Ruby | Node.js |
+|---|--------|-----|------|---------|
+| **JSON req/s** | 6,508 | 29,293 | 10,243 | 84,771 |
+| **Dependencies** | 0 | 0 | 0 | 0 |
+| **Features** | 54 | 54 | 54 | 54 |
+
+Run benchmarks locally: `python benchmarks/benchmark.py --python`
+
+---
+
+## Cross-Framework Parity
+
+Tina4 ships identical features across four languages — same architecture, same conventions, same 54 features:
+
+| | Python | PHP | Ruby | Node.js |
+|---|--------|-----|------|---------|
+| **Package** | `tina4-python` | `tina4stack/tina4php` | `tina4ruby` | `tina4-nodejs` |
+| **Tests** | 2,066 | 1,427 | 1,793 | 1,950 |
+| **Default port** | 7145 | 7146 | 7147 | 7148 |
+
+**7,236 tests** across all 4 frameworks. See [tina4.com](https://tina4.com).
 
 ---
 

{tina4_python-3.10.40 → tina4_python-3.10.42}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "tina4-python"
-version = "3.10.40"
-description = "Tina4 Python v3 — Zero-dependency, lightweight web framework"
+version = "3.10.42"
+description = "Tina4 for Python — 54 built-in features, zero dependencies"
 authors = [
     {name = "Andre van Zuydam", email = "andrevanzuydam@gmail.com"}
 ]

{tina4_python-3.10.40 → tina4_python-3.10.42}/tina4_python/CLAUDE.md

@@ -1762,8 +1762,8 @@ async def dashboard(request, response):
 
 ## v3 Features Summary
 
-- **38 built-in features**, zero third-party dependencies
-- **1,633 tests** passing across all modules
+- **54 built-in features**, zero third-party dependencies
+- **2,066 tests** passing across all modules
 - **Production server auto-detect**: `tina4python serve --production` auto-installs uvicorn
 - **`tina4python generate`**: model, route, migration, middleware scaffolding
 - **Database**: 5 engines (SQLite, PostgreSQL, MySQL, MSSQL, Firebird), query caching (`TINA4_DB_CACHE=true`, `cache_stats()`, `cache_clear()`)

{tina4_python-3.10.40 → tina4_python-3.10.42}/tina4_python/core/__init__.py

@@ -19,7 +19,7 @@ from tina4_python.core.router import (
 from tina4_python.core.middleware import CorsMiddleware, RateLimiter
 from tina4_python.core.cache import Cache
 from tina4_python.core.events import on, off, emit, emit_async, once, listeners, events, clear as clear_events
-from tina4_python.core.server import run, resolve_config
+from tina4_python.core.server import run, resolve_config, handle
 
 __all__ = [
     "Request", "Response", "Router",
@@ -28,5 +28,5 @@ __all__ = [
     "CorsMiddleware", "RateLimiter",
     "Cache",
     "on", "off", "emit", "emit_async", "once", "listeners", "events", "clear_events",
-    "run", "resolve_config",
+    "run", "resolve_config", "handle",
 ]

{tina4_python-3.10.40 → tina4_python-3.10.42}/tina4_python/core/server.py

@@ -607,54 +607,33 @@ async def _handle_dev_websocket(reader, writer, headers, path):
             pass
 
 
-async def app(scope: dict, receive, send):
-    """ASGI entry point — compatible with uvicorn, hypercorn, granian."""
-    if scope["type"] == "lifespan":
-        msg = await receive()
-        if msg["type"] == "lifespan.startup":
-            import time
-            global _start_time
-            _start_time = time.time()
-            await send({"type": "lifespan.startup.complete"})
-        elif msg["type"] == "lifespan.shutdown":
-            await send({"type": "lifespan.shutdown.complete"})
-        return
-
-    if scope["type"] == "websocket":
-        await _handle_asgi_websocket(scope, receive, send)
-        return
-
-    if scope["type"] != "http":
-        return
 
-    # Read full body
-    body = b""
-    while True:
-        msg = await receive()
-        body += msg.get("body", b"")
-        if not msg.get("more_body", False):
-            break
+async def handle(request: Request) -> Response:
+    """Dispatch a pre-built Request through the Tina4 router and return a Response.
 
-    # Build request
-    request = Request.from_scope(scope, body)
+    Handles session setup, CORS, rate limiting, routing, auth, middleware,
+    dev toolbar injection, and session saving. The caller is responsible
+    for sending the response over the wire. Useful for testing and embedding.
+    """
     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
+    if request.session is None:
+        try:
+            from tina4_python.session import Session
+            cookie_header = request.headers.get("cookie", "")
+            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)
@@ -663,9 +642,7 @@ async def app(scope: dict, receive, send):
     if _cors.is_preflight(request):
         _cors.apply(request, response)
         response.status(204)
-        await send({"type": "http.response.start", "status": 204, "headers": response.build_headers("")})
-        await send({"type": "http.response.body", "body": b""})
-        return
+        return response
 
     # Rate limiting
     rate_enabled = os.environ.get("TINA4_RATE_LIMIT", "")
@@ -680,9 +657,7 @@ async def app(scope: dict, receive, send):
                 "status": 429,
             })
             response.header("retry-after", str(info["reset"]))
-            await send({"type": "http.response.start", "status": 429, "headers": response.build_headers("")})
-            await send({"type": "http.response.body", "body": response.content})
-            return
+            return response
 
     import time as _time
     _req_start = _time.perf_counter()
@@ -727,12 +702,9 @@ async def app(scope: dict, receive, send):
             else:
                 response.status(404).json({"error": "Not found"})
 
-        # Send dev admin response (skip overlay injection)
+        # Dev admin response (skip overlay injection)
         _cors.apply(request, response)
-        headers = response.build_headers("")
-        await send({"type": "http.response.start", "status": response.status_code, "headers": headers})
-        await send({"type": "http.response.body", "body": response.content})
-        return
+        return response
 
     # Swagger auto-register: serve /swagger and /swagger/openapi.json when debug is on
     if _is_dev and request.method == "GET":
@@ -749,10 +721,7 @@ async def app(scope: dict, receive, send):
             )
             response.html(swagger_html)
             _cors.apply(request, response)
-            headers = response.build_headers("")
-            await send({"type": "http.response.start", "status": response.status_code, "headers": headers})
-            await send({"type": "http.response.body", "body": response.content})
-            return
+            return response
         elif request.path == "/swagger/openapi.json":
             # Serve OpenAPI spec JSON from all registered routes
             from tina4_python.swagger import Swagger as _SwaggerGen
@@ -760,10 +729,7 @@ async def app(scope: dict, receive, send):
             _spec = _swagger.generate(Router.get_routes())
             response.json(_spec)
             _cors.apply(request, response)
-            headers = response.build_headers("")
-            await send({"type": "http.response.start", "status": response.status_code, "headers": headers})
-            await send({"type": "http.response.body", "body": response.content})
-            return
+            return response
 
     # Match route
     route, params = Router.match(request.method, request.path)
@@ -931,13 +897,13 @@ async def app(scope: dict, receive, send):
                     request.method, request.path, matched_pattern,
                     request_id, len(Router.get_routes()),
                 ).encode()
-                content = response.content
+                content_body = response.content
                 # Inject before </body> if present, else append
-                if b"</body>" in content:
-                    content = content.replace(b"</body>", toolbar + b"\n</body>", 1)
+                if b"</body>" in content_body:
+                    content_body = content_body.replace(b"</body>", toolbar + b"\n</body>", 1)
                 else:
-                    content = content + toolbar
-                response.content = content
+                    content_body = content_body + toolbar
+                response.content = content_body
             except Exception:
                 pass
 
@@ -954,9 +920,6 @@ async def app(scope: dict, receive, send):
         except Exception:
             pass
 
-    # 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:
@@ -973,7 +936,43 @@ async def app(scope: dict, receive, send):
         except Exception:
             pass
 
-    # Build and send response
+    return response
+
+
+async def app(scope: dict, receive, send):
+    """ASGI entry point — compatible with uvicorn, hypercorn, granian."""
+    if scope["type"] == "lifespan":
+        msg = await receive()
+        if msg["type"] == "lifespan.startup":
+            import time
+            global _start_time
+            _start_time = time.time()
+            await send({"type": "lifespan.startup.complete"})
+        elif msg["type"] == "lifespan.shutdown":
+            await send({"type": "lifespan.shutdown.complete"})
+        return
+
+    if scope["type"] == "websocket":
+        await _handle_asgi_websocket(scope, receive, send)
+        return
+
+    if scope["type"] != "http":
+        return
+
+    # Read full body
+    body = b""
+    while True:
+        msg = await receive()
+        body += msg.get("body", b"")
+        if not msg.get("more_body", False):
+            break
+
+    # Build request and dispatch
+    request = Request.from_scope(scope, body)
+    response = await handle(request)
+
+    # ETag check — 304 Not Modified
+    if_none_match = request.headers.get("if-none-match", "")
     accept_encoding = request.headers.get("accept-encoding", "")
     headers = response.build_headers(accept_encoding)
 

{tina4_python-3.10.40 → tina4_python-3.10.42}/tina4_python/dev_admin/__init__.py

@@ -1924,6 +1924,15 @@ function drillDownFile(path){
             });
             html+='</div>';
         }
+        if(d.warnings&&d.warnings.length){
+            html+='<h3 style="margin:0.75rem 0 0.25rem;color:#eab308;font-size:0.85rem">&#9888; Warnings</h3>';
+            html+='<div style="display:flex;flex-direction:column;gap:4px">';
+            d.warnings.forEach(function(w){
+                html+='<div style="padding:4px 8px;background:rgba(234,179,8,0.08);border-left:3px solid #eab308;border-radius:0 4px 4px 0;font-size:0.75rem;font-family:var(--mono);color:var(--text)">';
+                html+='<span style="color:#eab308;margin-right:6px">L'+w.line+'</span>'+w.message+'</div>';
+            });
+            html+='</div>';
+        }
         dd.querySelector('.p-md').innerHTML=html;
     }).catch(function(e){
         dd.querySelector('.p-md').innerHTML='<p style="color:var(--danger)">Error: '+e.message+'</p>';

{tina4_python-3.10.40 → tina4_python-3.10.42}/tina4_python/dev_admin/metrics.py

@@ -327,6 +327,23 @@ def file_detail(file_path: str) -> dict:
     classes = sum(1 for n in ast.walk(tree) if isinstance(n, ast.ClassDef))
     imports = _extract_imports(tree, file_path)
 
+    # Detect empty methods/functions (body is only `pass` or a docstring)
+    warnings = []
+    for node in ast.walk(tree):
+        if isinstance(node, (ast.FunctionDef, ast.AsyncFunctionDef)):
+            body = node.body
+            # Strip leading docstring
+            effective = body[1:] if body and isinstance(body[0], ast.Expr) and isinstance(body[0].value, ast.Constant) else body
+            if not effective or all(isinstance(s, ast.Pass) for s in effective):
+                parent = _get_parent_class(tree, node)
+                name = f"{parent}.{node.name}" if parent else node.name
+                warnings.append({"type": "empty_method", "message": f"Method '{name}' appears to be empty", "line": node.lineno})
+        elif isinstance(node, ast.ClassDef):
+            body = node.body
+            effective = body[1:] if body and isinstance(body[0], ast.Expr) and isinstance(body[0].value, ast.Constant) else body
+            if not effective or all(isinstance(s, ast.Pass) for s in effective):
+                warnings.append({"type": "empty_class", "message": f"Class '{node.name}' appears to be empty", "line": node.lineno})
+
     return {
         "path": file_path,
         "loc": loc,
@@ -334,6 +351,7 @@ def file_detail(file_path: str) -> dict:
         "classes": classes,
         "functions": functions,
         "imports": imports,
+        "warnings": warnings,
     }
 
 

{tina4_python-3.10.40 → tina4_python-3.10.42}/tina4_python/orm/model.py

@@ -325,7 +325,6 @@ class ORM(metaclass=ORMMeta):
             pk_value: Primary key value.
             include: List of relationship names to eager-load.
         """
-        db = cls._get_db()
         pk = cls._get_pk()
         table = cls._get_table()
         pk_col = cls.field_mapping.get(pk, cls._fields[pk].column)
@@ -334,13 +333,7 @@ class ORM(metaclass=ORMMeta):
         if cls.soft_delete:
             sql += " AND deleted_at IS NULL"
 
-        row = db.fetch_one(sql, [pk_value])
-        if row is None:
-            return None
-        instance = cls(row)
-        if include:
-            cls._eager_load([instance], include)
-        return instance
+        return cls.select_one(sql, [pk_value], include=include)
 
     @classmethod
     def find(cls, pk_value, include: list[str] = None):
@@ -395,6 +388,12 @@ class ORM(metaclass=ORMMeta):
             cls._eager_load(instances, include)
         return instances, result.count
 
+    @classmethod
+    def select_one(cls, sql: str, params: list = None, include: list[str] = None):
+        """Return a single ORM instance for a raw SQL query, or None if no rows match."""
+        instances, _ = cls.select(sql, params, limit=1, offset=0, include=include)
+        return instances[0] if instances else None
+
     @classmethod
     def where(cls, filter_sql: str, params: list = None, limit: int = 20, offset: int = 0,
               include: list[str] = None):