VHL — additional Python functions
Hand-written wrappers, loaders, and helpers in sportsdataverse.hockey.vhl that are not
generated API-endpoint wrappers (those have their own reference pages).
VHL
vhl_tn
vhl_tn(season: 'int', stage: 'str' = 'regular') -> 'int'
The VHL tournament id (tn) of a season (END year) and stage.
Read from the calendar's tournament select, fetched once per process. The tn is what the
site keys every season page by; the wrappers map it for you, so you need it only to read
tn columns or build a URL by hand.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
season | int | END year of the season (2026 = 2025/26). The calendar covers 2010/11 on. | |
stage | str | 'regular' | "regular" (default) or "playoff". |
Returns
the tn (1374 for the 2025/26 regular season).
Raises
| Exception | Description |
|---|---|
ValueError | season is not a year or stage is not in STAGES. |
NoDataError | The calendar lists no such season and stage. |
AssetFetchError | The calendar page could not be fetched or has no tournament select. |
Example
from sportsdataverse.hockey.vhl import vhl_tn
vhl_tn(2026) # 1374
vhl_tn(2026, "playoff") # 1375