Enum RateLimitBehavior 

pub enum RateLimitBehavior {
    BlockAndRetry,
    ReturnError,
}

How the client should react when a rate limit is detected.

This controls what happens after detection; detection itself (status codes, response-body patterns) is configured via RateLimitConfig and always broadcasts ClientEvent::RateLimited and updates the shared RateLimitState regardless of the behavior selected here.

Queue-building usage

RateLimitBehavior::ReturnError is intended for callers that maintain their own work queue: instead of the client sleeping internally, operations fail fast with LastFmError::RateLimit. The caller can then watch SharedEventBroadcaster::watch_rate_limit_state (or the client’s watch_rate_limit_state()) for the “paused until T” estimate and schedule retries itself. See LastFmEditClientImpl::non_blocking() for a convenient way to derive such a client.

Variants

BlockAndRetry

Default behavior: internally sleep and retry (subject to RetryConfig) when a rate limit is detected. Callers block until the operation succeeds or retries are exhausted.

ReturnError

Never sleep or retry internally on rate limits. Operations return LastFmError::RateLimit immediately so the caller can queue the work and schedule its own retry (e.g. by watching RateLimitState).

Trait Implementations

impl Clone for RateLimitBehavior

fn clone(&self) -> RateLimitBehavior

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for RateLimitBehavior

impl Debug for RateLimitBehavior

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

Formats the value using the given formatter.

impl Default for RateLimitBehavior

fn default() -> RateLimitBehavior

Returns the “default value” for a type.

impl Eq for RateLimitBehavior

impl PartialEq for RateLimitBehavior

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for RateLimitBehavior