monaco-racing 0.1.1

A CLI tool to parse and report Monaco 2018 F1 qualification results.

Monaco Racing (CLI Tool)

A lightweight CLI tool to parse, calculate, and report Monaco 2018 Formula 1 qualification results (Q1 stage) from raw log files.

Features

• Log Parsing: Processes fictional timestamps from start.log and end.log matching them with abbreviations.txt.
• Lap Time Calculation: Computes precise lap times for each racer.
• Smart Sorting: Orders racers from fastest to slowest (or vice versa).
• F1 Q1 Rule Compliance: Automatically draws an underline after the 15th position to separate eliminated drivers.
• Driver Lookup: Instantly find statistics for a specific driver by name.

---

Installation

You can install the package from PyPI using either uv or pip.

Using uv (Recommended)

Installs the tool globally in an isolated environment:

uv tool install monaco-racing
pip install monaco-racing

Usage

1. Standard Report (Ascending order) Prints the full list of drivers from fastest to slowest (top 15 are separated by an underline):

monaco-report --files "path/to/data/folder"

2. Reversed Report (Descending order) Prints the full list of drivers from slowest to fastest:

monaco-report --files "path/to/data/folder" --desc

3. Search for a Specific Driver Shows statistics only for the specified driver:

monaco-report --files "path/to/data/folder" --driver "Sebastian Vettel"

4. Help Menu To see all available CLI arguments and options:

monaco-report --help

Documentation

Technical specifications and design decisions are documented separately in the RFC.md file.