Fetch Alabama school directory data — fetch

Downloads and processes school directory data from the ALSDE Education Directory. Data includes school and district contact information including administrator names, physical addresses, phone numbers, websites, grade ranges, and superintendent names.

Usage

fetch_directory(use_cache = TRUE)

Arguments

use_cache: If TRUE (default), uses locally cached data when available. Set to FALSE to force re-download from source.

Value

Data frame with directory data containing columns:

district_name: Name of the school system/district
school_name: Name of the school (NA for district/state rows)
entity_type: One of "State", "District", or "School"
principal_name: School principal or district administrator name
superintendent_name: District superintendent name
address: Physical street address
city: City
state: State (always "AL")
zip: ZIP code
phone: Phone number
website: Website URL
grades_served: Grade range offered (e.g., "PK-05", "09-12")
is_state: TRUE for state-level row
is_district: TRUE for district-level rows
is_school: TRUE for school-level rows

Details

Directory data is a point-in-time snapshot (not year-specific) reflecting the current state of the ALSDE Education Directory.

Examples

if (FALSE) { # \dontrun{
# Get directory data
dir <- fetch_directory()

# List all districts with superintendents
dir |>
  dplyr::filter(is_district) |>
  dplyr::select(district_name, superintendent_name)

# Find schools in Jefferson County
dir |>
  dplyr::filter(is_school, grepl("Jefferson", district_name)) |>
  dplyr::select(school_name, principal_name, grades_served)

# Count schools per district
dir |>
  dplyr::filter(is_school) |>
  dplyr::count(district_name, sort = TRUE)

# Force fresh download (ignore cache)
dir_fresh <- fetch_directory(use_cache = FALSE)
} # }