LinuxCommandLibrary

gitlint

Git commit message linter checks your commit messages for style.

TLDR

Check the last commit message

$ gitlint
copy


The range of commits to lint
$ gitlint --commits [single_refspec_argument]
copy


Path to a directory or Python module with extra user-defined rules
$ gitlint --extra-path [path/to/directory]
copy


Start a specific CI job
$ gitlint --target [path/to/target_directory]
copy


Path to a file containing a commit-msg
$ gitlint --msg-filename [path/to/filename]
copy


Read staged commit meta-info from the local repository
$ gitlint --staged
copy

SYNOPSIS

gitlint [OPTIONS] COMMAND [ARGS]...

DESCRIPTION

Git lint tool, checks your git commit messages for styling issues

Documentation: http://jorisroovers.github.io/gitlint

OPTIONS

--target DIRECTORY

Path of the target git repository. [default: current working directory]

-C, --config FILE

Config file location [default: .gitlint]

-c TEXT

Config flags in format <rule>.<option>=<value> (e.g.: -c T1.line-length=80). Flag can be used multiple times to set multiple config values.

--commits TEXT

The range of commits to lint. [default: HEAD]

-e, --extra-path PATH

Path to a directory or python module with extra user-defined rules

--ignore TEXT

Ignore rules (comma-separated by id or name).

--contrib TEXT

Contrib rules to enable (comma-separated by id or name).

--msg-filename FILENAME

Path to a file containing a commit-msg.

--ignore-stdin

Ignore any stdin data. Useful for running in CI server.

--staged

Read staged commit meta-info from the local repository.

-v, --verbose

Verbosity, more v's for more verbose output (e.g.: -v, -vv, -vvv). [default: -vvv]

-s, --silent

Silent mode (no output). Takes precedence over -v, -vv, -vvv.

-d, --debug

Enable debugging output.

--version

Show the version and exit.

--help

Show this message and exit.

Commands:

generate-config

Generates a sample gitlint config file.

install-hook

Install gitlint as a git commit-msg hook.

lint

Lints a git repository [default command]

run-hook

Runs the gitlint commit-msg hook.

uninstall-hook

Uninstall gitlint commit-msg hook.

When no COMMAND is specified, gitlint defaults to 'gitlint lint'.

SEE ALSO

The full documentation for gitlint, is maintained as a Texinfo manual. If the info and gitlint, programs are properly installed at your site, the command info gitlint, should give you access to the complete manual.

Copied to clipboard