Jira Workflow Automation Tool

A command-line tool for automating Jira ticket analysis and workflow metrics reporting.

Features

• Fetch tickets from Jira projects via REST API
• Calculate workflow metrics (cycle time, status distribution)
• Export results to CSV format
• Command-line interface with progress indicators

Status

🚧 In Development - Sprint Week 1

Quick Start

Coming soon...

Documentation

• Architecture
• API Reference
• Usage Examples

Tech Stack

• Language: Python 3.9+
• Core Libraries: requests, pandas, click, python-dotenv
• Testing: pytest, pytest-cov
• Code Quality: black, flake8

Project Structure

jira-automation/
├── src/              # Source code
├── tests/            # Test files
├── docs/             # Documentation
├── logs/             # Log files (gitignored)
└── output/           # Generated reports (gitignored)

Development

Setup

# Clone the repository
git clone https://github.com/yourusername/jira-automation.git
cd jira-automation

# Create virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Install in development mode
pip install -e .

Running Tests

# Run all tests with coverage
pytest

# Run with verbose output
pytest -v

# Generate HTML coverage report
pytest --cov=src --cov-report=html

Code Quality

# Format code with black
black .

# Check code style with flake8
flake8 src/ tests/

License

MIT