matrx-orm 3.1.103__tar.gz → 3.1.104__tar.gz

{matrx_orm-3.1.103 → matrx_orm-3.1.104}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: matrx-orm
-Version: 3.1.103
+Version: 3.1.104
 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.103 → matrx_orm-3.1.104}/matrx_orm/schema_builder/FEATURE.md

@@ -8,6 +8,10 @@ The schema builder generates importable models and manager wrappers from live da
   must never rely on catalog row order; otherwise identical generator runs
   oscillate every generated model containing that enum.
 - Guard: `packages/matrx-orm/tests/schema/test_enum_ordering.py`.
+- **Unknown catalog metrics sort last.** PostgreSQL can return `NULL` for a
+  relation's size or estimated row count; analysis must still complete and emit
+  generated code.
+- Guard: `packages/matrx-orm/tests/schema/test_schema_analysis.py`.
 
 ## Manager method names
 

{matrx_orm-3.1.103 → matrx_orm-3.1.104}/matrx_orm/schema_builder/schema_manager.py

@@ -15,6 +15,16 @@ from matrx_orm.schema_builder.tables import Table
 from matrx_orm.schema_builder.views import View
 
 
+def _relation_size_sort_key(relation: Table | View) -> tuple[bool, int]:
+    """Sort measured relations ahead of relations whose catalog size is unknown."""
+    return _nullable_int_sort_key(relation.size_bytes)
+
+
+def _nullable_int_sort_key(value: int | None) -> tuple[bool, int]:
+    """Sort known catalog metrics ahead of unknown values."""
+    return value is not None, value or 0
+
+
 class SchemaManager:
     def __init__(
         self,
@@ -85,17 +95,17 @@ class SchemaManager:
         )
 
         vcprint(
-            self.schema, title=f"SCHEMA MANAGER] with schema", verbose=self.verbose, color="blue"
+            self.schema, title="SCHEMA MANAGER] with schema", verbose=self.verbose, color="blue"
         )
         vcprint(
             self.database_project,
-            title=f"SCHEMA MANAGER] with database project",
+            title="SCHEMA MANAGER] with database project",
             verbose=self.verbose,
             color="blue",
         )
         vcprint(
             self.additional_schemas,
-            title=f"SCHEMA MANAGER] with additional schemas",
+            title="SCHEMA MANAGER] with additional schemas",
             verbose=self.verbose,
             color="blue",
         )
@@ -475,10 +485,10 @@ class SchemaManager:
             ),
             "all_enum_base_types": list(self.all_enum_base_types),
             "tables_by_size": sorted(
-                self.schema.tables.values(), key=lambda t: t.size_bytes, reverse=True
+                self.schema.tables.values(), key=_relation_size_sort_key, reverse=True
             )[:5],
             "views_by_size": sorted(
-                self.schema.views.values(), key=lambda v: v.size_bytes, reverse=True
+                self.schema.views.values(), key=_relation_size_sort_key, reverse=True
             )[:5],
             "fetch_strategies": table_fetch_strategy,
             "tables_with_foreign_keys": tables_with_fk,
@@ -489,7 +499,11 @@ class SchemaManager:
             "calc_exclusion_rules_count": calc_exclusion_rules_count,
             "sub_component_props_count": sub_component_props_count,
             "estimated_row_counts": dict(
-                sorted(estimated_row_counts.items(), key=lambda x: x[1], reverse=True)
+                sorted(
+                    estimated_row_counts.items(),
+                    key=lambda item: _nullable_int_sort_key(item[1]),
+                    reverse=True,
+                )
             ),
             "foreign_key_relationships_total": foreign_key_relationships_total,
             "referenced_by_relationships_total": referenced_by_relationships_total,

{matrx_orm-3.1.103 → matrx_orm-3.1.104}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "matrx-orm"
-version = "3.1.103"
+version = "3.1.104"
 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.104/tests/schema/test_schema_analysis.py

@@ -0,0 +1,26 @@
+from types import SimpleNamespace
+
+from matrx_orm.schema_builder.schema_manager import (
+    _nullable_int_sort_key,
+    _relation_size_sort_key,
+)
+
+
+def test_relation_size_sort_key_tolerates_unknown_catalog_sizes() -> None:
+    relations = [
+        SimpleNamespace(name="unknown", size_bytes=None),
+        SimpleNamespace(name="small", size_bytes=10),
+        SimpleNamespace(name="large", size_bytes=20),
+    ]
+
+    ordered = sorted(relations, key=_relation_size_sort_key, reverse=True)
+
+    assert [relation.name for relation in ordered] == ["large", "small", "unknown"]
+
+
+def test_nullable_catalog_metrics_sort_unknown_values_last() -> None:
+    assert sorted([None, 10, 20], key=_nullable_int_sort_key, reverse=True) == [
+        20,
+        10,
+        None,
+    ]