Struct Store 

pub struct Store { /* private fields */ }

The encrypted store, bound to a config, a recipient list and an unlocked identity.

Implementations

impl Store

pub fn open(config: Config, identity: Identity) -> Result<Self>

Opens an existing store and validates its recipients.

Errors

• Error::StoreNotFound if store_dir does not exist.
• Error::NoRecipients if .recipients is missing or empty.
• Error::Io / Error::InvalidRecipient on parse failures.

pub fn create( config: Config, identity: Identity, extra_recipients: &[Recipient], ) -> Result<Self>

Creates a brand-new store: store_dir/, .recipients, and an empty tree.

identity is the just-created user identity. Its public key plus any extra_recipients are written into .recipients.

Errors

• Error::StoreExists if .recipients already exists in store_dir.
• Error::Io on filesystem failures.

pub fn root(&self) -> &Path

Returns the absolute store directory.

pub const fn identity(&self) -> &Identity

Returns the unlocked identity.

pub fn recipients(&self) -> &[Recipient]

Returns the configured recipient list.

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

Returns true if a secret exists at logical.

pub fn get(&self, logical: &str) -> Result<Secret>

Reads and decrypts the secret at logical.

Errors

• Error::InvalidPath for malformed paths.
• Error::SecretNotFound if no such file exists.
• Error::Decrypt / Error::Io on failure.

pub fn set(&self, logical: &str, secret: &Secret) -> Result<()>

Encrypts and writes (or overwrites) secret at logical.

Errors

• Error::InvalidPath for malformed paths.
• Error::Io / Error::Encrypt on failure.

pub fn insert(&self, logical: &str, secret: &Secret) -> Result<()>

Inserts a new secret, failing if one already exists.

Errors

Returns Error::SecretExists if a file is already present.

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

Deletes the secret at logical. Also prunes now-empty parent directories up to (but not including) the store root.

Errors

Returns Error::SecretNotFound if the file is absent.

pub fn rename(&self, from: &str, to: &str) -> Result<()>

Renames a secret from one logical path to another.

Errors

• Error::SecretNotFound if from does not exist.
• Error::SecretExists if to already exists.
• Error::InvalidPath for malformed to.

pub fn list(&self, prefix: &str) -> Result<Vec<String>>

Lists logical paths under prefix (use "" for all), sorted.

Errors

Returns Error::Io on directory traversal failures.

pub fn find(&self, query: &str, include_notes: bool) -> Result<Vec<String>>

Searches paths and decrypted notes case-insensitively for query.

Notes are scanned only when include_notes is true (which requires decrypting every secret — slow on large stores).

Errors

Returns Error::Io / Error::Decrypt on failure when scanning notes.

pub fn set_recipients( &mut self, new_recipients: Vec<Recipient>, ) -> Result<usize>

Replaces the recipient list and re-encrypts every secret.

new_recipients must contain at least the current user’s public key (otherwise we’d lock ourselves out — checked).

Errors

Returns Error::InvalidRecipient if the resulting list does not include the user’s own public key, or Error::Io / Error::Decrypt during re-encryption.

Trait Implementations

impl Debug for Store

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

Formats the value using the given formatter.