Enum CandidateRequest 

pub enum CandidateRequest {
    Add(Vec<OsString>),
    Direct(Vec<OsString>),
    Staged(Vec<OsString>),
    StagedAtBase {
        base: Option<ObjectId>,
        pathspecs: Vec<OsString>,
    },
    Pushed(PushedScope),
    Landed(ObjectId),
}

What: What a lifecycle asks for. An enum is a closed set of named alternatives; each carries the arguments it needs. #[derive(...)] generates cloning, debug printing and ==. Why: The two sources differ only in what is staged on the private copy and in which entries become candidates.

In TS you’d write (pseudocode):

type CandidateRequest = { kind: 'add'; region: string[] } | { kind: 'direct'; pathspecs: string[] };

Variants

Add(Vec<OsString>)

What git add with these arguments would stage.

Tuple Fields

0: Vec<OsString>

The arguments after add, wrapper controls removed.

Direct(Vec<OsString>)

The worktree files a direct command selects.

Tuple Fields

0: Vec<OsString>

The pathspecs of the scope; --all is :/.

Staged(Vec<OsString>)

The entries the index already holds for the pathspecs, read without staging the worktree first. The commit path uses it, so corrections already written to the private index are the candidates.

Tuple Fields

0: Vec<OsString>

The pathspecs of the scope.

StagedAtBase

The entries the private index holds for the pathspecs, with a recorded base commit (the empty tree when the branch was unborn) as the baseline that marks additions, read without staging the worktree. The commit transaction uses it: its baseline is the base it recorded at invocation, never the HEAD another landing may have moved since. No pathspec means no candidate.

Fields

base: Option<ObjectId>

The recorded base commit, or nothing for an unborn branch.

pathspecs: Vec<OsString>

The pathspecs of the scope, each literal and rooted at the top level.

Pushed(PushedScope)

The changes a manual push publishes: each newly published commit’s own delta and the whole tree of each tip with no known published base.

Tuple Fields

0: PushedScope

The commits and trees the scan reads.

Landed(ObjectId)

The paths one landed commit changed, each against every parent, as the post-commit gate reads them: the committed bytes and no worktree or index state.

Tuple Fields

0: ObjectId

The landed commit whose tree changes are listed.

Trait Implementations

impl Clone for CandidateRequest

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CandidateRequest

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

Formats the value using the given formatter.

impl Eq for CandidateRequest

impl PartialEq for CandidateRequest

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for CandidateRequest