Soccer CLI

Soccer for Hackers - a CLI for all the football scores.

Install

An API key from football-data.org will be required and you can register for one here.

Using `pip`

$ pip install soccer-cli

Set your API key in an environment variable SOCCER_CLI_API_TOKEN

For example:

export SOCCER_CLI_API_TOKEN="<YOUR_API_TOKEN>"

Build from source

$ git clone git@github.com:architv/soccer-cli.git
$ cd soccer-cli
$ python setup.py install

You can set the API key using an environment variable as shown above or create a file config.py in the soccer package directory (soccer/config.py) with the single line

config = {
    "SOCCER_CLI_API_TOKEN": "<YOUR_API_TOKEN>",
}

Note:

Currently supports Linux, Mac OS X, NetBSD and FreeBSD.

Usage

Get standings for a league

$ soccer --standings --league=EPL # EPL is the league code for English Premier League

Get scores for a particular team

$ soccer --team=MUFC # MUFC is the team code for Manchester United
$ soccer --team=PSG --time=10 # scores for all the Paris Saint-Germain games over the past 10 days

Get scores for live games

$ soccer --live

Get scores for a particular league

$ soccer --league=BL # BL is the league code for Bundesliga
$ soccer --league=FL --time=15 # get scores for all the French Ligue games over the past 15 days

Get scores for all seven leagues with a set time period

$ soccer --time=10 # scores for all the seven leagues over the past 10 days

Help

$ soccer --help

List of supported leagues and their league codes

BL: Bundesliga (German League)
FL: Ligue 1 (French League)
EPL: English Premier League
LLIGA: Liga BBVA (Spanish League)
SA: Serie A (Italian League)
PPL: Primeira Liga (Portuguese League)
DED: Eredivisie (Dutch League)
CL: Champions League

Team and team codes

For a full list of supported team and team codes see this.

Demo

Standings

Live scores

Team scores

Todo

Enable cache
Add more test cases
Add fixtures for UEFA Champions League
Add league filter for live scores
Color coding for Europa league and differentiation between straight CL and CL playoff spots, and the same for EL spots
Add support for team line up