Metadata-Version: 2.1
Name: altair-extra-color-schemes
Version: 0.1.0
Summary: Additional named color schemes for Altair via a custom renderer.
Home-page: https://github.com/joaopalmeiro/altair-extra-color-schemes
License: MIT
Author: João Palmeiro
Author-email: joaopalmeiro@proton.me
Requires-Python: >=3.7,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Requires-Dist: altair (>=4.2,<4.3)
Project-URL: Bug Tracker, https://github.com/joaopalmeiro/altair-extra-color-schemes/issues
Project-URL: Repository, https://github.com/joaopalmeiro/altair-extra-color-schemes
Project-URL: Twitter, https://twitter.com/joaompalmeiro
Description-Content-Type: text/markdown

# altair-extra-color-schemes

Additional named color schemes for [Altair](https://altair-viz.github.io/) via a custom renderer.

## Quickstart

### Installation

Via [pip](https://pip.pypa.io/):

```bash
pip install altair-extra-color-schemes
```

Via [Pipenv](https://pipenv.pypa.io/):

```bash
pipenv install altair-extra-color-schemes
```

Via [Poetry](https://python-poetry.org/):

```bash
poetry add altair-extra-color-schemes
```

Via [PDM](https://pdm.fming.dev/):

```bash
pdm add altair-extra-color-schemes
```

Via [Pyflow](https://github.com/David-OConnor/pyflow):

```bash
pyflow install altair-extra-color-schemes
```

### Usage

```python
import altair as alt
alt.renderers.enable("extra_color_schemes")
```

You can find some example charts in the [`demo.ipynb` notebook](demo.ipynb).

## Color schemes

| Color scheme name | Source                                                                                                | Notes                                                          |
| ----------------- | ----------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- |
| `"dvs"`           | [Data Visualization Standards (DVS)](https://xdgov.github.io/data-design-standards/components/colors) | "Featured Colors" and "Qualitative Colors" > "Example Palette" |

## Development

> [Poetry](https://python-poetry.org/) (version 1.2.0b3)

- `poetry config virtualenvs.in-project true`
- `poetry install`
- `poetry run jupyter lab`
- `poetry run black demo.ipynb`
- `poetry check`

## Deployment

- `poetry version minor` or `poetry version patch`
- `poetry build`

## Notes

- [djLint](https://djlint.com/):
  - `pipx install djlint`
  - `djlint altair_extra_color_schemes/template.jinja --check`
  - `djlint altair_extra_color_schemes/template.jinja --reformat`
  - `djlint altair_extra_color_schemes/template.jinja --profile=jinja`
- [Default color schemes](https://vega.github.io/vega-lite/docs/scale.html#scheme)

