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

{charite_plot-0.2.0 → charite_plot-0.3.0}/CHANGELOG.md

@@ -5,6 +5,22 @@ 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

{charite_plot-0.2.0 → charite_plot-0.3.0}/CITATION.cff

@@ -6,7 +6,7 @@ authors:
   - family-names: Ramezani
     given-names: Pedram
     email: pedram.ramezani@charite.de
-version: 0.2.0
+version: 0.3.0
 date-released: 2026-07-01
 license: MIT
 url: "https://github.com/pedramezani/charite-plot"

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: charite-plot
-Version: 0.2.0
+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
@@ -53,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
@@ -82,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])
@@ -95,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])
 ```
@@ -123,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 |
@@ -141,7 +150,7 @@ 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
@@ -153,7 +162,7 @@ If you use charite-plot in your work, please cite it as:
   author    = {Ramezani, Pedram},
   title     = {charite-plot: Matplotlib and Altair Themes for Charité – Universitätsmedizin Berlin},
   year      = {2026},
-  version   = {0.2.0},
+  version   = {0.3.0},
   url       = {https://github.com/pedramezani/charite-plot},
   license   = {MIT},
 }

{charite_plot-0.2.0 → 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,7 +97,7 @@ 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
@@ -100,7 +109,7 @@ If you use charite-plot in your work, please cite it as:
   author    = {Ramezani, Pedram},
   title     = {charite-plot: Matplotlib and Altair Themes for Charité – Universitätsmedizin Berlin},
   year      = {2026},
-  version   = {0.2.0},
+  version   = {0.3.0},
   url       = {https://github.com/pedramezani/charite-plot},
   license   = {MIT},
 }

{charite_plot-0.2.0 → 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.2.0"
+__version__ = "0.3.0"
 __author__ = "Pedram Ramezani"
+
+__all__ = [
+    *_COLOR_ALL,
+    "PALETTES",
+    "make_palette",
+    "mpl_themes",
+    "altair_themes",
+]

{charite_plot-0.2.0 → charite_plot-0.3.0}/charite_plot/_theme_common.py

@@ -8,6 +8,8 @@ ratios are shared so both backends scale identically from their base size
 
 from typing import NamedTuple
 
+__all__ = ["FontSizes", "Margins", "Thickness", "resolve_font_sizes"]
+
 
 class FontSizes(NamedTuple):
     """Derived font sizes, all scaled from the base ``font_size``."""

{charite_plot-0.2.0 → charite_plot-0.3.0}/charite_plot/altair_themes.py

@@ -10,6 +10,9 @@ Register and enable with::
 
 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,
@@ -23,6 +26,8 @@ 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)."""
@@ -184,3 +189,39 @@ def enable(**kwargs) -> None:
     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.2.0 → 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"]
 
 

{charite_plot-0.2.0 → charite_plot-0.3.0}/charite_plot/mpl_themes.py

@@ -9,6 +9,8 @@ from .palettes import PALETTES
 from .fonts import build_font_stack
 from ._theme_common import Margins, Thickness, resolve_font_sizes
 
+__all__ = ["theme_charite", "enable", "using"]
+
 
 def theme_charite(
     font: str | None = None,
@@ -16,8 +18,9 @@ def theme_charite(
     thickness: float = 0.5,
     grid: bool = False,
     palette: str | list[str] = "primary",
-    interactive: bool = False,
+    background: str = "white",
     tiny_margins: bool = False,
+    interactive: bool = False,
 ) -> dict:
     """Return matplotlib rcParams dict for the Charité corporate identity theme.
 
@@ -35,13 +38,16 @@ def theme_charite(
     palette:
         Name of a built-in palette or a list of hex color strings used for the
         ``axes.prop_cycle``.
+    background:
+        Figure and axes background color.
+    tiny_margins:
+        Minimise all margins around the plot panel. Useful for dense layouts or
+        when saving figures with little surrounding whitespace.
     interactive:
         Enable matplotlib interactive mode (equivalent to ``plt.ion()``).
         Useful in notebooks or scripts where you want plots to display
-        without blocking.
-    tiny_margins:
-        Minimise all margins around the plot panel. Useful for dense layouts or 
-        when saving figures with little surrounding whitespace.
+        without blocking. Matplotlib-specific (Altair charts use
+        ``.interactive()``).
     """
     sans_font_stack = build_font_stack(preferred=font)
     monospace_font_stack = ["Andale Mono", "Nimbus Mono L", "Courier New", "Courier", "Fixed", "Terminal", "monospace"]
@@ -82,7 +88,7 @@ def theme_charite(
         "axes.labelcolor": TEXT_GREY,
         "axes.labelpad":   MARGINS.label,
         "axes.edgecolor":  BLACK,
-        "axes.facecolor":  WHITE,
+        "axes.facecolor":  background,
         "axes.grid":       grid,
         "axes.axisbelow":  True,
         "axes.spines.top":   False,
@@ -123,8 +129,8 @@ def theme_charite(
         "text.antialiased": True,
 
         # Figure
-        "figure.facecolor":      WHITE,
-        "figure.edgecolor":      WHITE,
+        "figure.facecolor":      background,
+        "figure.edgecolor":      background,
         "figure.dpi":            100,
         "figure.figsize":        (11, 8),
         "figure.subplot.hspace": MARGINS.hspace,
@@ -165,24 +171,45 @@ def theme_charite(
     }
 
 
-def apply_theme(params: dict) -> None:
-    """Apply a theme dict as the active matplotlib rcParams (permanent until reset)."""
+def enable(**kwargs) -> None:
+    """Apply the Charité theme to matplotlib's global rcParams (permanent until reset).
+
+    Parameters
+    ----------
+    **kwargs:
+        Any parameter accepted by :func:`theme_charite` (``font``,
+        ``font_size``, ``thickness``, ``grid``, ``palette``, ``background``,
+        ``tiny_margins``, ``interactive``).
+
+    Examples
+    --------
+    ```python
+    from charite_plot.mpl_themes import enable
+    enable(palette="goldelse", font_size=8)
+    ```
+    """
     import matplotlib as mpl
-    mpl.rcParams.update(params)
+    mpl.rcParams.update(theme_charite(**kwargs))
 
 
 @contextmanager
-def using(params: dict):
-    """Context manager: temporarily apply *params* then restore previous rcParams.
+def using(**kwargs):
+    """Temporarily apply the Charité theme, restoring the previous rcParams on exit.
+
+    Parameters
+    ----------
+    **kwargs:
+        Any parameter accepted by :func:`theme_charite`.
 
     Examples
     --------
     ```python
