Enum StoreCreationError 

pub enum StoreCreationError {
    Directory(BootstrapDirectoryError),
    Store(CovenError),
    DeviceLocked {
        path: PathBuf,
    },
    Identity(IdentityError),
    Sync(SyncError),
    Cleanup {
        operation: Box<StoreCreationError>,
        cleanup: Box<StoreCreationError>,
    },
    PublishedButNotSynced {
        store: StoreId,
        source: Box<StoreCreationError>,
    },
    Shutdown(Shutdown),
    Bug(Bug),
}

Creating a store failed, with publication and rollback made explicit (E1).

Variants

Directory(BootstrapDirectoryError)

Preparing, publishing or removing the hidden directory failed.

Store(CovenError)

Opening the database or custody failed.

DeviceLocked

The device is locked, and the protection class the app chose keeps the new store’s files from being made until it unlocks (api.md E1). No store was made; the app waits for the unlock and creates it again.

Fields

path: PathBuf

The first protected file the lock refused.

Identity(IdentityError)

Creating or persisting the member identity failed.

Sync(SyncError)

Closing the database or its workers failed.

Cleanup

Closing or rollback also failed; both causes remain available.

Fields

operation: Box<StoreCreationError>

The original failure.

cleanup: Box<StoreCreationError>

A cleanup failure.

PublishedButNotSynced

The complete store is visible and closed, but its directory sync failed.

Fields

store: StoreId

The published store; reopen it with CovenBuilder::open.

source: Box<StoreCreationError>

The directory-sync failure, retaining any close failure as Cleanup.

Shutdown(Shutdown)

Creation’s runtime is shutting down and dropped its work (E15). Creation runs as its own task, so with ShutdownOutcome::Unknown it may have stopped anywhere, before or after publishing the store; listing the stores shows which. A step on the blocking pool that the runtime dropped is NotRun.

Bug(Bug)

Creation panicked: a bug, which the caller reports (E15). As with Shutdown, listing the stores shows whether it published the store.

Trait Implementations

impl CarriesBug for StoreCreationError

fn bug(&self) -> Option<&Bug>

The bug this error carries, itself or through the failure it keeps.

impl Debug for StoreCreationError

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

Formats the value using the given formatter.

impl Display for StoreCreationError

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

Formats the value using the given formatter.

impl Error for StoreCreationError

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<BootstrapDirectoryError> for StoreCreationError

fn from(error: BootstrapDirectoryError) -> Self

Converts to this type from the input type.

impl From<Bug> for StoreCreationError

fn from(source: Bug) -> Self

Converts to this type from the input type.

impl From<CovenError> for StoreCreationError

fn from(error: CovenError) -> Self

Converts to this type from the input type.

impl From<IdentityError> for StoreCreationError

fn from(error: IdentityError) -> Self

Converts to this type from the input type.

impl From<OpenError> for StoreCreationError

Opening the database fails as the store’s open does.

fn from(error: OpenError) -> Self

Converts to this type from the input type.

impl From<Shutdown> for StoreCreationError

fn from(source: Shutdown) -> Self

Converts to this type from the input type.

impl From<SyncError> for StoreCreationError

fn from(error: SyncError) -> Self

Converts to this type from the input type.

impl From<TaskFailed> for StoreCreationError

fn from(failed: TaskFailed) -> Self

Converts to this type from the input type.