ncaa_eval.ingest.connectors.espn module

ESPN data source connector backed by the cbbpy scraper library.

The EspnConnector fetches current/recent season game data from ESPN via cbbpy. It does not provide team or season master data — those come exclusively from the Kaggle connector. A team_name_to_id mapping (built from Kaggle’s MTeams.csv) is required for translating ESPN team names into Kaggle integer IDs.

class ncaa_eval.ingest.connectors.espn.EspnConnector(team_name_to_id: dict[str, int], season_day_zeros: dict[int, date])[source]

Bases: Connector

Connector for ESPN game data via the cbbpy scraper.

Parameters:

  • team_name_to_id – Mapping from team name strings to Kaggle TeamIDs.

  • season_day_zeros – Mapping from season year to DayZero date.

fetch_games(season: int) → list[Game][source]

Fetch game results for season from ESPN via cbbpy.

Uses get_team_schedule() for each team in the mapping and deduplicates by ESPN game ID.