Struct ArchClientBuilder 

pub struct ArchClientBuilder { /* private fields */ }

What: Builder for creating ArchClient with custom configuration.

Inputs: None (created via ArchClient::builder())

Output: ArchClientBuilder that can be configured and built

Details:

• Allows customization of timeout, user agent, and other settings
• All methods return &mut Self for method chaining
• Call build() to create the ArchClient

Implementations

impl ArchClientBuilder

pub const fn new() -> Self

What: Create a new builder with default values.

Inputs: None

Output:

• ArchClientBuilder with default configuration

Details:

• Default timeout: 30 seconds
• Default user agent: “arch-toolkit/0.1.0”

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

What: Set the HTTP request timeout.

Inputs:

• timeout: Duration for request timeout

Output:

• &mut Self for method chaining

Details:

• Overrides default timeout of 30 seconds
• Applied to all HTTP requests made by this client

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

What: Set a custom user agent string.

Inputs:

• user_agent: User agent string to use for requests

Output:

• &mut Self for method chaining

Details:

• Overrides default user agent “arch-toolkit/0.1.0”
• Applied to all HTTP requests made by this client

pub fn retry_policy(self, policy: RetryPolicy) -> Self

What: Set the retry policy configuration.

Inputs:

• policy: Retry policy to use

Output:

• Self for method chaining

Details:

• Overrides default retry policy
• Applied to all AUR operations made by this client

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

What: Set the maximum number of retry attempts.

Inputs:

• max_retries: Maximum number of retries (default: 3)

Output:

• Self for method chaining

Details:

• Convenience method to set max_retries on the retry policy
• Creates default policy if none exists

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

What: Enable or disable retries globally.

Inputs:

• enabled: Whether retries are enabled (default: true)

Output:

• Self for method chaining

Details:

• Convenience method to enable/disable retries
• Creates default policy if none exists

pub fn retry_operation(self, operation: &str, enabled: bool) -> Self

What: Enable or disable retries for a specific operation type.

Inputs:

• operation: Operation name (“search”, “info”, “comments”, “pkgbuild”)
• enabled: Whether retries are enabled for this operation

Output:

• Self for method chaining

Details:

• Convenience method to configure per-operation retry behavior
• Creates default policy if none exists
• Invalid operation names are ignored

pub fn cache_config(self, config: CacheConfig) -> Self

What: Set the cache configuration.

Inputs:

• config: Cache configuration to use

Output:

• Self for method chaining

Details:

• Enables caching with the specified configuration
• If not set, caching is disabled (default)

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

What: Build the ArchClient with the configured settings.

Inputs: None

Output:

• Result<ArchClient> with configured client, or error if creation fails

Details:

• Uses configured values or defaults if not set
• Creates underlying reqwest::Client with timeout and user agent
• Rate limiting is handled automatically by existing static functions

Errors

• Returns Err(ArchToolkitError::Network) if reqwest::Client creation fails

Trait Implementations

impl Clone for ArchClientBuilder

fn clone(&self) -> ArchClientBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ArchClientBuilder

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

Formats the value using the given formatter.

impl Default for ArchClientBuilder

Available on crate feature aur only.

fn default() -> Self

Returns the “default value” for a type.