Table of Contents generated with DocToc

• wehoop 3.0.0
• wehoop 2.1.0
• wehoop 2.0.0
• wehoop 1.9.0
• wehoop 1.8.0
• wehoop 1.7.0
• wehoop 1.6.0
• wehoop 1.5.0
• ~106 WNBA Stats API functions added
• Adds 4 ESPN WBB and WNBA functions
• wehoop 1.2.1
• wehoop 1.2.0
• wehoop 1.1.1
• wehoop 1.1.0
• wehoop 1.0.0
• wehoop 0.9.2
• wehoop 0.9.1
• wehoop 0.9.0
• wehoop 0.3.0
• wehoop 0.2.0
• wehoop 0.1.0

wehoop 3.0.0

WBB cross-source crosswalk (wbb_*_crosswalk / load_wbb_*_crosswalk)

Three new live builders — wbb_team_crosswalk(), wbb_schedule_crosswalk(), wbb_player_crosswalk() — and three cached loaders — load_wbb_team_crosswalk(), load_wbb_schedule_crosswalk(), load_wbb_player_crosswalk() — link ESPN, Fox Sports (Bifrost), and Bart Torvik (barttorvik.com/ncaaw) WBB team/game/player identities into wide, one-row-per-entity tibbles keyed on espn_team_id. Team and schedule crosswalks use deterministic normalized-name joins with curated alias tables for known ESPN/Fox/Torvik name divergences (e.g. “UConn” / “Connecticut”, “Ole Miss” / “Mississippi”); player matching uses blocked Jaro-Winkler fuzzy matching with jersey tiebreakers (min_confidence = 0.92). Yahoo columns are NA placeholders reserved for a future source.

Two new women’s Bart Torvik scrapers — bart_wbb_ratings() (T-Rank team ratings) and bart_wbb_game_schedule() (full season schedule + results) — pull CSV/JSON from barttorvik.com/ncaaw. A new fox_wbb_teams_all() enumerator walks unseen Fox team ids to assemble the complete WBB team directory (single fox_wbb_teams() calls only return one conference at a time). Parallels the WNBA crosswalk surface added in the same release.

WNBA cross-source crosswalk (wnba_*_crosswalk / load_wnba_*_crosswalk)

Three new live builders — wnba_team_crosswalk(), wnba_schedule_crosswalk(), wnba_player_crosswalk() — and three cached loaders — load_wnba_team_crosswalk(), load_wnba_schedule_crosswalk(), load_wnba_player_crosswalk() — link ESPN, WNBA Stats API, and Fox Sports team/game/player identities into wide, one-row-per-entity tibbles. wnba_team_crosswalk() and wnba_player_crosswalk() are keyed on espn_team_id; wnba_schedule_crosswalk() is keyed on espn_game_id. Team and schedule crosswalks use deterministic normalized-name joins; player matching uses blocked Jaro-Winkler fuzzy matching with jersey/DOB tiebreakers (min_confidence = 0.92). Yahoo columns are NA placeholders reserved for a future source. A new fox_wnba_teams() / fox_wbb_teams() wrapper provides the Fox Bifrost team directory used by the crosswalk engine. Cached artifacts are backed by the wnba_crosswalk release tag in sportsdataverse-data.

Fox Sports basketball wrappers (fox_wnba_* / fox_wbb_*)

