lita-gerrit

lita-gerrit is a handler for Lita that allows interaction with Gerrit code review tool.

It allows to fetch Gerrit changes details from the chat and listens for hook events on HTTP interface.

It depends on HTTParty because Gerrit uses HTTP digest authentication, which is not supported by Lita's built-in HTTP client, Faraday.

Installation

Add lita-gerrit to your Lita instance's Gemfile:

gem "lita-gerrit"

Configuration

url (String) - Gerrit service URL
username (String) - Username for REST API
password (String) - Password for REST API

Example

Lita.configure do |config|
  config.handlers.gerrit.url = "https://gerrit.example.com"
  config.handlers.gerrit.username = "foo"
  config.handlers.gerrit.password = "bar"
end

Usage

Chat functions

lita > gerrit 42
gerrit: Display debug informations with correct log level by John Doe in chef. http://gerrit.example.com/42
(gerrit: <commit message> by <author> in <project>. <url>)

HTTP endpoints

lita-gerrit listens for events triggered by Gerrit hooks. An example hook is provided in contrib directory.

Currently only these hooks are implemented:

patchset_created
comment_added
change_merged

See list of supported hooks in Gerrit doc

License

MIT

josqu4red / lita-gerrit