[[PageOutline(2-5,Contents,pullout)]]

= Beanstalk Web Hook

== Description

This is a Trac plugin for handling beanstalk 'web hook' commit callbacks in Trac-integrated repositories. [http://beanstalkapp.com/ Beanstalk] is A complete workflow to write, review and deploy code. It is a proprietary licensed paid service.

This means the svnsync commands can be done automatically on commit, instead of via an out-of-band setup. It also enables the full set of "commit ticket updater" features for automatically associating tickets with changesets.

It has only been tested with Subversion and Trac 0.12.2.

== Bugs/Feature Requests

Existing bugs and feature requests for BeanstalkPlugin are 
[https://github.com/trac-hacks/BeanstalkPlugin/issues here].

If you have any issues, create a 
[https://github.com/trac-hacks/BeanstalkPlugin/issues/new new issue].

== Download and Source

The project is hosted on [https://github.com/trac-hacks/BeanstalkPlugin GitHub].

== Installation / Configuration

 * Build and install the plugin: run `python setup.py bdist_egg`, copy the egg to `$trac/plugins`.
 * Svnsync initialize a local mirror of the beanstalk repository.
 * Add [beanstalk].trac_admin_command trac config, eg `trac_admin_command = /usr/local/bin/trac-admin`
 * Add [beanstalk].sync_commands trac config with exact svnsync synchronize command, eg `sync_commands = REPO:svnsync synchronize file:///home/svn-repos/REPO`
 * Beanstalk: point web hook integration at `http://trac/beanstalk_hook/REPO/`

== Author/Contributors

'''Author:''' [wiki:dlowe] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:''' [[BR]]