Struct PromisorHandshake 

pub struct PromisorHandshake {
    pub decision: PromisorDecision,
    pub stored: Vec<StoredPromisorField>,
    pub resolved_filter: Option<ObjectFilterSpec>,
    pub warnings: Vec<PromisorConfigWarning>,
}

What the promisor-remote exchange decided for one fetch.

Built by the fetch driver when the server advertises promisor remotes and returned in FetchOutcome::promisor.

Fields

decision: PromisorDecision

The verdict on every advertised remote.

stored: Vec<StoredPromisorField>

Fields written into local config (promisor.storeFields).

resolved_filter: Option<ObjectFilterSpec>

The filter chosen from the accepted remotes, when the fetch asked for one automatically (FetchOptions::auto_filter).

warnings: Vec<PromisorConfigWarning>

Config values that were ignored, advertised values that were not stored, and advertised filters too complex to use as the automatic filter.

Implementations

impl PromisorHandshake

pub fn evaluate( cfg: &ConfigSet, advertisement: &PromisorAdvertisement, partial_fetch: bool, auto_filter: bool, ) -> Self

Decide the client side of the exchange.

Reads the client’s policy from cfg, decides against its configured promisor remotes, and declines everything with PromisorRejection::NotPartialFetch unless partial_fetch: a client that is not doing a partial fetch needs every object from this server. With auto_filter, also picks the filter for the fetch from the accepted remotes (PromisorDecision::combined_filter). Writes nothing; see Self::store_fields.

Parameters

• cfg: the client’s merged config.
• advertisement: what the server advertised.
• partial_fetch: whether the fetch is filtered or is from a promisor remote.
• auto_filter: whether to resolve the filter from the accepted remotes.

pub fn store_fields(&mut self, git_dir: &Path, cfg: &ConfigSet) -> Result<()>

Write promisor.storeFields values of the accepted remotes into git_dir’s config (see store_advertised_fields), recording what was written in Self::stored.

Parameters

• git_dir: the repository being fetched into.
• cfg: the client’s merged config, loaded before the fetch.

Errors

Returns Error when the local config file cannot be read or written.

Trait Implementations

impl Clone for PromisorHandshake

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 PromisorHandshake

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

Formats the value using the given formatter.

impl Default for PromisorHandshake

fn default() -> Self

Returns the “default value” for a type.

impl Eq for PromisorHandshake

impl PartialEq for PromisorHandshake

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for PromisorHandshake