Skip to navigation

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__

def __init__(
message: str,
*,
stage: str | None = None,
code: str | None = None,
retryable: bool = False,
details: Mapping[str, Any] | None = None,
) -> None

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__

def __init__(
message: str,
*,
stage: str | None = None,
code: str | None = None,
retryable: bool = False,
details: Mapping[str, Any] | None = None,
) -> None

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__

def __init__(
message: str,
*,
stage: str | None = None,
code: str | None = None,
retryable: bool = False,
details: Mapping[str, Any] | None = None,
) -> None

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__

def __init__(
message: str,
*,
stage: str | None = None,
code: str | None = None,
retryable: bool = False,
details: Mapping[str, Any] | None = None,
) -> None

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__

def __init__(
message: str,
*,
stage: str | None = None,
code: str | None = None,
retryable: bool = False,
details: Mapping[str, Any] | None = None,
) -> None

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__

def __init__(
message: str,
*,
stage: str | None = None,
code: str | None = None,
retryable: bool = False,
details: Mapping[str, Any] | None = None,
) -> None

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__

def __init__(
message: str,
*,
stage: str | None = None,
code: str | None = None,
retryable: bool = False,
details: Mapping[str, Any] | None = None,
) -> None

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__

def __init__(
message: str,
*,
stage: str | None = None,
code: str | None = None,
retryable: bool = False,
details: Mapping[str, Any] | None = None,
) -> None

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.