Snippets Groups Projects

6 months ago

Drop support for old-style continuation · 8fdfde0c

Adam Williamson authored 6 months ago

new-style continuation is available since 1.21, and we are
already forcing it for mw 1.21-1.25 in `api` by adding `continue`
to kwargs if it's not there. Old-style continuation is only
available by passing `rawcontinue=` and is not recommended.
I don't think we need to maintain support for it in the List
class. Theoretically it could maybe still be used if someone is
passing `rawcontinue=""` as an arg to `List` or a subclass of it
(and that overrides the `continue=` that we force in - I'm not
sure which wins), but I can't imagine why anyone would want to do
that.

This improves test coverage because old-style continuation is
uncovered at present. I'd rather remove it than write a test for
it.

See: https://www.mediawiki.org/wiki/API:Continue



Signed-off-by: Adam Williamson <awilliam@redhat.com>

8fdfde0c

Drop support for old-style continuation

Adam Williamson authored 6 months ago

new-style continuation is available since 1.21, and we are
already forcing it for mw 1.21-1.25 in `api` by adding `continue`
to kwargs if it's not there. Old-style continuation is only
available by passing `rawcontinue=` and is not recommended.
I don't think we need to maintain support for it in the List
class. Theoretically it could maybe still be used if someone is
passing `rawcontinue=""` as an arg to `List` or a subclass of it
(and that overrides the `continue=` that we force in - I'm not
sure which wins), but I can't imagine why anyone would want to do
that.

This improves test coverage because old-style continuation is
uncovered at present. I'd rather remove it than write a test for
it.

See: https://www.mediawiki.org/wiki/API:Continue



Signed-off-by: Adam Williamson <awilliam@redhat.com>

README.md 2.87 KiB

mwclient

mwclient is a lightweight Python client library to the MediaWiki API which provides access to most API functionality. It works with Python 3.6 and above, and supports MediaWiki 1.21 and above. For functions not available in the current MediaWiki, a MediaWikiVersionError is raised.

The current stable version 0.11.0 is available through PyPI:

$ pip install mwclient

The current development version can be installed from GitHub:

$ pip install git+git://github.com/mwclient/mwclient.git

Please see the changelog document for a list of changes.

mwclient was originally written by Bryan Tong Minh. It was maintained for many years by Dan Michael O. Heggø, with assistance from Waldir Pimenta. It is currently maintained by Marc Trölitzsch, Adam Williamson and Megan Cutrofello. The best way to get in touch with the maintainers is by filing an issue or a pull request.

Documentation

Up-to-date documentation is hosted at Read the Docs. It includes a user guide to get started using mwclient, a reference guide, implementation and development notes.

There is also some documentation on the GitHub wiki that hasn't been ported yet. If you want to help, you're welcome!

Contributing

Patches are welcome! See this page for information on how to get started with mwclient development.