Metadata-Version: 2.4
Name: gitplot
Version: 0.2.0
Summary: Git history visualizations from the command line
Keywords: cli,git,visualization,code-archaeology
Author: Maximilian Wolf
License-Expression: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Dist: tyro>=1.0.8
Requires-Dist: polars>=1.38.1
Requires-Dist: altair>=6.0.0
Requires-Dist: vl-convert-python>=1.9.0
Requires-Python: >=3.14
Project-URL: Repository, https://github.com/MaxWolf-01/gitplot
Project-URL: Issues, https://github.com/MaxWolf-01/gitplot/issues
Description-Content-Type: text/markdown

# gitplot

Git history visualizations from the command line.

## Quick Start

```bash
uvx gitplot sediment https://github.com/pola-rs/polars
uvx gitplot sediment /path/to/local/repo --samples 50 --workers 2
```

## Charts

### sediment

Stacked area chart showing code age layers over time. Each color band represents
lines of code from a specific time period, revealing how quickly code gets replaced.

Based on [gitcharts](https://github.com/koaning/gitcharts) by [Vincent D. Warmerdam](https://github.com/koaning).

```bash
gitplot sediment repo                              # default: quarter granularity, 100 samples, PNG
gitplot sediment repo --granularity year            # group by year instead of quarter
gitplot sediment repo --since 2023-01-01            # only show recent history
gitplot sediment repo --format svg                  # SVG output
gitplot sediment repo --samples 200                 # more data points (incremental)
open $(gitplot sediment repo --quiet)               # open the chart directly
```

Raw blame data is stored as parquet for incremental reuse. Re-running with more
samples only computes the delta. Changing visual settings (granularity, since,
format) is instant.

## Development

```bash
uv sync
make check
make test
```
