Skip to content
@dbwarden-org

DBWarden

DBWarden is a database migration system for Python/SQLAlchemy projects

DBWarden

DBWarden

Your SQLAlchemy models are your migrations.

Python PyPI License Documentation Codecov


DBWarden is a model‑first database migration system built on SQLAlchemy.
Define your schema in Python, review the generated SQL, and apply it with confidence, backed by a convergence gate that proves your migrations match your models.

This organization is the home of the DBWarden project and its official plugins.


Community & Approved Plugins

Community plugins use the same entry‑point mechanism.
Before they run, DBWarden asks for your explicit consent. No third‑party code executes without your knowledge.

→ Browse community plugins
→ Learn about the Approved tier


Quickstart

# install DBWarden
uv add dbwarden

# create a configuration
echo "
from dbwarden import database_config

database_config(
    database_name='primary',
    database_type='postgresql',
    database_url='postgresql://localhost/myapp',
)
" > dbwarden.py

# generate your first migration
dbwarden make-migrations "create initial tables"

# apply it
dbwarden migrate

Documentation

Full documentation with guides, cookbook, and API reference:
dbwarden.emiliano-go.com


Contributing

We welcome contributions to the core tool and to plugins.
Start with the core contribution guide or jump into any plugin’s issue tracker.


License

DBWarden and all official plugins are released under the MIT License.

Pinned Loading

  1. dbwarden dbwarden Public

    DBWarden is a database migration system for Python/SQLAlchemy projects

    Python 13 1

  2. dbwarden-ch-rbac dbwarden-ch-rbac Public

    DBWarden plugin for ClickHouse role-based access control: roles, users, grants, row policies, quotas, and settings profiles

    Python

  3. dbwarden-fastapi dbwarden-fastapi Public

    DBWarden plugin for FastAPI: session dependencies, health endpoints, migration routes, and lifespan management

    Python

  4. dbwarden-pgsql-rbac dbwarden-pgsql-rbac Public

    DBWarden plugin for PostgreSQL role-based access control: roles, grants, default privileges, and row-level security

    Python

  5. dbwarden-pgsql-types dbwarden-pgsql-types Public

    DBWarden plugin for PostgreSQL custom types: ENUMs, domains, composite types, and sequences

    Python

  6. dbwarden-seeds dbwarden-seeds Public

    DBWarden plugin for seed data management: apply, rollback, and export seed data across environments

    Python

Repositories

Showing 9 of 9 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…