A validator and automatic test suite for CLAP plugins. Clap-validator can automatically test one or more plugins for common bugs and incorrect behavior.
Prebuilt binaries can be found on the releases page. Development builds can be found here. The macOS builds are unsigned and may require Gatekeeper to be disabled or the quarantine bit to be removed (instructions).
Simply pass the path to one or more .clap plugins to clap-validator validate
to run the validator on those plugins. The --only-failed option can be used to
hide the output from all successful and skipped tests. Running clap-validator validate --help lists all available options:
clap-validator validate /path/to/the/plugin.clap
clap-validator validate /path/to/the/plugin.clap --only-failed
clap-validator validate --helpclap-validator runs tests in separate processes by default so plugin crashes can
be treated as such instead of taking down the validator. If you want to attach a
debugger to debug the plugin's behavior during a specific test, you can tell the
validator to run the that test in the current process. Use clap-validator list tests
to list all available tests.
clap-validator validate --in-process --test-filter <test-case-name> /path/to/the/plugin.clapAfter installing Rust, you can compile and run clap-validator as follows:
cargo run --release -- validate /path/to/the/plugin.clap