biathlon 1.7.1

CLI for exploring IBU biathlon results from biathlonresults.com

Biathlon CLI

A CLI to explore data from the IBU biathlon results API at biathlonresults.com.

No external dependencies - pure Python standard library.

Installation

From PyPI

pip install biathlon

From source

git clone https://github.com/thbtmntgn/biathlon.git
cd biathlon
pip install .

For development

git clone https://github.com/thbtmntgn/biathlon.git
cd biathlon
pip install -e .

Releases

CI runs on every push and pull request to main. Publishing to PyPI and creating a GitHub release only happen when a version tag is pushed.

Create a release:

git tag v1.5.0
git push origin v1.5.0

Version numbers are derived dynamically from Git tags via setuptools-scm.

PyPI publishing uses GitHub Actions trusted publishing (id-token: write), so the project must be configured as a trusted publisher on PyPI.

Usage

List available seasons:

biathlon seasons

List World Cup events from the current season:

biathlon events

List World Cup events for a specific season:

biathlon events --season 2425

List IBU Cup events for the current season:

biathlon events --level 2

List events with their races for the current season World Cup:

biathlon events --races

List sprint races for a specific season:

biathlon events --season 2425 --races --discipline sprint

Show results for the most recent World Cup race:

biathlon results

Show results for a specific race id:

biathlon results --race BT2526SWRLCP01SWSP

Show detailed split times for a race:

biathlon results --race BT2526SWRLCP03SMMS --detail

Show World Cup total standings (women, current season by default):

biathlon standings

Show men sprint standings for season 2425:

biathlon standings --season 2425 --men --sort sprint

Show country standings (Nations Cup + Relay points):

biathlon standings --country
biathlon standings --country --sort women-relay
biathlon standings --country --sort women-nations

Show athlete information:

biathlon athlete info --search "boe johannes"
biathlon athlete id --search "boe"
biathlon athlete results --id BTFRA12305199301

Show medal standings:

biathlon ceremony
biathlon ceremony --athlete

Show achievements medal tables:

biathlon achievements
biathlon achievements --men
biathlon achievements --country
biathlon achievements --nationality FRA
biathlon achievements --olympics
biathlon achievements --world --season all

Cumulate season statistics:

biathlon cumulate results
biathlon cumulate ski
biathlon cumulate pursuit
biathlon cumulate course
biathlon cumulate range
biathlon cumulate shooting
biathlon cumulate miss
biathlon cumulate penalty
biathlon cumulate remontada --men
biathlon cumulate cleansheet
biathlon cumulate cleansheet --sort percentage

Shooting accuracy:

biathlon shooting
biathlon shooting --men
biathlon shooting --race BT2526SWRLCP01SWSP
biathlon shooting --season 2425
biathlon shooting --include-relay all
biathlon shooting --sort hit-pct --min 50 --limit 30

Athlete form (course time ranks and shooting across recent races):

biathlon form
biathlon form --men
biathlon form --startlist
biathlon form --season --top 10
biathlon form --nat FRA,NOR

Season, event and race briefs (preevent agenda + standings snapshot, startlist analysis, post-race recap):

biathlon brief preseason
biathlon brief postseason
biathlon brief preevent
biathlon brief postevent
biathlon brief startlist
biathlon brief postrace

Run without installing:

python -m biathlon.cli seasons

Output formats:

biathlon results --format tsv
biathlon results --format markdown

License

MIT