Enum mwbot::Error

#[non_exhaustive]
pub enum Error {
    HttpError(Error),
    InvalidHeaderValue(InvalidHeaderValue),
    InvalidJson(Error),
    LockFailure(AcquireError),
    InvalidTitle(Error),
    IoError(Error),
    InvalidEtag,
    BadToken,
    TokenFailure(String),
    InvalidHeadingLevel(u32),
    NotLoggedIn,
    NotLoggedInAsBot,
    PermissionDenied(String),
    Blocked {
        info: String,
        details: BlockDetails,
    },
    PartiallyBlocked {
        info: String,
        details: BlockDetails,
    },
    GloballyBlocked(String),
    GloballyRangeBlocked(String),
    GloballyXFFBlocked(String),
    UnknownBlock(String),
    LoginThrottled,
    WrongPassword,
    InvalidPage,
    Nobots,
    PageDoesNotExist(String),
    ProtectedPage,
    EditConflict,
    ContentTooBig(String),
    SpamFilter {
        info: String,
        matches: Vec<String>,
    },
    UndoFailure(String),
    UnknownSaveFailure(Value),
    UploadWarning(Vec<UploadWarning>),
    Maxlag {
        info: String,
        retry_after: Option<u64>,
    },
    Readonly {
        info: String,
        retry_after: Option<u64>,
    },
    InternalException(ApiError),
    ApiError(ApiError),
    Unknown(String),
}

Primary error class

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.

HttpError(Error)

A HTTP error like a 4XX or 5XX status code

InvalidHeaderValue(InvalidHeaderValue)

Invalid header value, likely if the provided OAuth2 token or User-agent are invalid

InvalidJson(Error)

Error when decoding the JSON response from the API

LockFailure(AcquireError)

Error if unable to get request concurrency lock

InvalidTitle(Error)

IoError(Error)

InvalidEtag

etag header is invalid/missing

BadToken

Token invalid or expired

TokenFailure(String)

Unable to fetch a CSRF token

InvalidHeadingLevel(u32)

NotLoggedIn

When expected to be logged in but aren’t

NotLoggedInAsBot

When expected to be logged in but aren’t

PermissionDenied(String)

Blocked

Fields

info: String

details: BlockDetails

PartiallyBlocked

Fields

info: String

details: BlockDetails

GloballyBlocked(String)

GloballyRangeBlocked(String)

GloballyXFFBlocked(String)

UnknownBlock(String)

When we can’t group it into a more specific block

LoginThrottled

WrongPassword

InvalidPage

Nobots

When {{nobots}} matches

PageDoesNotExist(String)

Page does not exist

ProtectedPage

Page is protected

EditConflict

Edit conflict

ContentTooBig(String)

SpamFilter

Fields

info: String

matches: Vec<String>

Tripped the spam filter (aka SpamBlacklist)

UndoFailure(String)

If the edit could not be undone

UnknownSaveFailure(Value)

Some save failure happened, but we don’t know what it is

UploadWarning(Vec<UploadWarning>)

Maxlag

Fields

info: String

retry_after: Option<u64>

Readonly

Fields

info: String

retry_after: Option<u64>

When MediaWiki is in readonly mode

InternalException(ApiError)

An internal MediaWiki exception

ApiError(ApiError)

Any arbitrary error returned by the MediaWiki API

Unknown(String)

An error where we don’t know what to do nor have information to report back

Implementations

impl Error

pub fn is_page_related(&self) -> bool

Whether the issue is related to a specific page rather than a global issue

pub fn is_sitewide_block(&self) -> bool

Whether the issue is related to a sitewide block

pub fn retry_after(&self) -> Option<u64>

If the error merits a retry, how long should we wait?

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

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

fn from(source: AcquireError) -> Self

Converts to this type from the input type.

impl From<ApiError> for Error

fn from(apierr: ApiError) -> Self

Converts to this type from the input type.

impl From<Error> for ConfigError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(value: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(value: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<InvalidHeaderValue> for Error

fn from(source: InvalidHeaderValue) -> Self

Converts to this type from the input type.