Metadata-Version: 1.1
Name: django-dynamic-db-router
Version: 0.3.0
Summary: Simply route complex django queries to multiple databases.
Home-page: https://github.com/ambitioninc/django-dynamic-db-router
Author: Erik Swanson
Author-email: opensource@ambition.com
License: MIT
Description-Content-Type: UNKNOWN
Description: .. image:: https://travis-ci.org/ambitioninc/django-dynamic-db-router.png
           :target: https://travis-ci.org/ambitioninc/django-dynamic-db-router
        
        .. image:: https://coveralls.io/repos/ambitioninc/django-dynamic-db-router/badge.png?branch=develop
            :target: https://coveralls.io/r/ambitioninc/django-dynamic-db-router?branch=develop
        
        .. image:: https://pypip.in/v/django-dynamic-db-router/badge.png
            :target: https://pypi.python.org/pypi/django-dynamic-db-router/
            :alt: Latest PyPI version
        
        
        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:
        
        .. code-block:: python
        
            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.
        
        
        Installation
        ------------
        
        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://github.com/ambitioninc/django-dynamic-db-router.git
        
        Documentation
        =============
        
        Full documentation is available at http://django-dynamic-db-router.readthedocs.org
        
        License
        =======
        MIT License (see LICENSE)
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
