Struct git2::DiffFindOptions

pub struct DiffFindOptions {
    // some fields omitted
}

Control behavior of rename and copy detection

Methods

impl DiffFindOptions

fn new() -> DiffFindOptions

Creates a new set of empty diff find options.

All flags and other options are defaulted to false or their otherwise zero equivalents.

fn by_config(&mut self) -> &mut DiffFindOptions

Reset all flags back to their unset state, indicating that diff.renames should be used instead. This is overridden once any flag is set.

fn renames(&mut self, find: bool) -> &mut DiffFindOptions

Look for renames?

fn renames_from_rewrites(&mut self, find: bool) -> &mut DiffFindOptions

Consider old side of modified for renames?

fn copies(&mut self, find: bool) -> &mut DiffFindOptions

Look for copies?

fn copies_from_unmodified(&mut self, find: bool) -> &mut DiffFindOptions

Consider unmodified as copy sources?

For this to work correctly, use include_unmodified when the initial diff is being generated.

fn rewrites(&mut self, find: bool) -> &mut DiffFindOptions

Mark significant rewrites for split.

fn break_rewries(&mut self, find: bool) -> &mut DiffFindOptions

Actually split large rewrites into delete/add pairs

fn for_untracked(&mut self, find: bool) -> &mut DiffFindOptions

Find renames/copies for untracked items in working directory.

For this to work correctly use the include_untracked option when the initial diff is being generated.

fn all(&mut self, find: bool) -> &mut DiffFindOptions

Turn on all finding features.

fn ignore_leading_whitespace(&mut self, ignore: bool) -> &mut DiffFindOptions

Measure similarity ignoring leading whitespace (default)

fn ignore_whitespace(&mut self, ignore: bool) -> &mut DiffFindOptions

Measure similarity ignoring all whitespace

fn dont_ignore_whitespace(&mut self, dont: bool) -> &mut DiffFindOptions

Measure similarity including all data

fn exact_match_only(&mut self, exact: bool) -> &mut DiffFindOptions

Measure similarity only by comparing SHAs (fast and cheap)

fn break_rewrites_for_renames_only(&mut self, b: bool) -> &mut DiffFindOptions

Do not break rewrites unless they contribute to a rename.

Normally, break_rewrites and rewrites will measure the self-similarity of modified files and split the ones that have changed a lot into a delete/add pair. Then the sides of that pair will be considered candidates for rename and copy detection

If you add this flag in and the split pair is not used for an actual rename or copy, then the modified record will be restored to a regular modified record instead of being split.

fn remove_unmodified(&mut self, remove: bool) -> &mut DiffFindOptions

Remove any unmodified deltas after find_similar is done.

Using copies_from_unmodified to emulate the --find-copies-harder behavior requires building a diff with the include_unmodified flag. If you do not want unmodified records in the final result, pas this flag to have them removed.

fn rename_threshold(&mut self, thresh: u16) -> &mut DiffFindOptions

Similarity to consider a file renamed (default 50)

fn rename_from_rewrite_threshold(&mut self, thresh: u16) -> &mut DiffFindOptions

Similarity of modified to be glegible rename source (default 50)

fn copy_threshold(&mut self, thresh: u16) -> &mut DiffFindOptions

Similarity to consider a file copy (default 50)

fn break_rewrite_threshold(&mut self, thresh: u16) -> &mut DiffFindOptions

Similarity to split modify into delete/add pair (default 60)

fn rename_limit(&mut self, limit: usize) -> &mut DiffFindOptions

Maximum similarity sources to examine for a file (somewhat like git-diff's -l option or diff.renameLimit config)

Defaults to 200