# F1 Championship Helper
A friendly **command-line tool** to help you track **Formula 1 driver and constructor championship standings** and see if they’re still in contention for the title.
---
## Features
- Check if a **driver is still in the running** for the World Drivers’ Championship (WDC)
- Detailed weekend-by-weekend analysis with realistic point scenarios
- Check if a **constructor can still win** the World Constructors’ Championship (WCC)
- Fetches **up-to-date F1 season schedules** using FastF1
---
## Installation
You can install directly from GitHub for development:
```bash
pip install f1-helper
```
After installation, run the CLI globally:
```bash
f1-helper
```
---
## Usage
Once started, you’ll see a simple menu:
```plaintext
--- F1 Championship Helper ---
1. Check Driver WDC Contention (simple)
2. Check Driver WDC Detailed Scenario
3. Check Constructor WCC Contention
4. Exit
```
### Examples
- Simple driver check:
```plaintext
f1-helper
Enter option: 1
Enter Driver Name: Lewis Hamilton
```
- Detailed driver scenario:
```plaintext
f1-helper
Enter option: 2
Enter Driver Name: Max Verstappen
```
- Constructor check:
```plaintext
f1-helper
Enter option: 3
Enter Constructor Name: Ferrari
```
---
## Dependencies
- **fastf1** – for F1 data and race schedules
- **tabulate** – for pretty tables in the terminal
---
## License
MIT License © 2025 Saur Deshmukh.
Raw data
{
"_id": null,
"home_page": null,
"name": "f1-helper",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "F1, Formula 1, motorsport, CLI, championship, calculator",
"author": null,
"author_email": "Saur Deshmukh <saur90044@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/0a/0e/51ae7bdeee6dd88192800590d9a1dabb231fc84bd0728a193fb953ffea7e/f1_helper-0.1.0.tar.gz",
"platform": null,
"description": "# F1 Championship Helper\r\n\r\nA friendly **command-line tool** to help you track **Formula 1 driver and constructor championship standings** and see if they\u2019re still in contention for the title. \r\n\r\n---\r\n\r\n## Features\r\n\r\n- Check if a **driver is still in the running** for the World Drivers\u2019 Championship (WDC) \r\n- Detailed weekend-by-weekend analysis with realistic point scenarios \r\n- Check if a **constructor can still win** the World Constructors\u2019 Championship (WCC) \r\n- Fetches **up-to-date F1 season schedules** using FastF1\r\n\r\n---\r\n\r\n## Installation\r\n\r\nYou can install directly from GitHub for development: \r\n\r\n```bash\r\npip install f1-helper\r\n```\r\nAfter installation, run the CLI globally:\r\n```bash\r\nf1-helper\r\n```\r\n---\r\n## Usage\r\nOnce started, you\u2019ll see a simple menu:\r\n```plaintext\r\n--- F1 Championship Helper ---\r\n1. Check Driver WDC Contention (simple)\r\n2. Check Driver WDC Detailed Scenario\r\n3. Check Constructor WCC Contention\r\n4. Exit\r\n```\r\n### Examples\r\n- Simple driver check:\r\n```plaintext\r\nf1-helper\r\nEnter option: 1\r\nEnter Driver Name: Lewis Hamilton\r\n```\r\n- Detailed driver scenario:\r\n```plaintext\r\nf1-helper\r\nEnter option: 2\r\nEnter Driver Name: Max Verstappen\r\n```\r\n- Constructor check:\r\n```plaintext\r\nf1-helper\r\nEnter option: 3\r\nEnter Constructor Name: Ferrari\r\n```\r\n---\r\n## Dependencies\r\n- **fastf1** \u2013 for F1 data and race schedules\r\n- **tabulate** \u2013 for pretty tables in the terminal\r\n---\r\n## License\r\n\r\nMIT License \u00a9 2025 Saur Deshmukh.\r\n",
"bugtrack_url": null,
"license": null,
"summary": "CLI tool to check F1 driver and constructor championship scenarios",
"version": "0.1.0",
"project_urls": null,
"split_keywords": [
"f1",
" formula 1",
" motorsport",
" cli",
" championship",
" calculator"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "abcd7fb8983b1f42802a1ae852bfd8b178fb4e1e774c9d5f0922abaa71648575",
"md5": "c4809fa73c47ee9e0f2c6477c30d28e1",
"sha256": "5fc3fb1a078082302b902adfb19c365dada07eceb68c1ac5a9a65adca0e51613"
},
"downloads": -1,
"filename": "f1_helper-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c4809fa73c47ee9e0f2c6477c30d28e1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 4560,
"upload_time": "2025-09-01T11:27:37",
"upload_time_iso_8601": "2025-09-01T11:27:37.949884Z",
"url": "https://files.pythonhosted.org/packages/ab/cd/7fb8983b1f42802a1ae852bfd8b178fb4e1e774c9d5f0922abaa71648575/f1_helper-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "0a0e51ae7bdeee6dd88192800590d9a1dabb231fc84bd0728a193fb953ffea7e",
"md5": "f6ddb5e0be658ad1506a1368e02c60b5",
"sha256": "6191aa58d33a883afc35687eea69366dbca5ae461d0a47be48dfa5cc34dcae13"
},
"downloads": -1,
"filename": "f1_helper-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "f6ddb5e0be658ad1506a1368e02c60b5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 4238,
"upload_time": "2025-09-01T11:27:39",
"upload_time_iso_8601": "2025-09-01T11:27:39.079786Z",
"url": "https://files.pythonhosted.org/packages/0a/0e/51ae7bdeee6dd88192800590d9a1dabb231fc84bd0728a193fb953ffea7e/f1_helper-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-01 11:27:39",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "f1-helper"
}