Add integration tests and CI for template

.github/workflows/ci.yml

@@ -0,0 +1,19 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Run template tests
+        run: make test

.gitignore

@@ -0,0 +1,5 @@
+.claude/
+.venv/
+.pytest_cache/
+__pycache__/
+*.pyc

AGENTS.md

@@ -0,0 +1,28 @@
+# Agent guide for copier-minimal-python
+
+This is a copier template for Python projects. It generates new Python projects with uv, pytest, ruff, and optional CLI support.
+
+## Repository structure
+
+- `copier.yml` - Template configuration and questions
+- `template/` - Template files that get copied to new projects (uses Jinja2 templating)
+- `tests/` - Integration tests for the template itself
+- `Makefile` - Development commands for the template repo
+
+## Development
+
+- Run `make test` to verify the template generates correctly
+- The test creates a temporary project using copier with default values and checks basic structure
+
+## How the template works
+
+- `_subdirectory: template` in copier.yml tells copier to source files from `template/`
+- `_templates_suffix: ""` means all files are templates (no `.jinja` extension needed)
+- Template variables like `{{ project_name }}` are replaced during generation
+- Conditional blocks like `{% if has_cli %}` control optional features
+
+## Making changes
+
+1. Edit files in `template/` to change what gets generated
+2. Edit `copier.yml` to add/modify template questions
+3. Run `make test` to verify changes work

Makefile

@@ -0,0 +1,4 @@
+.PHONY: test
+
+test:
+	uv run pytest tests/ -v

copier.yml

@@ -1,5 +1,7 @@
 _min_copier_version: "9.0.0"
 
+_subdirectory: template
+
 _answers_file: .copier-answers.yml
 
 _templates_suffix: ""

pyproject.toml

@@ -0,0 +1,12 @@
+[project]
+name = "copier-minimal-python"
+version = "0.1.0"
+description = "A minimal copier template for Python projects"
+requires-python = ">=3.12"
+
+[dependency-groups]
+dev = [
+    "copier>=9.0.0",
+    "jinja2-time>=0.2.0",
+    "pytest>=8.0.0",
+]

tests/test_template.py

@@ -0,0 +1,41 @@
+"""Integration tests for the copier template."""
+
+import subprocess
+import tempfile
+from pathlib import Path
+
+
+def test_template_generates_with_defaults():
+    """Test that the template generates successfully with default values."""
+    template_dir = Path(__file__).parent.parent
+
+    with tempfile.TemporaryDirectory() as tmpdir:
+        dest = Path(tmpdir) / "test-project"
+
+        result = subprocess.run(
+            [
+                "uv",
+                "run",
+                "copier",
+                "copy",
+                "--defaults",
+                "--trust",
+                "--data",
+                "project_name=test-project",
+                "--data",
+                "description=A test project",
+                "--data",
+                "author_name=Test Author",
+                "--data",
+                "repo_owner=test-owner",
+                str(template_dir),
+                str(dest),
+            ],
+            capture_output=True,
+            text=True,
+        )
+
+        assert result.returncode == 0, f"copier failed: {result.stderr}"
+        assert dest.exists(), "Destination directory was not created"
+        assert (dest / "pyproject.toml").exists(), "pyproject.toml was not generated"
+        assert (dest / "src" / "test_project").exists(), "Package directory was not created"