Struct ClientConfig 

pub struct ClientConfig {
    pub retry: RetryConfig,
    pub rate_limit: RateLimitConfig,
    pub operational_delays: OperationalDelayConfig,
    pub api_key: Option<String>,
    pub rate_limit_behavior: RateLimitBehavior,
}

Unified configuration for retry behavior and rate limiting

Fields

retry: RetryConfig

Retry configuration

rate_limit: RateLimitConfig

Rate limit detection configuration

operational_delays: OperationalDelayConfig

Operational delay configuration

api_key: Option<String>

Last.fm API key for read-only API access (optional)

rate_limit_behavior: RateLimitBehavior

How to react when a rate limit is detected (block-and-retry vs. return an error)

Implementations

impl ClientConfig

pub fn new() -> Self

Create a new config with default settings

pub fn with_retries_disabled() -> Self

Create config with retries disabled

pub fn with_rate_limiting_disabled() -> Self

Create config with rate limit detection disabled

pub fn minimal() -> Self

Create config with both retries and rate limiting disabled

pub fn for_testing() -> Self

Create config optimized for testing (rate limit detection enabled, retries enabled but no delays)

pub fn with_retry_config(self, retry_config: RetryConfig) -> Self

Set custom retry configuration

pub fn with_rate_limit_config(self, rate_limit_config: RateLimitConfig) -> Self

Set custom rate limit configuration

pub fn with_operational_delays( self, operational_delays: OperationalDelayConfig, ) -> Self

Set custom operational delay configuration

pub fn with_max_retries(self, max_retries: u32) -> Self

Set custom retry count

pub fn with_retry_delays(self, base_delay: u64, max_delay: u64) -> Self

Set custom retry delays

pub fn with_custom_rate_limit_patterns(self, patterns: Vec<String>) -> Self

Add custom rate limit patterns

pub fn with_status_detection(self, enabled: bool) -> Self

Enable/disable HTTP status code rate limit detection

pub fn with_pattern_detection(self, enabled: bool) -> Self

Enable/disable response pattern rate limit detection

pub fn with_api_key(self, api_key: String) -> Self

Set the Last.fm API key for read-only API access

pub fn with_rate_limit_behavior(self, behavior: RateLimitBehavior) -> Self

Set how the client reacts to detected rate limits.

With RateLimitBehavior::ReturnError the client never sleeps or retries internally on rate limits; operations surface LastFmError::RateLimit so the caller can schedule retries itself (see RateLimitBehavior docs).

Trait Implementations

impl Clone for ClientConfig

fn clone(&self) -> ClientConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ClientConfig

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

Formats the value using the given formatter.

impl Default for ClientConfig

fn default() -> ClientConfig

Returns the “default value” for a type.

impl Eq for ClientConfig

impl PartialEq for ClientConfig

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ClientConfig