Git-Pandas is a powerful Python library that transforms Git repository data into pandas DataFrames, making it easy to analyze and visualize your codebase's history, contributors, and development patterns. Built on top of GitPython, it provides a simple yet powerful interface for extracting meaningful insights from your Git repositories.

• Easy to Use: Simple API that converts Git data into familiar pandas DataFrames
• Comprehensive Analysis: From basic commit history to complex metrics like bus factor
• Flexible: Works with single repositories or entire project directories
• Visualization Ready: Built-in plotting utilities for common Git analytics
• Performance Optimized: Optional caching support for memory-intensive operations

The Repository class provides a wrapper around a single Git repository, offering methods to:

• Extract commit history with filtering by extension and directory
• Analyze file changes and blame information
• Track branch and tag information
• Generate cumulative blame statistics
• Calculate file ownership and contribution patterns

The ProjectDirectory class enables analysis across multiple repositories:

• Automatically discovers and analyzes nested Git repositories
• Aggregates metrics across multiple repositories
• Provides project-level insights and statistics
• Calculates cross-repository metrics like total development time

• Commit History: Track changes with extension and directory filtering
• File Analysis: Monitor edited files and blame information
• Branch & Tag Management: Access repository structure information
• Cumulative Blame: Generate time-series data of code ownership
• File Ownership: Approximate file ownership and contribution patterns

• Bus Factor: Calculate project sustainability metrics
• Development Time: Estimate hours spent per project or author

• Profile Analysis: Analyze GitHub.com profiles via GitHubProfile object
• Repository Metrics: Extract repository-specific insights
• Contributor Insights: Track external contributions and collaborations

• Plotting Helpers: Built-in utilities for common Git analytics
• Punchcard Analysis: Generate and visualize commit patterns
• Blame Visualization: Create cumulative blame charts
• Time Series Analysis: Track changes and patterns over time

Git-Pandas supports Python 2.7+ and 3.3+. Install using pip:

pip install git-pandas

from gitpandas import Repository

# Analyze a single repository
repo = Repository('/path/to/repo')

# Get commit history with filtering
commits_df = repo.commit_history(
    branch='main',
    ignore_globs=['*.pyc'],
    include_globs=['*.py']
)

# Analyze blame information
blame_df = repo.blame(by='repository')

# Calculate bus factor
bus_factor_df = repo.bus_factor()

# Analyze multiple repositories
from gitpandas import ProjectDirectory
project = ProjectDirectory('/path/to/project')

# Core Analysis
repo.commit_history(branch=None, limit=None, days=None, ignore_globs=None, include_globs=None)
repo.file_change_history(branch=None, limit=None, days=None, ignore_globs=None, include_globs=None)
repo.blame(rev="HEAD", committer=True, by="repository", ignore_globs=None, include_globs=None)
repo.bus_factor(by="repository", ignore_globs=None, include_globs=None)
repo.punchcard(branch=None, limit=None, days=None, by=None, normalize=None, ignore_globs=None, include_globs=None)

# Repository Information
repo.list_files(rev="HEAD")
repo.has_branch(branch)
repo.is_bare()
repo.has_coverage()
repo.coverage()
repo.get_commit_content(rev, ignore_globs=None, include_globs=None)

# Initialize with multiple repositories
project = ProjectDirectory(
    working_dir='/path/to/project',
    ignore_repos=None,
    verbose=True,
    cache_backend=None,
    default_branch='main'
)

Most analysis methods support these filtering parameters:

• branch: Branch to analyze (defaults to repository's default branch)
• limit: Maximum number of commits to analyze
• days: Limit analysis to last N days
• ignore_globs: List of glob patterns for files to ignore
• include_globs: List of glob patterns for files to include
• by: How to group results (usually 'repository' or 'file')

We welcome contributions! Please review our Contributing Guidelines for details on:

• Code of Conduct
• Development Setup
• Pull Request Process
• Starter Issues

This project is BSD licensed (see LICENSE.md)