Development/Testing

Django development server

The simplest way to try out NIPTviewer is to spin up a django development server,

# Fetch js and css files
bash fetch_assets.sh

# Create a virtual environment and activate it
virtualenv venv -p python3 && source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Setup secret key
export SECRET_KEY=aJhoK81Osgg7M1M3LeNy # Set your own random string

# Setup database and admin
cd niptviewer
python3 manage.py migrate
python3 manage.py createsuperuser

# Load fixtures
python3 manage.py loaddata index
python3 manage.py loaddata sample_types

# Start development server
DJANGO_SETTINGS_MODULE=niptviewer.settingsdev python3 manage.py runserver

The service should be avaible at http://127.0.0.1:8000

Docker container

The docker development setup will create a 3 container system with the following containers:

• nginx service
• web service, with NIPTviewer source code, served by gunicorn
• postgres database service

# Fetch js and css files
bash fetch_assets.sh

# Build image and start container
docker-compose -f docker-compose-development.yaml up --build

NOTE: Downloading pdf from this test server will not work.

# Create admin user
export NIPT_WEB_CONTAINER_NAME_OR_ID=$(docker ps | grep nipt-web | awk '{print($1)}');
docker exec -it ${NIPT_WEB_CONTAINER_NAME_OR_ID} python3 manage.py createsuperuser;

To be able to download pdf, from development docker setup, you will have to modify the templates a bit. All static parts need to changed from ex:

href="{{% static "css/nv.d3.min.1.8.6.css" %}}"

to

"http://127.0.0.1:8000/staticfiles/css/nv.d3.min.1.8.6.css"

The service should be avaible at http://127.0.0.1:8000