Metadata-Version: 2.4
Name: toil-radar
Version: 0.1.4
Summary: Detect, visualize, and reduce DevOps toil
Author-email: Amrut Pagidipally <amrut.pagidipally@gmail.com>
Project-URL: Homepage, https://github.com/amrutp24/toil-radar
Project-URL: Repository, https://github.com/amrutp24/toil-radar
Project-URL: Issues, https://github.com/amrutp24/toil-radar/issues
Keywords: devops,sre,toil,automation,cli,productivity
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: streamlit>=1.29.0
Requires-Dist: pandas>=2.0.0
Requires-Dist: plotly>=5.0.0
Provides-Extra: dev
Requires-Dist: pytest>=6.0; extra == "dev"
Requires-Dist: pytest-cov>=2.0; extra == "dev"
Dynamic: license-file

# Toil Tracker

🔧 **Detect, visualize, and reduce DevOps toil** - Installable CLI tool for tracking repetitive operational work

## 🚀 Quick Install

```bash
pip install toil-radar
```

## 📱 Usage

### Scan a repository for toil:
```bash
toil-radar scan /path/to/your/repo
toil-radar scan /path/to/repo --days 60
```
 
### View toil summary:
```bash
toil-radar summary
toil-radar summary --days 30
```
 
### Launch web dashboard:
```bash
toil-dashboard
```
 
## 🎯 What it Detects

Automatically scans Git commit messages for toil patterns:

- **manual_deploy** - Manual deployment activities
- **manual_fix** - Emergency fixes and hotfixes  
- **revert** - Rollbacks and reverts
- **env_setup** - Environment configuration work
- **restart** - Service restarts/reboots

## 📊 Example Output

```
Scanning /myproject for toil patterns...
✅ Found 15 toil events

Breakdown:
  manual_deploy: 6
  manual_fix: 4
  restart: 3
  env_setup: 2

Toil Summary (last 30 days):
----------------------------------------
manual_deploy: 6 total
  HIGH: 3
  MEDIUM: 2
  LOW: 1
manual_fix: 4 total
  HIGH: 2
  MEDIUM: 1
  LOW: 1
```

## 🌟 Why This Matters

**30% of engineering time is spent on toil** - manual, repetitive work that provides no lasting value. This tool helps you:

1. **Identify** where your engineering time is going
2. **Discover** automation opportunities  
3. **Quantify** operational overhead
4. **Make informed** DevOps decisions

## 🎯 What It Actually Does

**Detects & Visualizes:**
- Manual deployment patterns
- Repetitive fixes and hotfixes
- Environment setup work
- Service restarts/reboots
- Rollbacks and reverts

**Then you decide where to automate based on the insights.**

## 🛠️ Development Install

```bash
git clone https://github.com/amrutp24/toil-radar
cd toil-radar
pip install -e .
```

## 📈 Next Steps

1. **Scan your repos** - Find your team's toil patterns
2. **Share findings** - Show colleagues the automation opportunities
3. **Automate the top 3** - Tackle highest-frequency toil first
4. **Track improvement** - Use dashboard to measure progress

## 🤝 Contributing

Found a toil pattern we missed? Open an issue or PR!

- Add detection patterns to `toil_detector.py`
- Improve visualizations in `dashboard.py`
- Share your toil reduction stories!

## 📄 License

MIT License - see [LICENSE](LICENSE) file

---

**⚡ Stop wondering where your engineering time goes. Start making data-driven DevOps decisions.**
