Metadata-Version: 1.1
Name: django-appengine-toolkit
Version: 0.1.2
Summary: Deploy Django projects on Google App Engine with ease
Home-page: https://github.com/masci/django-appengine-toolkit
Author: Massimiliano Pippi
Author-email: mpippi@gmail.com
License: BSD
Description: =============================
        Django Appengine Toolkit
        =============================
        
        .. image:: https://badge.fury.io/py/django-appengine-toolkit.png
            :target: http://badge.fury.io/py/django-appengine-toolkit
            
        .. image:: https://travis-ci.org/masci/django-appengine-toolkit.png?branch=master
                :target: https://travis-ci.org/masci/django-appengine-toolkit
        
        .. image:: https://pypip.in/d/django-appengine-toolkit/badge.png
                :target: https://crate.io/packages/django-appengine-toolkit?version=latest
        
        
        Appengine Toolkit pimps Django with some utilities which help deploying
        projects on Google App Engine with Google Cloud SQL as data backend.
        
        Features
        --------
        
        * collects project dependencies symlinking needed modules and packages and configuring App Engine environment
        * configures DATABASE setting parsing connection strings similar to those on Heroku
        
        Documentation
        -------------
        
        The full documentation is at http://django-appengine-toolkit.rtfd.org.
        
        Quickstart
        ----------
        
        Install appengine-toolkit::
        
            pip install django-appengine-toolkit
        
        Add it to the installed apps::
        
            INSTALLED_APPS = (
                # ...
                'appengine_toolkit',
            )
        
        To automatically configure database settings reading connection string
        from the DATABASE_URL enviroment var::
        
            import appengine_toolkit
            DATABASES = {
                'default': appengine_toolkit.config(),
            }
        
        You can set DATABASE_URL directly in your ``app.yaml`` file::
        
            env_variables:
              DJANGO_SETTINGS_MODULE: 'myapp.settings'
              DATABASE_URL: 'mysql://root@project_id:instance_id/database_name'
        
        
        To collect project dependencies, first configure Appengine Toolkit in your settings
        file, specifying the full path to your app.yaml file::
        
            APPENGINE_TOOLKIT = {
                'APP_YAML': os.path.join(BASE_DIR, '../../', 'app.yaml'),
            }
        
        
        ...then run the command ``collectdeps`` specifying the requirement file containing
        the list of packages needed by your project to run::
        
            python manage.py collectdeps -r my_requirements.txt
        
        a folder named ``libs`` will be created on your application root (i.e. the same folder
        where the YAML file resides) containing symlinks needed by App Engine to include
        dependencies in the production runtime enviroment.
        
        A file ``appengine_config.py`` will be created in the same folder and will contain
        code needed to configure the environment. If you need to customize the module
        ``appengine_config`` tell the command to not overwrite it - the command will then
        output the code you need to paste inside the module to complete the configuration
        process
        
        
        
        
        History
        -------
        
        0.1.0 (2013-11-30)
        ++++++++++++++++++
        
        * First release on PyPI.
Keywords: django-appengine-toolkit
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
