hgcampfire

hgcampfire is a Mercurial hook to notify a Campfire chatroom about changesets coming in to a repository.

Usage:

Add the following to your Mercurial config (in a system, user, or repo-level hgrc file), replacing the API key, URL, and room ID:

[campfire]
api_key = CAMPFIRE_AUTH_TOKEN_FOR_THE_USER_NOTIFICATIONS_WILL_COME_FROM
url = http://myorg.campfirenow.com
room = 123456

[hooks]
changegroup.campfire = python:hgcampfire.notify

These configs can of course be separated into different hgrc files, for instance if you want to specify the Campfire data user-wide, but apply the actual hook only to certain repositories.

Customization

You can modify the template hgcampfire uses for its notification by setting the template config value in the [campfire] section. The default value is {user} pushed:\n{changesets}. This template has the following context available to it: root is the repository root path, user is the value of the $USER environment variable, and changesets is the list of changesets pushed.

You can also modify the template hgcampfire uses to report each changeset, by setting the cset_template config value in the [campfire] section. This should be a Mercurial changeset template, of the same form you'd pass to --template. The default value is * "{desc}" by {author}.

What is new in this release:

• Add option to avoid announcing merges coming from a branch that matches a regular expression

What is new in version 0.3:

• add controls to limit types of changesets that get announced - add option to show only changesets on a certain branch - add option to not show single branch merges - add option to not show multi branch merges - add option to not show normal non-merge changesets

What is new in version 0.2.3:

• Document that Campfire's API now requires HTTPS.

What is new in version 0.2.2:

• don't let Python 2.5 and earlier raise HTTPError on 201 response code
• list multiple changesets in most-recent-first order

What is new in version 0.2.1:

• don't force the message type to TextMessage

Requirements:

• Python