Skip to main content

A succinct, minimal local jira control plane in a VSCode workspace. Because less Jira is more better!

Project description

powerjira

Get rid of the guff, because tickets should be simple.


Welcome to powerjira!

Put plainly, I don't enjoy my time in the Jira GUI. There's too much crap I don't care about, and even when you make your own ticket dashboard via JQL, the ticket views themselves could stand to be more minimal.
And that's where powerjira comes in ☕🤏

Open a minimal set of configuration files, whose location you control (defaults to $HOME), and interface with Jira in your favorite editor. It also offers an ergonomic way to manage watched tickets, and allows you to query tickets on key or status without having to remember JQL (because who wants that).

If you want to make tickets without the guff, I'm a pip install away!


Get Started 🚀


Export the following environment variables powerjira expects to be available for authentication:

export JIRA_DOMAIN=https://acme.atlassian.net
export JIRA_USERNAME=dingus@acme.com
export JIRA_TOKEN=abc123

Then:

pip install powerjira
pip install --upgrade powerjira

python -m powerjira --help
python -m powerjira init # stubs config if missing, opens in editor

Usage ⚙


For convenience, set some macro in your shell like:

alias pj='python -m powerjira'

Now the terminal is your ticketing interface:

pj goto # opens config in editor

pj fetch QA-123 # shows ticket
pj "to do" # shows all your tickets
pj make # reads specs from your config
pj watched prune # un-watches all your 'DONE' watched tickets
pj watched list

Technologies 🧰



Contribute 🤝


If you have thoughts on how to make the tool more pragmatic, submit a PR 😊
Also see TODOD for feature roadmap.

Documentation on the python jira module can be explored here.


License, Stats, Author 📜


example image tag

PyPI - License PyPI - Version GitHub repo size

See License for the full license text.

This package was authored by Isaac Yep.

Project details


Download files

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

Source Distribution

powerjira-1.0.0.tar.gz (31.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

powerjira-1.0.0-py3-none-any.whl (33.3 kB view details)

Uploaded Python 3

File details

Details for the file powerjira-1.0.0.tar.gz.

File metadata

  • Download URL: powerjira-1.0.0.tar.gz
  • Upload date:
  • Size: 31.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.1.2 CPython/3.13.2 Darwin/24.4.0

File hashes

Hashes for powerjira-1.0.0.tar.gz
Algorithm Hash digest
SHA256 a1ca6790b90d20829af0b35d9b2c3ef53aca9ae63606b4fb4a96e54d5e07c843
MD5 36f0414ca64cb607fa5d3b6afb232baf
BLAKE2b-256 227ee922e6f46a17ccce82b41c539e6a1b141ba82c0c98ec0ed0423cb016517e

See more details on using hashes here.

File details

Details for the file powerjira-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: powerjira-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 33.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.1.2 CPython/3.13.2 Darwin/24.4.0

File hashes

Hashes for powerjira-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 831688c93384bde35443cfe6f00e4cb475dfa17f4c3c2e148883c5a4fddc501a
MD5 e019a0ef329bd8d2e336dd22f87e1c14
BLAKE2b-256 5eca521fd62b31c918140a6575356ce9ac570f09adb484c0192e6d06dc519501

See more details on using hashes here.

Supported by

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