Script to tie git and Jira

I have started a project on github that is essentially a script to tie git and Jira, at http://github.com/rael/git-jira. We use it at our company to help us with release management and it has proven useful. See the README file for complete details. Following is a brief overview.

The script implements a certain convention we use: developers do work on topic branches that are named after Jira tickets and are created as branches off of origin/master.

When you first run the script, it will prompt you for connection parameters to your Jira server. You will then be able to create new Jira issues and associated git branches:

% git jira open --summary "Better log filtration method"
git branch PROJ-20 created
% git branch -a
  PROJ-20
* master

You can supply defaults for project, component, and issue type in your git config file, and you can provide these as arguments to the script as well (the README shows how to do this).

You can add a suffix when opening an issue if you like, to help you remember the purpose of the branch:

% git jira open --summary "Better log filtration method" -x "improve_logging"
git branch PROJ-20_improve_logging created
% git branch -a
  PROJ-20_improve_logging
* master

Or, you can rely on the script to tell you details of a git jira branch (with or without a suffix):

% git jira describe -i PROJ-20_improve_logging Data for issue: PROJ-20

Issue key . . . . . . . . . . : PROJ-20 Type . . . . . . . . . . . . : Bug(1) Status . . . . . . . . . . . : Open(1) Priority . . . . . . . . . . : Major(3) Assignee . . . . . . . . . . : rael Reporter . . . . . . . . . . : rael Created . . . . . . . . . . . : 11/16/09 7:30 PM Updated . . . . . . . . . . . : 11/16/09 7:30 PM Due date . . . . . . . . . . : Summary . . . . . . . . . . . : Better filtration method Description . . . . . . . . . : Components . . . . . . . . . : 'Component1' Affects versions . . . . . . : Fix versions . . . . . . . . : Environment . . . . . . . . . : Resolution . . . . . . . . . : Votes . . . . . . . . . . . . : 0

Adding a '-v' or '--verbose' will add all comments to the output.

This will also work implicitly for the current branch:

% git checkout PROJ-20_improve_logging % git jira describe Data for issue: PROJ-20

Issue key . . . . . . . . . . : PROJ-20 Type . . . . . . . . . . . . : Bug(1) [...]

You can also resolve issues you have completed:

% git jira close -i PROJ-20 Successfully progressed issue: PROJ-20 with step 'Resolve Issue'

Feel free to provide comments, criticize, suggest improvements, etc.

Bill