fastapi-testing

A set of testing guidelines for FastAPI, a Python framework for building web APIs. It covers normal and asynchronous requests and replacing real dependencies with test versions.

In plain words
What is it for?
Writing or reviewing pytest tests for FastAPI endpoints, including tests that run without starting a web server.
Why use it?
It helps tests behave like real API calls and avoids fragile ways of replacing databases, authentication, or other services.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/dkmqflx/fastapi-best-practices-plugin/fastapi-testing
Any agent
npx skills add dkmqflx/fastapi-best-practices-plugin --skill fastapi-testing
Clone the repo
git clone --depth 1 https://github.com/dkmqflx/fastapi-best-practices-plugin

Made for: Claude Code, Codex.

Per session 60 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 425 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00060 $0.00425
Opus 5 $0.00030 $0.00212
Sonnet 5 $0.00012 $0.00085
Haiku 4.5 $0.00006 $0.00042

Measured yesterday against content hash 381a45d2445e, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

fastapi-testing scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/fastapi-best-practices/skills/fastapi-testing/SKILL.md · 49 lines

What it actually says

FastAPI Testing

Best practices for testing FastAPI applications, following the official testing docs (https://fastapi.tiangolo.com/tutorial/testing/). Covers exercising endpoints through real HTTP semantics via TestClient/AsyncClient, and swapping dependencies safely with dependency_overrides. Each rule pairs an antipattern with the idiomatic pytest pattern.

When to Apply

Reference these guidelines when:

  • Writing tests for FastAPI path operations
  • Swapping a dependency (DB session, auth, external client) for a test double
  • Writing async tests against an ASGI app without a running server
  • Reviewing or refactoring an existing FastAPI test suite

Rules

  • testclient (HIGH) — test endpoints through fastapi.testclient.TestClient (real HTTP, in-process)
  • dependency-overrides (HIGH) — swap deps with app.dependency_overrides, not monkeypatch
  • async-client (MEDIUM) — use httpx AsyncClient + ASGITransport for async tests

How to Use

Read the individual rule file for the detailed explanation and before/after example:

rules/testclient.md
rules/dependency-overrides.md
rules/async-client.md

Each rule file contains:

  • A short explanation of why it matters, tied to the official docs
  • An Incorrect example (the antipattern)
  • A Correct example (the official pattern)
  • A link to the relevant page on https://fastapi.tiangolo.com/

All examples follow the official FastAPI documentation and avoid deprecated APIs.

Files

What ships with it

3 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 49 lines · 60 tokens per session scan A 381a45d2445e

Subscribe to this mod's changes

fastapi-testing is a skill published in the GitHub repository dkmqflx/fastapi-best-practices-plugin (1 stars, last pushed 2mo ago), licensed MIT. It adds 60 tokens to every session and 425 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

Cursor rules for FastAPI services with router/service/repository boundaries, typ

Cursor rules for FastAPI services with router/service/repository boundaries, typed provider adapters, bulkhead isolation, idempotency, and domain exceptions.

AmariahAK/atlarix-skills · 14 tokens

FastAPI best practices and patterns for building modern Python web APIs

Skill "FastAPI best practices and patterns for building modern Python web APIs" from AmariahAK/atlarix-skills, covering when to use this skill, source, fastapi best practices, project structure and api design.

AmariahAK/atlarix-skills · 12 tokens

fastapi-best-practices

Use this skill when creating or modifying Python backend services with FastAPI. It defines API design, security, and testing standards.

ApexIQ/skillsmith · 32 tokens

api-design

REST/GraphQL/gRPC API design best practices. Use when designing APIs, defining contracts, handling versioning. Covers OpenAPI 3.2, GraphQL Federation, gRPC streaming.

majiayu000/spellbook · 42 tokens

trellis-start

Initializes an AI development session by reading workflow guides, developer identity, git status, active tasks, and project guidelines from .trellis/. Classifies incoming tasks and routes to brainstorm, direct edit, or task workflow. Use when beginning a new coding session, resuming work, starting a new task, or…

yuqie6/ProductFlow · 73 tokens

general-video

The fallback workflow for authoring custom HyperFrames video compositions at any length or format — longer or multi-scene pieces, brand / sizzle reels, montages, title cards, static loops, and freeform compositions. Input- and length-agnostic. If a specialized workflow clearly fits the input — a marketed product, a…

Sma1lboy/rove · 114 tokens