standalone-service

What problem does it solve?

Solves the challenge of building modules that own their own PostgreSQL database by providing a complete standalone pattern with its own connection pool and migrations.

Core Features & Use Cases

• Owns its database and pool; runs migrations in isolation.
• Simple pattern for services that require full isolation or background workers.
• End-to-end lifecycle: configure, connect, migrate, use, and disconnect.

Quick Start

• Install pgdbm in your environment (pip install pgdbm).
• Create a DatabaseConfig with your dedicated PostgreSQL connection string.
• Initialize AsyncDatabaseManager with the config and call connect().
• Create AsyncMigrationManager with a migrations_path and a unique module_name, then call apply_pending_migrations().
• Use the manager to run queries, then call disconnect() on shutdown.