Development & community

Aldryn Events is an open-source project.

You don’t need to be an expert developer to make a valuable contribution - all you need is a little knowledge, and a willingness to follow the contribution guidelines.

Divio AG

Aldryn Events was created by Divio AG and is released under a BSD licence.

Aldryn Events is compatible with Divio’s Aldryn cloud-based django CMS hosting platform, and therefore with any standard django CMS installation. The additional requirements of an Aldryn application do not preclude its use with any other django CMS deployment.

Divio is committed to Aldryn Events as a high-quality application that helps set standards for others in the Aldryn/django CMS ecosystem, and as a healthy open source project.

Divio maintains overall control of the Aldryn Events repository.

Standards & policies

Aldryn Events is a django CMS application, and shares much of django CMS’s standards and policies.

These include:

Please familiarise yourself with this documentation if you’d like to contribute to Aldryn Events.

Running tests

Aldryn Events uses django CMS Helper to run its test suite.

Backend Tests

To run the tests, in the aldryn-events directory:

virtualenv env  # create a virtual environment
source env/bin/activate  # activate it
python setup.py install  # install the package requirements
pip install -r test_requirements/django_17.txt  # install the test requirements
python test_settings.py  # run the tests

You can run the tests against a different version of Django by using the appropriate value in django_xx.txt when installing the test requirements.

Frontend Tests

Follow the instructions in the aldryn-boilerplate-bootstrap3 documentation and setup the environment through to the Backend Tests section.

Instead of using python test_settings.py described above, you need to execute python test_settings.py server to get a running local server. You can open the development server locally through http://127.0.0.1:8000/. The database is added within the root of this project local.sqlite. You might want to delete the database from time to time to start with a fresh installation. Don’t forget to restart the server if you do so.