Errors

Every error the package raises on purpose derives from MllmShapError and from the closest built-in exception.

Typed errors raised by mllm-shap pipeline components.

Every error derives from MllmShapError, so except MllmShapError catches anything the package raises on purpose. Each error also derives from the closest built-in exception, so existing except ValueError or except LookupError handlers keep working.

@domain core @see [[knowledge/architecture/core]]

exception mllm_shap.errors.MllmShapError

Bases: Exception

Root of every error raised on purpose by mllm-shap.

exception mllm_shap.errors.PluginNotFoundError

Bases: LookupError, MllmShapError

Raised when no plugin is registered under the requested group and name.

exception mllm_shap.errors.PluginConflictError

Bases: ValueError, MllmShapError

Raised when a plugin name is registered twice without replace=True.

exception mllm_shap.errors.PluginLoadError(message: str, entry_point_name: str)

Bases: ImportError, MllmShapError

Raised when a packaging entry point cannot be imported.

entry_point_name

Name of the entry point whose load() failed.

exception mllm_shap.errors.ConfigError

Bases: ValueError, MllmShapError

Raised when configuration values are invalid or inconsistent.

exception mllm_shap.errors.BackendUnavailableError

Bases: RuntimeError, MllmShapError

Raised when a configured generative backend cannot be reached.

exception mllm_shap.errors.LogprobsUnavailableError

Bases: BackendUnavailableError

Raised when a value function needs token logprobs a generation lacks.

exception mllm_shap.errors.ArchiveExistsError

Bases: FileExistsError, MllmShapError

Raised when a run archive already exists and on_exists is "error".

exception mllm_shap.errors.ManifestVersionError

Bases: ValueError, MllmShapError

Raised when a run manifest or archive uses an unsupported schema version.

exception mllm_shap.errors.ReanalyzeMismatchError

Bases: ValueError, MllmShapError

Raised when reanalyze settings disagree with the archived run.

exception mllm_shap.errors.ArchiveIncompleteError

Bases: ValueError, MllmShapError

Raised when reanalyze meets an archive of a run that did not finish.

exception mllm_shap.errors.ArchiveNotFoundError

Bases: FileNotFoundError, MllmShapError

Raised when a run archive lacks its manifest or SQLite database.

exception mllm_shap.errors.ArchiveCorruptError

Bases: ValueError, MllmShapError

Raised when a run archive or its manifest cannot be read or parsed.