Enum ValidationError 

pub enum ValidationError {
    InvalidField {
        playbook_id: String,
        field: String,
        value: String,
        reason: String,
    },
    MissingField {
        playbook_id: String,
        field: String,
    },
    DuplicateId {
        playbook_id: String,
    },
    TomlParse(Error),
    UnknownPlaybook {
        playbook_id: String,
    },
    UnknownParent {
        playbook_id: String,
        parent_id: String,
    },
}

Errors returned by playbook validation and loading.

Every variant embeds the playbook id, the field path (a dotted JSON-pointer-style path such as acquisition.retry_budget), and the bad value as a string. The Display impl formats all three so the operator-facing message is actionable without any auxiliary lookup.

Variants

InvalidField

A field failed semantic validation (out of range, wrong multiplicity, inconsistent state).

Fields

playbook_id: String

Playbook containing the offending field.

field: String

Field path (dotted JSON-pointer-style).

value: String

String form of the bad value.

reason: String

Human-readable reason the value was rejected.

MissingField

A required field is missing from the TOML payload.

Fields

playbook_id: String

Playbook missing the field.

field: String

Field path (dotted JSON-pointer-style).

DuplicateId

The same playbook id appears more than once in the input bundle.

Fields

playbook_id: String

Conflicting playbook id.

TomlParse(Error)

The TOML parser reported a structural error.

UnknownPlaybook

The resolver was asked for a playbook id that is not loaded.

Fields

playbook_id: String

Playbook id the resolver could not find.

UnknownParent

A reference to a sibling playbook id (e.g. an extends = "tier1-static" declaration) could not be resolved.

Fields

playbook_id: String

Child playbook id.

parent_id: String

Parent playbook id it tried to extend.

Implementations

impl ValidationError

pub fn invalid_field( playbook_id: impl Into<String>, field: impl Into<String>, value: impl Display, reason: impl Into<String>, ) -> Self

Convenience constructor for ValidationError::InvalidField that builds the field path and bad-value string from caller inputs.

pub fn missing_field( playbook_id: impl Into<String>, field: impl Into<String>, ) -> Self

Convenience constructor for ValidationError::MissingField.

pub fn field_path(&self) -> Option<&str>

Field path (dotted JSON-pointer-style) when applicable.

pub fn bad_value(&self) -> Option<&str>

Bad value (string form) when applicable.

Trait Implementations

impl Debug for ValidationError

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

Formats the value using the given formatter.

impl Display for ValidationError

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

Formats the value using the given formatter.

impl Error for ValidationError

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.

impl From<Error> for ValidationError

fn from(source: Error) -> Self

Converts to this type from the input type.