GitHub Organization Statistics Tool

A comprehensive, open-source tool for analyzing GitHub organization statistics including repository metrics, contributor activity, code quality insights, and multi-organization support with GitHub Apps.

🚀 Features

• Repository Analysis: Comprehensive metrics including stars, forks, issues, languages, and activity
• Contributor Insights: Detailed contributor analysis with bot filtering capabilities
• Code Quality Metrics: Language statistics, dependency analysis, and security insights
• Multi-Organization Support: GitHub App authentication for analyzing multiple organizations
• Flexible Output: JSON, CSV, and Excel formats with rich formatting
• Advanced Filtering: Include/exclude forks, archived repos, empty repos, and bot accounts
• Rate Limit Management: Intelligent rate limiting and retry mechanisms
• Error Handling: Robust error handling with detailed logging and recovery

📦 Installation

Prerequisites

• Python 3.7 or higher
• pip package manager

Install Dependencies

pip install -r requirements.txt

Quick Install

git clone https://github.com/zoharbabin/github-org-stats.git
cd github-org-stats
pip install -r requirements.txt

🔧 Quick Start

Basic Usage

Analyze a GitHub organization with a personal access token:

python github_org_stats.py --org your-org --token ghp_your_token_here

GitHub App Authentication

For enterprise use and higher rate limits:

python github_org_stats.py \
  --org your-org \
  --app-id 12345 \
  --private-key /path/to/private-key.pem \
  --installation-id 67890

Advanced Usage

# Generate all output formats with bot filtering
python github_org_stats.py \
  --org your-org \
  --token ghp_token \
  --format all \
  --exclude-bots \
  --days-back 90 \
  --output-dir ./reports

📊 Output Formats

Excel Output (Default)

• Repository_Data: Complete repository information
• Summary: High-level organization statistics
• Contributors: Top contributors analysis
• Languages: Language distribution
• Errors: Error tracking information

JSON Output

Structured JSON with complete data hierarchy for programmatic access.

CSV Output

Flattened data suitable for spreadsheet analysis and data processing tools.

🔐 Authentication

Personal Access Token

For individual use or small-scale analysis:

• Required permissions: repo, read:org, read:user

GitHub App

For enterprise use and multi-organization analysis:

• Higher rate limits
• Better security
• Multi-organization support

See docs/USAGE.md for detailed authentication setup.

📖 Documentation

• Usage Guide - Comprehensive usage documentation
• Migration Guide - Migration from other tools
• Development Guide - Contributing and development setup

🧪 Testing

Run the test suite:

cd tests
python test_github_org_stats.py

Run specific test categories:

python test_github_org_stats.py --category auth
python test_github_org_stats.py --category data

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

Development Setup

1. Fork the repository
2. Create a feature branch
3. Install development dependencies: pip install -r requirements-dev.txt
4. Make your changes
5. Run tests: python -m pytest tests/
6. Submit a pull request

📄 License

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

🆘 Support

• Documentation: Check our comprehensive usage guide
• Issues: Report bugs or request features via GitHub Issues
• Discussions: Join the conversation in GitHub Discussions

🌟 Star History

🙏 Acknowledgments

• Thanks to all contributors who have helped improve this tool
• Built with PyGithub for GitHub API access
• Inspired by the need for comprehensive GitHub organization analysis

Made with ❤️ by the open-source community