Add examples

Author: mathsman5133

examples/discord_bot.py

@@ -0,0 +1,55 @@
+# this example assumes you have discord.py > v1.0.0 installed via `python -m pip install -U discord.py`
+# for more info on using discord.py, see the docs at: https://discordpy.readthedocs.io/en/latest/api.html#message
+import discord
+from discord.ext import commands
+
+import coc
+
+bot = commands.Bot(command_prefix='?')
+coc_client = coc.Client('coc token')
+
+
+@bot.command()
+async def player_heroes(ctx, player_tag):
+    player = await coc_client.get_player(player_tag)
+
+    to_send = ''
+    for hero in player.heroes:
+        to_send += '{}: Lv{}/{}'.format(str(hero), hero.level, hero.max_level)
+
+    await ctx.send(to_send)
+
+
+@bot.command()
+async def current_war_status(ctx, clan_tag):
+    e = discord.Embed(colour=discord.Colour.blue())
+
+    try:
+        war = await coc_client.get_current_war(clan_tag)
+    except coc.Forbidden:
+        return await ctx.send('Clan has a private war log!')
+
+    e.add_field(name=war.clan.name,
+                value=war.clan.tag)
+
+    e.add_field(name='War State:',
+                value=war.state,
+                inline=False)
+
+    if war.end_time:  # if state is notInWar we will get errors
+
+        hours, remainder = divmod(int(war.end_time.seconds_until), 3600)
+        minutes, seconds = divmod(remainder, 60)
+
+        e.add_field(name='Opponent:',
+                    value=f"{war.opponent.name}\n"
+                          f"{war.opponent.tag}",
+                    inline=False)
+        e.add_field(name="War End Time:",
+                    value=f'{hours} hours {minutes} minutes {seconds} seconds',
+                    inline=False)
+
+    await ctx.send(embed=e)
+
+bot.run('bot token')
+

examples/war_logs.py

@@ -0,0 +1,70 @@
+import coc
+import asyncio
+import logging
+
+log = logging.getLogger('coc')
+log.setLevel(logging.DEBUG)
+
+
+class COCClient(coc.Client):
+    def __init__(self, token, **kwargs):
+        super().__init__(token, **kwargs)
+
+    def on_token_reset(self, new_token):
+        """We want to override how the default on_token_reset is run
+        """
+        log.info('New token {} was created!'.format(new_token))
+
+
+# because we want to update our token if our IP changes, we need to pass in our email and password
+# from https://developer.clashofclans.com
+cocclient = COCClient('token', email='email', password='password', update_tokens=True)
+
+
+async def get_warlog_for_clans(clan_tags: list):
+    war_logs = {}
+    for tag in clan_tags:
+        # if we're not allowed to view warlog (private in game), this will raise an exception
+        try:
+            warlog = await cocclient.get_warlog(tag, cache=True)
+        except coc.Forbidden:
+            warlog = []
+
+        war_logs[tag] = warlog
+
+    # return a dict of list of war logs: {'tag': [list_of_warlog_objects]}
+    return war_logs
+
+
+async def get_clan_tags_names(name: str, limit: int):
+    clans = await cocclient.search_clans(name=name, limit=limit)
+    # return a list of tuples of name/tag pair ie. [(name, tag), (another name, another tag)]
+    return [(n.name, n.tag) for n in clans]
+
+
+async def get_warlog_opponents_from_clan_name(name: str, no_of_clans: int):
+    clan_tags_names = await get_clan_tags_names(name, no_of_clans)
+
+    # search for war logs with clan tags found
+    war_logs = await get_warlog_for_clans([n[1] for n in clan_tags_names])
+
+    for name, tag in clan_tags_names:
+        # iterate over the wars
+        for war in war_logs[tag]:
+            # if it is a league war we will error below because it does not return a WarLog object,
+            # and thus no opponent
+            if isinstance(war, coc.LeagueWarLogEntry):
+                print('League War Season - No opponent info available')
+                continue
+
+            print('War: {} vs {}'.format(name, war.opponent.name))
+
+if __name__ == '__main__':
+    loop = asyncio.get_event_loop()
+
+    loop.run_until_complete(get_warlog_opponents_from_clan_name('name', 5))
+    loop.run_until_complete(cocclient.close())
+
+
+
+