tina4-python 0.2.202__tar.gz → 0.2.203__tar.gz

{tina4_python-0.2.202 → tina4_python-0.2.203}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tina4-python
-Version: 0.2.202
+Version: 0.2.203
 Summary: Tina4Python - This is not another framework for Python
 Author-email: Andre van Zuydam <andrevanzuydam@gmail.com>
 Requires-Python: <4.0,>=3.12
@@ -58,13 +58,16 @@ You've just built your first Tina4 app — zero configuration, zero classes, zer
 - **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
+- **tina4-css** — lightweight CSS framework (~24 KB) ships built-in, Bootstrap-compatible class names
 - **ORM** — define models with typed fields, save/load/select/delete with one line
-- **Database** — SQLite, PostgreSQL, MySQL, MariaDB, MSSQL, Firebird
+- **Database** — SQLite, PostgreSQL, MySQL, MariaDB, MSSQL, Firebird, MongoDB
 - **Migrations** — versioned SQL files, CLI scaffolding
+- **Data seeder** — zero-dependency fake data generation with ORM and table support
 - **Sessions** — file, Redis, Valkey, or MongoDB backends
-- **JWT authentication** — auto-generated RSA keys, bearer tokens, form tokens
+- **JWT authentication** — HS256 tokens signed with your `SECRET` env var, form tokens
 - **Swagger/OpenAPI** — auto-generated docs at `/swagger`
-- **CRUD scaffolding** — instant admin UI with one line of code
+- **CRUD scaffolding** — instant searchable admin UI with one line of code
+- **GraphQL** — zero-dependency engine with ORM auto-schema and GraphiQL IDE
 - **Middleware** — before/after hooks per route or globally
 - **Queues** — background processing with litequeue, RabbitMQ, Kafka, or MongoDB
 - **WebSockets** — built-in support via `simple-websocket`
@@ -73,7 +76,7 @@ You've just built your first Tina4 app — zero configuration, zero classes, zer
 - **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)
+- **Localization** — i18n via gettext (English, French, Afrikaans, Chinese, Japanese, Spanish)
 
 ## Install
 
@@ -81,12 +84,26 @@ You've just built your first Tina4 app — zero configuration, zero classes, zer
 pip install tina4-python
 ```
 
-Or with [uv](https://docs.astral.sh/uv/) (recommended for dependency management):
+Or with [uv](https://docs.astral.sh/uv/) (recommended):
 
 ```bash
 uv add tina4-python
 ```
 
+### Optional extras
+
+Install only the database driver you need:
+
+```bash
+pip install tina4-python[postgres]    # PostgreSQL (psycopg2-binary)
+pip install tina4-python[mysql]       # MySQL / MariaDB (mysql-connector-python)
+pip install tina4-python[mssql]       # Microsoft SQL Server (pymssql)
+pip install tina4-python[firebird]    # Firebird (firebird-driver)
+pip install tina4-python[mongo]       # MongoDB (pymongo)
+pip install tina4-python[all-db]      # all of the above
+pip install tina4-python[dev-reload]  # hot-patching via jurigged
+```
+
 ## Routing
 
 Routes live in `src/routes/` and are auto-discovered on startup.
@@ -101,7 +118,7 @@ async def get_hello(request, response):
 
 @get("/hello/{name}")
 async def get_hello_name(name, request, response):
-    return response(f"Hello, {name}")
+    return response(f"Hello, {name}!")
 
 @get("/hello/json")
 async def get_hello_json(request, response):
@@ -110,10 +127,6 @@ async def get_hello_json(request, response):
 @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
@@ -136,11 +149,13 @@ User({"name": "Alice", "email": "alice@example.com"}).save()
 from tina4_python.Database import Database
 
 db = Database("sqlite3:app.db")
+db = Database("psycopg2:localhost/5432:mydb", "user", "password")      # PostgreSQL
+db = Database("mysql.connector:localhost/3306:mydb", "user", "password") # MySQL
+db = Database("pymongo:localhost/27017:mydb")                            # MongoDB
+
 result = db.fetch("SELECT * FROM users WHERE age > ?", [18])
 ```
 
-Works with SQLite, PostgreSQL, MySQL, MariaDB, MSSQL, and Firebird.
-
 ## Migrations
 
 ```bash
@@ -149,6 +164,48 @@ tina4 migrate:create "create users table"
 tina4 migrate
 ```
 
