Source code for scripts.commons_link

# -*- coding: utf-8 -*-
Include Commons template in home wiki.

This bot functions mainly in the en.wikipedia, because it
compares the names of articles and category in English
language (standard language in Commons). If the name of
an article in Commons will not be in English but with
redirect, this also functions.


    python commons_link [action] [pagegenerator]

where action can be one of these

 * pages      : Run over articles, include {{commons}}
 * categories : Run over categories, include {{commonscat}}

and pagegenerator can be one of these:

# (C) Leonardo Gregianin, 2006
# (C) Pywikibot team, 2007-2019
# Distributed under the terms of the MIT license.
# Ported by Geoffrey "GEOFBOT" Mon for Google Code-In 2013
# User:Sn1per
from __future__ import absolute_import, division, unicode_literals

import re

import pywikibot

from pywikibot import textlib, pagegenerators, i18n, Bot

docuReplacements = {'&params;': pagegenerators.parameterHelp}  # noqa: N816

[docs]class CommonsLinkBot(Bot): """Commons linking bot."""
[docs] def __init__(self, generator, **kwargs): """Initializer.""" self.availableOptions.update({ 'action': None, }) super(CommonsLinkBot, self).__init__(**kwargs) self.generator = generator self.findTemplate = re.compile(r'\{\{[Ss]isterlinks') self.findTemplate2 = re.compile(r'\{\{[Cc]ommonscat') self.findTemplate3 = re.compile(r'\{\{[Cc]ommons')
[docs] def run(self): """Run the bot.""" if not all((self.getOption('action'), self.generator)): return catmode = (self.getOption('action') == 'categories') for page in self.generator: try: self.current_page = page commons = commonspage = getattr(pywikibot, ('Page', 'Category')[catmode] )(commons, page.title()) try: commonspage.get(get_redirect=True) pagetitle = commonspage.title(with_ns=not catmode) if page.title() == pagetitle: old_text = page.get() text = old_text # for Commons/Commonscat template s = s2 = getattr(self, 'findTemplate{}'.format( (2, 3)[catmode]).search(text)) if s or s2: pywikibot.output('** Already done.') else: cats = textlib.getCategoryLinks(text, text = textlib.replaceCategoryLinks( '%s{{commons%s|%s}}' % (text, ('', 'cat')[catmode], pagetitle), cats, comment = i18n.twtranslate(, 'commons_link{}-template-added' .format(('', '-cat')[catmode])) try: self.userPut(page, old_text, text, summary=comment) except pywikibot.EditConflict: pywikibot.output( 'Skipping {} because of edit conflict' .format(page.title())) except pywikibot.NoPage: pywikibot.output('{} does not exist in Commons' .format(page.__class__.__name__)) except pywikibot.NoPage: pywikibot.output('Page {} does not exist' .format(page.title())) except pywikibot.IsRedirectPage: pywikibot.output('Page {} is a redirect; skipping.' .format(page.title())) except pywikibot.LockedPage: pywikibot.output('Page {} is locked'.format(page.title()))
[docs]def main(*args): """ Process command line arguments and invoke bot. If args is an empty list, sys.argv is used. @param args: command line arguments @type args: str """ options = {} local_args = pywikibot.handle_args(args) gen_factory = pagegenerators.GeneratorFactory() for arg in local_args: if arg in ('pages', 'categories'): options['action'] = arg elif arg == '-always': options['always'] = True else: gen_factory.handleArg(arg) gen = gen_factory.getCombinedGenerator(preload=True) if'action' not in options, missing_generator=not gen): return bot = CommonsLinkBot(gen, **options)
if __name__ == '__main__': main()