Metadata-Version: 1.2
Name: mw-api-client
Version: 3.1.0
Summary: A simple MediaWiki client.
Home-page: https://github.com/Kenny2github/mw-api-client
Author: Ken Hilton
License: MIT
Description: 
        A really simple MediaWiki API client.
        
        Can use most MediaWiki API modules.
        
        Requires the ``requests`` library.
        
        http://www.mediawiki.org/
        
        Installation
        ============
        
        To install the latest stable version::
        
            pip install -U mw-api-client
        
        To install the latest development (likely unstable) version::
        
            git clone https://github.com/Kenny2github/mw-api-client.git
            cd mw-api-client
            python setup.py install
        
        Example Usage
        =============
        
        .. code-block:: python
        
            import mw_api_client as mw
        
        Get a page:
        
        .. code-block:: python
        
            wp = mw.Wiki("https://en.wikipedia.org/w/api.php", "MyCoolBot/0.0.0")
        
            wp.login("kenny2wiki", password)
        
            sandbox = wp.page("User:Kenny2wiki/sandbox")
        
        Edit page:
        
        .. code-block:: python
        
            # Get the page
            contents = sandbox.read()
        
            # Change
            contents += "\n This is a test!"
            summary = "Made a test edit"
        
            # Submit
            sandbox.edit(contents, summary)
        
        List pages in category:
        
        .. code-block:: python
        
            for page in wp.category("Redirects").categorymembers():
                print(page.title)
        
        Remove all uses of a template:
        
        .. code-block:: python
        
            stub = wp.template("Stub")
        
            # Pages that transclude stub, main namespace only
            target_pages = list(stub.transclusions(namespace=0))
        
            # Sort by title because it's prettier that way
            target_pages.sort(key=lambda p: p.title)
        
            for page in target_pages:
                page.replace("{{stub}}", "")
        
        Patrol all recent changes in the Help namespace:
        
        .. code-block:: python
        
            rcs = wp.recentchanges(rcnamespace=12)
        
            for rc in rcs:
                rc.patrol()
        
        
        Made by Kenny2github, based off of ~blob8108's Scratch Wiki API client.
        
        MIT Licensed.
        
Keywords: mediawiki api requests
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content :: Wiki
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.6
Requires-Python: >=2.7
