sweetchuck/git-hooks

Provide a bridge between Git hooks and scripts under VCS.

Friday, July 28, 2017
by Sweetchuck
Repository
4 Watchers
0 Stars
1,448 Installations

PHP
24 Dependents
0 Suggesters
0 Forks
1 Open issues
12 Versions
86 % Grown

The README.md

sweetchuck/git-hooks

Triggers custom scripts from Git hooks., _(*1)

This package provides a bridge between the un-versioned ./.git/hooks/* scripts and scripts in your Git repository., _(*2)

, _(*3)

When to use

If you want to put your Git hook scripts under VCS to share them with your teammates then this is the tool you are looking for., _(*4)

How to use

Step into you existing package's directory (or create a new one with git init && composer init)
Run composer require --dev 'sweetchuck/git-hooks'
Then you have two option
1. Rely on Git hook scripts which are shipped with this package and implement the logic in your ./.git-hooks file.
2. Or create a ./git-hooks directory and create Git hook files in it. (eg: ./git-hooks/pre-commit)
The deployment script will be automatically triggered by the post-install-cmd Composer event.

Configuration

Example composer.json file:, _(*5)

{
    "extra": {
        "sweetchuck/git-hooks": {
            "core.hooksPath": "./git-hooks",
            "symlink": true
        }
    }
}

Configuration - core.hooksPath

Type: string, _(*6)

Default value: vendor/sweetchuck/git-hooks/git-hooks (dynamically detected), _(*7)

If the Git version is >= v2.9 then this value will be used to set git config core.hooksPath <PATH>. If Git is older than 2.9 then the content of this directory will be symbolically linked or copied to ./.git/hooks directory., _(*8)

Configuration - symlink

Type: boolean, _(*9)

Default value: false, _(*10)

This configuration option will be used only if Git version is older than v2.9. Copy or symlink Git hook files from the original location (provided by the core.hooksPath configuration) to the ./.git/hooks., _(*11)

Example ./.git-hooks file

If you use the Git hooks script from this package (vendor/sweetchuck/git-hooks/git-hooks) you will need custom script which catches Git hooks add triggers something really useful., _(*12)

Copy the content below into ./.git-hooks, _(*13)

#!/usr/bin/env bash

echo "BEGIN Git hook: ${sghHookName}"

function sghExit ()
{
    echo "END   Git hook: ${sghHookName}"

    exit $1
}

# @todo Better detection for executables: php, composer.phar.
sghRobo="$(composer config 'bin-dir')/robo"

test -s "${sghBridge}.local" && . "${sghBridge}.local"

sghTask="githook:${sghHookName}"

# Exit without error if "robo" doesn't exists or it has no corresponding task.
test -x "$sghRobo" || sghExit 0
"${sghRobo}" help "${sghTask}" 1> /dev/null 2>&1 || sghExit 0

if [ "$sghHasInput" = 'true' ]; then
    "$sghRobo" "${sghTask}" $@ <<< $(</dev/stdin) || sghExit $?
else
    "$sghRobo" "${sghTask}" $@ || sghExit $?
fi

sghExit 0

Example ./RoboFile.php

<?php

/**
 * Git hook tasks have to be started with 'githook' prefix.
 * So the method name format is: githook<GitHookNameInCamelCaseFormat>
 * Or use the @command annotation.
 */
class RoboFile extends \Robo\Tasks
{

    /**
     * Demo pre-commit callback.
     *
     * @command githook:pre-commit
     */
    public function githookPreCommit()
    {
        $this->say('The Git pre-commit hook is running');
    }
}

The Versions

28/07 2017

dev-master

9999999-dev

Provide a bridge between Git hooks and scripts under VCS.

Sources Download

GPL-2.0

The Development Requires

28/07 2017

v0.0.10

0.0.10.0

Provide a bridge between Git hooks and scripts under VCS.

Sources Download

GPL-2.0

The Development Requires

15/10 2016

v0.0.9

0.0.9.0

Provide a bridge between Git hooks and scripts under VCS.

Sources Download

GPL-2.0

The Development Requires

10/07 2016

v0.0.8

0.0.8.0

Provide a bridge between Git hooks and scripts under VCS.

Sources Download

GPL-2.0

The Development Requires

09/07 2016

v0.0.7

0.0.7.0

Provide a bridge between Git hooks and scripts under VCS.

Sources Download

GPL-2.0

The Development Requires

09/07 2016

dev-core-hooks-path

Provide a bridge between Git hooks and scripts under VCS.

Sources Download

GPL-2.0

The Development Requires

08/07 2016

v0.0.6

0.0.6.0

Provide a bridge between Git hooks and scripts under VCS.

Sources Download

GPL-2.0

The Development Requires

07/07 2016

v0.0.5

0.0.5.0

Provide a bridge between Git hooks and scripts under VCS.

Sources Download

GPL-2.0

The Development Requires

25/06 2016

v0.0.4

0.0.4.0

Provide a bridge between Git hooks and Robo tasks.

Sources Download

GPL-2.0

The Development Requires

07/06 2016

v0.0.3

0.0.3.0

Provide a bridge between Git hooks and Robo tasks.

Sources Download

GPL-2.0

The Development Requires

01/06 2016

v0.0.2

0.0.2.0

Provide a bridge between Git hooks and Robo tasks.

Sources Download

GPL-2.0

The Development Requires

28/05 2016

v0.0.1

0.0.1.0

Provide a bridge between Git hooks and Robo tasks.

Sources Download

GPL-2.0

library git-hooks

Provide a bridge between Git hooks and scripts under VCS.