-    with using(theme_charite(palette="goldelse")):
+    from charite_plot.mpl_themes import using
+    with using(palette="goldelse"):
         fig, ax = plt.subplots()
         ax.plot([1, 2, 3])
     ```
     """
     import matplotlib as mpl
-    with mpl.rc_context(params):
+    with mpl.rc_context(theme_charite(**kwargs)):
         yield

{charite_plot-0.2.0 → charite_plot-0.3.0}/charite_plot/palettes.py

@@ -9,6 +9,8 @@ from .colors import (
     WEINROT, HIMBEER, ROT, MANGO, RAPSGELB,
 )
 
+__all__ = ["PALETTES", "make_palette"]
+
 PALETTES: dict[str, list[str]] = {
     "primary":     [PRIME_BLUE, PRIME_DGREY, PRIME_LGREY],
     "secondary":   [SECOND_DBLUE, SECOND_LBLUE, KORALL],

{charite_plot-0.2.0 → charite_plot-0.3.0}/docs/api/altair_themes.md

@@ -5,4 +5,5 @@
       members:
         - theme_charite
         - enable
+        - using
         - register

{charite_plot-0.2.0 → charite_plot-0.3.0}/docs/api/mpl_themes.md

@@ -4,5 +4,5 @@
     options:
       members:
         - theme_charite
-        - apply_theme
+        - enable
         - using

{charite_plot-0.2.0 → charite_plot-0.3.0}/docs/citing.md

@@ -9,7 +9,7 @@ If you use charite-plot in your research or work, please cite it. A `CITATION.cf
   author    = {Ramezani, Pedram},
   title     = {charite-plot: Matplotlib and Altair Themes for Charité – Universitätsmedizin Berlin},
   year      = {2026},
-  version   = {0.2.0},
+  version   = {0.3.0},
   url       = {https://github.com/pedramezani/charite-plot},
   license   = {MIT},
 }

{charite_plot-0.2.0 → charite_plot-0.3.0}/docs/index.md

@@ -22,9 +22,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])
@@ -35,9 +35,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])
 ```
@@ -58,5 +58,5 @@ chart = alt.Chart(df).mark_bar().encode(...)
 ## Design principles
 
 - **Single source of truth** — colors are defined once in `colors.py` and imported by every other module.
-- **No side effects on import** — theme functions return plain dicts; you opt in with `apply_theme()`, `using()`, or `enable()`.
+- **No side effects on import** — theme functions return plain dicts; you opt in with `enable()` or `using()`.
 - **Font fallback** — if Charité Text Office is not installed, the theme cascades to Charit? Text Office, then Calibri, DejaVu Sans, and finally sans-serif automatically, following the official brand guidelines.

{charite_plot-0.2.0 → charite_plot-0.3.0}/docs/installation.md

@@ -37,9 +37,9 @@ charite-plot works out of the box with any system. The font fallback chain is:
 To use a different preferred font, pass it explicitly:
 
 ```python
-from charite_plot.mpl_themes import theme_charite, apply_theme
+from charite_plot.mpl_themes import enable
 
-apply_theme(theme_charite(font="Arial"))
+enable(font="Arial")
 ```
 
 A warning is shown if the requested font cannot be found on the system.

{charite_plot-0.2.0 → charite_plot-0.3.0}/docs/matplotlib.md

@@ -2,15 +2,15 @@
 
 ## Applying the theme
 
-### Permanently — `apply_theme`
+### Permanently — `enable`
 
 Sets rcParams globally for the rest of the session:
 
 ```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])
