A command line tool to list open jira issues
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Paul Buetow 3bf35cd8df use txt rather than pod 4 weeks ago
bin initial version of the template 9 years ago
debian Change github name 7 years ago
docs New release 8 years ago
src add unassigned switch 8 years ago
.version New release 8 years ago
Makefile New release 8 years ago
README.txt use txt rather than pod 4 weeks ago


japi - A Humble Jira API Tool

This is a small and simple command line tool to be used manually or via
cron to fetch the newest unresolved and unclosed tickets from a Jira

It might be usefull to write the results every hour to a local file and
do a "cat ~/.issues" every time you open a new shell.

CAUTION: You may also need to install the "JIRA::REST" module from CPAN
manually. It's not included in standard Debian GNU/Linux Wheezy yet.

Synopsis: japi [--debug] [--help] [--version] [--nocolor] [--passfile]
[--unassigned] [--jira_apiversion STRING] [--jira_query STRING]
[--jira_uribase STRING] [--jira_user STRING]

Prints out extra debugging infos during execution.

Prints out the help.

Prints out the version.

By default the output uses colored text output. This switch disables

--passfile STRING
Specifies the path to an optional file which includes the Jira API
password but Base64 encoded. The default value is "~/.japipass".

If the file is not present, Japi will prompt for the password.

By default the output lists assigned and unassigned issues. Use this
switch to only list unassigned issues.

--jira_apiversion STRING
Specifies the Jira API version to use. The default value is

--jira_query STRING
Specifies the Jira search string (e.q. a JQL string). The default
value is "search?jql=project=MT and status not in

--jira_uribase STRING
Specifies the Jira URI base. The default value is
"https://your-jira.example.com". This has to be changed.

--jira_user STRING
Specifies the Jira user. The default value is your current
Linux/UNIX user.

Almost all options have to be passed the Japi tool via command line. One
exception is the password file containing your Jira password Base64

It can be created like this:

bash -c 'read -s PASSWORD; tr -d "\n" <<< "$PASSWORD" | base64' | tee ~/.japipass
chmod 0600 ~/.japipass

Paul C. Buetow - <paul@buetow.org>