sdcplatform/ras-frontstage repository overview

⁠ras-frontstage

User interface for Respondent Account Services

⁠Setup

Based on python 3.9

Use Pyenv⁠ to manage installed Python versions

Install dependencies to a new virtual environment using Pipenv⁠

pip install -U pipenv
pipenv install

⁠Redis

ras-frontstage requires a redis instance to store user jwt's when they are logged in

For local development this can be installed using Homebrew

brew install redis

For more information see here⁠

It can also be run with docker

docker run --name redis -p 6379:6379 -d redis

⁠ras-frontstage-api

ras-frontstage calls one other service, ras-frontstage-api⁠ See that repo for how to run it and see the config below for the environment variables used to connect to it

⁠Run the application

pipenv run python run.py

⁠Run tests

Install test dependencies with

pipenv install --dev

The Makefile will run the tests in the unit or integration tests folder using pytest, and present a coverage report.
These can be easily run via the following commands:

make unit-tests
make integration-tests

or if you are running redis in the docker environment

make docker-test

or if you wish to run a single test file, it can be specified as follows:

make INTEGRATION_TESTS=tests/integration/views/surveys/test_surveys_list.py integration-tests
make UNIT_TESTS=tests/unit/test_filters.py unit-tests

The syntax above will work equally well with the 'docker-test' target

Note that this script will fail if there is a node_modules folder in the repo

⁠Configuration

Environment variables available for configuration are listed below:

These are set in config.py⁠