30class SofascoreClient:
 31    """
 32    Client for interacting with the Sofascore website.
 33    This class provides methods to access and retrieve data from Sofascore.
 34    """
 35
 36    def __init__(self) -> None:
 37        self.__service = SofascoreService()
 38
 39    def get_events(self, date: str = 'today', live: bool = False) -> list[Event]:
 40        """
 41        Get the scheduled events.
 42
 43        Args:
 44            date (str): The date of the events in the format "YYYY-MM-DD" or "today".
 45            live (bool): Whether to get the live events (more precise).
 46
 47        Returns:
 48            list[Event]: The scheduled events.
 49        """
 50        if live:
 51            return self.__service.get_live_events()
 52        return self.__service.get_events(date)
 53
 54    def get_event(self, event_id: int) -> Event:
 55        """
 56        Get the event information.
 57
 58        Args:
 59            event_id (int): The event id.
 60
 61        Returns:
 62            Event: The event information.
 63        """
 64        return self.__service.get_event(event_id)
 65
 66    def get_player(self, player_id: int) -> Player:
 67        """
 68        Get the player information.
 69
 70        Args:
 71            player_id (int): The player id.
 72
 73        Returns:
 74            Player: The player information.
 75        """
 76        return self.__service.get_player(player_id)
 77
 78    def get_match_incidents(self, event_id: int) -> list[Incident]:
 79        """
 80        Get the events of a match.
 81
 82        Args:
 83            event_id (int): The event id.
 84
 85        Returns:
 86            list[Incident]: The match incidents.
 87        """
 88        return self.__service.get_match_incidents(event_id)
 89
 90    def get_match_top_players(self, event_id: int) -> TopPlayersMatch:
 91        """
 92        Get the top players of a match.
 93
 94        Args:
 95            event_id (int): The event id.
 96
 97        Returns:
 98            TopPlayersMatch: The match top players.
 99        """
100        return self.__service.get_match_top_players(event_id)
101
102    def get_match_comments(self, event_id: int) -> list[Comment]:
103        """
104        Get the comments of a match.
105
106        Args:
107            event_id (int): The event id.
108
109        Returns:
110            list[Comment]: The match comments.
111        """
112        return self.__service.get_match_comments(event_id)
113
114    def get_match_stats(self, event_id: int) -> MatchStats:
115        """
116        Get the match statistics by event id.
117
118        Args:
119            event_id (int): The event id (also known as match id).
120
121        Returns:
122            MatchStats: The match statistics.
123        """
124        return self.__service.get_match_stats(event_id)
125
126    def get_match_lineups(self, event_id: int) -> Lineups:
127        """
128        Get the match lineups.
129
130        Args:
131            event_id (int): The event id.
132
133        Returns:
134            Lineups: The match lineups.
135        """
136        return self.__service.get_match_lineups(event_id)
137
138    def get_match_shots(self, event_id: int) -> list[Shot]:
139        """
140        Get the shots of a match.
141
142        Args:
143            event_id (int): The event id.
144
145        Returns:
146            list[Shot]: The match shots.
147        """
148        return self.__service.get_match_shots(event_id)
149
150    def get_team(self, team_id: int) -> Team:
151        """
152        Get detailed information about a team.
153
154        Args:
155            team_id (int): The team id.
156
157        Returns:
158            TeamEx: The team information.
159        """
160        team: Team = self.__service.get_team(team_id)
161        players: list[Player] = self.__service.get_team_players(team_id)
162        team.players = players
163        return team
164
165    def get_team_players(self, team_id: int) -> list[Player]:
166        """
167        Get the players of a team.
168
169        Args:
170            team_id (int): The team id.
171
172        Returns:
173            list[Player]: The players of the team.
174        """
175        return self.__service.get_team_players(team_id)
176
177    def get_team_events(
178        self, team_id: int, upcoming: bool = False, page: int = 0
179    ) -> list[Event]:
180        """
181        Get the events (matchs) of a team.
182
183        Args:
184            team_id (int): The team id.
185            upcoming (bool): Whether to get the upcoming events.
186            page (int): The page number.
187
188        Returns:
189            list[Event]: The events of the team.
190        """
191        return self.__service.get_team_events(team_id, upcoming, page)
192
193    def get_tournaments(self, category_id: Category) -> list[Tournament]:
194        """
195        Get the tournaments by category.
196        TODO: maybe add a argument to include seasons.
197
198        Args:
199            category_id (Category): The category id.
200
201        Returns:
202            list[Tournament]: The tournaments.
203        """
204        return self.__service.get_tournaments_by_category(category_id)
205
206    def get_tournament_seasons(self, tournament_id: int) -> list[Season]:
207        """
208        Get the seasons of a tournament.
209
210        Args:
211            tournament_id (int): The tournament id.
212
213        Returns:
214            list[Season]: The seasons of the tournament.
215        """
216        return self.__service.get_tournament_seasons(tournament_id)
217
218    def get_tournament_brackets(
219        self, tournament_id: int | Tournament, season_id: int | Season
220    ) -> list[Bracket]:
221        """
222        Get the tournament bracket.
223
224        Args:
225            tournament_id (int, Tournament): The tournament id.
226            season_id (int, Season): The season id.
227
228        Returns:
229            list[Bracket]: The tournament bracket.
230        """
231        return self.__service.get_tournament_bracket(tournament_id, season_id)
232
233    def get_tournament_standings(
234        self, tournament_id: int | Tournament, season_id: int | Season
235    ) -> list[Standing]:
236        """
237        Get the tournament standings.
238
239        Args:
240            tournament_id (int, Tournament): The tournament id.
241            season_id (int, Season): The season id.
242
243        Returns:
244            list[Standing]: The tournament standings.
245        """
246        return self.__service.get_tournament_standings(tournament_id, season_id)
247
248    def get_tournament_top_teams(
249        self, tournament_id: int | Tournament, season_id: int | Season
250    ) -> TopTournamentTeams:
251        """
252        Get the top teams of the tournament.
253
254        Args:
255            tournament_id (int, Tournament): The tournament id.
256            season_id (int, Season): The season id.
257
258        Returns:
259            TopTournamentTeams: The top teams of the tournament.
260        """
261        return self.__service.get_tournament_top_teams(tournament_id, season_id)
262
263    def get_tournament_top_players(
264        self, tournament_id: int | Tournament, season_id: int | Season
265    ) -> TopTournamentPlayers:
266        """
267        Get the top players of the tournament.
268
269        Args:
270            tournament_id (int, Tournament): The tournament id.
271            season_id (int, Season): The season id.
272
273        Returns:
274            TopTournamentPlayers: The top players of the tournament.
275        """
276        return self.__service.get_tournament_top_players(tournament_id, season_id)
277
278    def get_tournament_events(
279        self,
280        tournament_id: int | Tournament,
281        season_id: int | Season,
282        upcoming: bool = False,
283        page: int = 0,
284    ) -> list[Event]:
285        """
286        Get the events of the tournament.
287
288        Args:
289            tournament_id (int, Tournament): The tournament id.
290            season_id (int, Season): The season id.
291            upcoming (bool): Whether to get the upcoming events.
292            page (int): The page number.
293
294        Returns:
295            list[Event]: The events of the tournament.
296        """
297        return self.__service.get_tournament_events(
298            tournament_id, season_id, upcoming, page
299        )
300
301    def search(
302        self, query: str, entity: str | EntityType = EntityType.ALL
303    ) -> list[Event | Team | Player | Tournament]:
304        """
305        Search query for matches, teams, players, and tournaments.
306
307        Args:
308            query (str): The search query.
309            entity (str, EntityType): The entity type to search for.
310
311        Returns:
312            list[Event | Team | Player | Tournament]: The search results.
313        """
314        if isinstance(entity, str):
315            entity = EntityType(entity)
316        return self.__service.search(query, entity)

