Django application that acts as an integration layer that mediates the connection between ticket sales platforms and MaaS providers.
Development with Docker
Prerequisites:
- Docker
- Docker Compose
-
Create a
docker-compose.env.yaml
file in the project folder:- Use
docker-compose.env.yaml.example
as a base, it does not need any changes for getting the project running. - Set entrypoint/startup variables according to taste.
DEBUG
, controls debug mode on/offAPPLY_MIGRATIONS
, applies migrations on startupCREATE_ADMIN_USER
, creates an admin user with credentialskuva-admin
:(password, see below) (kuva-admin@hel.ninja)ADMIN_USER_PASSWORD
, the admin user's password. If this is not given, a random password is generated and written into stdout when an admin user is created automatically.
- Use
-
Run
docker-compose up
- The project is now running at localhost:8081
Optional steps
-
Run migrations:
- Taken care by the example env
docker exec maritime-maas-backend python manage.py migrate
-
Create superuser:
- Taken care by the example env
docker exec -it maritime-maas-backend python manage.py add_admin_user
Prerequisites:
- PostgreSQL 11
- Python 3.8
- Run
pip install -r requirements.txt
- Run
pip install -r requirements-dev.txt
(development requirements)
To setup a database compatible with default database settings:
Create user and database
sudo -u postgres createuser -P -R -S maritime_maas # use password `maritime_maas`
sudo -u postgres createdb -O maritime_maas maritime_maas
Allow user to create test database
sudo -u postgres psql -c "ALTER USER maritime_maas CREATEDB;"
- Create
.env
file:touch .env
- Set the
DEBUG
environment variable to1
. - Run
python manage.py migrate
- Run
python manage.py add_admin_user
- Run
python manage.py runserver 0:8000
The project is now running at localhost:8000
-
Install
pip-tools
:pip install pip-tools
-
Add new packages to
requirements.in
orrequirements-dev.in
-
Update
.txt
file for the changed requirements file:pip-compile requirements.in
pip-compile requirements-dev.in
-
If you want to update dependencies to their newest versions, run:
pip-compile --upgrade requirements.in
-
To install Python requirements run:
pip-sync requirements.txt
This project uses
black
,
flake8
and
isort
for code formatting and quality checking. Project follows the basic
black config, without any modifications.
Basic black
commands:
- To let
black
do its magic:black .
- To see which files
black
would change:black --check .
pre-commit
can be used to install and
run all the formatting tools as git hooks automatically before a
commit.
- Set the
DEBUG
environment variable to1
. - Run
pytest
.
Navigate to frontend folder.
To install node_modules
run yarn install
.
Create .env
file, use .env.example
as a base.
After installation is completed run application with yarn start
. Application is now running and can be found at localhost:3000
.