How to List All Unique Authors of a Git Folder: Step-by-Step Guide for Versioned Files

Table of Contents#

1. Prerequisites
2. Understanding Git Author Tracking
3. Basic Command: List All Authors in a Git Repository
4. Filtering by a Specific Folder
5. Handling Duplicates & Case Sensitivity
6. Including Email Addresses
7. Advanced Scenarios
   • Excluding Merge Commits
   • Limiting to a Specific Branch
   • Date-Restricted Author Lists
8. Troubleshooting Common Issues
9. Quick Reference: Summary of Commands
10. References

Prerequisites#

Before starting, ensure you have the following:

• Git Installed: Verify with git --version in your terminal. If not installed, download it from git-scm.com.
• A Git Repository: You’ll need a local Git repository with versioned files (navigate to it using cd /path/to/your/repo).
• Basic Terminal Knowledge: Familiarity with running commands in Terminal (macOS/Linux) or Command Prompt/PowerShell (Windows).

Understanding Git Author Tracking#

Git records two key pieces of author information for every commit:

• Author Name: The human-readable name of the contributor (e.g., "Jane Smith").
• Author Email: The email associated with the author (e.g., "[email protected]").

These are set via Git configuration (git config --global user.name "Your Name" and git config --global user.email "[email protected]") and stored in commit metadata. When you run git log, Git displays author names/emails for each commit.

Basic Command: List All Authors in a Git Repository#

Before narrowing down to a folder, let’s start with the basics: listing all authors across the entire repository (including duplicates).

Step 1: Use git log with a Pretty Format#

The git log command displays commit history. To extract only author names, use the --pretty=format:"%an" flag, where %an is a placeholder for "Author Name."

git log --pretty=format:"%an"  

Sample Output:

Alice Johnson  
Bob Williams  
Alice Johnson  # Duplicate (Alice committed twice)  
Charlie Brown  

Step 2: Remove Duplicates with sort -u#

To get unique authors, pipe the output to sort -u (the -u flag removes duplicates):

git log --pretty=format:"%an" | sort -u  

Sample Output (unique authors):

Alice Johnson  
Bob Williams  
Charlie Brown  

Filtering by a Specific Folder#

To list authors who modified a specific folder (e.g., src/components/), restrict git log to that folder using the -- separator followed by the folder path.

Command:#

git log --pretty=format:"%an" -- path/to/your/folder | sort -u  

Explanation:#

• -- path/to/your/folder: Tells Git to only consider commits that modified files in this folder. Replace path/to/your/folder with the actual path (e.g., src/, docs/, or assets/images/).
• | sort -u: Removes duplicate authors.

Example:#

If you want authors of the src/utils/ folder:

git log --pretty=format:"%an" -- src/utils/ | sort -u  

Sample Output:

Bob Williams  
Diana Lee  

(Only Bob and Diana modified files in src/utils/.)

Handling Duplicates & Case Sensitivity#

Git treats author names as case-sensitive by default. For example, "alice johnson" and "Alice Johnson" are considered distinct. To fix this:

Case-Insensitive Unique Authors#

Add the -f flag to sort to ignore case:

git log --pretty=format:"%an" -- src/utils/ | sort -uf  

Sample Output (case-insensitive):

Alice Johnson  # Merges "alice johnson" and "Alice Johnson"  
Bob Williams  

Including Email Addresses#

To list authors with their email addresses (useful for contact or verification), replace %an with %an <%ae>, where %ae is "Author Email."

Command:#

git log --pretty=format:"%an <%ae>" -- src/utils/ | sort -u  

Sample Output:

Alice Johnson <[email protected]>  
Bob Williams <[email protected]>  

Advanced Scenarios#

Excluding Merge Commits#

Merge commits often include authors who didn’t directly modify the folder (e.g., merging a branch). Use --no-merges to exclude them:

git log --no-merges --pretty=format:"%an" -- src/utils/ | sort -u  

Limiting to a Specific Branch#

To list authors for a folder only on a specific branch (e.g., dev), specify the branch name:

git log dev --pretty=format:"%an" -- src/utils/ | sort -u  

Date-Restricted Author Lists#

Filter authors by commits in a date range (e.g., past 30 days) using --since and --until:

# Authors who modified src/utils/ in the last 30 days  
git log --since="30 days ago" --pretty=format:"%an" -- src/utils/ | sort -u  

Or a specific date range:

git log --since="2023-01-01" --until="2023-06-30" --pretty=format:"%an" -- src/utils/ | sort -u  

Troubleshooting Common Issues#

"fatal: not a git repository"#

Issue: You’re not in a Git repository.
Fix: Navigate to your repo first: cd /path/to/your/repo.

No Output (Empty List)#

Issue: The folder has no commits (e.g., it was added but never modified).
Fix: Verify the folder path exists and has versioned files.

"error: pathspec 'folder' did not match any file(s) known to git"#

Issue: The folder path is incorrect.
Fix: Use ls (macOS/Linux) or dir (Windows) to check the folder name/path.

Quick Reference: Summary of Commands#

References#

• Git Documentation: git log
• Git Pretty Formats (for %an, %ae, etc.)
• GNU sort Command

By following these steps, you can efficiently list unique authors for any folder in your Git repository, empowering better collaboration and project tracking. Let us know in the comments if you encountered other scenarios! 🚀