ReferenceAPIPython Library Reference

Errors

View as Markdown

module nemo_fabric.errors

Public exception hierarchy for the NeMo Fabric Python SDK.

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__

1def __init__(
2    message: str,
3    *,
4    stage: str | None = None,
5    code: str | None = None,
6    retryable: bool = False,
7    details: Mapping[str, Any] | None = None,
8) -> 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.

class FabricConfigError

Invalid SDK input, request shape, factory, or resolved config.

Inheritance

Direct base: FabricError.

method __init__

1def __init__(
2    message: str,
3    *,
4    stage: str | None = None,
5    code: str | None = None,
6    retryable: bool = False,
7    details: Mapping[str, Any] | None = None,
8) -> 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.

class FabricRuntimeError

Failure while starting, invoking, stopping, or otherwise driving a runtime.

Inheritance

Direct base: FabricError.

method __init__

1def __init__(
2    message: str,
3    *,
4    stage: str | None = None,
5    code: str | None = None,
6    retryable: bool = False,
7    details: Mapping[str, Any] | None = None,
8) -> 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.

class FabricStateError

Operation rejected because a local runtime is in the wrong state.

Inheritance

Direct base: FabricRuntimeError.

method __init__

1def __init__(
2    message: str,
3    *,
4    stage: str | None = None,
5    code: str | None = None,
6    retryable: bool = False,
7    details: Mapping[str, Any] | None = None,
8) -> 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.

class FabricCapabilityError

Operation rejected by resolved runtime capabilities or implementation status.

Inheritance

Direct base: FabricRuntimeError.

method __init__

1def __init__(
2    message: str,
3    *,
4    stage: str | None = None,
5    code: str | None = None,
6    retryable: bool = False,
7    details: Mapping[str, Any] | None = None,
8) -> 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.

class FabricNativeUnavailableError

SDK call requires the PyO3 extension, but it is not installed or importable.

Inheritance

Direct base: FabricRuntimeError.

method __init__

1def __init__(
2    message: str,
3    *,
4    stage: str | None = None,
5    code: str | None = None,
6    retryable: bool = False,
7    details: Mapping[str, Any] | None = None,
8) -> 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.

This file was automatically generated via lazydocs.