Struct PcsExternalClientBuilder 

pub struct PcsExternalClientBuilder { /* private fields */ }

Builder for PcsExternalClient<S>.

Minimal wiring

use pcs_external::{PcsExternalClientBuilder, scopes::SendOnly};

let client = PcsExternalClientBuilder::new(
    "https://api.ppoppo.com/ext",
    "https://accounts.ppoppo.com/oauth/token",
    "my-client-id",
    "my-client-secret",
)
.build::<SendOnly>()
.await?;

From environment variables

Reads PCS_API_URL, PAS_TOKEN_URL, PAS_PCS_CLIENT_ID, PAS_PCS_CLIENT_SECRET. Returns None if any is unset.

use pcs_external::{PcsExternalClientBuilder, scopes::SendOnly};

let client = PcsExternalClientBuilder::from_env()?
    .build::<SendOnly>()
    .await
    .ok()?;

Implementations

impl PcsExternalClientBuilder

pub fn new( api_url: impl Into<String>, token_url: impl Into<String>, client_id: impl Into<String>, client_secret: impl Into<String>, ) -> Self

Construct from explicit parameters.

pub fn from_env() -> Option<Self>

Construct from environment variables.

Reads:

• PCS_API_URL — e.g. https://api.ppoppo.com/ext
• PAS_TOKEN_URL — e.g. https://accounts.ppoppo.com/oauth/token
• PAS_PCS_CLIENT_ID — OAuth2 client_id
• PAS_PCS_CLIENT_SECRET — OAuth2 client_secret

Returns None if any variable is missing.

pub fn with_cache_config(self, config: TokenCacheConfig) -> Self

Override the token cache configuration (e.g. refresh_skew).

pub async fn build<S: PcsExternalScopeSet>( self, ) -> Result<PcsExternalClient<S>, Error>

Build the client, connecting to the PCS External API endpoint.

Errors

Returns Error::Transport or Error::InvalidPathPrefix if the connection cannot be established.