Metadata-Version: 1.1
Name: django-resetdb
Version: 0.2.0
Summary: Management command to reset your Django database
Home-page: http://github.com/GreenBankObservatory/django-resetdb
Author: Thomas Chamberlin
Author-email: tchamber@nrao.edu
License: MIT
Description: # `django-resetdb`
        
        Developer-friendly database resets for Django
        
        ## Motivation
        
        You're developing a Django project and you need to investigate a problem in production. So, you need to clone the production database and take a look at it.
        
        In the olden days, this was a very manual process. You would try to find a wiki page, forget where it is, try to remember the commands you needed to do, probably forget some minor detail, and, eventually, you would get your database clone.
        
        Instead, you can now run a single command to either reset your database to a blank state or clone another database (production or otherwise).
        
        ## Installation
        
        ### Via internal PyPI
        
        First you'll need to make sure that your `pip` has knowledge of our internal PyPI repository. Then simply:
        
            $ pip install django-resetdb
        
        ### Manual Installation
        
            $ git clone https://github.com/GreenBankObservatory/django-resetdb
            $ pip install django-resetdb
        
        ## Configuration
        
        Two settings will need to be configured before use:
        
        1. Add `django-resetdb` to your `INSTALLED_APPS` (`./manage.py help` should now list `django-resetdb`)
        2. Add `django-resetdb` to your `LOGGING`, if you want to access its verbose modes (optional)
        
        ## Usage
        
        ### Reset to blank database
        
        In its most basic form, `resetdb` will simply reset your database to a blank state and apply migrations:
        
            $ ./manage.py resetdb
        
        ### Reset to a database clone
        
        This allows you to reset your database to a clone of another. You also have the option of avoiding migrations at the end (we need this for DSS currently, I think):
        
        If you want to clone a database, you could simply provide the database name you wish to clone:
        
            $ ./manage.py resetdb --clone dss_production --no-migrate
        
        If there is an existing database backup you wish to reset to, you can use that instead:
            
            $ ./manage.py resetdb --clone /home/scratch/dss/database_backups/dss_production.2018-06-08_00:00:00 --no-migrate
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
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
