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 less automatically 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.

Author

Artur Barseghyan <artur.barseghyan@gmail.com>