monaco-qualifying 0.1.0

Analysis of Formula 1 qualification results.

monaco-qualifying

License: MIT
GitLab Repo

Python-пакет для аналізу даних кваліфікації Формули 1 - Monaco 2018, який читає дані з трьох файлів:

• start.log
• end.log
• abbreviations.txt обчислює найкращі часи кіл, сортує гонщиків за часом кола та виводить звіт, що показує в таблиці топ-15 гонщиків та
• решту, яка не ввійшла до топ-15.

---

Зміст

• Посилання проекту
• Встановлення
• Використання
  • CLI
• Документація
• Приклади
• Оновлення пакету
• Тестування
• Структура проекту
• Пошук проблем

---

Посилання проекту

• Домашня сторінка: [monaco-qualifying на GitLab] (https://git.foxminded.ua/liliia-shpytsia-mentoring/task_6_report_of_monaco_2018_racing)
• Випуски: [Releases] (https://git.foxminded.ua/liliia-shpytsia-mentoring/task_6_report_of_monaco_2018_racing/-/releases)
• Ліцензія: [MIT License] (https://git.foxminded.ua/liliia-shpytsia-mentoring/task_6_report_of_monaco_2018_racing/-/blob/dev/LICENSE)
• Відкрити Issue: [Створити Issue] (https://git.foxminded.ua/liliia-shpytsia-mentoring/task_6_report_of_monaco_2018_racing/-/issues)

---

Встановлення

pip install monaco-qualifying

---

Використання

CLI

• Для виводу повного звіту гонщиків:

monaco-qualifying --files ./data --asc

• Для перегляду інформації про конкретного гонщика:

monaco-qualifying --files ./data --driver "Sebastian Vettel"

Примітка aргумент --driver показує тільки інформацію про вибраного гонщика. Порядок сортування задається параметрами --asc чи --desc (за замовчуванням - asc).

---

Документація

1. Відкрити Python-інтерпретатор:

python

1. Імпортувати модуль і викликати help():

from .driver_3_version import RecordData
help(RecordData)

---

Приклади

Приклад звіту

1. Sebastian Vettel | FERRARI | 1:4.415
2. Valtteri Bottas | MERCEDES | 1:12.434
3. Stoffel Vandoorne | MCLAREN RENAULT | 1:12.463
...
----------------------------------------------------------------------
16. Daniel Ricciardo | RED BULL RACING TAG HEUER | 2:47.987
17. Sergey Sirotkin | WILLIAMS MERCEDES | 4:47.294

Оновлення пакету

pip install --upgrade monaco-qualifying

---

Тестування

1. Клонувати репозиторій:

git clone https://git.foxminded.ua/liliia-shpytsia-mentoring/task_6_report_of_monaco_2018_racing.git 
cd task_6_report_of_monaco_2018_racing

1. Створити середовище та встановити залежності за допомогою uv:

uv venv
uv pip install -r uv.lock

1. Використати ruff для перевірки стилю коду.

ruff check .--fix

1. Запустити тести:

pytest

---

Структура проекту

task_6_report_of_monaco_2018_racing/
|-- data/
|   +-- abbreviations.txt
|   +-- end.log
|   +-- start/log
|-- src/
|   +-- monaco_qualifying/
|   |   +-- __init__.py
|   |   +-- driver_3_version.py
|-- tests/
|   +-- __init__.py
|   +-- test_driver.py
|-- .gitignore
|-- .gitlab-ci.yml
|-- LICENSE
|-- main.py
|-- pyproject.toml
|README.md
|--uv.lock

---

Пошук проблем

• Якщо виникли проблеми, створити [Issue] (https://git.foxminded.ua/liliia-shpytsia-mentoring/task_6_report_of_monaco_2018_racing/-/issues)на GitLab.

---