Skip to main content
Help us improve Python packaging – donate today!

Python MediaWiki Bot Framework

Project Description

Travis Build Status AppVeyor Build Status Code coverage Maintainability Pywikibot release

Pywikibot

The Pywikibot framework is a Python library that interfaces with the MediaWiki API version 1.14 or higher.

Also included are various general function scripts that can be adapted for different tasks.

For further information about the library excluding scripts see the full code documentation.

Quick start

git clone https://gerrit.wikimedia.org/r/pywikibot/core.git
cd core
git submodule update --init
python pwb.py script_name

Or to install using PyPI (excluding scripts)

pip install -U setuptools
pip install pywikibot

Our installation guide has more details for advanced usage.

Basic Usage

If you wish to write your own script it’s very easy to get started:

import pywikibot
site = pywikibot.Site('en', 'wikipedia')  # The site we want to run our bot on
page = pywikibot.Page(site, 'Wikipedia:Sandbox')
page.text = page.text.replace('foo', 'bar')
page.save('Replacing "foo" with "bar"')  # Saves the page

For more documentation on pywikibot see our docs.

The contents of the package

Directories
pywikibot Library routines, control files and global settings
pywikibot/comms Communication layer
pywikibot/compat Package to provide compatibility with compat scripts
pywikibot/data Module with several layers for data access to wiki
pywikibot/families wiki-specific information and settings
pywikibot/tools Miscellaneous helper functions (not wiki-dependent)
pywikibot/userinterfaces GUI and terminal interface

Required external programs

It may require the following programs to function properly:

  • 7za: To extract 7z files

Release history

Current release

  • Deprecation warning: support for py2.7.2 and py2.7.3 will be dropped
  • Dropped support for Python 2.6 (T154771)
  • Dropped support for Python 3.3 (T184508)
  • Bugfixes and improvements
  • Localisation updates

3.0.20180304

  • Bugfixes and improvements
  • Localisation updates

3.0.20180302

  • Changed requirements for requests and sseclient
  • Bugfixes and improvements
  • Localisation updates

3.0.20180204

  • Deprecation warning: support for py2.6 and py3.3 will be dropped
  • Changed requirements for cryprography, Pillow and pyOpenSSL
  • Bugfixes and improvements
  • Localisation updates

3.0.20180108

  • Maintenance script to download Wikimedia database dump
  • Option to auto-create accounts when logging in
  • Ship wikimania family file
  • Drop battlestarwiki family file
  • Bugfixes and improvements
  • Localisation updates

3.0.20171212

  • Introduce userscripts directory
  • Generator settings inside (user-)fixes.py
  • BaseUnlinkBot has become part of the framework in specialbots.py
  • Decommission of rcstream
  • Script files added to https://doc.wikimedia.org/pywikibot/
  • Other documentation updates
  • Bugfixes and improvements
  • Localisation updates

3.0.20170801

  • Bugfixes and improvements
  • Localisation updates

3.0.20170713

  • Implement server side event client EventStreams
  • Add thanks log support
  • new ndashredir.py script to create hyphenated redirects
  • new followlive.py script to flag new articles
  • new WbUnknown data type for Wikibase
  • Deprecate APISite.newfiles()
  • new pagegenerators filter option -titleregexnot
  • Inverse of pagegenerators -namespace option
  • Bugfixes and improvements
  • Localisation updates
  • Remove panoramiopicker.py script
  • Remove anarchopedia family out of the framework
  • CODE_OF_CONDUCT included

3.0.20170521

  • Replaced the word ‘async’ with ‘asynchronous’ due to python 3.7
  • Support for Python 2.6 but higher releases are strictly recommended
  • Bugfixes and improvements
  • Localisation updates

3.0.20170403

  • First major release from master branch
  • requests package is mandatory
  • Deprecate previous 2.0 branches

2.0rc5

  • Last stable 2.0 branch

2.0rc4

  • Remove dependency on pYsearch
  • Desupport Python 2.6 for Pywikibot 2.0 release branch

2.0rc3

  • Bugfixes
  • Localisation updates
  • i18n: always follow master branch

2.0rc2

  • Bugfixes and improvements
  • Localisation updates

2.0rc1

  • New scripts patrol.py and piper.py ported from old compat branch
  • isbn.py now supports wikibase
  • RecentChanges stream (rcstream) support
  • Sphinx documentation at https://doc.wikimedia.org/pywikibot/
  • Bugfixes and improvements
  • Localisation updates

2.0b3

  • Bugfixes and improvements

2.0b2

  • Bugfixes and improvements

2.0b1

  • First stable release branch

1.0 rv 2007-06-19

  • BeautifulSoup becomes mandatory
  • new scripts where added
  • new family files where supported
  • some scripts where archived

1.0

Sep 26, 2005

  • First PyWikipediaBot framework release
  • scripts and libraries for standardizing content
  • tools for making minor modifications
  • script making interwiki links

Contributing

Our code is maintained on Wikimedia’s Gerrit installation, learn how to get started.

Code of Conduct

The development of this software is covered by a Code of Conduct.

Release history Release notifications

This version
History Node

3.0.20180403

History Node

3.0.20180304

History Node

3.0.20180302

History Node

3.0.20180204

History Node

3.0.20180108

History Node

3.0.20171212

History Node

3.0.20170801

History Node

3.0.20170713

History Node

3.0.20170521

History Node

3.0.20170403

History Node

2.0rc5

History Node

2.0rc4

History Node

2.0rc3

History Node

2.0rc1.post2

History Node

2.0rc1.post1

History Node

2.0rc1

History Node

2.0b1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
pywikibot-3.0.20180403.tar.gz (489.1 kB) Copy SHA256 hash SHA256 Source None Apr 3, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page