mal

Wiki.

Development

This is a Django codebase. Check out the Django docs for general technical documentation.

Structure

The Django project is mal. There is one Django app, main, with all business logic.

Dependencies

Using venv:

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

This project also uses pip-tools for dependencies management.

Environment variables

You need to create a new file named .env in the root of this project once you cloned it.

.env should contain the following env variables:

SECRET_KEY="thisisthesecretkey"
DATABASE_URL="postgres://username:password@localhost:5432/db_name"
EMAIL_HOST_USER="smtp_user"
EMAIL_HOST_PASSWORD="smtp_password"

Database

This project uses PostgreSQL. See above on how to configure access to it using the .env file.

There is no need to create manually one if you're using Docker and Docker Compose. Run this to spin up the database in the background:

docker-compose up -d db

The database data will be saved in a gitignored directory, db_data, in the root of the project.

To create the database schema:

python manage.py migrate

Serve

To run the Django development server:

python manage.py runserver

Or, if you prefer to run the web server under Docker:

docker-compose up web

In which case, DATABASE_URL in .env should be like this:

DATABASE_URL="postgres://postgres:postgres@db:5432/postgres"

Testing

python manage.py test

Code linting & formatting

black . && isort -y && flake8

Deployment

Deployment is configured using the production-grade uwsgi server.

uwsgi --ini=uwsgi.ini -H venv/

You also need to populate your shell environment:

export SECRET_KEY="thisisthesecretkey"
export DATABASE_URL="postgres://username:password@localhost:5432/db_name"
export EMAIL_HOST_USER="smtp_user"
export EMAIL_HOST_PASSWORD="smtp_password"

Dokku

This project is also configured to deploy to dokku.

• Procfile: app init command
• app.json: predeploy tasks
• DOKKU_SCALE: process scaling

License

This software is licensed under the MIT license. For more information, read the LICENSE file.