bhs-calendars 2.11.1

Bundled BHS-area school bell-schedule calendar data for the bells library

bhs-calendars (Python)

Bundled bell-schedule calendar data for Berkeley High School and nearby middle schools, as a Python distribution. This is the Python counterpart of the npm @peterseibel/bhs-calendars package and ships the same per-year JSON.

It is data, not logic — pair it with the bells library to build schedules without supplying your own {year}.json files.

pip install bhs-calendars

Usage

from bhs_calendars import by_id, load_all
from bells import BellSchedule

# Grouped by school, each school's years sorted chronologically:
years = by_id()["bhs"]
schedule = BellSchedule(years, {})

# Or the flat list of every bundled school-year:
all_years = load_all()   # list[dict]

load_all() mirrors the npm package's default export (a flat list of yearly calendar objects). by_id() groups those by their id field — "bhs", "king-6", "king-7", "king-8", "longfellow-6", "longfellow-78", "willard-6", "willard-78" — with each group's years sorted by firstDay.

Unlike the library's Calendars loader (which reads {year}.json from a directory or URL), this data is bundled on disk with the package: no filesystem layout or network access required. The trade-off is that it only covers the BHS-area schools.

Data source

The single source of truth is the canonical bhs-calendars/ directory at the repository root (also the npm package source). The JSON under bhs_calendars/data/ is a verbatim, build-time copy of it and is gitignored, not committed — the build, test, and release flows (and CI) regenerate it so it can never drift from the source.

When working in this repo, run make sync-py-calendars (or make sync-calendars for both ports) from the repo root once after checkout, and again after the source data changes, before building or testing this package.