Metadata-Version: 2.4
Name: attaviz
Version: 0.1.0
Summary: Publication-ready World Bank Group charts and maps for Altair
License: MPL-2.0
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: altair>=5.0
Requires-Dist: pandas>=2.0
Requires-Dist: pyarrow>13.0.0
Requires-Dist: vegafusion>=2.0.3
Requires-Dist: vl-convert-python>=1.9.0.post1
Provides-Extra: maps
Requires-Dist: geopandas>=1.0; extra == "maps"
Dynamic: license-file

# attaviz

Publication-ready Altair themes, chart factories, and choropleth maps based on
the [World Bank Group Data Visualization Style Guide](https://worldbank.github.io/data-visualization-style-guide/).

**Documentation:** <https://datapartnership.github.io/attaviz/>

## Install

```bash
uv add "attaviz @ git+https://github.com/datapartnership/attaviz.git"
# or
pip install "git+https://github.com/datapartnership/attaviz.git"
```

Add the optional `maps` extra for choropleths: `pip install "attaviz[maps] @ git+https://github.com/datapartnership/attaviz.git"`.

## Quick start

```python
import pandas as pd
import attaviz

attaviz.enable()  # every chart now uses the WBG theme

data = pd.DataFrame(
    {"country": ["Indonesia", "Malaysia"], "population": [280, 35]}
)

chart = attaviz.bar(
    data,
    category="country",
    value="population",
    title="Population by country (millions)",
)
```

See the [documentation site](https://datapartnership.github.io/attaviz/) for the full gallery and reference.
