Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Simply route complex django queries to multiple databases.

Project Description

Django Dynamic DB Router

Working with multiple databases within django is supported, but the syntax requires peppering .using('my_database') throughout all queries that need to be routed to different databases. This is especially painful when trying to use libraries that were written without multiple database support in mind. With this library, running complex queries across different databases is as simple as:

from dynamic_db_router import in_database

with in_database('non-default-db'):
    result = run_complex_query()

To set up you django project to be able to use this router, simply pip install django-dynamic-db-router and add DATABASE_ROUTERS=['dynamic_db_router.DynamicDbRouter'] to your Django settings.

Django Dynamic DB Router includes a number of additional features, such as:

  • Using in_database as a function decorator.
  • Read and write protection controls.
  • Load database configurations dynamically for the lifetime of the context manager.

For more information, and complete API documentation, see the docs, linked below.


To install the latest release, type:

pip install django-dynamic-db-router

To install the latest code directly from source, type:

pip install git+git://


Full documentation is available at


MIT License (see LICENSE)

Release History

Release History

This version
History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
django_dynamic_db_router-0.3.0-py2.py3-none-any.whl (7.9 kB) Copy SHA256 Checksum SHA256 2.7 Wheel Dec 2, 2016
django-dynamic-db-router-0.3.0.tar.gz (6.2 kB) Copy SHA256 Checksum SHA256 Source Dec 2, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting