Files
dbyaml/CONTRIBUTING.md
T
2026-09-20 02:08:11 +02:00

1.2 KiB

Contributing

Development setup

Prerequisites: uv, just

# Arch Linux
pacman -S uv just
# optinal
pacman -S just-lsp yamlfmt shellcheck

The development environment and testing requires multiple specific Python versions; they can be installed with (inside the pulled git project directory):

uv sync

The storage directory of Python versions can be configured with UV_PYTHON_INSTALL_DIR. (It must be an absolute path.)

Testing

A script is available to run the test suit.

just test

Formatting

Formatting of YAML files requires yamlfmt to be installed seperately.

A script is available to run the format check.

just format-check
just schema-scheck

Linting

Linting requires shellcheck to be installed separately. Validating pyproject.toml against the checked-in uv schema also requires jq.

A script is available to run the lint check.

just lint-check
just type-check

Documentation

A script is available to run the documentaion generation.

just docs
just man