test(cli): integration tests scaffolding from cpa-templates (#143)

Closes #139

Co-authored-by: ulises-jeremias <ulises.jeremias@users.noreply.github.com>

Author: ulises-jeremias

.github/workflows/test.yml

@@ -10,11 +10,19 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
+      - name: Checkout cpa-templates
+        uses: actions/checkout@v4
+        with:
+          repository: Create-Python-App/cpa-templates
+          path: cpa-templates
       - uses: astral-sh/setup-uv@v6
         with:
           enable-cache: true
       - uses: actions/setup-python@v5
         with:
           python-version-file: .python-version
       - run: uv sync --group dev
-      - run: uv run pytest --cov --cov-report=term-missing
+      - name: Run tests
+        env:
+          CPA_TEMPLATES_ROOT: ${{ github.workspace }}/cpa-templates
+        run: uv run pytest --cov --cov-report=term-missing

CONTRIBUTING.md

@@ -24,4 +24,13 @@ make typecheck
 
 ## Templates
 
-Template bank work will live in `cpa-templates` (tracked in #44). Until then use `fixtures/`.
+Template and extension authoring lives in [`cpa-templates`](https://github.com/Create-Python-App/cpa-templates).
+
+To test scaffolding against a local `cpa-templates` checkout:
+
+```bash
+export CPA_TEMPLATES_ROOT=/path/to/cpa-templates
+uv run pytest packages/create-awesome-python-app/tests/test_cpa_templates_integration.py -v
+```
+
+The catalog is fetched from `cpa-templates` `templates.json` (override with `CPA_CATALOG_URL`).

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

@@ -0,0 +1,96 @@
+"""Integration tests against the cpa-templates bank."""
+
+from __future__ import annotations
+
+import os
+import subprocess
+from pathlib import Path
+
+import pytest
+
+_REPO_ROOT = Path(__file__).resolve().parents[4]
+_DEFAULT_CPA_TEMPLATES = (_REPO_ROOT.parent / "cpa-templates").resolve()
+CPA_TEMPLATES_ROOT = Path(
+    os.environ.get("CPA_TEMPLATES_ROOT", str(_DEFAULT_CPA_TEMPLATES))
+).resolve()
+FASTAPI_TEMPLATE = CPA_TEMPLATES_ROOT / "templates" / "fastapi-starter"
+GITHUB_SETUP = CPA_TEMPLATES_ROOT / "extensions" / "github-setup"
+
+
+def _cpa_templates_available() -> bool:
+    return (FASTAPI_TEMPLATE / "pyproject.toml").is_file()
+
+
+@pytest.mark.skipif(
+    not _cpa_templates_available(),
+    reason="cpa-templates checkout not available (set CPA_TEMPLATES_ROOT)",
+)
+def test_scaffold_fastapi_starter_from_cpa_templates(
+    tmp_path: Path, monkeypatch: pytest.MonkeyPatch
+) -> None:
+    monkeypatch.setenv("CI", "1")
+    monkeypatch.setenv("CPA_SKIP_GIT", "1")
+    dest = tmp_path / "api"
+    template_url = f"file://{CPA_TEMPLATES_ROOT}?subdir=templates/fastapi-starter"
+
+    result = subprocess.run(
+        [
+            "uv",
+            "run",
+            "create-awesome-python-app",
+            "--template",
+            template_url,
+            "--no-interactive",
+            "--no-install",
+            str(dest),
+        ],
+        cwd=_REPO_ROOT,
+        capture_output=True,
+        text=True,
+        check=False,
+    )
+    assert result.returncode == 0, result.stdout + result.stderr
+    assert (dest / "app" / "main.py").is_file()
+    assert (dest / "pyproject.toml").is_file()
+
+    sync = subprocess.run(["uv", "sync"], cwd=dest, capture_output=True, text=True)
+    assert sync.returncode == 0, sync.stderr
+
+    lint = subprocess.run(["uv", "run", "ruff", "check", "."], cwd=dest, capture_output=True, text=True)
+    assert lint.returncode == 0, lint.stderr
+
+    tests = subprocess.run(["uv", "run", "pytest", "-q"], cwd=dest, capture_output=True, text=True)
+    assert tests.returncode == 0, tests.stdout + tests.stderr
+
+
+@pytest.mark.skipif(
+    not (_cpa_templates_available() and GITHUB_SETUP.is_dir()),
+    reason="cpa-templates extensions not available",
+)
+def test_scaffold_fastapi_with_github_setup_extension(
+    tmp_path: Path, monkeypatch: pytest.MonkeyPatch
+) -> None:
+    monkeypatch.setenv("CI", "1")
+    monkeypatch.setenv("CPA_SKIP_GIT", "1")
+    dest = tmp_path / "api-ext"
+    repo = CPA_TEMPLATES_ROOT
+    result = subprocess.run(
+        [
+            "uv",
+            "run",
+            "create-awesome-python-app",
+            "--template",
+            f"file://{repo}?subdir=templates/fastapi-starter",
+            "--addons",
+            f"file://{repo}?subdir=extensions/github-setup",
+            "--no-interactive",
+            "--no-install",
+            str(dest),
+        ],
+        cwd=_REPO_ROOT,
+        capture_output=True,
+        text=True,
+        check=False,
+    )
+    assert result.returncode == 0, result.stdout + result.stderr
+    assert (dest / ".github" / "workflows" / "ci.yml").is_file()