feat(cli): enable shell completion for bash/zsh/fish

Closes #166.

Author: ulises-jeremias

README.md

@@ -59,6 +59,13 @@ uv sync
 uv run create-awesome-python-app --help
 ```
 
+### Shell completion
+
+```bash
+create-awesome-python-app --install-completion   # bash / zsh / fish
+create-awesome-python-app --show-completion      # print script only
+```
+
 ## License
 
 MIT — see [LICENSE](./LICENSE).

packages/create-awesome-python-app/README.md

@@ -9,3 +9,18 @@ uv run create-awesome-python-app --help
 uvx create-awesome-python-app@latest my-app   # after PyPI publish
 pipx run create-awesome-python-app my-app
 ```
+
+## Shell completion
+
+Typer installs completion scripts for bash, zsh, and fish:
+
+```bash
+# Interactive install into your shell profile
+create-awesome-python-app --install-completion
+
+# Or print the script and source it manually
+create-awesome-python-app --show-completion
+```
+
+After installing, restart the shell (or `source` your profile) and tab-complete
+flags such as `--template`, `--addons`, and `cache` subcommands.

packages/create-awesome-python-app/src/create_awesome_python_app/cli.py

@@ -28,7 +28,7 @@
     name="create-awesome-python-app",
     help="Composable scaffolding CLI for production-ready Python apps.",
     no_args_is_help=False,
-    add_completion=False,
+    add_completion=True,
 )
 cache_app = typer.Typer(help="Inspect and manage the local template cache")
 app.add_typer(cache_app, name="cache")

packages/create-awesome-python-app/tests/test_flags.py

@@ -23,5 +23,7 @@ def test_help_lists_scaffold_flags() -> None:
         "--set",
         "--force",
         "--no-install",
+        "--install-completion",
+        "--show-completion",
     ]:
         assert flag in text