Metadata-Version: 2.4
Name: gocharts
Version: 0.1.2
Summary: A Python charting library with support for pandas, polars, and numpy.
Author-email: Edvinas Drevinskas <e.drevinskas@gmail.com>
License-Expression: GPL-3.0-or-later
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: polars>=0.17.0
Requires-Dist: pandas>=1.3.0
Requires-Dist: numpy>=1.21.0
Requires-Dist: ipython>=7.0
Requires-Dist: pyarrow>=10.0.0
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: ruff; extra == "dev"
Provides-Extra: docs
Requires-Dist: mkdocs>=1.5; extra == "docs"
Requires-Dist: mkdocs-material>=9.0; extra == "docs"
Requires-Dist: mkdocstrings[python]>=0.24; extra == "docs"
Requires-Dist: zensical>=0.1; extra == "docs"
Dynamic: license-file

# gocharts

[![CI](https://github.com/EdvinasD/gochart/actions/workflows/ci.yml/badge.svg)](https://github.com/EdvinasD/gochart/actions/workflows/ci.yml)

**gocharts** is a Python library for creating interactive, public facing quality charts using [ECharts](https://echarts.apache.org/) and a grammar of graphics approach inspired by [ggplot2](https://ggplot2.tidyverse.org/).

## Features

- **Grammar of Graphics**: Build complex visualizations by layering components (data, aesthetics, geoms, scales, etc.).
- **Interactive Charts**: Powered by ECharts for rich, interactive visualizations.
- **Flexible API**: Compose plots using a familiar, declarative syntax.
- **Export Options**: Render charts in Jupyter notebooks, web apps, or export as HTML.

## Installation

```bash
pip install gocharts
```

## Quick Start

```python
import gocharts as go
import pandas as pd

df = pd.DataFrame({
    "time": [1, 2, 3, 4],
    "score": [10, 15, 13, 17]
})

gochart = go.Chart(df) \
    .geom('line', map = {'x':'time','y':'score'})

gochart.display()
```

## Documentation

- [User Guide](docs/user_guide.md)
- [API Reference](docs/api.md)
- [Examples](examples/)

## License

TBD

## Acknowledgements

- [ECharts](https://echarts.apache.org/)
- [ggplot2](https://ggplot2.tidyverse.org/)
- Inspired by the grammar of graphics paradigm
