pre-commit hooks for preCICE

This repo contains pre-commit hooks for preCICE.

The format-precice-config was moved into a separate repository precice/config-format.

Versioning of this repo

Hooks cover a major version of preCICE. The version is vX.Y, where X is the major version of preCICE and Y is the release of the hook.

Thus, if you plan to use these hooks with preCICE version 2.3.1, then only the 2 is important for the hook version.

Using the hooks

Add this to your .pre-commit-config.yaml in the root of your project:

-   repo: https://github.com/precice/precice-pre-commit-hooks
    rev: ''  # Use the tag you want to use
    hooks:
    -   id: check-image-prefix
        files: 'docs/images/.*'
        args: [ --prefix=docs-myspecialcomponent- ]

Note: The hook will treat every .xml file as a preCICE configuration file. You may need to exclude directories using exclude.

Hooks

check-image-prefix

This hook is only relevant for repositories integrated into the website

Checks if given images have the requested prefix. Only takes images into account that are inside a folder called images/. Pass the prefix to the hook by defining args: [ --prefix=my-prefix- ]. Returns 0 on success, 1 on incorrect prefix.