GitHub and Redmine integration

One of the challenges of hosting projects on GitHub and their ticket trackers elsewhere is linking items like GitHub Pull Requests with tickets. I’ve written a very simple API-driven prototype tool called GhostRed to do some simple integration. GhostRed scans GitHub pull requests, creates Redmine tickets in an appropriate project for them and then closes the request with a comment that includes a link to the ticket created. You can install GhostRed with:

1
$ gem install ghostred

And you can use it pretty simply like so:

1
$ ghostred --rm_token=token --rm_site=http://projects.puppetlabs.com --gh_org=puppetlabs --gh_token=token --gh_user jamtur01

Replace the options with ones appropriate to your environment. GhostRed also tries to match GitHub repository names to Redmine projects but also contains a mapping hash The full help text:

1
$ ghostred --help
2
Usage: ghostred [options] ...
3

4
Configuration options:
5
    -r, --rm_token TOKEN             The API token to use with Redmine
6
    -s, --rm_site SITE               The Redmine site to connect to
7
    -g, --gh_org GITHUB_ORG          The GitHub organisation
8
    -u, --gh_user GITHUB_USER        The GitHub user
9
    -t, --gh_token TOKEN             The GitHub token
10

11
Common options:
12
    -v, --version                    Display version
13
    -h, --help                       Display this screen

You can find the code on GitHub and comments, patches and feedback welcomed.