Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

πŸ› οΈ Complete GitHub automation toolkit with issue creation, analysis & reporting tools. Bulk operations, configurable templates, CSV exports & comprehensive documentation. Perfect for DevOps workflows.

License

Notifications You must be signed in to change notification settings

CloudSecOpsAI/github-utilities

Repository files navigation

πŸ› οΈ 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.

License: MIT Python 3.7+


πŸš€ 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


πŸ”— 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! πŸš€

About

πŸ› οΈ Complete GitHub automation toolkit with issue creation, analysis & reporting tools. Bulk operations, configurable templates, CSV exports & comprehensive documentation. Perfect for DevOps workflows.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /