Exceptions

sereto.exceptions

SeretoException

Bases: Exception

There was an ambiguous exception.

Source code in sereto/exceptions.py

class SeretoException(Exception):
    """There was an ambiguous exception."""

SeretoPathError

Bases: SeretoException

Path error.

Source code in sereto/exceptions.py

class SeretoPathError(SeretoException):
    """Path error."""

SeretoRuntimeError

Bases: SeretoException

Runtime error.

Source code in sereto/exceptions.py

class SeretoRuntimeError(SeretoException):
    """Runtime error."""

SeretoTypeError

Bases: SeretoException

Type error.

Source code in sereto/exceptions.py

class SeretoTypeError(SeretoException):
    """Type error."""

SeretoValueError

Bases: SeretoException, ValueError

Value error.

Source code in sereto/exceptions.py

class SeretoValueError(SeretoException, ValueError):
    """Value error."""

handle_exceptions(func)

Decorator for pretty printing SeReTo exceptions in debug mode.

If the exception is a subclass of SeretoException and DEBUG environment variable is set to '1', the full exception traceback will be printed with local variables shown.

Source code in sereto/exceptions.py

def handle_exceptions(func: Callable[P, R]) -> Callable[P, R]:
    """Decorator for pretty printing SeReTo exceptions in debug mode.

    If the exception is a subclass of SeretoException and DEBUG environment variable is set to '1', the full exception
    traceback will be printed with local variables shown.
    """

    @functools.wraps(func)
    def outer_function(*args: P.args, **kwargs: P.kwargs) -> R:
        try:
            return func(*args, **kwargs)
        except Exception as e:
            if isinstance(e, SeretoException):
                Console().print(f"[red]Error:[/red] {escape(str(e))}")
            if os.environ.get("DEBUG", False):
                Console().print_exception(show_locals=True, suppress=[click, jinja2, pydantic, pathlib])
            else:
                Console().print("\n[yellow]Set environment variable [blue]DEBUG=1[/blue] for more details.")
            sys.exit(1)

    return outer_function