tina4-python 0.2.188__tar.gz → 0.2.190__tar.gz

tina4_python-0.2.190/PKG-INFO

@@ -0,0 +1,264 @@
+Metadata-Version: 2.4
+Name: tina4-python
+Version: 0.2.190
+Summary: Tina4Python - This is not another framework for Python
+Author-email: Andre van Zuydam <andrevanzuydam@gmail.com>
+Requires-Python: <4.0,>=3.12
+Requires-Dist: asyncer>=0.0.8
+Requires-Dist: bcrypt<5.0.0,>=4.2.1
+Requires-Dist: cryptography<45.0.0,>=44.0.0
+Requires-Dist: hypercorn>=0.18.0
+Requires-Dist: jinja2<4.0.0,>=3.1.5
+Requires-Dist: jurigged>=0.6.0
+Requires-Dist: libsass<0.24.0,>=0.23.0
+Requires-Dist: litequeue<0.10,>=0.9
+Requires-Dist: pyjwt<3.0.0,>=2.10.1
+Requires-Dist: python-dotenv<2.0.0,>=1.0.1
+Requires-Dist: requests>=2.32.5
+Requires-Dist: simple-websocket<2.0.0,>=1.1.0
+Requires-Dist: watchdog<7.0.0,>=6.0.0
+Description-Content-Type: text/markdown
+
+# Tina4 Python — This is not a framework
+
+Laravel joy. Python speed. 10x less code.
+
+## Quickstart
+
+```bash
+pip install tina4-python
+tina4 init my_project
+cd my_project
+python app.py
+```
+
+You've just built your first Tina4 app — zero configuration, zero classes, zero boilerplate!
+
+> **Prefer uv?** Replace `pip install tina4-python` with `uv add tina4-python`, then use `uv run tina4 start` to launch the dev server.
+
+## Features
+
+- **ASGI compliant** — works with any ASGI server (uvicorn, hypercorn, daphne)
+- **Full async** — every route handler is `async` by default
+- **Routing** — decorator-based with path parameters, type hints, and auto-discovery
+- **Twig/Jinja2 templates** — with inheritance, partials, custom filters, and globals
+- **ORM** — define models with typed fields, save/load/select/delete with one line
+- **Database** — SQLite, PostgreSQL, MySQL, MariaDB, MSSQL, Firebird
+- **Migrations** — versioned SQL files, CLI scaffolding
+- **Sessions** — file, Redis, Valkey, or MongoDB backends
+- **JWT authentication** — auto-generated RSA keys, bearer tokens, form tokens
+- **Swagger/OpenAPI** — auto-generated docs at `/swagger`
+- **CRUD scaffolding** — instant admin UI with one line of code
+- **Middleware** — before/after hooks per route or globally
+- **Queues** — background processing with litequeue, RabbitMQ, Kafka, or MongoDB
+- **WebSockets** — built-in support via `simple-websocket`
+- **WSDL/SOAP** — auto-generated WSDL from Python classes
+- **REST client** — built-in `Api` class for external HTTP calls
+- **SCSS compilation** — auto-compiled to CSS on save
+- **Live reload** — browser auto-refreshes during development
+- **Inline testing** — decorator-based test cases with `@tests`
+- **Localization** — i18n via gettext (English, French, Afrikaans)
+
+## Install
+
+```bash
+pip install tina4-python
+```
+
+Or with [uv](https://docs.astral.sh/uv/) (recommended for dependency management):
+
+```bash
+uv add tina4-python
+```
+
+## Routing
+
+Routes live in `src/routes/` and are auto-discovered on startup.
+
+```python
+# src/routes/hello.py
+from tina4_python import get
+
+@get("/hello")
+async def get_hello(request, response):
+    return response("Hello, Tina4 Python!")
+
+@get("/hello/{name}")
+async def get_hello_name(name, request, response):
+    return response(f"Hello, {name}")
+
+@get("/hello/json")
+async def get_hello_json(request, response):
+    return response([{"brand": "BMW"}, {"brand": "Toyota"}])
+
+@get("/hello/template")
+async def get_hello_template(request, response):
+    return response.render("index.twig", {"data": request.params})
+
+@get("/hello/redirect")
+async def get_hello_redirect(request, response):
+    return response.redirect("/hello/world")
+```
+
+## ORM
+
+```python
+# src/orm/User.py
+from tina4_python import ORM, IntegerField, StringField
+
+class User(ORM):
+    id    = IntegerField(primary_key=True, auto_increment=True)
+    name  = StringField()
+    email = StringField()
+
+User({"name": "Alice", "email": "alice@example.com"}).save()
+```
+
+## Database
+
+```python
+from tina4_python.Database import Database
+
+db = Database("sqlite3:app.db")
+result = db.fetch("SELECT * FROM users WHERE age > ?", [18])
+```
+
+Works with SQLite, PostgreSQL, MySQL, MariaDB, MSSQL, and Firebird.
+
+## Migrations
+
+```bash
+tina4 migrate:create "create users table"
+# Edit the generated SQL file in migrations/
+tina4 migrate
+```
+
+## Sessions
+
+Built-in session management with pluggable backends:
+
+| Handler | Backend | Package |
+|---------|---------|---------|
+| `SessionFileHandler` (default) | File system | — |
+| `SessionRedisHandler` | Redis | `redis` |
+| `SessionValkeyHandler` | Valkey | `valkey` |
+| `SessionMongoHandler` | MongoDB | `pymongo` |
+
+```python
+request.session.set("name", "Joe")
+name = request.session.get("name")
+```
+
+## Queues
+
+Background processing with litequeue (default), RabbitMQ, Kafka, or MongoDB.
+
+```python
+from tina4_python.Queue import Queue, Producer, Consumer
+
+Producer(Queue(topic="emails")).produce({"to": "alice@example.com"})
+
+for msg in Consumer(Queue(topic="emails")).messages():
+    print(msg.data)
+```
+
+## Middleware
+
+```python
+from tina4_python.Router import get, middleware
+
+class AuthCheck:
+    @staticmethod
+    def before_auth(request, response):
+        if "authorization" not in request.headers:
+            return request, response("Unauthorized", 401)
+        return request, response
+
+@middleware(AuthCheck)
+@get("/protected")
+async def protected(request, response):
+    return response({"secret": True})
+```
+
+## Swagger / OpenAPI
+
+Auto-generated at `/swagger`. Add metadata with decorators:
+
+```python
+from tina4_python import description, tags
+
+@get("/users")
+@description("Get all users")
+@tags(["users"])
+async def users(request, response):
+    return response(User().select("*"))
+```
+
+## REST Client
+
+```python
+from tina4_python import Api
+
+api = Api("https://api.example.com", auth_header="Bearer xyz")
+result = api.get("/users/42")
+```
+
+## WSDL / SOAP
+
+```python
+from tina4_python.WSDL import WSDL, wsdl_operation
+
+class Calculator(WSDL):
+    SERVICE_URL = "http://localhost:7145/calculator"
+
+    def Add(self, a: int, b: int):
+        return {"Result": a + b}
+```
+
+## Testing
+
+```python
+from tina4_python import tests
+
+@tests(
+    assert_equal((7, 7), 1),
+    assert_raises(ZeroDivisionError, (5, 0)),
+)
+def divide(a: int, b: int) -> float:
+    if b == 0:
+        raise ZeroDivisionError("division by zero")
+    return a / b
+```
+
+Run with `tina4 test` or `uv run pytest --verbose`.
+
+## Environment
+
+Key `.env` settings:
+
+```bash
+SECRET=your-jwt-secret
+API_KEY=your-api-key
+DATABASE_NAME=sqlite3:app.db
+TINA4_DEBUG_LEVEL=ALL
+TINA4_LANGUAGE=en
+TINA4_SESSION_HANDLER=SessionFileHandler
+SWAGGER_TITLE=My API
+```
+
+## Further Documentation
+
+https://tina4.com/python
+
+## Community
+
+- GitHub: https://github.com/tina4stack/tina4-python
+
+## License
+
+MIT (c) 2007-2025 Tina4 Stack
+https://opensource.org/licenses/MIT
+
+---
+
+**Tina4** — The framework that keeps out of the way of your coding.

tina4_python-0.2.190/README.md

@@ -0,0 +1,243 @@
+# Tina4 Python — This is not a framework
+
+Laravel joy. Python speed. 10x less code.
+
+## Quickstart
+
+```bash
+pip install tina4-python
+tina4 init my_project
+cd my_project
+python app.py
+```
+
+You've just built your first Tina4 app — zero configuration, zero classes, zero boilerplate!
+
+> **Prefer uv?** Replace `pip install tina4-python` with `uv add tina4-python`, then use `uv run tina4 start` to launch the dev server.
+
+## Features
+
+- **ASGI compliant** — works with any ASGI server (uvicorn, hypercorn, daphne)
+- **Full async** — every route handler is `async` by default
+- **Routing** — decorator-based with path parameters, type hints, and auto-discovery
+- **Twig/Jinja2 templates** — with inheritance, partials, custom filters, and globals
+- **ORM** — define models with typed fields, save/load/select/delete with one line
+- **Database** — SQLite, PostgreSQL, MySQL, MariaDB, MSSQL, Firebird
+- **Migrations** — versioned SQL files, CLI scaffolding
+- **Sessions** — file, Redis, Valkey, or MongoDB backends
+- **JWT authentication** — auto-generated RSA keys, bearer tokens, form tokens
+- **Swagger/OpenAPI** — auto-generated docs at `/swagger`
+- **CRUD scaffolding** — instant admin UI with one line of code
+- **Middleware** — before/after hooks per route or globally
+- **Queues** — background processing with litequeue, RabbitMQ, Kafka, or MongoDB
+- **WebSockets** — built-in support via `simple-websocket`
+- **WSDL/SOAP** — auto-generated WSDL from Python classes
+- **REST client** — built-in `Api` class for external HTTP calls
+- **SCSS compilation** — auto-compiled to CSS on save
+- **Live reload** — browser auto-refreshes during development
+- **Inline testing** — decorator-based test cases with `@tests`
+- **Localization** — i18n via gettext (English, French, Afrikaans)
+
+## Install
+
+```bash
+pip install tina4-python
+```
+
+Or with [uv](https://docs.astral.sh/uv/) (recommended for dependency management):
+
+```bash
+uv add tina4-python
+```
+
+## Routing
+
+Routes live in `src/routes/` and are auto-discovered on startup.
+
+```python
+# src/routes/hello.py
+from tina4_python import get
+
+@get("/hello")
+async def get_hello(request, response):
+    return response("Hello, Tina4 Python!")
+
+@get("/hello/{name}")
+async def get_hello_name(name, request, response):
+    return response(f"Hello, {name}")
+
+@get("/hello/json")
+async def get_hello_json(request, response):
+    return response([{"brand": "BMW"}, {"brand": "Toyota"}])
+
+@get("/hello/template")
+async def get_hello_template(request, response):
+    return response.render("index.twig", {"data": request.params})
+
+@get("/hello/redirect")
+async def get_hello_redirect(request, response):
+    return response.redirect("/hello/world")
+```
+
+## ORM
+
+```python
+# src/orm/User.py
+from tina4_python import ORM, IntegerField, StringField
+
+class User(ORM):
+    id    = IntegerField(primary_key=True, auto_increment=True)
+    name  = StringField()
+    email = StringField()
+
+User({"name": "Alice", "email": "alice@example.com"}).save()
+```
+
+## Database
+
+```python
+from tina4_python.Database import Database
+
+db = Database("sqlite3:app.db")
+result = db.fetch("SELECT * FROM users WHERE age > ?", [18])
+```
+
+Works with SQLite, PostgreSQL, MySQL, MariaDB, MSSQL, and Firebird.
+
+## Migrations
+
+```bash
+tina4 migrate:create "create users table"
+# Edit the generated SQL file in migrations/
+tina4 migrate
+```
+
+## Sessions
+
+Built-in session management with pluggable backends:
+
+| Handler | Backend | Package |
+|---------|---------|---------|
+| `SessionFileHandler` (default) | File system | — |
+| `SessionRedisHandler` | Redis | `redis` |
+| `SessionValkeyHandler` | Valkey | `valkey` |
+| `SessionMongoHandler` | MongoDB | `pymongo` |
+
+```python
+request.session.set("name", "Joe")
+name = request.session.get("name")
+```
+
+## Queues
+
+Background processing with litequeue (default), RabbitMQ, Kafka, or MongoDB.
+
+```python
+from tina4_python.Queue import Queue, Producer, Consumer
+
+Producer(Queue(topic="emails")).produce({"to": "alice@example.com"})
+
+for msg in Consumer(Queue(topic="emails")).messages():
+    print(msg.data)
+```
+
+## Middleware
+
+```python
+from tina4_python.Router import get, middleware
+
+class AuthCheck:
+    @staticmethod
+    def before_auth(request, response):
+        if "authorization" not in request.headers:
+            return request, response("Unauthorized", 401)
+        return request, response
+
+@middleware(AuthCheck)
+@get("/protected")
+async def protected(request, response):
+    return response({"secret": True})
+```
+
+## Swagger / OpenAPI
+
+Auto-generated at `/swagger`. Add metadata with decorators:
+
+```python
+from tina4_python import description, tags
+
+@get("/users")
+@description("Get all users")
+@tags(["users"])
+async def users(request, response):
+    return response(User().select("*"))
+```
+
+## REST Client
+
+```python
+from tina4_python import Api
+
+api = Api("https://api.example.com", auth_header="Bearer xyz")
+result = api.get("/users/42")
+```
+
+## WSDL / SOAP
+
+```python
+from tina4_python.WSDL import WSDL, wsdl_operation
+
+class Calculator(WSDL):
+    SERVICE_URL = "http://localhost:7145/calculator"
+
+    def Add(self, a: int, b: int):
+        return {"Result": a + b}
+```
+
+## Testing
+
+```python
+from tina4_python import tests
+
+@tests(
+    assert_equal((7, 7), 1),
+    assert_raises(ZeroDivisionError, (5, 0)),
+)
+def divide(a: int, b: int) -> float:
+    if b == 0:
+        raise ZeroDivisionError("division by zero")
+    return a / b
+```
+
+Run with `tina4 test` or `uv run pytest --verbose`.
+
+## Environment
+
+Key `.env` settings:
+
+```bash
+SECRET=your-jwt-secret
+API_KEY=your-api-key
+DATABASE_NAME=sqlite3:app.db
+TINA4_DEBUG_LEVEL=ALL
+TINA4_LANGUAGE=en
+TINA4_SESSION_HANDLER=SessionFileHandler
+SWAGGER_TITLE=My API
+```
+
+## Further Documentation
+
+https://tina4.com/python
+
+## Community
+
+- GitHub: https://github.com/tina4stack/tina4-python
+
+## License
+
+MIT (c) 2007-2025 Tina4 Stack
+https://opensource.org/licenses/MIT
+
+---
+
+**Tina4** — The framework that keeps out of the way of your coding.

{tina4_python-0.2.188 → tina4_python-0.2.190}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tina4-python"
-version = "0.2.188"
+version = "0.2.190"
 description = "Tina4Python - This is not another framework for Python"
 authors = [
     {name = "Andre van Zuydam",email = "andrevanzuydam@gmail.com"}

{tina4_python-0.2.188 → tina4_python-0.2.190}/tina4_python/Auth.py

@@ -181,7 +181,8 @@ class Auth:
         self.secret = os.environ.get("SECRET", "{self.secret}")
         if self.secret == "{self.secret}":
             from tina4_python.Debug import Debug
-            Debug.warning("No SECRET env var set - using default secret. Set SECRET in your .env for production.")
+            from tina4_python import Messages
+            Debug.warning(Messages.MSG_AUTH_NO_SECRET)
         self.private_key = os.path.join(root_path, "secrets", "private.key")
         self.public_key = os.path.join(root_path, "secrets", "public.key")
         self.self_signed = os.path.join(root_path, "secrets", "domain.cert")