matrx-orm 3.1.1__tar.gz → 3.1.2__tar.gz

{matrx_orm-3.1.1 → matrx_orm-3.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: matrx-orm
-Version: 3.1.1
+Version: 3.1.2
 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.1 → matrx_orm-3.1.2}/matrx_orm/session/dag.py

@@ -46,6 +46,9 @@ from matrx_orm.session.op import SessionOp
 
 logger = logging.getLogger("matrx_orm.session.dag")
 
+# (model, field) pairs already reported as unresolvable — see _resolve_fk_deps.
+_WARNED_UNRESOLVED_FKS: set[tuple[str, str]] = set()
+
 
 class DependencyCycleError(RuntimeError):
     """Raised when the Session ops describe a cyclic write dependency."""
@@ -144,14 +147,22 @@ def _resolve_fk_deps(
         try:
             related_model = fk_ref.related_model
         except ValueError as exc:
-            logger.warning(
-                "[matrx_orm.session] FK '%s.%s' did not resolve (%s) — no in-flush "
-                "dependency inferred for it. The write proceeds; fix the reference "
-                "(regenerate models) so the boot audit stays clean.",
-                getattr(op.model_cls, "__name__", "?"),
-                fk_field_name,
-                exc,
-            )
+            # Warn ONCE per (model, field). `related_model` is a cached_property and
+            # exceptions are not cached, so it re-raises on every op of every flush —
+            # an unresolvable FK on a hot table would otherwise flood app_log forever
+            # and bury the signal it exists to raise.
+            key = (getattr(op.model_cls, "__name__", "?"), fk_field_name)
+            if key not in _WARNED_UNRESOLVED_FKS:
+                _WARNED_UNRESOLVED_FKS.add(key)
+                logger.warning(
+                    "[matrx_orm.session] FK '%s.%s' did not resolve (%s) — no in-flush "
+                    "dependency inferred for it. The write proceeds; fix the reference "
+                    "(regenerate models) so the boot audit stays clean. This warns once "
+                    "per process.",
+                    key[0],
+                    key[1],
+                    exc,
+                )
             continue
         if related_model is None:
             continue

{matrx_orm-3.1.1 → matrx_orm-3.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "matrx-orm"
-version = "3.1.1"
+version = "3.1.2"
 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" }

{matrx_orm-3.1.1 → matrx_orm-3.1.2}/tests/session/test_dag.py

@@ -103,6 +103,9 @@ class _UnresolvableFK:
     ],
 )
 def test_unresolvable_fk_reference_does_not_kill_the_write(FakeMessage, message):
+    from matrx_orm.session.dag import _WARNED_UNRESOLVED_FKS
+
+    _WARNED_UNRESOLVED_FKS.clear()
     """A NAME that won't resolve must never fail a WRITE.
 
     An unresolvable target cannot be a parent row in THIS flush, so it carries