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

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

Built distribution (wheel)

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

Total release size: 430.5 kB

Release files / jira_creator-0.0.41.tar.gz

Download URL jira_creator-0.0.41.tar.gz
Size 161.8 kB
Tags Source
SHA-256 checksum
How to use checksums
db2bfd94ef4fa969b670d26de2b7136bd6a57b39cac0c6a482fc565068a54bd6
BLAKE2b-256 checksum
How to use checksums
d895c7b5eedc7fa4877acb48b9a8660de2bb3018fb94649383bf40785f858a38
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.41-py3-none-any.whl

Download URL jira_creator-0.0.41-py3-none-any.whl
Size 268.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c3131be272683502072590a69fdd3a3e442f45ee247d0140c3f916d44d7330bd
BLAKE2b-256 checksum
How to use checksums
90d18b479de1522fb921ed1b1ef937b99a3d07c4187b5a54a957c43e8745b366
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

This release

0.0.41 This release

2 release files

0.0.40

2 release files

0.0.39

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