Skip to main content

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

ParameterTypeDefaultDescription
seasonintEND year of the season (2026 = 2025/26). The calendar covers 2010/11 on.
stagestr'regular'"regular" (default) or "playoff".

Returns

the tn (1374 for the 2025/26 regular season).

Raises

ExceptionDescription
ValueErrorseason is not a year or stage is not in STAGES.
NoDataErrorThe calendar lists no such season and stage.
AssetFetchErrorThe 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