Enum AgeVaultError 

#[non_exhaustive]
pub enum AgeVaultError {
    KeyRead(Error),
    KeyParse(String),
    VaultRead(Error),
    Decrypt(DecryptError),
    Io(Error),
    Json(Error),
    Encrypt(String),
    VaultWrite(Error),
    KeyWrite(Error),
    AlreadyExists(String),
    VaultAlreadyExists(PathBuf),
}

Errors that can occur during age vault operations.

Each variant wraps the underlying cause so callers can match on failure type without parsing error strings.

Examples

use zeph_vault::AgeVaultError;

let err = AgeVaultError::KeyParse("no identity line found".into());
assert!(err.to_string().contains("failed to parse age identity"));

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

KeyRead(Error)

The key file could not be read from disk.

KeyParse(String)

The key file content could not be parsed as an age identity.

VaultRead(Error)

The vault file could not be read from disk.

Decrypt(DecryptError)

The age decryption step failed (wrong key, corrupted file, etc.).

Io(Error)

An I/O error occurred while reading plaintext from the age stream.

Json(Error)

The decrypted bytes could not be parsed as JSON.

Encrypt(String)

The age encryption step failed.

VaultWrite(Error)

The vault file (or its temporary predecessor) could not be written to disk.

KeyWrite(Error)

The key file could not be written to disk.

AlreadyExists(String)

AgeVaultProvider::set_secret_mut was called with overwrite: false for a key that already exists in the vault.

VaultAlreadyExists(PathBuf)

AgeVaultProvider::init_vault (or AgeVaultProvider::init_vault_at) found an existing vault-key.txt or secrets.age at the target location and force was not set.

Trait Implementations

impl Debug for AgeVaultError

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

Formats the value using the given formatter.

impl Display for AgeVaultError

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

Formats the value using the given formatter.

impl Error for AgeVaultError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.