Pular para conteúdo

League

Tenha acesso facilmente aos dados dos campeões e skins do League of Legends.

Attributes:

Name Type Description
data dict

Dados da Riot.
explorer Explorer

Explorador de dados.
champions dict

Dicionário de campeões.
Source code in league_data/league.py 
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
class League:
    """Tenha acesso facilmente aos dados dos campeões e skins do League of Legends.

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

    def update(self) -> None:
        """Atualiza os dados e recria o dicionário de campeões.

        Example:
            ```python linenums="1"
            from league_data import League

            league = League()
            milio = league["milio"]  # -> None
            league.update()  # atualizando os dados e os campeões
            milio = league["milio"]  # -> <league_data.models.Champion object at ...>
            ```
        """
        self.data = self.get_data()
        self.explorer = Explorer(self.data)
        self.champions = self.explorer.champions

    @staticmethod
    def get_data() -> dict:
        """Busca todos os dados dos campeões do League of Legends.

        Uma requisição é feita para conseguir esses dados.

        Raises:
            ConnectionError: Caso não consiga realizar a requisição.

        Returns:
            data (dict): Os dados dos campeões e suas skins.

        Example:
            ```python linenums="1" title="Não é necessário instanciar a classe."
            from league_data import League

            data = League.get_data()  # -> {"1000": {"id": 1000, "isBase": ...}, ...}
            ```
        """
        url = "https://raw.communitydragon.org/latest/plugins/rcp-be-lol-game-data/global/default/v1/skins.json"

        try:
            response = request(method="get", url=url, timeout=10)
        except Timeout as exception:
            message = "A request demorou muito para ser finalizada..."
            raise ConnectionError(message) from exception

        return response.json()

    def __init__(self, data: dict | None = None, champions: dict | None = None) -> None:
        """Cria o um explorador automaticamente para a instância.

        Caso não receba os parâmetros, serão requisitados automaticamente.

        Args:
            data (dict, optional): Dados da Riot, gerados pelo League.
            champions (dict, optional): Dicionário de campeões, gerados pelo Explorer.
        """
        self.data = data or self.get_data()
        self.explorer = Explorer(self.data, champions)
        self.champions = self.explorer.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.
        """
        return self.explorer[name]

update()

Atualiza os dados e recria o dicionário de campeões.

Example 
1
2
3
4
5
6
from league_data import League

league = League()
milio = league["milio"]  # -> None
league.update()  # atualizando os dados e os campeões
milio = league["milio"]  # -> <league_data.models.Champion object at ...>
Source code in league_data/league.py 
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
def update(self) -> None:
    """Atualiza os dados e recria o dicionário de campeões.

    Example:
        ```python linenums="1"
        from league_data import League

        league = League()
        milio = league["milio"]  # -> None
        league.update()  # atualizando os dados e os campeões
        milio = league["milio"]  # -> <league_data.models.Champion object at ...>
        ```
    """
    self.data = self.get_data()
    self.explorer = Explorer(self.data)
    self.champions = self.explorer.champions

get_data() staticmethod

Busca todos os dados dos campeões do League of Legends.

Uma requisição é feita para conseguir esses dados.

Raises:

Type Description
ConnectionError

Caso não consiga realizar a requisição.

Returns:

Name Type Description
data dict

Os dados dos campeões e suas skins.
Example
Não é necessário instanciar a classe.
1
2
3
from league_data import League

data = League.get_data()  # -> {"1000": {"id": 1000, "isBase": ...}, ...}
Source code in league_data/league.py 
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
@staticmethod
def get_data() -> dict:
    """Busca todos os dados dos campeões do League of Legends.

    Uma requisição é feita para conseguir esses dados.

    Raises:
        ConnectionError: Caso não consiga realizar a requisição.

    Returns:
        data (dict): Os dados dos campeões e suas skins.

    Example:
        ```python linenums="1" title="Não é necessário instanciar a classe."
        from league_data import League

        data = League.get_data()  # -> {"1000": {"id": 1000, "isBase": ...}, ...}
        ```
    """
    url = "https://raw.communitydragon.org/latest/plugins/rcp-be-lol-game-data/global/default/v1/skins.json"

    try:
        response = request(method="get", url=url, timeout=10)
    except Timeout as exception:
        message = "A request demorou muito para ser finalizada..."
        raise ConnectionError(message) from exception

    return response.json()

__init__(data=None, champions=None)

Cria o um explorador automaticamente para a instância.

Caso não receba os parâmetros, serão requisitados automaticamente.

Parameters:

Name Type Description Default
data dict

Dados da Riot, gerados pelo League.

 None
champions dict

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

 None
Source code in league_data/league.py 
75
76
77
78
79
80
81
82
83
84
85
86
def __init__(self, data: dict | None = None, champions: dict | None = None) -> None:
    """Cria o um explorador automaticamente para a instância.

    Caso não receba os parâmetros, serão requisitados automaticamente.

    Args:
        data (dict, optional): Dados da Riot, gerados pelo League.
        champions (dict, optional): Dicionário de campeões, gerados pelo Explorer.
    """
    self.data = data or self.get_data()
    self.explorer = Explorer(self.data, champions)
    self.champions = self.explorer.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/league.py 
88
89
90
91
92
93
94
95
96
97
98
99
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.
    """
    return self.explorer[name]