betty.error module

Provide error handling utilities.

exception betty.error.UserFacingError[source]

Bases: Exception, Localizable

A localizable, user-facing error.

This type of error is fatal, but fixing it does not require knowledge of Betty’s internals or the stack trace leading to the error. It must therefore have an end-user-friendly message, and its stack trace must not be shown.

Parameters:

message (betty.locale.localizable.Localizable)

__init__(message: betty.locale.localizable.Localizable)[source]
Parameters:

message (betty.locale.localizable.Localizable)

localize(localizer: betty.locale.Localizer) str[source]

Localize self to a human-readable string.

Parameters:

localizer (betty.locale.Localizer)

Return type:

str

betty.error.serialize(error: betty.error._BaseExceptionT) betty.error._BaseExceptionT[source]

Serialize an exception.

This replaces the exception’s traceback object with the traceback formatted as a string.

Parameters:

error (typing.TypeVar(_BaseExceptionT, bound= BaseException))

Return type:

typing.TypeVar(_BaseExceptionT, bound= BaseException)