Elo-MMR-Py

Elo-MMR-Py exposes the Elo-MMR multiplayer rating algorithms through a small, typed Python API backed by Rust. See Installation for the package command and supported wheel platforms.

Complete leaderboard example

The following file is included verbatim and executed by the test suite:

"""Build a small leaderboard with the lightweight API."""

from elo_mmr_py import Contest, rate_latest

contests = [
    Contest(
        standings=[('Ada', 0, 0), ('Grace', 1, 1), ('Linus', 2, 2)],
        name='Example final',
        time_seconds=1_700_000_000,
    )
]

leaderboard = sorted(rate_latest(contests).values(), key=lambda player: -player.rating)
for position, player in enumerate(leaderboard, start=1):
    contest_label = 'contest' if player.contests_played == 1 else 'contests'
    print(
        f'{position}. {player.name}: {player.rating} '
        f'±{player.rating_sig} ({player.contests_played} {contest_label})'
    )

Output:

1. Ada: 1705 ±171 (1 contest)
2. Grace: 1500 ±171 (1 contest)
3. Linus: 1295 ±171 (1 contest)

The Concepts guide explains which rating API to use; the generated API reference is authoritative for signatures and return types.