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

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.43
File Size Uploaded
jira_creator-0.0.43.tar.gz 165.2 kB Details

Built distribution (wheel)

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

Total release size: 440.8 kB

Release files / jira_creator-0.0.43.tar.gz

Download URL jira_creator-0.0.43.tar.gz
Size 165.2 kB
Tags Source
SHA-256 checksum
How to use checksums
727648b2c67ec6e2e2b25cdfd4125803c23fb18d2eaf7d3bc443bad8e3da8f03
BLAKE2b-256 checksum
How to use checksums
af82a4cb5357f0263b407911d2503c8667b49433c1c471a1a1eb200322206339
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.43-py3-none-any.whl

Download URL jira_creator-0.0.43-py3-none-any.whl
Size 275.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6abb05dd71ca17e45f5ae2f6548ac6b99f6c06a2dcdebd0bfc8c150e205d443f
BLAKE2b-256 checksum
How to use checksums
6f9188f338ad4a7e837769bcdf58831f55a602dfaa3cd478e11e34a2df8931c1
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

This release

0.0.43 This release

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

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