Errors

Error Definitions

The sierra.internal.errors module defines all custom exception types used throughout sierra-dev, enabling precise error handling and logging.

Common Sierra errors

import sierra.internal.errors as errors

try:
    # Simulate a missing scripts directory
    raise errors.SierraClientPathError("Invalid path: ./scripts")
except errors.SierraClientPathError as e:
    print(f"Caught client path error: {e}")

try:
    # Simulate a module load failure
    raise errors.SierraClientLoadError("No invoker found in module")
except errors.SierraClientLoadError as e:
    print(f"Caught load error: {e}")

try:
    # Simulate a runtime failure in an invoker
    raise errors.SierraExecutionError("Script runtime exception")
except errors.SierraExecutionError as e:
    print(f"Caught execution error: {e}")

sierra.internal.errors

Classes

BaseSierraError

Bases: Exception

Base class for all Sierra errors.

SierraPathError

Bases: BaseSierraError

Raised when there is a problem with a filesystem path.

SierraPathNotFoundError

Bases: SierraPathError

Raised when a required filesystem path does not exist.

SierraClientPathError

Bases: SierraPathError

Raised when the SierraDevelopmentClient cannot load invokers because its environment.script_path (or a given file) is not found or is not a valid .py file.

SierraExecutionError

Bases: BaseSierraError

Raised when an execution error occurs in Sierra.

SierraClientLoadError

Bases: BaseSierraError

Raised when a dynamically-imported module contains no valid InvokerScript subclasses.

SierraHTTPError

Bases: BaseSierraError

Raised when an HTTP request via Sierra's http client fails.

SierraCacheError

Bases: BaseSierraError

Raised when a cache-related error occurs in Sierra.