Struct Driver

pub struct Driver {
    pub name: BString,
    pub command: Option<BString>,
    pub algorithm: Option<Algorithm>,
    pub binary_to_text_command: Option<BString>,
    pub is_binary: Option<bool>,
}

Available on crate feature blob only.

A set of values to define how to diff something that is associated with it using git-attributes, relevant for regular files.

Some values are related to diffing, some are related to conversions.

Fields

name: BString

The name of the driver, as referred to by [diff "name"] in the git configuration.

command: Option<BString>

The command to execute to perform the diff entirely like <command> old-file old-hex old-mode new-file new-hex new-mode.

Please note that we don’t make this call ourselves, but use it to determine that we should not run the our standard built-in algorithm but bail instead as the output of such a program isn’t standardized.

algorithm: Option<Algorithm>

The per-driver algorithm to use.

binary_to_text_command: Option<BString>

The external filter program to call like <binary_to_text_command> /path/to/blob which outputs a textual version of the provided binary file. Note that it’s invoked with a shell if arguments are given. Further, if present, it will always be executed, whether is_binary is set or not.

is_binary: Option<bool>

Some(true) if this driver deals with binary files, which means that a binary_to_text_command should be used to convert binary into a textual representation. Without such a command, anything that is considered binary is not diffed, but only the size of its data is made available. If Some(false), it won’t be considered binary, and the its data will not be sampled for the null-byte either. Leaving it to None means binary detection is automatic, and is based on the presence of the 0 byte in the first 8kB of the buffer.

Implementations

impl Driver

pub fn prepare_binary_to_text_cmd(&self, path: &Path) -> Option<Command>

Produce an invocable command pre-configured to produce the filtered output on stdout after reading path.

Trait Implementations

impl Clone for Driver

fn clone(&self) -> Driver

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Driver

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

Formats the value using the given formatter.

impl Default for Driver

fn default() -> Driver

Returns the “default value” for a type.

impl PartialEq for Driver

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Driver

impl StructuralPartialEq for Driver