Struct ConfigBuilder 

pub struct ConfigBuilder { /* private fields */ }

Configuration builder for creating a Config instance

Implementations

impl ConfigBuilder

pub fn build_client(self) -> Result<LastFmClient>

Build a LastFmClient directly from this builder

This is equivalent to calling build().map(LastFmClient::from_config).

Errors

Returns an error if the builder is missing required fields (e.g., API key).

impl ConfigBuilder

pub fn new() -> Self

Create a new configuration builder

pub fn api_key(self, key: impl Into<String>) -> Self

Set the API key

Example

use lastfm_client::ConfigBuilder;

let builder = ConfigBuilder::new().api_key("my_api_key");

pub fn from_env(self) -> Result<Self>

Load API key from environment variable

Example

use lastfm_client::ConfigBuilder;

let builder = ConfigBuilder::new().from_env()?;

Errors

Returns an error if the LAST_FM_API_KEY environment variable is missing.

pub fn user_agent(self, agent: impl Into<String>) -> Self

Set the user agent

If not set, defaults to async_lastfm/VERSION

pub fn timeout(self, duration: Duration) -> Self

Set the request timeout

If not set, defaults to 30 seconds

pub fn max_concurrent_requests(self, max: usize) -> Self

Set maximum concurrent requests

If not set, defaults to 5

pub fn retry_attempts(self, attempts: u32) -> Self

Set number of retry attempts

If not set, defaults to 3

pub fn rate_limit(self, max_requests: u32, per_duration: Duration) -> Self

Set rate limiting

Example

use lastfm_client::ConfigBuilder;
use std::time::Duration;

let builder = ConfigBuilder::new()
    .api_key("key")
    .rate_limit(5, Duration::from_secs(1)); // Max 5 requests per second

pub fn build(self) -> Result<Config>

Build the configuration

Errors

Returns an error if the API key is not set and cannot be loaded from environment

pub fn build_with_defaults() -> Result<Config>

Build the configuration with defaults, trying to load API key from environment

This is equivalent to ConfigBuilder::new().build() but more explicit about the default behavior.

Errors

Returns an error if the API key is not set and cannot be loaded from environment

Trait Implementations

impl Debug for ConfigBuilder

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

Formats the value using the given formatter.

impl Default for ConfigBuilder

fn default() -> ConfigBuilder

Returns the “default value” for a type.