gamesheet_sdk.admin.games.brackets module

Bracket and general game list operations.

gamesheet_sdk.admin.games.brackets.list_completed(session, season_id)[source]

Return every completed game in the specified season.

The supplied Session must already carry a bearer token (e.g. via Session.set_bearer_token()); the call is otherwise unauthenticated and will 401.

Parameters:

  • session (Session) – An authenticated Session.

  • season_id (str) – The season identifier whose completed games to list.

Returns:

list[Game] –

A list of Game, in the order the server returned them. The list may be empty if

the season has no completed games.

Return type:

list[Game]

gamesheet_sdk.admin.games.brackets.list_brackets(session, season_id)[source]

Return every bracket game in the specified season.

The supplied Session must already carry a bearer token (e.g. via Session.set_bearer_token()); the call is otherwise unauthenticated and will 401.

Notes

The brackets filter is based on the expected API pattern but has not been verified with real bracket data. If this returns unexpected results, the filter parameters may need adjustment.

Parameters:

  • session (Session) – An authenticated Session.

  • season_id (str) – The season identifier whose bracket games to list.

Returns:

list[Game] –

A list of Game, in the order the server returned them. The list may be empty if

the season has no bracket games.

Return type:

list[Game]

gamesheet_sdk.admin.games.brackets.get_game(session, season_id, game_id)[source]

Get a single game by ID.

The supplied Session must already carry a bearer token (e.g. via Session.set_bearer_token()); the call is otherwise unauthenticated and will 401.

Parameters:

  • session (Session) – An authenticated Session.

  • season_id (str) – The parent season identifier.

  • game_id (int) – The game identifier to retrieve.

Returns:

Game – The Game with the specified ID.

Raises:

GameSheetError – For any other non-2xx response, including 404 if the game is not found.

Return type:

Game