Official GitHub Services Integration - You can set these up in your repo admin screen under Service Hooks
Switch branches/tags
Nothing to show
Pull request Compare This branch is 3 commits ahead, 3032 commits behind github:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
config handle secrets.yml file with a .gitignore Sep 8, 2010
script - improve error reporting and POST handling Nov 1, 2010
spec Add specs for freckle service. Feb 4, 2009
vendor Forgot to vendor eventmachine. This is needed for the AMQP service (a… Nov 23, 2010
LICENSE add LICENSE Jul 14, 2008
Rakefile Added Rakefile with a RSpec task to make running of specs easier May 6, 2008
github-services.rb merge Nov 18, 2010


GitHub Services

How the services work

  1. A post-receive background job is submitted when someone pushes their commits to GitHub
  2. If the repository the commits belong to has any "Service Hooks" setup, the job makes a request to http://services-server/service_name/ with the following data:
    • params[:payload] containing all of the commit data (the same data you get using the API)
    • params[:data] containing the service data (username, password, room, etc)
  3. Sinatra (github-services.rb) processes the request (twitters your data, says something in campfire, posts it to lighthouse, etc)
  4. Rinse and repeat

Steps to contributing

  1. Fork the project

  2. Create a new file in /services/ called service_name.rb, using the following template:

     service :service_name do |data, payload|
  3. Vendor any external gems your code relies on, and make sure to include it in the requires at the top of github-services.rb

  4. Add documentation to docs/service_name (refer to the others for guidance)

  5. Add your name to the CONTRIBUTORS file

  6. Send a pull request from your fork to github/github-services

  7. Once it's accepted we'll add any new necessary data fields to the GitHub front-end so people can start using your addition.

Patches including tests are encouraged

Running the server locally

  1. [sudo] gem install hpricot
  2. git clone git://
  3. cd github-services
  4. ruby github-services.rb
  • Bugs in the code should be filed under the Issues tab
  • Problems with the service hooks can be filed here

How to test your service

  1. Start the github-services Sinatra server with ruby github-services.rb. By default, it runs on port 8080.
  2. Edit the doc/github_payload file as necessary to test your service. (Usually just editing the "data" values but leaving the "payload" alone.)
  3. Send the doc/github_payload file to your service by calling: ./script/deliver_payload [service-name]

NOTE: The name of the service and your docs/ file matters. If your service is RunCodeRun, your service and docs MUST be run_code_run. Good luck!