tirajira 1.1.4

TiraJira - tool for automating mass task creation in Jira with support for JSON, YAML, CSV, Excel and XML formats

TiraJira - Jira Task Automation

Tired of manually creating dozens or hundreds of tasks in Jira? TiraJira is your solution!

TiraJira is a powerful command-line utility for automating mass task creation in Jira. Just prepare tasks in a file (JSON, YAML, CSV, Excel or XML), and TiraJira will do the rest - create all your tasks in minutes instead of hours of manual work.

Key Features

• 🚀 Mass Task Creation - create dozens and hundreds of tasks in one operation
• 📁 Support for Different Formats - use familiar formats JSON, YAML, CSV, Excel or XML
• 🔗 Automatic Epic Linking - link tasks to epics without additional actions
• 🔗 Creating Links Between Tasks - automatically create links between new and existing tasks
• ⚡ Batch Processing - optimized task submission for maximum performance
• 🛠️ Full Custom Field Support - use all your Jira fields, including custom ones
• 📊 Detailed Logging - track the task creation process in real time
• 🛑 Error Stop Mode - stop processing when errors occur (--stop-on-error)
• 📋 Report Generation - get machine-readable reports in JSON, CSV, Excel, YAML, XML formats
• 🔁 Execution Resumption - continue from where you left off when errors occur
• 🔒 Protection Against Directory Traversal Attacks - preventing access to files outside the working directory

Quick Start

1. Install TiraJira:

   pip3 install tirajira
   

2. Prepare a task file in JSON format:

   [
     {
       "project": {"key": "PROJ"},
       "summary": "First task",
       "description": "Description of the first task",
       "issuetype": {"name": "Task"}
     }
   ]
   

3. Create tasks in Jira:

   tirajira import tasks.json
   

Done! Your tasks are created in Jira.

System Requirements

• Python 3.10 or higher
• Access to Jira Server
• API token for Jira access

Installation

For regular users (recommended):

pip3 install tirajira

For developers:

git clone https://github.com/your-login/tirajira.git
cd tirajira
poetry install

More about installation

Jira Connection Setup

TiraJira supports two authentication modes:

• Jira Cloud - Basic Auth (email + API token)
• Jira Server/Data Center - Personal Access Token

More about connection setup

Preparing a Task File

Supported formats: JSON, YAML, CSV, Excel, XML

Minimal example (JSON):

[
  {
    "project": {"key": "PROJ"},
    "summary": "My first task",
    "issuetype": {"name": "Task"}
  }
]

More about file formats

Commands

• import - Create tasks from file
• resume - Resume execution from report
• extract-failed - Extract failed tasks from report

More about commands

Detailed Documentation

• 🔧 Installation and Setup
• 🔐 Jira Connection Setup
• 📝 Preparing Task Files
• 🧰 Commands and Options
• 💡 Practical Examples
• 📋 Supported Task Fields
• 🛑 Request Rate Limiting Management
• ❓ Solving Common Problems
• 🤔 Frequently Asked Questions
• 📊 Report Format
• 👥 Contributing
• 🆘 Support

License

Apache License 2.0 - see LICENSE file for details.