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

tina4_python-0.2.201/README.md → tina4_python-0.2.203/PKG-INFO

@@ -1,3 +1,40 @@
+Metadata-Version: 2.4
+Name: tina4-python
+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
+Requires-Dist: asyncer>=0.0.8
+Requires-Dist: bcrypt<5.0.0,>=4.2.1
+Requires-Dist: hypercorn>=0.18.0
+Requires-Dist: jinja2<4.0.0,>=3.1.5
+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
+Provides-Extra: all-db
+Requires-Dist: firebird-driver>=1.10.0; extra == 'all-db'
+Requires-Dist: mysql-connector-python>=9.3.0; extra == 'all-db'
+Requires-Dist: psycopg2-binary>=2.9.10; extra == 'all-db'
+Requires-Dist: pymongo>=4.0.0; extra == 'all-db'
+Requires-Dist: pymssql>=2.3.0; extra == 'all-db'
+Provides-Extra: dev-reload
+Requires-Dist: jurigged>=0.6.0; extra == 'dev-reload'
+Provides-Extra: firebird
+Requires-Dist: firebird-driver>=1.10.0; extra == 'firebird'
+Provides-Extra: mongo
+Requires-Dist: pymongo>=4.0.0; extra == 'mongo'
+Provides-Extra: mssql
+Requires-Dist: pymssql>=2.3.0; extra == 'mssql'
+Provides-Extra: mysql
+Requires-Dist: mysql-connector-python>=9.3.0; extra == 'mysql'
+Provides-Extra: postgres
+Requires-Dist: psycopg2-binary>=2.9.10; extra == 'postgres'
+Description-Content-Type: text/markdown
+
 # Tina4 Python — This is not a framework
 
 Laravel joy. Python speed. 10x less code.
@@ -21,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`
@@ -36,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
 
@@ -44,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.
@@ -64,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):
@@ -73,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
@@ -99,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
@@ -112,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:
@@ -124,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
@@ -135,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
@@ -179,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),
@@ -209,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.201/PKG-INFO → tina4_python-0.2.203/README.md

@@ -1,24 +1,3 @@
-Metadata-Version: 2.4
-Name: tina4-python
-Version: 0.2.201
-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.
@@ -42,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`
@@ -57,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
 
@@ -65,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.
@@ -85,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):
@@ -94,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
@@ -120,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
@@ -133,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:
@@ -145,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
@@ -156,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
@@ -200,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),
@@ -230,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.201 → tina4_python-0.2.203}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tina4-python"
-version = "0.2.201"
+version = "0.2.203"
 description = "Tina4Python - This is not another framework for Python"
 authors = [
     {name = "Andre van Zuydam",email = "andrevanzuydam@gmail.com"}
@@ -11,8 +11,7 @@ dependencies = [
     "jinja2>=3.1.5,<4.0.0",
     "libsass (>=0.23.0,<0.24.0)",
     "python-dotenv (>=1.0.1,<2.0.0)",
-    "pyjwt (>=2.10.1,<3.0.0)",
-    "cryptography (>=44.0.0,<45.0.0)",
+    "pyjwt>=2.10.1,<3.0.0",
     "watchdog (>=6.0.0,<7.0.0)",
     "bcrypt (>=4.2.1,<5.0.0)",
     "litequeue (>=0.9,<0.10)",
@@ -20,11 +19,26 @@ dependencies = [
     "asyncer>=0.0.8",
     "hypercorn>=0.18.0",
     "requests>=2.32.5",
-    "jurigged>=0.6.0",
+]
+
+[project.optional-dependencies]
+dev-reload = ["jurigged>=0.6.0"]
+postgres  = ["psycopg2-binary>=2.9.10"]
+mysql     = ["mysql-connector-python>=9.3.0"]
+mssql     = ["pymssql>=2.3.0"]
+firebird  = ["firebird-driver>=1.10.0"]
+mongo     = ["pymongo>=4.0.0"]
+all-db    = [
+    "psycopg2-binary>=2.9.10",
+    "mysql-connector-python>=9.3.0",
+    "pymssql>=2.3.0",
+    "firebird-driver>=1.10.0",
+    "pymongo>=4.0.0",
 ]
 
 [dependency-groups]
 dev = [
+    "jurigged>=0.6.0",
     "flake8>=7.2.0",
     "mkdocs>=1.6.1",
     "mysql-connector-python>=9.3.0",