Skip to content

BackendExecutionError

from cascaqit import BackendExecutionError

BackendExecutionError

BackendExecutionError()

A structured exception for backend execution or adapter failures. It is catchable as both RuntimeError and CASCAQitError. In the current local learning workflows, this error does not imply a hardware or cloud call.

Defaults are category=backend, code=BACKEND_EXECUTION_ERROR, stage=backend, severity=error and retryable=False. Callers can override code, stage, object_path, suggestion and other fields. See CASCAQitError for the full constructor contract.

The default is retryable=False. Retry only when the specific failure is marked retryable and satisfies RetryPolicy; the exception class name alone is not a retry decision.

from cascaqit import BackendExecutionError

error = BackendExecutionError("Example failure", object_path="program")
assert error.to_error_ir().category == "backend"
assert error.to_diagnostic().code == "BACKEND_EXECUTION_ERROR"

See Results and diagnostics for troubleshooting.

to_error_ir

to_error_ir() -> ErrorIR

Return ErrorIR containing this exception’s category, code and context. Preserve the configured retryable value without initiating a retry.

to_diagnostic

to_diagnostic() -> DiagnosticsIR

Return DiagnosticsIR for display in a diagnostic list. Full provenance, cause and attached diagnostics remain in the exception and its ErrorIR.