# Development tools

There are different ways to contribute to the project. For example, with just a browser,
one can create issues on our Gitlab projects (see https://foss.heptapod.net/py-edu-fr) or
even submit merge requests via the web interface (see [](./mercurial-heptapod.md)).

However, to get and use our repositories locally on your computer, one needs:

- [UV]

  The installation instructions can be found here:
  <https://docs.astral.sh/uv/#installation>.

- [PDM]

  Since you already have [UV], it seems reasonable to install [PDM] with

  ```sh
  uv tool install pdm
  ```

- [Mercurial]

  Please read [](./mercurial-heptapod.md) and follow the advices!

Once the following commands work fine, you should be ready to use our repositories and
contribute.

```sh
uv --version
pdm --version
hg version -v
hg help topic
```

```{note}

The program `make` is also used as an helper to run slightly complicated or uncommon
commands but it is not mandatory.

```

[mercurial]: https://www.mercurial-scm.org/
[pdm]: https://pdm-project.org
[uv]: https://docs.astral.sh/uv/