pgdbm

Use when deciding which pgdbm pattern to use (standalone, dual-mode library, or shared pool) - provides decision tree based on deployment context without requiring doc exploration

Use before implementing pgdbm patterns to avoid common mistakes - provides rationalization table and red flags that prevent pool multiplication, schema errors, and template syntax violations

Use when implementing pgdbm database operations - provides complete AsyncDatabaseManager and DatabaseConfig API with all methods and parameters

Use when building reusable PyPI package with pgdbm - provides complete pattern for libraries that work standalone or embedded without needing examples

Use when working with database migrations in pgdbm - provides complete AsyncMigrationManager API with all methods and migration file format

Use when implementing shared connection pool for multiple services in same application - provides complete setup steps for FastAPI/multi-service apps without needing examples

Use when building simple standalone service or microservice with its own database - provides complete setup without shared pool complexity

Use when writing tests for pgdbm-based code - provides fixture selection decision tree and complete usage patterns without needing testing docs

Use when setting up pgdbm database connections, migrations, or multi-service architecture - provides mental model of one pool/many schemas/template syntax and complete API reference without needing to read docs