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

{tina4_python-0.2.190 → tina4_python-0.2.191}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tina4-python
-Version: 0.2.190
+Version: 0.2.191
 Summary: Tina4Python - This is not another framework for Python
 Author-email: Andre van Zuydam <andrevanzuydam@gmail.com>
 Requires-Python: <4.0,>=3.12

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

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

{tina4_python-0.2.190 → tina4_python-0.2.191}/tina4_python/CLAUDE.md

@@ -251,6 +251,38 @@ from tina4_python.Queue import Queue, Producer
 Producer(Queue(topic="tasks")).produce({"action": "send_email"})
 ```
 
+### 11. Key tina4_python Gotchas
+
+1. **Database import**: Use `from tina4_python.Database import Database` (NOT `from tina4_python import Database`)
+2. **noauth/secured import**: Use `from tina4_python import noauth` or `from tina4_python.Router import noauth` (there is NO `tina4_python.Decorators` module)
+3. **Jinja2 template syntax** (common mistakes):
+    - **No ternary operator**: Use `{% if x %}...{% endif %}` NOT `{{ x ? 'a' : 'b' }}`
+    - **elif not elseif**: Use `{% elif %}` NOT `{% elseif %}`
+    - **safe not raw**: Use `{{ var | safe }}` NOT `{{ var | raw }}` for unescaped output
+    - **format filter**: Use `{{ "%.2f" | format(value) }}` for number formatting
+    - **e() filter has NO arguments**: Use `{{ var|e }}` NOT `{{ var|e('js') }}` — Jinja2's `|e` is HTML-only with no mode parameter (that's PHP Twig syntax)
+    - **JS string escaping**: Use `{{ var|replace("'", "\\'") }}` to escape single quotes for inline JS onclick handlers
+    - **No `|escape('js')` or `|e('js')`**: These will throw `escape() takes 1 positional argument but 2 were given`
+    - **Ternary inline**: Use `{{ 's' if count != 1 else '' }}` NOT `{{ count != 1 ? 's' : '' }}`
+    - **Default values**: Use `{{ var|default('fallback') }}` — works on undefined and None
+    - **Chaining filters**: `{{ var|default('')|replace("'", "\\'") }}` — left to right
+    - **Loop variables**: `loop.index` (1-based), `loop.index0` (0-based), `loop.first`, `loop.last`, `loop.length`
+    - **Whitespace control**: `{%- -%}` and `{{- -}}` trim surrounding whitespace
+    - **String concatenation**: Use `~` operator: `{{ "hello " ~ name }}` NOT `{{ "hello " + name }}`
+    - **include with context**: `{% include "partial.twig" %}` inherits parent context automatically
+    - **Macro imports**: `{% from "macros/forms.twig" import field_group %}` — macros do NOT inherit parent context, pass variables explicitly
+4. **DatabaseResult**: `dba.fetch()` returns a `DatabaseResult` object, NOT a plain list
+    - Use `.records` to get list of dicts: `result.records`
+    - Use `.count` for row count (no `len()` support)
+    - Iteration works: `for row in result` or `list(result)`
+    - Other methods: `.to_json()`, `.to_array()`, `.to_csv()`, `.to_paginate()`
+4. **fetch_one()**: Returns a plain dict (or None), NOT a DatabaseResult
+5. **Dict access**: All query results use dict access `row["column"]` not attribute access `row.column`
+6. **Firebird connection string**: `firebird.driver:<host>/<port>:<database_path>` — note the `firebird.driver:` prefix (the module name), NOT `firebird:`
+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
+
+
 ---
 
 ## Project Structure
@@ -668,6 +700,9 @@ except:
     db.rollback()
 ```
 
+**NEVER use `db.execute("COMMIT")` or `db.execute("ROLLBACK")` or `db.execute("BEGIN")`.**
+Always use the proper methods: `db.commit()`, `db.rollback()`, `db.start_transaction()`. Raw SQL transaction commands bypass the framework's connection and transaction state management, leading to unpredictable behaviour and connection leaks.
+
 ## ORM
 
 Define models in `src/orm/` (one class per file, filename matches class name).
@@ -1310,3 +1345,5 @@ async def dashboard(request, response):
 </div>
 {% endblock %}
 ```
+
+

{tina4_python-0.2.190 → tina4_python-0.2.191}/tina4_python/Database.py

@@ -55,10 +55,13 @@ import datetime
 
 class Database:
 
-    def __init__(self, connection_string, username="", password=""):
+    def __init__(self, connection_string, username="", password="", charset=""):
         """
         Initializes a database connection
         :param connection_string:
+        :param username:
+        :param password:
+        :param charset: Character set for the connection (e.g. "UTF8", "WIN1252")
         """
         # split out the connection string
         # driver:host/port:schema/path
@@ -71,6 +74,8 @@ class Database:
                 username = os.environ.get("DATABASE_USERNAME", "")
             if password == "":
                 password = os.environ.get("DATABASE_PASSWORD", "")
+            if charset == "":
+                charset = os.environ.get("DATABASE_CHARSET", "")
 
             if connection_string is None:
                 from tina4_python import Messages
@@ -98,6 +103,7 @@ class Database:
         self.database_path = params[1]
         self.username = username
         self.password = password
+        self.charset = charset
 
         if self.database_engine == SQLITE:
             self.dba = self.database_module.connect(self.database_path)
@@ -149,28 +155,37 @@ class Database:
             self.database_path = temp_params[1]
 
             if self.database_engine == FIREBIRD:
-                self.dba = self.database_module.connect(
-                    self.host + "/" + str(self.port) + ":" + self.database_path,
-                    user=self.username,
-                    password=self.password
-                )
+                firebird_args = {
+                    "dsn": self.host + "/" + str(self.port) + ":" + self.database_path,
+                    "user": self.username,
+                    "password": self.password,
+                }
+                if self.charset:
+                    firebird_args["charset"] = self.charset
+                self.dba = self.database_module.connect(**firebird_args)
             elif self.database_engine == MYSQL:
-                self.dba = self.database_module.connect(
-                    database=self.database_path,
-                    port=self.port,
-                    host=self.host,
-                    user=self.username,
-                    password=self.password,
-                    consume_results=True
-                )
+                mysql_args = {
+                    "database": self.database_path,
+                    "port": self.port,
+                    "host": self.host,
+                    "user": self.username,
+                    "password": self.password,
+                    "consume_results": True,
+                }
+                if self.charset:
+                    mysql_args["charset"] = self.charset
+                self.dba = self.database_module.connect(**mysql_args)
             elif self.database_engine == POSTGRES:
-                self.dba = self.database_module.connect(
-                    dbname=self.database_path,
-                    port=self.port,
-                    host=self.host,
-                    user=self.username,
-                    password=self.password
-                )
+                postgres_args = {
+                    "dbname": self.database_path,
+                    "port": self.port,
+                    "host": self.host,
+                    "user": self.username,
+                    "password": self.password,
+                }
+                if self.charset:
+                    postgres_args["client_encoding"] = self.charset
+                self.dba = self.database_module.connect(**postgres_args)
             elif self.database_engine == MSSQL:
                 self.dba = self.database_module.connect(
                     server=self.host,