git-dump-diff
Git diff tool that shows a tree of changed files followed by their full content.
git-dump-diff is a verbose Git diagnostic tool. It shows a directory tree
of changed files and the full content of added or updated files.
Unlike a standard diff that shows only line changes, this tool lets you see the entire file context. It is ideal for code reviews and auditing feature branches.
Features
Visual Tree: Shows affected files in a clear directory structure.
Full Content: Displays the complete final state of new or modified files.
Binary Safe: Detects and skips binary files to keep your terminal clean.
Pager Support: Works with
lessautomatically for easy scrolling.No Dependencies: Uses only standard Python libraries.
Prerequisites
Python 3.10+
Installation
uv tool (recommended)
uv tool install git-dump-diff
pipx
pipx install git-dump-diff
Usage
Once installed, use the standard Git range syntax (base..target).
Compare branches
git dump-diff main..feature-branch
Compare commits
git dump-diff HEAD~3..HEAD
Options
--version: Show current version.--help: Show help message.
How it works
Git recognizes any executable in your PATH starting with git- as a
subcommand. This package installs a git-dump-diff entry point, making it
available as git dump-diff.
Tests
Run the tests with pytest:
pytest
Writing documentation
Keep the following hierarchy.
=====
title
=====
header
======
sub-header
----------
sub-sub-header
~~~~~~~~~~~~~~
sub-sub-sub-header
^^^^^^^^^^^^^^^^^^
sub-sub-sub-sub-header
++++++++++++++++++++++
sub-sub-sub-sub-sub-header
**************************
License
MIT
Support
For issues, visit GitHub.
Project documentation
Contents: