pywikibot-scripts


Namepywikibot-scripts JSON
Version 9.4.0 PyPI version JSON
download
home_pageNone
SummaryPywikibot Scripts Collection
upload_time2024-10-05 11:31:39
maintainerNone
docs_urlNone
authorNone
requires_python>=3.7.0
licenseMIT License
keywords add text archivebot basic bot client framework mediawiki pwb pybot python pywiki pywikibase pywikibot pywikipedia pywikipediabot replace redirect script scripts upload wiki wikibase wikidata wikimedia wikipedia
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage
            .. image:: https://img.shields.io/github/languages/top/wikimedia/pywikibot
   :alt: Top language
   :target: https://www.python.org/downloads/
.. image:: https://img.shields.io/github/last-commit/wikimedia/pywikibot
   :alt: Last commit
   :target: https://gerrit.wikimedia.org/r/plugins/gitiles/pywikibot/core/

###########################################################################
**This is a package to include robots for MediaWiki wikis like Wikipedia.**
###########################################################################

.. role:: api

*********************************
Some example robots are included.
*********************************

These programs can actually modify the live wiki on the net, and proper
wiki-etiquette should be followed before running it on any wiki.

To get started on proper usage of the bot framework, refer to `Manual:Pywikibot <https://www.mediawiki.org/wiki/Manual:Pywikibot>`_.

***************************
The contents of the package
***************************

Bots and scripts
================

