On Wed, Dec 23, 2015 at 9:15 AM, John Doe <rawzausho(a)gmail.com> wrote:
This task is set for the Google Code-In. It appears
that none of the methods
have a link to Mediawiki in the docstring. Is this correct?
We do not have many, but there are some, using different syntax style.
$ git grep --context=5 mediawiki.org.*API: pywikibot/site.py
pywikibot/site.py- @type expiry: int (days),
L{datetime.timedelta}, False (config)
pywikibot/site.py- @return: A dictionary with the properties of
the site. Each entry in
pywikibot/site.py- the dictionary is a tuple of the value
and a boolean to save if it
pywikibot/site.py- is the default value.
pywikibot/site.py- @rtype: dict (the values)
pywikibot/site.py: @see:
U{https://www.mediawiki.org/wiki/API:Meta#siteinfo_.2F_si}
pywikibot/site.py- """
pywikibot/site.py- def warn_handler(mod, message):
pywikibot/site.py- """Return True if the warning is
handled."""
pywikibot/site.py- matched = Siteinfo.WARNING_REGEX.match(message)
pywikibot/site.py- if mod == 'siteinfo' and matched:
--
pywikibot/site.py- """Iterate all current blocks, in order of
creation.
pywikibot/site.py-
pywikibot/site.py- Note that logevents only logs user blocks,
while this method
pywikibot/site.py- iterates all blocks including IP ranges.
The iterator yields dicts
pywikibot/site.py- containing keys corresponding to the block properties
pywikibot/site.py: (see
L{https://www.mediawiki.org/wiki/API:Blocks}).
pywikibot/site.py-
pywikibot/site.py- @param starttime: start iterating at this Timestamp
pywikibot/site.py- @param endtime: stop iterating at this Timestamp
pywikibot/site.py- @param reverse: if True, iterate oldest
blocks first (default: newest)
pywikibot/site.py- @param blockids: only iterate blocks with
these id numbers
--
pywikibot/site.py- # null edit, page not changed
pywikibot/site.py- pywikibot.log(u"Page [[%s]]
saved without any changes."
pywikibot/site.py- % page.title())
pywikibot/site.py- return True
pywikibot/site.py- page.latest_revision_id =
result["edit"]["newrevid"]
pywikibot/site.py: # see
https://www.mediawiki.org/wiki/API:Wikimania_2006_API_discussion#Notes
pywikibot/site.py- # not safe to assume that saved text
is the same as sent
pywikibot/site.py- del page.text
pywikibot/site.py- return True
pywikibot/site.py- elif result["edit"]["result"] ==
"Failure":
pywikibot/site.py- if "captcha" in result["edit"]:
--
pywikibot/site.py- def patrol(self, rcid=None, revid=None, revision=None):
pywikibot/site.py- """Return a generator of patrolled pages.
pywikibot/site.py-
pywikibot/site.py- Pages to be patrolled are identified by
rcid, revid or revision.
pywikibot/site.py- At least one of the parameters is mandatory.
pywikibot/site.py: See
https://www.mediawiki.org/wiki/API:Patrol.
pywikibot/site.py-
pywikibot/site.py- @param rcid: an int/string/iterable/iterator
providing rcid of pages
pywikibot/site.py- to be patrolled.
pywikibot/site.py- @type rcid: iterable/iterator which returns
a number or string which
pywikibot/site.py- contains only digits; it also supports
a string (as above) or int
--
pywikibot/site.py- reattempting to upload the file. NOTE:
If report_success is True or
pywikibot/site.py- None it'll raise an UploadWarning
exception if the static boolean is
pywikibot/site.py- False.
pywikibot/site.py- @type ignore_warnings: bool or callable or
iterable of str
pywikibot/site.py- @param chunk_size: The chunk size in
bytesfor chunked uploading (see
pywikibot/site.py:
U{https://www.mediawiki.org/wiki/API:Upload#Chunked_uploading}). It
pywikibot/site.py- will only upload in chunks, if the
version number is 1.20 or higher
pywikibot/site.py- and the chunk size is positive but lower
than the file size.
pywikibot/site.py- @type chunk_size: int
pywikibot/site.py- @param _file_key: Reuses an already uploaded
file using the filekey. If
pywikibot/site.py- None (default) it will upload the file.
--
John Vandenberg