Metadata-Version: 2.1
Name: lgdash
Version: 0.1.3
Summary: A command line tool for displaying live soccer scores and statistics.
Home-page: https://github.com/joypauls/league-dashboard
License: MIT
Keywords: cli,soccer,football,statistics,scores,live
Author: Joy Paulsen
Author-email: joypaulsen3@gmail.com
Requires-Python: >=3.13,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: click (>=8.1.7,<9.0.0)
Requires-Dist: pandas (>=2.2.3,<3.0.0)
Requires-Dist: requests (>=2.32.3,<3.0.0)
Requires-Dist: rich (>=13.9.4,<14.0.0)
Requires-Dist: tzlocal (>=5.2,<6.0)
Project-URL: Repository, https://github.com/joypauls/league-dashboard
Description-Content-Type: text/markdown

[![python](https://img.shields.io/badge/python-3.13-blue)](https://www.python.org)
[![PyPI version](https://badge.fury.io/py/lgdash.svg)](https://badge.fury.io/py/lgdash)

⚠️ This project is currently under active development and considered experimental (all 0.1.x releases).

# League Dashboard (lgdash)

Soccer/football at the command line. ⚽

Under the hood the app is calling the [football-data.org](https://www.football-data.org/) API, so an API token from that service is required. Register [here](https://www.football-data.org/pricing) to get one. 

## Features

- live scores
- league standings
- league schedules

### Currently Supported Leagues

- Premier League (England 🏴󠁧󠁢󠁥󠁮󠁧󠁿)
- La Liga (Spain 🇪🇸)
- Serie A (Italy 🇮🇹)
- Bundesliga (Germany 🇩🇪)
- Ligue 1 (France 🇫🇷)
- UEFA Champions League (Europe)

## Quick Start

### Get API Token

If you don't have one, register for an API token [here](https://www.football-data.org/pricing).

Then add this line with your token to `.zshrc` or another appropriate startup file.
```
export FOOTBALLDATA_API_TOKEN=<token>
```

### Install

Available on PyPI.

`pip install lgdash`

### How to Use

#### Today's Slate of Matches

Live scores and start times in local system time.

Example: Premier League (Default)  
`lgdash`, or `lgdash -l PL`

Example: Serie A  
`lgdash -l SA`

#### Standings

Current state of a league's standings with some statistics for each team.

Example: Premier League (Default)  
`lgdash standings`

Example: Serie A  
`lgdash standings -l SA`

#### Help

Each command and subcommand supports the `--help` option, for example:

`lgdash --help` and `lgdash --help`


## Commands

`lgdash`
- get live scores and today's scheduled matches
- `-l, --league`: specify a league code

`lgdash schedule`
- get upcoming matches
- `-l, --league`: specify a league code
- `-d, --days`: specify number of days in future

`lgdash standings`
- get league standings
- `-l, --league`: specify a league code

`lgdash leagues`
- get all supported league codes



