Metadata-Version: 2.4
Name: vcds-plotter
Version: 0.2.0
Summary: Plot VCDS CSV data with Matplotlib – a small, testable CLI tool.
Author-email: Supporterino <lars@roth-kl.de>
License: MIT
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: pandas>=2.0
Requires-Dist: matplotlib>=3.8

# VCDS-Plotter

{{description}}

## Installation

```bash
pip install vcds-plotter
```

> The console script is installed as `vcds‑plot`.  
> See the help output for all options:

```bash
vcds-plot --help
```

## Usage

```bash
# Plot the newest CSV file in the logs directory, grouping by unit
vcds-plot --group-by-unit

# Plot only the engine speed and temperature, excluding a noisy sensor
vcds-plot --metric Motordrehzahl,Temperatur --exclude SensorX

# Define a custom group that will be plotted in its own figure
vcds-plot --group "Engine & temp=Motordrehzahl,Temperatur"
```

## Development

```bash
# Install dev deps & pre‑commit hooks
task install

# Run tests, linters and formatting checks
task test
task lint
task format

# Generate a changelog from git history
task changelog
```

## Contributing

Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details.

## License

MIT © Supporterino
