matrx-orm 3.1.22__tar.gz → 3.1.23__tar.gz

{matrx_orm-3.1.22 → matrx_orm-3.1.23}/CLAUDE.md

@@ -98,6 +98,13 @@ uv run pytest packages/matrx-orm/tests
 
 Tests must run against a Postgres instance the developer provides (or a testcontainers-based fixture). No sibling matrx package is needed. If a test needs `matrx-connect`, that's a sign the test is in the wrong package.
 
+Host generators may expose a focused schema pass by forwarding
+`only_schemas={...}` to `run_schema_generation`; aidream's focused package-model
+command is `uv run python db/generate.py --schema <schema> --models-only`.
+`models_only=True` skips unrelated schema/type/helper outputs but still performs
+live introspection and writes the canonical generated Model file. The unfiltered
+command remains the release-wide regeneration path.
+
 ---
 
 ## Known issues

{matrx_orm-3.1.22 → matrx_orm-3.1.23}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: matrx-orm
-Version: 3.1.22
+Version: 3.1.23
 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.22 → matrx_orm-3.1.23}/matrx_orm/schema_builder/runner.py

@@ -52,7 +52,11 @@ def _load_yaml(path: Path) -> dict[str, Any]:
 
 
 def run_schema_generation(
-    config_path: str | Path = "matrx_orm.yaml", skip_git_check: bool = False
+    config_path: str | Path = "matrx_orm.yaml",
+    skip_git_check: bool = False,
+    *,
+    only_schemas: set[str] | None = None,
+    models_only: bool = False,
 ) -> None:
     """
     Read a matrx_orm.yaml config file, register all databases, apply debug
@@ -233,6 +237,16 @@ def run_schema_generation(
             color="yellow",
         )
         return
+    if only_schemas:
+        requested = set(only_schemas)
+        generate_list = [entry for entry in generate_list if entry.get("schema", "public") in requested]
+        found = {entry.get("schema", "public") for entry in generate_list}
+        missing = requested - found
+        if missing:
+            raise ValueError(
+                "matrx-orm generation requested unknown schema target(s): "
+                + ", ".join(sorted(missing))
+            )
 
     # model_name_prefix is RETIRED. The schema-aware model_registry (keyed on
     # (schema, class_name)) makes same-named tables across schemas coexist with
@@ -309,7 +323,8 @@ def run_schema_generation(
                 output_overrides=output_overrides,
             )
             manager.initialize()
-            manager.schema.generate_schema_files()
+            if not models_only:
+                manager.schema.generate_schema_files()
             manager.schema.generate_models()
             vcprint(
                 f"[MATRX ORM] Done — database='{db_name}' schema='{schema}'\n",
@@ -337,14 +352,20 @@ def run_schema_generation(
             _close_pools()
             raise
 
-    _write_host_models_aggregator(
-        generate_list, python_root, output_config, host_schema_model_names
-    )
+    if not models_only:
+        _write_host_models_aggregator(
+            generate_list, python_root, output_config, host_schema_model_names
+        )
 
     # Declarative host→package DB wiring: resolve each incorporated package's
     # DB_REQUIREMENTS manifest against the inventory just written above and emit
     # the aidream-side wiring module. Only when writing Python directly to disk.
-    if cfg.get("package_wiring") and output_config.python and output_config.save_direct:
+    if (
+        not models_only
+        and cfg.get("package_wiring")
+        and output_config.python
+        and output_config.save_direct
+    ):
         try:
             from matrx_orm.schema_builder.package_wiring import generate_package_wiring
 

{matrx_orm-3.1.22 → matrx_orm-3.1.23}/pyproject.toml

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