At the Lyon Hackthon, updates to the tarball releases were turned off,
and Pywikibot 2.0 release candidate (RC) 1 was published onto PYPI.
The tarball releases are currently locked to the git revision before
the Lyon Hackathon. This was done to prevent large code merges
affecting users of the tarballs and Wikimedia labs shared pywikibot.
There was one large change merged for RC 1, and there are a few more
large changes which will be merged before the final pywikibot 2.0.
I suggest bot operators avoid the unstable master by not updating
regularly using git, but using the labs shared version or the pip
package. We'll announce each new release candidate for people to
Anyone wanting only the library, without any of the traditional
scripts, can now use:
$ sudo pip install --pre pywikibot
The --pre is needed because the current published version is a
pre-release, and modern pip doesnt install those without being
explicitly told to do that.
Technical documentation, including an up-to-date API reference, is now
being published at
If you are using pywikibot for your own script, you can now package it
as a pypi package and add a dependency in your setup.py on
The pywikibot package doesnt include i18n data, and it detects when it
is not present.
pywikibot core now uses JSON i18n messages, and these can be included
in your own package. To enable your own JSON i18n messages, place
them in an i18n subdirectory of your package, and your script needs to
pywikibot does not require a user-config.py. It can be skipped by
setting envvar PYWIKIBOT2_NO_USER_CONFIG. This can be done before
calling python, or inside python but before importing pywikibot. e.g.
os.environ['PYWIKIBOT2_NO_USER_CONFIG'] = '1'
>> import pywikibot
Many thanks to all the developers of 'rewrite' over the years - it is
nearly finished ;-)