Metadata-Version: 1.1
Name: django-mysql-ssl
Version: 0.0.1
Summary: Backport dbshell support for ssl mysql connections in Django < 1.8
Home-page: http://github.com/cfpb/django-mysql-ssl
Author: CFPB
Author-email: tech@cfpb.gov
License: Public Domain
Description: # Django MySQL SSL
        
        **Description**:  Backport support for manage.py dbshell when mysql SSL is enabled
        
        ## Dependencies
        
        This application is confirmed to work with Django 1.5. It should also work with Django 1.6-1.7.  This plugin is not necessary for Django 1.8, as the capability is built into the core.
        
        ## Installation
        
        1. Install the application and its dependencies
        
        ```
        pip install django-mysql-ssl
        ```
        
        ## Usage
        
        1. Make sure you have configured your mysql database in the django settings with the appropriate ssl ca.  You may also need 'cert' and 'key', but for most purposes 'ca' should work fine.  This functionality is built into django and has nothing to do with this plugin.
        
        ```python
        DATABASES = {
            'default': {
                'ENGINE': 'django.db.backends.mysql',
                ...
                'OPTIONS':  {'ssl': {'ca': '<PATH TO CA CERT>'}}
            }
        }
        ```
        
        1. Connect to the db shell using the `dbshell_ssl` command: 
        
        ```shell
        ./manage.py dbshell_ssl
        ```
        
        ## Known issues
        
        None
        
        ## Getting help
        
        If you have questions, concerns, bug reports, etc, please file an issue in this repository's Issue Tracker.
        
        ## Getting involved
        
        Please feel free to fork this repo and submit Pull Requests with any enhancements.
        
        
        ----
        
        ## Open source licensing info
        1. [TERMS](TERMS.md)
        2. [LICENSE](LICENSE)
        3. [CFPB Source Code Policy](https://github.com/cfpb/source-code-policy/)
        
        
        ----
        
        ## Credits and references
        
        1. Django ticket explaining the broken dbshell command: https://code.djangoproject.com/ticket/22646
        1. Django PR implementing the functionality in Django 1.8: https://github.com/django/django/commit/01801edd3760f97a4ebc4d43ca5bbdbbdfebbb0a
        
        
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: Public Domain
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Libraries :: Python Modules
