matrx-orm 3.1.45__tar.gz → 3.1.47__tar.gz

{matrx_orm-3.1.45 → matrx_orm-3.1.47}/.gitignore

@@ -269,4 +269,9 @@ packages/matrx-utils/matrx_utils/data_in_code/data_history.json
 !.env.example
 !.env.sample
 !.env.template
+
+# Never commit local OAuth client/token artifacts
+credentials.json
+token*.pickle
+token*.json
 tests_trials/rag_tests/kg_export_output/

{matrx_orm-3.1.45 → matrx_orm-3.1.47}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: matrx-orm
-Version: 3.1.45
+Version: 3.1.47
 Summary: Async-first PostgreSQL ORM with bidirectional migrations, schema introspection, many-to-many relationships, and built-in state caching
 Project-URL: Homepage, https://github.com/AI-Matrix-Engine/aidream-current
 Project-URL: Repository, https://github.com/AI-Matrix-Engine/aidream-current

{matrx_orm-3.1.45 → matrx_orm-3.1.47}/matrx_orm/core/db_function.py

@@ -127,13 +127,14 @@ def _validate_identifier(name: str, kind: str) -> None:
         )
 
 
-async def call_function(
+async def call_function(  # noqa: ASYNC109 — maps onto asyncpg's per-call timeout
     database: str,
     schema: str,
     function: str,
     *args: Any,
     mode: Literal["scalar", "none", "rows"] = "scalar",
     field: str | None = None,
+    timeout: float | None = None,
 ) -> Any:
     """Call ``schema.function(args...)`` and return its value.
 
@@ -154,6 +155,12 @@ async def call_function(
             just this field (``(schema.function(args)).field``) instead of
             decoding the whole row. Mutually exclusive with ``mode="none"``
             and ``mode="rows"``.
+        timeout: per-call driver timeout in seconds, overriding the pool's
+            ``command_timeout`` (default 10s). Use for known-slow analytical
+            functions (aggregation RPCs) that legitimately exceed the pool
+            default; ``None`` keeps the pool's setting. A server-side
+            ``statement_timeout`` (e.g. from ``rls_session``) still applies
+            independently.
 
     Returns:
         The scalar value (mode="scalar"), ``None`` (mode="none"), or
@@ -180,21 +187,21 @@ async def call_function(
     active_conn = get_active_connection()
     if active_conn is not None:
         if mode == "none":
-            await active_conn.execute(sql, *bound_args)
+            await active_conn.execute(sql, *bound_args, timeout=timeout)
             return None
         if mode == "rows":
-            rows = await active_conn.fetch(sql, *bound_args)
+            rows = await active_conn.fetch(sql, *bound_args, timeout=timeout)
             return [dict(r) for r in rows]
-        return await active_conn.fetchval(sql, *bound_args)
+        return await active_conn.fetchval(sql, *bound_args, timeout=timeout)
 
     async with AsyncDatabaseManager.get_connection(database) as conn:
         if mode == "none":
-            await conn.execute(sql, *bound_args)
+            await conn.execute(sql, *bound_args, timeout=timeout)
             return None
         if mode == "rows":
-            rows = await conn.fetch(sql, *bound_args)
+            rows = await conn.fetch(sql, *bound_args, timeout=timeout)
             return [dict(r) for r in rows]
-        return await conn.fetchval(sql, *bound_args)
+        return await conn.fetchval(sql, *bound_args, timeout=timeout)
 
 
 def call_function_sync(
@@ -204,6 +211,7 @@ def call_function_sync(
     *args: Any,
     mode: Literal["scalar", "none", "rows"] = "scalar",
     field: str | None = None,
+    timeout: float | None = None,
 ) -> Any:
     """Synchronous twin of :func:`call_function`. Sync contexts only."""
     import asyncio
@@ -218,4 +226,6 @@ def call_function_sync(
     except RuntimeError as e:
         if "no running event loop" not in str(e):
             raise
-    return run_sync(call_function(database, schema, function, *args, mode=mode, field=field))
+    return run_sync(
+        call_function(database, schema, function, *args, mode=mode, field=field, timeout=timeout)
+    )

{matrx_orm-3.1.45 → matrx_orm-3.1.47}/matrx_orm/session/README.md

@@ -5,7 +5,7 @@
 > enforcement, transactional flush, integrated lifecycle watchdog.
 
 This package is the matrx-orm Phase A flagship feature. It makes the
-following pattern the canonical way to write rows in matrx-orm:
+following pattern the one way to write rows in matrx-orm:
 
 ```python
 from matrx_orm import Session

{matrx_orm-3.1.45 → matrx_orm-3.1.47}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "matrx-orm"
-version = "3.1.45"
+version = "3.1.47"
 description = "Async-first PostgreSQL ORM with bidirectional migrations, schema introspection, many-to-many relationships, and built-in state caching"
 readme = "README.md"
 license = { text = "MIT" }