tina4-python 3.10.34__tar.gz → 3.10.39__tar.gz

{tina4_python-3.10.34 → tina4_python-3.10.39}/.gitignore

@@ -60,9 +60,6 @@ __pycache__/
 *.so
 build/
 .pytest_cache/
-demo/.env
 example/.env
-demo/data/*.db
-demo/logs/*.log
 .claude/settings.local.json
 .claude/worktrees/

{tina4_python-3.10.34 → tina4_python-3.10.39}/PKG-INFO

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

{tina4_python-3.10.34 → tina4_python-3.10.39}/pyproject.toml

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

{tina4_python-3.10.34 → tina4_python-3.10.39}/tina4_python/__init__.py

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

tina4_python-3.10.39/tina4_python/ai/__init__.py

@@ -0,0 +1,312 @@
+# Tina4 AI — Install AI coding assistant context files.
+"""
+Simple menu-driven installer for AI tool context files.
+The user picks which tools they use, we install the appropriate files.
+
+    from tina4_python.ai import show_menu, install_selected
+"""
+import os
+import shutil
+import subprocess
+from pathlib import Path
+
+
+# Ordered list of supported AI tools
+AI_TOOLS = [
+    {"name": "claude-code", "description": "Claude Code", "context_file": "CLAUDE.md", "config_dir": ".claude"},
+    {"name": "cursor", "description": "Cursor", "context_file": ".cursorules", "config_dir": ".cursor"},
+    {"name": "copilot", "description": "GitHub Copilot", "context_file": ".github/copilot-instructions.md", "config_dir": ".github"},
+    {"name": "windsurf", "description": "Windsurf", "context_file": ".windsurfrules", "config_dir": None},
+    {"name": "aider", "description": "Aider", "context_file": "CONVENTIONS.md", "config_dir": None},
+    {"name": "cline", "description": "Cline", "context_file": ".clinerules", "config_dir": None},
+    {"name": "codex", "description": "OpenAI Codex", "context_file": "AGENTS.md", "config_dir": None},
+]
+
+
+def is_installed(root: str, tool: dict) -> bool:
+    """Check if a tool's context file already exists."""
+    return (Path(root).resolve() / tool["context_file"]).exists()
+
+
+def show_menu(root: str = ".") -> str:
+    """Print the numbered menu and return user input."""
+    root = str(Path(root).resolve())
+    green = "\033[32m"
+    reset = "\033[0m"
+
+    print("\n  Tina4 AI Context Installer\n")
+    for i, tool in enumerate(AI_TOOLS, 1):
+        installed = is_installed(root, tool)
+        marker = f"  {green}[installed]{reset}" if installed else ""
+        print(f"  {i}. {tool['description']:<20s} {tool['context_file']}{marker}")
+
+    # tina4-ai tools option
+    tina4_ai_installed = shutil.which("mdview") is not None
+    marker = f"  {green}[installed]{reset}" if tina4_ai_installed else ""
+    print(f"  8. Install tina4-ai tools  (requires Python){marker}")
+    print()
+    return input("  Select (comma-separated, or 'all'): ").strip()
+
+
+def install_selected(root: str, selection: str) -> list[str]:
+    """Install context files for the selected tools.
+
+    selection: comma-separated numbers like "1,2,3" or "all"
+    Returns list of created/updated file paths.
+    """
+    root_path = Path(root).resolve()
+    created = []
+
+    if selection.lower() == "all":
+        indices = list(range(len(AI_TOOLS)))
+        install_tina4_ai = True
+    else:
+        parts = [s.strip() for s in selection.split(",") if s.strip()]
+        indices = []
+        install_tina4_ai = False
+        for p in parts:
+            try:
+                n = int(p)
+                if n == 8:
+                    install_tina4_ai = True
+                elif 1 <= n <= len(AI_TOOLS):
+                    indices.append(n - 1)
+            except ValueError:
+                pass
+
+    context = generate_context()
+
+    for idx in indices:
+        tool = AI_TOOLS[idx]
+        files = _install_for_tool(root_path, tool, context)
+        created.extend(files)
+
+    if install_tina4_ai:
+        _install_tina4_ai()
+
+    return created
+
+
+def install_all(root: str = ".") -> list[str]:
+    """Install context for all AI tools (non-interactive)."""
+    return install_selected(root, "all")
+
+
+def _install_for_tool(root: Path, tool: dict, context: str) -> list[str]:
+    """Install context file for a single tool."""
+    created = []
+    context_path = root / tool["context_file"]
+
+    # Create directories
+    if tool.get("config_dir"):
+        (root / tool["config_dir"]).mkdir(parents=True, exist_ok=True)
+    context_path.parent.mkdir(parents=True, exist_ok=True)
+
+    # Always overwrite — user chose to install
+    context_path.write_text(context, encoding="utf-8")
+    action = "Updated" if context_path.exists() else "Installed"
+    rel = str(context_path.relative_to(root))
+    created.append(rel)
+    print(f"  \033[32m✓\033[0m {action} {rel}")
+
+    # Claude-specific extras
+    if tool["name"] == "claude-code":
+        skills = _install_claude_skills(root)
+        created.extend(skills)
+
+    return created
+
+
+def _install_tina4_ai():
+    """Install tina4-ai package (provides mdview for markdown viewing)."""
+    print("  Installing tina4-ai tools...")
+    for cmd in ["pip3", "pip"]:
+        if shutil.which(cmd):
+            try:
+                result = subprocess.run(
+                    [cmd, "install", "--upgrade", "tina4-ai"],
+                    capture_output=True, text=True, timeout=60,
+                )
+                if result.returncode == 0:
+                    print("  \033[32m✓\033[0m Installed tina4-ai (mdview)")
+                    return
+                else:
+                    print(f"  \033[33m!\033[0m {cmd} failed: {result.stderr.strip()[:100]}")
+            except (subprocess.TimeoutExpired, OSError):
+                continue
+    print("  \033[33m!\033[0m Python/pip not available — skip tina4-ai")
+
+
+def _install_claude_skills(root: Path) -> list[str]:
+    """Copy Claude Code skill files from the framework's templates."""
+    created = []
+    commands_dir = root / ".claude" / "commands"
+    commands_dir.mkdir(parents=True, exist_ok=True)
+
+    pkg_dir = Path(__file__).parent.parent
+    source_dirs = [pkg_dir / "templates" / "ai" / "claude-commands"]
+
+    for source_dir in source_dirs:
+        if source_dir.is_dir():
+            for skill_file in source_dir.glob("*.md"):
+                target = commands_dir / skill_file.name
+                target.write_text(skill_file.read_text(encoding="utf-8"), encoding="utf-8")
+                rel = str(target.relative_to(root))
+                created.append(rel)
+
+    # Copy skill directories from framework .claude/skills/
+    framework_root = pkg_dir.parent
+    framework_skills_dir = framework_root / ".claude" / "skills"
+    if framework_skills_dir.is_dir():
+        target_skills_dir = root / ".claude" / "skills"
+        target_skills_dir.mkdir(parents=True, exist_ok=True)
+        for skill_dir in framework_skills_dir.iterdir():
+            if skill_dir.is_dir():
+                target_dir = target_skills_dir / skill_dir.name
+                if target_dir.exists():
+                    shutil.rmtree(target_dir)
+                shutil.copytree(skill_dir, target_dir)
+                rel = str(target_dir.relative_to(root))
+                created.append(rel)
+                print(f"  \033[32m✓\033[0m Updated {rel}")
+
+    return created
+
+
+def generate_context() -> str:
+    """Generate the universal Tina4 context document for any AI assistant."""
+    return f"""# Tina4 Python — AI Context
+
+This project uses **Tina4 Python**, a lightweight, batteries-included web framework
+with zero third-party dependencies for core features.
+
+**Documentation:** https://tina4.com
+
+## Quick Start
+
+```bash
+tina4python init .          # Scaffold project
+tina4python serve           # Start dev server on port 7145
+tina4python migrate         # Run database migrations
+tina4python test            # Run test suite
+tina4python routes          # List all registered routes
+```
+
+## Project Structure
+
+```
+src/routes/       — Route handlers (auto-discovered, one per resource)
+src/orm/          — ORM models (one per file, filename = class name)
+src/templates/    — Twig/Jinja2 templates (extends base.twig)
+src/app/          — Shared helpers and service classes
+src/scss/         — SCSS files (auto-compiled to public/css/)
+src/public/       — Static assets served at /
+src/locales/      — Translation JSON files
+src/seeds/        — Database seeder scripts
+migrations/       — SQL migration files (sequential numbered)
+tests/            — pytest test files
+```
+
+## Built-in Features (No External Packages Needed)
+
+| Feature | Module | Import |
+|---------|--------|--------|
+| Routing | router | `from tina4_python.core.router import get, post, put, delete` |
+| ORM | orm | `from tina4_python.orm import ORM, IntegerField, StringField` |
+| Database | database | `from tina4_python.database import Database` |
+| Templates | template | `response.render("page.twig", data)` |
+| JWT Auth | auth | `from tina4_python.auth import Auth, hash_password, check_password` |
+| REST API Client | api | `from tina4_python.api import Api` |
+| GraphQL | graphql | `from tina4_python.graphql import GraphQL, Schema` |
+| WebSocket | websocket | `from tina4_python.websocket import WebSocketServer` |
+| SOAP/WSDL | wsdl | `from tina4_python.wsdl import WSDL, wsdl_operation` |
+| Email (SMTP+IMAP) | messenger | `from tina4_python.messenger import Messenger` |
+| Background Queue | queue | `from tina4_python.queue import Queue` |
+| SCSS Compilation | scss | Auto-compiled from src/scss/ |
+| Migrations | migration | `tina4python migrate` CLI command |
+| Seeder | seeder | `from tina4_python.seeder import FakeData, seed_table` |
+| i18n | localization | `from tina4_python.localization import Localization` |
+| Swagger/OpenAPI | swagger | Auto-generated at /swagger |
+| Sessions | session | `request.session.get(key)` / `.set(key, value)` |
+| Middleware | middleware | `@middleware(MyMiddleware)` decorator |
+| HTML Builder | html_element | `from tina4_python.html_element import HTMLElement` |
+| Form Tokens | template | `{{{{ form_token() }}}}` in Twig |
+
+## Key Conventions
+
+1. **Routes return `response()`** — always use `response(data)` not `response.json()`
+2. **GET routes are public**, POST/PUT/PATCH/DELETE require auth by default
+3. **Use `@noauth()`** to make write routes public, `@secured()` to protect GET routes
+4. **Decorator order**: `@noauth/@secured` → `@description/@tags` → `@get/@post` (route decorator innermost)
+5. **Every template extends `base.twig`** — no standalone HTML pages
+6. **No inline styles** — use SCSS in `src/scss/` with CSS variables
+7. **No hardcoded colors** — use `var(--primary)`, `var(--text)`, etc.
+8. **All schema changes via migrations** — never create tables in route code
+9. **Service pattern** — complex logic goes in `src/app/` service classes, routes stay thin
+10. **Use built-in features** — never install packages for things Tina4 already provides
+
+## AI Workflow — Available Skills
+
+When using an AI coding assistant with Tina4, these skills are available:
+
+| Skill | Description |
+|-------|-------------|
+| `/tina4-route` | Create a new route with proper decorators and auth |
+| `/tina4-orm` | Create an ORM model with migration |
+| `/tina4-crud` | Generate complete CRUD (migration, ORM, routes, template, tests) |
+| `/tina4-auth` | Set up JWT authentication with login/register |
+| `/tina4-api` | Create an external API integration |
+| `/tina4-queue` | Set up background job processing |
+| `/tina4-template` | Create a server-rendered template page |
+| `/tina4-graphql` | Set up a GraphQL endpoint |
+| `/tina4-websocket` | Set up WebSocket communication |
+| `/tina4-wsdl` | Create a SOAP/WSDL service |
+| `/tina4-messenger` | Set up email send/receive |
+| `/tina4-test` | Write tests for a feature |
+| `/tina4-migration` | Create a database migration |
+| `/tina4-seed` | Generate fake data for development |
+| `/tina4-i18n` | Set up internationalization |
+| `/tina4-scss` | Set up SCSS stylesheets |
+| `/tina4-frontend` | Set up a frontend framework |
+
+## Common Patterns
+
+### Route
+```python
+from tina4_python.core.router import get, post, noauth
+from tina4_python.swagger import description, tags
+
+@noauth()
+@description("Create a widget")
+@tags(["widgets"])
+@post("/api/widgets")
+async def create_widget(request, response):
+    data = request.body
+    return response({{"created": True}}, 201)
+```
+
+### ORM Model
+```python
+from tina4_python.orm import ORM, IntegerField, StringField
+
+class Widget(ORM):
+    id = IntegerField(primary_key=True, auto_increment=True)
+    name = StringField()
+```
+
+### Template
+```twig
+{{% extends "base.twig" %}}
+{{% block content %}}
+<div class="container">
+    <h1>{{{{ title }}}}</h1>
+    {{% for item in items %}}
+        <p>{{{{ item.name }}}}</p>
+    {{% endfor %}}
+</div>
+{{% endblock %}}
+```
+"""
+
+
+__all__ = ["AI_TOOLS", "is_installed", "show_menu", "install_selected", "install_all", "generate_context"]

{tina4_python-3.10.34 → tina4_python-3.10.39}/tina4_python/auth/__init__.py

@@ -14,7 +14,7 @@ No PyJWT, no cryptography package.
     payload = auth.valid_token(token)
 
     hashed = Auth.hash_password("secret123")
-    Auth.check_password(hashed, "secret123")  # True
+    Auth.check_password("secret123", hashed)  # True
 """
 import os
 import hmac
@@ -152,6 +152,25 @@ class Auth:
         auth = cls(secret=secret, expires_in=expires_in)
         return auth.refresh_token(token)
 
+    @classmethod
+    def authenticate_request_static(cls, headers: dict) -> dict | None:
+        """Extract and validate auth from request headers without instantiating Auth.
+
+        Reads SECRET from env. Checks: Bearer JWT, Bearer API key, Basic auth.
+        Returns payload dict on success, None on failure.
+        """
+        secret = os.environ.get("SECRET", "tina4-default-secret")
+        auth = cls(secret=secret)
+        return auth.authenticate_request(headers)
+
+    @staticmethod
+    def validate_api_key_static(provided: str, expected: str = None) -> bool:
+        """Validate an API key without instantiating Auth.
+
+        Alias for validate_api_key (already a staticmethod).
+        """
+        return Auth.validate_api_key(provided, expected)
+
     # ── Password Hashing ──────────────────────────────────────────
 
     @staticmethod
@@ -164,7 +183,7 @@ class Auth:
         return f"pbkdf2_sha256${iterations}${salt}${dk.hex()}"
 
     @staticmethod
-    def check_password(hashed: str, password: str) -> bool:
+    def check_password(password: str, hashed: str) -> bool:
         """Verify a password against its PBKDF2 hash."""
         try:
             parts = hashed.split("$")
@@ -183,9 +202,18 @@ class Auth:
     # ── API Key Auth ──────────────────────────────────────────────
 
     @staticmethod
-    def validate_api_key(provided: str) -> bool:
-        """Check a Bearer token against the TINA4_API_KEY env var (falls back to API_KEY)."""
-        expected = os.environ.get("TINA4_API_KEY", os.environ.get("API_KEY", ""))
+    def validate_api_key(provided: str, expected: str = None) -> bool:
+        """Check an API key against an expected value.
+
+        Args:
+            provided: The API key provided in the request.
+            expected: The expected API key. If None, reads from
+                      TINA4_API_KEY env var (falls back to API_KEY).
+
+        Returns: True if the provided key matches.
+        """
+        if expected is None:
+            expected = os.environ.get("TINA4_API_KEY", os.environ.get("API_KEY", ""))
         if not expected:
             return False
         return hmac.compare_digest(provided, expected)
@@ -255,4 +283,17 @@ def refresh_token(token: str, expires_in: int = 60) -> str | None:
     return Auth.refresh_token_static(token, expires_in=expires_in)
 
 
-__all__ = ["Auth", "get_token", "valid_token", "get_payload", "refresh_token"]
+def authenticate_request(headers: dict) -> dict | None:
+    """Validate auth from request headers — reads SECRET from env."""
+    return Auth.authenticate_request_static(headers)
+
+
+def validate_api_key(provided: str, expected: str = None) -> bool:
+    """Validate an API key. Shortcut for Auth.validate_api_key()."""
+    return Auth.validate_api_key(provided, expected)
+
+
+__all__ = [
+    "Auth", "get_token", "valid_token", "get_payload", "refresh_token",
+    "authenticate_request", "validate_api_key",
+]

{tina4_python-3.10.34 → tina4_python-3.10.39}/tina4_python/cli/__init__.py

@@ -363,7 +363,7 @@ def _routes(args):
         importlib.import_module("app")
 
     from tina4_python.core.router import Router
-    routes = Router.all()
+    routes = Router.get_routes()
     if not routes:
         print("No routes registered.")
         return
@@ -405,42 +405,19 @@ def _build(args):
 
 
 def _ai(args):
-    """Detect AI coding tools and install Tina4 context."""
-    from tina4_python.ai import detect_ai, install_context, install_all, status_report
+    """Install AI coding assistant context files."""
+    from tina4_python.ai import show_menu, install_selected, install_all
 
     root = "."
 
-    if "--all" in args:
-        # Install context for ALL known AI tools
-        created = install_all(root, force="--force" in args)
-        if created:
-            print("Installed Tina4 context for all AI tools:")
-            for f in created:
-                print(f"  + {f}")
-        else:
-            print("All AI context files already exist. Use --force to overwrite.")
-    elif "--status" in args or not args:
-        # Show detection status
-        print(status_report(root))
-
-        # Auto-install for detected tools
-        detected = [t for t in detect_ai(root) if t["installed"]]
-        if detected:
-            created = install_context(root)
-            if created:
-                print("Installed Tina4 context:")
-                for f in created:
-                    print(f"  + {f}")
-            else:
-                print("Context files already exist. Use --force to overwrite.")
+    if args and args[0].lower() == "all":
+        # Non-interactive: install everything
+        install_all(root)
     else:
-        # Install for specific tool(s)
-        created = install_context(root, tools=args, force="--force" in args)
-        if created:
-            for f in created:
-                print(f"  + {f}")
-        else:
-            print("Nothing to install.")
+        # Interactive: show menu, get selection
+        selection = show_menu(root)
+        if selection:
+            install_selected(root, selection)
 
 
 def _generate(args):

{tina4_python-3.10.34 → tina4_python-3.10.39}/tina4_python/core/router.py

@@ -231,8 +231,13 @@ class Router:
         return None, {}
 
     @staticmethod
-    def all() -> list[dict]:
-        """Return all registered routes (for CLI listing and Swagger)."""
+    def get_routes() -> list[dict]:
+        """Return all registered routes."""
+        return _routes
+
+    @staticmethod
+    def list_routes() -> list[dict]:
+        """Return all registered routes (debug-friendly)."""
         return _routes
 
     @staticmethod

{tina4_python-3.10.34 → tina4_python-3.10.39}/tina4_python/core/server.py

@@ -757,7 +757,7 @@ async def app(scope: dict, receive, send):
             # Serve OpenAPI spec JSON from all registered routes
             from tina4_python.swagger import Swagger as _SwaggerGen
             _swagger = _SwaggerGen()
-            _spec = _swagger.generate(Router.all())
+            _spec = _swagger.generate(Router.get_routes())
             response.json(_spec)
             _cors.apply(request, response)
             headers = response.build_headers("")
@@ -929,7 +929,7 @@ async def app(scope: dict, receive, send):
                 matched_pattern = route["path"] if route else "-"
                 toolbar = render_dev_toolbar(
                     request.method, request.path, matched_pattern,
-                    request_id, len(Router.all()),
+                    request_id, len(Router.get_routes()),
                 ).encode()
                 content = response.content
                 # Inject before </body> if present, else append
@@ -1216,7 +1216,7 @@ def run(host: str | None = None, port: int | None = None):
 
     # Auto-discover routes
     _auto_discover("src")
-    route_count = len(Router.all())
+    route_count = len(Router.get_routes())
     Log.info(f"Discovered {route_count} routes")
 
     # Resolve host/port (CLI arg > ENV > default)