jenkins-bot submitted this change.
[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(-)
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}
@@ -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."""
To view, visit change 680632. To unsubscribe, or for help writing mail filters, visit settings.