Development

Table of Contents

• System dependencies
• Python dependencies
• Formatting code
• Executing utt from source
• Tests
  • Unit tests
  • Integration Tests

System dependencies

You will need the following tools on your system to work on utt:

• Python
• Make
• Poetry
• Docker

Python dependencies

Once the dependencies above have been installed on your system, you can install utt's Python dependencies with this command:

$ make bootstrap

Formatting code

All code must be properly formatted to be accepted in utt. You can format the code with this command:

$ make format

Executing utt from source

To run utt from local source:

$ poetry run utt

Tests

This section is very important as most code changes need tests.

You can run all tests with this command:

$ make test

Unit tests

Unit tests are in-memory tests (i.e. no I/O) that runs very fast. They are located in ../test/unit.

To run them:

$ make test.unit

Integration Tests

Integration tests test the entire system. They

1. build utt
2. build and start a docker container
3. install utt in the container
4. run tests in the container

Integration tests test the entire system. They 1) build utt, 2) build and start a docker container, 3) install utt in the container, and 4) run tests in the container.

Integration tests are located in ../test/integration

To run them:

$ make test.integration

The tests are listed in this Makefile

You can also run a specific test. For example, to run the hello test:

$ make test.integration INTEGRATION_CMD=hello

You can also spawn a shell in the container:

$ make test.integration INTEGRATION_CMD=shell

And, then you can run a specific test:

$ make hello

Note that the previous command must be run inside the container.