Enum RegentError 

pub enum RegentError {
    FailureToFindGroupContent,
    FailureToParseContent(String),
    FailureToRunCommand(String),
    FailureToEstablishConnection(String),
    FailedInitialization(String),
    FailedTcpBinding(String),
    FailedTaskDryRun(String),
    FailedDryRunEvaluation(String),
    FailedToApplyExpectedState(String),
    FailedToGetSecret(String),
    FailureToConsiderContext(String),
    MissingInitialization(String),
    GroupNotFound,
    MissingGroupsList,
    WorkFlowNotFollowed(String),
    WrongInitialization(String),
    AnyOtherError(String),
    IncoherentExpectedState(String),
    InternalLogicError(String),
    NotConnectedToHost,
    ProblemWithHostConnection(String),
    SecretsIssue(String),
    AttributeError(String),
    TimeOutReached(String),
    FailedToGetFile(String),
    IncompatibleHost(String),
}

The primary error type for Regent SDK operations.

All operations in Regent SDK return this error type, which provides detailed information about what went wrong during execution.

Error Variants

• FailureToFindGroupContent: Could not locate group information
• FailureToParseContent: Parsing errors (YAML, JSON, etc.)
• FailureToRunCommand: Command execution failed
• FailureToEstablishConnection: Connection to host failed
• FailedInitialization: Initialization or setup error
• FailedTcpBinding: TCP binding failed
• FailedTaskDryRun: Dry run of a task failed
• FailedDryRunEvaluation: Evaluation during dry run failed
• FailedToApplyExpectedState: Could not apply the expected state
• FailedToGetSecret: Secret retrieval failed
• FailureToConsiderContext: Template context rendering failed
• MissingInitialization: Required initialization was missing
• GroupNotFound: Requested group does not exist
• MissingGroupsList: Groups list was not provided
• WorkFlowNotFollowed: Required workflow was not followed
• WrongInitialization: Initialization was incorrect
• AnyOtherError: Generic error wrapper
• IncoherentExpectedState: Expected state definition was inconsistent
• InternalLogicError: Internal library error (please report)
• NotConnectedToHost: Operation attempted without active connection
• ProblemWithHostConnection: Connection issue with host
• SecretsIssue: Problem with secret management
• AttributeError: Issue with an attribute definition or execution
• TimeOutReached: Operation timed out

Example

use regent_sdk::RegentError;

fn handle_error(e: RegentError) {
    match e {
        RegentError::NotConnectedToHost => {
            eprintln!("Please connect to the host first");
        }
        RegentError::TimeOutReached(msg) => {
            eprintln!("Operation timed out: {}", msg);
        }
        RegentError::FailedToGetSecret(msg) => {
            eprintln!("Secret retrieval failed: {}", msg);
        }
        _ => {
            eprintln!("An error occurred: {:?}", e);
        }
    }
}

Variants

FailureToFindGroupContent

FailureToParseContent(String)

FailureToRunCommand(String)

FailureToEstablishConnection(String)

FailedInitialization(String)

FailedTcpBinding(String)

FailedTaskDryRun(String)

FailedDryRunEvaluation(String)

FailedToApplyExpectedState(String)

FailedToGetSecret(String)

FailureToConsiderContext(String)

MissingInitialization(String)

GroupNotFound

MissingGroupsList

WorkFlowNotFollowed(String)

WrongInitialization(String)

AnyOtherError(String)

IncoherentExpectedState(String)

InternalLogicError(String)

NotConnectedToHost

ProblemWithHostConnection(String)

SecretsIssue(String)

AttributeError(String)

TimeOutReached(String)

FailedToGetFile(String)

IncompatibleHost(String)

Trait Implementations

impl Clone for RegentError

fn clone(&self) -> RegentError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RegentError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for RegentError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for RegentError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.