exceptions — Exceptions and Warning Classes#

Pywikibot Exceptions and warning classes.

This module contains all exception and warning classes used throughout the framework:

Exception
 +-- Error
      +-- APIError
      |    +-- APIMWError
      |    +-- UploadError
      +-- AutoblockUserError
      +-- CaptchaError
      +-- ClientError
      |    +-- Client414Error
      +-- InvalidTitleError
      +-- NoUsernameError
      +-- PageInUseError
      +-- PageRelatedError
      |    +-- CircularRedirectError
      |    +-- InterwikiRedirectPageError
      |    +-- IsNotRedirectPageError
      |    +-- IsRedirectPageError
      |    +-- NoMoveTargetError
      |    +-- NoPageError
      |    +-- NotEmailableError
      |    +-- PageLoadRelatedError
      |    |    +-- InconsistentTitleError
      |    |    +-- InvalidPageError
      |    |    +-- NoSiteLinkError
      |    +-- PageSaveRelatedError
      |    |    +-- EditConflictError
      |    |    |    +-- ArticleExistsConflictError
      |    |    |    +-- PageCreatedConflictError
      |    |    |    +-- PageDeletedConflictError
      |    |    +-- LockedPageError
      |    |    |    +-- LockedNoPageError
      |    |    |    +-- CascadeLockedPageError
      |    |    +-- NoCreateError
      |    |    +-- OtherPageSaveError
      |    |    +-- SpamblacklistError
      |    |    +-- TitleblacklistError
      |    |    +-- AbuseFilterDisallowedError
      |    +-- UnsupportedPageError
      +-- SectionError
      +-- ServerError
      |    +-- FatalServerError
      |    +-- Server504Error
      +-- SiteDefinitionError
      |    +-- UnknownFamilyError
      |    +-- UnknownSiteError
      +-- TimeoutError
      |    +-- MaxlagTimeoutError
      +-- TranslationError
      +-- UserRightsError
      |    +-- HiddenKeyError (KeyError)
      +-- UnknownExtensionError (NotImplementedError)
      +-- VersionParseError
      +-- WikiBaseError
           +-- CoordinateGlobeUnknownError (NotImplementedError)
           +-- EntityTypeUnknownError
           +-- NoWikibaseEntityError

UserWarning
 +-- ArgumentDeprecationWarning (FutureWarning)
 +-- FamilyMaintenanceWarning

RuntimeWarning
 +-- NotImplementedWarning

Error: Base class, all exceptions should the subclass of this class.

  • CaptchaError: Captcha is asked and config.solve_captcha == False

  • ClientError: A problem with the client request

  • AutoblockUserError: requested action on a virtual autoblock user not valid

  • InvalidTitleError: Invalid page title

  • NoUsernameError: Username is not in user config file, or it is invalid.

  • PageInUseError: Page cannot be reserved due to a lock

  • SectionError: The section specified by # does not exist

  • TranslationError: no language translation found

  • UnknownExtensionError: Extension is not defined for this site

  • UserRightsError: insufficient rights for requested action

  • VersionParseError: failed to parse version information

  • i18n.TranslationError: i18n/l10n message not available

APIError: wiki API returned an error

  • APIMWError: MediaWiki internal exception

  • UploadError: upload failed

SiteDefinitionError: Site loading problem

  • UnknownSiteError: Site does not exist in Family

  • UnknownFamilyError: Family is not registered

PageRelatedError: any exception which is caused by an operation on a Page.

  • NoPageError: Page does not exist

  • UnsupportedPageError: Page is not supported due to a namespace restriction

  • IsRedirectPageError: Page is a redirect page

  • IsNotRedirectPageError: Page is not a redirect page

  • CircularRedirectError: Page is a circular redirect

  • InterwikiRedirectPageError: Page is a redirect to another site

  • InvalidPageError: Page is invalid e.g. without history

  • NotEmailableError: The target user has disabled email

  • NoMoveTargetError: An expected move target page does not exist

PageLoadRelatedError: any exception which happens while loading a Page.
  • InconsistentTitleError: Page receives a title inconsistent with query

  • NoSiteLinkError: ItemPage has no sitelink to given site