@@ -25,9 +25,9 @@ plt.show()
 Applies the theme only inside the `with` block, then restores the previous rcParams:
 
 ```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", "D"], [3, 7, 5, 9])
 ```
@@ -57,8 +57,9 @@ mpl.rcParams.update(params)
 | `thickness` | `float` | `0.5` | Axis line and tick width. |
 | `grid` | `bool` | `False` | Show major grid lines. |
 | `palette` | `str | list[str]` | `"primary"` | Named palette or list of hex strings for `axes.prop_cycle`. |
-| `interactive` | `bool` | `False` | Enable interactive mode (equivalent to `plt.ion()`). Useful in notebooks or scripts where plots should display without blocking. |
+| `background` | `str` | `"white"` | Figure and axes background color. |
 | `tiny_margins` | `bool` | `False` | Minimise all margins and paddings around the plot panel. Useful for dense layouts. |
+| `interactive` | `bool` | `False` | Enable interactive mode (equivalent to `plt.ion()`). Matplotlib-specific. |
 
 ---
 
@@ -67,37 +68,37 @@ mpl.rcParams.update(params)
 ### Palette switcher
 
 ```python
-from charite_plot.mpl_themes import theme_charite, apply_theme
+from charite_plot.mpl_themes import enable
 
-apply_theme(theme_charite(palette="berryseason"))
+enable(palette="berryseason")
 ```
 
 ### Custom font size for a journal figure
 
 ```python
-apply_theme(theme_charite(font_size=8, thickness=0.4))
+enable(font_size=8, thickness=0.4)
 ```
 
 ### Custom color list
 
 ```python
-apply_theme(theme_charite(palette=["#004d9b", "#ea5451", "#fab600"]))
+enable(palette=["#004d9b", "#ea5451", "#fab600"])
 ```
 
 ### Grid on
 
 ```python
-apply_theme(theme_charite(grid=True))
+enable(grid=True)
 ```
 
 ### Dense layout with minimal margins
 
 ```python
-apply_theme(theme_charite(tiny_margins=True))
+enable(tiny_margins=True)
 ```
 
 ### Interactive mode (notebooks / REPL)
 
 ```python
-apply_theme(theme_charite(interactive=True))   # equivalent to plt.ion()
+enable(interactive=True)   # equivalent to plt.ion()
 ```

{charite_plot-0.2.0 → charite_plot-0.3.0}/examples/mpl_showcase.py

@@ -13,7 +13,7 @@ import matplotlib.pyplot as plt
 import matplotlib.patches as mpatches
 import matplotlib.ticker as mticker
 
-from charite_plot.mpl_themes import theme_charite, apply_theme
+from charite_plot.mpl_themes import enable
 from charite_plot.palettes import PALETTES
 
 rng = np.random.default_rng(42)
@@ -28,7 +28,7 @@ COMMON = {
 MARKERS = {"A": "o", "B": "s", "C": "^"}
 
 # ── apply theme globally ───────────────────────────────────────────────────
-apply_theme(theme_charite(palette="primary"))
+enable(palette="primary")
 COLORS = PALETTES["primary"]
 
 # ── figure layout ──────────────────────────────────────────────────────────

{charite_plot-0.2.0 → charite_plot-0.3.0}/examples/palette_preview.py

@@ -14,10 +14,10 @@ sys.path.insert(0, str(pathlib.Path(__file__).parent.parent))
 import matplotlib.pyplot as plt
 import matplotlib.patches as mpatches
 
-from charite_plot.mpl_themes import theme_charite, apply_theme
+from charite_plot.mpl_themes import enable
 from charite_plot.palettes import PALETTES
 
-apply_theme(theme_charite())
+enable()
 
 MAX_COLS = max(len(p) for p in PALETTES.values())
 names = list(PALETTES.keys())

{charite_plot-0.2.0 → charite_plot-0.3.0}/examples/poly_showcase.py

@@ -18,7 +18,7 @@ sys.path.insert(0, str(pathlib.Path(__file__).parent.parent))
 import numpy as np
 import matplotlib.pyplot as plt
 
-from charite_plot.mpl_themes import theme_charite, apply_theme
+from charite_plot.mpl_themes import enable
 from charite_plot.colors import PRIME_BLUE, PRIME_DGREY, KORALL, TEXT_GREY
 
 COLORS = [KORALL, PRIME_BLUE, PRIME_DGREY]   # C1, C2, C3
@@ -94,7 +94,7 @@ t_axis, means, ses = _generate_data()
 
 
 # ── single: Charité theme ───────────────────────────────────────────────────
-apply_theme(theme_charite(font_size=14, thickness=1))
+enable(font_size=14, thickness=1)
 
 fig, ax = plt.subplots(figsize=(6, 4.5))
 fig.subplots_adjust(top=0.88)