Improvements
- A timeout parameter was added to :func:`data.memento.get_closest_memento_url` and the default timeout was increased to 30 s (:phab:`T382943`).
- :func:`bot.calledModuleName` returns either 'unittest' or 'pytest' during test run (:phab:`T382797`).
- :class:`tools.threading.BoundedPoolExecutor` was added (:phab:`T333741`).
- args parameter for :mod:`logging` functions can be used as formatting arguments
- :attr:`.login.OauthLoginManager.access_token` was added.
- Representation string for :class:`login.LoginManager` was added.
Bugfixes
- Remove unintentional args parameter in :class:`tools.threading.ThreadList` (:phab:`T382787`).
Code cleanups
- Remove unintentional
pywikibot.warn() - Unused get_redirect parameter of :meth:`BasePage.getOldVersion()<page.BasePage.getOldVersion>` was removed.
- baserevid parameter of :class:`DataSite<pywikibot.site._datasite.DataSite>` methods :meth:`editSource()<pywikibot.site._datasite.DataSite.editSource>`, :meth:`editQualifier()<pywikibot.site._datasite.DataSite.editQualifier>`, :meth:`removeClaims()<pywikibot.site._datasite.DataSite.removeClaims>`, :meth:`removeSources()<pywikibot.site._datasite.DataSite.removeSources>`, :meth:`remove_qualifiers()<pywikibot.site._datasite.DataSite.remove_qualifiers>` were be removed.
linktrailmethods of :class:`family.Family` and :class:`BaseSite<pywikibot.site._basesite.BaseSite>` were removed; use :meth:`APISite.linktrail()<pywikibot.site._apisite.APISite.linktrail>` instead.- Positional arguments decoder, layer and newline for :mod:`logging` functions are invalid; keyword arguments must be used instead.
- tb parameter of :func:`exception()<pywikibot.logging.exception>` function was dropped; use exc_info instead.
- The positional arguments of :meth:`page.BasePage.linkedPages` were removed.
FilePage.usingPages()was renamed to :meth:`using_pages()<pywikibot.FilePage.using_pages>`.APISite.article_pathwas removed. :attr:`APISite.articlepath <pywikibot.site._apisite.APISite.articlepath>` can be used instead.fix_digitsmethod of :class:`textlib.TimeStripper` was removed; :func:`textlib.to_latin_digits` can be used instead.- :mod:`textlib`.tzoneFixedOffset class was removed in favour of :class:`time.TZoneFixedOffse<pywikibot.time.TZoneFixedOffset>`.
- A boolean watch parameter in :meth:`page.BasePage.save` is desupported.
XMLDumpOldPageGeneratorwas removed in favour of acontentparameter of :func:`pagegenerators.XMLDumpPageGenerator` (:phab:`T306134`).- :meth:`pywikibot.User.is_blocked` method was renamed from
isBlockedfor consistency. - Values of :meth:`APISite.allpages()<pywikibot.site._generators.GeneratorsMixin.allpages>` parameter filterredir must be True, False or None.
- :mod:`tools.threading` classes no longer can be imported from :mod:`tools`.
- :mod:`tools.itertools` datatypes no longer can be imported from :mod:`tools`.
- :mod:`tools.collections` datatypes no longer can be imported from :mod:`tools`.
svn_rev_infoandgetversion_svnof :mod:`version` module were be removed. SVN repository is no longer supported. (:phab:`T362484`).- Old color escape sequences like
\03{color}were dropped in favour of new color format like<<color>>. tools.formatter.color_format()was removed; the new color literals can be used instead.- RedirectPageBot and NoRedirectPageBot bot classes were removed in favour of :attr:`use_redirects<bot.BaseBot.use_redirects>` attribute.
Other breaking changes
- :mod:`backports` module is no longer a public API.
- Drop support for MediaWiki < 1.31 (:phab:`T378984`)
- Require
requests >= 2.31.0(:phab:`T347031`) - Python 3.7 support was dropped (:phab:`T378893`), including importlib_metadata of :mod:`backports`.
- See also Current Deprecations below.
- 10.0.0: 'millenia' argument for precision parameter of :class:`pywikibot.WbTime` is deprecated; 'millennium' must be used instead.
- 10.0.0: includeredirects parameter of :func:`pagegenerators.AllpagesPageGenerator` and :func:`pagegenerators.PrefixingPageGenerator` is deprecated and should be replaced by filterredir
- 9.6.0: :meth:`BaseSite.languages()<pywikibot.site._basesite.BaseSite.languages>` will be removed in favour of :attr:`BaseSite.codes<pywikibot.site._basesite.BaseSite.codes>`
- 9.5.0: :meth:`DataSite.getPropertyType()<pywikibot.site._datasite.DataSite.getPropertyType>` will be removed in favour of :meth:`DataSite.get_property_type()<pywikibot.site._datasite.DataSite.get_property_type>`
- 9.3.0: :meth:`page.BasePage.userName` and :meth:`page.BasePage.isIpEdit` are deprecated in favour of
useroranonattributes of :attr:`page.BasePage.latest_revision` property - 9.2.0: Imports of :mod:`logging` functions from :mod:`bot` module is deprecated and will be desupported
- 9.2.0: total argument in
-logeventspagegenerators option is deprecated; use-limitinstead (:phab:`T128981`) - 9.0.0: The content parameter of :meth:`proofreadpage.IndexPage.page_gen` is deprecated and will be ignored (:phab:`T358635`)
- 9.0.0:
userinterfaces.transliteration.transliteratorwas renamed to :class:`Transliterator <userinterfaces.transliteration.Transliterator>` - 9.0.0:
nextparameter of :meth:`userinterfaces.transliteration.transliterator.transliterate` was renamed tosucc - 9.0.0:
typeparameter of :meth:`site.APISite.protectedpages() <pywikibot.site._generators.GeneratorsMixin.protectedpages>` was renamed toprotect_type - 9.0.0:
allparameter of :meth:`site.APISite.namespace()<pywikibot.site._apisite.APISite.namespace>` was renamed toall_ns - 9.0.0:
filterparameter of :func:`date.dh` was renamed tofilter_func - 9.0.0:
dictparameter of :class:`data.api.OptionSet` was renamed todata - 9.0.0:
pywikibot.version.get_toolforge_hostname()is deprecated without replacement - 9.0.0:
allrevisionsparameter of :class:`xmlreader.XmpDump` is deprecated, userevisionsinstead (:phab:`T340804`) - 9.0.0:
iteritemsmethod of :class:`data.api.Request` will be removed in favour ofitems - 9.0.0:
SequenceOutputter.output()is deprecated in favour of :attr:`tools.formatter.SequenceOutputter.out` property - 9.0.0: nullcontext context manager and SimpleQueue queue of :mod:`backports` are deprecated
- 8.4.0: modules_only_mode parameter of :class:`data.api.ParamInfo`, its paraminfo_keys class attribute and its preloaded_modules property will be removed
- 8.4.0: dropdelay and releasepid attributes of :class:`throttle.Throttle` will be removed in favour of expiry class attribute
- 8.2.0: :func:`tools.itertools.itergroup` will be removed in favour of :func:`backports.batched`
- 8.2.0: normalize parameter of :meth:`WbTime.toTimestr` and :meth:`WbTime.toWikibase` will be removed
- 8.1.0: Dependency of :exc:`exceptions.NoSiteLinkError` from :exc:`exceptions.NoPageError` will be removed
- 8.1.0:
exceptions.Server414Erroris deprecated in favour of :exc:`exceptions.Client414Error` - 8.0.0: :meth:`Timestamp.clone()<pywikibot.time.Timestamp.clone>` method is deprecated
in favour of
Timestamp.replace()method. - 8.0.0: :meth:`family.Family.maximum_GET_length` method is deprecated in favour of :ref:`config.maximum_GET_length<Account Settings>` (:phab:`T325957`)
- 8.0.0:
addOnlyparameter of :func:`textlib.replaceLanguageLinks` and :func:`textlib.replaceCategoryLinks` are deprecated in favour ofadd_only - 8.0.0: :class:`textlib.TimeStripper` regex attributes
ptimeR,ptimeznR,pyearR,pmonthR,pdayRare deprecated in favour ofpatternsattribute which is a :class:`textlib.TimeStripperPatterns`. - 8.0.0: :class:`textlib.TimeStripper`
groupsattribute is deprecated in favour oftextlib.TIMEGROUPS - 8.0.0: :meth:`LoginManager.get_login_token<login.ClientLoginManager.get_login_token>` was
replaced by
login.ClientLoginManager.site.tokens['login'] - 8.0.0:
data.api.LoginManager()is deprecated in favour of :class:`login.ClientLoginManager` - 8.0.0: :meth:`APISite.messages()<pywikibot.site._apisite.APISite.messages>` method is deprecated in favour of :attr:`userinfo['messages']<pywikibot.site._apisite.APISite.userinfo>`
- 8.0.0: :meth:`Page.editTime()<page.BasePage.editTime>` method is deprecated and should be replaced by :attr:`Page.latest_revision.timestamp<page.BasePage.latest_revision>`
- 9.4.0: :mod:`flow` support is deprecated and will be removed (:phab:`T371180`)