Struct DiffOptions 

#[non_exhaustive]
pub struct DiffOptions {
    pub context_lines: usize,
    pub inter_hunk_context: usize,
    pub algorithm: DiffAlgorithm,
    pub indent_heuristic: bool,
    pub renames: RenameDetection,
    pub filter: Option<DiffFilter>,
    pub whitespace: WhitespaceMode,
    pub word_level_inline: bool,
    pub function_context: bool,
    /* private fields */
}

Line-diff options shared by structured output, log patches, and benchmarks.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

context_lines: usize

Unchanged context lines around each change (Git -U, default 3).

inter_hunk_context: usize

--inter-hunk-context (default 0).

algorithm: DiffAlgorithm

Line diff algorithm.

indent_heuristic: bool

Apply Git’s indent heuristic when generating hunks.

renames: RenameDetection

Rename detection for tree diffs.

filter: Option<DiffFilter>

--diff-filter status selection (applied after rename detection).

whitespace: WhitespaceMode

Whitespace comparison rules for line diffs.

word_level_inline: bool

When false, skip intra-line word emphasis (line-level hunks only).

function_context: bool

Expand hunks to enclosing function boundaries (git diff -W).

Implementations

impl DiffOptions

pub fn with_context_lines(self, context_lines: usize) -> Self

Builder-style update of context lines (-U).

pub fn with_inter_hunk_context(self, inter_hunk_context: usize) -> Self

Builder-style update of inter-hunk context.

pub fn with_algorithm(self, algorithm: DiffAlgorithm) -> Self

Builder-style update of the line diff algorithm.

pub fn with_indent_heuristic(self, indent_heuristic: bool) -> Self

Builder-style update of the indent heuristic flag.

pub fn with_renames(self, renames: RenameDetection) -> Self

Builder-style update of rename detection.

pub fn with_filter(self, filter: Option<DiffFilter>) -> Self

Builder-style update of diff status filter.

pub fn rename_similarity_threshold(&self) -> Option<u32>

Similarity percent for rename detection, or None when RenameDetection::Off.

pub fn rename_threshold_u32(&self) -> u32

u32 threshold for super::apply_rename_detection_to_diff_entries and related APIs.

pub fn with_word_level_inline(self, word_level_inline: bool) -> Self

Builder-style update of word-level inline emphasis.

pub fn with_whitespace(self, whitespace: WhitespaceMode) -> Self

Builder-style update of whitespace comparison rules.

pub fn cap_word_level_inline_for_changed_files( self, changed_files: usize, ) -> Self

Turn off word-level inline when changed_files exceeds WORD_LEVEL_INLINE_MAX_CHANGED_FILES.

pub fn from_config(config: &ConfigSet) -> Self

Read diff.algorithm, diff.context, diff.interHunkContext, diff.indentHeuristic, and diff.renames from repository config.

pub fn resolve_indent_heuristic( config: &ConfigSet, cli_indent_heuristic: bool, cli_no_indent_heuristic: bool, ) -> bool

Resolve indent heuristic with optional CLI overrides (log/diff plumbing).

Trait Implementations

impl Clone for DiffOptions

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DiffOptions

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for DiffOptions

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for DiffOptions

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.