llms.txt

# Football.TXT 

> Football.txt is a plain text data format (in unicode / utf-8) 
for football (soccer) match schedules (with fixtures & results, lineups, bookings, and more). 
Designed to be easy to read & write by humans while
staying machine-parsable with a context-free LALR(1) grammar into JSON, CSV & SQL. 


## Football.TXT Format Specs

- [Football.TXT Grammar](https://github.com/sportdb/sport.db.v2/tree/master/parser/fbtxt/grammar): The LALR(1) grammar rules / productions in yacc-like source files
- [Football.TXT Specification](https://openfootball.github.io/spec/): The syntax rules for round & date headers, match & goal lines, lineups incl. sub(stitution)s, bookings (yellow/yellow-red/red cards) and more.

Tips:
- For format samples look at the Football.TXT datasets that incl. the World Cup, English Premier League, Bundesliga, and more


## Football.TXT (Command-line) Tooling

Format syntax error testing & debugging:
- `fbtok`      - Football.TXT lexer (& tokenizer) for testing; breaks-up (source) text files into tokens 
- `fbtree`     - Football.TXT parser for syntax check testing & debugging; builds-up an (abstract syntax) parse tree   

Conversion:
- `fbtxt2json` - convert Football.TXT matchfiles to .json
- `fbtxt2csv`  - convert Football.TXT matchfiles to .csv


## Football.TXT Datasets

- [World Cup](https://github.com/openfootball/worldcup):    (FIFA) World Cup, all 23 tournaments 1930 to 2026 in (quick/compact) overview and full versions
- [England](https://github.com/openfootball/england):       English Premier League, Championship, and more
- and many more