Struct Agreement 

pub struct Agreement { /* private fields */ }

Both sides, and what the bridge can therefore serve.

Implementations

impl Agreement

pub fn between(downstream: Leg, upstream: Leg) -> Self

Reconciles two independently negotiated legs.

Pure and total: any two legs produce an agreement, including two that share no features at all. Refusing to build one in that case would leave the caller with nothing to report on, and “nothing in common” is exactly the situation where an operator most needs to be told.

pub const fn downstream(&self) -> &Leg

The client side of the bridge.

pub const fn upstream(&self) -> &Leg

The server side of the bridge.

pub const fn served(&self) -> FeatureProfile

What the bridge can actually serve: the intersection.

This is what gets advertised downstream. Anything else is a promise the bridge cannot keep.

pub fn withheld(&self) -> &[Withheld]

The features dropped, and which side refused each.

pub fn serves(&self, feature: Feature) -> bool

Whether feature can be served, in both directions.

pub fn same_version(&self) -> bool

Whether the two sides settled on the same revision.

Not required for a bridge — translating between revisions is its whole purpose — but a bridge answering true has nothing to translate and is usually a misconfiguration, so it is worth asking.

pub fn summary(&self) -> String

A one-line summary for a log or a --json field.

Trait Implementations

impl Clone for Agreement

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 Agreement

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

Formats the value using the given formatter.

impl Eq for Agreement

impl PartialEq for Agreement

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Agreement