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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: csrd-utils
-Version: 0.3.25
+Version: 0.3.26
 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.26}/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.26}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "csrd-utils"
-version = "0.3.25"
+version = "0.3.26"
 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.26}/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)