centurion_erp/CONTRIBUTING.md

Contribution Guide

Dev Environment

It's advised to setup a python virtual env for development. this can be done with the following commands.

python3 -m venv venv

source venv/bin/activate

pip install -r requirements.txt

To setup the django test server run the following

cd app

python manage.py runserver 8002

python3 manage.py migrate

python3 manage.py createsuperuser

# If model changes
python3 manage.py makemigrations --noinput

Updates to python modules will need to be captured with SCM. This can be done by running pip freeze > requirements.txt from the running virtual environment.

Running Tests

test can be run by running the following:

1. pip install -r requirements_test.txt -r requirements.txt

2. pytest --cov --cov-report html --cov=./

Docker Container

cd app

docker build . --tag django-app:dev

docker run -d --rm -v ${PWD}/db.sqlite3:/app/db.sqlite3 -p 8002:8000 --name app django-app:dev