Conventional Commits Linter

A tooling/language agnostic utility to lint Git commit message against the Conventional Commits specification.

Why use Conventional Commits Linter?

• No Dependencies - A binary download is provided, removing dependencies on downloading tools or interpreter languages.
• Correctness - The linting against the Conventional Commits specification is strict. Numerous violations missed by other linters are caught.
• Sensible Defaults - By default no subjective linting rules are applied, only compliance with the Conventional Commits specification is asserted.
• Configurable - While by default no subjective linting rules are applied, additional subjective linting rules can be enabled.
• Fast - Utilising Rust the performance is significantly better than other interpreted language linters.

Upcoming

• Optional configuration file over CLI arguments/flags.
• Add commit title length arguments/flags.
• Add type as noun linting warning/CLI arguments/flags.
• Add scope as noun linting warning/CLI arguments/flags.
• Add exclamation before scope linting warning.
• Adding description casing CLI arguments/flags.
• Adding type casing CLI arguments/flags.
• Adding scope casing CLI arguments/flags.

Content

• Usage
  • Usage - Additional Flags
  • Usage - Logging
• Compiling via Local Repository
• Compiling via Cargo
• Unit Testing
• End-to-End Testing
• Issues/Feature Requests

Usage

Conventional Commits Linter operates directly on a Git repository, the Git environment variables are respected. With the environment variable GIT_DIR unset, Conventional Commits Linter will search for a Git repository starting in the current directory.

Using either the argument --from-commit-hash or --from-tag will note the start of the range of commits till HEAD to lint. The range is inclusive of HEAD and exclusive of the initial commit.

All commit messages in the range are linted against the Conventional Commits v1.0.0 specification. If any commits messages fail linting then an error message explaining why is logged and Conventional Commits Linter exits with a non zero exit code.

Usage - Additional Flags

| Flag | | |---------------------------|-| | --allow-angular-type-only | Allow the Conventional Commits type to only be (build, ci, docs, feat, fix, perf, refactor, style, test, revert), otherwise linting for the commit will fail. |

Usage - Logging

The crates pretty_env_logger and log are used to provide logging. The environment variable RUST_LOG can be used to set the logging level. See https://crates.io/crates/prettyenvlogger for more detailed documentation.

Compiling via Local Repository

Checkout the code repository locally, change into the repository's directory and then build via cargo. Using the --release flag produces an optimised binary but takes longer to compile.

git clone git@gitlab.com:DeveloperC/conventional_commits_linter.git cd conventional_commits_linter/ cargo build --release

The compiled binary is present in target/release/conventional_commits_linter.

Compiling via Cargo

Cargo is the Rust package manager, using the install sub-command it pulls the crate from crates.io and then compiles the binary locally. cargo install places the produced binary at $HOME/.cargo/bin/conventional_commits_linter.

cargo install conventional_commits_linter

Unit Testing

The unit test suite has a number parameterised tests testing the Conventional Commits v1.0.0 linting, cargo can be used to setup and run all the unit tests.

cargo test

End-to-End Testing

To ensure correctness as there are a variety of out of process dependencies the project has an End-to-End behaviour driven test suite using the behave framework (https://github.com/behave/behave). To run the test suite you need to first build a binary, install Python3, install behave and then execute behave to run the behaviour driven test suite.

Note - You can't use --release as the End-to-End test suite uses target/debug/conventional_commits_linter.

cargo build cd end-to-end-tests/ virtualenv -p python3 .venv source .venv/bin/activate pip3 install -r requirements.txt behave

Issues/Feature Requests

To report a bug/issue or request a new feature use https://gitlab.com/DeveloperC/conventionalcommitslinter/-/issues.