Merge pull request #157 from Kuchenmampfer/capital_leaderboards

add clan capital leaderboards

Author: doluk

coc/clans.py

@@ -48,9 +48,11 @@ class RankedClan(BaseClan):
     member_count: :class:`int`
         The number of members in the clan.
     points: :class:`int`
-        The clan's trophy-count. If retrieving info for versus leader-boards, this will be ``None``.
+        The clan's trophy-count. If retrieving info for capital or versus leader-boards, this will be ``None``.
     versus_points: :class:`int`
-        The clan's versus trophy count. If retrieving info for regular leader boards, this will be ``None``.
+        The clan's versus trophy count. If retrieving info for regular or capital leader boards, this will be ``None``.
+    capital_points: :class:`int`
+        The clan's capital trophy count. If retrieving info for regular or versus leader boards, this will be ``None``.
     rank: :class:`int`
         The clan's rank in the leader board.
     previous_rank: :class:`int`
@@ -62,6 +64,7 @@ class RankedClan(BaseClan):
         "member_count",
         "points",
         "versus_points",
+        "capital_points",
         "rank",
         "previous_rank",
     )
@@ -75,6 +78,7 @@ def _from_data(self, data: dict) -> None:
 
         self.points: int = data_get("clanPoints")
         self.versus_points: int = data_get("clanVersusPoints")
+        self.capital_points: int = data_get("clanCapitalPoints")
         self.member_count: int = data_get("members")
         self.location = try_enum(Location, data=data_get("location"))
         self.rank: int = data_get("rank")

coc/client.py

@@ -1240,6 +1240,40 @@ async def get_location_clans(
         data = await self.http.get_location_clans(location_id, limit=limit, before=before, after=after)
         return [RankedClan(data=n, client=self) for n in data["items"]]
 
+    async def get_location_clans_capital(
+        self, location_id: int = "global", *, limit: int = None, before: str = None, after: str = None
+    ) -> List[RankedClan]:
+        """Get clan capital rankings for a specific location
+
+        Parameters
+        -----------
+        location_id : int
+            The Location ID to search for. Defaults to all locations (``global``).
+        limit : int
+            The number of results to fetch.
+        before : str, optional
+            For use with paging. Not implemented yet.
+        after: str, optional
+            For use with paging. Not implemented yet.
+
+        Raises
+        ------
+        Maintenance
+            The API is currently in maintenance.
+
+        GatewayError
+            The API hit an unexpected gateway exception.
+
+
+        Returns
+        --------
+        List[:class:`RankedClan`]
+            The top clans for the requested location.
+        """
+
+        data = await self.http.get_location_clans_capital(location_id, limit=limit, before=before, after=after)
+        return [RankedClan(data=n, client=self) for n in data["items"]]
+
     async def get_location_players(
         self, location_id: int = "global", *, limit: int = None, before: str = None, after: str = None
     ) -> List[RankedPlayer]:

coc/http.py

@@ -396,6 +396,9 @@ def get_location_players(self, location_id, **kwargs):
     def get_location_clans_versus(self, location_id, **kwargs):
         return self.request(Route("GET", "/locations/{}/rankings/clans-versus".format(location_id), **kwargs))
 
+    def get_location_clans_capital(self, location_id, **kwargs):
+        return self.request(Route("GET", "/locations/{}/rankings/capitals".format(location_id), **kwargs))
+
     def get_location_players_versus(self, location_id, **kwargs):
         return self.request(Route("GET", "/locations/{}/rankings/players-versus".format(location_id), **kwargs))