jira-creator
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
.tmplfiles located in thetemplates/directory. - Uses
TemplateLoaderto 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)
| File | Size | Uploaded | |
|---|---|---|---|
| jira_creator-0.0.39.tar.gz | 161.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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
|