Service for handling backend calls in LITE.

Running the service with docker

• Download the repository:

  • git clone https://github.com/uktrade/lite-api.git
  • cd lite-api

• First time setup

  • Set up your local config file:

    • cp local.env .env - you will want to set this up with valid values, ask another developer or get them from Vault. If you want to run in Docker then uncomment the appropriate line in .env refering to DATABASE_URL

  • Initialise submodules

    • git submodule init
    • git submodule update

  • Ensure docker is running

  • Build and start docker images:

    • docker network create lite - shared network to allow API and frontend to communicate
    • docker-compose build - build the container image
    • docker-compose start db - to bring up the db to allow the migrate to succeed

  • Run the migrations

    • ./bin/migrate.sh - Perform the Django migrations

• Starting the service

  • docker-compose up - to start the API's django server

• Go to the index page (e.g. http://localhost:8100)

• At this point you might want to seed your database with some static

  • run docker-compose run ./manage.py seedall

Add a single user:

Run the following command to add new users:

INTERNAL_USERS='[{"email"=>"[email protected]"}]' ./manage.py seedinternalusers
EXPORTER_USERS='[{"email"=>"[email protected]"}]' ./manage.py seedexporterusers

Running Background tasks

pipenv run ./manage.py process_tasks will run all background tasks

Installing WeasyPrint for document generation

To produce PDF documents you will also need to install WeasyPrint. Do this after installing the python packages in the Pipfile;

MacOS: https://weasyprint.readthedocs.io/en/stable/install.html#macos

Linux: https://weasyprint.readthedocs.io/en/stable/install.html#debian-ubuntu

Installing endesive for document signing

To digitally sign documents endsesive requires the OS library swig to be installed. To install run sudo apt-get install swig

A p12 file is also required. Please see https://uktrade.atlassian.net/wiki/spaces/ILT/pages/1390870733/PDF+Document+Signing

Documentation

API Docs available on GitHub Pages

Running locally without Docker

Entity Relationship diagrams

ER Diagrams can be viewed in docs/entity-relation-diagrams/.

To regenerate the diagrams run pipenv run ./manage.py create_er_diagrams

Running Tests

• pipenv run ./manage.py test will run all tests
• pipenv run ./manage.py test cases will run the cases module tests

Running Code Coverage

• pipenv run ./manage.py coverage <module_to_run_coverage_on> <tests_to_run>

1. Providing no positional arguments implies that you want to run all tests and collect the coverage:
   • pipenv run ./manage.py coverage
2. The first positional argument implies what module you want to collect coverage for:
   • pipenv run ./manage.py coverage cases will collect coverage on the cases module and run only the cases tests
3. The second positional argument implies what tests to run in order to collect coverage for the given module:
   • pipenv run ./manage.py coverage cases all will collect coverage on the cases module and run all tests
   • pipenv run ./manage.py coverage cases queues will collect coverage on the cases module and only run the queues tests

LITE Repositories

lite-api - Service for handling backend calls in LITE.

lite-frontend - The web frontend for LITE.

Running Bandit

pipenv run bandit -r .

Running API tests

pipenv run ./manage.py test

with option --parallel to run them in parallel

To run a specific folder:

pipenv run ./manage.py test <folder_name>