How to filter by commit content?

Filtering commits by their content in Git can be done using the git log command along with specific options. Here are several methods to filter commits based on the content of the changes made in those commits:

1. Using --grep to Filter by Commit Message

If you want to filter commits based on keywords in the commit messages, you can use the --grep option:

git log --grep="keyword"

This command will display all commits that contain "keyword" in their commit messages.

2. Using -S to Search for Added or Removed Content

To find commits that add or remove a specific string in the content of files, use the -S option:

git log -S"string"

This command will show commits that introduced or removed the specified string in the code.

3. Using -G to Search for Changes Matching a Regular Expression

If you want to filter commits based on changes that match a regular expression, use the -G option:

git log -G"regex"

This command will display commits that added or removed lines matching the specified regular expression.

4. Combining with Other Options

You can combine these options with others to refine your search. For example, to find commits that added a specific string and also limit the output to a specific file, you can do:

git log -S"string" -- path/to/file.txt

5. Using --patch to Show Changes

If you want to see the actual changes made in the commits that match your filters, you can add the -p option:

git log -S"string" -p

This will show the diffs for each commit that added or removed the specified string.

Example Workflow

Here’s a typical workflow for filtering commits by content:

1. Find commits that added a specific string:

   git log -S"TODO"

2. Find commits that changed lines matching a regex:

   git log -G"fix.*bug"

3. View the changes in commits that modified a specific file:

   git log -S"string" -- path/to/file.txt -p

Conclusion

Filtering commits by content is a powerful way to track changes and understand the evolution of your codebase. By using the -S and -G options, you can pinpoint specific changes and gain insights into your project's history. If you have more questions or need further examples, feel free to ask!