Metadata-Version: 2.4
Name: badminton-cli
Version: 0.1.1
Summary: Beautiful console application for German U19 badminton rankings
Keywords: badminton,rankings,dbv,cli,sports,germany
Author: Paulo Matos
Author-email: Paulo Matos <pmatos@igalia.com>
License-Expression: MIT
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Games/Entertainment
Requires-Dist: rich>=13.0
Requires-Dist: click>=8.0
Requires-Dist: httpx>=0.25
Requires-Dist: openpyxl>=3.1
Requires-Dist: rapidfuzz>=3.0
Requires-Dist: platformdirs>=4.0
Requires-Dist: plotext>=5.2
Requires-Dist: pytest>=7.0 ; extra == 'dev'
Requires-Dist: ruff>=0.1 ; extra == 'dev'
Requires-Python: >=3.12
Project-URL: Homepage, https://github.com/pmatos/badminton-cli
Project-URL: Issues, https://github.com/pmatos/badminton-cli/issues
Project-URL: Repository, https://github.com/pmatos/badminton-cli
Provides-Extra: dev
Description-Content-Type: text/markdown

# 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

```bash
# Using uv (recommended)
uv tool install badminton-cli

# Or using pipx
pipx install badminton-cli

# Or using pip
pip install badminton-cli
```

## Quick Start

```bash
# 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:

```bash
badminton-cli
```

## Claude Code Plugin

A Claude Code plugin is available for AI-assisted ranking exploration. See the [claude-plugin](./claude-plugin/) directory.

## Requirements

- Python 3.12+

## License

MIT License - see [LICENSE](./LICENSE) for details.

## Links

- [PyPI](https://pypi.org/project/badminton-cli/)
- [GitHub](https://github.com/pmatos/badminton-cli)
- [Issues](https://github.com/pmatos/badminton-cli/issues)
