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

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.44
File Size Uploaded
jira_creator-0.0.44.tar.gz 165.7 kB Details

Built distribution (wheel)

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

Total release size: 442.9 kB

Release files / jira_creator-0.0.44.tar.gz

Download URL jira_creator-0.0.44.tar.gz
Size 165.7 kB
Tags Source
SHA-256 checksum
How to use checksums
740bcebe50604a0d30b4ae5cd4556036bae1c7998ebe925b3e687046424230a6
BLAKE2b-256 checksum
How to use checksums
f464de9ddfef12834303c240aaec5faa1b20817a565dad754b9e5d04d5102a40
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.44-py3-none-any.whl

Download URL jira_creator-0.0.44-py3-none-any.whl
Size 277.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
85ea0020d8c8292bceddfd1c022aedb98a4f4348d2b3d226b17016334e623a31
BLAKE2b-256 checksum
How to use checksums
f2eb4e5ba947afe567dfd804ff6bd5f3a0e8b320519131db69b1eed6c4a50197
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

This release

0.0.44 This release

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

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