Source code for python_utils.exceptions

"""
This module provides utility functions for raising and reraising exceptions.

Functions::

    raise_exception(exception_class, *args, **kwargs):
        Returns a function that raises an exception of the given type with
        the given arguments.

    reraise(*args, **kwargs):
        Reraises the current exception.
"""

import collections.abc
import typing




def raise_exception(
    exception_class: type[Exception],
    *args: typing.Any,
    **kwargs: typing.Any,
) -> collections.abc.Callable[..., None]:
    """
    Returns a function that raises an exception of the given type with the
    given arguments.

    >>> raise_exception(ValueError, 'spam')('eggs')
    Traceback (most recent call last):
        ...
    ValueError: spam
    """

    def raise_(*args_: typing.Any, **kwargs_: typing.Any) -> typing.Any:
        """Raise ``exception_class`` with the captured args."""
        raise exception_class(*args, **kwargs)

    return raise_





def reraise(*args: typing.Any, **kwargs: typing.Any) -> typing.Any:
    """
    Reraises the current exception.

    This function seems useless, but it can be useful when you need to pass
    a callable to another function that raises an exception.
    """
    raise