Skip to contents

Clear the cfbfastR lookup cache

Source: R/espn_cfb_game.R
espn_cfb_clear_cache.Rd

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, and also the per-season CFBD team catalog and roster that cfbd_pbp_data() memoises to attach team and player ids. The next call that needs one fetches it again. 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 lookup 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 lookup hits the API).

  • 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()
# }