csrd-utils 0.3.25__tar.gz → 0.3.27__tar.gz

{csrd_utils-0.3.25 → csrd_utils-0.3.27}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: csrd-utils
-Version: 0.3.25
+Version: 0.3.27
 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
@@ -40,10 +40,21 @@ csrd feature add workers --service .
 csrd doctor --service .
 csrd audit                                          # if cwd is workspace, audits all services
 csrd audit --service .                              # explicitly audit one service path
+csrd completion bash                                # print bash completion script
 ```
 
 `feature plan --json` is useful for CI or tooling wrappers.
 
+### Bash tab completion
+
+Enable command/subcommand completion in bash:
+
+```bash
+source <(csrd completion bash)
+```
+
+Then examples like `csrd ne<TAB>` and `csrd new wor<TAB>` complete to `new` and `workspace`.
+
 ### Workspace extraction command
 
 Service extraction into a sibling workspace is supported:

{csrd_utils-0.3.25 → csrd_utils-0.3.27}/README.md

@@ -27,10 +27,21 @@ csrd feature add workers --service .
 csrd doctor --service .
 csrd audit                                          # if cwd is workspace, audits all services
 csrd audit --service .                              # explicitly audit one service path
+csrd completion bash                                # print bash completion script
 ```
 
 `feature plan --json` is useful for CI or tooling wrappers.
 
+### Bash tab completion
+
+Enable command/subcommand completion in bash:
+
+```bash
+source <(csrd completion bash)
+```
+
+Then examples like `csrd ne<TAB>` and `csrd new wor<TAB>` complete to `new` and `workspace`.
+
 ### Workspace extraction command
 
 Service extraction into a sibling workspace is supported:

{csrd_utils-0.3.25 → csrd_utils-0.3.27}/pyproject.toml

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

{csrd_utils-0.3.25 → csrd_utils-0.3.27}/src/csrd_utils/__main__.py

@@ -71,6 +71,75 @@ WORKSPACE_MARKER = ".csrd-workspace"
 WORKSPACE_CLUSTER_SPEC = Path(".csrd") / "cluster.yaml"
 
 
+def _parser_shape(
+    parser: argparse.ArgumentParser,
+    chain: tuple[str, ...] = (),
+) -> tuple[dict[tuple[str, ...], list[str]], dict[tuple[str, ...], list[str]]]:
+    commands: dict[tuple[str, ...], list[str]] = {}
+    options: dict[tuple[str, ...], list[str]] = {}
+
+    subcommands: list[str] = []
+    flags: list[str] = []
+    for action in parser._actions:
+        if isinstance(action, argparse._SubParsersAction):
+            subcommands.extend(sorted(action.choices.keys()))
+            for name, subparser in action.choices.items():
+                child_chain = (*chain, name)
+                child_commands, child_options = _parser_shape(subparser, child_chain)
+                commands.update(child_commands)
+                options.update(child_options)
+        else:
+            flags.extend([item for item in action.option_strings if item.startswith("-")])
+
+    commands[chain] = sorted(dict.fromkeys(subcommands))
+    options[chain] = sorted(dict.fromkeys(flags))
+    return commands, options
+
+
+def _render_bash_completion(parser: argparse.ArgumentParser) -> str:
+    commands, options = _parser_shape(parser)
+
+    lines = [
+        "# bash completion for csrd",
+        "_csrd_completion() {",
+        "  local cur key token",
+        '  cur="${COMP_WORDS[COMP_CWORD]}"',
+        '  key=""',
+        "",
+        '  for token in "${COMP_WORDS[@]:1:COMP_CWORD-1}"; do',
+        '    case "$token" in',
+        "      -*) continue ;;",
+        "    esac",
+        '    if [[ -n "$key" ]]; then',
+        '      key="$key $token"',
+        "    else",
+        '      key="$token"',
+        "    fi",
+        "  done",
+        "",
+        '  case "$key" in',
+    ]
+
+    for chain in sorted(commands.keys()):
+        key = " ".join(chain)
+        command_candidates = commands.get(chain, [])
+        option_candidates = options.get(chain, [])
+        candidates = " ".join(command_candidates + option_candidates).strip()
+        if not candidates:
+            continue
+        lines.append(f'    "{key}") COMPREPLY=( $(compgen -W "{candidates}" -- "$cur") ) ;;')
+
+    lines.extend(
+        [
+            "    *) COMPREPLY=() ;;",
+            "  esac",
+            "}",
+            "complete -F _csrd_completion csrd csrd-utils csrt",
+        ]
+    )
+    return "\n".join(lines) + "\n"
+
+
 def _workspace_services_dir(workspace_root: Path) -> Path:
     return workspace_root / "src"
 
