Read this in 中文 (Chinese).

This Python program analyzes a GitHub user's repositories to collect comprehensive statistics on:

• 📈 Total additions and deletions across all repositories (including forks, but only counting user's own contributions)
• 🔤 Lines of code per programming language
• 📚 Detailed repository information

View the latest analysis results in the stats branch.

• Comprehensive Analysis: Collects detailed statistics on code contributions
• Language Breakdown: Shows distribution of code across programming languages
• Smart Fork Analysis: Analyzes all repositories including forks, but only counts user's own contributions
• Parallel Processing: Efficiently processes multiple repositories concurrently
• Rich Output: Beautiful console output with tables and colors
• Detailed Logging: Comprehensive logging for debugging
• Access Levels: Supports both basic (no token) and full (with token) access modes
• Flexible Token Configuration: Support for multiple ways to provide GitHub token

• Python 3.8+
• GitHub Personal Access Token (optional, for full access)

pip install github-stats-analyzer

1. Clone this repository:

git clone https://github.com/SakuraPuare/github-stats-analyzer.git
cd github-stats-analyzer

1. Install the required dependencies:

pip install -r requirements.txt

You can provide your GitHub Personal Access Token in several ways:

1. Command Line Argument:

github-stats <username> --token your_token_here

1. Environment Variable:

export GITHUB_TOKEN=your_token_here
github-stats <username>

1. .env File (optional): Create a .env file in your working directory:

GITHUB_TOKEN=your_personal_access_token_here

1. Go to your GitHub account settings
2. Select "Developer settings" from the sidebar
3. Click on "Personal access tokens" and then "Tokens (classic)"
4. Click "Generate new token" and select "Generate new token (classic)"
5. Give your token a descriptive name
6. Select the following scopes: repo, read:user
7. Click "Generate token"
8. Copy the token and use one of the methods above to provide it

After installation, you can use the tool in three ways:

1. Using the installed command:

github-stats <github_username>

1. Using Python's -m flag:

python -m github_stats_analyzer <github_username>

1. From source:

python main.py <github_username>

The program supports the following command line options:

github-stats <github_username> [--debug] [--include-all] [--access-level {basic|full}] [--token TOKEN]

• --debug: Enable debug output for more detailed logging
• --include-all: Include all languages in statistics (don't exclude any)
• --access-level: Choose access level (basic or full)
  • basic: Limited data without token (default)
  • full: Full data with token
• --token: GitHub Personal Access Token (can also be set via GITHUB_TOKEN environment variable)

The program supports two access levels:

• Limited to public repositories only
• Maximum 30 repositories analyzed
• Maximum 30 commits per repository
• Basic statistics only
• No private repository access
• No fork analysis
• No detailed repository information
• Rate limit: 60 requests per hour

• Access to all repositories (public and private)
• No limit on number of repositories
• No limit on number of commits
• Complete statistics
• Private repository access
• Fork analysis
• Detailed repository information
• Rate limit: 5000 requests per hour

You can also use the package as a library in your Python code:

import asyncio
from github_stats_analyzer import GitHubStatsAnalyzer, AccessLevel

async def analyze_user(username: str, access_level: str = AccessLevel.BASIC):
    analyzer = GitHubStatsAnalyzer(username, access_level=access_level)
    await analyzer.analyze()
    analyzer.print_results()

# Run the analysis
asyncio.run(analyze_user("octocat", AccessLevel.FULL))

The project is organized into several modules:

The program will display:

• Total additions and deletions across all repositories
• Language statistics sorted by lines of code
• List of repositories with star count and creation date (in full access mode)

• The program analyzes all repositories including forks, but only counts the user's own contributions
• GitHub API has rate limits, so analyzing users with many repositories might take time
• Lines of code are estimated based on byte count (approximation)
• Some languages are excluded by default to avoid skewing statistics (use --include-all to include them)
• Log files are stored in the log directory
• Basic access mode is suitable for quick analysis of public repositories
• Full access mode requires a GitHub token but provides complete statistics
• Token can be provided via command line, environment variable, or .env file

Contributions are welcome! Please feel free to submit a Pull Request.

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

Generated with ❤️ by Cursor