Metadata-Version: 2.1
Name: powerjira
Version: 0.1.4
Summary: A succinct, minimal local jira control plane that can live in your text editor. Interface with tickets fast!
Home-page: https://github.com/anthonybench/powerjira
License: GNU GPL
Keywords: jira,poetry
Author: sleepyboy
Author-email: anthonybenchyep@gmail.com
Requires-Python: >=3.10,<4.0
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Requires-Dist: PyYAML (>=6.0,<7.0)
Requires-Dist: jira (>=3.4.1,<4.0.0)
Project-URL: Repository, https://github.com/anthonybench/powerjira
Description-Content-Type: text/markdown

# **PowerJira**
*A succinct local jira control plane*

<br />

## **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! 🥳

<br />

### **Table of Contents** 📖
<hr>

  - [Welcome](#Welcome-to-Powerjira)
  - [**Get Started**](#Get_Started)
  - [Usage](#Usage-⚙)
  - [Technologies](#technologies-)
  - [Contribute](#Contribute-)
  - [Acknowledgements](#acknowledgements-)
  - [License/Stats/Author](#license-stats-author-)

<br />

## **Get Started 🚀**
<hr>

To get started, clone the [interface repository](https://github.com/anthonybench/powerjira) 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 summary
- `description` - Text file for the issue description
- `agent.yml` - Yaml file for user credentials
- `config.yml` - Yaml file to configure issue creation

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!

<br />

## **Usage ⚙**
<hr>

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**
```sh
./main.py [-r|--raw]
```
**Fetch info from existing ticket**
```sh
./main.py --fetch=<issue-key> [-r|--raw]
```
**Info**
```sh
./main.py [-h|--help]
```

The "*raw*" option flag (`-r`, `--raw`) outputs a formatted dump of the raw api response.

<br />

## **Technologies 🧰**
<hr>

  - [PyYAML](https://pypi.org/project/PyYAML/)
  - [python-jira](https://pypi.org/project/jira/)
  - [Poetry](https://python-poetry.org/)

<br />

## **Contribute 🤝**
<hr>

Feel free to push PR's to help make this tool more extensible/flexible over at the [GitHub repo](https://github.com/anthonybench/powerjira).

<br />

## **Acknowledgements 💙**
<hr>

Thanks to Atlassian for making market-leading tools that kinda frustrate me.

<br />

## **License, Stats, Author 📜**
<hr>

<img align="right" alt="example image tag" src="https://i.imgur.com/jtNwEWu.png" width="200" />

<!-- badge cluster -->

![PyPI](https://img.shields.io/pypi/v/powerjira)
![GitHub repo size](https://img.shields.io/github/repo-size/anthonybench/powerjira)

<!-- / -->
See [License](https://www.gnu.org/licenses/gpl-3.0.txt) for the full license text.

This repository was authored by *Isaac Yep*.

[Back to Table of Contents](#table-of-contents)
