Release nflreadr 1.5.0 · nflverse/nflreadr

This release covers changes released before the start of the 2025 NFL season.

Breaking Changes

load_players() now loads v2 nflverse players data. This is a breaking change as some variables have been removed or renamed. Please see the data comparison for more details.
load_player_stats() now access new player_stats files created by nflfastR::calculate_stats() (#279) and has a few function signature changes:
- stat_type argument is deprecated - now returns offense, defense, and kicking player statistics as one file.
- gains a new argument summary_level so that it can return player stats summarized by week, regular season, postseason, or regular + postseason combined
load_team_stats() added to access new team_stats files created by nflfastR::calculate_stats() (#279)
load_depth_charts() now provides depth charts by date (including the preseason), and defaults to most_recent_season(roster = TRUE), rather than most_recent_season(roster = FALSE). Please note that the data structure has changed because the data source had to be changed from NFL Data Exchange to ESPN. (#275, #277)
load_participation() is back, somewhat! FTNData.com has graciously offered to provide participation data after each season has ended, so we now have participation data from 2024 and 2023. Please note that this data is licensed under CC-BY-SA 4.0 and should be credited (for 2023 onwards) to FTN Data via nflverse. (#278)
Now requires a minimum R version of 4.1.0, to align with the tidyverse's version support policies.

nflreadr now exports the variable nflreadr::nflverse_data_timezone which defines the standard timezone across all nflverse data. When printing to the console, nflreadr will convert timestamps to the user local timezone.
Added several player name mappings (#249, #253, #255, #270)
Added a dictionary to describe what each shorthand roster status indicates (#232)
clean_team_abbrs() now converts "PHO" to "ARI". (#260)
Improved description of next score probability variables in nflreadr::dictionary_pbp. (#262)
.sitrep and all *_sitrep functions now redact nflfastR option paths. (#263)
clean_team_abbrs() now converts full team names like "Los Angeles Chargers" or team nicknames like "Bills" to corresponding team abbreviations ("LAC" and "BUF" in this example). (#269)
get_current_week() now passes arguments on to most_recent_season(). (#272)