Players

class Player(player_id)[source]

A player, loaded from the ESPN core API athlete record.

Example values are for Player(277916), Ajinkya Rahane.

Parameters:

player_id (int)

player_id: int

ESPNcricinfo player id.

json: dict[str, Any]

The core API athlete record.

name: str

Name as printed on scorecards, 'Ajinkya Rahane'.

first_name: str

'Ajinkya'.

full_name: str

'Ajinkya Madhukar Rahane'.

date_of_birth: date | None

Date of birth, or None if ESPN has none.

age: int | None

Age in years as ESPN reports it, or None.

playing_role: str | None

'Top-order batter', or None.

batting_style: str | None

'Right-hand bat', or None.

bowling_style: str | None

'Right-arm medium', or None.

property major_teams: list[str]

Names of the player’s major teams (one request per team, on first access).

get_career_averages(file_name=None, match_format=11, data_type='allround')[source]

Write career averages (overall and by span) to a CSV file.

Parameters:

  • file_name (str | None) – Output path. Defaults to {player_id}_{match_format}_{data_type}_career_averages.csv.

  • match_format (int) – 1 Test, 2 ODI, 3 T20I, 11 all international, 20 youth Test, 21 youth ODI.

  • data_type (str) – allround, batting, bowling or fielding.

Return type:

None

get_career_summary(file_name=None, match_format=11, data_type='allround')[source]

Write the career summary (one row per format, venue, opponent…) to CSV.

Parameters:

  • file_name (str | None) – Output path. Defaults to {player_id}_{match_format}_{data_type}_career_summary.csv.

  • match_format (int) – 1 Test, 2 ODI, 3 T20I, 11 all international, 20 youth Test, 21 youth ODI.

  • data_type (str) – allround, batting, bowling or fielding.

Return type:

None

get_data(file_name=None, match_format=11, data_type='allround', view='match')[source]

Write the player’s record match by match (or another view) to CSV.

Parameters:

  • file_name (str | None) – Output path. Defaults to {player_id}_{match_format}_{data_type}_{view}.csv.

  • match_format (int) – 1 Test, 2 ODI, 3 T20I, 11 all international, 20 youth Test, 21 youth ODI.

  • data_type (str) – allround, batting, bowling or fielding.

  • view (str) – match, innings, cumulative, reverse_cumulative, series, tour or ground.

Return type:

None