Metadata-Version: 2.2
Name: dayplot
Version: 0.1.0
Summary: calendar heatmaps with matplotlib
Home-page: https://github.com/JosephBARBIERDARNAL/dayplot
Author: Joseph Barbier
Author-email: Joseph Barbier <joseph.barbierdarnal@gmail.com>
Project-URL: Homepage, https://github.com/JosephBARBIERDARNAL/dayplot
Project-URL: Issues, https://github.com/JosephBARBIERDARNAL/dayplot/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Framework :: Matplotlib
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: matplotlib
Provides-Extra: data
Requires-Dist: pandas>=2.2.3; extra == "data"
Requires-Dist: requests>=2.32.3; extra == "data"
Dynamic: author
Dynamic: home-page

# dayplot

A simple-to-use Python library to build **calendar heatmaps** with ease.

It's built on top of **matplotlib** and leverages it to access high customization possibilities.

<br>

## Quick start

```py
import matplotlib.pyplot as plt
import dayplot as dp

df = dp.load_dataset()  # requires pandas to be installed

fig, ax = plt.subplots(figsize=(15, 6))
dp.calendar(
    dates=df["dates"],
    values=df["values"],
    start_date="2024-01-01",
    end_date="2024-12-31",
    ax=ax,
)
```

![](https://raw.githubusercontent.com/JosephBARBIERDARNAL/dayplot/refs/heads/main/docs/img/quickstart.png)

<br>

## Installation

```bash
pip install git+https://github.com/JosephBARBIERDARNAL/dayplot.git
```

<br>

## Related projects

- [calplot](https://github.com/tomkwok/calplot)
- [july](https://github.com/e-hulten/july)
- [calendarplot](https://github.com/dhowland/calendarplot)

<br><br>
