Enum PostgresInboxError 

#[non_exhaustive]
pub enum PostgresInboxError {
    NotMigrated {
        source: Error,
    },
    NotClaimed {
        scope: String,
        message_id: MessageId,
    },
    InvalidSettings {
        message: String,
    },
    Database {
        source: Error,
    },
}

A failure of a crate::PostgresInboxStore call (inbox contract §3). Deliberately smaller than crate::PostgresOutboxError: the inbox has no enqueue/acquire analog, so it needs no Decode/UnknownMetadataVersion/DuplicateMessage variant.

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.

NotMigrated

The relation does not resolve on this connection’s search_path (SQLSTATE 42P01). Either migrate() has not run, or the connection’s search_path does not resolve the unqualified name inbox to the migrated schema. Permanent — the table does not appear on its own. Reliar does not check this at construction (ADR 0047); this is the first statement reporting it, with PostgreSQL’s own message attached as the source. Mapped from SQLSTATE 42P01 on every call.

Fields

source: Error

The underlying 42P01 error, returned from std::error::Error::source.

NotClaimed

crate::PostgresInboxStore’s InboxStore::complete matched zero rows — reachable only by misuse (completing without a preceding Claimed claim, after the claiming transaction aborted, or completing a row that has since gone dead — complete’s own guard is completed_at IS NULL AND dead_at IS NULL, ADR 0042 A.2.4). Permanent — retrying the same call changes nothing.

Fields

scope: String

The scope the caller completed under.

message_id: MessageId

The message id the caller tried to complete.

InvalidSettings

PostgresInboxSettings::validate rejected the settings — currently only max_attempts == 0 (ADR 0042 A.2.4). Checked at crate::PostgresInboxStore::with_settings, before any query runs. Permanent.

Fields

message: String

A payload-free description of what was rejected.

Database

Any other sqlx failure, classified by SQLSTATE exactly as crate::PostgresOutboxError::Database.

Fields

source: Error

The underlying sqlx error.

Trait Implementations

impl Classify for PostgresInboxError

Per-variant classification table, exactly as crate::PostgresOutboxError’s: no blanket “everything else is transient”.

fn kind(&self) -> FailureKind

Whether the failure this error represents can succeed on retry.

impl Debug for PostgresInboxError

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

Formats the value using the given formatter.

impl Display for PostgresInboxError

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

Formats the value using the given formatter.

impl Error for PostgresInboxError

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 PostgresInboxError

fn from(source: Error) -> Self

Converts to this type from the input type.