config_context¶

@contextmanager
def config_context(
    *,
    resampler: bool | Literal["widget"] | None = None,
    resampler_n_shown_samples: int | None = None,
    resampler_downsampler: AbstractAggregator | None = None,
    resampler_gap_handler: AbstractGapHandler | None = None,
    resampler_trace_prefix_suffix: tuple[str, str] | None = None,
    resampler_show_mean_aggregation_size: bool | None = None,
    line_shape: str | None = None,
) -> Generator[None, None, None]:
    """Context manager to temporarily override plotting configuration.

    Parameters
    ----------
    resampler : bool | Literal["widget"] | None, default=None
        Temporary resampler mode.  ``None`` leaves the current value
        unchanged.
    resampler_n_shown_samples : int | None, default=None
        Temporary number of shown samples.  ``None`` leaves unchanged.
    resampler_downsampler : AbstractAggregator | None, default=None
        Temporary downsampling algorithm.  ``None`` leaves unchanged.
    resampler_gap_handler : AbstractGapHandler | None, default=None
        Temporary gap handler.  ``None`` leaves unchanged.
    resampler_trace_prefix_suffix : tuple[str, str] | None, default=None
        Temporary legend prefix/suffix.  ``None`` leaves unchanged.
    resampler_show_mean_aggregation_size : bool | None, default=None
        Temporary aggregation size display.  ``None`` leaves unchanged.
    line_shape : str | None, default=None
        Temporary line interpolation for every scatter line trace (one of
        `VALID_LINE_SHAPES`).  ``None`` leaves unchanged.

    Examples
    --------
    >>> from yohou.plotting import config_context, get_config, set_config
    >>> set_config(resampler=False)
    >>> with config_context(resampler="widget"):
    ...     assert get_config()["resampler"] == "widget"
    >>> assert get_config()["resampler"] is False
    >>> with config_context(line_shape="hv"):
    ...     assert get_config()["line_shape"] == "hv"
    >>> assert get_config()["line_shape"] is None

    See Also
    --------
    [`set_config`][yohou.plotting.set_config] : Set global configuration values.
    [`get_config`][yohou.plotting.get_config] : Read the current configuration.
    """
    old = _global_config.copy()
    try:
        set_config(
            resampler=resampler,
            resampler_n_shown_samples=resampler_n_shown_samples,
            resampler_downsampler=resampler_downsampler,
            resampler_gap_handler=resampler_gap_handler,
            resampler_trace_prefix_suffix=resampler_trace_prefix_suffix,
            resampler_show_mean_aggregation_size=resampler_show_mean_aggregation_size,
            line_shape=line_shape,
        )
        yield
    finally:
        _global_config.clear()
        _global_config.update(old)