+## Data Seeder
+
+Generate fake data for development and testing:
+
+```python
+from tina4_python.Seeder import FakeData, seed_orm, seed_table
+
+fake = FakeData()
+fake.name()    # "Alice Johnson"
+fake.email()   # "alice.johnson@example.com"
+fake.phone()   # "+27 82 123 4567"
+
+# Seed an ORM model
+seed_orm(User, count=50)
+
+# Seed a raw table
+seed_table(db, "products", columns, count=100)
+```
+
+CLI:
+
+```bash
+tina4 seed                        # run all files in src/seeds/
+tina4 seed:create "initial users" # scaffold a new seed file
+```
+
+## CRUD Scaffolding
+
+Generate a searchable, paginated admin UI with one call:
+
+```python
+from tina4_python.CRUD import CRUD
+
+@get("/admin/users")
+async def admin_users(request, response):
+    return response(CRUD.to_crud(request, {
+        "sql": "SELECT id, name, email FROM users",
+        "title": "User Management",
+        "primary_key": "id",
+    }))
+```
+
 ## Sessions
 
 Built-in session management with pluggable backends:
@@ -161,8 +218,26 @@ Built-in session management with pluggable backends:
 | `SessionMongoHandler` | MongoDB | `pymongo` |
 
 ```python
-request.session.set("name", "Joe")
-name = request.session.get("name")
+request.session.set("user_id", 42)
+user_id = request.session.get("user_id")
+```
+
+## JWT Authentication
+
+Tokens are signed with HS256 using your `SECRET` env var. Set it in `.env`:
+
+```bash
+SECRET=your-strong-random-secret-32-chars-min
+```
+
+```python
+from tina4_python import tina4_auth
+
+token = tina4_auth.get_token({"user_id": 42})
+is_valid = tina4_auth.valid(token)
+payload = tina4_auth.get_payload(token)
+hashed = tina4_auth.hash_password("mypassword")
+ok = tina4_auth.check_password(hashed, "mypassword")
 ```
 
 ## Queues
@@ -172,10 +247,25 @@ Background processing with litequeue (default), RabbitMQ, Kafka, or MongoDB.
 ```python
 from tina4_python.Queue import Queue, Producer, Consumer
 
+# Enqueue from a route
 Producer(Queue(topic="emails")).produce({"to": "alice@example.com"})
 
+# Process in a worker
 for msg in Consumer(Queue(topic="emails")).messages():
-    print(msg.data)
+    send_email(msg.data)
+```
+
+## GraphQL
+
+Zero-dependency GraphQL engine with ORM auto-schema:
+
+```python
+from tina4_python.GraphQL import GraphQL
+
+gql = GraphQL()
+gql.schema.from_orm(User)     # auto-generates type, queries, and mutations
+gql.schema.from_orm(Product)
+gql.register_route("/graphql") # GET = GraphiQL IDE, POST = queries
 ```
 
 ## Middleware
@@ -216,25 +306,30 @@ async def users(request, response):
 from tina4_python import Api
 
 api = Api("https://api.example.com", auth_header="Bearer xyz")
-result = api.get("/users/42")
+result = api.send_request("/users/42")
 ```
 
 ## WSDL / SOAP
 
 ```python
 from tina4_python.WSDL import WSDL, wsdl_operation
+from tina4_python import get, post
 
 class Calculator(WSDL):
-    SERVICE_URL = "http://localhost:7145/calculator"
-
+    @wsdl_operation({"Result": int})
     def Add(self, a: int, b: int):
         return {"Result": a + b}
+
+@get("/calculator")
+@post("/calculator")
+async def calculator(request, response):
+    return response(Calculator(request).handle())
 ```
 
-## Testing
+## Inline Testing
 
 ```python
