Contributing #

First of all, thank you for using and contributing to id-translation! Any and all contributions are welcome.

Creating issues#

Issues are tracked on GitHub. Issue reports are appreciated, but please use a succinct title and add relevant tags. Please include a Minimal reproducible example if reporting an issue, or sample snippet if requesting a new feature or change which demonstrates the (desired) usage.

Getting started#

Follow these steps to begin local development.

Installing Poetry

See poetry.lock for the version used.

curl -sSL https://install.python-poetry.org/ | python -

Installing the project

Clone and install the virtual environment used for development. Some material is placed in submodules, so we need to clone recursively.
```
git clone --recurse-submodules git@github.com:rsundqvist/id-translation.git
cd id-translation
poetry install --all-extras
```
Generating documentation has a few dependencies which may need to be installed manually.
```
sudo apt-get update
sudo apt-get install pandoc tree
```
Verify installation (optional)

Start the test databases.
```
./run-docker-dvdrental.sh
```
Run all invocations.
```
./run-invocations.sh
```
This is similar to what the CI/CD pipeline does for a single OS and major Python version.

Running GitHub Actions locally#

Relying on GitHub actions for new CI/CD features is quite slow. An alternative is to use act instead, which allows running pipelines locally (with some limitations, see act docs). For example, running

act -j tests --matrix python-version:3.12

will execute the tests workflow.

Branching point#

Branched from rics@v1.0.0.