Command line utilities for interacting with JIRA
Project description
jira-commands
Table of Contents
Some command-line tools for interacting with JIRA.
Scripts
All of these scripts support --help
to get a detailed list of command line options.
Name | Description |
---|---|
jc |
Main driver. Will run all the other commands inside a docker container for you. |
jc add label / jc label add |
Add a label to a ticket |
jc assign subtasks / jc assign ticket subtasks |
Assign a ticket to someone. |
jc assign ticket / jc ticket assign |
Assign a ticket to someone. |
jc close subtasks / jc close ticket subtasks |
Close all of a ticket's subtasks |
jc close ticket / jc ticket close |
Close a ticket |
jc comment on subtasks / jc comment on ticket subtasks |
Add identical comment to all of a ticket's subtasks |
jc comment on ticket / jc ticket comment |
Comment on a ticket |
jc create ticket / jc ticket create |
Create a ticket. You will need |
jc custom field allowed values |
List a custom field's allowed values since JIRA isn't forthcoming about them. |
jc examine ticket / jc ticket examine |
Detailed dump of a ticket and all its custom field names |
jc extract customfield mappings |
Extract the custom field mappings from an issue into a file |
jc get label / jc list labels |
List labels on a ticket |
jc get link types |
Prints the names of all link types defined on your JIRA instance. |
jc get priority ids |
Prints the names of all ticket priorities defined on your JIRA instance. |
jc label remove / jc remove label |
Remove a label from a ticket |
jc link tickets / jc ticket link |
Link two tickets. Use jc get link types to see what link names are defined on your JIRA server. Case matters. |
jc list project tickets |
List open tickets in a given JIRA project |
jc list subtasks |
Close all of a ticket's subtasks |
jc list ticket transitions / jc ticket transition list |
See the availale transitions for a given ticket. |
jc transition ticket to / jc ticket transition set |
Transition a ticket to another state. Use jc list ticket transitions to see which are available |
jc vivisect ticket / jc ticket vivisect |
Detailed dump of a ticket to find out all the custom field names and other innards. |
jc transition subtasks / jc transition ticket subtasks |
Transition all of a ticket's subtasks to a specific state |
The jc
program is the main driver script and will find the subcommands, so you can do jc ticket comment --ticket ABC-123 --comment 'foo bar baz'
and it will find the jc-ticket-comment
script and run it with the --ticket
and --comment
arguments.
If you're using the docker method, jc
will automatically run the subcommands inside a container for you. If you've installed via pip, it'll find the commands where they were installed in your $PATH
.
Configuration
The jc
commands all read settings from ~/.jira-commands/jira.yaml
. Settings in the file can be overridden by specifying command-line options.
Basic Authentication
I'm setting my username and jira server in the example configuraation file below. The tools will ask for my password when I run them.
jira_server: https://jira.example.com
username: YOUR_JIRA_USER
You can specify a password
key but it's a terrible idea.
OAuth Authentication
Here's an example settings file for oauth authentication. Add --auth=OAUTH
to use oath instead of basic authentication.
jira_server: https://jira.example.com/
oauth_access_token: ABCDabcdABCDabcdABCDabcdABCDabcd
oauth_access_token_secret: ABCDabcdABCDabcdABCDabcdABCDabcd
oauth_consumer_key: OAUTH_CONSUMER_KEY_ID
oauth_private_key_pem_pathL: /path/to/pem/file
username: YOUR_JIRA_USER
PAT authentication
Here's an example settings file for PAT authentication.
username: YOUR_JIRA_USER
pat_token: xyzzyAbc123
jira_server: https://jira.example.com/
Installation
Run via docker / nerdctl
This is the recommended way to use the jc
commands, and how it will be run if you use one of the ZSH frameworks detailed below.
If you're not using a ZSH framework, clone this repository and add its bin
directory to your $PATH
. It contains a jc
script that will detect whether you have nerdctl
or docker
and if it finds them, map ~/jira-commands
(and the configuration file there) into a volume in the jira-commands
container and run the tools inside the container.
Direct pip install
sudo pip install jira-commands
will install the command-line tools via pip
. This may cause compatibility annoyances with other python tools on your system, so there's a docker
/nerdctl
option as well.
ZSH plugin
The tooling has been packaged as a ZSH plugin to make using it as easy as possible for ZSH users.
zgenom
If you're using Zgenom:
- Add
zgenom load unixorn/jira-commands
to your.zshrc
with your other plugins zgenom reset && zgenom save
Antigen
If you're using Antigen:
- Add
antigen bundle unixorn/jira-commands
to your .zshrc where you've listed your other plugins. - Close and reopen your Terminal/iTerm window to refresh context and use the plugin. Alternatively, you can run
antigen bundle unixorn/jira-commands
in a running shell to haveantigen
load the new plugin.
oh-my-zsh
If you're using oh-my-zsh:
-
Clone the repository into a new
jira-commands
directory in oh-my-zsh's plugin folder:git clone https://github.com/unixorn/jira-commands.git $ZSH_CUSTOM/plugins/jira-commands
-
Edit your
~/.zshrc
and addjira-commands
– same as clone directory – to the list of plugins to enable:plugins=( ... jira-commands )
-
Then, restart your terminal application to refresh context and use the plugin. Alternatively, you can source your current shell configuration:
source ~/.zshrc
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file jira_commands-0.22.2.tar.gz
.
File metadata
- Download URL: jira_commands-0.22.2.tar.gz
- Upload date:
- Size: 28.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.8.2 CPython/3.9.18 Darwin/23.5.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6156151892318a64ba72ca38061d8b528136b7eb36aa53a03f7e396ac7fbd164 |
|
MD5 | 24ddde9e067ec2977d81f29df13878cc |
|
BLAKE2b-256 | b06e1f65b8cd745589e412ad46f1430d04105ec6fddae40ad881008ff504dde1 |
File details
Details for the file jira_commands-0.22.2-py3-none-any.whl
.
File metadata
- Download URL: jira_commands-0.22.2-py3-none-any.whl
- Upload date:
- Size: 32.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.8.2 CPython/3.9.18 Darwin/23.5.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | abb0bc01179025e1e7ae85a5cce5605c081a6e9378fc01f5c3e500cedcd0f4a3 |
|
MD5 | c660689b454edeeded387d073e6c5c8d |
|
BLAKE2b-256 | 4eb0fdb4c3085c3744b208dad2c83a5d00ecb2cccf059ceaf098455459dbd704 |