Errors
module nemo_fabric.errors
Public exception hierarchy for the NeMo Fabric Python SDK.
Global Variables
- TYPE_CHECKING
class FabricError
Base class for structured SDK-level NeMo Fabric errors.
Catch this type to handle any SDK failure while preserving machine-readable stage, code, retryability, and detail fields.
Attributes:
stage: Lifecycle stage that failed, when known.code: Stable machine-readable error code, when available.retryable: Whether retrying may succeed without changing the request.details: Detached structured error details.
Inheritance
Direct base: RuntimeError.
method __init__
Initialize a structured NeMo Fabric exception.
Args:
message: Human-readable failure description.stage: Optional lifecycle stage that failed.code: Optional stable machine-readable error code.retryable: Whether callers may safely retry unchanged input.details: Optional structured diagnostic context. The exception stores a deep copy.
property cleanup_runtime
Owned runtime for a failed lifecycle cleanup retry, or None.
This in-memory capability is excluded from error text and structured details.
class FabricConfigError
Invalid SDK input, request shape, factory, or resolved config.
Inheritance
Direct base: FabricError.
method __init__
Initialize a structured NeMo Fabric exception.
Args:
message: Human-readable failure description.stage: Optional lifecycle stage that failed.code: Optional stable machine-readable error code.retryable: Whether callers may safely retry unchanged input.details: Optional structured diagnostic context. The exception stores a deep copy.
property cleanup_runtime
Owned runtime for a failed lifecycle cleanup retry, or None.
This in-memory capability is excluded from error text and structured details.
class FabricRuntimeError
Failure while starting, invoking, stopping, or otherwise driving a runtime.
Inheritance
Direct base: FabricError.
method __init__
Initialize a structured NeMo Fabric exception.
Args:
message: Human-readable failure description.stage: Optional lifecycle stage that failed.code: Optional stable machine-readable error code.retryable: Whether callers may safely retry unchanged input.details: Optional structured diagnostic context. The exception stores a deep copy.
property cleanup_runtime
Owned runtime for a failed lifecycle cleanup retry, or None.
This in-memory capability is excluded from error text and structured details.
class FabricStateError
Operation rejected because a local runtime is in the wrong state.
Inheritance
Direct base: FabricRuntimeError.
method __init__
Initialize a structured NeMo Fabric exception.
Args:
message: Human-readable failure description.stage: Optional lifecycle stage that failed.code: Optional stable machine-readable error code.retryable: Whether callers may safely retry unchanged input.details: Optional structured diagnostic context. The exception stores a deep copy.
property cleanup_runtime
Owned runtime for a failed lifecycle cleanup retry, or None.
This in-memory capability is excluded from error text and structured details.
class FabricCapabilityError
Operation rejected by resolved runtime capabilities or implementation status.
Inheritance
Direct base: FabricRuntimeError.
method __init__
Initialize a structured NeMo Fabric exception.
Args:
message: Human-readable failure description.stage: Optional lifecycle stage that failed.code: Optional stable machine-readable error code.retryable: Whether callers may safely retry unchanged input.details: Optional structured diagnostic context. The exception stores a deep copy.
property cleanup_runtime
Owned runtime for a failed lifecycle cleanup retry, or None.
This in-memory capability is excluded from error text and structured details.
class FabricNativeUnavailableError
SDK call requires the PyO3 extension, but it is not installed or importable.
Inheritance
Direct base: FabricRuntimeError.
method __init__
Initialize a structured NeMo Fabric exception.
Args:
message: Human-readable failure description.stage: Optional lifecycle stage that failed.code: Optional stable machine-readable error code.retryable: Whether callers may safely retry unchanged input.details: Optional structured diagnostic context. The exception stores a deep copy.
property cleanup_runtime
Owned runtime for a failed lifecycle cleanup retry, or None.
This in-memory capability is excluded from error text and structured details.
class ResourceObservationUnavailableError
Runtime resources cannot be read now.
The runtime stopped, is stopping, its adapter host process exited, a live process in its tree or the process table cannot be read, or the process tree kept changing during the read.
Inheritance
Direct base: FabricRuntimeError.
method __init__
Initialize a structured NeMo Fabric exception.
Args:
message: Human-readable failure description.stage: Optional lifecycle stage that failed.code: Optional stable machine-readable error code.retryable: Whether callers may safely retry unchanged input.details: Optional structured diagnostic context. The exception stores a deep copy.
property cleanup_runtime
Owned runtime for a failed lifecycle cleanup retry, or None.
This in-memory capability is excluded from error text and structured details.
class ResourceObservationUnsupportedError
Runtime resources have no reader.
The runtime’s adapter kind, environment provider, or operating system has no resource reader.
Inheritance
Direct base: FabricRuntimeError.
method __init__
Initialize a structured NeMo Fabric exception.
Args:
message: Human-readable failure description.stage: Optional lifecycle stage that failed.code: Optional stable machine-readable error code.retryable: Whether callers may safely retry unchanged input.details: Optional structured diagnostic context. The exception stores a deep copy.
property cleanup_runtime
Owned runtime for a failed lifecycle cleanup retry, or None.
This in-memory capability is excluded from error text and structured details.
This file was automatically generated via lazydocs.