Clear the cfbfastR ESPN catalog cache

The ESPN college football game wrappers enrich their output with team and position detail drawn from two static catalogs – espn_cfb_teams() (~750 teams) and espn_cfb_positions() (~74 positions). Because those catalogs do not change often, the internal lookups built from them are memoised with cachem + memoise, so a loop over many games does not re-hit ESPN for the catalogs on every call.

espn_cfb_clear_cache() forgets those memoised lookups. The next wrapper call that needs a catalog will fetch a fresh copy from ESPN. Use it when you want to force a refresh – for example after a long-running session, or when debugging.

Usage

espn_cfb_clear_cache()

Value

Invisibly returns NULL. Called for its side effect of forgetting the memoised catalog lookups.

Details

Clear the cfbfastR ESPN catalog cache

Caching is configured at package load via two options():

• cfbfastR.cache – cache backend. One of "memory" (default; in-memory cachem::cache_mem(), cleared when the session ends), "filesystem" (persistent on-disk cachem::cache_disk() under tools::R_user_dir()), or "off" (no memoisation – every catalog fetch hits ESPN).

• cfbfastR.cache_duration – cache time-to-live in seconds. Defaults to 86400 (24 hours).

Set these with options() before the package is loaded, e.g. options(cfbfastR.cache = "filesystem"). When cfbfastR.cache is "off", the catalog helpers are never memoised and espn_cfb_clear_cache() is a no-op (it still returns invisibly without error).

See also

Other ESPN CFB Functions: espn_cfb_award(), espn_cfb_awards(), espn_cfb_coach(), espn_cfb_coach_record(), espn_cfb_coaches(), espn_cfb_franchise(), espn_cfb_franchises(), espn_cfb_futures(), espn_cfb_game_broadcasts(), espn_cfb_game_drive_plays(), espn_cfb_game_drives(), espn_cfb_game_leaders(), espn_cfb_game_odds(), espn_cfb_game_pbp(), espn_cfb_game_play(), espn_cfb_game_player_box(), espn_cfb_game_player_statistics(), espn_cfb_game_powerindex(), espn_cfb_game_predictor(), espn_cfb_game_probabilities(), espn_cfb_game_situation(), espn_cfb_game_status(), espn_cfb_game_team_leaders(), espn_cfb_game_team_linescores(), espn_cfb_game_team_records(), espn_cfb_game_team_roster(), espn_cfb_game_team_statistics(), espn_cfb_game_teams(), espn_cfb_groups(), espn_cfb_pbp_v2(), espn_cfb_player(), espn_cfb_player_career_stats(), espn_cfb_player_eventlog(), espn_cfb_player_gamelog(), espn_cfb_player_overview(), espn_cfb_player_seasons(), espn_cfb_player_splits(), espn_cfb_player_stats_v3(), espn_cfb_players(), espn_cfb_position(), espn_cfb_positions(), espn_cfb_powerindex(), espn_cfb_qbr(), espn_cfb_rankings(), espn_cfb_recruits(), espn_cfb_season_info(), espn_cfb_season_types(), espn_cfb_season_weeks(), espn_cfb_seasons(), espn_cfb_standings(), espn_cfb_team(), espn_cfb_team_ats(), espn_cfb_team_awards(), espn_cfb_team_coaches(), espn_cfb_team_events(), espn_cfb_team_leaders(), espn_cfb_team_powerindex(), espn_cfb_team_ranks(), espn_cfb_team_record(), espn_cfb_team_roster(), espn_cfb_team_schedule(), espn_cfb_teams(), espn_cfb_unnest_plays(), espn_cfb_venue(), espn_cfb_venues(), espn_cfb_week_rankings()

Examples

# \donttest{
  # Force the team / position catalogs to be re-fetched on next use
  espn_cfb_clear_cache()
# }