Metadata-Version: 2.4
Name: easy-viz
Version: 0.1.0
Summary: The Metabase / Power BI of Python at the code level: query result in, finished Plotly figure out.
Keywords: plotly,visualization,charts,sql,analytics,dataframe
Author: Arian Mokhtariha
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Framework :: Jupyter
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: 3.15
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: Typing :: Typed
Requires-Dist: plotly>=7.1
Requires-Dist: narwhals>=2.8
Requires-Dist: numpy>=2.1
Requires-Dist: scipy>=1.14.1
Requires-Dist: kaleido>=1.5 ; extra == 'export'
Requires-Python: >=3.13
Project-URL: Homepage, https://github.com/arianmokhtariha/easy-viz
Project-URL: Repository, https://github.com/arianmokhtariha/easy-viz
Project-URL: Changelog, https://github.com/arianmokhtariha/easy-viz/blob/main/CHANGELOG.md
Project-URL: Issues, https://github.com/arianmokhtariha/easy-viz/issues
Provides-Extra: export
Description-Content-Type: text/markdown

# easy-viz

[![CI](https://github.com/arianmokhtariha/easy-viz/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/arianmokhtariha/easy-viz/actions/workflows/ci.yml)

The Metabase / Power BI of Python, at the code level: a query result goes in, a
finished Plotly figure comes out.

Run your SQL (or anything else), pass the table straight to an easy-viz function, and
get a finished chart. Every feature of the chart is a typed, documented parameter, so a
plot goes from a one-line default to an advanced chart by changing arguments, not by
writing plotting code. Every function returns a plain Plotly figure, so anything the
parameters don't cover can still be done with Plotly.

> **Status:** alpha, under active development. The API may still change between
> 0.x releases; the [changelog](https://github.com/arianmokhtariha/easy-viz/blob/main/CHANGELOG.md)
> lists every change.

## Install
```
pip install easy-viz
```
For PNG, SVG and PDF export with `ev.save()`, add the `export` extra (it needs
Chrome; `plotly_get_chrome` installs it):
```
pip install "easy-viz[export]"
```
Python 3.13 or newer.

The [gallery](https://github.com/arianmokhtariha/easy-viz/tree/main/gallery) shows
every function on a fictional retailer's data, starting from a SQL query each time.

## Development
```
uv sync --all-extras --all-groups
uv run pytest
```
What easy-viz is for: [`docs/product.md`](https://github.com/arianmokhtariha/easy-viz/blob/main/docs/product.md).
How it's organised, and why: [`docs/`](https://github.com/arianmokhtariha/easy-viz/tree/main/docs).
<!-- Links are absolute because this file is also the PyPI project page, where
relative links break. -->

