commit-check/README.org

1.4 KiB

commit-check v0.1.0

This is the commit-check project. It is a quick and easy commit style checker that can be used either as a git hook to enforce the style checked by commit-check, or as a syntax checker back-end (like Flycheck).

The entire code for the project is currently contained in the commit-check file. The files test-pass.txt, test-fail-barely.txt and test-fail-miserably.txt are used for testing purposes. They contain and explain certain situations that can occur when writing commits that may or may not cause errors to be reported.

Installation

commit-check can either be used manually (or as a back-end to some other tool), or as a git commit-msg hook to stop you from committing badly styled commit messages.

For manual use

To get this project up and running make sure you have perl installed and that commit-check is somewhere in your PATH.

As git hook

Place the commit-check executable file in the .git/hooks directory of your project, with the name commit-msg. It doesn't need to be the actual executable, it can also be a (soft) link to the executable, or a script running this program (passing along all arguments).

License

This project is licensed under the GNU GPLv3, its terms and conditions can be found in the file COPYING in the project source tree.