PageSaveRelatedError: page exceptions within the save operation on a Page

  • AbuseFilterDisallowedError: AbuseFilter disallowed

  • SpamblacklistError: MediaWiki spam filter detected a blacklisted URL

  • TitleblacklistError: MediaWiki detected a blacklisted page title

  • OtherPageSaveError: misc. other save related exception.

  • LockedPageError: Page is locked
    • LockedNoPageError: Title is locked against creation

    • CascadeLockedPageError: Page is locked due to cascading protection

  • EditConflictError: Edit conflict while uploading the page
    • PageDeletedConflictError: Page was deleted since being retrieved

    • PageCreatedConflictError: Page was created by another user

    • ArticleExistsConflictError: Page article already exists

  • NoCreateError: parameter nocreate not allow page creation

ServerError: a problem with the server.

  • FatalServerError: A fatal/non-recoverable server error

  • Server414Error: Server timed out with HTTP 414 code

  • Server504Error: Server timed out with HTTP 504 code

WikiBaseError: any issue specific to Wikibase.

  • NoWikibaseEntityError: entity doesn’t exist

  • CoordinateGlobeUnknownError: globe is not implemented yet.

  • EntityTypeUnknownError: entity type is not available on the site.

TimeoutError: request failed with a timeout

  • MaxlagTimeoutError: request failed with a maxlag timeout

DeprecationWarning: old functionality replaced by new functionality

PendingDeprecationWarning: problematic code which has not yet been fully deprecated, possibly because a replacement is not available

RuntimeWarning: problems developers should have fixed, and users need to be aware of its status.

  • NotImplementedWarning: functionality not implemented

UserWarning: warnings targeted at users

  • config._ConfigurationDeprecationWarning: user configuration file problems

  • login._PasswordFileWarning: password file problems

  • ArgumentDeprecationWarning: command line argument problems

  • FamilyMaintenanceWarning: missing information in family definition

Changed in version 6.0: exceptions were renamed and are ending with “Error”.

Changed in version 7.0: All Pywikibot Error exceptions must be imported from pywikibot.exceptions. Deprecated exceptions identifiers were removed.

Changed in version 8.1: Server414Error class is deprecated; use Client414Error instead.

exception exceptions.APIError(code, info, **kwargs)[source]#

Bases: Error

The wiki site returned an error message.

Save error dict returned by MW API.

Parameters:
  • code (str) –

  • info (str) –

  • kwargs (Any) –

Return type:

None

exception exceptions.APIMWError(mediawiki_exception_class_name, info, **kwargs)[source]#

Bases: APIError

The API site returned an error about a MediaWiki internal exception.

Save error dict returned by MW API.

Parameters:
  • mediawiki_exception_class_name (str) –

  • info (str) –

  • kwargs (Any) –

Return type:

None

exception exceptions.AbuseFilterDisallowedError(page, info)[source]#

Bases: PageSaveRelatedError

Page save failed because the AbuseFilter disallowed it.

Parameters:
  • page (pywikibot.page.BasePage) –

  • info (str) –

Return type:

None

message = 'Edit to page {title} disallowed by the AbuseFilter.\n{info}'#
exception exceptions.ArgumentDeprecationWarning[source]#

Bases: UserWarning, FutureWarning

Command line argument that is no longer supported.

exception exceptions.ArticleExistsConflictError(page, message=None)[source]#

Bases: EditConflictError

Page already exists.

Parameters:
  • page (pywikibot.page.BasePage) – Page that caused the exception

  • message (str | None) –

Return type:

None

message = 'Destination article {} already exists and is not a redirect to the source article'#
exception exceptions.AutoblockUserError(arg)[source]#

Bases: Error

Requested action on a virtual autoblock user not valid.

The class AutoblockUserError is an exception that is raised whenever an action is requested on a virtual autoblock user that’s not available for him (i.e. roughly everything except unblock).

Parameters:

arg (Exception | str) –

Return type:

None

exception exceptions.CaptchaError(arg)[source]#

Bases: Error

Captcha is asked and config.solve_captcha == False.

Parameters:

arg (Exception | str) –

Return type:

None

exception exceptions.CascadeLockedPageError(page, message=None)[source]#

Bases: LockedPageError

Page is locked due to cascading protection.

Parameters:
  • page (pywikibot.page.BasePage) – Page that caused the exception

  • message (str | None) –

Return type:

None

