Si vous aimez le foot et êtes légèrement geek sur les bords, cet article devrait vous intéresser ! football-cli est un petit programme qui va vous permettre d'afficher le résultats des matchs, tableaux des scores, sur votre terminal !

football-cli est un paquet NPM à installer sur votre machine. Il vous faut bien entendu NodeJS au préalable.

L'installation est classique, via un terminal / invite de commandes :

npm install -g footballcli

Vous disposez maintenant de la ligne de commandes football.

Récupérer une clé API

Pour fonctionner, football-cli utilise la base de données du site football-data.org. Pour utiliser football-cli, vous devez avoir une clé API, qui est disponible à cette adresse. Une adresse mail vous sera demandée.

Ensuite, vous devez lier cette clé à votre football-cli. Pour cela, lancez cette commande :

football config

Votre clé API vous sera demandée, vous n'aurez plus qu'à la coller dans le terminal et à valider par la touche Entrée.

Pour info, sur le site football-data.org, vous pouvez accéder à votre espace (adresse mail + clé API) pour lier un domaine et faire des tests, si vous le souhaitez.

Les commandes disponibles

La liste des commandes est visible via un simple football -h.

football <command>

Commands:
  scores     Get scores of past and live fixtures
  fixtures   Get upcoming and past fixtures of a league and team
  standings  Get standings of particular league
  lists      List of codes of various competitions
  config     Change configuration and defaults

Options:
  -h, --help  Show help

Voir les scores

Voici la commande pour consulter les scores des matchs :

football scores

Deux options existent :

• -l : permet de voir les résultats des matchs en direct
• -t <team> : permet de consulter les scores d'une équipe en particulier. Pour connaître le nom d'une équipe, voir ci-dessous.

Consulter la liste des championnats (lists)

football-cli peut récupérer les données de plusieurs championnats, répartis dans plusieurs pays. Vous retrouverez ainsi les deux premières divisions de l'Angleterre, l'Italie, la France, l'Espagne, l'Allemagne, plus le championnat des Pays-Bas, du Portugal et la Champions League.

Chaque championnat est identifié par un code. Le code FL1 correspond à la Ligue 1 française. Ce code pourra être passé en paramètre de plusieurs commandes (paramètre -l).

football lists

Matchs passés et à venir (fixtures)

la commande fixtures permet d'afficher la liste des derniers matchs. Sans aucun paramètre, vous vous retrouverez avec une liste importante de matchs.

• l : permet de filtrer sur un championnat, via son code (ex : FL1)
• t : filtre sur une équipe en particulier

Pour avoir les derniers matchs d'un championnat, et plus particulièrement de l'équipe de Nice, lancez cette commande :

football fixtures -l FL1 -t "OGC Nice"

Egalement, vous pouvez afficher la liste des matchs à venir pour un championnat ou une équipe avec le paramètre -n (next) :

football fixtures -l FL1 -t "OGC Nice"

Tableau des résultats (standings)

Le tableau des résultats est disponible par championnat. Le code de ce dernier est obligatoire, avec l'option -l.

football standings -l PL

Conclusion

football-cli est donc un outil plutôt sympa à utiliser, même si les fonctionnalités pourraient être encore plus poussées (tableau des scores plus complet, liste des joueurs avec leurs stats, etc...) !