Skip to content
A JIRA plugin for Lita
Ruby
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
lib
locales
spec
.gitignore
.rspec
.rubocop.yml
.ruby-version
.travis.yml
CHANGELOG.md
CONTRIBUTING.md
Gemfile
LICENSE
README.md
Rakefile
lita-jira.gemspec

README.md

lita-jira

Build Status MIT License RubyGems :: RMuh Gem Version Code Climate Gemnasium

A JIRA plugin for Lita.

Installation

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

gem "lita-jira"

Configuration

Add the following variables to your lita config file:

config.handlers.jira.username = 'your_jira_username'
config.handlers.jira.password = 'a_password'
config.handlers.jira.site     = 'https://your.jira.instance.example.com/'

Optional attributes

  • context (string) - If your instance is in a /subdirectory, put that here. Default: ''
  • format (string) - You can select a compact one line issue summary by setting this parameter to one-line. Default: verbose
  • ambient (boolean) - When set to true, Lita will show JIRA issue details when a JIRA issue key is mentioned in chat, outside the context of a command. Default: false
  • ignore (array) - Prevent ambient JIRA issue detection in certain users' messages. Accepts user names, mention names, and IDs. Default: []
  • rooms (array) - Limit ambient JIRA issue detection to a certain list of rooms. If unspecified, the bot will respond to detected issues in all rooms.
  • use_ssl (boolean) - When set to true, an SSL connection will be used to JIRA. Set to false if you run JIRA over plain http.
config.handlers.jira.context = '/myjira'
config.handlers.jira.format = 'one-line'
config.handlers.jira.ambient = true
config.handlers.jira.ignore = ['Jira', 'Github', 'U1234']
config.handlers.jira.rooms = ['devtools', 'engineering']
config.handlers.jira.use_ssl = false

Usage

Shortcuts

todo <project> "<subject>" ["<summary>"] - Creates an issue in <project> with <subject> and optionally <summary>
jira <issue>                             - Shows a short summary <issue>
jira details <issue>                     - Shows all details about <issue>
jira comment on <issue> <comment text>   - Adds <comment text> to <issue>
jira myissues                            - Displays a list of issues assigned to identified user

Misc

jira identify <email address> - Associate your chat user with your email address
jira forget                   - Remove your chat user / email association
jira whoami                   - Show your chat user / email association

CHANGELOG

CHANGELOG

License

MIT

You can’t perform that action at this time.