tracker_github_hook.rb

#!/usr/bin/env ruby
#
# GitHub Post-Receive hook handler to add comments, and update state in Pivotal Tracker
# Configure your Tracker API key, and Project ID in a config.yml file placed in the
# same directory as this app.
# When you make commits to Git/GitHub, and want a comment and optionally a state update
# made to Tracker, add the following syntax to your commit message:
#     
#     [Story#####]
# or
#     [Story##### state:finished]
#

require 'rubygems'
require 'sinatra'
require 'json'
require 'rest_client'
require 'yaml'


# load up configuration from YAML file
configure do
  begin
    config = open(File.expand_path(File.dirname(__FILE__) + '/config.yml')) { |f| YAML.load(f) }
    
    PROJECTS = Hash.new
    config.each do |project|
      raise "required configuration settings not found" unless project[1]['tracker_api_token'] && project[1]['tracker_project_id']    
      PROJECTS[project[1]['github_url']] = { :api_token => project[1]['tracker_api_token'], :project_id => project[1]['tracker_project_id'], :ref => project[1]['ref'] }
    end

    tokens_path = File.expand_path(File.dirname(__FILE__) + '/tokens.yml')
    PROJECTS['tokens'] = File.file?(tokens_path) ? YAML.load_file(tokens_path) : Hash.new
  rescue => e
    puts "Failed to startup: #{e.message}"
    puts "Ensure you have a config.yml in this directory with the'tracker_api_token' and 'tracker_project_id' keys/values set."
    exit(-1)
  end
end

# The handler for the GitHub post-receive hook
post '/' do
  @num_commits = 0
  push = JSON.parse(params[:payload])
  tracker_info = PROJECTS[push['repository']['url']]
  raise "GitHub Webook triggerd for repo: #{push['repository']['url']}; no matching github_url in config.yml" if tracker_info == nil
  if tracker_info[:ref] && push['ref'] != tracker_info[:ref]
      puts "Skipping commit for non-tracked ref #{push['ref']}"
  end
  push['commits'].each { |commit| process_commit(tracker_info, commit) }
  "Processed #{@num_commits} commits for stories"
end

get '/' do
    "Have your github webhook point here; bridge works automatically via POST"
end

  
helpers do
  def process_commit(tracker_info, commit)
    # get commit message
    message = commit['message']
    # see if there is a Tracker story trigger, and if so, get story ID
    message.scan(/\[Story(\d+)([^\]]*)\]/) do |tracker_trigger|
      @num_commits += 1
      story_id = tracker_trigger[0]
      clean_message = message.gsub(/\[.*\]/,'')

      # post comment to the story
      RestClient.post(create_api_url(tracker_info[:project_id], story_id, '/notes'),
                      "<note><text>#{clean_message} [https://github.com/kkouddous/hapnin/commit/#{commit['id']}]</text></note>", 
                      tracker_api_headers(PROJECTS['tokens'][commit['author']['email']] || tracker_info[:api_token]))
    
      # See if we have a state change
      state = tracker_trigger[1].match(/.*state:(\s?\w+).*/)
      if state
        state = state[1].strip

        RestClient.put(create_api_url(tracker_info[:project_id], story_id), 
                       "<story><current_state>#{state}</current_state></story>", 
                       tracker_api_headers(tracker_info[:api_token]))
      end     
    end
  end

  def create_api_url(project_id, story_id, extra_path_elemets='')
    "http://www.pivotaltracker.com/services/v1/projects/#{project_id}/stories/#{story_id}#{extra_path_elemets}"
  end
  
  def tracker_api_headers(api_token)
    { 'X-TrackerToken' => api_token, 'Content-type' => 'application/xml' }
  end

end