+--------------------------+---------------------------------------------------------+
| Bots and Scripts                                                                   |
+==========================+=========================================================+
| add_text.py              | Adds text at the top or end of pages.                   |
+--------------------------+---------------------------------------------------------+
| archivebot.py            | Archives discussion threads.                            |
+--------------------------+---------------------------------------------------------+
| basic.py                 | Is a template from which simple bots can be made.       |
+--------------------------+---------------------------------------------------------+
| blockpagechecker.py      | Deletes any protection templates that are on pages      |
|                          | which aren't actually protected.                        |
+--------------------------+---------------------------------------------------------+
| category.py              | Add a category link to all pages mentioned on a page,   |
|                          | change or remove category tags.                         |
+--------------------------+---------------------------------------------------------+
| category_graph.py        | Visualizes category hierarchy                           |
+--------------------------+---------------------------------------------------------+
| category_redirect.py     | Maintain category redirects and replace links to        |
|                          | redirected categories.                                  |
+--------------------------+---------------------------------------------------------+
| change_pagelang.py       | Changes the content language of pages.                  |
+--------------------------+---------------------------------------------------------+
| checkimages.py           | Check recently uploaded files. Checks if a file         |
|                          | description is present and if there are other problems  |
|                          | in the image's description.                             |
+--------------------------+---------------------------------------------------------+
| claimit.py               | Adds claims to Wikidata items based on categories.      |
+--------------------------+---------------------------------------------------------+
| clean_sandbox.py         | This bot resets a sandbox with predefined text.         |
+--------------------------+---------------------------------------------------------+
| commonscat.py            | Adds {{commonscat}} to Wikipedia categories (or         |
|                          | articles), if other language Wikipedia already has such |
|                          | a template.                                             |
+--------------------------+---------------------------------------------------------+
| commons_information.py   | Insert a language template into the description field.  |
+--------------------------+---------------------------------------------------------+
| coordinate_import.py     | Coordinate importing script.                            |
+--------------------------+---------------------------------------------------------+
| cosmetic_changes.py      | Can do slight modifications to a wiki page source code  |
|                          | such that the code looks cleaner.                       |
+--------------------------+---------------------------------------------------------+
| data_ingestion.py        | A generic bot to do batch uploading to Commons.         |
+--------------------------+---------------------------------------------------------+
| delete.py                | This script can be used to delete pages en masse.       |
+--------------------------+---------------------------------------------------------+
| delinker.py              | Delink file references of deleted images.               |
+--------------------------+---------------------------------------------------------+
| djvutext.py              | Extracts OCR text from djvu files and uploads onto      |
|                          | pages in the "Page" namespace on Wikisource.            |
+--------------------------+---------------------------------------------------------+
| download_dump.py         | Downloads dumps from dumps.wikimedia.org                |
+--------------------------+---------------------------------------------------------+
| fixing_redirects.py      | Correct all redirect links of processed pages.          |
+--------------------------+---------------------------------------------------------+
| harvest_template.py      | Template harvesting script.                             |
+--------------------------+---------------------------------------------------------+
| illustrate_wikidata.py   | Bot to add images to Wikidata items.                    |
+--------------------------+---------------------------------------------------------+
| image.py                 | Script to replace transclusions of files.               |
+--------------------------+---------------------------------------------------------+
| imagetransfer.py         | Given a wiki page, check the interwiki links for        |
|                          | images, and let the user choose among them for          |
|                          | images to upload.                                       |
+--------------------------+---------------------------------------------------------+
| interwiki.py             | A robot to check interwiki links on all pages (or       |
|                          | a range of pages) of a wiki.                            |
+--------------------------+---------------------------------------------------------+
| interwikidata.py         | Script to handle interwiki links based on Wikibase.     |
+--------------------------+---------------------------------------------------------+
| listpages.py             | Print a list of pages, defined by a page generator.     |
+--------------------------+---------------------------------------------------------+
| misspelling.py           | Similar to solve_disambiguation.py. It is supposed to   |
|                          | fix links that contain common spelling mistakes.        |
+--------------------------+---------------------------------------------------------+
| movepages.py             | Bot that can move pages to another title.               |
+--------------------------+---------------------------------------------------------+
| newitem.py               | Script creates new items on Wikidata based on criteria. |
+--------------------------+---------------------------------------------------------+
| noreferences.py          | Searches for pages where <references /> is missing      |
|                          | although a <ref> tag is present, and in that case adds  |
|                          | a new references section.                               |
+--------------------------+---------------------------------------------------------+
| nowcommons.py            | This bot can delete images with NowCommons template.    |
+--------------------------+---------------------------------------------------------+
| pagefromfile.py          | This bot takes its input from a file that contains a    |
|                          | number of pages to be put on the wiki.                  |
+--------------------------+---------------------------------------------------------+
| parser_function_count.py | Find expensive templates that are subject to be         |
|                          | converted to Lua.                                       |
+--------------------------+---------------------------------------------------------+
| patrol.py                | Obtains a list pages and marks the edits as patrolled   |
|                          | based on a whitelist.                                   |
+--------------------------+---------------------------------------------------------+
| protect.py               | Protect and unprotect pages en masse.                   |
+--------------------------+---------------------------------------------------------+
| redirect.py              | Fix double redirects and broken redirects. Note:        |
|                          | solve_disambiguation also has functions which treat     |
|                          | redirects.                                              |
+--------------------------+---------------------------------------------------------+
| reflinks.py              | Search for references which are only made of a link     |
|                          | without title and fetch the html title from the link to |
|                          | use it as the title of the wiki link in the reference.  |
+--------------------------+---------------------------------------------------------+
| replace.py               | Search articles for a text and replace it by another    |
|                          | text. Both text are set in two configurable             |
|                          | text files. The bot can either work on a set of given   |
|                          | pages or crawl an SQL dump.                             |
+--------------------------+---------------------------------------------------------+
| replicate_wiki.py        | Replicates pages in wiki to a second wiki within family |
+--------------------------+---------------------------------------------------------+
| revertbot.py             | Script that can be used for reverting certain edits.    |
+--------------------------+---------------------------------------------------------+
| solve_disambiguation.py  | Interactive robot doing disambiguation.                 |
+--------------------------+---------------------------------------------------------+
| speedy_delete.py         | Help sysops to quickly check and/or delete pages listed |
|                          | for speedy deletion.                                    |
+--------------------------+---------------------------------------------------------+
| template.py              | Change one template (that is {{...}}) into another.     |
+--------------------------+---------------------------------------------------------+
| templatecount.py         | Display the list of pages transcluding a given list     |
|                          | of templates.                                           |
+--------------------------+---------------------------------------------------------+
| touch.py                 | Bot goes over all pages of the home wiki, and edits     |
|                          | them without changes.                                   |
+--------------------------+---------------------------------------------------------+
| transferbot.py           | Transfers pages from a source wiki to a target wiki.    |
+--------------------------+---------------------------------------------------------+
| transwikiimport.py       | Transfers pages from a source wiki to a target wiki     |
|                          | including edit history using :api:`Import`.             |
+--------------------------+---------------------------------------------------------+
| unusedfiles.py           | Bot appends some text to all unused images and other    |
|                          | text to the respective uploaders.                       |
+--------------------------+---------------------------------------------------------+
| unlink.py                | This bot unlinks a page on every page that links to it. |
+--------------------------+---------------------------------------------------------+
| upload.py                | Upload an image to a wiki.                              |
+--------------------------+---------------------------------------------------------+
| watchlists.py            | Allows access to the account's watchlist.               |
+--------------------------+---------------------------------------------------------+
| weblinkchecker.py        | Check if external links are still working.              |
+--------------------------+---------------------------------------------------------+
| welcome.py               | Script to welcome new users.                            |
+--------------------------+---------------------------------------------------------+

