MediaWiki
=========
.. image:: https://img.shields.io/badge/license-MIT-blue.svg
:target: https://opensource.org/licenses/MIT/
:alt: License
.. image:: https://img.shields.io/github/release/barrust/mediawiki.svg
:target: https://github.com/barrust/mediawiki/releases
:alt: GitHub release
.. image:: https://github.com/barrust/mediawiki/workflows/Python%20package/badge.svg
:target: https://github.com/barrust/mediawiki/actions?query=workflow%3A%22Python+package%22
:alt: Build Status
.. image:: https://codecov.io/gh/barrust/mediawiki/branch/master/graph/badge.svg?token=OdETiNgz9k
:target: https://codecov.io/gh/barrust/mediawiki
:alt: Test Coverage
.. image:: https://app.codacy.com/project/badge/Grade/34162198611f4aa0bde630d1dab72ce8
:target: https://www.codacy.com/gh/barrust/mediawiki/dashboard?utm_source=github.com&utm_medium=referral&utm_content=barrust/mediawiki&utm_campaign=Badge_Grade
:alt: Codacy Review
.. image:: https://badge.fury.io/py/pymediawiki.svg
:target: https://badge.fury.io/py/pymediawiki
:alt: PyPi Release
.. image:: http://pepy.tech/badge/pymediawiki
:target: https://pepy.tech/project/pymediawiki
:alt: Downloads
***mediawiki*** is a python wrapper and parser 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 <http://www.wikipedia.org>`__ but other MediaWiki sites can
also be used.
MediaWiki wraps the `MediaWiki API <https://www.mediawiki.org/wiki/API>`_
so you can focus on *leveraging* your favorite MediaWiki site's data,
not getting it. Please check out the code on
`github <https://www.github.com/barrust/mediawiki>`_!
**Note:** this library was designed for ease of use and simplicity. If you plan
on doing serious scraping, automated requests, or editing, please look into
`Pywikibot <https://www.mediawiki.org/wiki/Manual:Pywikibot>`__
which has a larger API, advanced rate limiting, and other features so we may
be considerate of the MediaWiki infrastructure. Pywikibot has also other extra
features such as support for Wikibase (that runs Wikidata).
Installation
------------------
Pip Installation:
::
$ pip install pymediawiki
To install from source:
To install ``mediawiki``, simply clone the `repository on GitHub
<https://github.com/barrust/mediawiki>`__, then run from the folder:
::
$ python setup.py install
``mediawiki`` supports python versions 3.5 - 3.9
For *python 2.7* support, install `release 0.6.7 <https://github.com/barrust/mediawiki/releases/tag/v0.6.7>`__
::
$ pip install pymediawiki==0.6.7
Documentation
-------------
Documentation of the latest release is hosted on
`readthedocs.io <http://pymediawiki.readthedocs.io/en/latest/?>`__
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:
.. code:: python
>>> from mediawiki import MediaWiki
>>> wikipedia = MediaWiki()
>>> wikipedia.search('washington')
Run more advanced searches:
.. code:: python
>>> wikipedia.opensearch('washington')
>>> wikipedia.allpages('a')
>>> 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:
.. code:: python
>>> p = wikipedia.page('Chess')
>>> p.title
>>> p.summary
>>> p.categories
>>> p.images
>>> p.links
>>> p.langlinks
See the `documentation for more examples!
<http://pymediawiki.readthedocs.io/en/latest/quickstart.html#quickstart>`_
Changelog
------------------
Please see the `changelog
<https://github.com/barrust/mediawiki/blob/master/CHANGELOG.md>`__ for a list
of all changes.
License
-------
MIT licensed. See the `LICENSE file
<https://github.com/barrust/Wikipedia/blob/master/LICENSE>`__
for full details.
Raw data
{
"_id": null,
"home_page": "https://github.com/barrust/mediawiki",
"name": "pymediawiki",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "python,mediawiki,wikipedia,API,wiki,parser,natural language processing,nlp",
"author": "Tyler Barrus",
"author_email": "barrust@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/4c/0b/1ac091235baec1fcc88849889b377158afbf52d77f8f10bfde6391919ed5/pymediawiki-0.7.4.tar.gz",
"platform": null,
"description": "MediaWiki\n=========\n\n.. image:: https://img.shields.io/badge/license-MIT-blue.svg\n :target: https://opensource.org/licenses/MIT/\n :alt: License\n.. image:: https://img.shields.io/github/release/barrust/mediawiki.svg\n :target: https://github.com/barrust/mediawiki/releases\n :alt: GitHub release\n.. image:: https://github.com/barrust/mediawiki/workflows/Python%20package/badge.svg\n :target: https://github.com/barrust/mediawiki/actions?query=workflow%3A%22Python+package%22\n :alt: Build Status\n.. image:: https://codecov.io/gh/barrust/mediawiki/branch/master/graph/badge.svg?token=OdETiNgz9k\n :target: https://codecov.io/gh/barrust/mediawiki\n :alt: Test Coverage\n.. image:: https://app.codacy.com/project/badge/Grade/34162198611f4aa0bde630d1dab72ce8 \n :target: https://www.codacy.com/gh/barrust/mediawiki/dashboard?utm_source=github.com&utm_medium=referral&utm_content=barrust/mediawiki&utm_campaign=Badge_Grade\n :alt: Codacy Review\n.. image:: https://badge.fury.io/py/pymediawiki.svg\n :target: https://badge.fury.io/py/pymediawiki\n :alt: PyPi Release\n.. image:: http://pepy.tech/badge/pymediawiki\n :target: https://pepy.tech/project/pymediawiki\n :alt: Downloads\n\n***mediawiki*** is a python wrapper and parser for the MediaWiki API. The goal\nis to allow users to quickly and efficiently pull data from the MediaWiki site\nof their choice instead of worrying about dealing directly with the API. As\nsuch, it does not force the use of a particular MediaWiki site. It defaults to\n`Wikipedia <http://www.wikipedia.org>`__ but other MediaWiki sites can\nalso be used.\n\nMediaWiki wraps the `MediaWiki API <https://www.mediawiki.org/wiki/API>`_\nso you can focus on *leveraging* your favorite MediaWiki site's data,\nnot getting it. Please check out the code on\n`github <https://www.github.com/barrust/mediawiki>`_!\n\n**Note:** this library was designed for ease of use and simplicity. If you plan\non doing serious scraping, automated requests, or editing, please look into\n`Pywikibot <https://www.mediawiki.org/wiki/Manual:Pywikibot>`__\nwhich has a larger API, advanced rate limiting, and other features so we may\nbe considerate of the MediaWiki infrastructure. Pywikibot has also other extra\nfeatures such as support for Wikibase (that runs Wikidata).\n\n\nInstallation\n------------------\n\nPip Installation:\n\n::\n\n $ pip install pymediawiki\n\nTo install from source:\n\nTo install ``mediawiki``, simply clone the `repository on GitHub\n<https://github.com/barrust/mediawiki>`__, then run from the folder:\n\n::\n\n $ python setup.py install\n\n``mediawiki`` supports python versions 3.5 - 3.9\n\nFor *python 2.7* support, install `release 0.6.7 <https://github.com/barrust/mediawiki/releases/tag/v0.6.7>`__\n\n::\n\n $ pip install pymediawiki==0.6.7\n\nDocumentation\n-------------\n\nDocumentation of the latest release is hosted on\n`readthedocs.io <http://pymediawiki.readthedocs.io/en/latest/?>`__\n\nTo build the documentation yourself run:\n\n::\n\n $ pip install sphinx\n $ cd docs/\n $ make html\n\nAutomated Tests\n------------------\n\nTo run automated tests, one must simply run the following command from the\ndownloaded folder:\n\n::\n\n $ python setup.py test\n\n\nQuickstart\n------------------\n\nImport mediawiki and run a standard search against Wikipedia:\n\n.. code:: python\n\n >>> from mediawiki import MediaWiki\n >>> wikipedia = MediaWiki()\n >>> wikipedia.search('washington')\n\nRun more advanced searches:\n\n.. code:: python\n\n >>> wikipedia.opensearch('washington')\n >>> wikipedia.allpages('a')\n >>> wikipedia.geosearch(title='washington, d.c.')\n >>> wikipedia.geosearch(latitude='0.0', longitude='0.0')\n >>> wikipedia.prefixsearch('arm')\n >>> wikipedia.random(pages=10)\n\nPull a MediaWiki page and some of the page properties:\n\n.. code:: python\n\n >>> p = wikipedia.page('Chess')\n >>> p.title\n >>> p.summary\n >>> p.categories\n >>> p.images\n >>> p.links\n >>> p.langlinks\n\nSee the `documentation for more examples!\n<http://pymediawiki.readthedocs.io/en/latest/quickstart.html#quickstart>`_\n\n\n\nChangelog\n------------------\n\nPlease see the `changelog\n<https://github.com/barrust/mediawiki/blob/master/CHANGELOG.md>`__ for a list\nof all changes.\n\n\nLicense\n-------\n\nMIT licensed. See the `LICENSE file\n<https://github.com/barrust/Wikipedia/blob/master/LICENSE>`__\nfor full details.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Wikipedia and MediaWiki API wrapper for Python",
"version": "0.7.4",
"project_urls": {
"Homepage": "https://github.com/barrust/mediawiki"
},
"split_keywords": [
"python",
"mediawiki",
"wikipedia",
"api",
"wiki",
"parser",
"natural language processing",
"nlp"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "09833e9126b2cfa8082195bff319ccb822b784947f4a3ea58633295cda39217c",
"md5": "7781059e280779635985278f3742952e",
"sha256": "23e95d8a6d3170414f6db4c8d1592c1458a7a2ad20dceb9d8541e5e19752fd95"
},
"downloads": -1,
"filename": "pymediawiki-0.7.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7781059e280779635985278f3742952e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 24792,
"upload_time": "2024-01-06T16:56:08",
"upload_time_iso_8601": "2024-01-06T16:56:08.759713Z",
"url": "https://files.pythonhosted.org/packages/09/83/3e9126b2cfa8082195bff319ccb822b784947f4a3ea58633295cda39217c/pymediawiki-0.7.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4c0b1ac091235baec1fcc88849889b377158afbf52d77f8f10bfde6391919ed5",
"md5": "320a46809bb9e9e1b6a0abc21a82745f",
"sha256": "fec43acf5d88e599708dde62dfc9107a4e322470d1c46eecd442af61d723e7c6"
},
"downloads": -1,
"filename": "pymediawiki-0.7.4.tar.gz",
"has_sig": false,
"md5_digest": "320a46809bb9e9e1b6a0abc21a82745f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 1672199,
"upload_time": "2024-01-06T16:56:10",
"upload_time_iso_8601": "2024-01-06T16:56:10.753725Z",
"url": "https://files.pythonhosted.org/packages/4c/0b/1ac091235baec1fcc88849889b377158afbf52d77f8f10bfde6391919ed5/pymediawiki-0.7.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-06 16:56:10",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "barrust",
"github_project": "mediawiki",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pymediawiki"
}
JSON
