tina4-python 3.10.50__tar.gz → 3.10.55__tar.gz

{tina4_python-3.10.50 → tina4_python-3.10.55}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tina4-python
-Version: 3.10.50
+Version: 3.10.55
 Summary: Tina4 for Python — 54 built-in features, zero dependencies
 Author-email: Andre van Zuydam <andrevanzuydam@gmail.com>
 License: MIT

{tina4_python-3.10.50 → tina4_python-3.10.55}/tina4_python/__init__.py

@@ -8,13 +8,13 @@ Tina4 Python v3.0 — Zero-dependency, lightweight web framework.
 
 One import, everything works.
 """
-__version__ = "3.10.50"
+__version__ = "3.10.55"
 
 # ── Route decorators ──
 from tina4_python.core.router import (  # noqa: E402, F401
     get, post, put, patch, delete, any_method,
     noauth, secured, cached, middleware, template,
-    Router,
+    Router, RouteGroup,
 )
 
 # ── HTTP Constants ──

{tina4_python-3.10.50 → tina4_python-3.10.55}/tina4_python/cli/__init__.py

@@ -156,7 +156,7 @@ Usage: tina4python <command> [options]
 
 Commands:
   init [dir]                    Scaffold a new project
-  serve [--port P] [--no-browser]  Start dev server (default: 0.0.0.0:7146)
+  serve [--port P] [--no-browser] [--no-reload]  Start dev server (default: 0.0.0.0:7146)
   migrate                      Run pending database migrations
   migrate:create <desc>         Create a new migration file
   migrate:rollback              Rollback last migration batch
@@ -327,12 +327,15 @@ def _serve(args):
     if os.environ.get("TINA4_OPEN_BROWSER", "").lower() in ("false", "0", "no"):
         no_browser = True
 
+    # --no-reload flag
+    no_reload = "no-reload" in flags
+
     # Kill existing process on port
     port = cli_port or int(os.environ.get("PORT", os.environ.get("TINA4_PORT", "7146")))
     _kill_process_on_port(port)
 
     from tina4_python.core import run
-    run(host=cli_host, port=cli_port, no_browser=no_browser)
+    run(host=cli_host, port=cli_port, no_browser=no_browser, no_reload=no_reload)
 
 
 # ── Migrate ───────────────────────────────────────────────────────────

{tina4_python-3.10.50 → tina4_python-3.10.55}/tina4_python/core/router.py

@@ -57,6 +57,51 @@ class RouteRef:
         return self
 
 
+class RouteGroup:
+    """A group of routes sharing a common prefix and middleware.
+
+    Passed to the callback in Router.group(). Supports nesting.
+
+    Usage::
+
+        Router.group("/api", lambda group: [
+            group.get("/users", list_handler),
+            group.post("/users", create_handler),
+            group.group("/admin", lambda admin: [
+                admin.get("/stats", stats_handler),
+            ], middleware=[admin_check]),
+        ], middleware=[auth_check])
+    """
+
+    def __init__(self, router_cls, prefix: str, middleware: list = None):
+        self._router = router_cls
+        self._prefix = prefix
+        self._middleware = middleware or []
+
+    def get(self, path: str, handler, **options) -> RouteRef:
+        return self._router.add("GET", self._prefix + path, handler, middleware=self._middleware, **options)
+
+    def post(self, path: str, handler, **options) -> RouteRef:
+        return self._router.add("POST", self._prefix + path, handler, middleware=self._middleware, **options)
+
+    def put(self, path: str, handler, **options) -> RouteRef:
+        return self._router.add("PUT", self._prefix + path, handler, middleware=self._middleware, **options)
+
+    def patch(self, path: str, handler, **options) -> RouteRef:
+        return self._router.add("PATCH", self._prefix + path, handler, middleware=self._middleware, **options)
+
+    def delete(self, path: str, handler, **options) -> RouteRef:
+        return self._router.add("DELETE", self._prefix + path, handler, middleware=self._middleware, **options)
+
+    def any(self, path: str, handler, **options) -> RouteRef:
+        return self._router.add("ANY", self._prefix + path, handler, middleware=self._middleware, **options)
+
+    def group(self, prefix: str, callback, middleware=None):
+        merged = list(self._middleware) + (middleware or [])
+        nested = RouteGroup(self._router, self._prefix + prefix.rstrip("/"), merged)
+        callback(nested)
+
+
 class Router:
     """Route registry and matcher."""
 
@@ -68,14 +113,17 @@ class Router:
     def group(cls, prefix: str, callback, middleware=None):
         """Register routes with a shared prefix and optional middleware.
 
