Enum DriverError 

pub enum DriverError {
    Connect(Box<dyn Error + Send + Sync>),
    Operation(Box<dyn Error + Send + Sync>),
    InvalidTagValue {
        tag: TagId,
        message: String,
    },
    Unsupported {
        operation: &'static str,
    },
    IndexOperationRejected {
        message: String,
    },
    IncompatibleGateway {
        operation: &'static str,
    },
    BrowseStateInvalid,
}

All the ways a crate::Driver call can fail.

Deliberately not a single opaque/anyhow-style error: callers need to tell “the driver itself is unreachable” apart from “one read/write/browse call failed” apart from “this driver doesn’t support that at all” to react correctly — in particular the unattended-operation guardrails planned for cli-safety need to distinguish a connection failure (abort immediately, nothing was attempted) from an operation failure (may be worth one retry) rather than treating every failure identically.

The underlying cause is boxed (Box<dyn std::error::Error + Send + Sync>) rather than naming a concrete type, since different crate::Driver implementations wrap completely unrelated error types (a future driver-opcda’s opcda_bridge::Error, a simulator’s own internal error, golden-trace parse errors for driver-replay) and this trait/error model must not force all of them to share one. #[source] still preserves the full chain for std::error::Error::source()/anyhow/logging to walk.

Variants

Connect(Box<dyn Error + Send + Sync>)

The driver could not be reached at all — nothing was read or written. For driver-opcda, this is expected to wrap opcda_bridge::Error::Connect.

Operation(Box<dyn Error + Send + Sync>)

A read/write/browse call reached the driver but failed there — an RPC error, an unresolvable tag, a malformed response. For driver-opcda, this is expected to wrap opcda_bridge::Error::Rpc. Distinct from a rejected-but-otherwise-successful write (see crate::types::WriteOutcome), which is not an error at all.

InvalidTagValue

One specific tag’s value could not be used as requested — e.g. its raw string value isn’t valid for whatever the caller needed it to mean. Carries the tag so a caller reporting a failed run can name exactly which tag was the problem.

Fields

tag: TagId

message: String

Unsupported

This driver does not implement the requested operation at all (e.g. browse on the simulator or replay drivers, which have no real tag tree to browse) — distinct from a transient DriverError::Operation failure, since retrying can never help.

Fields

operation: &'static str

IndexOperationRejected

The gateway rejected an indexed-search operation because the server’s current enrollment or index state does not permit it.

Fields

message: String

IncompatibleGateway

The connected gateway predates a required protocol operation.

Fields

operation: &'static str

BrowseStateInvalid

A server-side browse session or continuation token is no longer usable.

Trait Implementations

impl Debug for DriverError

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

Formats the value using the given formatter.

impl Display for DriverError

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

Formats the value using the given formatter.

impl Error for DriverError

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.