Badminton CLI
A beautiful console application for exploring German U19 badminton rankings from the German Badminton Association (DBV).
Features
- Search players by name with fuzzy matching
- View player details including rankings across all disciplines
- Compare players side-by-side
- Calculate team points for doubles partnerships
- View top rankings filtered by discipline
- Track ranking history with terminal graphs
- JSON output for all commands for programmatic access
Installation
# Using uv (recommended)
uv tool install badminton-cli
# Or using pipx
pipx install badminton-cli
# Or using pip
pip install badminton-cli
Quick Start
# Download ranking data
badminton-cli update
# Search for a player
badminton-cli search "Max Mustermann"
# View player details
badminton-cli player 01-150083
# Show top rankings in Men's Singles
badminton-cli top --discipline HE
# Compare two players
badminton-cli compare 01-150083 01-150084
# View ranking history graph
badminton-cli graph 01-150083 --since 6m
Commands
| Command | Description |
|---|---|
update |
Download and index ranking data from DBV |
search <name> |
Fuzzy search for players |
player <id> |
Show detailed player information |
compare <id1> <id2> |
Side-by-side player comparison |
team <id1> <id2> |
Calculate combined team points |
top |
Show top-ranked players |
graph <id> |
Show ranking history graph |
history |
List available ranking weeks |
All commands support --json for structured output.
Disciplines
| Code | German | English |
|---|---|---|
| HE | Herren Einzel | Men's Singles |
| DE | Damen Einzel | Women's Singles |
| HD | Herren Doppel | Men's Doubles |
| DD | Damen Doppel | Women's Doubles |
| HM | Herren Mixed | Mixed (male player) |
| DM | Damen Mixed | Mixed (female player) |
Interactive Mode
Run without arguments for an interactive TUI:
badminton-cli
Claude Code Plugin
A Claude Code plugin is available for AI-assisted ranking exploration. See the claude-plugin directory.
Requirements
- Python 3.12+
License
MIT License - see LICENSE for details.
Links
1 maintainer
Metadata
1 maintainer
Release files for badminton-cli 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| badminton_cli-0.1.1.tar.gz | 19.2 kB | Without provenance | Details for badminton_cli-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| badminton_cli-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for badminton_cli-0.1.1-py3-none-any.whl |
Total release size: 46.5 kB
Release files / badminton_cli-0.1.1.tar.gz
| Download URL | badminton_cli-0.1.1.tar.gz |
|---|---|
| Size | 19.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0df031bd763826f5db2bdc9907bb3ff25fa70b3ce4db22b0a8942674e7f85b5c
|
|
BLAKE2b-256 checksum How to use checksums |
a533ad27a39892a3c129c7ab4d5244c2071d9807b61b1b99487410d0323591d0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.7
|
Release files / badminton_cli-0.1.1-py3-none-any.whl
| Download URL | badminton_cli-0.1.1-py3-none-any.whl |
|---|---|
| Size | 27.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b5da444db5e3c256c732af472d48bf6c17d247663a4afe7756cec34bac6443de
|
|
BLAKE2b-256 checksum How to use checksums |
1106500428dc889c2191bee5b21d5b24c97109573d540b8cc5aca07070b70318
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.7
|
Security for badminton-cli 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
