Struct ChainStore 

pub struct ChainStore { /* private fields */ }

Composable credential store that chains multiple backends.

Attempts to retrieve credentials from each store in order until one succeeds. Write operations go to the first writable store.

Default Chain

Use ChainStore::default_chain() for the recommended configuration:

1. Environment variables (highest priority, for CI/CD)
2. OS Keychain (for local development)

Example

use devboy_storage::{ChainStore, CredentialStore};

// Use default chain
let store = ChainStore::default_chain();

// Or create custom chain
use devboy_storage::{EnvVarStore, MemoryStore};
let store = ChainStore::new(vec![
    Box::new(EnvVarStore::new()),
    Box::new(MemoryStore::new()),
]);

Implementations

impl ChainStore

pub fn new(stores: Vec<Box<dyn CredentialStore>>) -> Self

Create a chain store from a list of stores.

Stores are tried in order for read operations. The first writable store is used for write operations.

pub fn default_chain() -> Self

Create the default credential chain.

Order:

1. Environment variables (EnvVarStore)
2. OS Keychain (KeychainStore)

This is the recommended configuration for most use cases:

• CI/CD can set DEVBOY_* or provider-specific env vars
• Local development uses keychain transparently

pub fn ci_chain() -> Self

Create a chain for CI/CD environments (no keychain).

Only uses environment variables and memory store. Useful when keychain is not available.

pub fn len(&self) -> usize

Get the number of stores in the chain.

pub fn is_empty(&self) -> bool

Check if the chain is empty.

Trait Implementations

impl CredentialStore for ChainStore

fn store(&self, key: &str, value: &SecretString) -> Result<()>

Store a credential securely.

fn get(&self, key: &str) -> Result<Option<SecretString>>

Retrieve a stored credential.

fn delete(&self, key: &str) -> Result<()>

Delete a stored credential.

fn is_available(&self) -> bool

Check if this credential store is available and functional.

fn is_writable(&self) -> bool

Check if this store supports write operations.

fn exists(&self, key: &str) -> bool

Check if a credential exists.

impl Debug for ChainStore

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

Formats the value using the given formatter.