philiprehberger-git-analyzer 0.2.0

Git repository statistics and commit analysis

philiprehberger-git-analyzer

Git repository statistics and commit analysis.

Installation

pip install philiprehberger-git-analyzer

Usage

from philiprehberger_git_analyzer import analyze

report = analyze(".")

print(f"Total commits: {report.total_commits}")
print(f"Contributors: {report.contributor_count}")
print(f"Most active file: {report.most_changed_file}")
print(f"Commits/week: {report.commits_per_week}")

# Per-author stats
for author in report.authors:
    print(f"{author.name}: {author.commits} commits")

# File hotspots (most changed files)
for file in report.hotspots(limit=10):
    print(f"{file.path}: {file.change_count} changes")

# Language breakdown
for ext, count in report.file_extensions.items():
    print(f"{ext}: {count} files")

# Activity patterns
print(report.commits_by_hour)      # {9: 42, 10: 38, ...}
print(report.commits_by_weekday)   # {0: 120, 1: 115, ...} (0=Mon)
print(report.activity_heatmap())   # {weekday: {hour: count}}

Top authors and hotspots

from philiprehberger_git_analyzer import analyze

report = analyze(".")

# Top 5 most active contributors
for author in report.top_authors(5):
    print(f"{author.name}: {author.commits} commits")

# Top 5 most frequently changed files
for file in report.top_hotspots(5):
    print(f"{file.path}: {file.change_count} changes")

API

analyze(repo_path, branch?, max_commits?) -> RepoReport

Field	Description
total_commits	Total number of commits
contributor_count	Number of unique authors
first_commit_date	Date of earliest commit
last_commit_date	Date of latest commit
commits_per_week	Average commits per week
most_changed_file	File with most changes
authors	List of AuthorStats
file_extensions	Extension → file count
commits_by_day	Date → commit count
commits_by_hour	Hour → commit count
commits_by_weekday	Weekday → commit count
hotspots(limit)	Most frequently changed files
activity_heatmap()	Weekday × hour activity matrix
top_authors(n=10)	Top N authors by commit count, descending
top_hotspots(n=10)	Top N files by change frequency, descending

Development

pip install -e .
python -m pytest tests/ -v

Support

If you find this project useful:

⭐ Star the repo

🐛 Report issues

💡 Suggest features

❤️ Sponsor development

🌐 All Open Source Projects

💻 GitHub Profile

🔗 LinkedIn Profile

License

MIT