Source code for clash_royale.aio.resources.players

from __future__ import annotations

from ...models.player import Battle, Player, UpcomingChest
from .resource import Resource




class Players(Resource):
    """
    Async resource for player-related endpoints.

    Check the :clash-royale-api:`players`
    for more detailed information about each endpoint.
    """



    async def get(self, tag: str) -> Player:
        """Get player information by tag."""
        encoded_tag = self._encode_tag(tag)
        response = await self._client._request("GET", f"/players/{encoded_tag}")
        return Player.model_validate(response)




    async def get_battlelog(self, tag: str) -> list[Battle]:
        """Get player's battle log."""
        encoded_tag = self._encode_tag(tag)
        response = await self._client._request(
            "GET", f"/players/{encoded_tag}/battlelog"
        )
        return [Battle.model_validate(battle) for battle in response]




    async def get_upcoming_chests(self, tag: str) -> list[UpcomingChest]:
        """Get player's upcoming chests."""
        encoded_tag = self._encode_tag(tag)
        response = await self._client._request(
            "GET", f"/players/{encoded_tag}/upcomingchests"
        )
        return [
            UpcomingChest.model_validate(upcoming_chest)
            for upcoming_chest in response["items"]
        ]