Struct ClientBuilder 

pub struct ClientBuilder { /* private fields */ }

Builder for configuring and connecting to an agtrace workspace.

Provides flexible path resolution with the following priority:

1. Explicit path via builder.path()
2. AGTRACE_PATH environment variable
3. XDG data directory (e.g., ~/.local/share/agtrace on Linux, ~/Library/Application Support/agtrace on macOS)

Examples

// Use default XDG path
let client = Client::connect_default().await?;

// Use explicit path
let client = Client::builder()
    .path("/custom/path")
    .connect().await?;

// Use AGTRACE_PATH environment variable
// $ export AGTRACE_PATH=/tmp/agtrace
let client = Client::builder().connect().await?;

Implementations

impl ClientBuilder

pub fn new() -> Self

Create a new ClientBuilder with default settings.

pub fn path(self, path: impl Into<PathBuf>) -> Self

Set an explicit workspace path (highest priority).

pub async fn connect(self) -> Result<Client>

Connect to the workspace using the configured or resolved path. If the workspace does not exist, it will be automatically initialized.

Trait Implementations

impl Default for ClientBuilder

fn default() -> ClientBuilder

Returns the “default value” for a type.