message = 'Page {} is locked due to cascading protection.'#
exception exceptions.CircularRedirectError(page, message=None)[source]#

Bases: PageRelatedError

Page is a circular redirect.

Exception argument is the redirect target; this may be the same title as this page or a different title (in which case the target page directly or indirectly redirects back to this one)

Parameters:
  • page (pywikibot.page.BasePage) – Page that caused the exception

  • message (str | None) –

Return type:

None

message = 'Page {} is a circular redirect.'#
exception exceptions.Client414Error(arg)[source]#

Bases: ClientError

Server returned with HTTP 414 code.

New in version 8.1.

Parameters:

arg (Exception | str) –

Return type:

None

exception exceptions.ClientError(arg)[source]#

Bases: Error

Got unexpected server response due to client issue.

New in version 8.1.

Parameters:

arg (Exception | str) –

Return type:

None

exception exceptions.CoordinateGlobeUnknownError(arg)[source]#

Bases: WikiBaseError, NotImplementedError

This globe is not implemented yet in either WikiBase or pywikibot.

Parameters:

arg (Exception | str) –

Return type:

None

exception exceptions.EditConflictError(page, message=None)[source]#

Bases: PageSaveRelatedError

There has been an edit conflict while uploading the page.

Parameters:
  • page (pywikibot.page.BasePage) – Page that caused the exception

  • message (str | None) –

Return type:

None

message = 'Page {} could not be saved due to an edit conflict'#
exception exceptions.EntityTypeUnknownError(arg)[source]#

Bases: WikiBaseError

The requested entity type is not recognised on this site.

Parameters:

arg (Exception | str) –

Return type:

None

exception exceptions.Error(arg)[source]#

Bases: Exception

Pywikibot error.

Parameters:

arg (Exception | str) –

Return type:

None

exception exceptions.FamilyMaintenanceWarning[source]#

Bases: UserWarning

Family class is missing definitions.

exception exceptions.FatalServerError(arg)[source]#

Bases: ServerError

A fatal server error will not be corrected by resending the request.

Parameters:

arg (Exception | str) –

Return type:

None

exception exceptions.HiddenKeyError(arg)[source]#

Bases: UserRightsError, KeyError

Insufficient user rights to view the hidden key.

Parameters:

arg (Exception | str) –

Return type:

None

exception exceptions.InconsistentTitleError(page, actual)[source]#

Bases: PageLoadRelatedError

Page receives a title inconsistent with query.

Parameters:
  • page (pywikibot.page.BasePage) – Page that caused the exception

  • actual (str) – title obtained by query

Return type:

None

exception exceptions.InterwikiRedirectPageError(page, target_page)[source]#

Bases: PageRelatedError

Page is a redirect to another site.

This is considered invalid in Pywikibot. See bug T75184.

Parameters:
  • target_page (pywikibot.page.BasePage) – Target page of the redirect.

  • page (pywikibot.page.BasePage) –

Return type:

None

message = 'Page redirects to a page on another Site.\nPage: {page}\nTarget page: {target_page} on {target_site}.'#
exception exceptions.InvalidPageError(page, message=None)[source]#

Bases: PageLoadRelatedError

Missing page history.

New in version 6.2.

Parameters:
  • page (pywikibot.page.BasePage) – Page that caused the exception

  • message (str | None) –

Return type:

None

message = 'Page {} is invalid.'#
exception exceptions.InvalidTitleError(arg)[source]#

Bases: Error

Invalid page title.

Parameters:

arg (Exception | str) –

Return type:

None

exception exceptions.IsNotRedirectPageError(page, message=None)[source]#

Bases: PageRelatedError

Page is not a redirect page.

Parameters:
  • page (pywikibot.page.BasePage) – Page that caused the exception

  • message (str | None) –

Return type:

None

message = 'Page {} is not a redirect page.'#
exception exceptions.IsRedirectPageError(page, message=None)[source]#

Bases: PageRelatedError

Page is a redirect page.

Parameters:
  • page (pywikibot.page.BasePage) – Page that caused the exception

  • message (str | None) –

Return type:

None

message = 'Page {} is a redirect page.'#
exception exceptions.LockedNoPageError(page, message=None)[source]#

Bases: LockedPageError

Title is locked against creation.

Parameters:
  • page (pywikibot.page.BasePage) – Page that caused the exception

  • message (str | None) –

