jirify
A simple ruby gem that helps me work with jira
Installation
- Run
gem install jirify
. - Execute
jira setup
and go through the setup process. - Optionally source
$HOME/.jirify/jirify.bash_completion.sh
to have autocomplete in bash. - Execute
jira
andjira <command> help
to learn about available commands.
Config Explained
Currently, the config structure of jirify
is:
-
$HOME/.jirify
folder that contains:-
.jirify
- yaml file generated byjira setup
-
jirify.bash_completion.sh
- bash completion script you can source. This is placed here byjira setup
, so if you don't see it or you want to refresh it, runjira setup
again. -
.cache
- cache for completion script
-
Config file: $HOME/.jirify/.jirify
options:
username: <atlassian username (email)>
token: <token generated from https://id.atlassian.com>
site: <JIRA url>
projects:
- <JIRA project key>
filter_by_labels:
- <label to filter by when displaying sprint>
verbose: <force jirify to always be verbose>
To Do
- Tests:
- Test CLI classes.
- Test UI classes.
- Test
Models::Issue
. - Test
Models::Transition
,Models::BaseList
(?). - Test
Config::copy_bash_completion!
.
- Refactor Models -
BaseList
doesn't make much sense. -
RefactorSprintCell
:-
It should be a more generalIssueRenderer
. -
Use it forjira issues describe
with additional option to draw border.
-
- Adjust
jira issues mine
to terminal width. - Add ability to define mapping between custom statuses and custom transitions in config.
- Add ability to specify custom filters when listing issues (both
jira sprint
andjira issues
)