CODEWITHSUNDEEP
gitgit-post-receive
Errol
Errol

Reputation: 702

How to test git hooks

Since "testing" is a common use for a Git hook, my question is hard to search for.

I'm writing a fairly involved git post-receive hook and want to know what the best way to test it is. Currently my process is:

Is there any easier way to test this? Ideally it would look like:

Perhaps I can "reissue" a previous push or have the remote repo act as though it just received a push with a specific hash?

Upvotes: 46

Views: 32381

Answers (5)

Denilson Sá Maia
Denilson Sá Maia

Reputation: 49407

The original question was about post-receive hook, but I have a solution that should work for some other hooks, such as pre-push.

Some git commands have a --dry-run parameter:

$ git push --help | grep -A2 -- --dry-run
…
       -n, --dry-run
           Do everything except actually send the updates.

$ git pull --help | grep -A2 -- --dry-run
       --dry-run
           Show what would be done, without making any changes.

$ git commit --help | grep -A2 -- --dry-run
…
       --dry-run
           Do not create a commit, but show a list of paths that are to be
           committed, paths with local changes that will be left uncommitted

Thus, you can test a pre-push hook by running git push --dry-run. It will run the hook, but won't push any changes.

This may also work for some other commands and hooks. But I understand this isn't a general answer. (e.g. It doesn't apply to post-receive.)

Upvotes: 0

BMW
BMW

Reputation: 45263

Answer this four-years-old question.

If you'd like to test hook, you need to test in local environment first, I give the detail commands for following up, use post-receive as sample:

$ mkdir /tmp/hook_test
$ cd /tmp/hook_test

$ # set local git repo, where you put hooks in it.
$ git clone --bare https://github.com/git/git.git

$ # set develop environment which is cloned from the new created repo. 
$ git clone git.git repo 
    
$ # copy and rename the hook you need test to "post-receive"
$ cd git.git/hooks
$ cp ~/post-receive-test post-receive

$ # suppose the hook script is bash script.
$ # edit "post-receive" and add "set -x" to second line in it to active debug

$ cd /tmp/hook_test/repo
$ # emulate a hook trigger, do some changes, "git add" and "git commit" it 

$ git push
 
$ # Now you should see the script "post-receive" runs automatically with debug details.

You should be free to run git push, that the updates are only pushed to local repo /tmp/hook_test/git.git

Upvotes: 22

fariwesen
fariwesen

Reputation: 111

For debugging you could also end your hook in something like this:

echo "No errors found."
exit 1

If you are happy with you hook you of course take out the last line again.

Upvotes: 5

dirksen
dirksen

Reputation: 173

My approach is to dial the HEAD at the remote repo back one commit, and then push again:

ssh <repo> 'cd /<repo_path>; git update-ref refs/heads/master HEAD^' && git push origin master

Upvotes: 8

Lily Ballard
Lily Ballard

Reputation: 185681

Write a hook that just records its arguments/environment and dumps that to a file. Then you can just re-invoke the real hook at your leisure with the same environment/arguments and it will act as though you just re-issued the exact same push.

Upvotes: 16

Related Questions