jenkins-bot has submitted this change. ( https://gerrit.wikimedia.org/r/c/pywikibot/core/+/680632 )
Change subject: [cleanup] Show a FutureWarning with deprecated arguments ......................................................................
[cleanup] Show a FutureWarning with deprecated arguments
See doc: if an argument is to be removed, the value may be one of the following: - None: shows a DeprecationWarning - False: shows a PendingDeprecationWarning - True: shows a FutureWarning (only once) - empty string: no warning is printed
Change-Id: I646c46283698953ca7677ef5d2c92fcd85aa3c41 --- M pywikibot/__init__.py M pywikibot/bot.py M pywikibot/cosmetic_changes.py M pywikibot/daemonize.py M pywikibot/data/mysql.py M pywikibot/family.py M pywikibot/login.py M pywikibot/page/__init__.py M pywikibot/pagegenerators.py M pywikibot/site/_apisite.py M pywikibot/site/_extensions.py M pywikibot/site/_generators.py M pywikibot/textlib.py M pywikibot/titletranslate.py M scripts/category.py 15 files changed, 99 insertions(+), 99 deletions(-)
Approvals: JJMC89: Looks good to me, approved jenkins-bot: Verified
diff --git a/pywikibot/__init__.py b/pywikibot/__init__.py index d3c194a..7780a54 100644 --- a/pywikibot/__init__.py +++ b/pywikibot/__init__.py @@ -1074,7 +1074,7 @@ return matched_sites[0]
-@_deprecate_arg('sysop', None) +@_deprecate_arg('sysop', True) def Site(code: Optional[str] = None, fam=None, user: Optional[str] = None, *, interface=None, url: Optional[str] = None) -> Union[APISite, DataSite, ClosedSite]: diff --git a/pywikibot/bot.py b/pywikibot/bot.py index 2192118..79bb54a 100644 --- a/pywikibot/bot.py +++ b/pywikibot/bot.py @@ -1931,7 +1931,7 @@ use_from_page = True treat_missing_item = False
- @deprecated_args(use_from_page=None) + @deprecated_args(use_from_page=True) def __init__(self, **kwargs): """Initializer of the WikidataBot.""" self.create_missing_item = False diff --git a/pywikibot/cosmetic_changes.py b/pywikibot/cosmetic_changes.py index 3c085ee..fd70a71 100755 --- a/pywikibot/cosmetic_changes.py +++ b/pywikibot/cosmetic_changes.py @@ -205,7 +205,7 @@
"""Cosmetic changes toolkit."""
- @deprecated_args(redirect=None, diff='show_diff', site='page') + @deprecated_args(redirect=True, diff='show_diff', site='page') def __init__(self, page, *, show_diff: bool = False, namespace: Optional[int] = None, diff --git a/pywikibot/daemonize.py b/pywikibot/daemonize.py index 6b70a9f..4ee2be3 100644 --- a/pywikibot/daemonize.py +++ b/pywikibot/daemonize.py @@ -1,6 +1,6 @@ """Module to daemonize the current process on Unix.""" # -# (C) Pywikibot team, 2007-2020 +# (C) Pywikibot team, 2007-2021 # # Distributed under the terms of the MIT license. # @@ -14,7 +14,7 @@ is_daemon = False
-@deprecated_args(write_pid=None) +@deprecated_args(write_pid=True) def daemonize(close_fd=True, chdir=True, redirect_std=None): """ Daemonize the current process. diff --git a/pywikibot/data/mysql.py b/pywikibot/data/mysql.py index f3caa95..95fef47 100644 --- a/pywikibot/data/mysql.py +++ b/pywikibot/data/mysql.py @@ -20,7 +20,7 @@ from pywikibot.tools import deprecated_args
-@deprecated_args(encoding=None) +@deprecated_args(encoding=True) def mysql_query(query: str, params=None, dbname: Optional[str] = None, verbose: Optional[bool] = None): diff --git a/pywikibot/family.py b/pywikibot/family.py index c122af1..dac12ae 100644 --- a/pywikibot/family.py +++ b/pywikibot/family.py @@ -546,7 +546,7 @@ _families = {}
@staticmethod - @deprecated_args(fatal=None) + @deprecated_args(fatal=True) def load(fam: Optional[str] = None): """Import the named family.
@@ -1219,7 +1219,7 @@ return '{0}.wikimedia.org'.format(cls.name)
-@deprecated_args(site=None) +@deprecated_args(site=True) def AutoFamily(name: str, url: str): """ Family that automatically loads the site configuration. diff --git a/pywikibot/login.py b/pywikibot/login.py index b09128b..989da9b 100644 --- a/pywikibot/login.py +++ b/pywikibot/login.py @@ -89,7 +89,7 @@
"""Site login manager."""
- @deprecated_args(username='user', verbose=None, sysop=None) + @deprecated_args(username='user', verbose=True, sysop=True) def __init__(self, password: Optional[str] = None, site=None, user: Optional[str] = None): """ @@ -371,7 +371,7 @@ # NOTE: Currently OauthLoginManager use mwoauth directly to complete OAuth # authentication process
- @deprecated_args(sysop=None) + @deprecated_args(sysop=True) def __init__(self, password: Optional[str] = None, site=None, user: Optional[str] = None): """ diff --git a/pywikibot/page/__init__.py b/pywikibot/page/__init__.py index 2a6ba98..967864f 100644 --- a/pywikibot/page/__init__.py +++ b/pywikibot/page/__init__.py @@ -2573,7 +2573,7 @@ if total == 0: return
- @deprecated_args(startFrom='startprefix', startsort=None, endsort=None) + @deprecated_args(startFrom='startprefix', startsort=True, endsort=True) def articles(self, recurse: Union[int, bool] = False, total: Optional[int] = None, diff --git a/pywikibot/pagegenerators.py b/pywikibot/pagegenerators.py index 3d85afb..df8b3e5 100644 --- a/pywikibot/pagegenerators.py +++ b/pywikibot/pagegenerators.py @@ -1268,7 +1268,7 @@
@deprecated('Site.allpages()', since='20180512') -@deprecated_args(step=None) +@deprecated_args(step=True) def AllpagesPageGenerator(start: str = '!', namespace=0, includeredirects=True, site=None, total: Optional[int] = None, content: bool = False @@ -1298,7 +1298,7 @@ filterredir=filterredir, total=total, content=content)
-@deprecated_args(step=None) +@deprecated_args(step=True) def PrefixingPageGenerator(prefix: str, namespace=None, includeredirects: Union[None, bool, str] = True, site=None, total: int = None, @@ -1337,7 +1337,7 @@ filterredir=filterredir, total=total, content=content)
-@deprecated_args(number='total', mode='logtype', repeat=None) +@deprecated_args(number='total', mode='logtype', repeat=True) def LogeventsPageGenerator(logtype: Optional[str] = None, user: Optional[str] = None, site=None, namespace: Optional[int] = None, @@ -1372,8 +1372,8 @@ pywikibot.exception(e)
-@deprecated_args(number='total', step=None, namespace='namespaces', - repeat=None, get_redirect=None) +@deprecated_args(number='total', step=True, namespace='namespaces', + repeat=True, get_redirect=True) def NewpagesPageGenerator(site=None, namespaces=(0, ), total: Optional[int] = None): """ @@ -1415,7 +1415,7 @@
@deprecated('site.unconnected_pages()', since='20180512') -@deprecated_args(step=None) +@deprecated_args(step=True) def UnconnectedPageGenerator(site=None, total: Optional[int] = None): """ Iterate Page objects for all unconnected pages to a Wikibase repository. @@ -1432,7 +1432,7 @@
@deprecated('File.usingPages()', since='20200515') -@deprecated_args(referredImagePage='referredFilePage', step=None) +@deprecated_args(referredImagePage='referredFilePage', step=True) def FileLinksGenerator(referredFilePage, total=None, content=False): """DEPRECATED. Yield Pages on which referredFilePage file is displayed.""" return referredFilePage.usingPages(total=total, @@ -1440,7 +1440,7 @@
@deprecated('Page.imagelinks()', since='20200515') -@deprecated_args(step=None) +@deprecated_args(step=True) def ImagesPageGenerator(pageWithImages, total=None, content=False): """DEPRECATED. Yield FilePages displayed on pageWithImages.""" return pageWithImages.imagelinks(total=total, @@ -1452,7 +1452,7 @@ return (pywikibot.Page(link) for link in page.interwiki())
-@deprecated_args(step=None) +@deprecated_args(step=True) def LanguageLinksPageGenerator(page, total=None): """Iterate over all interwiki language links on a page.""" return (pywikibot.Page(link) for link in page.iterlanglinks(total=total)) @@ -1460,7 +1460,7 @@
@deprecated('Page.getReferences(follow_redirects=False)', since='20200515', future_warning=True) -@deprecated_args(step=None) +@deprecated_args(step=True) def ReferringPageGenerator(referredPage, followRedirects=False, withTemplateInclusion=True, onlyTemplateInclusion=False, @@ -1473,7 +1473,7 @@ total=total, content=content)
-@deprecated_args(step=None) +@deprecated_args(step=True) def CategorizedPageGenerator(category, recurse=False, start=None, total=None, content=False, namespaces=None): @@ -1501,7 +1501,7 @@ yield from category.articles(**kwargs)
-@deprecated_args(step=None) +@deprecated_args(step=True) def SubCategoriesPageGenerator(category, recurse=False, start=None, total=None, content=False): """Yield all subcategories in a specific category. @@ -1526,7 +1526,7 @@
@deprecated('Page.linkedPages()', since='20200515') -@deprecated_args(step=None) +@deprecated_args(step=True) def LinkedPageGenerator(linkingPage, total: int = None, content: bool = False): """DEPRECATED. Yield all pages linked from a specific page.
@@ -1618,7 +1618,7 @@ return site.load_pages_from_pageids(pageids)
-@deprecated_args(number='total', step=None) +@deprecated_args(number='total', step=True) def UserContributionsGenerator(username, namespaces: List[int] = None, site=None, total: Optional[int] = None, _filter_unique=_filter_unique_pages): @@ -1921,7 +1921,7 @@ yield page
-@deprecated_args(site=None, since='20201107') +@deprecated_args(site=True) def CategoryFilterPageGenerator(generator, category_list): """ Wrap a generator to filter pages by categories specified. @@ -2129,7 +2129,7 @@ yield from reversed(list(filtered_generator()))
-@deprecated_args(pageNumber='groupsize', step='groupsize', lookahead=None) +@deprecated_args(pageNumber='groupsize', step='groupsize', lookahead=True) def PreloadingGenerator(generator, groupsize: int = 50): """ Yield preloaded pages taken from another generator. @@ -2195,7 +2195,7 @@ yield from repo.preload_entities(pages, groupsize)
-@deprecated_args(number='total', step=None, repeat=None) +@deprecated_args(number='total', step=True, repeat=True) def NewimagesPageGenerator(total: Optional[int] = None, site=None): """ New file generator. @@ -2262,7 +2262,7 @@
@deprecated('Site.unusedfiles()', since='20200515') -@deprecated_args(extension=None, number='total', repeat=None) +@deprecated_args(extension=True, number='total', repeat=True) def UnusedFilesGenerator(total: Optional[int] = None, site=None): # pragma: no cover """ @@ -2278,7 +2278,7 @@
@deprecated('Site.withoutinterwiki()', since='20200515') -@deprecated_args(number='total', repeat=None) +@deprecated_args(number='total', repeat=True) def WithoutInterwikiPageGenerator(total=None, site=None): # pragma: no cover """ DEPRECATED. Page lacking interwikis generator. @@ -2293,7 +2293,7 @@
@deprecated('Site.uncategorizedcategories()', since='20200515') -@deprecated_args(number='total', repeat=None) +@deprecated_args(number='total', repeat=True) def UnCategorizedCategoryGenerator(total: Optional[int] = 100, site=None): # pragma: no cover """ @@ -2309,7 +2309,7 @@
@deprecated('Site.uncategorizedimages()', since='20200515') -@deprecated_args(number='total', repeat=None) +@deprecated_args(number='total', repeat=True) def UnCategorizedImageGenerator(total: int = 100, site=None): # pragma: no cover """ @@ -2325,7 +2325,7 @@
@deprecated('Site.uncategorizedpages()', since='20200515') -@deprecated_args(number='total', repeat=None) +@deprecated_args(number='total', repeat=True) def UnCategorizedPageGenerator(total: int = 100, site=None): # pragma: no cover """ @@ -2341,7 +2341,7 @@
@deprecated('Site.uncategorizedtemplates()', since='20200515') -@deprecated_args(number='total', repeat=None) +@deprecated_args(number='total', repeat=True) def UnCategorizedTemplateGenerator(total: int = 100, site=None): # pragma: no cover """ @@ -2357,7 +2357,7 @@
@deprecated('Site.lonelypages()', since='20200515') -@deprecated_args(number='total', repeat=None) +@deprecated_args(number='total', repeat=True) def LonelyPagesPageGenerator(total: Optional[int] = None, site=None): # pragma: no cover """ @@ -2373,7 +2373,7 @@
@deprecated('Site.unwatchedpages()', since='20200515') -@deprecated_args(number='total', repeat=None) +@deprecated_args(number='total', repeat=True) def UnwatchedPagesPageGenerator(total: Optional[int] = None, site=None): # pragma: no cover """ @@ -2418,7 +2418,7 @@ return site.wantedpages(total=total)
-@deprecated_args(number='total', repeat=None) +@deprecated_args(number='total', repeat=True) def AncientPagesPageGenerator(total: int = 100, site=None): # pragma: no cover """ Ancient page generator. @@ -2433,7 +2433,7 @@
@deprecated('Site.deadendpages()', since='20200515') -@deprecated_args(number='total', repeat=None) +@deprecated_args(number='total', repeat=True) def DeadendPagesPageGenerator(total: int = 100, site=None): # pragma: no cover """ DEPRECATED. Dead-end page generator. @@ -2447,7 +2447,7 @@ return site.deadendpages(total=total)
-@deprecated_args(number='total', repeat=None) +@deprecated_args(number='total', repeat=True) def LongPagesPageGenerator(total: int = 100, site=None): """ Long page generator. @@ -2461,7 +2461,7 @@ return (page for page, _ in site.longpages(total=total))
-@deprecated_args(number='total', repeat=None) +@deprecated_args(number='total', repeat=True) def ShortPagesPageGenerator(total: int = 100, site=None): """ Short page generator. @@ -2509,7 +2509,7 @@
@deprecated('Site.exturlusage()', since='20200515') -@deprecated_args(link='url', euprotocol='protocol', step=None) +@deprecated_args(link='url', euprotocol='protocol', step=True) def LinksearchPageGenerator(url: str, namespaces: List[int] = None, total: Optional[int] = None, site=None, protocol: Optional[str] = None): @@ -2532,7 +2532,7 @@
@deprecated('Site.search()', since='20200515') -@deprecated_args(number='total', step=None) +@deprecated_args(number='total', step=True) def SearchPageGenerator(query, total: Optional[int] = None, namespaces=None, site=None): # pragma: no cover """ diff --git a/pywikibot/site/_apisite.py b/pywikibot/site/_apisite.py index 9619c38..a06b585 100644 --- a/pywikibot/site/_apisite.py +++ b/pywikibot/site/_apisite.py @@ -212,7 +212,7 @@ return pywikibot.Site(url=site['url'] + '/w/index.php') raise ValueError('Cannot parse a site out of %s.' % dbname)
- @deprecated_args(step=None) + @deprecated_args(step=True) def _generator(self, gen_class, type_arg: Optional[str] = None, namespaces=None, total: Optional[int] = None, **args): """Convenience method that returns an API generator. @@ -662,7 +662,7 @@
return OrderedDict((key, _mw_msg_cache[amlang][key]) for key in keys)
- @deprecated_args(forceReload=None) + @deprecated_args(forceReload=True) def mediawiki_message(self, key, lang=None) -> str: """Fetch the text for a MediaWiki message.
diff --git a/pywikibot/site/_extensions.py b/pywikibot/site/_extensions.py index 928d902..4541fe9 100644 --- a/pywikibot/site/_extensions.py +++ b/pywikibot/site/_extensions.py @@ -230,7 +230,7 @@
"""APISite mixin for WikibaseClient extension."""
- @deprecated_args(step=None) + @deprecated_args(step=True) @need_extension('WikibaseClient') def unconnected_pages(self, total=None): """Yield Page objects from Special:UnconnectedPages. diff --git a/pywikibot/site/_generators.py b/pywikibot/site/_generators.py index 7805390..018b5d2 100644 --- a/pywikibot/site/_generators.py +++ b/pywikibot/site/_generators.py @@ -271,7 +271,7 @@ return itertools.chain(*genlist.values()) return blgen
- @deprecated_args(step=None, filterRedirects='filter_redirects') + @deprecated_args(step=True, filterRedirects='filter_redirects') def page_embeddedin(self, page, *, filter_redirects=None, namespaces=None, total=None, content=False): """Iterate all pages that embedded the given page as a template. @@ -346,7 +346,7 @@ namespaces=namespaces, content=content) ), total)
- @deprecated_args(step=None) + @deprecated_args(step=True) def pagelinks(self, page, *, namespaces=None, follow_redirects=False, total=None, content=False): """Iterate internal wikilinks contained (or transcluded) on page. @@ -378,7 +378,7 @@ **plargs)
# Sortkey doesn't work with generator - @deprecated_args(withSortKey=None, step=None) + @deprecated_args(withSortKey=True, step=True) def pagecategories(self, page, *, total=None, content=False): """Iterate categories to which page belongs.
@@ -398,7 +398,7 @@ type_arg='categories', total=total, g_content=content, **clargs)
- @deprecated_args(step=None) + @deprecated_args(step=True) def pageimages(self, page, *, total=None, content=False): """Iterate images used (not just linked) on the page.
@@ -414,7 +414,7 @@ titles=imtitle, total=total, g_content=content)
- @deprecated_args(step=None) + @deprecated_args(step=True) def pagetemplates(self, page, *, namespaces=None, total=None, content=False): """Iterate templates transcluded (not just linked) on the page. @@ -437,7 +437,7 @@ titles=tltitle, namespaces=namespaces, total=total, g_content=content)
- @deprecated_args(step=None, startsort=None, endsort=None) + @deprecated_args(step=True, startsort=True, endsort=True) def categorymembers(self, category, *, namespaces=None, sortby: Optional[str] = None, @@ -598,7 +598,7 @@ props.append('roles') return props
- @deprecated_args(getText='content', sysop=None) + @deprecated_args(getText='content', sysop=True) @remove_last_args(['rollback']) def loadrevisions(self, page, *, content=False, section=None, **kwargs): """Retrieve revision information and store it in page object. @@ -726,7 +726,7 @@ raise NoPage(page) api.update_page(page, pagedata, rvgen.props)
- @deprecated_args(step=None) + @deprecated_args(step=True) def pagelanglinks(self, page, *, total=None, include_obsolete=False): """Iterate all interlanguage links on page, yielding Link objects.
@@ -754,7 +754,7 @@
yield link
- @deprecated_args(step=None) + @deprecated_args(step=True) def page_extlinks(self, page, *, total=None): """Iterate all external links on page, yielding URL strings.
@@ -772,7 +772,7 @@ for linkdata in pageitem['extlinks']: yield linkdata['*']
- @deprecated_args(throttle=None, limit='total', step=None, + @deprecated_args(throttle=True, limit='total', step=True, includeredirects='filterredir') def allpages(self, start='!', prefix='', namespace=0, filterredir=None, filterlanglinks=None, minsize=None, maxsize=None, @@ -847,7 +847,7 @@ apgen.request['gapdir'] = 'descending' return apgen
- @deprecated_args(step=None) + @deprecated_args(step=True) def alllinks(self, start='!', prefix='', namespace=0, unique=False, fromids=False, total=None): """Iterate all links to pages (which need not exist) in one namespace. @@ -886,7 +886,7 @@ p._fromid = link['fromid'] yield p
- @deprecated_args(step=None) + @deprecated_args(step=True) def allcategories(self, start='!', prefix='', total=None, reverse=False, content=False): """Iterate categories used (which need not have a Category page). @@ -914,7 +914,7 @@ acgen.request['gacdir'] = 'descending' return acgen
- @deprecated_args(step=None) + @deprecated_args(step=True) def botusers(self, total=None): """Iterate bot users.
@@ -932,7 +932,7 @@
yield from self._bots.values()
- @deprecated_args(step=None) + @deprecated_args(step=True) def allusers(self, start='!', prefix='', group=None, total=None): """Iterate registered users, ordered by username.
@@ -958,7 +958,7 @@ augen.request['augroup'] = group return augen
- @deprecated_args(step=None) + @deprecated_args(step=True) def allimages(self, start='!', prefix='', minsize=None, maxsize=None, reverse=False, sha1=None, sha1base36=None, total=None, content=False): @@ -1029,7 +1029,7 @@ fagen.request['fadir'] = 'descending' return fagen
- @deprecated_args(step=None) + @deprecated_args(step=True) def blocks(self, starttime=None, endtime=None, reverse=False, blockids=None, users=None, iprange: Optional[str] = None, total: Optional[int] = None): @@ -1086,7 +1086,7 @@ bkgen.request['bkip'] = iprange return bkgen
- @deprecated_args(step=None) + @deprecated_args(step=True) def exturlusage(self, url: Optional[str] = None, protocol: Optional[str] = None, namespaces=None, total: Optional[int] = None, content=False): @@ -1125,7 +1125,7 @@ namespaces=namespaces, total=total, g_content=content)
- @deprecated_args(step=None) + @deprecated_args(step=True) def imageusage(self, image, namespaces=None, filterredir=None, total=None, content=False): """Iterate Pages that contain links to the given FilePage. @@ -1155,7 +1155,7 @@ namespaces=namespaces, total=total, g_content=content, **iuargs)
- @deprecated_args(step=None) + @deprecated_args(step=True) def logevents(self, logtype: Optional[str] = None, user: Optional[str] = None, page=None, namespace=None, start=None, end=None, @@ -1308,8 +1308,8 @@ rcgen.request['rctag'] = tag return rcgen
- @deprecated_args(number='total', step=None, key='searchstring', - getredirects=True, get_redirects=None) + @deprecated_args(number='total', step=True, key='searchstring', + getredirects=True, get_redirects=True) def search(self, searchstring: str, *, namespaces=None, where: str = 'text', @@ -1364,7 +1364,7 @@ total=total, g_content=content) return srgen
- @deprecated_args(step=None, showMinor='minor') + @deprecated_args(step=True, showMinor='minor') def usercontribs(self, user=None, userprefix=None, start=None, end=None, reverse=False, namespaces=None, minor=None, total: Optional[int] = None, top_only=False): @@ -1421,7 +1421,7 @@ ucgen.request['ucshow'] = option_set return ucgen
- @deprecated_args(step=None, showMinor='minor', showAnon='anon', + @deprecated_args(step=True, showMinor='minor', showAnon='anon', showBot='bot') def watchlist_revs(self, start=None, end=None, reverse=False, namespaces=None, minor=None, bot=None, @@ -1487,7 +1487,7 @@ or self.has_right('undelete'))): raise UserRightsError(err + 'deleted content.')
- @deprecated_args(step=None, get_text='content', page='titles', + @deprecated_args(step=True, get_text='content', page='titles', limit='total') def deletedrevs(self, titles=None, start=None, end=None, reverse: bool = False, @@ -1667,7 +1667,7 @@ 'ususers': usernames, 'usprop': usprop}) return usgen
- @deprecated_args(step=None) + @deprecated_args(step=True) def randompages(self, total=None, namespaces=None, redirects=False, content=False): """Iterate a number of random pages. @@ -1724,7 +1724,7 @@ }
@need_right('patrol') - @deprecated_args(token=None) + @deprecated_args(token=True) def patrol(self, rcid=None, revid=None, revision=None): """Return a generator of patrolled pages.
@@ -1806,8 +1806,8 @@
yield result['patrol']
- @deprecated_args(number='total', repeat=None, namespace='namespaces', - rcshow=None, rc_show=None, get_redirect=None, step=None, + @deprecated_args(number='total', repeat=True, namespace='namespaces', + rcshow=True, rc_show=True, get_redirect=True, step=True, showBot='bot', showRedirects='redirect', showPatrolled='patrolled') def newpages(self, user=None, returndict=False, @@ -1855,8 +1855,8 @@ '', pageitem['user'], pageitem['comment'])
@deprecated('APISite.logevents(logtype="upload")', since='20170619') - @deprecated_args(lestart='start', leend='end', leuser='user', letitle=None, - repeat=None, number='total', step=None) + @deprecated_args(lestart='start', leend='end', leuser='user', letitle=True, + repeat=True, number='total', step=True) def newfiles(self, user=None, start=None, end=None, reverse=False, total=None): """Yield information about newly uploaded files. @@ -1877,7 +1877,7 @@ comment = event.comment() or '' yield (filepage, date, user, comment)
- def querypage(self, special_page, total=None): + def querypage(self, special_page, total=True): """Yield Page objects retrieved from Special:{special_page}.
@see: U{https://www.mediawiki.org/wiki/API:Querypage%7D @@ -1896,7 +1896,7 @@ type_arg='querypage', gqppage=special_page, total=total)
- @deprecated_args(number='total', step=None, repeat=None) + @deprecated_args(number='total', step=True, repeat=True) def longpages(self, total=None): """Yield Pages and lengths from Special:Longpages.
@@ -1911,7 +1911,7 @@ yield (pywikibot.Page(self, pageitem['title']), int(pageitem['value']))
- @deprecated_args(number='total', step=None, repeat=None) + @deprecated_args(number='total', step=True, repeat=True) def shortpages(self, total=None): """Yield Pages and lengths from Special:Shortpages.
@@ -1926,7 +1926,7 @@ yield (pywikibot.Page(self, pageitem['title']), int(pageitem['value']))
- @deprecated_args(number='total', step=None, repeat=None) + @deprecated_args(number='total', step=True, repeat=True) def deadendpages(self, total=None): """Yield Page objects retrieved from Special:Deadendpages.
@@ -1934,7 +1934,7 @@ """ return self.querypage('Deadendpages', total)
- @deprecated_args(number='total', step=None, repeat=None) + @deprecated_args(number='total', step=True, repeat=True) def ancientpages(self, total=None): """Yield Pages, datestamps from Special:Ancientpages.
@@ -1947,7 +1947,7 @@ yield (pywikibot.Page(self, pageitem['title']), pywikibot.Timestamp.fromISOformat(pageitem['timestamp']))
- @deprecated_args(number='total', step=None, repeat=None) + @deprecated_args(number='total', step=True, repeat=True) def lonelypages(self, total=None): """Yield Pages retrieved from Special:Lonelypages.
@@ -1955,7 +1955,7 @@ """ return self.querypage('Lonelypages', total)
- @deprecated_args(number='total', step=None, repeat=None) + @deprecated_args(number='total', step=True, repeat=True) def unwatchedpages(self, total=None): """Yield Pages from Special:Unwatchedpages (requires Admin privileges).
@@ -1963,7 +1963,7 @@ """ return self.querypage('Unwatchedpages', total)
- @deprecated_args(step=None) + @deprecated_args(step=True) def wantedpages(self, total=None): """Yield Pages from Special:Wantedpages.
@@ -1985,7 +1985,7 @@ """ return self.querypage('Wantedtemplates', total)
- @deprecated_args(number='total', step=None, repeat=None) + @deprecated_args(number='total', step=True, repeat=True) def wantedcategories(self, total=None): """Yield Pages from Special:Wantedcategories.
@@ -1993,7 +1993,7 @@ """ return self.querypage('Wantedcategories', total)
- @deprecated_args(number='total', step=None, repeat=None) + @deprecated_args(number='total', step=True, repeat=True) def uncategorizedcategories(self, total=None): """Yield Categories from Special:Uncategorizedcategories.
@@ -2001,7 +2001,7 @@ """ return self.querypage('Uncategorizedcategories', total)
- @deprecated_args(number='total', step=None, repeat=None) + @deprecated_args(number='total', step=True, repeat=True) def uncategorizedimages(self, total=None): """Yield FilePages from Special:Uncategorizedimages.
@@ -2012,7 +2012,7 @@ # synonym uncategorizedfiles = uncategorizedimages
- @deprecated_args(number='total', step=None, repeat=None) + @deprecated_args(number='total', step=True, repeat=True) def uncategorizedpages(self, total=None): """Yield Pages from Special:Uncategorizedpages.
@@ -2020,7 +2020,7 @@ """ return self.querypage('Uncategorizedpages', total)
- @deprecated_args(number='total', step=None, repeat=None) + @deprecated_args(number='total', step=True, repeat=True) def uncategorizedtemplates(self, total=None): """Yield Pages from Special:Uncategorizedtemplates.
@@ -2028,7 +2028,7 @@ """ return self.querypage('Uncategorizedtemplates', total)
- @deprecated_args(number='total', step=None, repeat=None) + @deprecated_args(number='total', step=True, repeat=True) def unusedcategories(self, total=None): """Yield Category objects from Special:Unusedcategories.
@@ -2036,7 +2036,7 @@ """ return self.querypage('Unusedcategories', total)
- @deprecated_args(extension=None, number='total', step=None, repeat=None) + @deprecated_args(extension=True, number='total', step=True, repeat=True) def unusedfiles(self, total=None): """Yield FilePage objects from Special:Unusedimages.
@@ -2044,7 +2044,7 @@ """ return self.querypage('Unusedimages', total)
- @deprecated_args(number='total', step=None, repeat=None) + @deprecated_args(number='total', step=True, repeat=True) def withoutinterwiki(self, total=None): """Yield Pages without language links from Special:Withoutinterwiki.
@@ -2052,7 +2052,7 @@ """ return self.querypage('Withoutinterwiki', total)
- @deprecated_args(step=None) + @deprecated_args(step=True) def broken_redirects(self, total=None): """Yield Pages with broken redirects from Special:BrokenRedirects.
@@ -2060,7 +2060,7 @@ """ return self.querypage('BrokenRedirects', total)
- @deprecated_args(step=None) + @deprecated_args(step=True) def double_redirects(self, total=None): """Yield Pages with double redirects from Special:DoubleRedirects.
@@ -2068,7 +2068,7 @@ """ return self.querypage('DoubleRedirects', total)
- @deprecated_args(step=None) + @deprecated_args(step=True) def redirectpages(self, total=None): """Yield redirect pages from Special:ListRedirects.
@@ -2125,7 +2125,7 @@ return self._generator(api.PageGenerator, type_arg='pageswithprop', gpwppropname=propname, total=total)
- @deprecated_args(step=None, sysop=None) + @deprecated_args(step=True, sysop=True) def watched_pages(self, force=False, total=None): """ Return watchlist. diff --git a/pywikibot/textlib.py b/pywikibot/textlib.py index 83f8872..bec8d82 100644 --- a/pywikibot/textlib.py +++ b/pywikibot/textlib.py @@ -937,7 +937,7 @@ # do not find or change links of other kinds, nor any that are formatted # as in-line interwiki links (e.g., "[[:es:Artículo]]".
-@deprecate_arg('pageLink', None) +@deprecate_arg('pageLink', True) def getLanguageLinks(text: str, insite=None, template_subpage=False) -> dict: """ Return a dict of inter-language links found in text. diff --git a/pywikibot/titletranslate.py b/pywikibot/titletranslate.py index e042929..fd0916a 100644 --- a/pywikibot/titletranslate.py +++ b/pywikibot/titletranslate.py @@ -1,6 +1,6 @@ """Title translate module.""" # -# (C) Pywikibot team, 2003-2020 +# (C) Pywikibot team, 2003-2021 # # Distributed under the terms of the MIT license. # @@ -11,7 +11,7 @@ from pywikibot.tools import deprecated_args
-@deprecated_args(family=None) +@deprecated_args(family=True) def translate(page=None, hints=(), auto=True, removebrackets=False, site=None) -> list: """ diff --git a/scripts/category.py b/scripts/category.py index 772b575..e9c4ddf 100755 --- a/scripts/category.py +++ b/scripts/category.py @@ -403,7 +403,7 @@
"""A robot to mass-add a category to a list of pages."""
- @deprecated_args(editSummary='comment', dry=None) + @deprecated_args(editSummary='comment', dry=True) def __init__(self, generator, newcat=None, sort_by_last_name=False, create=False, comment='', follow_redirects=False) -> None: """Initializer."""
pywikibot-commits@lists.wikimedia.org