Return type:

None

message = 'Page {} does not exist and is locked preventing creation.'#
exception exceptions.LockedPageError(page, message=None)[source]#

Bases: PageSaveRelatedError

Page is locked.

Parameters:
  • page (pywikibot.page.BasePage) – Page that caused the exception

  • message (str | None) –

Return type:

None

message = 'Page {} is locked.'#
exception exceptions.MaxlagTimeoutError(arg)[source]#

Bases: TimeoutError

Request failed with a maxlag timeout error.

Parameters:

arg (Exception | str) –

Return type:

None

exception exceptions.NoCreateError(page, message=None)[source]#

Bases: PageSaveRelatedError

Parameter nocreate doesn’t allow page creation.

Parameters:
  • page (pywikibot.page.BasePage) – Page that caused the exception

  • message (str | None) –

Return type:

None

message = 'Page {} could not be created due to parameter nocreate'#
exception exceptions.NoMoveTargetError(page, message=None)[source]#

Bases: PageRelatedError

Expected move target page not found.

Parameters:
  • page (pywikibot.page.BasePage) – Page that caused the exception

  • message (str | None) –

Return type:

None

message = 'Move target page of {} not found.'#
exception exceptions.NoPageError(page, message=None)[source]#

Bases: PageRelatedError

Page does not exist.

Parameters:
  • page (pywikibot.page.BasePage) – Page that caused the exception

  • message (str | None) –

Return type:

None

message = "Page {} doesn't exist."#
exception exceptions.NoSiteLinkError(page, dbname)[source]#

Bases: PageLoadRelatedError, NoPageError

ItemPage has no sitelink to the given site.

New in version 8.1.

Deprecated since version 8.1: NoPageError dependency.

Parameters:
  • page (pywikibot.page.ItemPage) – ItemPage that caused the exception

  • dbname (str) – site identifier of the queried sitelink

Return type:

None

exception exceptions.NoUsernameError(arg)[source]#

Bases: Error

Username is not in user config file (user-config.py).

Parameters:

arg (Exception | str) –

Return type:

None

exception exceptions.NoWikibaseEntityError(entity)[source]#

Bases: WikiBaseError

This entity doesn’t exist.

Parameters:

entity (pywikibot.page.WikibaseEntity) – Wikibase entity

Return type:

None

exception exceptions.NotEmailableError(page, message=None)[source]#

Bases: PageRelatedError

This user is not emailable.

Parameters:
  • page (pywikibot.page.BasePage) – Page that caused the exception

  • message (str | None) –

Return type:

None

message = '{} is not emailable.'#
exception exceptions.NotImplementedWarning[source]#

Bases: _NotImplementedWarning

Feature that is no longer implemented.

exception exceptions.OtherPageSaveError(page, reason)[source]#

Bases: PageSaveRelatedError

Saving the page has failed due to uncatchable error.

Parameters:
  • reason (str | Exception) – Details of the problem

  • page (pywikibot.page.BasePage) –

Return type:

None

property args: str#

Expose args.

message = 'Edit to page {title} failed:\n{reason}'#
exception exceptions.PageCreatedConflictError(page, message=None)[source]#

Bases: EditConflictError

Page was created by another user.

Parameters:
  • page (pywikibot.page.BasePage) – Page that caused the exception

  • message (str | None) –

Return type:

None

message = 'Page {} has been created since last retrieved.'#
exception exceptions.PageDeletedConflictError(page, message=None)[source]#

Bases: EditConflictError

Page was deleted since being retrieved.

Parameters:
  • page (pywikibot.page.BasePage) – Page that caused the exception

  • message (str | None) –

Return type:

None

message = 'Page {} has been deleted since last retrieved.'#
exception exceptions.PageInUseError(arg)[source]#

Bases: Error

Page cannot be reserved for writing due to existing lock.

Parameters:

arg (Exception | str) –

Return type:

None

exception exceptions.PageLoadRelatedError(page, message=None)[source]#

Bases: PageRelatedError

Loading the contents of a Page object has failed.

Parameters:
  • page (pywikibot.page.BasePage) – Page that caused the exception

  • message (str | None) –

Return type:

None

message = 'Page {} was not loaded.'#
exception exceptions.PageRelatedError(page, message=None)[source]#

