charite-plot 0.1.1__tar.gz → 0.3.0__tar.gz

charite_plot-0.3.0/CHANGELOG.md

@@ -0,0 +1,54 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.3.0] - 2026-07-18
+
+### Added
+
+- `theme_charite` (matplotlib) gained a `background` parameter (sets figure and axes facecolor).
+- Altair now provides a `using()` context manager mirroring the matplotlib one, for scoping the theme to a `with` block.
+- Explicit `__all__` declarations on every module (and the package) to define the public API surface for `from charite_plot import *` and tooling.
+
+### Changed
+
+- **Unified API across backends.** The matplotlib activate function was renamed `apply_theme(params)` → `enable(**kwargs)`, and `using()` now takes theme keyword arguments instead of a pre-built dict — matching the Altair backend. Migrate `apply_theme(theme_charite(palette="x"))` to `enable(palette="x")` and `using(theme_charite(palette="x"))` to `using(palette="x")`. `theme_charite()` still returns a plain dict if you prefer to apply it manually via `mpl.rcParams.update()`.
+
+### Removed
+
+- `mpl_themes.apply_theme()` — replaced by `mpl_themes.enable()` (see above).
+
+## [0.2.0] - 2026-07-01
+
+### Added
+
+- `theme_charite` (matplotlib) gained `interactive` and `tiny_margins` parameters.
+- `theme_charite` (Altair) gained `thickness` and `tiny_margins` parameters, bringing it to parity with the matplotlib backend.
+
+### Changed
+
+- Font-size ramp is now shared between both backends: labels scale at 1× and legend text at 0.8× the base size. Altair legend labels are slightly smaller and axis labels slightly larger as a result.
+
+## [0.1.1] - 2026-06-13
+
+### Fixed
+
+- README images now use absolute raw GitHub URLs so they render correctly on PyPI.
+- Corrected PyPI project URLs (homepage, docs, repository, bug tracker).
+
+## [0.1.0] - 2026-06-12
+
+### Added
+
+- Initial release.
+- Matplotlib theme (`mpl_themes.theme_charite`) with `apply_theme()` and `using()` context manager.
+- Altair/Vega-Lite theme (`altair_themes.theme_charite`) with `register()` and `enable()`.
+- 10 built-in colour palettes: `primary`, `secondary`, `mono`, `light`, `versus`, `nineties`, `brickhouse`, `sunrise`, `berryseason`, `goldelse`.
+- 27 Charité corporate identity colour constants in `colors.py`.
+- `make_palette()` for subsampling and interpolating palettes.
+- Font fallback chain: Charité Text Office → Charit? Text Office → Calibri → DejaVu Sans → sans-serif.
+- MkDocs Material documentation with API reference.
+- MIT License.

charite_plot-0.3.0/CITATION.cff

@@ -0,0 +1,19 @@
+cff-version: 1.2.0
+message: "If you use this software, please cite it as below."
+type: software
+title: "charite-plot: Matplotlib and Altair Themes for Charité – Universitätsmedizin Berlin"
+authors:
+  - family-names: Ramezani
+    given-names: Pedram
+    email: pedram.ramezani@charite.de
+version: 0.3.0
+date-released: 2026-07-01
+license: MIT
+url: "https://github.com/pedramezani/charite-plot"
+repository-code: "https://github.com/pedramezani/charite-plot"
+keywords:
+  - matplotlib
+  - altair
+  - theme
+  - visualization
+  - charite

{charite_plot-0.1.1 → charite_plot-0.3.0}/LICENSE.md

