Enum gix_worktree::stack::State

pub enum State {
    CreateDirectoryAndAttributesStack {
        unlink_on_collision: bool,
        validate: Options,
        attributes: Attributes,
    },
    AttributesAndIgnoreStack {
        attributes: Attributes,
        ignore: Ignore,
    },
    AttributesStack(Attributes),
    IgnoreStack(Ignore),
}

Variants

CreateDirectoryAndAttributesStack

Available on crate feature attributes only.

Useful for checkout where directories need creation, but we need to access attributes as well.

Fields

unlink_on_collision: bool

If there is a symlink or a file in our path, try to unlink it before creating the directory.

validate: Options

Options to control how newly created path components should be validated.

attributes: Attributes

State to handle attribute information

AttributesAndIgnoreStack

Available on crate feature attributes only.

Used when adding files, requiring access to both attributes and ignore information, for example during add operations.

Fields

attributes: Attributes

State to handle attribute information

ignore: Ignore

State to handle exclusion information

AttributesStack(Attributes)

Available on crate feature attributes only.

Used when only attributes are required, typically with fully virtual worktrees.

IgnoreStack(Ignore)

Used when providing worktree status information.

Implementations

impl State

Initialization

pub fn for_checkout( unlink_on_collision: bool, validate: Options, attributes: Attributes, ) -> Self

Available on crate feature attributes only.

Configure a state to be suitable for checking out files, which only needs access to attribute files read from the index.

pub fn for_add(attributes: Attributes, ignore: Ignore) -> Self

Available on crate feature attributes only.

Configure a state for adding files, with support for ignore files and attribute files.

impl State

Utilities

pub fn id_mappings_from_index( &self, index: &State, paths: &PathStorageRef, case: Case, ) -> Vec<(BString, ObjectId)>

Returns a vec of tuples of relative index paths along with the best usable blob OID for either ignore or attribute files or both. This allows files to be accessed directly from the object database without the need for a worktree checkout.

Note that this method…

• ignores entries which aren’t blobs.
• ignores ignore entries which are not skip-worktree.
• within merges, picks ‘our’ stage both for ignore and attribute files.

• index is where we look for suitable files by path in order to obtain their blob hash.
• paths is the indices storage backend for paths.
• case determines if the search for files should be case-sensitive or not.

Trait Implementations

impl Clone for State

fn clone(&self) -> State

Returns a copy of the value.

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

Performs copy-assignment from source.