Bases: Error

Abstract Exception, used when the exception concerns a particular Page.

This class should be used when the Exception concerns a particular Page, and when a generic message can be written once for all.

Parameters:
  • page (pywikibot.page.BasePage) – Page that caused the exception

  • message (str | None) –

Return type:

None

message = ''#
exception exceptions.PageSaveRelatedError(page, message=None)[source]#

Bases: PageRelatedError

Saving the page has failed.

Parameters:
  • page (pywikibot.page.BasePage) – Page that caused the exception

  • message (str | None) –

Return type:

None

message = 'Page {} was not saved.'#
exception exceptions.SectionError(arg)[source]#

Bases: Error

The section specified by # does not exist.

Parameters:

arg (Exception | str) –

Return type:

None

exception exceptions.Server504Error(arg)[source]#

Bases: ServerError

Server timed out with HTTP 504 code.

Parameters:

arg (Exception | str) –

Return type:

None

exception exceptions.ServerError(arg)[source]#

Bases: Error

Got unexpected server response.

Parameters:

arg (Exception | str) –

Return type:

None

exception exceptions.SiteDefinitionError(arg)[source]#

Bases: Error

Site does not exist.

Parameters:

arg (Exception | str) –

Return type:

None

exception exceptions.SpamblacklistError(page, url)[source]#

Bases: PageSaveRelatedError

Page save failed because MediaWiki detected a blacklisted spam URL.

Parameters:
  • page (pywikibot.page.BasePage) –

  • url (str) –

Return type:

None

message = 'Edit to page {title} rejected by spam filter due to content:\n{url}'#
exception exceptions.TimeoutError(arg)[source]#

Bases: Error

Request failed with a timeout error.

Parameters:

arg (Exception | str) –

Return type:

None

exception exceptions.TitleblacklistError(page, message=None)[source]#

Bases: PageSaveRelatedError

Page save failed because MediaWiki detected a blacklisted page title.

Parameters:
  • page (pywikibot.page.BasePage) – Page that caused the exception

  • message (str | None) –

Return type:

None

message = 'Page {} is title-blacklisted.'#
exception exceptions.TranslationError(arg)[source]#

Bases: Error, ImportError

Raised when no correct translation could be found.

Inherits from ImportError, as this exception is now used where previously an ImportError would have been raised, and may have been caught by scripts as such.

Parameters:

arg (Exception | str) –

Return type:

None

exception exceptions.UnknownExtensionError(arg)[source]#

Bases: Error, NotImplementedError

Extension is not defined.

Parameters:

arg (Exception | str) –

Return type:

None

exception exceptions.UnknownFamilyError(arg)[source]#

Bases: SiteDefinitionError

Family is not registered.

Parameters:

arg (Exception | str) –

Return type:

None

exception exceptions.UnknownSiteError(arg)[source]#

Bases: SiteDefinitionError

Site does not exist in Family.

Parameters:

arg (Exception | str) –

Return type:

None

exception exceptions.UnsupportedPageError(page, message=None)[source]#

Bases: PageRelatedError

Unsupported page due to namespace restriction.

Parameters:
  • page (pywikibot.page.BasePage) – Page that caused the exception

  • message (str | None) –

Return type:

None

message = 'Page {} is not supported due to namespace restriction.'#
exception exceptions.UploadError(code, message, file_key=None, offset=0)[source]#

Bases: APIError

Upload failed with a warning message (passed as the argument).

Create a new UploadError instance.

Parameters:
  • file_key (str | None) – The file_key of the uploaded file to reuse it later. If no key is known or it is an incomplete file it may be None.

  • offset (int | bool) – The starting offset for a chunked upload. Is False when there is no offset.

  • code (str) –

  • message (str) –

Return type:

None

property message: str#

Return warning message.

exception exceptions.UserRightsError(arg)[source]#

Bases: Error

Insufficient user rights to perform an action.

Parameters:

arg (Exception | str) –

Return type:

None

exception exceptions.VersionParseError(arg)[source]#

Bases: Error

Failed to parse version information.

Parameters:

arg (Exception | str) –

Return type:

None

exception exceptions.WikiBaseError(arg)[source]#

Bases: Error

Wikibase related error.

Parameters:

arg (Exception | str) –

Return type:

None