@@ -947,6 +1016,10 @@ def _build_parser() -> argparse.ArgumentParser:
     extract.add_argument("--json", action="store_true", help="Print extraction result as JSON")
     extract.add_argument("--force", action="store_true", help="Overwrite target service path")
 
+    completion = sub.add_parser("completion", help="Shell completion helpers")
+    completion_sub = completion.add_subparsers(dest="completion_shell", required=True)
+    completion_sub.add_parser("bash", help="Print bash completion script")
+
     return parser
 
 
@@ -1180,6 +1253,10 @@ def main() -> int:
             print(f"Refreshed source cluster scaffold at: {result['source_cluster']}")
         return 0
 
+    if args.command == "completion" and args.completion_shell == "bash":
+        print(_render_bash_completion(parser), end="")
+        return 0
+
     if args.command == "doctor":
         return _run_doctor(args.service, args.json)
 

csrd_utils-0.3.27/src/csrd_utils/templates/cookiecutter-service/{{cookiecutter.service_name}}/tests/unit/test_settings_contracts.py

@@ -0,0 +1,73 @@
+"""Unit tests for settings validator branches and package exports."""
+
+from __future__ import annotations
+
+import importlib
+from types import SimpleNamespace
+
+import pytest
+
+from app.settings import Settings
+
+
+def test_validate_db_credentials_returns_self_without_database() -> None:
+    candidate = SimpleNamespace(has_database=False)
+    assert Settings.validate_db_credentials(candidate) is candidate
+
+
+def test_validate_db_credentials_returns_self_for_sqlite() -> None:
+    candidate = SimpleNamespace(has_database=True, db_kind="sqlite")
+    assert Settings.validate_db_credentials(candidate) is candidate
+
+
+def test_validate_db_credentials_skips_non_production_when_not_enforced() -> None:
+    candidate = SimpleNamespace(
+        has_database=True,
+        db_kind="postgres",
+        enforce_strong_db_credentials=False,
+        app_env="development",
+    )
+    assert Settings.validate_db_credentials(candidate) is candidate
+
+
+@pytest.mark.parametrize(
+    ("field", "value", "expected"),
+    [
+        ("db_user", "service_user", "DB_USER"),
+        ("db_password", "change_me", "DB_PASSWORD"),
+        ("db_name", "service_db", "DB_NAME"),
+    ],
+)
+def test_validate_db_credentials_rejects_weak_defaults(
+    field: str,
+    value: str,
+    expected: str,
+) -> None:
+    candidate = SimpleNamespace(
+        has_database=True,
+        db_kind="postgres",
+        enforce_strong_db_credentials=True,
+        app_env="production",
+        db_user="app_user",
+        db_password="StrongPass123!",
+        db_name="inventory_db",
+    )
+    setattr(candidate, field, value)
+
+    with pytest.raises(ValueError, match=expected):
+        Settings.validate_db_credentials(candidate)
+
+
+def test_app_package_init_modules_expose_tuple_all() -> None:
+    for module_name in [
+        "app.delegates",
+        "app.dependencies",
+        "app.middleware",
+        "app.repositories",
+        "app.workers",
+    ]:
+        module = importlib.import_module(module_name)
+        exports = getattr(module, "__all__", ())
+        assert isinstance(exports, tuple)
+        for exported_name in exports:
+            assert hasattr(module, exported_name)