Skip to content

Exceptions

Defines the exceptions shared across gllm-pipeline.

BasePipelineError(message=None, *, debug_info=None, recovery=None, original_error=None)

Bases: BaseError

Root of the normalized errors raised by gllm-pipeline.

This class is abstract and is never raised directly. Every concrete subclass defines its own code (GLLM-PIPE-<NAME>) and default_message.

Attributes:

Name Type Description
code str | None

Stable error code. Defined by each concrete subclass.

default_message str | None

Message used when no message is given. Defined by each concrete subclass.

message str

The message of this error.

debug_info DebugInfo

Structured internal detail about this error.

PipelineKeyError(message=None, *, debug_info=None, recovery=None, original_error=None)

Bases: BasePipelineError, KeyError

Raised when a required key is missing from the state, config or input map, or an unknown key is requested.

Attributes:

Name Type Description
code str

Stable error code, GLLM-PIPE-KEY.

default_message str

Message used when no message is given.

message str

The message of this error.

debug_info DebugInfo

Structured internal detail about this error.

PipelineNotImplementedError(message=None, *, debug_info=None, recovery=None, original_error=None)

Bases: BasePipelineError, NotImplementedError

Raised when a pipeline or step method that must be overridden is not implemented.

Attributes:

Name Type Description
code str

Stable error code, GLLM-PIPE-NOT-IMPLEMENTED.

default_message str

Message used when no message is given.

message str

The message of this error.

debug_info DebugInfo

Structured internal detail about this error.

PipelineRuntimeError(message=None, *, debug_info=None, recovery=None, original_error=None)

Bases: BasePipelineError, RuntimeError

Raised when a pipeline or step fails while building or executing.

Attributes:

Name Type Description
code str

Stable error code, GLLM-PIPE-RUNTIME.

default_message str

Message used when no message is given.

message str

The message of this error.

debug_info DebugInfo

Structured internal detail about this error.

PipelineTypeError(message=None, *, debug_info=None, recovery=None, original_error=None)

Bases: BasePipelineError, TypeError

Raised when a pipeline, step or component receives a value of an unexpected type.

Attributes:

Name Type Description
code str

Stable error code, GLLM-PIPE-TYPE.

default_message str

Message used when no message is given.

message str

The message of this error.

debug_info DebugInfo

Structured internal detail about this error.

PipelineValueError(message=None, *, debug_info=None, recovery=None, original_error=None)

Bases: BasePipelineError, ValueError

Raised when a pipeline, step, component or its state has an invalid value.

Attributes:

Name Type Description
code str

Stable error code, GLLM-PIPE-VALIDATION.

default_message str

Message used when no message is given.

message str

The message of this error.

debug_info DebugInfo

Structured internal detail about this error.

RouterProviderError(message=None, *, debug_info=None, recovery=None, original_error=None)

Bases: BasePipelineError, RuntimeError

Raised when a router provider fails while routing.

Attributes:

Name Type Description
code str

Stable error code, GLLM-PIPE-ROUTER-PROVIDER.

default_message str

Message used when no message is given.

message str

The message of this error.

debug_info DebugInfo

Structured internal detail, including error_type, original_message and traceback of the provider error.