@@ -7,3 +7,7 @@ Permission is hereby granted, free of charge, to any person obtaining a copy of
 The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
 
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+---
+
+This package is based on the original `charite` R package developed by Johannes Julius Mohn (https://github.com/johannesjuliusm/charite), which is also distributed under the MIT License.

{charite_plot-0.1.1 → charite_plot-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: charite-plot
-Version: 0.1.1
+Version: 0.3.0
 Summary: Matplotlib and Altair themes for Charité – Universitätsmedizin Berlin
 Project-URL: Homepage, https://github.com/pedramezani/charite-plot
 Project-URL: Documentation, https://pedramezani.github.io/charite-plot
@@ -17,6 +17,10 @@ License: # MIT License
         The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
         
         THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+        
+        ---
+        
+        This package is based on the original `charite` R package developed by Johannes Julius Mohn (https://github.com/johannesjuliusm/charite), which is also distributed under the MIT License.
 License-File: LICENSE.md
 Keywords: altair,charite,matplotlib,theme,visualization
 Classifier: Development Status :: 3 - Alpha
@@ -49,6 +53,13 @@ Description-Content-Type: text/markdown
 
 # charite-plot
 
+![PyPI Version](https://img.shields.io/pypi/v/charite-plot?link=https%3A%2F%2Fpypi.org%2Fproject%2Fcharite-plot%2F)
+![PyPI License](https://img.shields.io/pypi/l/charite_plot)
+![PyPI Python Version](https://img.shields.io/pypi/pyversions/charite-plot)
+![PyPI Types](https://img.shields.io/pypi/types/charite-plot)
+![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/pedRamezani/charite-plot/ci.yml)
+![Website](https://img.shields.io/website?url=https%3A%2F%2Fpedramezani.github.io%2Fcharite-plot%2F&style=social&logo=materialformkdocs&label=documentation)
+
 A Python package with a Charité-styled Matplotlib theme, [visual identity](https://marke.charite.de/d/Y3FxSwD6Tz3a) colour palettes, and an Altair theme — ported from the [`charite` R package](https://github.com/johannesjuliusm/charite).
 
 ## Installation
@@ -78,9 +89,9 @@ Preview the available colour palettes.
 
 ```python
 import matplotlib.pyplot as plt
-from charite_plot.mpl_themes import theme_charite, apply_theme
+from charite_plot.mpl_themes import enable
 
-apply_theme(theme_charite())
+enable()
 
 fig, ax = plt.subplots()
 ax.plot([1, 2, 3], [4, 7, 3])
@@ -91,9 +102,9 @@ plt.show()
 Use as a context manager to scope the theme to a single figure:
 
 ```python
-from charite_plot.mpl_themes import theme_charite, using
+from charite_plot.mpl_themes import using
 
-with using(theme_charite(palette="goldelse")):
+with using(palette="goldelse"):
     fig, ax = plt.subplots()
     ax.bar(["A", "B", "C"], [3, 7, 5])
 ```
@@ -119,11 +130,13 @@ enable(palette="berryseason", font_size=13)
 
 | Symbol | Description |
 |--------|-------------|
-| `mpl_themes.theme_charite()` | Returns a matplotlib rcParams dict for the Charité theme |
-| `mpl_themes.apply_theme(params)` | Applies a theme dict permanently to `rcParams` |
-| `mpl_themes.using(params)` | Context manager: applies theme temporarily |
-| `altair_themes.theme_charite()` | Returns a Vega-Lite config dict for the Charité theme |
+| `mpl_themes.theme_charite(**kwargs)` | Returns a matplotlib rcParams dict for the Charité theme |
+| `mpl_themes.enable(**kwargs)` | Applies the theme permanently to `rcParams` |
+| `mpl_themes.using(**kwargs)` | Context manager: applies the theme temporarily |
+| `altair_themes.theme_charite(**kwargs)` | Returns a Vega-Lite config dict for the Charité theme |
 | `altair_themes.enable(**kwargs)` | Registers and enables the theme in Altair |
+| `altair_themes.using(**kwargs)` | Context manager: enables the theme temporarily |
+| `altair_themes.register()` | Registers the theme without enabling it (Altair-only) |
 | `PALETTES` | Dict of 10 named colour palettes |
 | `make_palette(name, n, reverse)` | Subsample or interpolate any palette |
 | `CHARITE_COLORS` | Dict of all 27 hex colour constants |
@@ -137,9 +150,30 @@ The fallback chain follows the official Charité brand guidelines:
 `DejaVu Sans` ships with Matplotlib and is always available as the penultimate fallback; `sans-serif` lets the browser or system choose if nothing else matches (important for Altair/Vega-Lite). To override the preferred font:
 
 ```python
-apply_theme(theme_charite(font="Arial"))
+enable(font="Arial")
 ```
 
+## How to cite
+
+If you use charite-plot in your work, please cite it as:
+
+```bibtex
+@software{ramezani2026chariteplot,
+  author    = {Ramezani, Pedram},
+  title     = {charite-plot: Matplotlib and Altair Themes for Charité – Universitätsmedizin Berlin},
+  year      = {2026},
+  version   = {0.3.0},
+  url       = {https://github.com/pedramezani/charite-plot},
+  license   = {MIT},
+}
+```
+
+## Acknowledgements
+
+This package is based on the original [`charite` R package](https://github.com/johannesjuliusm/charite) developed by Johannes Julius Mohn.
+
 ## License
 
 MIT © 2026 Pedram Ramezani
+
+The original `charite` R package by Johannes Julius Mohn is likewise MIT licensed.

{charite_plot-0.1.1 → charite_plot-0.3.0}/README.md

@@ -1,5 +1,12 @@
 # charite-plot
 
+![PyPI Version](https://img.shields.io/pypi/v/charite-plot?link=https%3A%2F%2Fpypi.org%2Fproject%2Fcharite-plot%2F)
+![PyPI License](https://img.shields.io/pypi/l/charite_plot)
+![PyPI Python Version](https://img.shields.io/pypi/pyversions/charite-plot)
+![PyPI Types](https://img.shields.io/pypi/types/charite-plot)
+![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/pedRamezani/charite-plot/ci.yml)
+![Website](https://img.shields.io/website?url=https%3A%2F%2Fpedramezani.github.io%2Fcharite-plot%2F&style=social&logo=materialformkdocs&label=documentation)
+
 A Python package with a Charité-styled Matplotlib theme, [visual identity](https://marke.charite.de/d/Y3FxSwD6Tz3a) colour palettes, and an Altair theme — ported from the [`charite` R package](https://github.com/johannesjuliusm/charite).
 
 ## Installation
@@ -29,9 +36,9 @@ Preview the available colour palettes.
 
 ```python
 import matplotlib.pyplot as plt
-from charite_plot.mpl_themes import theme_charite, apply_theme
+from charite_plot.mpl_themes import enable
 
-apply_theme(theme_charite())
+enable()
 
 fig, ax = plt.subplots()
 ax.plot([1, 2, 3], [4, 7, 3])
@@ -42,9 +49,9 @@ plt.show()
 Use as a context manager to scope the theme to a single figure:
 
 ```python
-from charite_plot.mpl_themes import theme_charite, using
+from charite_plot.mpl_themes import using
 
-with using(theme_charite(palette="goldelse")):
+with using(palette="goldelse"):
     fig, ax = plt.subplots()
     ax.bar(["A", "B", "C"], [3, 7, 5])
 ```
@@ -70,11 +77,13 @@ enable(palette="berryseason", font_size=13)
 
 | Symbol | Description |
 |--------|-------------|
-| `mpl_themes.theme_charite()` | Returns a matplotlib rcParams dict for the Charité theme |
-| `mpl_themes.apply_theme(params)` | Applies a theme dict permanently to `rcParams` |
-| `mpl_themes.using(params)` | Context manager: applies theme temporarily |
-| `altair_themes.theme_charite()` | Returns a Vega-Lite config dict for the Charité theme |
+| `mpl_themes.theme_charite(**kwargs)` | Returns a matplotlib rcParams dict for the Charité theme |
+| `mpl_themes.enable(**kwargs)` | Applies the theme permanently to `rcParams` |
+| `mpl_themes.using(**kwargs)` | Context manager: applies the theme temporarily |
+| `altair_themes.theme_charite(**kwargs)` | Returns a Vega-Lite config dict for the Charité theme |
 | `altair_themes.enable(**kwargs)` | Registers and enables the theme in Altair |
+| `altair_themes.using(**kwargs)` | Context manager: enables the theme temporarily |
+| `altair_themes.register()` | Registers the theme without enabling it (Altair-only) |
 | `PALETTES` | Dict of 10 named colour palettes |
 | `make_palette(name, n, reverse)` | Subsample or interpolate any palette |
 | `CHARITE_COLORS` | Dict of all 27 hex colour constants |
@@ -88,9 +97,30 @@ The fallback chain follows the official Charité brand guidelines:
 `DejaVu Sans` ships with Matplotlib and is always available as the penultimate fallback; `sans-serif` lets the browser or system choose if nothing else matches (important for Altair/Vega-Lite). To override the preferred font:
 
 ```python
-apply_theme(theme_charite(font="Arial"))
+enable(font="Arial")
 ```
 
+## How to cite
+
+If you use charite-plot in your work, please cite it as:
+
+```bibtex
+@software{ramezani2026chariteplot,
+  author    = {Ramezani, Pedram},
+  title     = {charite-plot: Matplotlib and Altair Themes for Charité – Universitätsmedizin Berlin},
+  year      = {2026},
+  version   = {0.3.0},
+  url       = {https://github.com/pedramezani/charite-plot},
+  license   = {MIT},
+}
+```
+
+## Acknowledgements
+
+This package is based on the original [`charite` R package](https://github.com/johannesjuliusm/charite) developed by Johannes Julius Mohn.
+
 ## License
 
 MIT © 2026 Pedram Ramezani
+
+The original `charite` R package by Johannes Julius Mohn is likewise MIT licensed.

{charite_plot-0.1.1 → charite_plot-0.3.0}/charite_plot/__init__.py

@@ -5,12 +5,12 @@ Quick start
 Matplotlib::
 
     import matplotlib.pyplot as plt
-    from charite_plot.mpl_themes import theme_charite, apply_theme
+    from charite_plot.mpl_themes import enable
 
-    apply_theme(theme_charite())            # permanent
+    enable()            # permanent
     # or temporarily:
     from charite_plot.mpl_themes import using
-    with using(theme_charite(palette="goldelse")):
+    with using(palette="goldelse"):
         fig, ax = plt.subplots()
         ax.plot([1, 2, 3])
 
@@ -21,10 +21,19 @@ Altair::
     # charts rendered after this call use the theme automatically
 """
 
-from .colors import *  # noqa: F401, F403  (all color constants + CHARITE_COLORS)
-from .palettes import PALETTES, make_palette  # noqa: F401
-from . import mpl_themes  # noqa: F401
-from . import altair_themes  # noqa: F401
+from .colors import *  # noqa: F403  (all color constants + CHARITE_COLORS)
+from .colors import __all__ as _COLOR_ALL
+from .palettes import PALETTES, make_palette
+from . import mpl_themes
+from . import altair_themes
 
-__version__ = "0.1.1"
+__version__ = "0.3.0"
 __author__ = "Pedram Ramezani"
+
+__all__ = [
+    *_COLOR_ALL,
+    "PALETTES",
+    "make_palette",
+    "mpl_themes",
+    "altair_themes",
+]

charite_plot-0.3.0/charite_plot/_theme_common.py

@@ -0,0 +1,57 @@
+"""Shared theme primitives for the matplotlib and Altair backends.
+
+These small ``NamedTuple`` structures keep the per-backend theme builders
+readable by giving names to the derived size/margin values. The font-size
+ratios are shared so both backends scale identically from their base size
+(matplotlib works in points, Altair in pixels, but the ratios are the same).
+"""
+
+from typing import NamedTuple
+
+__all__ = ["FontSizes", "Margins", "Thickness", "resolve_font_sizes"]
+
+
+class FontSizes(NamedTuple):
+    """Derived font sizes, all scaled from the base ``font_size``."""
+    title: float
+    subtitle: float
+    label: float
+    legend: float
+
+
+class Margins(NamedTuple):
+    """Derived margins/paddings around the plot panel.
+
+    ``wspace`` / ``hspace`` are subplot-spacing fractions used only by the
+    matplotlib backend; they default to ``0`` so the Altair backend can build
+    a ``Margins`` without supplying them.
+    """
+    title: float
+    label: float
+    legend: float
+    wspace: float = 0.0
+    hspace: float = 0.0
+
+
+class Thickness(NamedTuple):
+    """Derived line widths, scaled from the base ``thickness``.
+
+    ``lines`` / ``patches`` are matplotlib-specific defaults; they carry
+    defaults so the Altair backend can build a ``Thickness`` from just the
+    axis-related widths.
+    """
+    axes: float
+    grid: float
+    ticks: float
+    lines: float = 1.5
+    patches: float = 0.0
+
+
+def resolve_font_sizes(font_size: float) -> FontSizes:
+    """Return the standard Charité font-size ramp derived from *font_size*."""
+    return FontSizes(
+        title=round(font_size * 1.2),
+        subtitle=font_size,
+        label=font_size,
+        legend=round(font_size * 0.8),
+    )

charite_plot-0.3.0/charite_plot/altair_themes.py

@@ -0,0 +1,227 @@
+"""Altair / Vega-Lite theme for Charité – Universitätsmedizin Berlin.
+
+Register and enable with::
+
+    from charite_plot.altair_themes import enable
+    enable()                              # default params
+    enable(palette="goldelse")            # custom palette
+    enable(font="Arial", font_size=13)    # font override
+"""
+
+from __future__ import annotations
+
+from contextlib import contextmanager
+from uuid import uuid4
+
+from .colors import (
+    BLACK, WHITE, TEXT_GREY, PRIME_BLUE, PRIME_LGREY,
+    SECOND_DBLUE, KORALL,
+)
+from .palettes import PALETTES
+from .fonts import build_font_stack
+from ._theme_common import Margins, Thickness, resolve_font_sizes
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from altair.theme import AxisConfigKwds, ThemeConfig
+
+__all__ = ["theme_charite", "enable", "using", "register"]
+
+
+def _css_font_stack(preferred: str | None) -> str:
+    """Return a CSS font-family string (comma-separated, quoted if needed)."""
+    def _quote(name: str) -> str:
+        return f'"{name}"' if " " in name else name
+
+    return ", ".join(_quote(f) for f in build_font_stack(preferred=preferred))
+
+
+def theme_charite(
+    font: str | None = None,
+    font_size: int = 12,
+    thickness: float = 0.5,
+    grid: bool = False,
+    palette: str | list[str] = "primary",
+    background: str = "white",
+    tiny_margins: bool = False,
+) -> ThemeConfig:
+    """Return an Altair theme config dict for the Charité corporate theme.
+
+    Parameters
+    ----------
+    font:
+        Preferred font. Falls back through Charité Text Office → Charit? Text Office → Calibri → DejaVu Sans → sans-serif.
+    font_size:
+        Base font size in pixels.
+    thickness:
+        Axis line and tick width.
+    grid:
+        Show axis grid lines.
+    palette:
+        Built-in palette name or list of hex colors for the categorical range.
+    background:
+        Chart background color.
+    tiny_margins:
+        Minimise all paddings around the chart.
+    """
+    colors = PALETTES[palette] if isinstance(palette, str) else list(palette)
+    font_stack = _css_font_stack(preferred=font)
+
+    FONT_SIZES = resolve_font_sizes(font_size)
+    MARGINS = Margins(
+        title=8 if tiny_margins else 12,   # chart title offset
+        label=3 if tiny_margins else 6,    # axis / legend title padding
+        legend=2 if tiny_margins else 4,   # legend inner padding
+    )
+    THICKNESS = Thickness(
+        axes=thickness,          # domain line width
+        grid=thickness * 0.8,    # grid line width
+        ticks=thickness,         # tick mark width
+        lines=2,                 # line-mark stroke width (independent of thickness)
+        patches=0.4,             # geoshape stroke width
+    )
+    CHART_PAD = 6 if tiny_margins else 10
+
+    axis: AxisConfigKwds = {
+        "labelFont":     font_stack,
+        "titleFont":     font_stack,
+        "labelFontSize": FONT_SIZES.label,
+        "titleFontSize": FONT_SIZES.subtitle,
+        "labelColor":    TEXT_GREY,
+        "titleColor":    TEXT_GREY,
+        "titlePadding":  MARGINS.label,
+        "domain":        True,
+        "domainColor":   BLACK,
+        "domainWidth":   THICKNESS.axes,
+        "ticks":         True,
+        "tickColor":     BLACK,
+        "tickWidth":     THICKNESS.ticks,
+        "tickSize":      4,
+        "grid":          grid,
+        "gridColor":     PRIME_LGREY,
+        "gridWidth":     THICKNESS.grid,
+        "gridOpacity":   0.85,
+    }
+
+    return {
+        "config": {
+            "background": background,
+            "font":       font_stack,
+            "padding":    {"top": CHART_PAD, "bottom": CHART_PAD, "left": CHART_PAD, "right": CHART_PAD},
+            "view":  {"stroke": None},
+            "axis":  axis,
+            "axisX": axis,
+            "axisY": axis,
+            "legend": {
+                "labelFont":     font_stack,
+                "titleFont":     font_stack,
+                "labelFontSize": FONT_SIZES.legend,
+                "titleFontSize": FONT_SIZES.subtitle,
+                "labelColor":    TEXT_GREY,
+                "titleColor":    TEXT_GREY,
+                "titlePadding":  MARGINS.label,
+                "padding":       MARGINS.legend,
+                "rowPadding":    FONT_SIZES.legend / 4,
+                "symbolSize":    100,
+            },
+            "header": {
+                "labelFont":       font_stack,
+                "titleFont":       font_stack,
+                "labelFontSize":   FONT_SIZES.label,
+                "titleFontSize":   FONT_SIZES.subtitle,
+                "labelColor":      WHITE,
+                "titleColor":      PRIME_BLUE,
+                "labelBackground": PRIME_BLUE,
+            },
+            "title": {
+                "font":             font_stack,
+                "subtitleFont":     font_stack,
+                "fontSize":         FONT_SIZES.title,
+                "subtitleFontSize": FONT_SIZES.subtitle,
+                "color":            PRIME_BLUE,
+                "subtitleColor":    TEXT_GREY,
+                "anchor":           "middle",
+                "offset":           MARGINS.title,
+            },
+            "range": {
+                "category":  colors,
+                "ordinal":   colors,
+                "diverging": [SECOND_DBLUE, "#ffffff", KORALL],
+                "heatmap":   ["#ffffff", PRIME_BLUE],
+                "ramp":      ["#ffffff", PRIME_BLUE],
+            },
+            "bar":      {"color": colors[0], "binSpacing": 1},
+            "line":     {"color": colors[0], "strokeWidth": THICKNESS.lines},
+            "point":    {"color": colors[0], "size": 60, "opacity": 0.85, "filled": True},
+            "area":     {"color": colors[0], "opacity": 0.8},
+            "arc":      {"color": colors[0]},
+            "rect":     {"color": colors[0]},
+            "geoshape": {"stroke": WHITE, "strokeWidth": THICKNESS.patches},
+            "text":     {"font": font_stack, "fontSize": FONT_SIZES.label, "color": TEXT_GREY},
+        }
+    }
+
+
+def register() -> None:
+    """Register the Charité theme with Altair's theme registry (default params)."""
+    import altair as alt
+    alt.theme.register("charite", enable=False)(theme_charite)
+
+
+def enable(**kwargs) -> None:
+    """Register and enable the Charité theme in Altair.
+
+    Parameters
+    ----------
+    **kwargs:
+        Any parameter accepted by ``theme_charite``
+        (``font``, ``font_size``, ``thickness``, ``grid``, ``palette``,
+        ``background``, ``tiny_margins``).
+
+    Examples
+    --------
+    ```python
+    from charite_plot.altair_themes import enable
+    enable(palette="goldelse", font_size=13)
+    ```
+    """
+    import altair as alt
+    func = (lambda: theme_charite(**kwargs)) if kwargs else theme_charite
+    alt.theme.register("charite", enable=True)(func)
+
+
+@contextmanager
+def using(**kwargs):
+    """Temporarily enable the Charité theme, restoring the previous theme on exit.
+
+    Mirrors :func:`charite_plot.mpl_themes.using`. Charts created (or serialised
+    with ``chart.to_json()`` / ``chart.to_dict()``) inside the ``with`` block use
+    the Charité theme; the previously active theme is restored afterwards.
+
+    Parameters
+    ----------
+    **kwargs:
+        Any parameter accepted by ``theme_charite``.
+
+    Examples
+    --------
+    ```python
+    from charite_plot.altair_themes import using
+    with using(palette="goldelse"):
+        spec = chart.to_json()
+    ```
+    """
+    import altair as alt
+    func = (lambda: theme_charite(**kwargs)) if kwargs else theme_charite
+    # Register under a unique throwaway name so we don't clobber the primary
+    # "charite" registration and so nested ``using`` blocks don't collide.
+    # ``alt.theme.enable`` restores the previous theme on exit; the temporary
+    # registration is removed afterwards to keep the registry clean.
+    name = f"_charite_{uuid4().hex}"
+    alt.theme.register(name, enable=False)(func)
+    try:
+        with alt.theme.enable(name):
+            yield
+    finally:
+        alt.theme.unregister(name)

{charite_plot-0.1.1 → charite_plot-0.3.0}/charite_plot/fonts.py

@@ -2,6 +2,8 @@
 
 import warnings
 
+__all__ = ["FONT_STACK", "check_font", "build_font_stack"]
+
 FONT_STACK = ["Charité Text Office", "Charit? Text Office", "Calibri", "DejaVu Sans", "sans-serif"]