Tool:DrTrigonBot

From Wikitech
Jump to: navigation, search
Pwb icon.svg

This bot is part of the mw:Pywikibot framework for MediaWiki Wikipedias.

Please consult /Migration from TS and /HowTo and Information as well. For developer the /ToDo list might be interesting.

Information

project: tools (bots obsolete)
instances: Nova Resource:Tools#Instances for this project
server: http://tools.wmflabs.org/?status , http://ganglia.wmflabs.org/latest/, (TS CRON load: cron jobs sh)
directory: /data/project/drtrigonbot
SUL account: DrTrigonBot (active on several wikis, e.g. dewiki, enwiki, commons, wikidata, meta)
operator: User:DrTrigon
status: panellogs (see explanation)

panellogs (on TS)

license[1][2]:
 i) Generally: http://opensource.org/licenses/GPL-3.0
ii) Used libraries might be licensed different but compatible, e.g.: MIT
    (check mw:Manual:Pywikibot/Installation#Dependencies)

DrTrigonBot runs parts of the Pywikibot repertory in order to work on
jobs and own tasks as defined on its wiki pages.
Copyright (C) 2013 DrTrigon (and the Pywikibot team)

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.
software: #Setup pywikibot on Labs#Setup drtrigonbot
tracker: bugzilla (open)

Web scripts and tools

Local list of tools and the most recent list for DrTrigonBot.

web scripts and tools for DrTrigonBot
DrTrigonBot status panel English DrTrigonBot status panel is a data extracting-tool, which is used as helper for DrTrigonBot. It displays the current state or healthy of the bot. (the signal is green if the bot works as expected and turns red if it is down, see explanation)
DrTrigonBot subster simulation panel English DrTrigonBot subster simulation panel is a simulation-tool, which is used as helper for DrTrigonBot. It simulates the behaviour of the template used to activate the subster (sub) bot. It access the online productive bot code, the same that is runned for the bot (no emulation).
DrTrigonBot subster mail queue English
DrTrigonBot category discussion summary English DrTrigonBot category discussion summary is a data extracting-tool, which is used as helper for DrTrigonBot. It summarizes categories' discussions by following recursively all categories down the tree and listing all contained pages that were changed during a given period of time.
DrTrigonBot info panel English
web scripts and tools for general purpose
XSaLT: XSL/XSLT Simple and Lightweight Tool English XSaLT: XSL/XSLT Simple and Lightweight Tool is a data extracting-tool, which is used as helper for any XML content (like RSS feeds or else). It transforms any XML source document given by help of lxml XSLT processor according to given XSLT stylesheet into a resulting document. Available XSLT stylesheets are:
filter: Versatile/Generic (text) Page Filter Tool English
obsolete or experimental - not supported, use at own risk
Global Wiki API Version English Global Wiki API Version is a data extracting-tool, which is used as helper for MediaWiki API version determination. It displays the current version of several API modules from following wikis:
  • translatewiki.net
  • test.wikipedia.org
  • de.wikipedia.org
  • en.wikipedia.org
  • (others can easily be added, please report if you need another one!)
DrTrigonBot checksum checker English DrTrigonBot checksum checker is a data extracting-tool, which is used as helper for DrTrigonBot. It displays the current state of a wiki page section compared against a known (old) checksum to check if the section has changed. (experimental, look here for an example)
DrTrigonBot Discussion Summary MOST RECENT / LATEST English

Setup pywikibot on Labs

sources: gerrit
docs: Manual; all languages

Code; compat (coverage) • core n/a

maillist: Pywikipedia-l Archives

All important steps and infos to install pywikibot are given in mw:Manual:Pywikibot/Installation#Setup on Wikimedia Labs/Tool Labs server resp. in Nova Resource:Tools/Help#Setup pywikibot on Labs (locally).

For developer, the manual on how to clone the git repository from gerrit and setup review can be found at mw:Manual:Pywikipediabot/Gerrit#Example (step-by-step).

Setup drtrigonbot

sources: gerrit
docs: Manual; de | en

Code; -

maillist: -

In order to install drtrigonbot either to tool-labs or to the toolserver, use the fabfile available

https://phabricator.wikimedia.org/diffusion/PWDT/browse/master/fabfile.py

and follow the instructions given there:

HOW TO INSTALL DrTrigonBot TO TOOLSERVER AND/OR TOOL-LABS

1.) download and install git (and fabric)
2.) download the fabfile, e.g.:
    $ wget https://phabricator.wikimedia.org/diffusion/PWDT/browse/master/fabfile.py?view=raw
3.) run the fabfile:
    $ fab -H localhost install
4.) setup your config files by generating new or copying existing ones
5.) run the finalization:
    $ fab -H localhost backup

It will automatically clone the needed repos and setup the server home
directory in order to be able to run DrTrigonBot.

[...]

If you did not install fabric or it is not available because you do not have
permissions, you can use the following syntax alternatively:
$ python fabfile.py -H localhost cmd1[,cmd2,...]
instead of
$ fab -H localhost cmd1[,cmd2,...]

References

  1. OSI approved: http://opensource.org/licenses
  2. Various Licenses and Comments about Them: http://www.gnu.org/licenses/license-list.html