python-testing-strategies — Claude Code skill for FastAPI tests

What python-testing-strategies does

This skill hands the agent a working set of conventions for testing a FastAPI project. It covers the async client built on httpx.AsyncClient with ASGITransport, fixture layout, small factory functions for test data, and test names that say what broke — test_get_item_not_found, test_create_item_missing_name.

Each endpoint gets a checklist: the happy path through create, read, update and delete, a 404 case, a 422 validation error, a 401 when the route is protected, and soft delete where removed rows must not come back. A gotchas section lists the failures that waste the most time. Skip asyncio_mode = "auto" in pyproject.toml and async tests either collect nothing or hang. Reach for Starlette's synchronous TestClient instead of AsyncClient and async bugs stay hidden, because the sync client never touches the event loop. Database state also bleeds across tests unless an autouse=True fixture resets it, and then CI failures depend on run order.

The skill can read, write and edit files, search the project, and run shell commands. Install it with npx skills add for Claude, Codex, Cursor, Gemini CLI or OpenCode; GitHub Copilot uses gh skill install instead.