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.39

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.39
File Size Uploaded
jira_creator-0.0.39.tar.gz 161.8 kB Details

Built distribution (wheel)

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

Total release size: 430.5 kB

Release files / jira_creator-0.0.39.tar.gz

Download URL jira_creator-0.0.39.tar.gz
Size 161.8 kB
Tags Source
SHA-256 checksum
How to use checksums
af20968399e54df5a4e361280856917d0e65b841b8bced83f20476d1fb546736
BLAKE2b-256 checksum
How to use checksums
b8a18ac13e290d62d4bb4d1dc9aea7030c36679c5bb2784bfbf2c4807f7f5bd5
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.39-py3-none-any.whl

Download URL jira_creator-0.0.39-py3-none-any.whl
Size 268.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b611154fe4c828b2bc2bc8dfa1f783a1104d67c31388119caef1466e26d36092
BLAKE2b-256 checksum
How to use checksums
0076e0369f17831e618879bcf2ebe4f28228d6fe832880f2df3b79df324cb04c
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

This release

0.0.39 This release

2 release files

0.0.38

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