sarscov2x 1.0.0

Installing the sample Django application

If you want, you can install the Django app. When installed you can easily inspect the .travis.yml and tox.ini and perhaps run the tests locally.

To do so, follow the steps below to create a python environment, install the dependencies, prepare the Django apps DB, create a user account, and loads a local test web server.

First, set up a python environment.

I use miniconda to build and manage my python environments. You will need to install miniconda so go to the the miniconda docs and select the installer for your OS.

After the installing miniconda, open a terminal and create a new python environment using the conda command:

conda create -n edc python=3.8

Your new python env is named “edc” and runs python 3.8.

Next, activate your new environment:

conda activate edc

Next, clone the repo into a folder, for example, projects:

mkdir ~/projects
cd  ~/projects
git clone https://github.com/erikvw/sarscov2x.git

Navigate into the repo and install the requirements:

cd ~/projects/sarscov2x
pip install -U -r requirements.txt

This is a simple Django application that uses sqlite as the DB. To create the database:

python manage.py migrate

Next, create your user account:

# run and follow the prompts
python manage.py createsuperuser

Next, start up the test webserver:

python manage.py runserver

Lastly, open your browser and navigate to:

http://localhost:8000

PEP8, tests, tox and TravisCI, code coverage

TravisCI is just part of what can be used to simplify checking your code (flake8), running all your tests against multiple environments (tox and travis) while finally checking that your test coverage is still where you want it to be.

References:

https://docs.travis-ci.com/user/tutorial/

https://docs.travis-ci.com/user/tutorial/#to-get-started-with-travis-ci-using-github

https://docs.travis-ci.com/user/job-lifecycle/

https://docs.travis-ci.com/user/environment-variables/#default-environment-variables