tina4-python 3.10.97__tar.gz → 3.11.0__tar.gz

{tina4_python-3.10.97 → tina4_python-3.11.0}/.gitignore

@@ -61,5 +61,16 @@ __pycache__/
 build/
 .pytest_cache/
 example/.env
+example/data/*.db
+example/data/*.db-*
+example/store/data/*.db
+example/store/data/*.db-*
+example/store/data/broken/
+example/store/data/.broken/
+example/store/data/mailbox/
+example/store/data/sessions/
+example/store/.tina4/
+example/store/__pycache__/
+example/store/src/**/__pycache__/
 .claude/settings.local.json
 .claude/worktrees/

{tina4_python-3.10.97 → tina4_python-3.11.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tina4-python
-Version: 3.10.97
+Version: 3.11.0
 Summary: Tina4 for Python — 54 built-in features, zero dependencies
 Author-email: Andre van Zuydam <andrevanzuydam@gmail.com>
 License: MIT
@@ -749,6 +749,28 @@ Tina4 ships identical features across four languages — same architecture, same
 
 ---
 
+## Demo Store
+
+A complete e-commerce app lives in `example/`. It demonstrates every framework feature through a real-world use case.
+
+```bash
+cd example
+bash setup.sh          # macOS/Linux
+# or: setup.bat        # Windows
+.venv/bin/python app.py
+```
+
+Open http://localhost:7146
+
+| Role | Email | Password |
+|------|-------|----------|
+| Admin | admin@tina4store.com | admin123 |
+| Customer | alice@example.com | customer123 |
+
+See [`example/README.md`](example/README.md) for full details.
+
+---
+
 ## Documentation
 
 Full guides, API reference, and examples at **[tina4.com](https://tina4.com)**.

{tina4_python-3.10.97 → tina4_python-3.11.0}/README.md

@@ -717,6 +717,28 @@ Tina4 ships identical features across four languages — same architecture, same
 
 ---
 
+## Demo Store
+
+A complete e-commerce app lives in `example/`. It demonstrates every framework feature through a real-world use case.
+
+```bash
+cd example
+bash setup.sh          # macOS/Linux
+# or: setup.bat        # Windows
+.venv/bin/python app.py
+```
+
+Open http://localhost:7146
+
+| Role | Email | Password |
+|------|-------|----------|
+| Admin | admin@tina4store.com | admin123 |
+| Customer | alice@example.com | customer123 |
+
+See [`example/README.md`](example/README.md) for full details.
+
+---
+
 ## Documentation
 
 Full guides, API reference, and examples at **[tina4.com](https://tina4.com)**.

{tina4_python-3.10.97 → tina4_python-3.11.0}/tina4_python/CLAUDE.md

@@ -245,6 +245,7 @@ Tina4 provides a full toolkit. Before writing custom code, check if the framewor
 | Dependency injection | `Container` from `tina4_python.container` |
 | Structured logging | `Log` from `tina4_python.debug` |
 | Error overlay (dev) | `render_error_overlay`, `is_debug_mode` from `tina4_python.debug.error_overlay` |
+| Periodic background work | `background()` from `tina4_python.core.server` |
 
 **Bad — writing a custom queue:**
 ```python
@@ -289,6 +290,7 @@ Queue(topic="tasks").push({"action": "send_email"})
 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: `DATABASE_URL`.
 7. **Running the app**: `uv run python app.py <port> <name>` — port and name are CLI args handled by tina4_python
 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.10.97 → tina4_python-3.11.0}/tina4_python/__init__.py

@@ -8,7 +8,7 @@ Tina4 Python v3.0 — Zero-dependency, lightweight web framework.
 
 One import, everything works.
 """
-__version__ = "3.10.97"
+__version__ = "3.11.0"
 
 # ── Route decorators ──
 from tina4_python.core.router import (  # noqa: E402, F401
@@ -60,4 +60,4 @@ from tina4_python.cache import (  # noqa: E402, F401
 from tina4_python.container import Container  # noqa: E402, F401
 
 # ── Server ──
-from tina4_python.core.server import run  # noqa: E402, F401
+from tina4_python.core.server import run, background  # noqa: E402, F401

{tina4_python-3.10.97 → tina4_python-3.11.0}/tina4_python/core/server.py

@@ -32,6 +32,21 @@ _ai_port_ctx: contextvars.ContextVar[bool] = contextvars.ContextVar("_ai_port_ct
 # Track startup time
 _start_time: float = 0
 
+# ── Background tasks registry ────────────────────────────────────────────
+_background_tasks: list[dict] = []
+
+
+def background(callback, interval: float = 1.0):
+    """Register a background task that runs periodically in the server event loop.
+
+    Matches PHP's $app->background(fn, interval) pattern.
+
+    Args:
+        callback: Function to call (sync or async, no arguments).
+        interval: Seconds between invocations (default: 1.0).
+    """
+    _background_tasks.append({"callback": callback, "interval": interval})
+
 
 def _auto_discover(root_dir: str = "src"):
     """Auto-import all .py files in src/ to trigger route decorators."""
@@ -1812,7 +1827,48 @@ def run(host: str | None = None, port: int | None = None, no_browser: bool = Fal
             except NotImplementedError:
                 pass  # Windows
 
+        # Start registered background tasks as asyncio tasks.
+        # Sync callbacks run in a thread pool so they CANNOT block the event loop.
+        # A timeout (2x interval, min 5s) cancels runaway tasks.
+        import concurrent.futures
+        _executor = concurrent.futures.ThreadPoolExecutor(
+            max_workers=max(len(_background_tasks), 2),
+            thread_name_prefix="tina4_bg",
+        )
+        bg_tasks = []
+        for task_def in _background_tasks:
+            cb = task_def["callback"]
+            iv = task_def["interval"]
+
+            async def _tick_loop(_cb=cb, _iv=iv):
+                timeout = max(_iv * 2, 5.0)
+                while not shutdown.is_set():
+                    try:
+                        if asyncio.iscoroutinefunction(_cb):
+                            await asyncio.wait_for(_cb(), timeout=timeout)
+                        else:
+                            # Run sync callback in thread pool — never blocks the event loop
+                            await asyncio.wait_for(
+                                loop.run_in_executor(_executor, _cb),
+                                timeout=timeout,
+                            )
+                    except asyncio.TimeoutError:
+                        Log.warning(
+                            f"Background task exceeded {timeout:.1f}s timeout and was interrupted. "
+                            f"Use non-blocking calls (e.g. queue.pop() instead of queue.consume())."
+                        )
+                    except Exception as e:
+                        Log.error(f"Background task error: {e}")
+                    await asyncio.sleep(_iv)
+
+            bg_tasks.append(asyncio.create_task(_tick_loop()))
+
         await shutdown.wait()
+
+        # Cancel background tasks
+        for t in bg_tasks:
+            t.cancel()
+
         if ai_server:
             ai_server.close()
             await ai_server.wait_closed()

{tina4_python-3.10.97 → tina4_python-3.11.0}/tina4_python/frond/engine.py

@@ -914,8 +914,40 @@ def _parse_filter_chain(expr: str) -> tuple[str, list[tuple[str, list[str]]]]:
     return variable, filters
 
 
-def _parse_args(raw: str) -> list[str]:
-    """Parse filter arguments, respecting quoted strings and backslash escapes."""
+def _coerce_arg(s: str):
+    """Try to convert a string argument to a Python object (dict, list, number, bool).
+
+    Returns the original string unchanged if no conversion applies.
+    """
+    if s.startswith("{") and s.endswith("}"):
+        try:
+            return json.loads(s)
+        except Exception:
+            pass
+    if s.startswith("[") and s.endswith("]"):
+        try:
+            return json.loads(s)
+        except Exception:
+            pass
+    if s in ("true", "True"):
+        return True
+    if s in ("false", "False"):
+        return False
+    if s in ("null", "None", "none"):
+        return None
+    try:
+        return int(s)
+    except (ValueError, TypeError):
+        pass
+    try:
+        return float(s)
+    except (ValueError, TypeError):
+        pass
+    return s
+
+
+def _parse_args(raw: str) -> list:
+    """Parse filter arguments, respecting quoted strings, braces, and backslash escapes."""
     args = []
     current = ""
     in_quote = None
@@ -926,9 +958,9 @@ def _parse_args(raw: str) -> list[str]:
             in_quote = ch
         elif ch == in_quote:
             in_quote = None
-        elif ch == "(" and not in_quote:
+        elif ch in ("(", "{", "[") and not in_quote:
             depth += 1
-        elif ch == ")" and not in_quote:
+        elif ch in (")", "}", "]") and not in_quote:
             depth -= 1
         elif ch == "," and not in_quote and depth == 0:
             args.append(_strip_outer_quotes(current.strip()))
@@ -939,7 +971,7 @@ def _parse_args(raw: str) -> list[str]:
     if current.strip():
         args.append(_strip_outer_quotes(current.strip()))
 
-    return args
+    return [_coerce_arg(a) for a in args]
 
 
 def _strip_outer_quotes(s: str) -> str:
@@ -964,6 +996,13 @@ def _strip_outer_quotes(s: str) -> str:
     return s
 
 
+def _dict_replace(s: str, mapping: dict) -> str:
+    """Apply multiple replacements from a dict (Twig-style replace filter)."""
+    for old, new in mapping.items():
+        s = s.replace(str(old), str(new))
+    return s
+
+
 # Built-in filters
 _BUILTIN_FILTERS = {
     "upper": lambda v, *a: str(v).upper(),
@@ -981,7 +1020,11 @@ _BUILTIN_FILTERS = {
     "last": lambda v, *a: v[-1] if v else None,
     "join": lambda v, *a: (a[0] if a else ", ").join(str(i) for i in v) if isinstance(v, list) else str(v),
     "split": lambda v, *a: str(v).split(a[0] if a else " "),
-    "replace": lambda v, *a: str(v).replace(a[0], a[1]) if len(a) >= 2 else str(v),
+    "replace": lambda v, *a: (
+        _dict_replace(str(v), a[0]) if len(a) == 1 and isinstance(a[0], dict)
+        else str(v).replace(a[0], a[1]) if len(a) >= 2
+        else str(v)
+    ),
     "default": lambda v, *a: v if v is not None and v != "" else (a[0] if a else ""),
     "raw": lambda v, *a: v,  # Mark as safe (no escaping)
     "safe": lambda v, *a: v,

{tina4_python-3.10.97 → tina4_python-3.11.0}/tina4_python/orm/model.py

@@ -168,7 +168,7 @@ class ORM(metaclass=ORMMeta):
     table_name: str = ""
     soft_delete: bool = False  # Set True to enable soft delete
     field_mapping: dict[str, str] = {}  # {"python_attribute": "db_column"}
-    auto_map: bool = False  # No-op in Python (snake_case matches DB); exists for cross-language parity
+    auto_map: bool = True  # No-op in Python (snake_case matches DB); exists for cross-language parity
     auto_crud: bool = False  # Set True to auto-register CRUD routes
     _db: str | object | None = None  # Per-model database override
     _fields: dict[str, Field] = {}
@@ -933,14 +933,18 @@ class ORM(metaclass=ORMMeta):
 
     # ── Serialization ───────────────────────────────────────────
 
-    def to_dict(self, include: list[str] = None) -> dict:
+    def to_dict(self, include: list[str] = None, case: str = "snake") -> dict:
         """Convert to dict (field values only, optionally with relationships).
 
         Args:
             include: List of relationship names to include. Supports dot notation
                      for nested relationships (e.g., ["posts.comments"]).
+            case: Key casing — 'snake' (default for Python), 'camel' (matches PHP).
         """
-        result = {name: getattr(self, name) for name in self._fields}
+        if case == "camel":
+            result = {snake_to_camel(name): getattr(self, name) for name in self._fields}
+        else:
+            result = {name: getattr(self, name) for name in self._fields}
 
         if include:
             # Group includes: top-level and nested
@@ -957,27 +961,28 @@ class ORM(metaclass=ORMMeta):
                 if rel_name in self._relationships:
                     # Access the relationship (triggers lazy load if not cached)
                     related = getattr(self, rel_name)
+                    key = snake_to_camel(rel_name) if case == "camel" else rel_name
                     if related is None:
-                        result[rel_name] = None
+                        result[key] = None
                     elif isinstance(related, list):
-                        result[rel_name] = [
-                            r.to_dict(include=nested if nested else None)
+                        result[key] = [
+                            r.to_dict(include=nested if nested else None, case=case)
                             for r in related
                         ]
                     else:
-                        result[rel_name] = related.to_dict(
-                            include=nested if nested else None
+                        result[key] = related.to_dict(
+                            include=nested if nested else None, case=case
                         )
 
         return result
 
-    def to_assoc(self, include: list[str] = None) -> dict:
+    def to_assoc(self, include: list[str] = None, case: str = "snake") -> dict:
         """Convert to an associative dict (alias for to_dict)."""
-        return self.to_dict(include=include)
+        return self.to_dict(include=include, case=case)
 
-    def to_object(self) -> dict:
+    def to_object(self, case: str = "snake") -> dict:
         """Convert to an object/dict (alias for to_dict)."""
-        return self.to_dict()
+        return self.to_dict(case=case)
 
     def to_array(self) -> list:
         """Convert to a list of values."""

{tina4_python-3.10.97 → tina4_python-3.11.0}/tina4_python/scss/__init__.py

@@ -62,10 +62,15 @@ def compile_scss(scss_dir: str = "src/scss", output: str = "public/css/default.c
     if minify:
         css = _minify(css)
 
-    # Write output
+    # Write output only if content changed (avoids triggering DevReload loops)
     out_path = Path(output)
     out_path.parent.mkdir(parents=True, exist_ok=True)
-    out_path.write_text(css, encoding="utf-8")
+    try:
+        existing = out_path.read_text(encoding="utf-8")
+    except (FileNotFoundError, OSError):
+        existing = None
+    if existing != css:
+        out_path.write_text(css, encoding="utf-8")
 
     return css