Struct ClientBuilder

pub struct ClientBuilder { /* private fields */ }

Builder for constructing a Client with custom configuration.

This allows specifying the API region, base URL, credentials, and optionally customizing the inner reqwest::ClientBuilder.

Implementations

impl ClientBuilder

pub fn from_env() -> Self

Creates a builder pre-configured using environment variables.

• Uses PCLOUD_REGION or PCLOUD_BASE_URL for the endpoint.
• Uses PCLOUD_ACCESS_TOKEN or PCLOUD_USERNAME/PCLOUD_PASSWORD for credentials.

Falls back to the EU region if none is specified.

impl ClientBuilder

pub fn set_region(&mut self, region: Region)

Sets the API region.

pub fn with_region(self, region: Region) -> Self

Sets the API region and returns the modified builder.

pub fn set_base_url(&mut self, base_url: impl Into<Cow<'static, str>>)

Sets a custom base URL.

pub fn with_base_url(self, base_url: impl Into<Cow<'static, str>>) -> Self

Sets a custom base URL and returns the modified builder.

pub fn set_client_builder(&mut self, client_builder: ClientBuilder)

Sets a custom reqwest::ClientBuilder.

pub fn with_client_builder(self, client_builder: ClientBuilder) -> Self

Sets a custom reqwest::ClientBuilder and returns the modified builder.

pub fn set_credentials(&mut self, credentials: Credentials)

Sets the credentials for API authentication.

pub fn with_credentials(self, credentials: Credentials) -> Self

Sets the credentials and returns the modified builder.

pub fn build(self) -> Result<Client, Error>

Builds the Client with the configured options.

Errors

Returns [Error::MissingCredentials] if no credentials were set. Returns Error::Reqwest if the HTTP client could not be built.

Trait Implementations

impl Debug for ClientBuilder

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

Formats the value using the given formatter.

impl Default for ClientBuilder

fn default() -> Self

Creates a new ClientBuilder with default settings:

• Base URL is set to the EU region.
• No credentials are set.
• No custom reqwest::ClientBuilder is used.