0.0.7 • Published 8 years ago

hubot-github-mention-notifier v0.0.7

Weekly downloads
1
License
MIT
Repository
github
Last release
8 years ago

hubot-github-comment-notifier

A GitHub pull request and issue comment notifier for hubot

See following for full documentation.

Assumptions

hubot-github-comment-notifier makes the following assumptions:

  • Pull request and issue comments should be notified with assignee and mentions when they are specified
  • Pull request and issue comments may be notified in different rooms
  • May limit notifications only when there are mentions in comments
    • Currently other conditions like labels and milestones are not supported to limit notifications
    • Your pull requests are welcomed to add more control to the notification limitation
  • Other GitHub events than pull request and issue comment should be supported in other modules
  • Only sends notifications when
    • pull request
      • pull request is (re)opened
      • comment is added to pull request
      • pull request is closed
    • issue
      • issue is (re)opened
      • comment is added to issue
      • issue is closed

Installation

In hubot project repo, run:

npm install hubot-seen --save

Then add hubot-github-comment-notifier to your external-scripts.json:

["hubot-github-comment-notifier"]

Configuration

VariableDescription
HUBOT_TEAM_PATH(Optional) If you want to convert GitHub's @ mention to another services's (Slack and etc.) mention, you can specify a json file to describe the conversion rule.

HUBOT_TEAM_PATH

The json file should looks like this:

{
  "@github_mention": "<@slack_mention>"
}

See _team.json for its example

Webhooks

Pull Request

You need to add HUBOT_URL/hubot/github-pull-request?room=ROOM[&only-mentioned=1][&randm-mention=1] to your repository's webhooks.

ParameterDescription
HUBOT_URLYour Hubot server's url
ROOMTo which room you want to send notification
  • When &only-mentioned=1 is added, it sends notifications only when there are @ mentions.
  • When &random-mention=1 is added, it picks-up a user from team.json and send notification.
    • You can specify more than 2 in the value to pick-up more than two users.

Issue

You need to add HUBOT_URL/hubot/github-issue?room=ROOM[&only-mentioned=1] to your repository's webhooks.

ParameterDescription
HUBOT_URLYour Hubot server's url
ROOMTo which room you want to send notification
  • When &only-mentioned=1 is added, it sends notifications only when there are @ mentions.
0.0.7

8 years ago

0.0.6

8 years ago

0.0.5

8 years ago

0.0.4

8 years ago

0.0.3

8 years ago

0.0.2

8 years ago

0.0.1

8 years ago