sphinxext-altair: Sphinx extension for embedding Altair charts
Project description
sphinxext-altair
sphinxext-altair provides the directive altair-plot
to insert live-rendered Altair plots within your Sphinx documentation:
.. altair-plot::
import altair as alt
from vega_datasets import data
cars = data.cars()
alt.Chart(cars).mark_point().encode(
x='Horsepower',
y='Miles_per_Gallon',
color='Origin',
shape='Origin'
)
You can enable the extension by adding it to your conf.py
:
extensions = [
...
"sphinxext_altair.altairplot",
...
]
You can find all available options in the docstring of sphinxext_altair/altairplot.py
. For more examples on how to use this extension, see the test Sphinx documentation in tests/roots/test-altairplot
or the official Altair documentation.
You can install the extension with:
pip install sphinxext-altair
Contributing
It's recommended to use a virtual environment for development:
python -m venv .venv
# Install the project in editable mode including development dependencies
pip install -e '.[dev]'
sphinxext-altair
uses black for code formatting, mypy for static type checking, ruff for various linting rules, and pytest for testing. All these tools can be executed by running:
hatch run test
As part of those tests, a Sphinx documentation is built at tests/roots/test-altairplot
. You can manually build this documentation and view it which is very useful during development of a new feature. For example, if you want to add a new option to the altair-plot
directive, you can add another example in the file tests/roots/test-altairplot/index.rst
and then build and view the documentation by running:
hatch run build-test-docs
hatch run serve-test-docs
The test documentation can now be viewed at http://localhost:8000.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file sphinxext_altair-0.2.0.tar.gz
.
File metadata
- Download URL: sphinxext_altair-0.2.0.tar.gz
- Upload date:
- Size: 8.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: python-httpx/0.24.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | eac920f97fdc9d44b669f442c24f6d96ea4f236179b96c25df41a8cd4385e5f6 |
|
MD5 | 4ec37c58815f710ffd30fddd243edda9 |
|
BLAKE2b-256 | ea2c41b5f3079481f4e49a9451be1a429fda3dec1e51786875e104ef3c95d836 |
File details
Details for the file sphinxext_altair-0.2.0-py3-none-any.whl
.
File metadata
- Download URL: sphinxext_altair-0.2.0-py3-none-any.whl
- Upload date:
- Size: 7.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: python-httpx/0.24.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4a307add6a530586794ba80204d724305009b5f499782cf1f828af0fc1d056b9 |
|
MD5 | b7700e446fd40542adda3c51afd288d0 |
|
BLAKE2b-256 | 81c915bd3bf427be9dc4f4d06bb7fcc4b0b7fb82aef07e25c5026bb52c819380 |