Struct SpnClient 

pub struct SpnClient { /* private fields */ }

Client for communicating with the spn daemon.

The client uses Unix socket IPC to communicate with the daemon, which handles all keychain access to avoid repeated auth prompts.

Implementations

impl SpnClient

pub async fn connect() -> Result<Self, Error>

Connect to the spn daemon.

Returns an error if the daemon is not running.

pub async fn connect_to(socket_path: &PathBuf) -> Result<Self, Error>

Connect to the daemon at a specific socket path.

pub async fn connect_with_fallback() -> Result<Self, Error>

Connect to the daemon, falling back to env vars if daemon is unavailable.

This is the recommended way to connect in applications that should work even without the daemon running.

pub fn is_fallback_mode(&self) -> bool

Check if the client is in fallback mode (daemon not connected).

pub async fn ping(&mut self) -> Result<String, Error>

Ping the daemon to verify the connection.

pub async fn get_secret( &mut self, provider: &str, ) -> Result<SecretString, Error>

Get a secret for the given provider.

In fallback mode, attempts to read from the environment variable associated with the provider (e.g., ANTHROPIC_API_KEY).

pub async fn has_secret(&mut self, provider: &str) -> Result<bool, Error>

Check if a secret exists for the given provider.

pub async fn list_providers(&mut self) -> Result<Vec<String>, Error>

List all available providers.

Trait Implementations

impl Debug for SpnClient

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

Formats the value using the given formatter.