-from tina4_python import tests
+from tina4_python import tests, assert_equal, assert_raises
 
 @tests(
     assert_equal((7, 7), 1),
@@ -246,14 +341,14 @@ def divide(a: int, b: int) -> float:
     return a / b
 ```
 
-Run with `tina4 test` or `uv run pytest --verbose`.
+Run with `tina4 test` or `uv run pytest`.
 
 ## Environment
 
 Key `.env` settings:
 
 ```bash
-SECRET=your-jwt-secret
+SECRET=your-jwt-secret-32-chars-min
 API_KEY=your-api-key
 DATABASE_NAME=sqlite3:app.db
 TINA4_DEBUG_LEVEL=ALL

{tina4_python-0.2.202 → tina4_python-0.2.203}/README.md

@@ -21,13 +21,16 @@ You've just built your first Tina4 app — zero configuration, zero classes, zer
 - **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
+- **tina4-css** — lightweight CSS framework (~24 KB) ships built-in, Bootstrap-compatible class names
 - **ORM** — define models with typed fields, save/load/select/delete with one line
-- **Database** — SQLite, PostgreSQL, MySQL, MariaDB, MSSQL, Firebird
+- **Database** — SQLite, PostgreSQL, MySQL, MariaDB, MSSQL, Firebird, MongoDB
 - **Migrations** — versioned SQL files, CLI scaffolding
+- **Data seeder** — zero-dependency fake data generation with ORM and table support
 - **Sessions** — file, Redis, Valkey, or MongoDB backends
-- **JWT authentication** — auto-generated RSA keys, bearer tokens, form tokens
+- **JWT authentication** — HS256 tokens signed with your `SECRET` env var, form tokens
 - **Swagger/OpenAPI** — auto-generated docs at `/swagger`
-- **CRUD scaffolding** — instant admin UI with one line of code
+- **CRUD scaffolding** — instant searchable admin UI with one line of code
+- **GraphQL** — zero-dependency engine with ORM auto-schema and GraphiQL IDE
 - **Middleware** — before/after hooks per route or globally
 - **Queues** — background processing with litequeue, RabbitMQ, Kafka, or MongoDB
 - **WebSockets** — built-in support via `simple-websocket`
@@ -36,7 +39,7 @@ You've just built your first Tina4 app — zero configuration, zero classes, zer
 - **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)
+- **Localization** — i18n via gettext (English, French, Afrikaans, Chinese, Japanese, Spanish)
 
 ## Install
 
@@ -44,12 +47,26 @@ You've just built your first Tina4 app — zero configuration, zero classes, zer
 pip install tina4-python
 ```
 
-Or with [uv](https://docs.astral.sh/uv/) (recommended for dependency management):
+Or with [uv](https://docs.astral.sh/uv/) (recommended):
 
 ```bash
 uv add tina4-python
 ```
 
+### Optional extras
+
+Install only the database driver you need:
+
+```bash
+pip install tina4-python[postgres]    # PostgreSQL (psycopg2-binary)
+pip install tina4-python[mysql]       # MySQL / MariaDB (mysql-connector-python)
+pip install tina4-python[mssql]       # Microsoft SQL Server (pymssql)
+pip install tina4-python[firebird]    # Firebird (firebird-driver)
+pip install tina4-python[mongo]       # MongoDB (pymongo)
+pip install tina4-python[all-db]      # all of the above
+pip install tina4-python[dev-reload]  # hot-patching via jurigged
+```
+
 ## Routing
 
 Routes live in `src/routes/` and are auto-discovered on startup.
@@ -64,7 +81,7 @@ async def get_hello(request, response):
 
 @get("/hello/{name}")
 async def get_hello_name(name, request, response):
-    return response(f"Hello, {name}")
+    return response(f"Hello, {name}!")
 
 @get("/hello/json")
 async def get_hello_json(request, response):
@@ -73,10 +90,6 @@ async def get_hello_json(request, response):
 @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
@@ -99,11 +112,13 @@ User({"name": "Alice", "email": "alice@example.com"}).save()
 from tina4_python.Database import Database
 
 db = Database("sqlite3:app.db")
+db = Database("psycopg2:localhost/5432:mydb", "user", "password")      # PostgreSQL
+db = Database("mysql.connector:localhost/3306:mydb", "user", "password") # MySQL
+db = Database("pymongo:localhost/27017:mydb")                            # MongoDB
+
 result = db.fetch("SELECT * FROM users WHERE age > ?", [18])
 ```
 
-Works with SQLite, PostgreSQL, MySQL, MariaDB, MSSQL, and Firebird.
-
 ## Migrations
 
 ```bash
@@ -112,6 +127,48 @@ tina4 migrate:create "create users table"
 tina4 migrate
 ```
 
