Struct Leadership

pub struct Leadership { /* private fields */ }

The exact durable owner record a caller may attempt to renew before local expiry.

It is caller-local evidence, not a lease granted by a durable clock: a poll must still verify the participant, rank, and persisted duration against durable state. A later successful leader poll, including renewal by this same participant, supersedes this token’s fencing rank.

Implementations

impl Leadership

pub fn participant(&self) -> &ParticipantId

Returns the process incarnation this token identifies as owner.

A renewal attempt additionally requires this to match the participant passed to super::LeaderElection::poll.

pub fn rank(&self) -> Rank

Returns this token’s durable revision as a fencing rank.

A later successful leader poll supersedes this rank, including renewal by the same participant.

pub fn lease_duration(&self) -> Duration

Returns the lease duration persisted with this token.

It bounds local renewability from Self::last_renewed_at, not the durable owner’s lifetime.

pub fn last_renewed_at(&self) -> Duration

Returns the caller-clock time supplied at the successful poll attempt’s start.

A renewal is locally eligible only while elapsed time from this value is less than Self::lease_duration. It must be compared only with the same caller’s monotonic clock.

Trait Implementations

impl Clone for Leadership

fn clone(&self) -> Leadership

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Leadership

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

Formats the value using the given formatter.

impl PartialEq for Leadership

fn eq(&self, other: &Leadership) -> 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 Leadership

impl StructuralPartialEq for Leadership