Metadata-Version: 2.4
Name: moderngraph
Version: 0.3.2
Summary: A modern, lightweight Python plotting library for modern, clean, highly customizable data visualizations.
Author-email: Mostafa Sobhy <Mostafa.Sobhy@outlook.de>
License: MIT License
        
        Copyright (c) 2026 [fullname]
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
License-File: LICENSE
Requires-Python: <3.14,>=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="https://raw.githubusercontent.com/mostafasobhy65/moderngraph/main/static/banner.svg" alt="moderngraph banner" width="600" />


  [![Release](https://img.shields.io/pypi/v/moderngraph?label=Release)](https://github.com/mostafasobhy65/moderngraph/releases)
  [![License](https://img.shields.io/pypi/l/moderngraph?label=License)](https://github.com/mostafasobhy65/moderngraph/blob/main/LICENSE)
  [![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.
