Struct SyncState 

pub struct SyncState {
    pub last_attempt: Option<OffsetDateTime>,
    pub last_success: Option<OffsetDateTime>,
    pub last_outcome: Option<SyncOutcome>,
    pub etag: Option<String>,
    pub last_modified: Option<String>,
    pub failure_streak: u32,
    pub not_before: Option<OffsetDateTime>,
    pub throttle_reason: Option<ThrottleReason>,
}

Fields

last_attempt: Option<OffsetDateTime>

last_success: Option<OffsetDateTime>

last_outcome: Option<SyncOutcome>

etag: Option<String>

Validators handed back to the service on the next request.

last_modified: Option<String>

failure_streak: u32

Consecutive failures, used for exponential backoff.

not_before: Option<OffsetDateTime>

A server-imposed floor on the next run: the next run may not start before this instant, whatever the policy cadence says. Surfaces a quota reset or a minimum poll interval and survives restart.

throttle_reason: Option<ThrottleReason>

Why the target is throttled, if it is. For logs and the status view.

Implementations

impl SyncState

pub fn record(&mut self, at: OffsetDateTime, outcome: SyncOutcome)

pub fn is_failing(&self) -> bool

pub fn throttle_until(&mut self, until: OffsetDateTime, reason: ThrottleReason)

Set a server-imposed floor on the next run.

pub fn clear_throttle(&mut self)

Clear any server-imposed floor.

Trait Implementations

impl Clone for SyncState

fn clone(&self) -> SyncState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SyncState

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

Formats the value using the given formatter.

impl Default for SyncState

fn default() -> SyncState

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SyncState

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SyncState

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.