Module diff 

Diff machinery — compare trees, index entries, and working tree files.

Overview

This module provides the core diffing infrastructure shared by diff, diff-index, status, log, show, commit, and merge.

Levels of comparison

1. Tree-to-tree — compare two tree objects (e.g. for log/show).
2. Tree-to-index — compare a tree (usually HEAD) against the index (staged changes, used by diff --cached and status).
3. Index-to-worktree — compare index against the working directory (unstaged changes, used by diff and status).

Content diff

Line-level diffing uses the Myers algorithm via the similar crate. Output formats: unified patch, raw (:old-mode new-mode ...), stat, numstat.

Structs

DiffEntry

A single diff entry representing one changed path.

Enums

DiffStatus

The kind of change between two sides of a diff.

Constants

ZERO_OID

The zero (null) object ID used for “no object” in diff output.

Functions

count_changes

Count insertions and deletions between two strings.

detect_copies

Detect copies among diff entries.

detect_renames

Detect renames by pairing Deleted and Added entries with similar content.

diff_index_to_tree

Compare the index against a tree (usually HEAD’s tree).

diff_index_to_worktree

Compare the index against the working tree.

diff_tree_to_worktree

Compare a tree against the working tree.

diff_trees

Compare two trees and return the list of changed entries.

format_raw

Format a diff entry in Git’s raw diff format.

format_raw_abbrev

Format a diff entry with abbreviated OIDs.

format_rename_path

Format a rename pair using Git’s compact path format.

format_stat_line

Generate diff stat output (file name + insertions/deletions).

stat_matches

Quick stat check: does the index entry’s cached stat data match the file?

unified_diff

Generate a unified diff patch for two blobs.

zero_oid

Return the zero ObjectId.