SuperHooks
SuperHooks is a quick way to have hooks apply across multiple projects. It allows you to decouple the hooks you use from the projects you use them in by pacing the hooks into seperate folders.
Hooks are defined at three levels:
- Global hooks : hooks available everywhere
- User hooks : hooks used for your own user
- Project hooks : hooks used only for a project
Once a hook gets invoked from git
, all the different types of hook will run.
Installation
To install it yourself do:
$ gem install super_hooks
Then from any git project you can use:
$ super_hooks --install
Usage
Install super_hooks
into a git repository:
$ super_hooks --install
List the current hooks:
$ super_hooks
See the other options with:
$ super_hooks --help
Creating hooks
Locations
Hook Type | Location |
---|---|
User Hooks | installed in ~/.git_hooks/ |
Project Hooks | installed in your projects .git/git_hooks/ folder |
Global Hooks | indicated by your hooks.global configuration |
Note: You can have multiple hooks.global
configurations by either:
1. adding them with the command: `git config --add hooks.global </path/to/hooks/directory>
2. adding the paths in a comma seperated value way
Examples
Once super_hooks
is installed, you can easily create hooks by placing executables files (chmod 755
) under a folder with the hook name.
For example, if you were to create a pre-commit hook for your user, you would do the following:
$ mkdir -p ~/.git_hooks/pre-commit/
$ touch ~/.git_hooks/pre-commit/cool_hook
$ chmod 755 ~/.git_hooks/pre-commit/cool_hook
Note: having a --about
option when running your executable will allow you to have a short description when listing hooks. See my rake example for this project.
Example: I have my own hooks which I have installed for all of my projects:
$ git clone [email protected]:frankywahl/git_hooks.git somewhere
$ cd somewhere
$ git config --global hooks.config `pwd`
Code Status
Contributing
- Fork it ( https://github.com/[my-github-username]/super_hooks/fork )
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new Pull Request
Copyright
Copyright (c) 2014 Franky W.
See LICENSE.txt for details.
Credits
A great thanks to icefox git-hooks which was greatly used for this project and his blogpost