🛠️ GitHub Utilities

A comprehensive collection of GitHub automation tools for developers, DevOps teams, and project managers. Streamline your GitHub workflows with powerful utilities for issue management, automation, and reporting.

---

🚀 Available Tools

📝 Issue Creator

Automate GitHub issue creation with configurable templates and bulk operations.

• Bulk Issue Creation: Create multiple issues from text files
• Template-Based: Use JSON configuration files for consistent formatting
• Smart Features: Duplicate prevention, dry-run mode, label management
• Use Cases: Project planning, feature requests, compliance tracking

Quick Start:

cd issue-creator/
python github-issue-creator.py --config config-examples/basic-config.json --file examples/sample-items.txt

📊 Issue Analyzer

Generate detailed reports and analytics from closed GitHub issues.

• Advanced Filtering: Filter by labels, date ranges, assignees
• Multiple Exports: CSV, JSON, and console outputs
• Comprehensive Analytics: Trends, statistics, resolution times
• Use Cases: Team performance, sprint retrospectives, reporting

Quick Start:

cd issue-analyzer/
python github-issues-analyzer.py --owner myorg --repo myrepo --format csv

---

🛠️ Coming Soon

🔄 PR Automation (Planned)

• Automated pull request creation and management
• Template-based PR descriptions
• Bulk PR operations

🏛️ Repository Management (Planned)

• Repository setup and configuration automation
• Bulk repository operations
• Settings synchronization

🔒 Branch Protection Utilities (Planned)

• Automated branch protection rule setup
• Policy management across repositories
• Compliance enforcement

⚡ GitHub Actions Helpers (Planned)

• Workflow template generation
• Action configuration utilities
• CI/CD automation tools

---

📋 Quick Setup

Prerequisites

• Python 3.7+
• GitHub Personal Access Token
• Git configured with your GitHub account

Installation

# Clone the repository
git clone https://github.com/CloudSecOpsAI/github-utilities.git
cd github-utilities

# Install dependencies
pip install -r requirements.txt

# Set up environment
cp issue-creator/env.example .env
# Edit .env with your GitHub token

Authentication Setup

1. Create a GitHub Personal Access Token
2. Add token to your .env file:

GITHUB_TOKEN=your_token_here

---

📁 Repository Structure

github-utilities/
├── README.md                          # This overview
├── LICENSE                            # MIT License
├── requirements.txt                   # Shared dependencies
├── .gitignore                         # Global ignore patterns
├── issue-creator/                     # Issue creation tools
│   ├── README.md                     # Issue creator documentation
│   ├── github-issue-creator.py       # Main script
│   ├── config-examples/              # Template configurations
│   └── examples/                     # Usage examples
├── issue-analyzer/                    # Issue analysis tools
│   ├── README.md                     # Issue analyzer documentation
│   ├── github-issues-analyzer.py     # Main script
│   └── examples/                     # Usage examples
├── docs/                             # Shared documentation
│   ├── getting-started.md           # Setup guide
│   ├── authentication.md            # Auth setup
│   └── troubleshooting.md           # Common issues
└── scripts/                          # Utility scripts
    ├── setup.sh                     # Environment setup
    └── test-all.sh                  # Test all tools

---

🎯 Use Cases

Project Management

• Sprint Planning: Bulk create sprint tasks and user stories
• Feature Tracking: Generate issues for roadmap items
• Bug Triage: Analyze bug resolution patterns

DevOps Workflows

• Release Planning: Create release tracking issues
• Compliance: Generate compliance requirement issues
• Reporting: Monthly team performance reports

Team Collaboration

• Onboarding: Create standardized onboarding tasks
• Documentation: Track documentation requirements
• Code Review: Analyze review patterns and performance

---

🔧 Configuration Examples

Issue Creator Templates

{
  "repository": {
    "owner": "myorg",
    "name": "myrepo"
  },
  "issue_template": {
    "title_format": "Feature: {item}",
    "body_template": "## Objective\nImplement {item} functionality..."
  },
  "labels": ["enhancement", "feature"],
  "assignees": ["team-lead"]
}

Issue Analyzer Filtering

# Team performance report
python github-issues-analyzer.py --owner myorg --repo myrepo --days 30 --format csv

# Bug analysis
python github-issues-analyzer.py --owner myorg --repo myrepo --labels "bug" --format json

# Sprint retrospective
python github-issues-analyzer.py --owner myorg --repo myrepo --since 2024-01-01 --until 2024-01-14

---

🤝 Contributing

We welcome contributions! Here's how you can help:

1. 🐛 Report Issues: Found a bug? Create an issue
2. 💡 Suggest Features: Have an idea? Start a discussion
3. 🔧 Submit PRs: Want to contribute code? Fork and submit a pull request
4. 📚 Improve Docs: Help make our documentation better

Development Setup

# Fork and clone your fork
git clone https://github.com/your-username/github-utilities.git
cd github-utilities

# Create feature branch
git checkout -b feature/your-feature

# Make changes and test
# Submit pull request

---

📚 Documentation

• Getting Started - Complete setup guide
• Authentication - GitHub token setup
• Issue Creator Guide - Detailed usage
• Issue Analyzer Guide - Analytics and reporting
• Troubleshooting - Common issues and solutions

---

🔗 Related Projects

• GitHub CLI - Official GitHub command line tool
• Hub - Command-line wrapper for git
• Octokit - Official GitHub API libraries

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

⭐ Support

If you find these tools helpful:

• ⭐ Star this repository
• 🐛 Report issues you encounter
• 💡 Suggest new features
• 🤝 Contribute to the project
• 📢 Share with your team

---

📈 Roadmap

2025 Q2

• ✅ Issue Creator
• ✅ Issue Analyzer
• 🔄 Documentation improvements
• 🔄 Enhanced examples

2025 Q3

• 🚀 PR Automation tools
• 🚀 Repository management utilities
• 🚀 Enhanced configuration options

2025 Q4

• 🚀 Branch protection utilities
• 🚀 GitHub Actions helpers
• 🚀 Advanced automation workflows

---

Transform your GitHub workflow with powerful automation tools! 🚀