Installing and configuring for development and testing

Installation

LTD Keeper requires Python 3.5.

You can get the application by cloning the Git repository:

git clone https://github.com/lsst-sqre/ltd-keeper.git

Install the pre-requisites with pip: Install for development:

cd ltd-keeper
make install

LTD Keeper also uses SQLite in development and testing modes (any SQL server can be used in production).

Running Tests: pytest

You can invoke the pytest-based tests by running:

make test

Running for development: run.py runserver

The ‘development’ configuration profile provides useful defaults for running an LTD Keeper instance locally (see config.py).

Run LTD Keeper in development mode via:

./run.py createdb
./run.py init
./run.py runserver

The createdb subcommand creates tables in a development database, and the init command seeds a default user. This default user has username user and password pass.

Once the development DB is prepared you can skip the createdb and init commands with later instantiations of runserver.