felipebool / crook
Crook is a simple tool to ease your life when dealing with git hooks
Installs: 13 135
Dependents: 0
Suggesters: 0
Security: 0
Stars: 59
Watchers: 4
Forks: 5
Open Issues: 0
Requires
- php: ^7.1
- symfony/console: ^4.0
Requires (Dev)
- codacy/coverage: ^1.4
- phpunit/phpunit: ^7.0
- squizlabs/php_codesniffer: ^3.2
- vlucas/phpdotenv: ^2.4
README
Crook
First of all, Crook is a work in progress.
If you are not familiar with git hooks, you may want to read Git Hooks documentation first.
Crook is the simplest way to define and manage your Git Hooks. Its aim is to allow scripts from your composer.json run when git hook actions are triggered.
Usage
The aim of this project is to be as simple as possible, thus, you won't have to write any PHP code, you just need to install any packages from packagist and then make them run for partucular git hooks. The process is explained in the following sections.
Installation
Just run
$ composer require felipebool/crook --dev
Init Crook
$ vendor/bin/crook init
will create crook.json configuration file and theHook in the root of your project.
Add a new hook
$ vendor/bin/crook add hook-name action-name
will create a symbolic link from .git/hooks/hook-name to theHook, enabling that hook.
Remove a hook
$ vendor/bin/crook remove hook-name
will remove the symbolic link .git/hooks/hook-name, disabling that hook.
Add a action to composer.json
When you add a new action using add
you need to add what is expected to run when that action is triggered inside you composer.json. To do that, you must create a new entry inside the section scripts
and then define what must run there.
Crook configuration file
Crook uses a json configuration file just like composer, it is called crook.json. The configuration is made, basically, by writting as a key the git hook name and as value the respective script entry in composer.json. See the following example
{ "pre-commit": "code-check", "composer": "/home/felipe/bin/composer" }
Although you are able to edit crook.json by yourself, you should do it using $ vendor/bin/crook
in order to create the symbolic links. Only the composer path must be set manually. The mechanism is explained in the next section.
The mechanism
Every time you run a
vendor/bin/crook add hook-name action-name
Crook creates a symbolic link from .git/hooks/hook-name to /your/project/hook/theHook, simple as that.
Now, when git trigger the action hook-name, it will follow the link to /your/project/hook/theHook and Crook will then look for a script named action-name inside your project's composer.json and will execute the commands defined there.
Adding code validation using phpcs before any commit
In order to check your code against PSR2, you must do this
Add the script action inside composer.json
"scripts": {
"code-check": "phpcs --standard=PSR2 src/",
}
Initialize crook
$ vendor/bin/crook init
Bind code-check to pre-commit hook
$ vendor/bin/crook add pre-commit code-check
Next time you run $ git commit -m 'some message'
crook will run the code defined inside code-check and will prevent code from being commited if the check fail.