Metadata-Version: 1.1
Name: mediawikiapi
Version: 1.1.0
Summary: Wikipedia API on Python
Home-page: https://github.com/lehinevych/MediaWikiAPI
Author: Taras Lehinevych
Author-email: mediawikiapi@taraslehinevych.me
License: MIT
Description-Content-Type: UNKNOWN
Description: MediaWikiAPI
        ============
        
        |PyPI version| |Version| |Build Status| |GitHub Issues| |License|
        [|Docs|
        
        **MediaWikiAPI** is a Python library that makes it easy to access and
        parse data from Wikipedia.
        
        Search Wikipedia, get article summaries, get data like links and images
        from a page, and more. Wikipedia wraps the
        ``MediaWiki API <https://www.mediawiki.org/wiki/API>``\ \_\_ so you can
        focus on using Wikipedia data, not getting it.
        
        .. code:: python
        
            >>> from mediawikiapi import MediaWikiAPI
            >>> mediawikiapi = MediaWikiAPI()
            >>> print mediawikiapi.summary("Wikipedia")
            # Wikipedia (/ˌwɪkɨˈpiːdiə/ or /ˌwɪkiˈpiːdiə/ WIK-i-PEE-dee-ə) is a collaboratively edited, multilingual, free Internet encyclopedia supported by the non-profit Wikimedia Foundation...
        
            >>> mediawikiapi.search("Barack")
            # [u'Barak (given name)', u'Barack Obama', u'Barack (brandy)', u'Presidency of Barack Obama', u'Family of Barack Obama', u'First inauguration of Barack Obama', u'Barack Obama presidential campaign, 2008', u'Barack Obama, Sr.', u'Barack Obama citizenship conspiracy theories', u'Presidential transition of Barack Obama']
        
            >>> ny = mediawikiapi.page("New York")
            >>> ny.title
            # u'New York'
            >>> ny.url
            # u'http://en.wikipedia.org/wiki/New_York'
            >>> ny.content
            # u'New York is a state in the Northeastern region of the United States. New York is the 27th-most exten'...
            >>> ny.links[0]
            # u'1790 United States Census'
        
            >>> mediawikiapi.conf.language = "fr"
            >>> mediawikiapi.summary("Facebook", sentences=1)
            # Facebook est un service de réseautage social en ligne sur Internet permettant d'y publier des informations (photographies, liens, textes, etc.) en contrôlant leur visibilité par différentes catégories de personnes.
        
        Installation
        ------------
        
        To install MediaWikiAPI, simply run:
        
        .. code:: bash
        
            pip install mediawikiapi
        
        MediaWikiAPI is compatible with Python 3 and Python 2.7.
        
        Documentation
        -------------
        
        The documentation is available
        `here <http://mediawikiapi.readthedocs.io/en/latest/>`__ Changelog could
        be find in the documentation.
        
        To run tests, clone the
        ``repository on GitHub <https://github.com/lehinevych/MediaWikiAPI>``\ \_\_,
        then run:
        
        .. code:: bash
        
            pip install -r requirements.txt
            bash runtests  # will run tests for python and python3
            python -m unittest discover tests/ '*test.py'  # manual style
        
        in the root project directory.
        
        To build the documentation yourself, after installing requirements.txt,
        run:
        
        .. code:: bash
        
            pip install sphinx
            cd docs/
            make html
        
        License
        -------
        
        MIT licensed. See the
        ``LICENSE file <https://github.com/lehinevych/MediaWikiAPI/blob/master/LICENSE>``\ \_\_
        for full details.
        
        Credits
        -------
        
        -  @goldsmith for making such a fantastic library to fork
        
        .. |PyPI version| image:: https://img.shields.io/pypi/v/mediawikiapi.svg
           :target: https://pypi.python.org/pypi/mediawikiapi
        .. |Version| image:: https://img.shields.io/pypi/pyversions/mediawikiapi.svg
           :target: https://pypi.python.org/pypi/mediawikiapi
        .. |Build Status| image:: https://travis-ci.org/lehinevych/MediaWikiAPI.svg?branch=master
           :target: https://travis-ci.org/leginevych/MediaWikiAPI
        .. |GitHub Issues| image:: https://img.shields.io/github/issues/lehinevych/MediaWikiAPI.svg
           :target: https://github.com/lehinevych/MediaWikiAPI/issues
        .. |License| image:: https://img.shields.io/badge/license-MIT%20License-brightgreen.svg
           :target: https://opensource.org/licenses/MIT
        .. |Docs| image:: https://readthedocs.org/projects/mediawikiapi/badge/?version=latest
        
        
Keywords: python wikipedia API mediawiki
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Topic :: Software Development :: Libraries
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
