Metadata-Version: 1.1
Name: dj-database-url
Version: 0.5.0
Summary: Use Database URLs in your Django Application.
Home-page: https://github.com/kennethreitz/dj-database-url
Author: Kenneth Reitz
Author-email: me@kennethreitz.com
License: BSD
Description-Content-Type: UNKNOWN
Description: 
        dj-database-url
        ~~~~~~~~~~~~~~~
        
        .. image:: https://secure.travis-ci.org/kennethreitz/dj-database-url.png?branch=master
           :target: http://travis-ci.org/kennethreitz/dj-database-url
        
        This simple Django utility allows you to utilize the
        `12factor <http://www.12factor.net/backing-services>`_ inspired
        ``DATABASE_URL`` environment variable to configure your Django application.
        
        The ``dj_database_url.config`` method returns a Django database connection
        dictionary, populated with all the data specified in your URL. There is
        also a `conn_max_age` argument to easily enable Django's connection pool.
        
        If you'd rather not use an environment variable, you can pass a URL in directly
        instead to ``dj_database_url.parse``.
        
        Supported Databases
        -------------------
        
        Support currently exists for PostgreSQL, PostGIS, MySQL, MySQL (GIS),
        Oracle, Oracle (GIS), and SQLite.
        
        Installation
        ------------
        
        Installation is simple::
        
            $ pip install dj-database-url
        
        Usage
        -----
        
        Configure your database in ``settings.py`` from ``DATABASE_URL``::
        
            import dj_database_url
        
            DATABASES['default'] = dj_database_url.config(conn_max_age=600, ssl_require=True)
        
        Provide a default::
        
            DATABASES['default'] = dj_database_url.config(default='postgres://...'}
        
        Parse an arbitrary Database URL::
        
            DATABASES['default'] = dj_database_url.parse('postgres://...', conn_max_age=600)
        
        The ``conn_max_age`` attribute is the lifetime of a database connection in seconds
        and is available in Django 1.6+. If you do not set a value, it will default to ``0``
        which is Django's historical behavior of using a new database connection on each
        request. Use ``None`` for unlimited persistent connections.
        
        
        
Platform: any
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