Read-only Fox Sports “Bifrost” basketball wrappers over api.foxsports.com/bifrost/v1/{wnba,wcbk}/*, complementing the espn_wnba_* / espn_wbb_* families. Eight wrappers per league flatten Fox’s layout-oriented JSON (sections → tables → rows → cells) into tidy wehoop_data tibbles: fox_<lg>_pbp (period-based play-by-play), _boxscore, _odds, _team_roster, _team_stats, _team_gamelog, _standings, _league_leaders. A shared internal layer backs both leagues. Verified live; reverse-engineering notes + an OpenAPI 3.1 spec live in the sdv-internal-refs repo. Parallels the cfbfastR / hoopR / fastRhockey / baseballr / sportsdataverse-py fox_* families.

Her Hoop Stats (hhs_*) — subscription

New hhs_*() family for Her Hoop Stats, a subscription women’s-basketball statistics service. Like hoopR’s KenPom kp_*() wrappers, these log in with the subscriber’s own credentials (read from the email/password arguments, the wehoop.herhoopstats_email / wehoop.herhoopstats_password options, or the HERHOOPSTATS_EMAIL / HERHOOPSTATS_PW environment variables — never bundled) and reuse the session cookie:

• hhs_teams(min_season, max_season, division) — NCAA women’s team single-season summary index (with a team_link per row).
• hhs_team_stats(team_link) — a team’s statistics page.
• hhs_team_roster(team_link) — a team’s player roster.

Examples are \dontrun{} and tests skip unless credentials are present, so R CMD check never attempts a login. Because the service is subscriber-only, the login flow and member-table selectors are provided as a starting point and may need adjustment if the site changes.

WNBA Basketball-Reference (bref_wnba_*)

New bref_wnba_*() family scraping WNBA data from Basketball-Reference — a deep historical source (back to 1997) wehoop did not previously cover, complementing the WNBA Stats API and ESPN wrappers. No account or API key is required:

• bref_wnba_player_stats(season, table) — league-wide player season stats (table = "per_game" / "totals" / "advanced").
• bref_wnba_team_stats(season, table) — team season stats (table = "per_game" / "totals" / "per_poss" / "advanced").
• bref_wnba_standings(season) — both conferences, labelled Eastern / Western.

All echo the requested season (and the stat table) as columns. The two Sports-Reference scraping quirks are handled internally (comment-hidden tables are un-commented; columns are read from each cell’s data-stat attribute). Basketball-Reference rate-limits aggressive scraping (~20 requests/minute); examples are \donttest{} and tests are network-gated.

ESPN endpoint naming convention (game_/player_)

The new-in-3.0.0 ESPN endpoint wrappers are named with the shared sportsdataverse taxonomy used by cfbfastR/hoopR: event_competitor* → game_team*, event_competition → game, event_* → game_*, and athlete_* → player_* (58 functions). These wrappers are new this release and were never on CRAN (2.1.0), so the convention is applied directly without deprecation shims. The web-common-v3 /athletes/{id}/stats wrapper becomes *_player_stats_v3 (kept alongside the core-v2 *_player_stats, a different endpoint). The long-standing espn_wnba_pbp() / espn_wnba_team_box() / etc. are unaffected.

New exported functions

NCAA WBB league-wide RAPM loader

New WNBA Stats API V3 endpoints

58 new ESPN endpoint wrappers (across 7 domains)

Built on shared internal helpers in R/espn_basketball_*_helpers.R so each WBB/WNBA pair stays DRY (one bugfix to the helper propagates to both). The pkgdown reference index was reorganized into 14 per-domain ESPN subsections to scale the rendered nav.

News & calendar

Injuries

WBB injury data is typically sparse on ESPN; both variants return an empty tibble (rather than erroring) when no injuries are reported.

Team detail

Athlete coverage (8 endpoints × 2 leagues = 16 functions)

WNBA-only ESPN endpoints

Event detail — all under core-v2 /events/{id}/competitions/{id}/

League-wide catalog (6 endpoints × 2 leagues = 12 functions)

New data loaders (50+ functions)

All loaders follow the existing load_wnba_pbp() shape — (seasons, ..., dbConnection = NULL, tablename = NULL), progressively() decorator, data.table::rbindlist(use.names = TRUE, fill = TRUE), optional DB write, and a final wehoop_data class set on the in-memory result. Tests gated by WEHOOP_LOAD_TESTS=1 via skip_load_test() in tests/testthat/helper-skip.R. All datasets read from new sportsdataverse-data release tags published by the wehoop-wbb-data, wehoop-wnba-data, and wehoop-wnba-stats-data pipelines.

Season-level rosters and player stats

New file R/load_wnba_stats.R houses the four wnba_stats_* loaders. Adds most_recent_wnba_stats_season() helper in R/utils.R (thin wrapper around most_recent_wnba_season() for naming symmetry with the wnba_stats_* family).

Season-summary loaders

Shot events, per-game rosters, game officials

WNBA Stats API schedule + game logs + PBP

Populated by the rewritten wehoop-wnba-stats-data/R/wnba_stats_01_pbp.R pipeline (V3 PBP with on-court lineups supplied directly by wnba_pbp(), plus possession assignment, FT-to-foul attribution, garbage-time flag, and a per-season + master schedule build). All three datasets are wired into update_wnba_stats_db() (datasets = c("schedule", "player_game_logs", "pbp", ...)).

Manifest helpers + selective DB updates

• Adds 25 load_*_manifest() helpers (one per non-PBP/non-schedule dataset across the three release-tag families). Each manifest returns the per-season season / row_count / generated_at_utc / source_endpoint CSV attached to its release tag, so users can discover available seasons without triggering a heavy load_*() call.
• Adds a datasets= argument on update_wnba_db() / update_wbb_db() and a new update_wnba_stats_db() for selective DB population. Example: update_wbb_db(datasets = c("rosters", "player_stats")). When datasets=NULL, the historical play-by-play behavior is preserved.

Vignettes & reference reorganization

• Adds vignettes/espn-endpoints.Rmd covering all 80 ESPN basketball wrappers (existing 22 + 58 new).
• Reorganizes the pkgdown reference index into 14 per-domain ESPN subsections so the rendered nav scales for the new surface.

Tier 1 core-v2 expansion (crawler-driven)

20 new wrappers across 9 resource families, paired with the matching hoopR additions. Surfaced by an internal $ref-following crawler that mapped the entire reachable basketball API surface (21,962 fetches, 1,570 unique templates across all 4 basketball leagues). Each wrapper is a thin shim over a shared .espn_basketball_*() helper.

Tier 2A core-v2 expansion — season metadata

10 new wrappers across 5 resource families covering season-level metadata: season types, the per-(season × season-type) leaderboards, and (mostly college-only) season rankings. Backed by a shared R/espn_basketball_season_meta_helpers.R. NBA + MBB siblings ship in hoopR’s matching release.

Tier 2A core-v2 expansion — weeks + per-week rankings

8 new wrappers across 4 resource families covering the week structure of a season. Backed by a shared R/espn_basketball_week_helpers.R. NBA + MBB siblings ship in hoopR’s matching release.

Tier 2A core-v2 expansion — groups (conferences and divisions)

8 new wrappers across 4 resource families covering the per-season group hierarchy. Backed by a shared R/espn_basketball_group_helpers.R. NBA + MBB siblings ship in hoopR’s matching release.

Tier 2A core-v2 expansion — team deep + coach-in-season

4 new wrappers paired with hoopR’s Tier 2A team-deep release. Backed by R/espn_basketball_team_deep_helpers.R. (The odds-records and depth-chart endpoints are NBA / MBB only at ESPN — those siblings live in hoopR.)

Tier 2A core-v2 expansion — athlete career + draft pick

5 new wrappers paired with hoopR’s matching release.

Tier 2B core-v2 expansion — athlete event log + draft completion

5 new wrappers paired with hoopR’s matching release.

Tier 2B core-v2 expansion — event meta endpoints

8 new wrappers per league (16 across both packages) wrapping events/{eid}/competitions/{cid}/.... Paired with hoopR’s matching release.

Tier 2B core-v2 expansion — event competitor sub-resources

5 new resource families under events/{eid}/competitions/{cid}/competitors/{team_id}/, each shimmed for WNBA and WBB (10 new public functions). Paired with hoopR’s matching release.

Tier 2F core-v2 expansion — typed-detail companions

5 new resource families completing index/detail pairs for existing wrappers. WBB has no league-wide draft; WNBA has no coach/tournament wrappers — those families ship in the leagues where the index exists.

_pkgdown.yml updated for both WBB + WNBA.

Tier 2E.2 core-v2 expansion — team-season stats + quick lookups

3 new resource families across WNBA + WBB (5 new exports — season_draft is WNBA-only). Paired with hoopR’s matching release.

_pkgdown.yml updated to surface the new entries.

Tier 2E.1 core-v2 expansion — event-scoped player + play deep dives

4 new resource families covering per-game player stats, starter/DNP metadata, single-play detail, and on-court personnel (8 new public functions). Paired with hoopR’s matching release.

Tier 2D core-v2 expansion — position dictionary

2 new resource families for the league-specific position dictionary (4 new public functions). Position ids are not shared across the basketball family — id 1 resolves to Point Guard in WNBA and Center in WBB. These wrappers make the dictionary explicit so users can disambiguate position $ref URLs in athlete records.

Both _pkgdown.yml league-catalog subsections updated to surface the new entries.

pkgdown index

The wehoop pkgdown reference index now lists every Tier 1 + Tier 2A wrapper (the 3.0.0 pkgdown build was failing with “topics missing from index” for the Tier 1 additions — fixed by adding a “Core-v2 expansion” subsection per league).

Late-cycle additions and fixes (August 2026)

NCAA women’s-basketball + model-dataset loaders

Seventeen further bulk-data loaders, following the established loader shape:

• A 13-function NCAA women’s-basketball family reading the stats.ncaa.org-derived datasets produced by the companion sportsdataverse-py engine (wehoop ships loaders only): load_ncaa_wbb_pbp(), load_ncaa_wbb_shots() (2019+), load_ncaa_wbb_lineups(), load_ncaa_wbb_matchup_stints(), load_ncaa_wbb_possessions(), load_ncaa_wbb_rapm() (league-wide regularized adjusted plus-minus, 2011+), load_ncaa_wbb_rapm_within_team(), load_ncaa_wbb_player_box(), load_ncaa_wbb_team_box(), load_ncaa_wbb_rosters(), load_ncaa_wbb_team_rosters(), load_ncaa_wbb_schedule(), and load_ncaa_wbb_team_ids() (2010+ unless noted).
• load_wnba_stats_possessions() (1997+), also registered in update_wnba_stats_db().
• Three model datasets: load_wnba_player_impact() (1997+), load_wbb_player_value() (2014+), and load_wbb_ratings() (2008+).

Fixes

• wnba_pbp() (V3): when the flaky upstream gamerotation call fails or returns empty, on-court player columns are now inferred from substitution events (the pre-V3 method) instead of degrading to all-NA, with a warning naming the affected game id.
• espn_wbb_standings() now requests ESPN’s conference-grouped standings — the flat league list silently omitted the six 2022-23 Division-I newcomer programs (356 of 362 teams). All 362 teams are returned and the result gains a conference column.
• espn_wnba_pbp() / espn_wbb_pbp() no longer error on games whose plays carry fewer (or more) participants than a previously hardcoded column count; participant columns are named dynamically and padded to the documented schema.
• ... is now genuinely forwarded to DBI::dbWriteTable() in every loader documenting it (35 call sites), and load_wbb_player_core(), load_wnba_team_box(), and load_wnba_player_core() — which documented an optional database write without performing it — now perform it.
• The internal ESPN season group-children fetch paginates instead of truncating at 200 results.
• load_wbb_pbp() / load_wnba_pbp() docs: type_text is ESPN-verbatim (“MadeFreeThrow” is the free-throw play type for made and missed attempts — filter makes with scoring_play), score_value carries the attempt’s value even on misses, and load_wbb_pbp() documents the producer-appended pregame_home_prob / home_win_prob columns.

Published-data correction (loaders serve corrected assets)

The pre-2006 WNBA (2002-2005) and pre-2016 NCAA WBB (2003-2015) ESPN play-by-play release assets were rebuilt with the correct halves-era clock model: those seasons were 2×20-minute halves, but the published half, start/end *_seconds_remaining, overtime, and timeout-bucket columns had been derived under a 4×10-minute quarters assumption. load_wnba_pbp() and load_wbb_pbp() for the affected seasons now serve corrected values (row counts and all other columns unchanged).

Additional soft deprecations

Probe sweeps against stats.wnba.com (August 2026) confirmed five more endpoints permanently empty upstream; their wrappers now emit lifecycle::deprecate_warn() (when = "3.0.0") while remaining callable: wnba_videoevents() and the four wnba_draftcombine*() wrappers (the WNBA publishes no draft-combine data).

Behavior changes to existing functions

Restored functionality (un-deprecations)

wnba_draftboard() is rewritten against the new upstream endpoint https://content-api-prod.nba.com/public/1/leagues/wnba/draft/{season}/board (the old wnba.com/wp-json/api/v1/get_draft_board endpoint stopped serving data). It now returns a tidied named list of two tibbles — board (draft metadata) and picks (one row per pick with team, prospect, career stats, and headshot URL). See ?wnba_draftboard for the column schema.

The following wrappers were deprecated in 2.1.0 or earlier in 3.0.0 dev when their underlying endpoints returned empty result sets. Re-probing in mid-season 2026 (verified 2026-05-16 against LeagueID=10, current 2025-26 season) shows the endpoints have resumed publishing populated data, so the lifecycle::deprecate_stop() shim has been removed and the original body restored on each:

ESPN return-shape streamlining (rectangularization)

Following an audit of all ESPN wrappers against the package’s “single wide, self-describing tibble” preference:

Bug fixes

Return-value initialization sweep. Swept ~124 WNBA and ESPN wrappers that return(df_list) (or returned other vars assigned only inside tryCatch(expr = ...)) without initializing the return value first. When the API errored, callers saw object 'df_list' not found instead of the intended cli::cli_alert_danger + empty-list fallback. Each wrapper now initializes its return variable before tryCatch, so errors degrade gracefully to an empty list / NULL. Affected files: R/wnba_stats_boxscore.R, R/wnba_stats_boxscore_v3.R, R/wnba_stats_cume.R, R/wnba_stats_draft.R, R/wnba_stats_franchise.R, R/wnba_stats_leaders.R, R/wnba_stats_league.R, R/wnba_stats_league_dash.R, R/wnba_stats_lineups.R, R/wnba_stats_pbp.R, R/wnba_stats_player.R, R/wnba_stats_player_dash.R, R/wnba_stats_roster.R, R/wnba_stats_scoreboard.R, R/wnba_stats_shotchart.R, R/wnba_stats_team.R, R/wnba_stats_team_dash.R, R/wnba_stats_video.R, R/espn_wbb_data.R, R/espn_wnba_data.R, R/wnba_data_pbp.R.

Data-loader URL migration

Deprecations (lifecycle, slated for 3.1.0 removal)

Adds lifecycle to Imports and migrates every existing cli::cli_alert_danger() deprecation stub to lifecycle::deprecate_stop(), matching the style used in hoopR. Calling any of these functions now errors with a structured lifecycleDeprecatedError that names a replacement (or, where none exists, an explanation). Their tests skip with a "Deprecated: <fn>() now errors by design; use <replacement>." message before the function call.

Newly deprecated in 3.0.0 — endpoints returned <!DOCTYPE html> (HTTP 404 / maintenance page) at test time:

Already deprecated, re-stated under the lifecycle pattern:

Soft warning (lifecycle::deprecate_warn) — function still runs but recommends a replacement; will escalate to deprecate_stop if the upstream endpoint isn’t restored:

• wnba_boxscoresummaryv3() → wnba_boxscoresummaryv2(). The V3 endpoint still answers 200 OK with the full schema, but the core result sets (game_summary, line_score, inactive_players, other_stats, available_video, game_info, arena_info) come back zero-row in 2025; only officials and last_five_meetings populate. The V2 variant still returns full data.

Documentation improvements

@return column descriptions on every exported function

Every @return markdown table across the 42 R source files is upgraded from two columns (col_name | types) to three columns (col_name | types | description). 580+ tables touched and 4,341 total table rows; every result set on every function now ships a per-column description in ?<function> help, the pkgdown reference, and the rendered man pages. Existing prose \describe{} blocks (notably on load_wbb_pbp(), load_wnba_pbp(), and parameter_descriptions) are unchanged.

Coverage — frequency-weighted, what ?fn readers actually see — 74.7% of the 4,341 @return table rows now carry a hand-quality description (curated + ESPN-API + mined). The remaining 25.3% are heuristic-fallback rows; the heuristic generator’s snake_case expansion + suffix rules cover most of those acceptably (e.g. defended_at_rim_field_goals_attempted → “Number of defended at rim field goals attempted.”), and the long tail is dominated by single-occurrence columns from low-traffic endpoints.

Description sources (precedence order, first match wins):

1. tools/docs/column_descriptions_curated.csv — 619 hand-authored entries focused on the highest-traffic columns and basketball / ESPN domain conventions (team identity, advanced shooting metrics, hustle stats, V2 vs V3 column pairs, ESPN athlete / event / news fields).
2. tools/docs/column_descriptions_api.csv — 181 ESPN-authored descriptions mined live from 14 endpoints per league across both wnba and womens-college-basketball, covering 9 endpoint families: core-v2 athlete statistics (per-season, post-season, career), core-v2 team statistics, core-v2 statisticslog, core-v2 leaders, web-v3 athlete stats / splits / gamelog / overview, and web-v3 statistics/byathlete leaderboards. Three response shapes are recognized: nested categories with stats objects, parallel arrays under categories, and top-level parallel-array shapes (splits / gamelog). This covers the ESPN stat-section column families (general_*, offensive_*, defensive_*, rebounding_*, shooting_*, misc_*) with full prose definitions straight from ESPN — e.g. defensive_blocks → “Short for blocked shot, number of times when a defensive player legally deflects a field goal attempt from an offensive player.” Re-mine at any time with Rscript tools/docs/mine_api_descriptions.R.
3. Mined \item{...}{...} lines from existing \describe{} blocks.
4. Heuristic patterns driven by column-name suffixes (*_id, *_pct, *_made, *_attempted, *_per_36, etc.) with basketball-friendly noun substitution (fg → field goals, tov → turnovers, oreb → offensive rebounds).

New tooling under tools/docs/ (.Rbuildignore’d, sibling of the existing tools/probes/ diagnostic toolkit):

The sweep is idempotent: re-running augment_all_r_files() after updating the dictionary refreshes existing 3-column tables in place rather than appending a fourth column.

Internals

HTTP layer

• Jittered exponential backoff in .retry_request(). Replaced the default fixed 2-second retry cadence with runif(1, 0.5, 1.5) * 2^i so retries from concurrent users hitting the same rate-limited endpoint don’t synchronize into a thundering-herd burst that Cloudflare scores as an attack. Same 3 max tries; same backoff envelope (~0.5–6s); just spread.

• Restored proxy support. When wehoop migrated from httr to httr2 in the V3 work, the legacy httr::use_proxy() plumbing was dropped and request_with_proxy() quietly stopped honoring proxies (its ... was preserved purely for source compatibility). Both request_with_proxy() and the lower-level .retry_request() now accept a proxy = argument:

  • proxy = NULL (default) — libcurl reads http_proxy / https_proxy / no_proxy env vars automatically.
  • proxy = "http://host:port" — string form, forwarded to httr2::req_proxy(url = ...).
  • proxy = list(url=, port=, username=, password=, auth=) — named list spread into httr2::req_proxy() for authenticated proxies.

  Resolution order in .retry_request(): explicit proxy = arg → getOption("wehoop.proxy") → libcurl env vars. The ... thread works for WNBA Stats wrappers (which forward into request_with_proxy()); ESPN / NCAA wrappers call .retry_request() directly without ..., so use options(wehoop.proxy = ...) at the top of the session to cover those without per-function plumbing. Validated end-to-end: ncaa_wbb_teams() and espn_wnba_game_all() both routed through an authenticated test proxy via the option fallback.

Test infrastructure

• Empty / NULL responses now FAIL the test instead of silently SKIPping. The earlier skip("No rows returned from endpoint at test time") guard was hiding regressions: when an upstream endpoint starts returning HTML (404 / maintenance) or breaks in some other silent way, the test should flag it. Converted all 117 such guards across tests/testthat/test-*.R from skip(...) to fail(...) + return(invisible(NULL)) so the test surfaces a FAIL count for follow-up. Deprecation skips and the env-gated skip_*_test() / skip_on_cran() / skip_on_ci() helpers are unchanged.
• Pinned 16 wnba_team* test files from most_recent_wnba_season() to most_recent_wnba_season() - 1 so the team-stats endpoints have a known-completed season to query and don’t degenerate to “no rows” in the WNBA off-season window. wnba_teams() and standings tests still track the live season because that’s what they’re meant to verify.
• Bumped .ncaa_headers() user-agent to Chrome 130 and added the Sec-Fetch-* / sec-ch-ua-* headers a real browser sends.
• ncaa_wbb_teams() keeps its legacy stats.ncaa.org/team/inst_team_list scrape (per-season per-division team list with season_id populated), and now threads the proxy = argument from ... through to .retry_request() at the top level. stats.ncaa.org is fronted by Akamai and returns HTTP 403 (Reference #18.<...>) to many residential and cloud IP ranges; pass a proxy that egresses from a non-blocked address — either per-call (ncaa_wbb_teams(year, division, proxy = list(url=, port=, username=, password=))) or session-wide (options(wehoop.proxy = list(...))). See the Network access section of ?ncaa_wbb_teams for the full resolution order.

Test suite hardening (column-drift resilience)

• Flipped 394 column assertions from strict expect_equal(sort(colnames(x)), sort(cols)) to subset checks expect_in(sort(cols), sort(colnames(x))) across 115 test files — per the CLAUDE.md guidance, WNBA / ESPN APIs add columns without removing old ones, and the strict checks were brittle.
• Injected skip("No rows returned from endpoint at test time") guards into 114 test files so tests which access x[[1]] degrade gracefully to a skip (rather than a subscript-out-of-bounds error) when the upstream endpoint errors or returns empty. (Later converted to fail() — see “Test infrastructure” above.)
• Cleaned stale column names out of expected cols lists where ESPN renamed/removed columns (jersey, active, team_x_ref_2, team_is_all_star, Team_ID → TEAM_ID).
• Added per-element null/empty-column check helpers to test-wnba_teamvsplayer.R and test-wnba_playerdashboardbyclutch.R so tests tolerate the WNBA Stats API returning fewer result-set elements than the test expects.
• Added tools/ directory (excluded from the package build via .Rbuildignore) containing the one-off R scripts used to apply the above sweeps: patch_df_list_init.R, patch_return_var_init.R, flip_expect_equal_cols.R, inject_skip_guard.R.

Release / CRAN preparation

• Add cph (copyright holder) role to Saiem Gilani in Authors@R (CRAN strict requirement).
• Bump LICENSE and LICENSE.md copyright year from 2020 to 2026.
• Add full roxygen blocks (description, @return, @examples) to most_recent_wbb_season() and most_recent_wnba_season(), which had been title/@export-only.
• Add @examples \donttest{} blocks to all 58 new ESPN endpoint wrappers. Live-API examples are wrapped in \donttest{} so they do not run during routine R CMD check but are still exercised under --run-donttest. The redundant @details code-block samples were removed from these 58 functions; the legacy @details-with-code-block convention is retained for the WNBA Stats API (wnba_*) and NCAA (ncaa_wbb_*) wrappers per the project’s documentation conventions in CLAUDE.md.
• Modernize inst/CITATION: replace deprecated citEntry() / personList() with bibentry() / c(person(), ...) (R 4.x deprecation cleanup).
• Add parameter_descriptions (dataset) and year_to_season (utility) to _pkgdown.yml reference index so pkgdown::check_pkgdown() passes (resolves the gh-pages deploy failure).

wehoop 2.1.0

• wnba_homepagewidget() function added to replace the following homepage functions being deprecated.
• wnba_homepageleaders() function deprecated due to WNBA Stats API deprecation.
• wnba_homepagev2() function deprecated due to WNBA Stats API deprecation.
• wnba_leaderstiles() function deprecated due to WNBA Stats API deprecation.
• wnba_scoreboard() function deprecated due to WNBA Stats API deprecation (use wnba_scoreboardv3()).
• wnba_teaminfocommon() function deprecated due to WNBA Stats API deprecation (use wnba_teamdetails()).

wehoop 2.0.0

• load_wnba_*() functions now use sportsdataverse-data releases url instead of wehoop-data repository URL
• load_wbb_*() functions now use sportsdataverse-data releases url instead of wehoop-data repository URL
• wnba_pbp() function and new wnba_pbps() function added with on_court (default TRUE) parameter to return on court players for each play event

wehoop 1.9.0

WNBA Stats API Live Endpoints

• wnba_live_pbp() function added.
• wnba_live_boxscore() function added.
• wnba_todays_scoreboard() function added.

WNBA Boxscore V3 (and V3-styled) Endpoints Added

• wnba_scoreboardv3() function added.
• wnba_boxscoretraditionalv3() function added.
• wnba_boxscoreadvancedv3() function added.
• wnba_boxscoremiscv3() function added.
• wnba_boxscorescoringv3() function added.
• wnba_boxscoreusagev3() function added.
• wnba_boxscorefourfactorsv3() function added.
• wnba_boxscoreplayertrackv3() function added.
• wnba_boxscorehustlev2() function added.

Other WNBA Stats API functions added

• wnba_shotchartlineupdetail() function added.
• wnba_franchiseleaderswrank() function added.
• wnba_leaderstiles() function added.
• wnba_leagueleaders() function added.
• wnba_videodetailsasset() function added.
• wnba_infographicfanduelplayer() function added.

Other Functions Added

• ncaa_wbb_teams() function added.

Proxy Capability Added and Other Notes

• Add rlang dots option for passing httr::use_proxy() option to wnba_*() functions
• Returns documentation added for all working WNBA Stats API endpoints and ESPN functions
• Tests added for all working WNBA Stats API endpoints and ESPN functions, over 750 tests when run locally

wehoop 1.8.0

• Add proxy rlang dots option for passing httr::use_proxy() option to wnba_stats_*() functions
• Improved output for espn_wbb_team_box(), espn_wbb_player_box(), espn_wnba_team_box(), espn_wnba_player_box()

wehoop 1.7.0

• espn_wbb_game_rosters() function added.
• espn_wnba_game_rosters() function added.
• wnba_teams() function added. Useful for cross-walking between ESPN and WNBA Stats API

wehoop 1.6.0

• Updates tidyr and dplyr statements to use quotations on columns instead of data masking per tidyselect deprecation notice.

wehoop 1.5.0

~106 WNBA Stats API functions added

Adds 4 ESPN WBB and WNBA functions

• wehoop::espn_wbb_player_stats() function added.

• wehoop::espn_wbb_team_stats() function added.

• wehoop::espn_wnba_player_stats() function added.

• wehoop::espn_wnba_team_stats() function added.

• Removes furrr and future dependencies and replaces with purrr (>= 0.3.0)

wehoop 1.2.1

• Minor release to stay ahead of tidyr release revdepchecks

wehoop 1.2.0

• Add returns for all the functions
• Update a handful of field names from the scoreboard functions and to also include neutral_site and conference_competition columns for the women’s college basketball scoreboard function.

wehoop 1.1.1

• Change functions from furrr::future_map_dfr() functions to data.table::rbindlist() functions for loaders.

wehoop 1.1.0

Add schedule loaders

• wehoop::load_wbb_schedule() function added
• wehoop::load_wnba_schedule() function added

wehoop 1.0.0

Add team box score loaders

• wehoop::load_wbb_team_box() function added
• wehoop::load_wnba_team_box() function added

Add player box score loaders

• wehoop::load_wbb_player_box() function added
• wehoop::load_wnba_player_box() function added

Standings functions

• wehoop::espn_wnba_standings()
• wehoop::espn_wbb_standings()

Getting Started vignette

• Getting started with wehoop data

wehoop 0.9.2

Quick fix for update db functions

Dependency pruning

This update is a non-user facing change to package dependencies to shrink the list of dependencies.

wehoop 0.9.1

Clean names and team returns

• All functions have now been given the janitor::clean_names() treatment
• wehoop::espn_wbb_teams() has updated the returns to be more identity information related only
• wehoop::espn_wnba_teams() to be more identity information related only
• All tests were updated

wehoop 0.9.0

Loading capabilities added to the package

• wehoop::load_wbb_pbp() and wehoop::update_wbb_db() functions added
• wehoop::load_wnba_pbp() and wehoop::update_wnba_db() functions added

wehoop 0.3.0

Dependencies

• R version 3.5.0 or greater dependency added
• purrr version 0.3.0 or greater dependency added
• rvest version 1.0.0 or greater dependency added
• progressr version 0.6.0 or greater dependency added
• usethis version 1.6.0 or greater dependency added
• xgboost version 1.1.0 or greater dependency added
• tidyr version 1.0.0 or greater dependency added
• stringr version 1.3.0 or greater dependency added
• tibble version 3.0.0 or greater dependency added
• furrr dependency added
• future dependency added

Test coverage

• Added tests for all ESPN functions

Function Naming Convention Change

• Similarly, data and metrics sourced from ESPN will begin with espn_ as opposed to wbb_ or wnba_.
• Data sourced directly from the NCAA website will start the function with ncaa_

wehoop 0.2.0

• Added support for ESPN’s play-by-play endpoints with the addition of the following functions:
• wehoop::espn_wnba_game_all() - a convenience wrapper function around the following three functions (returns the results as a list of three data frames)
• wehoop::espn_wnba_team_box()
• wehoop::espn_wnba_player_box()
• wehoop::espn_wnba_pbp()
• wehoop::espn_wnba_teams()
• wehoop::espn_wbb_scoreboard()

wehoop 0.1.0

• Added support for ESPN’s play-by-play endpoints with the addition of the following functions:
• wehoop::espn_wbb_game_all() - a convenience wrapper function around the following three functions (returns the results as a list of three data frames)
• wehoop::espn_wbb_team_box()
• wehoop::espn_wbb_player_box()
• wehoop::espn_wbb_pbp()
• wehoop::espn_wbb_teams()
• wehoop::espn_wbb_conferences()
• wehoop::espn_wbb_scoreboard()
• wehoop::ncaa_wbb_NET_rankings()
• wehoop::espn_wbb_rankings()