fix(cli): accept space-separated --addons/--extend (0.2.8) (#242)

* fix(cli): accept space-separated --addons/--extend values

Typer only takes one value per flag; expand CNA-style `--addons a b`
into repeated flags before parsing so the documented UX works.

Co-authored-by: Cursor <cursoragent@cursor.com>

* style: fix ruff import wrap and CHANGELOG MD024

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: ulises-jeremias

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.2.8 - 2026-07-22
+
+### CLI / argv
+
+- Accept space-separated `--addons` / `--extend` values (CNA Commander parity): `--addons fastapi-docker github-setup` expands to repeated flags before Typer parses.
+
 ## 0.2.7 - 2026-07-22
 
 ### CLI

packages/create-awesome-python-app/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "create-awesome-python-app"
-version = "0.2.7"
+version = "0.2.8"
 description = "Composable scaffolding CLI for production-ready Python apps"
 readme = "README.md"
 requires-python = ">=3.12"

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

@@ -1,3 +1,3 @@
 """Create Awesome Python App CLI."""
 
-__version__ = "0.2.7"
+__version__ = "0.2.8"

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

@@ -71,6 +71,49 @@ def _preprocess_fixture_argv(argv: list[str] | None = None) -> list[str]:
     return out
 
 
+def _expand_variadic_option(argv: list[str], option: str) -> list[str]:
+    """Expand ``--addons a b`` into ``--addons a --addons b`` (CNA Commander parity).
+
+    Typer's ``list[str]`` Option only accepts one value per flag. Commander uses
+    ``--addons [extensions...]``, so users naturally write space-separated lists.
+    """
+    out: list[str] = []
+    i = 0
+    prefix = option + "="
+    while i < len(argv):
+        arg = argv[i]
+        if arg == option:
+            i += 1
+            values: list[str] = []
+            while i < len(argv) and not argv[i].startswith("-"):
+                values.append(argv[i])
+                i += 1
+            if not values:
+                out.append(option)
+            else:
+                for value in values:
+                    out.extend([option, value])
+            continue
+        if arg.startswith(prefix):
+            value = arg[len(prefix) :]
+            out.extend([option, value] if value else [option])
+            i += 1
+            continue
+        out.append(arg)
+        i += 1
+    return out
+
+
+def _preprocess_cli_argv(argv: list[str] | None = None) -> list[str]:
+    """Apply argv rewrites needed before Typer parses the CLI."""
+    out = _preprocess_fixture_argv(argv)
+    out = _expand_variadic_option(out, "--addons")
+    out = _expand_variadic_option(out, "--extend")
+    if argv is None:
+        sys.argv = out
+    return out
+
+
 def apply_fixture_mode(fixture: str | None) -> None:
     """Translate ``--fixture`` into ``CPA_CATALOG_FIXTURE`` / ``CPA_FIXTURE_DIR``."""
     if fixture is None and os.environ.get("CPA_CATALOG_FIXTURE") != "1":
@@ -204,7 +247,7 @@ def main() -> None:
     treat `cache` as project_directory).
     """
     check_python_version(">=3.12", "create-awesome-python-app")
-    _preprocess_fixture_argv()
+    _preprocess_cli_argv()
     if len(sys.argv) > 1 and sys.argv[1] == "cache":
         sys.argv = [sys.argv[0], *sys.argv[2:]]
         cache_app(prog_name="create-awesome-python-app cache")

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

@@ -271,6 +271,108 @@ async def fake_create_python_app(project_directory, options, *_args, **_kwargs):
     assert options["template"] == f"file://{tpl}"
 
 
+def test_expand_variadic_addons_and_extend() -> None:
+    from create_awesome_python_app.cli import (
+        _expand_variadic_option,
+        _preprocess_cli_argv,
+    )
+
+    assert _expand_variadic_option(
+        ["cpa", "my-api", "--addons", "fastapi-docker", "github-setup", "--no-install"],
+        "--addons",
+    ) == [
+        "cpa",
+        "my-api",
+        "--addons",
+        "fastapi-docker",
+        "--addons",
+        "github-setup",
+        "--no-install",
+    ]
+    assert _preprocess_cli_argv(
+        [
+            "cpa",
+            "my-api",
+            "--template",
+            "fastapi-starter",
+            "--addons",
+            "fastapi-docker",
+            "github-setup",
+            "--extend",
+            "a",
+            "b",
+            "--no-interactive",
+        ]
+    ) == [
+        "cpa",
+        "my-api",
+        "--template",
+        "fastapi-starter",
+        "--addons",
+        "fastapi-docker",
+        "--addons",
+        "github-setup",
+        "--extend",
+        "a",
+        "--extend",
+        "b",
+        "--no-interactive",
+    ]
+
+
+def test_space_separated_addons_after_project_directory(
+    tmp_path: Path, monkeypatch
+) -> None:
+    """CNA parity: ``--addons fastapi-docker github-setup`` (one flag, many values)."""
+    from create_awesome_python_app.cli import _preprocess_cli_argv
+
+    tpl = tmp_path / "tpl"
+    tpl.mkdir()
+    captured: dict[str, object] = {}
+
+    async def fake_check_for_latest_version(_package_name):
+        return None
+
+    async def fake_create_python_app(project_directory, options, *_args, **_kwargs):
+        captured["project_directory"] = project_directory
+        captured["options"] = options
+
+    monkeypatch.setattr(
+        "create_awesome_python_app.cli.check_for_latest_version",
+        fake_check_for_latest_version,
+    )
+    monkeypatch.setattr(
+        "create_awesome_python_app.cli.create_python_app",
+        fake_create_python_app,
+    )
+
+    argv = _preprocess_cli_argv(
+        [
+            "cpa",
+            "my-api",
+            "--template",
+            f"file://{tpl}",
+            "--addons",
+            "fastapi-docker",
+            "github-setup",
+            "--no-install",
+            "--no-interactive",
+        ]
+    )
+    result = runner.invoke(app, argv[1:])
+
+    text = (result.stdout or "") + (result.stderr or "")
+    assert result.exit_code == 0, text
+    assert "unexpected extra argument" not in text.lower()
+    options = captured["options"]
+    assert isinstance(options, dict)
+    addons = options["addons"]
+    assert isinstance(addons, list)
+    assert len(addons) == 2
+    assert any("fastapi-docker" in a for a in addons)
+    assert any("github-setup" in a for a in addons)
+
+
 def test_preprocess_fixture_argv_bare_and_with_dir() -> None:
     from create_awesome_python_app.cli import _FIXTURE_AUTO, _preprocess_fixture_argv