Metadata-Version: 2.1
Name: Django-Deployment-Tools
Version: 0.5.0
Summary: Django deployment utilities
Home-page: UNKNOWN
Author: Orange Cloud for Business
Author-email: yves-gwenael.bourhis@orange.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Environment :: Console
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Internet :: WWW/HTTP
Requires-Dist: pbr (!=2.1.0,>=5.4.4)
Requires-Dist: six (>=1.10.0)
Requires-Dist: Django (<2,>=1.11) ; (python_version<'3.0')
Requires-Dist: Django (>=2.2.6) ; (python_version>='3.0')

# Django Deployement Tools

Tools to help deploy a django application.

## INSTALLATION:

    pip install Django-Deployment-Tools

## CONFIGURATION:

Add `'django_deploy_tools',` in your `settings.INSTALLED_APPS`.

Add a `STATIC_ROOT` variable in your django `settings.py` file.

See <https://docs.djangoproject.com/en/3.0/ref/settings/#static-files>,
<https://docs.djangoproject.com/en/3.0/ref/settings/#static-root> and
<https://docs.djangoproject.com/en/3.0/howto/static-files/> for more
details.

## USAGE:

First collect static files:

    python manage.py collectstatic

If you have django-compressor (optional) run:

    python manage.py compress

(see <https://django-compressor.readthedocs.io/en/stable/> for more details).

Then, create a wsgi file:

    python manage.py make_sgi --wsgi --out path/to/wsgi_file

And then generate an apache configuration file:

    python manage.py make_apache_conf --wsgi path/to/wsgi_file --sll --out /path/to/apache_conf_file

For more information check :

    python manage.py make_apache_conf -h

Especially to define the proper ssl certificates. If not specified when
creating the configuration file you will have to edit the generated apache
configuration.

## DEVELOPMENT:

If you want to contribute, deployement commands are to be added in the

`management/commands` directory:
<https://github.com/ygbourhis/django_deploy_tools/tree/master/django_deploy_tools/management/commands>
As per the django documentation:
<https://docs.djangoproject.com/en/dev/howto/custom-management-commands/>
And configuration templates used by the commands are put in the `templates/django_deploy_tools`directory:
<https://github.com/ygbourhis/django_deploy_tools/tree/master/django_deploy_tools/templates/django_deploy_tools>
Then, before adding a pull request, run the `check_code` script to check coding rules

TODO: Add unittests.