Struct SyncPolicy 

pub struct SyncPolicy {
    pub interval: Duration,
    pub min_interval: Duration,
    pub backoff: Backoff,
    pub offline_retry: Duration,
    pub max_throttle: Duration,
}

When a target should be synchronised.

The same engine serves a one-minute notification poll and a six-hour analytics refresh — only these numbers differ.

Fields

interval: Duration

Cadence while everything is healthy.

min_interval: Duration

Floor between two runs, however often a refresh is requested.

Protects against a user holding the refresh button and against a UI that re-syncs on every window focus.

backoff: Backoff

How to back off after failures.

offline_retry: Duration

Retry delay while the machine appears to be offline.

Short and flat rather than exponential: connectivity usually returns in one step, and backing off for half an hour would leave the app stale long after the network came back.

max_throttle: Duration

The longest a service may push this target’s next run into the future.

A service-reported throttle (quota reset, X-Poll-Interval) is honoured up to this bound. Without it, a buggy or hostile response could freeze a target indefinitely; past the bound the delay is clamped and a warning is logged.

Implementations

impl SyncPolicy

pub fn every(interval: Duration) -> Self

A policy that runs every interval.

pub fn with_min_interval(self, min_interval: Duration) -> Self

pub fn with_backoff(self, backoff: Backoff) -> Self

pub fn with_offline_retry(self, offline_retry: Duration) -> Self

pub fn with_max_throttle(self, max_throttle: Duration) -> Self

Trait Implementations

impl Clone for SyncPolicy

fn clone(&self) -> SyncPolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for SyncPolicy

impl Debug for SyncPolicy

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

Formats the value using the given formatter.

impl Default for SyncPolicy

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for SyncPolicy

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for SyncPolicy