Enum InGenError 

#[non_exhaustive]
pub enum InGenError {
    Other(Box<dyn Error + Send + Sync>),
    Gen(Box<GenError>),
    Insert(InsertError),
    Provider(ProviderError),
    Space(Error),
    SetCube(SetCubeError),
    UniverseTransaction(ExecuteError<UniverseTransaction>),
    SpaceTransaction(ExecuteError<SpaceTransaction>),
}

Aggregation of types of errors that might occur in “world generation”.

This is distinct from GenError in that this type is returned from functions responsible for generation, and that type is returned from functions that manage generation — that invoke the first kind and (usually) store its result in the Universe. This separation is intended to encourage more precise attribution of the source of the error despite implicit conversions, because a “nested” GenError will be obligated to be wrapped in InGenError rather than mistakenly taken as the same level.

TODO: Work this into a coherent set of error cases rather than purely “I saw one of these once, so add it”.

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.

Other(Box<dyn Error + Send + Sync>)

Generic error container for unusual situations.

Gen(Box<GenError>)

Something else needed to be generated and that failed.

Insert(InsertError)

Failed to insert the generated items in the Universe.

Provider(ProviderError)

Failed to find a needed dependency.

Space(Error)

Failed during Space construction.

SetCube(SetCubeError)

Failed during Space manipulation.

UniverseTransaction(ExecuteError<UniverseTransaction>)

Failed during a transaction executed as part of generation.

SpaceTransaction(ExecuteError<SpaceTransaction>)

Failed during a transaction executed as part of generation.

Implementations

impl InGenError

pub fn other<E: Error + Send + Sync + 'static>(error: E) -> Self

Convert an arbitrary error to InGenError.

Trait Implementations

impl Debug for InGenError

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

Formats the value using the given formatter.

impl Display for InGenError

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

Formats the value using the given formatter.

impl Error for InGenError

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<Error> for InGenError

fn from(error: Error) -> Self

Converts to this type from the input type.

impl From<ExecuteError<SpaceTransaction>> for InGenError

fn from(error: ExecuteError<SpaceTransaction>) -> Self

Converts to this type from the input type.

impl From<ExecuteError> for InGenError

fn from(error: ExecuteError<UniverseTransaction>) -> Self

Converts to this type from the input type.

impl From<GenError> for InGenError

fn from(error: GenError) -> Self

Converts to this type from the input type.

impl From<InsertError> for InGenError

fn from(error: InsertError) -> Self

Converts to this type from the input type.

impl From<ProviderError> for InGenError

fn from(error: ProviderError) -> Self

Converts to this type from the input type.

impl From<SetCubeError> for InGenError

fn from(error: SetCubeError) -> Self

Converts to this type from the input type.