Metadata-Version: 1.1
Name: zappa-django-utils
Version: 0.3.1
Summary: Helpers for Django Zappa deployments
Home-page: https://github.com/Miserlou/zappa-django-utils
Author: Rich Jones
Author-email: rich@openwatch.net
License: MIT License
Description: # zappa-django-utils
        
        [![PyPI](https://img.shields.io/pypi/v/zappa-django-utils.svg)](https://pypi.python.org/pypi/zappa-django-utils)
        [![Slack](https://img.shields.io/badge/chat-slack-ff69b4.svg)](https://slack.zappa.io/)
        [![Gun.io](https://img.shields.io/badge/made%20by-gun.io-blue.svg)](https://gun.io/)
        [![Patreon](https://img.shields.io/badge/support-patreon-brightgreen.svg)](https://patreon.com/zappa)
        
        
        Small utilities for making [Zappa](https://github.com/Miserlou/Zappa) deployments slightly easier for Django applications.
        
        This project was inspired by Edgar Roman's [Zappa Django Guide](https://github.com/edgarroman/zappa-django-guide).
        
        ## Installation
        
        Install via `pip`:
            
            $ pip install zappa-django-utils
        
        Add to your installed apps:
        
            INSTALLED_APPS += ('zappa_django_utils',)
        
        ## Usage
        
        ### Using an S3-Backed Database Engine
        
        **ZDU** includes the ability to use `s3sqlite`, an [S3-synced SQLite database](https://blog.zappa.io/posts/s3sqlite-a-serverless-relational-database) as a Django database engine.
        
        This will cause problems for applications with high loads of concurrent writes, but it scales very well for high-read applications that don't have concurrent writes (like CMSes), and it's orders of magnitude cheaper than AWS RDS.
        
        To use this, in your Django project's `settings.py` file, add the following:
        
        ```python
        DATABASES = {
            'default': {
                'ENGINE': 'zappa_django_utils.db.backends.s3sqlite',
                'NAME': 'sqlite.db',
                'BUCKET': 'your-db-bucket'
            }
        }
        ```
        
        And.. that's it!
        
        ### Creating a Postgres Database
        
        Once you have your RDS set up, your VPC/Subnet/Security Groups set up, and your `DATABASES` setting set up, you can create the database with:
        
            $ zappa manage <stage> create_pg_db
        
        Then you're ready to `python manage.py makemigrations` and `zappa update; zappa manage migrate`!
        
        ### Creating a Default Admin User 
        
        You'll probably need a default user to manage your application with, so you can now:
        
            $ zappa manage <stage> create_admin_user
        
        Now log in with the information that gets returned and immediately change the admin user's email and password.
        
        ### Creating/Dropping a Postgres Schema
        
        You can create a [Postgres schema](https://www.postgresql.org/docs/current/static/ddl-schemas.html) with:
        
            $ zappa manage create_pg_schema
        
        and drop it with:
        
            $ zappa manage drop_pg_schema
        
        ## License
        
        (c) 2017, Rich Jones, MIT License
        
Platform: UNKNOWN
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
