command line utility for interacting with jira

Navigation

Verified details

These details have been verified by PyPI
Maintainers
Avatar for alisaifee from gravatar.com alisaifee

Unverified details

These details have not been verified by PyPI
Project links
GitHub Statistics

View statistics for this project via Libraries.io, or by using our public dataset on Google BigQuery

Meta

License: MIT License (MIT)

Author: Ali-Akber Saifee

Classifiers

Project description

Introduction

Simple command line utility to interact with your jira instance.

build status

Installation

  • with easy_install or pip:

    sudo easy_install jira-cli
sudo pip install jira-cli

  • from source:

    git clone http://github.com/alisaifee/jira-cli
cd jira-cli
python setup.py build
sudo python setup.py install

  • after installation, a few configuration steps will be prompted upon invoking jira-cli for the first time:

    ali@home ~ $ jira-cli
base url for your jira instance (e.g http://issues.apache.org/jira):http://jira.yourdomain.com
enter username:ali
enter password:*********

    The details of your jira instance will be kept in ~/.jira-cli/config and the authentication token will be stored in ~/.jira-cli/auth. Once the authentication token has expired you will be reprompted for your username & password again. Alternatively you can provide the username and password on the command line as:

    ali@home ~ $ jira-cli --user=ali --password=sekret ...

Usage

A few examples to get started.

create an issue with only a title in project TP with default priority and type Bug:

ali@home ~ $ jira-cli -n Bug -t "Test Bug" --priority=Major -p TP
link                 : http://jira.yourdomain.com/browse/TP-24
assignee             :
summary              : Test Bug
issue                : TP-24
reporter             : ali

create an issue with priority Major and a description:

ali@home ~ $ jira-cli -n Bug -t "Test Bug" --priority=Major -p TP the description
link                 : http://jira.yourdomain.com/browse/TP-25
assignee             :
summary              : Test Bug
issue                : TP-25
reporter             : ali

list the issue TP-25:

ali@home ~ $ jira-cli TP-25
link                 : http://jira.yourdomain.com/browse/TP-25
assignee             :
summary              : Test Bug
issue                : TP-25
reporter             : ali

list the issues TP-20 & TP-21:

ali@home ~ $ jira-cli TP-20 TP-21
link                 : http://jira.yourdomain.com/browse/TP-20
assignee             : ali
summary              : test
issue                : TP-20
reporter             : ali

link                 : http://jira.yourdomain.com/browse/TP-21
assignee             :
summary              : Test Bug
issue                : TP-21
reporter             : ali

list the issues in short form:

ali@home ~ $ jira-cli TP-20 TP-21 TP-22 --oneline
TP-20 test < http://jira.yourdomain.com/browse/TP-20 >
TP-21 Test Bug < http://jira.yourdomain.com/browse/TP-21 >
TP-22 Test Bug < http://jira.yourdomain.com/browse/TP-22 >

add a comment to an existing issue:

ali@home ~ $ jira-cli -j TP-20 -c this is a new comment
this is a new comment added to TP-20

provide your own formatting:

ali@home ~ $ jira-cli TP-20 --format="%reporter, %summary, %status"

free text search for issues:

ali@home ~ $ jira-cli --search some random words

jql search for issues:

ali@home ~ $ jira-cli --search-jql 'reporter=ali and type=bug'

list only the comments for an issue:

ali@home ~ $ jira-cli --comments-only TP-20
Thu Nov 10 08:42:55 UTC 2011 ali : this is a new comment
Fri Dec 02 00:19:40 UTC 2011 ali : another comment
Sat Mar 10 11:08:34 UTC 2012 ali : test comment
Sat Mar 10 11:08:51 UTC 2012 ali : another test comment

Project details

Verified details

These details have been verified by PyPI
Maintainers
Avatar for alisaifee from gravatar.com alisaifee

Unverified details

These details have not been verified by PyPI
Project links
GitHub Statistics

View statistics for this project via Libraries.io, or by using our public dataset on Google BigQuery

Meta

License: MIT License (MIT)

Author: Ali-Akber Saifee

Classifiers

Release history Release notifications | RSS feed

3.0

2.2

2.1.5

2.1.4

2.1.3

2.1.2

2.1.1

2.1.0

2.0.17

2.0.16

2.0.15

2.0.14

2.0.13

2.0.12

2.0.11

2.0.10

2.0.9

2.0.8

2.0.7

2.0.6

2.0.5

2.0.4

2.0.3

2.0.2

2.0.1

2.0.0

This version

0.4.2

0.4.1

0.4

0.3.10

0.3.9

0.3.8

0.3.7

0.3.6

0.3.5

0.3.4

0.3.3

0.3.2

0.3.1

0.3

0.2.9

0.2.8

0.2.7

0.2.6

0.2.5

0.2.4

0.2.3

0.2.1

0.2

0.1.9

0.1.8

0.1.7

0.1.6

0.1.5

0.1.4

0.1.3

0.2.1-1-g5d009e5

0.1.8-1-gd421df1

0.1.6-3-g7c96d5a pre-release

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jira-cli-0.4.2.tar.gz (7.3 kB view hashes)

Uploaded Source

Built Distributions

jira_cli-0.4.2-py2.7.egg (13.7 kB view hashes)

Uploaded Source

jira-cli-0.4.2.macosx-10.4-x86_64.tar.gz (37.9 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page