-        Saves/restores static prefix and middleware state around the
-        callback so that nested groups concatenate correctly.
+        The callback receives a RouteGroup object with get/post/put/patch/
+        delete/any/group methods for registering routes under the prefix.
 
         Usage::
 
-            Router.group("/api", lambda: [
-                Router.get("/users", handler),
-                Router.post("/users", handler),
+            Router.group("/api", lambda group: [
+                group.get("/users", list_handler),
+                group.post("/users", create_handler),
+                group.group("/admin", lambda admin: [
+                    admin.get("/stats", stats_handler),
+                ], middleware=[admin_check]),
             ], middleware=[auth_check])
         """
         prev_prefix = cls._group_prefix
@@ -85,7 +133,8 @@ class Router:
         cls._group_middleware = prev_middleware + (middleware or [])
 
         try:
-            callback()
+            group = RouteGroup(cls, cls._group_prefix, list(cls._group_middleware))
+            callback(group)
         finally:
             cls._group_prefix = prev_prefix
             cls._group_middleware = prev_middleware

{tina4_python-3.10.50 → tina4_python-3.10.55}/tina4_python/core/server.py

@@ -9,6 +9,7 @@ import os
 import sys
 import signal
 import asyncio
+import contextvars
 import importlib
 import uuid
 from pathlib import Path
@@ -25,6 +26,9 @@ _cors = CorsMiddleware()
 _rate_limiter = RateLimiter()
 
 
+# ContextVar to signal that the current request is being served on the AI dev port
+_ai_port_ctx: contextvars.ContextVar[bool] = contextvars.ContextVar("_ai_port_ctx", default=False)
+
 # Track startup time
 _start_time: float = 0
 
@@ -1222,7 +1226,7 @@ def resolve_config(cli_host: str | None = None, cli_port: int | None = None) ->
     return host, port
 
 
-def _print_banner(host: str, port: int, server_name: str = "asyncio"):
+def _print_banner(host: str, port: int, server_name: str = "asyncio", ai_port: int | None = None):
     """Print the Tina4 Slant ASCII banner to stdout (not through the logger)."""
     from tina4_python.dotenv import is_truthy
 
@@ -1234,6 +1238,8 @@ def _print_banner(host: str, port: int, server_name: str = "asyncio"):
     color = "\033[34m" if sys.stdout.isatty() else ""
     reset = "\033[0m" if sys.stdout.isatty() else ""
 
+    ai_port_line = f"\n  AI Port:   http://{display}:{ai_port} (no-reload)" if ai_port else ""
+
     banner = f"""{color}
   ______ _             __ __
  /_  __/(_)___  ____ _/ // /
@@ -1246,12 +1252,12 @@ def _print_banner(host: str, port: int, server_name: str = "asyncio"):
   Server:    http://{display}:{port} ({server_name})
   Swagger:   http://localhost:{port}/swagger
   Dashboard: http://localhost:{port}/__dev
-  Debug:     {"ON" if is_debug else "OFF"} (Log level: {log_level})
+  Debug:     {"ON" if is_debug else "OFF"} (Log level: {log_level}){ai_port_line}
 """
     print(banner)
 
 
-def run(host: str | None = None, port: int | None = None, no_browser: bool = False):
+def run(host: str | None = None, port: int | None = None, no_browser: bool = False, no_reload: bool = False):
     """Start the Tina4 dev server.
 
     Discovers routes from src/, starts ASGI server, handles shutdown.
@@ -1260,11 +1266,15 @@ def run(host: str | None = None, port: int | None = None, no_browser: bool = Fal
         host: Bind address. Falls back to HOST env var, then 0.0.0.0.
         port: Bind port. Falls back to PORT env var, then 7146.
         no_browser: If True, do not open browser on startup.
+        no_reload: If True, disable the file watcher / live-reload.
     """
     import time
     global _start_time
     _start_time = time.time()
 
+    if no_reload:
+        os.environ["TINA4_NO_RELOAD"] = "true"
+
     # Ensure CWD is on sys.path so auto-discovered modules can be imported
     cwd = os.getcwd()
     if cwd not in sys.path:
@@ -1302,11 +1312,13 @@ def run(host: str | None = None, port: int | None = None, no_browser: bool = Fal
 
     # Start DevReload file watcher in debug mode
     if is_debug:
-        try:
-            from tina4_python.dev_reload import start as _start_dev_reload
-            _start_dev_reload(["src", "public"])
-        except Exception as e:
-            Log.error(f"DevReload: failed to start: {e}")
+        no_reload = os.environ.get("TINA4_NO_RELOAD", "").lower() in ("true", "1", "yes")
+        if not no_reload:
+            try:
+                from tina4_python.dev_reload import start as _start_dev_reload
+                _start_dev_reload(["src", "public"])
+            except Exception as e:
+                Log.error(f"DevReload: failed to start: {e}")
 
     prod = None
     if not is_debug:
@@ -1314,11 +1326,17 @@ def run(host: str | None = None, port: int | None = None, no_browser: bool = Fal
 
     server_name = prod[0] if prod else "asyncio"
 
+    # Determine AI dev port (port+1) when debug is on and not suppressed
+    _no_ai_port = os.environ.get("TINA4_NO_AI_PORT", "").lower() in ("true", "1", "yes")
+    _ai_port = (port + 1) if (is_debug and not _no_ai_port) else None
+
     # Banner — printed directly to stdout, not through the logger
-    _print_banner(host, port, server_name)
+    _print_banner(host, port, server_name, ai_port=_ai_port)
 
     display = "localhost" if host in ("0.0.0.0", "::") else host
     Log.info(f"Server started http://{display}:{port} ({server_name})")
+    if _ai_port:
+        Log.info(f"AI dev port: http://{display}:{_ai_port} (no-reload)")
 
     # Open browser after a short delay (unless --no-browser)
     _skip_browser = no_browser or os.environ.get("TINA4_NO_BROWSER", "").lower() in ("true", "1", "yes")
@@ -1387,6 +1405,11 @@ def run(host: str | None = None, port: int | None = None, no_browser: bool = Fal
             # Check for WebSocket upgrade before reading body
             _header_dict = {k.decode(): v.decode() for k, v in headers}
             if _header_dict.get("upgrade", "").lower() == "websocket":
+                if hasattr(writer, "_tina4_ai_port") and path == "/__dev_reload":
+                    writer.write(b"HTTP/1.1 404 Not Found\r\nContent-Length: 0\r\n\r\n")
+                    await writer.drain()
+                    writer.close()
+                    return
                 await _handle_dev_websocket(reader, writer, _header_dict, path)
                 return
 
@@ -1441,6 +1464,19 @@ def run(host: str | None = None, port: int | None = None, no_browser: bool = Fal
 
         server = await start_server(_handle_connection, host, port)
 
+        # AI dev port (port + 1) — no-reload, no live-reload WebSocket
+        ai_server = None
+        if _ai_port:
+            try:
+                async def _handle_ai_connection(reader, writer):
+                    _ai_port_ctx.set(True)
+                    writer._tina4_ai_port = True
+                    await _handle_connection(reader, writer)
+
+                ai_server = await start_server(_handle_ai_connection, host, _ai_port)
+            except OSError:
+                Log.warning(f"AI port {_ai_port} in use — skipping")
+
         loop = asyncio.get_running_loop()
         for sig in (signal.SIGINT, signal.SIGTERM):
             try:
@@ -1449,6 +1485,9 @@ def run(host: str | None = None, port: int | None = None, no_browser: bool = Fal
                 pass  # Windows
 
         await shutdown.wait()
+        if ai_server:
+            ai_server.close()
+            await ai_server.wait_closed()
         server.close()
         await server.wait_closed()
         Log.info("Server stopped.")

{tina4_python-3.10.50 → tina4_python-3.10.55}/tina4_python/crud/__init__.py

@@ -15,7 +15,7 @@ Discovers ORM models and registers CRUD routes automatically.
 
 Generated endpoints per model:
 
-    GET    /api/{table_name}       — list with pagination (limit, skip)
+    GET    /api/{table_name}       — list with pagination (limit, offset; also accepts page, per_page)
     GET    /api/{table_name}/{id}  — get single record by primary key
     POST   /api/{table_name}       — create new record
     PUT    /api/{table_name}/{id}  — update record by primary key
@@ -94,18 +94,37 @@ class AutoCrud:
         # ── GET /api/{table} — list with pagination ──────────────
         async def list_handler(request, response, _cls=model_class):
             try:
-                limit = int(request.params.get("limit", 10))
-                skip = int(request.params.get("skip", 0))
+                # Primary names: limit / offset
+                # Compat names: per_page / page (PHP/Ruby/Node style)
+                limit = int(request.params.get("limit", request.params.get("per_page", 10)))
+                offset = int(request.params.get("offset", 0))
+                # page/per_page compat: if page is provided, derive offset from it
+                if "page" in request.params and "offset" not in request.params:
+                    page = int(request.params.get("page", 1))
+                    per_page = int(request.params.get("per_page", limit))
+                    offset = (page - 1) * per_page
+                    limit = per_page
+                else:
+                    page = (offset // limit) + 1 if limit else 1
             except (ValueError, TypeError):
                 limit = 10
-                skip = 0
+                offset = 0
+                page = 1
 
-            records, total = _cls.all(limit=limit, skip=skip)
+            records, total = _cls.all(limit=limit, skip=offset)
+            total_pages = max(1, -(-total // limit)) if limit else 1
+            data = [r.to_dict() for r in records]
             return response({
-                "data": [r.to_dict() for r in records],
-                "total": total,
+                "records": data,       # standard name
+                "data": data,          # backwards compat
+                "count": total,        # standard name
+                "total": total,        # backwards compat
                 "limit": limit,
-                "skip": skip,
+                "offset": offset,
+                "page": page,
+                "per_page": limit,     # backwards compat
+                "totalPages": total_pages,   # camelCase standard
+                "total_pages": total_pages,  # backwards compat
             })
 
         list_handler.__name__ = f"autocrud_list_{table}"

{tina4_python-3.10.50 → tina4_python-3.10.55}/tina4_python/database/adapter.py

@@ -33,16 +33,19 @@ class DatabaseResult:
 
     def to_paginate(self, page: int = 1, per_page: int = 20) -> dict:
         total_pages = max(1, -(-self.count // per_page))  # ceil division
-        start = (page - 1) * per_page
-        end = start + per_page
+        offset = (page - 1) * per_page
+        data = self.records[offset:offset + per_page]
         return {
-            "data": self.records[start:end],
-            "total": self.count,
+            "records": data,        # standard name
+            "data": data,           # backwards compat (PHP/Ruby/Node)
+            "count": self.count,    # standard name
+            "total": self.count,    # backwards compat
+            "limit": per_page,      # standard name
+            "offset": offset,       # standard name
             "page": page,
-            "per_page": per_page,
-            "total_pages": total_pages,
-            "has_next": page < total_pages,
-            "has_prev": page > 1,
+            "per_page": per_page,   # backwards compat
+            "totalPages": total_pages,   # camelCase standard
+            "total_pages": total_pages,  # backwards compat
         }
 
     def column_info(self) -> list[dict]:

{tina4_python-3.10.50 → tina4_python-3.10.55}/tina4_python/database/connection.py

@@ -123,6 +123,14 @@ register_driver("sqlserver", MSSQLAdapter)
 from tina4_python.database.firebird import FirebirdAdapter
 register_driver("firebird", FirebirdAdapter)
 
+# Register MongoDB (pymongo — optional)
+try:
+    from tina4_python.database.mongodb import MongoDBAdapter
+    register_driver("mongodb", MongoDBAdapter)
+    register_driver("pymongo", MongoDBAdapter)
+except ImportError:
+    pass
+
 
 class Database:
     """Database connection manager.

{tina4_python-3.10.50 → tina4_python-3.10.55}/tina4_python/database/firebird.py

@@ -49,7 +49,7 @@ class FirebirdAdapter(DatabaseAdapter):
         host = parsed.hostname or "localhost"
         port = parsed.port or 3050
         # Firebird database path — decode URL-encoded characters
-        db_path = unquote(parsed.path.lstrip("/")) if parsed.path else ""
+        db_path = unquote(parsed.path[1:]) if parsed.path.startswith("/") else unquote(parsed.path)
         user = parsed.username or username or "SYSDBA"
         password = parsed.password or password or "masterkey"
         charset = kwargs.pop("charset", "UTF8")