Pular para conteúdo

Explorer

Explore e entenda facilmente os dados dos campeões.

Attributes:

Name Type Description
data dict

Dados da Riot.
champions dict

Dicionário de campeões.
Source code in league_data/explorer.py 
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
class Explorer:
    """Explore e entenda facilmente os dados dos campeões.

    Attributes:
        data (dict): Dados da Riot.
        champions (dict): Dicionário de campeões.
    """

    def get_champion(self, name: str) -> Champion | None:
        """Retorna o objeto do campeão, caso exista.

        Args:
            name (str): Nome do campeão.

        Returns:
            Champion (Champion): O objeto que contém os dados do campeão.
            None (None): Caso o nome do campeão não seja válido.
        """
        name = name.lower()

        if name in self.champions:
            champion_data = self.champions[name]
            return Champion(self, champion_data)

        return None

    def get_skin(self, name: str) -> Skin | None:
        """Retorna o objeto da skin, caso exista.

        Args:
            name (str): Nome da skin.

        Returns:
            Skin (Skin): O objeto que contém os dados da skin.
            None (None): Caso o nome da skin não seja válida.
        """
        name = name.lower()

        for champion in self.champions.values():
            if name not in champion["skins"]:
                continue

            skin_data = champion["skins"][name]
            return Skin(self, champion, skin_data)

        return None

    @staticmethod
    def get_splash_art(champion_id: str, skin_id: str) -> str:
        """Retorna a URL do campeão ou da skin desejada com base em seus IDS."""
        return f"https://raw.communitydragon.org/latest/plugins/rcp-be-lol-game-data/global/default/v1/champion-splashes/{champion_id}/{skin_id}.jpg"

    def __init__(self, data: dict, champions: dict | None = None) -> None:
        """Reformula os dados que recebe como parâmetro.

        Caso não receba os champions, será requisitado automaticamente.

        Args:
            data (dict): Dados da Riot, gerados pelo League.
            champions (dict, optional): Dicionário de campeões, gerados pelo Explorer.
        """
        self.data = data  # dados gerados da classe League
        self.champions = champions or self.__get_champions()

    def __getitem__(self, name: str) -> Champion | Skin | None:
        """Retorna os dados do campeão ou skin, caso exista.

        Args:
            name (str): Nome do campeão ou skin.

        Returns:
            Champion (Champion): Objeto do campeão encontrado.
            Skin (Skin): Objeto da skin encontrada.
            None (None): Nenhum item foi encontrado.
        """
        champion = self.get_champion(name)
        return champion or self.get_skin(name)

    def __get_champions(self) -> dict:
        champions = {}

        for index in self.data:
            if not self.data[index]["isBase"]:
                continue

            champion_name = self.data[index]["name"]
            champion_id = self.__get_champion_id(index)
            champions[champion_name.lower()] = {
                "id": champion_id,
                "name": champion_name,
                "art": self.get_splash_art(champion_id, index),
                "skins": self.__get_champion_skins(champion_id),
            }

        return champions

    def __get_champion_skins(self, champion_id: str) -> dict:
        skins = {}

        for index in self.data:
            if self.data[index]["isBase"]:
                continue

            if self.__get_champion_id(index) != champion_id:
                continue  # apenas as skins do campeão solicitado.

            skin_name = self.data[index]["name"]
            skins[skin_name.lower()] = {
                "id": index,
                "name": skin_name,
                "rarity": self.data[index]["rarity"],
                "art": self.get_splash_art(champion_id, index),
            }

        return skins

    def __get_champion_id(self, index: str) -> str:
        endpoint = self.data[index]["splashPath"]
        return endpoint.split("/")[-2]

get_champion(name)

Retorna o objeto do campeão, caso exista.

Parameters:

Name Type Description Default
name str

Nome do campeão.

 required

Returns:

Name Type Description
Champion Champion

O objeto que contém os dados do campeão.
None None

Caso o nome do campeão não seja válido.
Source code in league_data/explorer.py 
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
def get_champion(self, name: str) -> Champion | None:
    """Retorna o objeto do campeão, caso exista.

    Args:
        name (str): Nome do campeão.

    Returns:
        Champion (Champion): O objeto que contém os dados do campeão.
        None (None): Caso o nome do campeão não seja válido.
    """
    name = name.lower()

    if name in self.champions:
        champion_data = self.champions[name]
        return Champion(self, champion_data)

    return None

get_skin(name)

Retorna o objeto da skin, caso exista.

Parameters:

Name Type Description Default
name str

Nome da skin.

 required

Returns:

Name Type Description
Skin Skin

O objeto que contém os dados da skin.
None None

Caso o nome da skin não seja válida.
Source code in league_data/explorer.py 
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
def get_skin(self, name: str) -> Skin | None:
    """Retorna o objeto da skin, caso exista.

    Args:
        name (str): Nome da skin.

    Returns:
        Skin (Skin): O objeto que contém os dados da skin.
        None (None): Caso o nome da skin não seja válida.
    """
    name = name.lower()

    for champion in self.champions.values():
        if name not in champion["skins"]:
            continue

        skin_data = champion["skins"][name]
        return Skin(self, champion, skin_data)

    return None

get_splash_art(champion_id, skin_id) staticmethod

Retorna a URL do campeão ou da skin desejada com base em seus IDS.

Source code in league_data/explorer.py 
64
65
66
67
@staticmethod
def get_splash_art(champion_id: str, skin_id: str) -> str:
    """Retorna a URL do campeão ou da skin desejada com base em seus IDS."""
    return f"https://raw.communitydragon.org/latest/plugins/rcp-be-lol-game-data/global/default/v1/champion-splashes/{champion_id}/{skin_id}.jpg"

__init__(data, champions=None)

Reformula os dados que recebe como parâmetro.

Caso não receba os champions, será requisitado automaticamente.

Parameters:

Name Type Description Default
data dict

Dados da Riot, gerados pelo League.

 required
champions dict

Dicionário de campeões, gerados pelo Explorer.

 None
Source code in league_data/explorer.py 
69
70
71
72
73
74
75
76
77
78
79
def __init__(self, data: dict, champions: dict | None = None) -> None:
    """Reformula os dados que recebe como parâmetro.

    Caso não receba os champions, será requisitado automaticamente.

    Args:
        data (dict): Dados da Riot, gerados pelo League.
        champions (dict, optional): Dicionário de campeões, gerados pelo Explorer.
    """
    self.data = data  # dados gerados da classe League
    self.champions = champions or self.__get_champions()

__getitem__(name)

Retorna os dados do campeão ou skin, caso exista.

Parameters:

Name Type Description Default
name str

Nome do campeão ou skin.

 required

Returns:

Name Type Description
Champion Champion

Objeto do campeão encontrado.
Skin Skin

Objeto da skin encontrada.
None None

Nenhum item foi encontrado.
Source code in league_data/explorer.py 
81
82
83
84
85
86
87
88
89
90
91
92
93
def __getitem__(self, name: str) -> Champion | Skin | None:
    """Retorna os dados do campeão ou skin, caso exista.

    Args:
        name (str): Nome do campeão ou skin.

    Returns:
        Champion (Champion): Objeto do campeão encontrado.
        Skin (Skin): Objeto da skin encontrada.
        None (None): Nenhum item foi encontrado.
    """
    champion = self.get_champion(name)
    return champion or self.get_skin(name)