Struct gix_diff::blob::Platform

source ·
pub struct Platform {
    pub options: Options,
    pub filter: Pipeline,
    pub attr_stack: Stack,
    /* private fields */
}
Available on crate feature blob only.
Expand description

A utility for performing a diff of two blobs, including flexible conversions, conversion-caching acquisition of diff information. Note that this instance will not call external filters as their output can’t be known programmatically, but it allows to prepare their input if the caller wishes to perform this task.

Optimized for NxM lookups with built-in caching.

Fields§

§options: Options

Options to alter how diffs should be performed.

§filter: Pipeline

A way to convert objects into a diff-able format.

§attr_stack: Stack

A way to access .gitattributes

Implementations§

source§

impl Platform

Lifecycle

source

pub fn new( options: Options, filter: Pipeline, filter_mode: Mode, attr_stack: Stack, ) -> Self

Create a new instance with options, and a way to filter data from the object database to data that is diff-able. filter_mode decides how to do that specifically. Use attr_stack to access attributes pertaining worktree filters and diff settings.

source§

impl Platform

Conversions

source

pub fn set_resource( &mut self, id: ObjectId, mode: EntryKind, rela_path: &BStr, kind: ResourceKind, objects: &impl FindObjectOrHeader, ) -> Result<(), Error>

Store enough information about a resource to eventually diff it, where…

  • id is the hash of the resource. If it is null, it should either be a resource in the worktree, or it’s considered a non-existing, deleted object. If an id is known, as the hash of the object as (would) be stored in git, then it should be provided for completeness.
  • mode is the kind of object (only blobs and links are allowed)
  • rela_path is the relative path as seen from the (work)tree root.
  • kind identifies the side of the diff this resource will be used for. A diff needs both OldOrSource and NewOrDestination.
  • objects provides access to the object database in case the resource can’t be read from a worktree.

Note that it’s assumed that either id + mode ( or rela_path can serve as unique identifier for the resource, depending on whether or not a worktree root is set for the resource of kind, with resources with worktree roots using the rela_path as unique identifier.

§Important

If an error occurs, the previous resource of kind will be cleared, preventing further diffs unless another attempt succeeds.

source

pub fn prepare_diff_command( &self, diff_command: BString, context: Context, count: usize, total: usize, ) -> Result<Command, Error>

Given diff_command and context, typically obtained from git-configuration, and the currently set diff-resources, prepare the invocation and temporary files needed to launch it according to protocol. count / total are used for progress indication passed as environment variables GIT_DIFF_PATH_(COUNTER|TOTAL) respectively (0-based), so the first path has count=0 and total=1 (assuming there is only one path). Returns None if at least one resource is unset, see set_resource().

Please note that this is an expensive operation this will always create up to two temporary files to hold the data for the old and new resources.

§Deviation

If one of the resources is binary, the operation reports an error as such resources don’t make their data available which is required for the external diff to run.

source

pub fn resource(&self, kind: ResourceKind) -> Option<Resource<'_>>

Returns the resource of the given kind if it was set.

source

pub fn resources(&self) -> Option<(Resource<'_>, Resource<'_>)>

Obtain the two resources that were previously set as (OldOrSource, NewOrDestination), if both are set and available.

This is useful if one wishes to manually prepare the diff, maybe for invoking external programs, instead of relying on Self::prepare_diff().

source

pub fn prepare_diff(&mut self) -> Result<Outcome<'_>, Error>

Prepare a diff operation on the previously set old and new resources.

The returned outcome allows to easily perform diff operations, based on the prepare_diff::Outcome::operation field, which hints at what should be done.

source

pub fn clear_resource_cache(&mut self)

Every call to set_resource() will keep the diffable data in memory, and that will never be cleared.

Use this method to clear the cache, releasing memory. Note that this will also loose all information about resources which means diffs would fail unless the resources are set again.

Note that this also has to be called if the same resource is going to be diffed in different states, i.e. using different ids, but the same rela_path.

Trait Implementations§

source§

impl Clone for Platform

source§

fn clone(&self) -> Platform

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> CloneToUninit for T
where T: Clone,

source§

default unsafe fn clone_to_uninit(&self, dst: *mut T)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dst. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.