commitplease

Commitplease

This node.js module validates git commit messages while you commit, according to the rules specified in the jQuery Commit Guidlines. These are pretty generic, so this module should be useful for most projects that care about commit message formats.

Installation

npm install commitplease

Usage

Just commit as usual. This modules installs a git commit-msg hook, automatically validating all commit messages as you enter them. Invalid messages will be rejected, with details on what's wrong and a copy of the input.

API

The API is a work-in-progress. Currently there's no way to customize options when using the bundled commit hook.

var validate = require('commitplease/lib/validate');
var errors = validate(commit.message);
if (errors.length) {
	postComment('This commit has ' + errors.length + ' problems!');
}

validate(message[, options]), returns Array

• message (String): The commit message to validate. Must use LF (\n) as line breaks.
• options (Object, optional): Use this to override the default settings, see properties and defaults below
• returns Array: Empty for valid messages, one or more items as String for each problem found

Options and their defaults:

component: true,
limits: {
	subject: 72,
	other: 80
}

License

Copyright 2014 Jörn Zaefferer. Released under the terms of the MIT license.

---

Support this project by donating on Gittip.