Docs

You can find our docs online.

Contributing

Follow the steps below to develop and contribute to the project.

Requirements

• Python 3.10 or higher
• Task 3.44.0
  • We pin the version to 3.44.0 due to y-scope/spider#250.
• uv 0.7.0 or higher

Set up

Run dependency installation task:

task deps:lib_install

Set up the config files for our C++ linting tools:

task lint:cpp-configs

Adding files

Certain file types need to be added to our linting rules manually:

• CMake. If adding a CMake file, add it (or its parent directory) as an argument to the gersemi command in taskfiles/lint.yaml.
  • If adding a directory, the file must be named CMakeLists.txt or use the .cmake extension.
• YAML. If adding a YAML file (regardless of its extension), add it as an argument to the yamllint command in taskfiles/lint.yaml.

Linting

Before submitting a pull request, ensure you’ve run the linting commands below and either fixed any violations or suppressed the warning.

To run all linting checks:

task lint:check

To run all linting checks AND automatically fix any fixable issues:

task lint:fix

Running specific linters

The commands above run all linting checks, but for performance you may want to run a subset (e.g., if you only changed C++ files, you don't need to run the YAML linting checks) using one of the tasks in the table below.

Task	Description
lint:cmake-check	Runs the CMake linters.
lint:cmake-fix	Runs the CMake linters and fixes any violations.
lint:cpp-check	Runs the C++ linters (formatters and static analyzers).
lint:cpp-fix	Runs the C++ linters and fixes some violations.
lint:cpp-format-check	Runs the C++ formatters.
lint:cpp-format-fix	Runs the C++ formatters and fixes any violations.
lint:cpp-static-check	Runs the C++ static analyzers.
lint:cpp-static-fix	Runs the C++ static analyzers.
lint:py-check	Runs the Python linters and formatter.
lint:py-fix	Runs the Python linters and formatter and fixes some violations.
lint:toml-check	Runs the TOML linters and formatter.
lint:toml-fix	Runs the TOML linters and formatter and fixes some violations.
lint:yml-check	Runs the YAML linters.
lint:yml-fix	Runs the YAML linters.