README.md

# scores
[![builds.sr.ht status](https://builds.sr.ht/~mtmn/scores.svg)](https://builds.sr.ht/~mtmn/scores?)

A command-line tool that displays football scores and league standings from football-data.org.

## Features

* Display upcoming and recent match results
* Show league standings/tables
* Filter matches by team
* Support for multiple leagues (Premier League, Championship, La Liga, Champions League)

## Installation

To install scores, run:

```sh
cargo install --path .
```

## Usage

```sh
scores [OPTIONS]
```

### Options

*   `-h`, `--help`: Print help information.
*   `-s`, `--standings`: Show league standings/table.
*   `-t`, `--token <TOKEN>`: API token from football-data.org (required).
*   `-f`, `--filter <TEAM>`: Filter by team name or abbreviation.
*   `-a`, `--all`: List all matches across every competition (ignores `--league`). This is the default when no `--league` is given.
*   `-l`, `--league <LEAGUE>`: League to display. When omitted, all competitions are shown.

### Leagues

*   `epl`: Premier League
*   `efl`: Championship
*   `laliga`: La Liga
*   `ucl`: Champions League

### Example

```sh
# List all matches across every competition
scores -t <TOKEN>

# Show upcoming Premier League matches
scores -l epl -t <TOKEN>

# Show Premier League table
scores -s -t <TOKEN>

# List all matches involving Arsenal across every competition
scores -f arsenal -t <TOKEN>

# Show upcoming Arsenal matches in the Premier League
scores -l epl -f arsenal -t <TOKEN>

# Show La Liga standings
scores -s -l laliga -t <TOKEN>

# Show upcoming Champions League matches
scores -l ucl -t <TOKEN>
```