Struct ClientBuilder 

pub struct ClientBuilder { /* private fields */ }

Builder for LangfuseClient, mirroring the style of opentelemetry-langfuse.

Implementations

impl ClientBuilder

pub fn new() -> Self

Start a new builder without credentials. Use ClientBuilder::public_key and ClientBuilder::secret_key to provide them before calling ClientBuilder::build.

pub fn from_env() -> Result<Self>

Create a builder pre-populated from environment variables.

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

Set the public key used for authentication.

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

Set the secret key used for authentication.

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

Override the Langfuse base URL (defaults to https://cloud.langfuse.com).

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

Override the request timeout (defaults to 60 seconds).

pub fn connect_timeout(self, value: Duration) -> Self

Override the connection timeout (defaults to 10 seconds).

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

Override the user agent string.

pub fn http_client(self, client: ClientWithMiddleware) -> Self

Set a custom HTTP client with middleware.

This allows you to provide a pre-configured ClientWithMiddleware with custom settings like retry policies, connection pooling, logging, etc.

Example

use reqwest_middleware::ClientBuilder;
use reqwest_retry::{RetryTransientMiddleware, policies::ExponentialBackoff};

let retry_policy = ExponentialBackoff::builder().build_with_max_retries(3);
let client = ClientBuilder::new(reqwest::Client::new())
    .with(RetryTransientMiddleware::new_with_policy(retry_policy))
    .build();

let langfuse_client = langfuse_ergonomic::ClientBuilder::from_env()?
    .http_client(client)
    .build()?;

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

Build a LangfuseClient using the configured options.

Trait Implementations

impl Clone for ClientBuilder

fn clone(&self) -> ClientBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ClientBuilder

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

Formats the value using the given formatter.

impl Default for ClientBuilder

fn default() -> ClientBuilder

Returns the “default value” for a type.