Context
The repo has fixtures/ and CLI flags/env vars for offline catalog testing (--fixture, CPA_CATALOG_FIXTURE, CPA_FIXTURE_DIR), but CONTRIBUTING.md barely documents them. Newcomers struggle to run CLI tests without network.
Steps
- Read how fixtures are used in
packages/create-awesome-python-app/tests/ and CLI help.
- Add a "Testing with fixtures" section to
CONTRIBUTING.md modeled after CNA's fixture docs (adapted to CPA names).
- Include example commands for
--list-templates / a smoke scaffold using fixtures.
- Link relevant tests.
Acceptance criteria
Files
CONTRIBUTING.md
fixtures/ (reference)
- CLI / tests under
packages/create-awesome-python-app/
How to verify
A new contributor can follow the section and list templates offline without hitting GitHub raw URLs.
Context
The repo has
fixtures/and CLI flags/env vars for offline catalog testing (--fixture,CPA_CATALOG_FIXTURE,CPA_FIXTURE_DIR), butCONTRIBUTING.mdbarely documents them. Newcomers struggle to run CLI tests without network.Steps
packages/create-awesome-python-app/tests/and CLI help.CONTRIBUTING.mdmodeled after CNA's fixture docs (adapted to CPA names).--list-templates/ a smoke scaffold using fixtures.Acceptance criteria
CPA_CATALOG_FIXTURE,CPA_FIXTURE_DIR, and--fixtureFiles
CONTRIBUTING.mdfixtures/(reference)packages/create-awesome-python-app/How to verify
A new contributor can follow the section and list templates offline without hitting GitHub raw URLs.