13class PromiedosClient:
14    """
15    Client for interacting with the Promiedos website.
16    This class provides methods to access and retrieve data from Promiedos.
17    """
18
19    def __init__(self) -> None:
20        """
21        Initializes the Promiedos client.
22        """
23        self.__service = PromiedosService()
24
25    def get_events(self, date: str = "today") -> list[Event]:
26        """
27        Get the events for the given date.
28
29        Args:
30            date (str): The date to get the events. Defaults to "today".
31
32        Returns:
33            list[Event]: The events for the given date.
34        """
35        return self.__service.get_events(date)
36
37    def get_match(self, match_id: str = None, match: Match = None) -> Match:
38        """
39        Get the match for the given slug and match ID.
40
41        Args:
42            match_id (str): The match ID. E.g. "ediecji".
43            Match (Match): The match object.
44
45        Returns:
46            Match: The match for the given slug and match ID.
47        """
48        if not match_id and not match:
49            raise NotMatchIdProvided(
50                "No match ID provided OR no match object provided."
51            )
52        if match:
53            return self.__service.get_match(match.id)
54        return self.__service.get_match(match_id)
55
56    def get_tournament(self, tournament_id: str) -> Tournament:
57        """
58        Get the matches for the given tournament ID.
59
60        Args:
61            tournament_id (str): The tournament ID. E.g. "hc".
62
63        Returns:
64            Tournament: The tournament for the given tournament ID.
65        """
66        return self.__service.get_tournament(tournament_id)
67
68    def get_tournament_matchs(
69        self, tournament_id: str, stage_id: str = None
70    ) -> list[Match]:
71        """
72        Get the matches for the given tournament ID using the stage ID.
73
74        Args:
75            tournament_id (str): The tournament ID. E.g. "hc".
76            stage_id (str): The stage ID.
77        Returns:
78            list[Match]: The matches for the given tournament ID.
79        """
80        return self.__service.get_tournament_matchs(tournament_id, stage_id)

12class FBrefClient:
13    """
14    A class to represent the client for interacting with the FBref website.
15    """
16
17    def __init__(self, language: str = "en", proxies: dict = None) -> None:
18        """
19        Initializes the Sofascore client.
20        """
21        self.__service = FBrefService(language=language, proxies=proxies)
22
23    def get_matchs(self, date: str = None) -> list[Match]:
24        """
25        Get the scheduled matchs.
26
27        Args:
28            date (str): The date of the matchs in the format "YYYY-MM-DD".
29
30        Returns:
31            list[Match]: The scheduled matchs.
32        """
33        return self.__service.get_matchs(date)
34
35    def get_match_details(self, match_id: str) -> MatchDetails:
36        """
37        Get the match report.
38
39        Args:
40            match_id (str): The match id.
41
42        Returns:
43            MatchDetails: The match details.
44        """
45        return self.__service.get_match_details(match_id)