+## Data Seeder
+
+Generate fake data for development and testing:
+
+```python
+from tina4_python.Seeder import FakeData, seed_orm, seed_table
+
+fake = FakeData()
+fake.name()    # "Alice Johnson"
+fake.email()   # "alice.johnson@example.com"
+fake.phone()   # "+27 82 123 4567"
+
+# Seed an ORM model
+seed_orm(User, count=50)
+
+# Seed a raw table
+seed_table(db, "products", columns, count=100)
+```
+
+CLI:
+
+```bash
+tina4 seed                        # run all files in src/seeds/
+tina4 seed:create "initial users" # scaffold a new seed file
+```
+
+## CRUD Scaffolding
+
+Generate a searchable, paginated admin UI with one call:
+
+```python
+from tina4_python.CRUD import CRUD
+
+@get("/admin/users")
+async def admin_users(request, response):
+    return response(CRUD.to_crud(request, {
+        "sql": "SELECT id, name, email FROM users",
+        "title": "User Management",
+        "primary_key": "id",
+    }))
+```
+
 ## Sessions
 
 Built-in session management with pluggable backends:
@@ -124,8 +181,26 @@ Built-in session management with pluggable backends:
 | `SessionMongoHandler` | MongoDB | `pymongo` |
 
 ```python
-request.session.set("name", "Joe")
-name = request.session.get("name")
+request.session.set("user_id", 42)
+user_id = request.session.get("user_id")
+```
+
+## JWT Authentication
+
+Tokens are signed with HS256 using your `SECRET` env var. Set it in `.env`:
+
+```bash
+SECRET=your-strong-random-secret-32-chars-min
+```
+
+```python
+from tina4_python import tina4_auth
+
+token = tina4_auth.get_token({"user_id": 42})
+is_valid = tina4_auth.valid(token)
+payload = tina4_auth.get_payload(token)
+hashed = tina4_auth.hash_password("mypassword")
+ok = tina4_auth.check_password(hashed, "mypassword")
 ```
 
 ## Queues
@@ -135,10 +210,25 @@ Background processing with litequeue (default), RabbitMQ, Kafka, or MongoDB.
 ```python
 from tina4_python.Queue import Queue, Producer, Consumer
 
+# Enqueue from a route
 Producer(Queue(topic="emails")).produce({"to": "alice@example.com"})
 
+# Process in a worker
 for msg in Consumer(Queue(topic="emails")).messages():
-    print(msg.data)
+    send_email(msg.data)
+```
+
+## GraphQL
+
+Zero-dependency GraphQL engine with ORM auto-schema:
+
+```python
+from tina4_python.GraphQL import GraphQL
+
+gql = GraphQL()
+gql.schema.from_orm(User)     # auto-generates type, queries, and mutations
+gql.schema.from_orm(Product)
+gql.register_route("/graphql") # GET = GraphiQL IDE, POST = queries
 ```
 
 ## Middleware
@@ -179,25 +269,30 @@ async def users(request, response):
 from tina4_python import Api
 
 api = Api("https://api.example.com", auth_header="Bearer xyz")
-result = api.get("/users/42")
+result = api.send_request("/users/42")
 ```
 
 ## WSDL / SOAP
 
 ```python
 from tina4_python.WSDL import WSDL, wsdl_operation
+from tina4_python import get, post
 
 class Calculator(WSDL):
-    SERVICE_URL = "http://localhost:7145/calculator"
-
+    @wsdl_operation({"Result": int})
     def Add(self, a: int, b: int):
         return {"Result": a + b}
+
+@get("/calculator")
+@post("/calculator")
+async def calculator(request, response):
+    return response(Calculator(request).handle())
 ```
 
-## Testing
+## Inline Testing
 
 ```python
-from tina4_python import tests
+from tina4_python import tests, assert_equal, assert_raises
 
 @tests(
     assert_equal((7, 7), 1),
@@ -209,14 +304,14 @@ def divide(a: int, b: int) -> float:
     return a / b
 ```
 
-Run with `tina4 test` or `uv run pytest --verbose`.
+Run with `tina4 test` or `uv run pytest`.
 
 ## Environment
 
 Key `.env` settings:
 
 ```bash
-SECRET=your-jwt-secret
+SECRET=your-jwt-secret-32-chars-min
 API_KEY=your-api-key
 DATABASE_NAME=sqlite3:app.db
 TINA4_DEBUG_LEVEL=ALL

{tina4_python-0.2.202 → tina4_python-0.2.203}/pyproject.toml

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