Metadata-Version: 2.3
Name: monaco-racing
Version: 0.1.1
Summary: A CLI tool to parse and report Monaco 2018 F1 qualification results.
Author: oleg-cpu
Author-email: oleg-cpu <arshavaoleg70@gmail.com>
Requires-Python: >=3.13
Description-Content-Type: text/markdown

# 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:
```bash
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.
