Skip to content

nemo_fabric.errors.md

Latest commit

 

History

History
239 lines (137 loc) · 5.38 KB

nemo_fabric.errors.md

File metadata and controls

239 lines (137 loc) · 5.38 KB
Raw
title Errors
slug /reference/api/python-library-reference/errors
description Structured exception hierarchy for config, capability, state, and runtime failures.

{/* SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved. SPDX-License-Identifier: Apache-2.0 */}

module nemo_fabric.errors

Public exception hierarchy for the NeMo Fabric Python SDK.

class FabricError

Base class for structured SDK-level 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.

method __init__

__init__(
    message: 'str',
    stage: 'str | None' = None,
    code: 'str | None' = None,
    retryable: 'bool' = False,
    details: 'Mapping[str, Any] | None' = None
) → None

Initialize a structured 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.

method __init__

__init__(
    message: 'str',
    stage: 'str | None' = None,
    code: 'str | None' = None,
    retryable: 'bool' = False,
    details: 'Mapping[str, Any] | None' = None
) → None

Initialize a structured 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.

method __init__

__init__(
    message: 'str',
    stage: 'str | None' = None,
    code: 'str | None' = None,
    retryable: 'bool' = False,
    details: 'Mapping[str, Any] | None' = None
) → None

Initialize a structured 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.

method __init__

__init__(
    message: 'str',
    stage: 'str | None' = None,
    code: 'str | None' = None,
    retryable: 'bool' = False,
    details: 'Mapping[str, Any] | None' = None
) → None

Initialize a structured 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.

method __init__

__init__(
    message: 'str',
    stage: 'str | None' = None,
    code: 'str | None' = None,
    retryable: 'bool' = False,
    details: 'Mapping[str, Any] | None' = None
) → None

Initialize a structured 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.

method __init__

__init__(
    message: 'str',
    stage: 'str | None' = None,
    code: 'str | None' = None,
    retryable: 'bool' = False,
    details: 'Mapping[str, Any] | None' = None
) → None

Initialize a structured 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.