MediaWiki API for Python
Project description
mediawiki is a python wrapper for the MediaWiki API. The goal is to allow users to quickly and efficiently pull data from the MediaWiki site of their choice instead of worrying about dealing directly with the API. As such, it does not force the use of a particular MediaWiki site. It defaults to Wikipedia but other MediaWiki sites can also be used.
Note: this library was designed for ease of use and simplicity, not for advanced use. If you plan on doing serious scraping or automated requests, please use Pywikipediabot (or one of the other more advanced Python MediaWiki API wrappers), which has a larger API, advanced rate limiting, and other features so we may be considerate of the MediaWiki infrastructure.
Installation
Pip Installation:
$ pip install pymediawiki
To install from source:
To install mediawiki, simply clone the repository on GitHub, then run from the folder:
$ python setup.py install
mediawiki supports python versions 2.7 and 3.3 - 3.6
Documentation
Documentation of the latest release is hosted on pythonhosted.org
To build the documentation yourself run:
$ pip install sphinx $ cd docs/ $ make html
Automated Tests
To run automated tests, one must simply run the following command from the downloaded folder:
$ python setup.py test
Quickstart
Import mediawiki and run a standard search against Wikipedia:
>>> from mediawiki import MediaWiki
>>> wikipedia = MediaWiki()
>>> wikipedia.search('washington')
Run more advanced searches:
>>> wikipedia.opensearch('washington')
>>> wikipedia.geosearch(title='washington, d.c.')
>>> wikipedia.geosearch(latitude='0.0', longitude='0.0')
>>> wikipedia.prefixsearch('arm')
>>> wikipedia.random(pages=10)
Pull a MediaWiki page and some of the page properties:
>>> p = wikipedia.page('Chess')
>>> p.title
>>> p.summary
>>> p.categories
>>> p.images
>>> p.links
See the Documentation for more examples!
Changelog
Please see the changelog for a list of all changes.
License
MIT licensed. See the LICENSE file for full details.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Hashes for pymediawiki-0.3.9-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 67bae2a7d749ae43896bedb7039bb0a8b0f9b664a6a9f7a67f70403f95d9668d |
|
MD5 | 120698c65e8fea0cc2207230dc328bb3 |
|
BLAKE2b-256 | 8d4d5d61cae96613bc3584767bb8e7ef4ff697c0366f475633e0a755984c3872 |