# Git::Hooks
A Perl framework for implementing Git (and Gerrit) hooks.
## What's this about?
[Git hooks](
http://git-scm.com/book/en/v2/Customizing-Git-Git-Hooks) are
programs you install in Git repositories in order to augment Git's
functionality.
The Git::Hooks Perl module is a framework that makes it easier to implement and
use Git hooks. It comes with a set of plugins already implementing useful
functionality for you to make sure your commits comply with your project
policies. As a Git user or a Git server administrator you probably don't need to
implement any hooks for most of your needs, just to enable and configure some of
the existing plugins.
## Installation
Git::Hooks is installed like any other Perl module. It's easier to use a CPAN
client, such as `cpanm` or `cpan`, so that dependencies are installed
automatically:
$ cpanm Git::Hooks
$ cpan Git::Hooks
You can even use it directly from a clone of its Git repository. All you have to
do is to tell Perl where to find it by using this in your scripts:
use lib '/path/to/clone/of/git-hooks/lib';
use Git::Hooks;
## Documentation
The main module documents its [usage](
https://metacpan.org/pod/Git%3A%3AHooks)
in detail. Each plugin is implemented as a separate module under the
`Git::Hooks::` name space. Git::Hooks distribution comes with a set of plugins
and you can find more on
[CPAN](
https://metacpan.org/search?q=module%3AGit%3A%3AHooks). The native
plugins provided by the distribution are these:
- [Git::Hooks::CheckCommit](
https://metacpan.org/pod/Git%3A%3AHooks%3A%3ACheckCommit) -
enforce commit policies
- [Git::Hooks::CheckDiff](
https://metacpan.org/pod/Git%3A%3AHooks%3A%3ACheckDiff) -
check differences between commits
- [Git::Hooks::CheckFile](
https://metacpan.org/pod/Git%3A%3AHooks%3A%3ACheckFile) -
check file names and contents
- [Git::Hooks::CheckJira](
https://metacpan.org/pod/Git%3A%3AHooks%3A%3ACheckJira) -
integrate with [Jira](
https://www.atlassian.com/software/jira)
- [Git::Hooks::CheckLog](
https://metacpan.org/pod/Git%3A%3AHooks%3A%3ACheckLog) -
enforce log message policies
- [Git::Hooks::CheckReference](
https://metacpan.org/pod/Git%3A%3AHooks%3A%3ACheckReference) -
check reference names
- [Git::Hooks::CheckRewrite](
https://metacpan.org/pod/Git%3A%3AHooks%3A%3ACheckRewrite) -
protect against unsafe rewrites
- [Git::Hooks::CheckWhitespace](
https://metacpan.org/pod/Git%3A%3AHooks%3A%3ACheckWhitespace) -
detect whitespace errors
- [Git::Hooks::GerritChangeId](
https://metacpan.org/pod/Git%3A%3AHooks%3A%3AGerritChangeId) -
insert Gerrit's Change-Ids into commit messages
- [Git::Hooks::Notify](
https://metacpan.org/pod/Git%3A%3AHooks%3A%3ANotify) -
notify users via email
- [Git::Hooks::PrepareLog](
https://metacpan.org/pod/Git%3A%3AHooks%3A%3APrepareLog) -
prepare commit messages before being edited
For a gentler introduction you can read our
[Git::Hooks::Tutorial](
https://metacpan.org/pod/Git%3A%3AHooks%3A%3ATutorial). It
has instructions for Git users, Git administrators, and Gerrit administrators.
## Getting Help
In order to ask questions or to report problems, please, [file an issue at
GitHub](
https://github.com/gnustavo/Git-Hooks/issues).
## Copyright & License
Git::Hooks is copyright (c) 2008-2020 of [CPQD](
http://www.cpqd.com.br).
This is free software; you can redistribute it and/or modify it under the same
terms as the Perl 5 programming language system itself. About the only thing you
can't do is pretend that you wrote code that you didn't.
## Enjoy!
Gustavo Chaves <
[email protected]>
