{"id":15041088,"url":"https://github.com/f1db/f1db","last_synced_at":"2025-04-04T12:09:33.294Z","repository":{"id":41272816,"uuid":"403954428","full_name":"f1db/f1db","owner":"f1db","description":"Open Source Formula 1 Database","archived":false,"fork":false,"pushed_at":"2024-10-22T07:32:24.000Z","size":8221,"stargazers_count":192,"open_issues_count":5,"forks_count":22,"subscribers_count":10,"default_branch":"main","last_synced_at":"2024-10-23T10:47:54.212Z","etag":null,"topics":["csv","database","db","f1","f1db","formula1","json","mysql","opendata","postgesql","smile","sql","sqlite"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc-by-4.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/f1db.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-09-07T11:36:08.000Z","updated_at":"2024-10-22T14:33:47.000Z","dependencies_parsed_at":"2024-03-28T18:36:05.237Z","dependency_job_id":"dea946de-8ac9-4307-a2bb-dc9c127b4b49","html_url":"https://github.com/f1db/f1db","commit_stats":{"total_commits":540,"total_committers":3,"mean_commits":180.0,"dds":"0.0037037037037036535","last_synced_commit":"4381dd19411e570352e51dc1bf2dd8d1818816af"},"previous_names":[],"tags_count":87,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/f1db%2Ff1db","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/f1db%2Ff1db/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/f1db%2Ff1db/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/f1db%2Ff1db/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/f1db","download_url":"https://codeload.github.com/f1db/f1db/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247174423,"owners_count":20896078,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["csv","database","db","f1","f1db","formula1","json","mysql","opendata","postgesql","smile","sql","sqlite"],"created_at":"2024-09-24T20:45:31.649Z","updated_at":"2025-04-04T12:09:30.246Z","avatar_url":"https://github.com/f1db.png","language":"Kotlin","readme":"[![GitHub Release](https://img.shields.io/github/v/release/f1db/f1db?style=for-the-badge\u0026labelColor=%23333\u0026color=%23d40000\u0026)](https://github.com/f1db/f1db/releases)\n[![GitHub License](https://img.shields.io/github/license/f1db/f1db?style=for-the-badge\u0026labelColor=%23333\u0026color=%23d40000)](https://creativecommons.org/licenses/by/4.0/)\n[![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/f1db/f1db/total?style=for-the-badge\u0026labelColor=%23333\u0026color=%23d40000)](https://github.com/f1db/f1db/releases)\n[![GitHub Repo stars](https://img.shields.io/github/stars/f1db/f1db?style=for-the-badge\u0026labelColor=%23333\u0026color=%23d40000)](https://github.com/f1db/f1db/stargazers)\n\n\n## F1DB\n\n[F1DB] is the most comprehensive free open source database with all-time Formula 1 racing data and statistics.\n\nWhether you are building a custom website, mobile application or just using F1DB to query data, here is what we provide:\n\n- All drivers\n- All constructors (including chassis)\n- All engine manufacturers (including engines)\n- All tyre manufacturers\n- All circuits and location data\n- All seasons from 1950 to present; including:\n  - entrants\n  - standings\n- All races; including:\n  - free practice and warming-up results\n  - qualifying and pre-qualifying results\n  - sprint race results\n  - starting grid positions\n  - race results\n  - fastest laps\n  - pit stops\n  - driver of the day results\n  - standings\n\nNew releases will be available as soon as possible after every race. See also [Versioning](#versioning).\n\nRelease artifacts are available in the following formats:\n\n- CSV\n- JSON\n- JSON splitted (multiple data files)\n- Smile (binary variant of the JSON format)\n- SQL (MySQL, PostgreSQL or SQLite .sql dump files to create and populate a custom database)\n- SQLite database\n\n\n## Notable changes in `v2025.0.3`\n\n- Added `polePosition` property to `RaceResult` object.\n\nTo accommodate this change the JSON Schema is bumped to version `v6.1.0`.\n\n\n## Notable changes in `v2025.0.2`\n\n- Added `direction`, `length` and `turns` properties to `Circuit` object.\n- Added `direction` and `turns` properties to `Race` object (`courseLength` already exists).\n- Added `driversChampionshipDecider` and `constructorsChampionshipDecider` properties to `Race` object.\n\nTo accommodate these changes the JSON Schema is bumped to version `v6.0.0`.\n\n\n## F1DB JSON Schema\n\nThe main [`f1db.schema.json`](https://raw.githubusercontent.com/f1db/f1db/main/src/schema/current/single/f1db.schema.json)\nschema file contains all F1DB object definitions and serves as the main documentation.  \n\nFor the splitted distributions the [splitted](https://github.com/f1db/f1db/tree/main/src/schema/current/splitted)\nschema files must be used.\n\nBoth the JSON and Smile artifacts validate against the F1DB Json Schema.\n\n#### Schema version compatibility / history\n\n| Version                 | Schema Version                                                                                                                                                                                                                                    |\n|-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `\u003e=` `v2025.0.3`        | [`f1db.schema.json v6.1.0`](https://raw.githubusercontent.com/f1db/f1db/main/src/schema/v6.1.0/single/f1db.schema.json), [`f1db-*.schema.json v6.1.0 splitted`](https://github.com/f1db/f1db/tree/main/src/schema/v6.1.0/splitted)                |\n| `\u003e=` `v2025.0.2`        | [`f1db.schema.json v6.0.0`](https://raw.githubusercontent.com/f1db/f1db/main/src/schema/v6.0.0/single/f1db.schema.json), [`f1db-*.schema.json v6.0.0 splitted`](https://github.com/f1db/f1db/tree/main/src/schema/v6.0.0/splitted)                |\n| `\u003e=` `v2024.19.0`       | [`f1db.schema.json v5.0.0`](https://raw.githubusercontent.com/f1db/f1db/main/src/schema/v5.0.0/single/f1db.schema.json), [`f1db-*.schema.json v5.0.0 splitted`](https://github.com/f1db/f1db/tree/main/src/schema/v5.0.0/splitted)                |\n| `\u003e=` `v2024.0.0.beta2`  | [`f1db.schema.json v4.1.0`](https://raw.githubusercontent.com/f1db/f1db/main/src/schema/v4.1.0/single/f1db.schema.json), [`f1db-*.schema.json v4.1.0 splitted`](https://github.com/f1db/f1db/tree/main/src/schema/v4.1.0/splitted)                |\n| `\u003e=` `v2024.0.0.beta1`  | [`f1db.schema.json v4.0.0`](https://raw.githubusercontent.com/f1db/f1db/main/src/schema/v4.0.0/single/f1db.schema.json), [`f1db-*.schema.json v4.0.0 splitted`](https://github.com/f1db/f1db/tree/main/src/schema/v4.0.0/splitted)                |\n| `\u003e=` `v2023.22.0`       | [`onlyf1-db.schema.json v3.2.0`](https://raw.githubusercontent.com/f1db/f1db/main/src/schema/v3.2.0/single/onlyf1-db.schema.json), [`onlyf1-db-*.schema.json v3.2.0 splitted`](https://github.com/f1db/f1db/tree/main/src/schema/v3.2.0/splitted) |\n| `\u003e=` `v2023.8.0`        | [`onlyf1-db.schema.json v3.1.0`](https://raw.githubusercontent.com/f1db/f1db/main/src/schema/v3.1.0/single/onlyf1-db.schema.json), [`onlyf1-db-*.schema.json v3.1.0 splitted`](https://github.com/f1db/f1db/tree/main/src/schema/v3.1.0/splitted) |\n| `\u003e=` `v2023.4.0`        | [`onlyf1-db.schema.json v3.0.0`](https://raw.githubusercontent.com/f1db/f1db/main/src/schema/v3.0.0/single/onlyf1-db.schema.json), [`onlyf1-db-*.schema.json v3.0.0 splitted`](https://github.com/f1db/f1db/tree/main/src/schema/v3.0.0/splitted) |\n| `\u003e=` `v2023.0.0.beta1`  | [`onlyf1-db.schema.json v2.0.0`](https://raw.githubusercontent.com/f1db/f1db/main/src/schema/v2.0.0/single/onlyf1-db.schema.json), [`onlyf1-db-*.schema.json v2.0.0 splitted`](https://github.com/f1db/f1db/tree/main/src/schema/v2.0.0/splitted) |\n| `\u003e=` `v2022.1.1`        | [`f1db-json-schema-v1.4.0.json`](https://raw.githubusercontent.com/f1db/f1db/main/src/schema/v1.x/f1db-json-schema-v1.4.0.json)                                                                                                                   |\n| `\u003e=` `v2022.0.0`        | [`f1db-json-schema-v1.3.0.json`](https://raw.githubusercontent.com/f1db/f1db/main/src/schema/v1.x/f1db-json-schema-v1.3.0.json)                                                                                                                   |\n| `\u003e=` `v2022.0.0.beta4`  | [`f1db-json-schema-v1.3.0.json`](https://raw.githubusercontent.com/f1db/f1db/main/src/schema/v1.x/f1db-json-schema-v1.3.0.json)                                                                                                                   |\n| `\u003e=` `v2022.0.0.beta3`  | [`f1db-json-schema-v1.2.0.json`](https://raw.githubusercontent.com/f1db/f1db/main/src/schema/v1.x/f1db-json-schema-v1.2.0.json)                                                                                                                   |\n| `\u003e=` `v2022.0.0.beta2`  | [`f1db-json-schema-v1.1.0.json`](https://raw.githubusercontent.com/f1db/f1db/main/src/schema/v1.x/f1db-json-schema-v1.1.0.json)                                                                                                                   |\n| `\u003e=` `v2022.0.0.alpha1` | [`f1db-json-schema-v1.0.0.json`](https://raw.githubusercontent.com/f1db/f1db/main/src/schema/v1.x/f1db-json-schema-v1.0.0.json)                                                                                                                   |\n\n\n## F1DB SQL / SQLite Database\n\nThe SQLite database artifact contains all data in a relational database format\nand can be used to directly query the data instead of processing the JSON format.\n\nThe database file could also serve students who want to learn SQL.\n\nWe suggest to use [SQLiteStudio] for querying the database file.\nOf course any SQLite compliant SQL client can be used as well.\n\nSince `v2024.3.0` SQL artifacts are available for MySQL, PostgreSQL and SQLite\nthat provide .sql dump files to import the schema and data directly in these database systems.\n\nIf you want to populate another database system (e.g. H2) then most likely the\nPostgreSQL .sql dump file is your best option. \nIf that doesn't work, and you want a .sql dump file for another database system to be added\nto the release artifacts, then please create a [feature request](https://github.com/f1db/f1db/issues).\n\n\n## Versioning\n\nReleases are versioned using a \"customized\" [CalVer] versioning scheme:\n\n    YYYY.RR.MICRO(.MODIFIER)\n\nwhich uses the following conventions:\n\n- **YYYY** – Full year of the season – `2025`, ..\n- **RR** – Round number within the season – `0`, `1`, `2`, .., `10`, `11`, ..\n- **MICRO** – Patch version – `0`, `1`, `2`, ..\n- **MODIFIER** – An optional text tag like `dev`, `alpha`, `beta`, `rc`, ..\n\nNote this is basically the `YYYY.MINOR.MICRO(.MODIFIER)` pattern where `MINOR` indicates the round number (`RR`).\n\nExamples:\n\n- **2025.0.0** – Pre-season release before the 1\u003csup\u003est\u003c/sup\u003e race round of the 2025 season.\n- **2025.0.1** – Pre-season patch release before the 1\u003csup\u003est\u003c/sup\u003e race round of the 2025 season.\n- **2025.0.1** – First pre-season patch release before the 1\u003csup\u003est\u003c/sup\u003e race round of the 2025 season.\n- **2025.1.0** – Final release after the 1\u003csup\u003est\u003c/sup\u003e race round of the 2025 season.\n- **2025.2.0** – Final release after the 2\u003csup\u003end\u003c/sup\u003e race round of the 2025 season.\n- **2025.2.1** – First patch release after the 2\u003csup\u003end\u003c/sup\u003e race round of the 2025 season.\n- **2025.2.2** – Second patch release after the 2\u003csup\u003end\u003c/sup\u003e race round of the 2025 season.\n\nAs you can see we use a special **RR** `0` for pre-season releases.\n\n\n## Community\n\nThe F1DB community can be found on [GitHub Discussions](https://github.com/f1db/f1db/discussions), where you can ask and answer questions, voice ideas, and share your projects.\n\nKeep in touch with us by following us on [X](https://twitter.com/f1db_com) or [Bluesky](https://bsky.app/profile/f1db.com).\n\n\n## Reporting Data Issues\n\nWe use [GitHub Issues](https://github.com/f1db/f1db/issues) to track data issues or related problems.\n\nIf you found a data issue which is not reported yet, please [create a new issue](https://github.com/f1db/f1db/issues/new).\n\n## Building from Source\n\nTo build the distribution zips simply run:\n\n    ./gradlew clean dist assemble\n\nRequires Java 21.\n\n\n## Releasing\n\n[GitHub Actions](https://github.com/f1db/f1db/actions) is used to build and upload new releases by creating a new git tag.\n\nFollow these steps:\n\n1. Update the version number in `gradle.properties`\n2. `git commit -am \"Release v\u003cversion\u003e\"`\n3. `git push`\n4. `git tag -a v\u003cversion\u003e -m \"Release v\u003cversion\u003e\"`\n3. `git push origin v\u003cversion\u003e`\n\nand the release action is automatically triggered by pushing the new tag.\n\n\n## License\n\n[![Creative Commons License][CC BY Icon Normal]][CC BY]\n\nF1DB is licensed under a [Creative Commons Attribution 4.0 International License][CC BY].\n\n\n[F1DB]: https://www.f1db.com\n[CalVer]: https://calver.org/\n[CC BY]: http://creativecommons.org/licenses/by/4.0/  \n[CC BY Icon Compact]: https://i.creativecommons.org/l/by/4.0/80x15.png\n[CC BY Icon Normal]: https://i.creativecommons.org/l/by/4.0/88x31.png\n[CC BY Plaintext]: https://creativecommons.org/licenses/by-sa/4.0/legalcode.txt\n[SQLiteStudio]: https://sqlitestudio.pl/\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ff1db%2Ff1db","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ff1db%2Ff1db","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ff1db%2Ff1db/lists"}