A succinct, minimal local jira control plane that can live in your text editor. Interface with tickets fast!
Project description
PowerJira
A succinct local jira control plane
Welcome to PowerJira!
Hate how visually noise and clunky the Jira web-app is? Ever wish you could just type the small subset of issue fields you actually care about into an editor and create/find tickets quickly?
Welcome to the party! 🥳
Table of Contents 📖
Get Started 🚀
To get started, clone this repo and populate the config files per the readme.
Specifically, you need 4 files. These can be named whatever you wish by editing main.py:59
.
Below are the requirements of the file with the default (suggested) file names:
summary
- Text file for the issue summarydescription
- Text file for the issue descriptionagent.yml
- Yaml file for user credentialsconfig.yml
- Yaml file to configure issue creation
The text files simply contain the text you want in the ticket.
As for the yaml files, see the Usage section below.
Set up your editor space the way you like it, and bam! You've dramatically reduced your time spent in the jira web-app, and even possibly absolve the need for it completely!
Usage ⚙
With your shell's working directory positioned where the 4 files are present (or if paths have been set accordingly):
Create ticket with config values
./main.py [-r|--raw]
Fetch info from existing ticket
./main.py --fetch=<issue-key> [-r|--raw]
Info
./main.py [-h|--help]
The "raw" option flag (-r
, --raw
) outputs a formatted dump of the raw api response.
For your own custom use:
from powerjira import fetchIssue, createTicket
For the configuration yaml's: config.yml
project: <project-key>
priority: <priority>
epicKey: # Leave as empty for standalone task or epic
issueType: <type>
reporter: <reporter-account-id>
assignee: <assignee-account-id>
agent.yaml
domain: <host>
userName: <email>
token: <jira-access-token>
Technologies 🧰
Contribute 🤝
Feel free to push PR's to help make this tool more extensible/flexible.
Acknowledgements 💙
Thanks to Atlassian for making market-leading tools that kinda frustrate me.
License, Stats, Author 📜
See License for the full license text.
This repository was authored by Isaac Yep.
PyPi Package
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
Hashes for powerjira-0.2.6-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6a5a1ebf9a90118912e32891ecc70b8b464f7f9fa947e1e66b103c33119c2cda |
|
MD5 | 008b4dc4c86e375ea042343d6a7007af |
|
BLAKE2b-256 | 9464997ab79d9ea57c77f2b50675b8bf397e9bad01179eca9642cd4ae2f32540 |