Struct Secrets 

pub struct Secrets {
    pub store: Arc<dyn KeyringStore>,
    /* private fields */
}

High-level façade combining a KeyringStore with environment variable fallbacks.

Lookup precedence: keyring → env → none. Callers that also have a TOML config layer must wire that themselves at the very end of the chain.

Fields

store: Arc<dyn KeyringStore>

Underlying secret store.

Implementations

impl Secrets

pub fn new(store: Arc<dyn KeyringStore>) -> Self

Build a new façade around a store.

pub fn auto_detect() -> Self

Construct the platform-appropriate default backend. On platforms where an OS keyring backend is reachable this returns DefaultKeyringStore; otherwise it falls back to FileKeyringStore under ~/.deepseek/secrets/.

pub fn backend_name(&self) -> &'static str

Backend label, suitable for doctor output.

pub fn resolve(&self, name: &str) -> Option<String>

Resolve a secret with keyring → env → none precedence.

name is the canonical provider name ("deepseek", "openrouter", "novita", "nvidia"/"nvidia-nim", "openai"). Empty strings on either layer are treated as “not set”.

pub fn set(&self, name: &str, value: &str) -> Result<(), SecretsError>

Convenience: write a secret through the underlying store.

pub fn delete(&self, name: &str) -> Result<(), SecretsError>

Convenience: delete a secret through the underlying store.

pub fn get(&self, name: &str) -> Result<Option<String>, SecretsError>

Convenience: read a secret directly (no env fallback).

Trait Implementations

impl Clone for Secrets

fn clone(&self) -> Secrets

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Secrets

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

Formats the value using the given formatter.