<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/feedzai/feedzai-altair-theme/master/assets/notebook_header_dark.svg" />
<img alt="" src="https://raw.githubusercontent.com/feedzai/feedzai-altair-theme/master/assets/notebook_header.svg" height="96" />
</picture>
# feedzai-altair-theme
[](https://pypi.org/project/feedzai-altair-theme/)
[](https://mybinder.org/v2/gh/feedzai/feedzai-altair-theme/master?urlpath=/lab/tree/demo.ipynb)
[](https://colab.research.google.com/github/feedzai/feedzai-altair-theme/blob/master/demo.ipynb)
Feedzai's theme for [Altair](https://github.com/altair-viz/altair) charts.
## Sneak peek
## Quickstart
### Installation
Via [pip](https://github.com/pypa/pip):
```bash
pip install feedzai-altair-theme
```
Via [Pipenv](https://pipenv.pypa.io/):
```bash
pipenv install feedzai-altair-theme
```
Via [Poetry](https://python-poetry.org/):
```bash
poetry add feedzai-altair-theme
```
Via [PDM](https://pdm.fming.dev/):
```bash
pdm add feedzai-altair-theme
```
Via [uv](https://docs.astral.sh/uv/):
```bash
uv add feedzai-altair-theme
```
### Usage
```python
import altair as alt
alt.theme.enable("feedzai")
```
You can find some example charts in the [`demo.ipynb` notebook](demo.ipynb).
## Development
Assuming [uv](https://docs.astral.sh/uv/getting-started/installation/) is installed, install Python:
```bash
uv python install
```
Create and activate the development environment:
```bash
uv sync
```
```bash
source .venv/bin/activate
```
After implementing changes, type-check with mypy, then lint and format the code with Ruff:
```bash
mypy
```
```bash
ruff check --fix
```
```bash
ruff format
```
To see the changes applied to some example charts, use the [`demo.ipynb` notebook](demo.ipynb):
```bash
jupyter lab demo.ipynb
```
Once done, deactivate the development environment:
```bash
deactivate
```
## Deployment
### Bump the package version
Bump the feedzai-altair-theme version using one of the following commands, according to the [Semantic Versioning](https://semver.org/) specification:
```bash
uv version --bump patch
```
```bash
uv version --bump minor
```
```bash
uv version --bump major
```
Next, confirm you can build the package locally:
```bash
uv build
```
### Open a PR
Once the changes are finished and the feedzai-altair-theme version is updated, open a [PR](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request). After the PR is merged, a maintainer will ensure a new package version is released.
### Release the new package version
To release a new version of feedzai-altair-theme, create a new (lightweight) tag from the `master` branch, and a GitHub Actions workflow will take care of the rest:
```bash
git tag "v$(uv version --short)"
```
```bash
git tag -n
```
```bash
git push origin --tags
```
## Misc
### Install the feedzai-altair-theme package in an environment without an Internet connection
#### Via repo
First, download the repo and move it to your environment. Then install the package with pip (or an equivalent) by pointing to the folder path and adding the necessary flags:
```bash
pip install feedzai-altair-theme/ --no-deps --no-build-isolation
```
This command assumes that the feedzai-altair-theme [dependencies](https://github.com/feedzai/feedzai-altair-theme/blob/master/pyproject.toml) and the [uv build backend](https://docs.astral.sh/uv/concepts/build-backend/) are already installed in your environment. For more information about the additional flags, check the [pip install documentation](https://pip.pypa.io/en/stable/cli/pip_install/).
#### Via wheel
First, download the [wheel (a.k.a. built distribution)](https://pypi.org/project/feedzai-altair-theme/#files) and move it to your environment. Then install the package with pip (or an equivalent) by pointing to the file path and adding the necessary flags after replacing `<VERSION>`:
```bash
pip install feedzai_altair_theme-<VERSION>-py3-none-any.whl
```
This command assumes that the feedzai-altair-theme [dependencies](https://github.com/feedzai/feedzai-altair-theme/blob/master/pyproject.toml) are already installed in your environment.
Raw data
{
"_id": null,
"home_page": null,
"name": "feedzai-altair-theme",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "altair, theme, data, visualization",
"author": "Feedzai",
"author_email": "Feedzai <oss-licenses@feedzai.com>",
"download_url": "https://files.pythonhosted.org/packages/18/7d/8c81de8efbf1fc5c29cfca446ab10a2a2a2e55169027014198d414a0a545/feedzai_altair_theme-2.0.0.tar.gz",
"platform": null,
"description": "<picture>\n <source media=\"(prefers-color-scheme: dark)\" srcset=\"https://raw.githubusercontent.com/feedzai/feedzai-altair-theme/master/assets/notebook_header_dark.svg\" />\n <img alt=\"\" src=\"https://raw.githubusercontent.com/feedzai/feedzai-altair-theme/master/assets/notebook_header.svg\" height=\"96\" />\n</picture>\n\n# feedzai-altair-theme\n\n[](https://pypi.org/project/feedzai-altair-theme/)\n[](https://mybinder.org/v2/gh/feedzai/feedzai-altair-theme/master?urlpath=/lab/tree/demo.ipynb)\n[](https://colab.research.google.com/github/feedzai/feedzai-altair-theme/blob/master/demo.ipynb)\n\nFeedzai's theme for [Altair](https://github.com/altair-viz/altair) charts.\n\n## Sneak peek\n\n\n\n## Quickstart\n\n### Installation\n\nVia [pip](https://github.com/pypa/pip):\n\n```bash\npip install feedzai-altair-theme\n```\n\nVia [Pipenv](https://pipenv.pypa.io/):\n\n```bash\npipenv install feedzai-altair-theme\n```\n\nVia [Poetry](https://python-poetry.org/):\n\n```bash\npoetry add feedzai-altair-theme\n```\n\nVia [PDM](https://pdm.fming.dev/):\n\n```bash\npdm add feedzai-altair-theme\n```\n\nVia [uv](https://docs.astral.sh/uv/):\n\n```bash\nuv add feedzai-altair-theme\n```\n\n### Usage\n\n```python\nimport altair as alt\n\nalt.theme.enable(\"feedzai\")\n```\n\nYou can find some example charts in the [`demo.ipynb` notebook](demo.ipynb).\n\n## Development\n\nAssuming [uv](https://docs.astral.sh/uv/getting-started/installation/) is installed, install Python:\n\n```bash\nuv python install\n```\n\nCreate and activate the development environment:\n\n```bash\nuv sync\n```\n\n```bash\nsource .venv/bin/activate\n```\n\nAfter implementing changes, type-check with mypy, then lint and format the code with Ruff:\n\n```bash\nmypy\n```\n\n```bash\nruff check --fix\n```\n\n```bash\nruff format\n```\n\nTo see the changes applied to some example charts, use the [`demo.ipynb` notebook](demo.ipynb):\n\n```bash\njupyter lab demo.ipynb\n```\n\nOnce done, deactivate the development environment:\n\n```bash\ndeactivate\n```\n\n## Deployment\n\n### Bump the package version\n\nBump the feedzai-altair-theme version using one of the following commands, according to the [Semantic Versioning](https://semver.org/) specification:\n\n```bash\nuv version --bump patch\n```\n\n```bash\nuv version --bump minor\n```\n\n```bash\nuv version --bump major\n```\n\nNext, confirm you can build the package locally:\n\n```bash\nuv build\n```\n\n### Open a PR\n\nOnce the changes are finished and the feedzai-altair-theme version is updated, open a [PR](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request). After the PR is merged, a maintainer will ensure a new package version is released.\n\n### Release the new package version\n\nTo release a new version of feedzai-altair-theme, create a new (lightweight) tag from the `master` branch, and a GitHub Actions workflow will take care of the rest:\n\n```bash\ngit tag \"v$(uv version --short)\"\n```\n\n```bash\ngit tag -n\n```\n\n```bash\ngit push origin --tags\n```\n\n## Misc\n\n### Install the feedzai-altair-theme package in an environment without an Internet connection\n\n#### Via repo\n\nFirst, download the repo and move it to your environment. Then install the package with pip (or an equivalent) by pointing to the folder path and adding the necessary flags:\n\n```bash\npip install feedzai-altair-theme/ --no-deps --no-build-isolation\n```\n\nThis command assumes that the feedzai-altair-theme [dependencies](https://github.com/feedzai/feedzai-altair-theme/blob/master/pyproject.toml) and the [uv build backend](https://docs.astral.sh/uv/concepts/build-backend/) are already installed in your environment. For more information about the additional flags, check the [pip install documentation](https://pip.pypa.io/en/stable/cli/pip_install/).\n\n#### Via wheel\n\nFirst, download the [wheel (a.k.a. built distribution)](https://pypi.org/project/feedzai-altair-theme/#files) and move it to your environment. Then install the package with pip (or an equivalent) by pointing to the file path and adding the necessary flags after replacing `<VERSION>`:\n\n```bash\npip install feedzai_altair_theme-<VERSION>-py3-none-any.whl\n```\n\nThis command assumes that the feedzai-altair-theme [dependencies](https://github.com/feedzai/feedzai-altair-theme/blob/master/pyproject.toml) are already installed in your environment.\n",
"bugtrack_url": null,
"license": null,
"summary": "Feedzai's theme for Altair charts.",
"version": "2.0.0",
"project_urls": {
"Changelog": "https://github.com/feedzai/feedzai-altair-theme/blob/master/CHANGELOG.md",
"Issues": "https://github.com/feedzai/feedzai-altair-theme/issues",
"Source": "https://github.com/feedzai/feedzai-altair-theme"
},
"split_keywords": [
"altair",
" theme",
" data",
" visualization"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "633b4e4cf02294b87b66bf9146ab6d5aed36ae3f093e32a47d6146a9c032b5da",
"md5": "b203e909f54d6c7ced56819c237cee99",
"sha256": "cd7e11f04df4d0fa229e0d89362bfdabf1ec522eeb2f2795b6c5fce8bf455ae4"
},
"downloads": -1,
"filename": "feedzai_altair_theme-2.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b203e909f54d6c7ced56819c237cee99",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 12500,
"upload_time": "2025-09-03T10:52:21",
"upload_time_iso_8601": "2025-09-03T10:52:21.782103Z",
"url": "https://files.pythonhosted.org/packages/63/3b/4e4cf02294b87b66bf9146ab6d5aed36ae3f093e32a47d6146a9c032b5da/feedzai_altair_theme-2.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "187d8c81de8efbf1fc5c29cfca446ab10a2a2a2e55169027014198d414a0a545",
"md5": "13444737a4b25a8fc20d474b1565a0c5",
"sha256": "80d0019edf38beb0f83c220cf04c91c7a6bc0243eaae6d3f7a6a6f20667a1ea0"
},
"downloads": -1,
"filename": "feedzai_altair_theme-2.0.0.tar.gz",
"has_sig": false,
"md5_digest": "13444737a4b25a8fc20d474b1565a0c5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 9746,
"upload_time": "2025-09-03T10:52:22",
"upload_time_iso_8601": "2025-09-03T10:52:22.527222Z",
"url": "https://files.pythonhosted.org/packages/18/7d/8c81de8efbf1fc5c29cfca446ab10a2a2a2e55169027014198d414a0a545/feedzai_altair_theme-2.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-03 10:52:22",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "feedzai",
"github_project": "feedzai-altair-theme",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "feedzai-altair-theme"
}
JSON