Maintenance
===========

+------------------------+---------------------------------------------------------+
| maintenance            | Framework helper scripts                                |
+========================+=========================================================+
| addwikis.py            | Script to add wikis to a family file.                   |
+------------------------+---------------------------------------------------------+
| cache.py               | Script for showing and deleting API cache.              |
+------------------------+---------------------------------------------------------+
| colors.py              | Utility to show pywikibot colors.                       |
+------------------------+---------------------------------------------------------+
| make_i18n_dict.py      | Generate an i18n file from a given script.              |
+------------------------+---------------------------------------------------------+
| unidata.py             | Updates _first_upper_exception_dict in tools.unidata    |
+------------------------+---------------------------------------------------------+


**External packages could be required with Pywikibot:**

The pwb.py wrapper scripts informs about the requirement and how to install.

More precise information, and a list of the options that are available for
the various programs, can be retrieved by running the bot with the -help
parameter, e.g.::

    python pwb.py interwiki -help

** Outdated and deleted scripts can be recovered.**
Refer `Outdated core scripts` and `Outdated compat scripts` in our documentation:
https://doc.wikimedia.org/pywikibot/master/scripts/index.html#script-descriptions

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "pywikibot-scripts",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.7.0",
    "maintainer_email": "The Pywikibot team <pywikibot@lists.wikimedia.org>",
    "keywords": "add text, archivebot, basic, bot, client, framework, mediawiki, pwb, pybot, python, pywiki, pywikibase, pywikibot, pywikipedia, pywikipediabot, replace, redirect, script, scripts, upload, wiki, wikibase, wikidata, wikimedia, wikipedia",
    "author": null,
    "author_email": "xqt <info@gno.de>",
    "download_url": null,
    "platform": null,
    "description": ".. image:: https://img.shields.io/github/languages/top/wikimedia/pywikibot\r\n   :alt: Top language\r\n   :target: https://www.python.org/downloads/\r\n.. image:: https://img.shields.io/github/last-commit/wikimedia/pywikibot\r\n   :alt: Last commit\r\n   :target: https://gerrit.wikimedia.org/r/plugins/gitiles/pywikibot/core/\r\n\r\n###########################################################################\r\n**This is a package to include robots for MediaWiki wikis like Wikipedia.**\r\n###########################################################################\r\n\r\n.. role:: api\r\n\r\n*********************************\r\nSome example robots are included.\r\n*********************************\r\n\r\nThese programs can actually modify the live wiki on the net, and proper\r\nwiki-etiquette should be followed before running it on any wiki.\r\n\r\nTo get started on proper usage of the bot framework, refer to `Manual:Pywikibot <https://www.mediawiki.org/wiki/Manual:Pywikibot>`_.\r\n\r\n***************************\r\nThe contents of the package\r\n***************************\r\n\r\nBots and scripts\r\n================\r\n\r\n+--------------------------+---------------------------------------------------------+\r\n| Bots and Scripts                                                                   |\r\n+==========================+=========================================================+\r\n| add_text.py              | Adds text at the top or end of pages.                   |\r\n+--------------------------+---------------------------------------------------------+\r\n| archivebot.py            | Archives discussion threads.                            |\r\n+--------------------------+---------------------------------------------------------+\r\n| basic.py                 | Is a template from which simple bots can be made.       |\r\n+--------------------------+---------------------------------------------------------+\r\n| blockpagechecker.py      | Deletes any protection templates that are on pages      |\r\n|                          | which aren't actually protected.                        |\r\n+--------------------------+---------------------------------------------------------+\r\n| category.py              | Add a category link to all pages mentioned on a page,   |\r\n|                          | change or remove category tags.                         |\r\n+--------------------------+---------------------------------------------------------+\r\n| category_graph.py        | Visualizes category hierarchy                           |\r\n+--------------------------+---------------------------------------------------------+\r\n| category_redirect.py     | Maintain category redirects and replace links to        |\r\n|                          | redirected categories.                                  |\r\n+--------------------------+---------------------------------------------------------+\r\n| change_pagelang.py       | Changes the content language of pages.                  |\r\n+--------------------------+---------------------------------------------------------+\r\n| checkimages.py           | Check recently uploaded files. Checks if a file         |\r\n|                          | description is present and if there are other problems  |\r\n|                          | in the image's description.                             |\r\n+--------------------------+---------------------------------------------------------+\r\n| claimit.py               | Adds claims to Wikidata items based on categories.      |\r\n+--------------------------+---------------------------------------------------------+\r\n| clean_sandbox.py         | This bot resets a sandbox with predefined text.         |\r\n+--------------------------+---------------------------------------------------------+\r\n| commonscat.py            | Adds {{commonscat}} to Wikipedia categories (or         |\r\n|                          | articles), if other language Wikipedia already has such |\r\n|                          | a template.                                             |\r\n+--------------------------+---------------------------------------------------------+\r\n| commons_information.py   | Insert a language template into the description field.  |\r\n+--------------------------+---------------------------------------------------------+\r\n| coordinate_import.py     | Coordinate importing script.                            |\r\n+--------------------------+---------------------------------------------------------+\r\n| cosmetic_changes.py      | Can do slight modifications to a wiki page source code  |\r\n|                          | such that the code looks cleaner.                       |\r\n+--------------------------+---------------------------------------------------------+\r\n| data_ingestion.py        | A generic bot to do batch uploading to Commons.         |\r\n+--------------------------+---------------------------------------------------------+\r\n| delete.py                | This script can be used to delete pages en masse.       |\r\n+--------------------------+---------------------------------------------------------+\r\n| delinker.py              | Delink file references of deleted images.               |\r\n+--------------------------+---------------------------------------------------------+\r\n| djvutext.py              | Extracts OCR text from djvu files and uploads onto      |\r\n|                          | pages in the \"Page\" namespace on Wikisource.            |\r\n+--------------------------+---------------------------------------------------------+\r\n| download_dump.py         | Downloads dumps from dumps.wikimedia.org                |\r\n+--------------------------+---------------------------------------------------------+\r\n| fixing_redirects.py      | Correct all redirect links of processed pages.          |\r\n+--------------------------+---------------------------------------------------------+\r\n| harvest_template.py      | Template harvesting script.                             |\r\n+--------------------------+---------------------------------------------------------+\r\n| illustrate_wikidata.py   | Bot to add images to Wikidata items.                    |\r\n+--------------------------+---------------------------------------------------------+\r\n| image.py                 | Script to replace transclusions of files.               |\r\n+--------------------------+---------------------------------------------------------+\r\n| imagetransfer.py         | Given a wiki page, check the interwiki links for        |\r\n|                          | images, and let the user choose among them for          |\r\n|                          | images to upload.                                       |\r\n+--------------------------+---------------------------------------------------------+\r\n| interwiki.py             | A robot to check interwiki links on all pages (or       |\r\n|                          | a range of pages) of a wiki.                            |\r\n+--------------------------+---------------------------------------------------------+\r\n| interwikidata.py         | Script to handle interwiki links based on Wikibase.     |\r\n+--------------------------+---------------------------------------------------------+\r\n| listpages.py             | Print a list of pages, defined by a page generator.     |\r\n+--------------------------+---------------------------------------------------------+\r\n| misspelling.py           | Similar to solve_disambiguation.py. It is supposed to   |\r\n|                          | fix links that contain common spelling mistakes.        |\r\n+--------------------------+---------------------------------------------------------+\r\n| movepages.py             | Bot that can move pages to another title.               |\r\n+--------------------------+---------------------------------------------------------+\r\n| newitem.py               | Script creates new items on Wikidata based on criteria. |\r\n+--------------------------+---------------------------------------------------------+\r\n| noreferences.py          | Searches for pages where <references /> is missing      |\r\n|                          | although a <ref> tag is present, and in that case adds  |\r\n|                          | a new references section.                               |\r\n+--------------------------+---------------------------------------------------------+\r\n| nowcommons.py            | This bot can delete images with NowCommons template.    |\r\n+--------------------------+---------------------------------------------------------+\r\n| pagefromfile.py          | This bot takes its input from a file that contains a    |\r\n|                          | number of pages to be put on the wiki.                  |\r\n+--------------------------+---------------------------------------------------------+\r\n| parser_function_count.py | Find expensive templates that are subject to be         |\r\n|                          | converted to Lua.                                       |\r\n+--------------------------+---------------------------------------------------------+\r\n| patrol.py                | Obtains a list pages and marks the edits as patrolled   |\r\n|                          | based on a whitelist.                                   |\r\n+--------------------------+---------------------------------------------------------+\r\n| protect.py               | Protect and unprotect pages en masse.                   |\r\n+--------------------------+---------------------------------------------------------+\r\n| redirect.py              | Fix double redirects and broken redirects. Note:        |\r\n|                          | solve_disambiguation also has functions which treat     |\r\n|                          | redirects.                                              |\r\n+--------------------------+---------------------------------------------------------+\r\n| reflinks.py              | Search for references which are only made of a link     |\r\n|                          | without title and fetch the html title from the link to |\r\n|                          | use it as the title of the wiki link in the reference.  |\r\n+--------------------------+---------------------------------------------------------+\r\n| replace.py               | Search articles for a text and replace it by another    |\r\n|                          | text. Both text are set in two configurable             |\r\n|                          | text files. The bot can either work on a set of given   |\r\n|                          | pages or crawl an SQL dump.                             |\r\n+--------------------------+---------------------------------------------------------+\r\n| replicate_wiki.py        | Replicates pages in wiki to a second wiki within family |\r\n+--------------------------+---------------------------------------------------------+\r\n| revertbot.py             | Script that can be used for reverting certain edits.    |\r\n+--------------------------+---------------------------------------------------------+\r\n| solve_disambiguation.py  | Interactive robot doing disambiguation.                 |\r\n+--------------------------+---------------------------------------------------------+\r\n| speedy_delete.py         | Help sysops to quickly check and/or delete pages listed |\r\n|                          | for speedy deletion.                                    |\r\n+--------------------------+---------------------------------------------------------+\r\n| template.py              | Change one template (that is {{...}}) into another.     |\r\n+--------------------------+---------------------------------------------------------+\r\n| templatecount.py         | Display the list of pages transcluding a given list     |\r\n|                          | of templates.                                           |\r\n+--------------------------+---------------------------------------------------------+\r\n| touch.py                 | Bot goes over all pages of the home wiki, and edits     |\r\n|                          | them without changes.                                   |\r\n+--------------------------+---------------------------------------------------------+\r\n| transferbot.py           | Transfers pages from a source wiki to a target wiki.    |\r\n+--------------------------+---------------------------------------------------------+\r\n| transwikiimport.py       | Transfers pages from a source wiki to a target wiki     |\r\n|                          | including edit history using :api:`Import`.             |\r\n+--------------------------+---------------------------------------------------------+\r\n| unusedfiles.py           | Bot appends some text to all unused images and other    |\r\n|                          | text to the respective uploaders.                       |\r\n+--------------------------+---------------------------------------------------------+\r\n| unlink.py                | This bot unlinks a page on every page that links to it. |\r\n+--------------------------+---------------------------------------------------------+\r\n| upload.py                | Upload an image to a wiki.                              |\r\n+--------------------------+---------------------------------------------------------+\r\n| watchlists.py            | Allows access to the account's watchlist.               |\r\n+--------------------------+---------------------------------------------------------+\r\n| weblinkchecker.py        | Check if external links are still working.              |\r\n+--------------------------+---------------------------------------------------------+\r\n| welcome.py               | Script to welcome new users.                            |\r\n+--------------------------+---------------------------------------------------------+\r\n\r\nMaintenance\r\n===========\r\n\r\n+------------------------+---------------------------------------------------------+\r\n| maintenance            | Framework helper scripts                                |\r\n+========================+=========================================================+\r\n| addwikis.py            | Script to add wikis to a family file.                   |\r\n+------------------------+---------------------------------------------------------+\r\n| cache.py               | Script for showing and deleting API cache.              |\r\n+------------------------+---------------------------------------------------------+\r\n| colors.py              | Utility to show pywikibot colors.                       |\r\n+------------------------+---------------------------------------------------------+\r\n| make_i18n_dict.py      | Generate an i18n file from a given script.              |\r\n+------------------------+---------------------------------------------------------+\r\n| unidata.py             | Updates _first_upper_exception_dict in tools.unidata    |\r\n+------------------------+---------------------------------------------------------+\r\n\r\n\r\n**External packages could be required with Pywikibot:**\r\n\r\nThe pwb.py wrapper scripts informs about the requirement and how to install.\r\n\r\nMore precise information, and a list of the options that are available for\r\nthe various programs, can be retrieved by running the bot with the -help\r\nparameter, e.g.::\r\n\r\n    python pwb.py interwiki -help\r\n\r\n** Outdated and deleted scripts can be recovered.**\r\nRefer `Outdated core scripts` and `Outdated compat scripts` in our documentation:\r\nhttps://doc.wikimedia.org/pywikibot/master/scripts/index.html#script-descriptions\r\n",
    "bugtrack_url": null,
    "license": "MIT License",
    "summary": "Pywikibot Scripts Collection",
    "version": "9.4.0",
    "project_urls": {
        "Changelog": "https://doc.wikimedia.org/pywikibot/master/changelog.html",
        "Documentation": "https://doc.wikimedia.org/pywikibot/stable/",
        "Download": "https://www.pywikibot.org",
        "GitHub Mirror": "https://github.com/wikimedia/pywikibot",
        "Homepage": "https://www.mediawiki.org/wiki/Manual:Pywikibot",
        "Repository": "https://gerrit.wikimedia.org/r/plugins/gitiles/pywikibot/core/",
        "Tracker": "https://phabricator.wikimedia.org/tag/pywikibot/"
    },
    "split_keywords": [
        "add text",
        " archivebot",
        " basic",
        " bot",
        " client",
        " framework",
        " mediawiki",
        " pwb",
        " pybot",
        " python",
        " pywiki",
        " pywikibase",
        " pywikibot",
        " pywikipedia",
        " pywikipediabot",
        " replace",
        " redirect",
        " script",
        " scripts",
        " upload",
        " wiki",
        " wikibase",
        " wikidata",
        " wikimedia",
        " wikipedia"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "27db889a3fdedf01a84dc5a10241f0ea74a48b3e42a8d6ffdbfa708823da266a",
                "md5": "59b1975615a8599e6f73cb2eecc90c3d",
                "sha256": "949d1386e6728bce2daba8ad4d3ceda4f321a23716b916ecac02f3f61e85f133"
            },
            "downloads": -1,
            "filename": "pywikibot_scripts-9.4.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "59b1975615a8599e6f73cb2eecc90c3d",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.7.0",
            "size": 2188378,
            "upload_time": "2024-10-05T11:31:39",
            "upload_time_iso_8601": "2024-10-05T11:31:39.729884Z",
            "url": "https://files.pythonhosted.org/packages/27/db/889a3fdedf01a84dc5a10241f0ea74a48b3e42a8d6ffdbfa708823da266a/pywikibot_scripts-9.4.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-10-05 11:31:39",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "wikimedia",
    "github_project": "pywikibot",
    "travis_ci": false,
    "coveralls": true,
    "github_actions": true,
    "requirements": [],
    "tox": true,
    "lcname": "pywikibot-scripts"
}
        
Elapsed time: 1.84800s