csrd-utils 0.3.102__tar.gz → 0.3.103__tar.gz

{csrd_utils-0.3.102 → csrd_utils-0.3.103}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: csrd-utils
-Version: 0.3.102
+Version: 0.3.103
 Summary: CLI utilities for csrd service generation and feature augmentation
 Project-URL: Repository, https://github.com/csrd-api/fastapi-common
 Project-URL: Documentation, https://github.com/csrd-api/fastapi-common/tree/main/packages/utils

{csrd_utils-0.3.102 → csrd_utils-0.3.103}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "csrd-utils"
-version = "0.3.102"
+version = "0.3.103"
 description = "CLI utilities for csrd service generation and feature augmentation"
 license = { text = "MIT" }
 requires-python = ">=3.12"

{csrd_utils-0.3.102 → csrd_utils-0.3.103}/src/csrd_utils/v2/compose/renderer.py

@@ -13,7 +13,7 @@ from .infra import (
 )
 from .loader import default_spec, load_spec, save_spec, spec_file_path
 from .scaffolder import scaffold_services
-from .service_renderers import render_init, render_requirements, render_settings
+from .service_renderers import render_init, render_migrations, render_requirements, render_settings
 from .yaml_editor import dumps_yaml
 
 WORKSPACE_MARKER_FILENAME = ".csrd-workspace"
@@ -404,6 +404,10 @@ def render_workspace(output_dir: Path, *, git_init: bool = False) -> Path:
         (svc_dir / "__init__.py").write_text(render_init(svc, spec), encoding="utf-8")
         (svc_dir / "requirements.txt").write_text(render_requirements(svc, spec), encoding="utf-8")
 
+        migrations_content = render_migrations(svc, spec)
+        if migrations_content is not None:
+            (svc_dir / "migrations.py").write_text(migrations_content, encoding="utf-8")
+
     if spec.workspace.git_init:
         maybe_git_init(output_dir)
 

{csrd_utils-0.3.102 → csrd_utils-0.3.103}/src/csrd_utils/v2/compose/service_renderers.py

@@ -270,10 +270,9 @@ def render_init(svc: ServiceNode, spec: ComposeSpec) -> str:
         if desc is not None:
             descriptors.append((augment.name, desc))
 
-    # Check whether this service has db-config (needs migration startup)
-    has_db = any(name == "db-config" for name, _ in descriptors) or any(
-        name == "jwt-auth-provider" for name, _ in descriptors
-    )
+    # Check whether this service has db-config (needs migration startup).
+    # jwt-auth-provider handles its own migrations internally via _get_adapter.
+    has_db = any(name == "db-config" for name, _ in descriptors)
 
     # Collect imports
     imports = [
@@ -399,3 +398,81 @@ def render_init(svc: ServiceNode, spec: ComposeSpec) -> str:
     )
 
     return "\n".join(imports + body)
+
+
+# ---------------------------------------------------------------------------
+# migrations.py
+# ---------------------------------------------------------------------------
+
+
+def render_migrations(svc: ServiceNode, spec: ComposeSpec) -> str | None:
+    """Render ``migrations.py`` with auto-imported crud-scaffold migrations.
+
+    Returns ``None`` when the service has no ``db-config`` augment.
+
+    The rendered file is designed to work both ways:
+
+    * **With the generator** — crud-scaffold entity migrations are
+      auto-imported on each render.  Re-running the generator picks up
+      new entities.
+    * **Without the generator** — users can add migrations directly
+      to the list or import from their own ``migrations_*.py`` files.
+      The file is plain Python; no special tooling required.
+    """
+    augment_names: set[str] = set()
+    for ws_aug in spec.workspace.augments:
+        desc = AUGMENT_REGISTRY.get(ws_aug.name)
+        if desc is not None and desc.applies_to_role == svc.role:
+            augment_names.add(ws_aug.name)
+    for augment in svc.augments:
+        augment_names.add(augment.name)
+
+    if "db-config" not in augment_names:
+        return None
+
+    # Collect entity names from crud-scaffold augments
+    entities: list[str] = []
+    for augment in svc.augments:
+        if augment.name == "crud-scaffold":
+            entity_raw = augment.options.get("entity_name", "item")
+            entity = entity_raw if isinstance(entity_raw, str) else entity_raw[0]
+            snake = entity.replace("-", "_").lower()
+            entities.append(snake)
+
+    lines = [
+        '"""Database migrations for this service.',
+        "",
+        "This file is rendered by the generator but is safe to edit directly.",
+        "If you stop using the generator, just add Migration entries to the list.",
+        '"""',
+        "",
+        "from csrd.migration import Migration",
+    ]
+
+    if entities:
+        lines.append("")
+        for snake in entities:
+            lines.append(f"from .migrations_{snake} import {snake}_migration")
+
+    lines.append("")
+    lines.append("")
+    lines.append("migrations: list[Migration] = [")
+
+    if entities:
+        for snake in entities:
+            lines.append(f"    {snake}_migration,")
+        lines.append("    # Add custom migrations below this line")
+    else:
+        lines.append("    # Migration(")
+        lines.append('    #     version="001",')
+        lines.append('    #     description="Initial schema",')
+        lines.append('    #     up="CREATE TABLE ...",')
+        lines.append('    #     down="DROP TABLE ...",')
+        lines.append("    # ),")
+
+    lines.append("]")
+    lines.append("")
+    lines.append('__all__ = ("migrations",)')
+    lines.append("")
+
+    return "\n".join(lines)

csrd_utils-0.3.102/src/csrd_utils/v2/templates/augments/db-config/migrations.py.template

@@ -1,21 +0,0 @@
-"""Database migrations for $service_name.
-
-Add Migration entries to this list as your schema evolves.
-The MigrationRunner applies them in order and tracks which
-have been applied.
-
-This file is scaffolded once and never overwritten.
-"""
-
-from csrd.migration import Migration
-
-migrations: list[Migration] = [
-    # Migration(
-    #     version="001",
-    #     description="Initial schema",
-    #     up="CREATE TABLE ...",
-    #     down="DROP TABLE ...",
-    # ),
-]
-
-__all__ = ("migrations",)