takahe/CONTRIBUTING.md

Contributing to Takahē

Getting Started

Development can be done “bare metal” or with Docker. We’ll describe both here.

Bare Metal

Takahē requires Python 3.10 or above, so you’ll need that first. Then, create and activate a virtual environment:

$ python3 -m venv .venv
$ . .venv/bin/activate

You can install the development requirements:

$ pip install -r requirements-dev.txt

…and enable git commit hooks if you like:

$ pre-commit install

Finally, you can run the tests with PyTest:

$ pytest

Docker

The docker build process will take care of much of the above, but you just have to be sure that you’re executing it from the project root.

First, you need to build your image:

$ docker build -f ./docker/Dockerfile -t "takahe:latest" .

Then start the compose session:

$ docker compose -f docker/docker-compose.yml up

Once your session is up and running, you can run the tests inside your container:

$ docker compose -f docker/docker-compose.yml exec web pytest

Code of Conduct

As a contributor, you can help us keep the Takahē community open and inclusive. Takahē follows the Django Project Code of Conduct.