Hi Maarten,

On 8 April 2017 at 13:50, Maarten Dammers <maarten@mdammers.nl> wrote:

Excellent! Do we need to update any documentation like https://www.mediawiki.org/wiki/Manual:Pywikibot/Installation ?

Yes -- specifically, the links 'install stable' link to pre-packaged zips that include dependencies for 2.x. These nightlies need to be updated for 3.x. I've created a task for this -- https://phabricator.wikimedia.org/T162560.

Do people who use the PyPI 2.x have an easy upgrade path or do they have to explicitly install the 3.x version?

They have to explicitly upgrade ('pip install --upgrade pywikibot'), which should also install all required dependencies. And, of course, there may be API breakage, although this really should be minimal.

As you may have guessed from the version number, this is with the idea to essentially to 'timeboxed' releases, where we just push the most recent version from git to PyPI. This means a little less stability (releases may be broken inadvertently), but also means the version om PyPI will be much more up to date.

Good to hear. The lagging behind of master was getting embarrassing. What triggers this update? Just a merge to master or is it a manual operation? Is this documented somewhere?

It's a manual operation; the method is the same as other python packages:

python setup.py sdist # source distribution

twine upload dist/pywikibot-... # twine is the tool to upload releases to pypi; can be installed with pip install twine

We should probably document this explicitly somewhere ;-) but I'm not entirely sure where...

Best,

Merlijn