No commit activity in last 3 years
No release in over 3 years
GitHub web hook integration for Lita.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.3
>= 0
>= 0
>= 3.0.0.beta2

Runtime

>= 0.6.9
>= 2.7
>= 1.5.0
 Project Readme

lita-github-web-hooks

lita-github-web-hooks integrates GitHub Web Hooks with Lita. It allows Lita to announce various GitHub activity in the chat.

Installation

Add lita-github-web-hooks to your Lita instance's Gemfile:

gem "lita-github-web-hooks"

Configuration

Required attributes

  • room_ids (Array<String>) - An array of string room IDs. Events received from GitHub will be announced in every room defined by this attribute.
  • user_ids (Array<String>) - An array of string user IDs. Events received from GitHub will be sent to every user defined by this attribute.

Example

Here is an example of what a configuration for Lita running on HipChat might look like.

Lita.configure do |config|
  config.handlers.github_web_hooks.room_ids = ["12345_myroom"]
  config.handlers.github_web_hooks.user_ids = ["12345_123456@chat.hipchat.com"]
end

Usage

IMPORTANT: Only the ping, push, and watch hooks are implemented so far. The rest of the hooks will be coming when GitHub documents their payloads.

  1. Specify which rooms and users you want GitHub activity announced to via the configuration attributes.
  2. Use GitHub's API or a repository's settings page to create a new hook for the events you're interested in. Set the "Payoad URL" to http://example.com/github-web-hooks, where example.com is the hostname where your Lita instance is running.

License

MIT