sinclairtarget/git-who
Git Who
git-who is a Git contribution analysis tool designed to identify the primary owners of files and directories by analyzing commit history and file trees. It functions as an ownership mapper and statistics generator that calculates commit volumes and line counts to determine responsibility for specific subsystems.
The tool distinguishes itself by mapping directory trees to their most active contributors and generating chronological visualizations, such as bar charts, to show how dominant author shares have shifted over time. It resolves fragmented author names and email addresses into single unique identities using Git mailmap configurations to ensure reporting accuracy.
The project provides capabilities for repository maintenance auditing, author contribution summaries, and noise reduction through the exclusion of specific commit hashes or file paths via pathspec filtering.
Features
- Code Ownership Mapping - Maps directory trees to their most active contributors to identify primary owners of specific files and subsystems.
- Commit History Analysis - Analyzes git logs and revision ranges to calculate contribution metrics based on commit frequency and authorship.
- Author Statistics Generators - Calculates commit volumes and line counts per author filtered by paths and date ranges.
- Git Identity Resolution - Resolves fragmented author names and emails into unique identities using Git mailmap configurations for accurate reporting.
- Git Repository Analysis - Analyzes Git commit logs and repository metadata to identify primary owners of specific files and directories.
- Contribution Analysis - The tool calculates the total volume of work contributed by authors sorted by lines added, files changed, or modification dates.
- Git User Identities - Consolidates fragmented author names and emails into single identities using Git mailmap configurations.
- Project Contribution Analysis - Generates a quantitative table of total contributions per author filtered by paths and commit ranges.
- Directory Distribution Maps - Visualizes how work is distributed across a project directory to identify authors dominating specific components.
- Ownership Mapping Traversers - Recursively traverses the directory structure to assign component ownership based on the highest volume of commits.
- Analysis File Filters - Implements shell-like pathspec patterns to include or exclude specific file paths from history analysis.
- Metadata-Based Analysis Filters - Refines analysis results by including or excluding specific authors, date ranges, or file patterns.
- Revision Exclusions - The tool skips specific commits during analysis by referencing a predefined list of revisions to ignore.
- Author Contribution Shares - Generates chronological bar charts showing how the proportional share of commits among dominant authors shifts over time.
- Directory Contribution Maps - Annotates a directory tree with the primary author for each path to visualize component responsibility.
- Revision Exclusions - Omits specific commit hashes from analysis based on a predefined list of ignored revisions.
- Contribution Timeline Charts - Displays a chronological timeline and bar chart showing the dominant author and their proportional share per year.
- Repository Auditing - Summarizes author activity and code volume while filtering out automated commits to perform a maintenance audit.
- Yearly Share Aggregators - Provides proportional shares of contributions grouped by year to visualize shifts in dominant authorship.
- Git管理工具 - Listed in the “Git 工具” section of the Great Open Source Project awesome list.
