Enum StoreError

pub enum StoreError {
    DoesNotExist,
    Io {
        source: Error,
    },
    Load {
        source: Error,
    },
    Str {
        source: Utf8Error,
    },
    ProcessEndedWithoutSuccess,
    UnsupportedVersion,
    AmbiguousFlags(FlagSet<CheckFlag>),
    MissingFlag(FlagSet<CheckFlag>),
    BadStoreVersion(u8),
    IsReadonly,
}

Errors that can occur during store operations.

These errors handle various failure modes when interacting with the store:

• File system operations
• Data serialization/deserialization
• Version compatibility

Variants

DoesNotExist

The store file does not exist.

This typically occurs on first run or if the store file was deleted.

Io

An I/O error occurred during store operations.

This can happen during file reading, writing, or filesystem operations.

Fields

source: Error

Underlying error

Load

Failed to load store data from file.

This typically indicates corruption or an incompatible / outdated store format.

Fields

source: Error

Underlying error

Str

Failed to convert data to UTF-8.

This can occur when reading store metadata like file hashes.

Fields

source: Utf8Error

Underlying error

ProcessEndedWithoutSuccess

A subprocess (like sha256sum) exited with non-zero status.

UnsupportedVersion

Attempted to load a store with an unsupported version number.

This occurs when the store file version is newer or older than what this version of netpulse supports.

AmbiguousFlags(FlagSet<CheckFlag>)

A Check has flags that are exclusive to each other.

This variant contains a FlagSet with only the conflicting CheckFlags set.

MissingFlag(FlagSet<CheckFlag>)

A Check that does not have the required flags to be valid.

This variant contains a FlagSet with only the flags CheckFlags set that would make it a valid state. Exactly one of these flags must be set.

BadStoreVersion(u8)

Occurs when trying to convert an arbitrary u8 to a Version that is not defined. Only known Versions are valid.

IsReadonly

A store can be loaded as readonly if it’s corrupted or there is a version mismatch

Trait Implementations

impl Debug for StoreError

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

Formats the value using the given formatter.

impl Display for StoreError

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

Formats the value using the given formatter.

impl Error for StoreError

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.

impl From<Box<ErrorKind>> for StoreError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for StoreError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<StoreError> for AnalysisError

fn from(source: StoreError) -> Self

Converts to this type from the input type.

impl From<StoreError> for RunError

fn from(source: StoreError) -> Self

Converts to this type from the input type.

impl From<Utf8Error> for StoreError

fn from(source: Utf8Error) -> Self

Converts to this type from the input type.