biathlon 1.2.0

CLI for exploring IBU biathlon results from biathlonresults.com

Biathlon CLI

A CLI to explore data from the IBU biathlon results API at https://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 .

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 ski/range/shooting time breakdowns for a race:

biathlon results ski --race BT2526SWRLCP03SMMS
biathlon results range --race BT2526SWRLCP03SMMS
biathlon results shooting --race BT2526SWRLCP03SMMS

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

biathlon scores

Show men sprint standings for season 2425:

biathlon scores --season 2425 --men --sort sprint

Run without installing:

python -m biathlon.cli seasons

Shell Completion

Enable tab completion for bash:

eval "$(biathlon --completion bash)"

Or add to your ~/.bashrc:

source <(biathlon --completion bash)

For zsh, add to your ~/.zshrc:

source <(biathlon --completion zsh)

Limitations

• Relay races are not supported. Commands like results, shooting, and cumulate filter out relay events. Only individual race formats (sprint, pursuit, individual, mass start) are included in statistics and rankings.

License

MIT