Metadata-Version: 2.4
Name: moderngraph
Version: 0.3.0
Summary: A modern, lightweight Python plotting library for modern, clean, highly customizable data visualizations.
Author-email: Mostafa Sobhy <Mostafa.Sobhy@outlook.de>
License-File: LICENSE
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Requires-Dist: matplotlib>=3.10.9
Requires-Dist: pandas>=2.0.0
Requires-Dist: polars>=1.40.1
Requires-Dist: pyarrow>=24.0.0
Requires-Dist: seaborn>=0.13.2
Description-Content-Type: text/markdown

<div align="center">
  <img src="static/banner.svg" alt="moderngraph banner" width="600" />


  [![PyPI Version](https://img.shields.io/pypi/v/moderngraph)](https://pypi.org/project/moderngraph/)
  [![PyPI - License](https://img.shields.io/pypi/l/moderngraph)](https://pypi.org/project/moderngraph/)
  [![Python Supported](https://img.shields.io/pypi/pyversions/moderngraph.svg)](https://pypi.org/project/moderngraph/)
  [![CI](https://img.shields.io/github/actions/workflow/status/mostafasobhy65/moderngraph/ci.yml?branch=main&label=CI)](https://github.com/mostafasobhy65/moderngraph/actions?query=workflow%3Aci)
  [![CD](https://img.shields.io/github/actions/workflow/status/mostafasobhy65/moderngraph/cd.yml?branch=main&label=CD)](https://github.com/mostafasobhy65/moderngraph/actions?query=workflow%3Acd)
  [![Coverage](https://img.shields.io/codecov/c/github/mostafasobhy65/moderngraph)](https://codecov.io/gh/mostafasobhy65/moderngraph)


  **A modern, lightweight Python plotting library for modern, clean, highly customizable data visualizations.**
</div>

---

## Features

- **Minimalist API:** Create stunning visuals (heatmaps, bar plots, etc.) with just a few lines of code.
- **Highly Customizable:** Built on top of `seaborn` and `matplotlib`.
- **Data Ready:** Native support for `pandas` and `polars` DataFrames.
- **Smart Themes:** Clean, modern defaults to make your graphs presentation-ready out of the box.

## Installation

```bash
pip install moderngraph
```

## Quickstart

Render a beautiful heatmap effortlessly:

```python
import pandas as pd
from moderngraph.heatmaps.modern_heatmap import ModernHeatmap

# 1. Create some data
data = pd.DataFrame({
    "A": [1, 2],
    "B": [3, 4]
})

# 2. Plot a beautiful heatmap
heatmap = ModernHeatmap(data)
heatmap.plot()
```

> **Tip:** Check out the interactive [EDA Notebooks](notebooks/) for more in-depth examples!

## Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page or submit a pull request.
