SIMNet/simnet/client/components/wish/genshin.py

from functools import partial
from typing import Optional, List

from simnet.client.components.wish.base import BaseWishClient
from simnet.models.genshin.wish import Wish
from simnet.utils.enum_ import Game
from simnet.utils.paginator import WishPaginator

__all__ = ("GenshinWishClient",)


class GenshinWishClient(BaseWishClient):
    """The GenshinWishClient class for making requests towards the Wish API."""

    async def wish_history(
        self,
        banner_types: Optional[List[int]] = None,
        limit: Optional[int] = None,
        lang: Optional[str] = None,
        authkey: Optional[str] = None,
        end_id: int = 0,
    ) -> List[Wish]:
        """Get the wish history for a list of banner types.

        Args:
            banner_types (Optional[List[int]], optional): The banner types to get the wish history for.
            limit (Optional[int] , optional): The maximum number of wishes to retrieve.
                If not provided, all available wishes will be returned.
            lang (Optional[str], optional): The language code to use for the request.
                If not provided, the class default will be used.
            authkey (Optional[str], optional): The authorization key for making the request.
            end_id  (int, optional): The ending ID of the last wish to retrieve.

        Returns:
            List[Wish]: A list of GenshinWish objects representing the retrieved wishes.
        """
        banner_types = banner_types or [100, 200, 301, 302]
        banner_names = await self.get_banner_names(game=Game.GENSHIN, lang=lang, authkey=authkey)
        wishes = []
        for banner_type in banner_types:
            paginator = WishPaginator(
                end_id,
                partial(
                    self.get_wish_page,
                    banner_type=banner_type,
                    game=Game.GENSHIN,
                    authkey=authkey,
                ),
            )
            items = await paginator.get(limit)
            banner_name = banner_names[banner_type]
            wishes.extend([Wish(**i, banner_name=banner_name) for i in items])
        return sorted(wishes, key=lambda wish: wish.time.timestamp())