Skip to main content

jira-creator

Build Status Python License Last Commit

A powerful tool that streamlines the creation of JIRA issues such as stories, bugs, epics, spikes, and tasks. With the use of standardized templates and the option of AI-enhanced descriptions, you can create JIRA issues quickly and efficiently.

⚡ Quick Start

Get up and running in under 30 seconds.

1. Create your configuration file and enable autocomplete

Create a bash script with the values of your JIRA environment variables and enable the autocomplete feature with the following command:

mkdir -p ~/.bashrc.d
cat <<EOF > ~/.bashrc.d/jira.sh
# Your environment variables here...

# Enable autocomplete
eval "$(/usr/local/bin/rh-issue --_completion | sed 's/rh_jira.py/rh-issue/')"
EOF

source ~/.bashrc.d/jira.sh

2. Link the command-line tool wrapper

Make the command-line tool wrapper executable and link it to your local bin directory:

chmod +x jira_creator/rh-issue-wrapper.sh
sudo ln -s $(pwd)/jira_creator/rh-issue-wrapper.sh /usr/local/bin/rh-issue

3. Run the tool

You can create a new JIRA issue with the following command:

rh-issue create story "Improve onboarding experience"

🧪 Usage & Commands

// Your command list goes here...

🤖 AI Provider Support

Incorporate different AI providers by setting the AI_PROVIDER environment variable.

Use ollama for managing different models:

mkdir -vp ~/.ollama-models
docker run -d -v ~/.ollama-models:/root/.ollama -p 11434:11434 ollama/ollama

Various AI providers are supported, including OpenAI, LLama3, DeepSeek, and more. Setup details for each provider are provided below.

🛠 Dev Setup

Install development dependencies with pipenv:

pipenv install --dev

Testing & Linting

Run the tests and linters with:

make test
make lint
make super-lint

⚙️ How It Works

The tool:

  • Loads field definitions from .tmpl files located in the templates/ directory.
  • Uses TemplateLoader to generate Markdown descriptions.
  • Optionally uses AI for improving readability and structure.
  • Makes a request to the JIRA's REST API (or performs a dry-run).

📜 License

This project is licensed under the Apache License.

Metadata

Release files for jira-creator 0.0.38

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for jira-creator 0.0.38
File Size Uploaded
jira_creator-0.0.38.tar.gz 161.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for jira-creator 0.0.38
File Interpreter ABI Platform
jira_creator-0.0.38-py3-none-any.whl Python 3 none any Details

Total release size: 430.5 kB

Release files / jira_creator-0.0.38.tar.gz

Download URL jira_creator-0.0.38.tar.gz
Size 161.7 kB
Tags Source
SHA-256 checksum
How to use checksums
a8ab4b534c7b195af3af77669f9b9997e0a980c6c64009203868dd347fc34377
BLAKE2b-256 checksum
How to use checksums
20e7c7b7f89f5d3a8449b1d8d87e2c5b0f021db61f73548e6b807f5d8735d2d9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.3

Release files / jira_creator-0.0.38-py3-none-any.whl

Download URL jira_creator-0.0.38-py3-none-any.whl
Size 268.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2ff277a0b3d8f87bb96c0c0aa54f66313b3dcca40c57a0cb72636541657eb885
BLAKE2b-256 checksum
How to use checksums
bcfa3966330ef718da2acf87b223fec3241afb98d6843db5cb32b8f4499d755a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.3

Release history Release notifications | RSS feed

1.0.14

2 release files

1.0.13

2 release files

1.0.12

2 release files

1.0.11

2 release files

1.0.9

2 release files

1.0.3

2 release files

1.0.1

2 release files

0.0.44

2 release files

0.0.43

2 release files

0.0.42

2 release files

0.0.41

2 release files

0.0.40

2 release files

0.0.39

2 release files

This release

0.0.38 This release

2 release files

0.0.37

2 release files

0.0.36

2 release files

0.0.32

2 release files

0.0.31

2 release files

0.0.30

2 release files

0.0.29

2 release files

0.0.28

2 release files

0.0.27

2 release files

0.0.26

2 release files

0.0.17

2 release files

0.0.12

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page