RCOP - Rust preCOmmit COP

This package provides a command line utility to validate commit messages.

Installation

To use this package, you'll need to have Rust and Cargo installed on your system. Once you have them, you can install this package by running the following command:

rs cargo install rcop

Usage

To use the command line utility, run the following command in the root of your git repository:

sh echo "docs: This is a first test" | rcop

This will read the commit message from the standard input, and then validate it based on the default commit types: fix, feat, docs, style, refactor, perf, test, and chore.

Add the location for rcop to your $PATH and the commit-msg from this repository into the .git/hooks/ to verify the message.

Options

Here are the command line options you can use with rcop:

--dont-exit-on-errors or -e: By default, the command line utility exits with a non-zero exit code when it encounters an error. If you pass this option, it will print the error message and continue running. --types or -t: This option allows you to override the commit types and the required fields for each commit type. For example, if you want to add a commit type named feature that requires a field named scope, you can pass the following argument: --types feature=scope. You can specify multiple commit types by separating them with semicolons, like this: --types fix=scope,description;feature=scope,body.

Examples

Here are some examples of how you can use rcop:

To validate a commit message that has the type fix and the field scope:

echo "fix(scope): Some fixes" | rcop

To validate a commit message that has the type docs and no required fields:

echo "docs: Some updates to the documentation" | rcop --types docs=

To validate a commit message that has the type docs and no required fields:

echo "wild(scope): Some updates to the documentation" | rcop --types wild=scope,description

To validate a commit message and print the error message instead of exiting:

echo "invalid: scope: Some invalid commit message" | rcop --dont-exit-on-errors

Output

When a commit message is successfully validated, rcop exits with a zero exit code and doesn't produce any output.

Otherwise, it prints an error message and exits with a non-zero exit code.