Contributing to Borealis

Development on the Borealis software is both appreciated and encouraged. If you have new features you would like added, please reach out via email to superdarn@usask.ca and we would be happy to work with you to implement your request.

Contribution Standards

pre-commit hooks are used to enforce coding standards for this project. To use pre-commit in your environment, install cppcheck and clang-format with your native package manager and install borealis[dev] in your Python virtual environment. Now, every time you commit, pre-commit will run the hooks for this project and only proceed with the commit if all hooks pass. Note that some hooks modify the formatting of files, so the hook will fail if it executes any reformatting. Inspect the changes before attempting to commit again; in most instances, the hooks should pass on the second attempt without you needing to modify any files.