pub enum Event<'a, 'old, 'new> {
Addition {
entry_mode: EntryMode,
id: Id<'new>,
},
Deletion {
entry_mode: EntryMode,
id: Id<'old>,
},
Modification {
previous_entry_mode: EntryMode,
previous_id: Id<'old>,
entry_mode: EntryMode,
id: Id<'new>,
},
Rewrite {
source_location: &'a BStr,
source_entry_mode: EntryMode,
source_id: Id<'old>,
diff: Option<DiffLineStats>,
entry_mode: EntryMode,
id: Id<'new>,
copy: bool,
},
}
blob-diff
only.Expand description
An event emitted when finding differences between two trees.
Variants§
Addition
Fields
An entry was added, like the addition of a file or directory.
Deletion
Fields
An entry was deleted, like the deletion of a file or directory.
Modification
Fields
An entry was modified, e.g. changing the contents of a file adjusts its object id and turning a file into a symbolic link adjusts its mode.
Rewrite
Fields
source_location: &'a BStr
The location of the source of the rename operation.
It may be empty if neither file names nor file paths are tracked.
source_id: Id<'old>
The object id of the entry before the rename.
Note that this is the same as id
if we require the similarity to be 100%, but may
be different otherwise.
diff: Option<DiffLineStats>
Information about the diff we performed to detect similarity and match the source_id
with the current state at id
.
It’s None
if source_id
is equal to id
, as identity made an actual diff computation unnecessary.
Entries are considered rewritten if they are not trees and they, according to some understanding of identity, were renamed
or copied.
In case of renames, this means they originally appeared as Deletion
signalling their source as well as an
Addition
acting as destination.
In case of copies, the copy
flag is true and typically represents a perfect copy of a source was made.
This variant can only be encountered if rewrite tracking is enabled.
Note that mode changes may have occurred as well, i.e. changes from executable to non-executable or vice-versa.
Implementations§
source§impl<'a, 'old, 'new> Event<'a, 'old, 'new>
impl<'a, 'old, 'new> Event<'a, 'old, 'new>
sourcepub fn diff(&self) -> Option<Result<Platform<'old, 'new>, Error>>
pub fn diff(&self) -> Option<Result<Platform<'old, 'new>, Error>>
Produce a platform for performing a line-diff, or None
if this is not a Modification
or one of the entries to compare is not a blob.
sourcepub fn entry_mode(&self) -> EntryMode
pub fn entry_mode(&self) -> EntryMode
Return the current mode of this instance.