Errors Module

Custom exception classes for drivers and toolchains.

This module defines all error types raised during parsing, execution, and toolchain operations. Errors are grouped by their purpose, including internal language (IL) parsing, SQL dialect translation, execution failures, and result simplification issues. It also includes validation and synchronous/asynchronous capability errors.

LinkValidationError:

Raised when step input/output sets are incompatible.

ILParsingError:

Raised when parsing the internal language fails.

DialectParsingError:

Raised when converting IL to a SQL dialect fails.

ExecutionError:

Raised when executing a SQL statement fails.

SimplifyingError:

Raised when simplifying low-level results fails.

NotAsyncError:

Raised when async execution is attempted but not supported.

NotSyncError:

Raised when sync execution is attempted but not supported.

exception plugorm.errors.DialectParsingError[source]

Raised when translating dialect into an internal language (IL) dialect fails.

exception plugorm.errors.ExecutionError[source]

Raised when execution of a SQL statement fails.

exception plugorm.errors.ILParsingError[source]

Raised when parsing the internal language (IL) fails.

exception plugorm.errors.LinkValidationError(source: str, target: str, input_: set[str], output: set[str])[source]

Exception raised when toolchain step linkage is invalid.

This error occurs when the output types of one step are not compatible with the expected input types of the subsequent step.

source

The name of the step producing the output.

Type:

str

target

The name of the step expecting compatible input.

Type:

str

input_

The set of required input types for the target step.

Type:

set[str]

output

The set of output types produced by the source step.

Type:

set[str]

exception plugorm.errors.NotAsyncError[source]

Raised when an asynchronous operation is attempted but the driver does not support async execution.

exception plugorm.errors.NotSyncError[source]

Raised when a synchronous operation is attempted but the driver does not support sync execution.

exception plugorm.errors.SimplifyingError[source]

Raised when simplification of a low-level result into a higher-level form fails.