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: secret store → 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 default backend. The prompt-free default is FileKeyringStore under ~/.deepseek/secrets/. Set SECRET_BACKEND_ENV to system or keyring to opt into the OS credential store.

pub fn file_backed() -> Self

Construct the file-backed default backend directly.

pub fn system_keyring() -> Self

Construct the opt-in OS credential backend, falling back to the file-backed store when the platform backend is unavailable.

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 secret store → env → none precedence.

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

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

Resolve a secret and report which layer supplied it.

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.