djaodjin/djaodjin-deployutils

Deploy webapps hosted on djaodjin.com

DjaoDjin deployutils

This Python module enables a Django or Flask project to seamlessly integrate behind the HTTP session manager reverse proxy. It will replace the default django.contrib.sessions and AUTHENTICATION_BACKENDS to decode sessions forwarded to your project by the HTTP session manager.

Tested with

• Python: 3.7, Django: 3.2 (LTS), Django Rest Framework: 3.12
• Python: 3.10, Django: 4.0 (latest), Django Rest Framework: 3.12
• Python: 2.7, Django: 1.11 (legacy), Django Rest Framework: 3.9.4

More technical documentation

Install

Install deployutils into your environment

$ pip install djaodjin-deployutils

See the steps to integrate with a Django project.

Development

Clone the repository in a virtualenv and install the prerequisites

$ python3 -m .venv
$ source .venv/bin/activate
$ pip install -r testsite/requirements.txt

Create the credentials file with a DJAODJIN_SECRET_KEY and the empty db.

$ make initdb

Run the web application

$ python manage.py runserver

Browse to http://localhost:8000

Release Notes

Tested with

• Python: 3.7, Django: 3.2 (LTS)
• Python: 3.10, Django: 4.2 (latest)
• Python: 2.7, Django: 1.11 (legacy) - use testsite/requirements-legacy.txt

0.11.0

• makes manages_broker a property (breaking change)
• fixes missing get_context_data
• adds message about env variables override

previous release notes

djaodjin-deployutils's Issues

pip > 10 & pip.get_installed_distributions()

From pypa/pip#5243

See https://pip.pypa.io/en/latest/user_guide/#using-pip-from-your-program - importing functions from pip is not supported. In this case, setuptools (specifically pkg_resources) probably has the functionality you need.

That's explicitly not the right thing to do. Please don't do this, we will not support such usage.

This is really an issue as we must stick with old pip version < 10 to still be able to use djaodjin-deployutils.

As far as we can see, this is only user for logging purpose in file https://github.com/djaodjin/djaodjin-deployutils/blob/master/deployutils/apps/django/logging.py

Maybe the proposed alternative in the link above can work :

import pkg_resources

dists = [d for d in pkg_resources.working_set]
# Filter out distributions you don't care about and use.