errors

heliaAOT Errors API

Typed error hierarchy for user-facing failures. A HeliaAotError carries an optional hint (one actionable next step) and optional details (e.g. subprocess output); the CLI renders these as a clean Error: line with a dim hint instead of a traceback, and exits 1.

Machine-readable model

HeliaAotErrorclassBase class for user-facing heliaAOT failures.
ModelLoadErrorclassThe input model could not be found or parsed.
OutputExistsErrorclassAn output path already exists and --force was not given.
ConfigValueErrorclassA configuration value is invalid for the requested conversion.
UnsupportedModelErrorclassThe input model uses a structure or dtype heliaAOT cannot lower.
TemplateRenderErrorclassA codegen template referenced context its handler did not supply.
GoldenDataKeyErrorclassA supplied golden-data archive is missing a required tensor key.

HeliaAotError(message: str, *, hint: str | None = None, details: str | None = None)

Base class for user-facing heliaAOT failures.

Parameters

Parameters of HeliaAotError
Name	Type	Default	Description
`message`	`str`	Required	What went wrong, phrased for the user.
`hint`	`str \| None`	None	One actionable next step (rendered dim below the error).
`details`	`str \| None`	None	Supporting output (e.g. tool stderr), rendered dim.

hint = hint

details = details

ModelLoadError()

The input model could not be found or parsed.

Also a FileNotFoundError so callers catching the stdlib type keep working.

OutputExistsError()

An output path already exists and --force was not given.

Also a FileExistsError so callers catching the stdlib type keep working.

ConfigValueError()

A configuration value is invalid for the requested conversion.

Also a ValueError so callers catching the stdlib type keep working.

UnsupportedModelError()

The input model uses a structure or dtype heliaAOT cannot lower.

Raised when a graph is recognized but cannot be compiled, so the message can name the recognized construct and the hint can state the supported form. Also a ValueError so callers catching the stdlib type keep working.

TemplateRenderError()

A codegen template referenced context its handler did not supply.

The shared Jinja environment uses StrictUndefined, so an undefined name, a missing attribute, or an out-of-range index raises during emit instead of rendering as the empty string. That is always a heliaAOT defect rather than a user mistake, but it is reachable from a valid model, so the failure is reported with the operator, template, and line that produced it and the original UndefinedError is kept as __cause__. Also a RuntimeError so callers catching the stdlib type keep working.

GoldenDataKeyError()

A supplied golden-data archive is missing a required tensor key.

Also a KeyError so callers catching the stdlib type keep working.