Skip to contents

Fetch assessment results for multiple years

Usage

fetch_assessment_multi(
  end_years,
  tidy = TRUE,
  use_cache = TRUE,
  source = NULL,
  max_age_days = NULL,
  refresh = FALSE,
  allow_partial = FALSE
)

Arguments

end_years

Vector of school year ends (e.g., 2015:2025).

tidy

If TRUE (default), returns tidy output.

use_cache

If TRUE (default), uses locally cached results.

source

Requested acquisition mode: "package" (default) or explicit "live" where a runtime producer exists. Retained-only surfaces reject live requests; refresh their files through the documented manual harvest.

max_age_days

Maximum reusable live-cache age in elapsed 24-hour days.

refresh

Force live retrieval. Valid only in live mode.

allow_partial

If FALSE (default) the call FAILS CLOSED: any year that cannot be served aborts the whole request, so a short frame is never returned to a caller who did not ask for one. If TRUE, a year that the source genuinely could not serve is dropped with a warning naming it and recorded in the returned frame's missing_years attribute; a package or source-policy refusal is still never dropped. requested_years and missing_years are attached in both modes.

Value

Combined data frame of assessment results for all requested years.

Examples

if (FALSE) { # \dontrun{
# Smarter Balanced / NH SAS era
asmt <- fetch_assessment_multi(2015:2025)

# State reading proficiency trend, all students
asmt |>
  dplyr::filter(
    is_state, subject == "reading", grade == "TOTAL",
    subgroup == "total_enrollment"
  ) |>
  dplyr::select(end_year, pct_proficient) |>
  dplyr::arrange(end_year)

# Just a couple of years
two_years <- fetch_assessment_multi(c(2023, 2025))
} # }