Enum DbError 

pub enum DbError<E> {
    Sql(DbSqlError),
    Other(E),
}

Error which occurs within a database transaction

If this was a rusqlite::Error, then it’s in DbError::Sql. This will allow transaction retry logic to see it.

Measures are taken to stop anyone type-erasing a rusqlite::Error, for example by calling anyhow’s .context() or our .into_internal on it.

rusqlite::Error can still be converted manually with AE::from, // which should therefore be accompanied by a comment each time. btest/test/no-anyhow-from checks for this. This isn’t perfect because ? could perform automatic error conversion - so we must be careful if we make functions return anyhow::Result near the db.

Doesn’t implement Error, so you can’t accidentally type-erase this error.

Variants

Sql(DbSqlError)

Database API call reported error, might mean transaction retry

Other(E)

Another error occurred. We should definitely rollback and not retry.

Implementations

impl DbError<ErasedError1>

pub fn unwrap_after_retries(self) -> Error

Convert to an anyhow::Error, when you’ve done needed retries

Correctness

See ErasedError1::unwrap_after_retries.

impl DbError<Void>

pub fn into_sql_void(self) -> DbSqlError

impl<E> DbError<E>

pub fn is_busy_err<T>(r: &Result<T, Self>) -> Option<&DbSqlError>

Is r an error with code BUSY ?

Trait Implementations

impl<E> DbErrorContext<DbError<E>> for DbError<E>

fn with_db_context<D>(self, context: impl FnOnce() -> D) -> DbError<E>

where D: Display,

Returns the error, or result, with more context (from a closure)

fn db_context<D>(self, context: D) -> Output

where D: Display,

Returns the error, or result, with more context

impl<E> DbErrorContext<DbError<E>> for Error

fn with_db_context<D>(self, context: impl FnOnce() -> D) -> DbError<E>

where D: Display,

Returns the error, or result, with more context (from a closure)

fn db_context<D>(self, context: D) -> Output

where D: Display,

Returns the error, or result, with more context

impl<E: Debug> Debug for DbError<E>

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

Formats the value using the given formatter.

impl<E> Display for DbError<E>

where E: Display,

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

Formats the value using the given formatter.

impl From<DbError<Error>> for SchemaGenerationError

fn from(e: DbError<AE>) -> SchemaGenerationError

Converts to this type from the input type.

impl<E> From<E> for DbError<E>

fn from(x: E) -> Self

Converts to this type from the input type.