Skip to content

Latest commit

 

History

History
133 lines (90 loc) · 4.1 KB

README.markdown

File metadata and controls

133 lines (90 loc) · 4.1 KB

notify-webhook

notify-webhook is a git post-receive hook script that posts JSON data to a webhook capable server.

This implements the GitHub Web hooks API as closely as possible. It allows arbitrary git repositories to use webhook capable services.

As an example, this script works very well with commitbot which sends commit notifications to XMPP group chat rooms.

Dependencies

Usage

Installation & Configuration (manual)

To use notify-webhook, just copy notify-webhook.py to your repository's .git/hooks dir and call it post-receive. Be sure to set it executable with chmod 755 post-receive as well.

Configuration is handled through git config. We use sensible defaults where possible.

Configuration example:

git config meta.url "http://example.com"
git config hooks.webhookurl "http://example.net"

Installation & Configuration (Gitolite)

Please see the installation details at Gitolite repo-specific hooks.

Configuration example:

repo some-repo-in-gitolite
  option hook.post-receive = notify-webhook
  config meta.url = "http://example.com"
  config hooks.webhookurl = "http://example.net"

Configuration Parameters

hooks.webhookurl

The URL to the webhook consumer - the commit details will be POSTed here.

Defaults to None which will echo the JSON data instead of sending it (unless the hooks.webhookurls configuration is set).

hooks.webhookurls

A list of URLs to different webhook consumers - the commit details will be POSTed to each of them in the order they arrive (if hooks.webhookurl is set, the commit details will be POSTed to that URL first).

The value is parsed like a csv file so each URL is separated by a comma or a newline (or a combination of the two). URLs with a comma in them can be wrapped in quotation marks.

An example of value with two URLS:

git config hooks.webhookurls 'http://example.com/hook,"http://other.example.com/hook,with,comma"'

Defaults to None which will echo the JSON data instead of sending it (unless the hooks.webhookurl configuration is set).

meta.ownername / meta.owneremail

Details about the repository owner.

Defaults the gitweb.owner variable, and falls back to author details on the initial commit to the repository.

meta.reponame

The name of the repository.

Defaults to the repository name as determined by its path.

meta.description

Description of the repo.

Defaults to the gitweb.description config variable, and falls back to the contents of the description file. This behavior is intended to be compatible with GitWeb.

meta.url

The URL of your repository browser

Defaults to None

meta.commiturl

The URL of a commit in your repository browser. %s is replaced with the SHA1 hash of the commit. Defaults to meta.url+'/commit/%s' or None

meta.compareurl

The URL of a diff in your repository browser. Must contain two %s elements. Defaults to meta.url+'/compare/%s..%s' or None

hooks.authuser

Username to use for basic and digest authentication.

Defaults to None

hooks.authpass

Password to use for basic and digest authentication. Note that it is stored in plaintext in git's config file!

Defaults to None

hooks.authrealm

Realm to use for digest authentication.

Defaults to None

hooks.secrettoken

Secret token to use for GitHub-compatible X-Hub-Signature header.

Defaults to None

hooks.webhook-contenttype

Payload Content Type to use for the body of the data. Supported values are:

  • application/x-www-form-urlencoded (default).
  • application/json

License

This code is copyright (c) 2008-2015 by Jack Moffitt [email protected] and others; and is available under the GPLv3. See LICENSE.txt for details. See CONTRIBUTORS.markdown for all authors.