Struct ElectionConfig 

pub struct ElectionConfig {
    pub lease_duration: Duration,
    pub heartbeat_interval: Duration,
    pub candidate_timeout: Duration,
    pub election_enabled: bool,
    pub allow_preemption: bool,
}

Global configuration for the leader election system

Controls the behavior of the election system including lease duration, timeouts, and preemption policy.

Fields

lease_duration: Duration

How long a leadership lease lasts

Leader must refresh before this expires to maintain leadership. Longer values reduce election traffic but slow failover.

heartbeat_interval: Duration

Recommended heartbeat interval

Candidates and leaders should send heartbeats at this interval. Typically lease_duration / 3 to ensure timely refresh.

candidate_timeout: Duration

How long before a candidate is considered dead

Candidates that haven’t sent a heartbeat within this duration may be evicted from the candidate list.

election_enabled: bool

Master switch to enable/disable elections

When disabled:

• No new leaders can be elected
• Existing leader remains until lease expires
• Registration and heartbeats return errors

allow_preemption: bool

Whether higher priority processes can preempt current leader

If true, a candidate with higher priority can take over leadership even if the current leader’s lease is valid. If false, must wait for lease to expire.

Implementations

impl ElectionConfig

pub fn with_lease_duration(lease_duration: Duration) -> Self

Create a new ElectionConfig with custom lease duration

Other values are derived from the lease duration:

• heartbeat_interval = lease_duration / 3
• candidate_timeout = lease_duration * 1.5

Trait Implementations

impl Clone for ElectionConfig

fn clone(&self) -> ElectionConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ElectionConfig

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

Formats the value using the given formatter.

impl Default for ElectionConfig

fn default() -> Self

Creates default configuration with sensible production values

• 10 second lease duration
• 3 second heartbeat interval
• 15 second candidate timeout
• Elections enabled
• Preemption enabled