trackmania.cotd module

class trackmania.cotd.BestCOTDStats(best_rank: int, best_rank_time: datetime, best_rank_div_rank: int, best_div: int, best_div_time: datetime, best_rank_in_div: int, best_rank_in_div_time: datetime, best_rank_in_div_div: int)[source]

Bases: COTDObject

New in version 0.3.0.

Represents the Best COTD Stats of player as shows in the COTD Stats Page.

Parameters

  • best_rank (int) – The best rank achieved by the player.

  • best_rank_time (datetime) – The time when best_rank was achieved.

  • best_rank_div_rank (int) – The rank achieved in the division of the best_rank.

  • best_div (int) – The best division of the player.

  • best_div_time (datetime) – The time when best_div was achieved.

  • best_rank_in_div (int) – The best rank the player achieved in any division.

  • best_rank_in_div_time (datetime) – The time when best_rank_in_div was achieved.

  • best_rank_in_div_div (int) – The division of the best_rank_in_div.

class trackmania.cotd.COTD(cotd_id: int, name: str, player_count: int, start_date: datetime, end_date: datetime)[source]

Bases: COTDObject

New in version 0.3.0.

Represents a Cup of the Day

Parameters

  • cotd_id (int) – The cotd id

  • name (str) – The name of the cotd

  • player_count (int) – The number of players that played the COTD

  • start_date (datetime) – The start date of the COTD

  • end_date (datetime) – The end date of the COTD

async classmethod get_cotd(page: int = 0) → list[typing_extensions.Self][source]

New in version 0.3.0.

Fetches the Latest COTDs and returns its data.

Parameters

page (int, optional) – The page, each page contains 12 items. by default 0

Returns

The COTDs

Return type

list[COTD]

class trackmania.cotd.PlayerCOTD(total: int, recent_results: list[trackmania.cotd.PlayerCOTDResults], stats: PlayerCOTDStats, player_id: str)[source]

Bases: COTDObject

New in version 0.3.0.

The Player’s COTD Data

Parameters

  • total (int) – Total COTD’s Played

  • recent_results (list[PlayerCOTDResults]) – Represents the recent COTD results the player has gotten

  • stats (PlayerCOTDStats) – Represents the Statistics of the Player’s COTD career

  • player_id (str) – The player’s ID

async classmethod get_page(player_id: str, page: int = 0) → Self[source]

New in version 0.3.0.

Gets the Player’s COTD Stats of a particular page.

Parameters

  • player_id (str) – The player’s ID

  • page (int, optional) – The page of the ID, by default 0

class trackmania.cotd.PlayerCOTDResults(id: int, timestamp: datetime, name: str, div: int, rank: int, div_rank: int | None, score: int | None, total_players: int)[source]

Bases: COTDObject

New in version 0.3.0.

Represents a Player’s COTD Result.

Parameters

  • id (int) – The ID of the COTD.

  • timestamp (datetime) – The timestamp of the COTD.

  • name (str) – The name of the COTD

  • div (int) – The division the player achieved

  • rank (int) – The rank the player achieved

  • div_rank (int | None) – The rank the player achieved in the division. If the player did not play in the division, this will be None.

  • score (int | None) – The score of the player. If the player did not play after qualifying for the COTD, this will be None.

  • total_players (int) – The total players that played this COTD.

class trackmania.cotd.PlayerCOTDStats(average_div: float, average_div_rank: float, average_rank: float, best_overall: BestCOTDStats, best_primary: BestCOTDStats, div_win_streak: int, total_div_wins: int, total_wins: int, win_streak: int)[source]

Bases: COTDObject

New in version 0.3.0.

Represents the COTD Stats of a player as shows in the COTD Stats Page.

Parameters

  • average_div (float) – The average div of the player

  • average_div_rank (float) – The average div rank of the player

  • average_rank (float) – The average rank of the player

  • best_overall (BestCOTDStats) – The best overall rank of the player

  • best_primary (BestCOTDStats) – The best primary rank of the player

  • div_win_streak (int) – The div win streak of the player

  • total_div_wins (int) – The total div wins of the player

  • total_wins (int) – The total wins of the player

  • win_streak (int) – The win streak of the player