Metadata-Version: 2.1
Name: coc.py
Version: 0.0.3
Summary: A python wrapper for the Clash of Clans API
Home-page: https://github.com/mathsman5133/coc.py
Author: mathsman5133
License: MIT
Platform: UNKNOWN
Requires-Python: >=3.5.3
Description-Content-Type: text/x-rst
Requires-Dist: python-dateutil
Requires-Dist: aiohttp (<3.6.0,>=3.3.0)

coc.py
======

Easy to use asynchronous Clash of Clans API wrapper in Python.

Key Features
-------------
- Asynchronous code
- Entire coverage of the official Clash of Clans API
- Auto updating tokens for use with dynamic IPs

Getting Started
================

Installing
-----------
**Python 3.5 or higher is required**

.. code:: sh

    # Linux/OS X
    python3 -m pip install -U coc.py

    # Windows
    py -3 -m pip install -U coc.py

Quick Example
--------------
.. code:: py

    import coc
    import asyncio

    client = coc.Client('token')

    async def player_name(tag):
        player = await client.get_player(tag)

        print(player.name)
        # alternatively,
        print(str(player))

    async def get_five_players(name):
        players = await client.search_players(name=name, limit=5)
        for n in players:
            print(n, n.tag)

    if __name__ == '__main__':
        loop = asyncio.get_event_loop()
        loop.run_until_complete(get_some_player('tag'))
        loop.run_until_complete(get_five_players('name')

For more examples see the examples directory

Links
------
- `coc.py Documentation <https://cocpy.readthedocs.io/en/latest/?>`_
- `Official Clash of Clans API Page <https://developer.clashofclans.com/>`_






