Enum StructureError 

pub enum StructureError {
    MissingEntrySource {
        module: String,
    },
    EntrySourceNotUtf8 {
        module: String,
    },
    NoWorkflowImport {
        module: String,
    },
    UnknownActivity {
        activity: String,
    },
    EntryFunctionNotFound {
        module: String,
        function: String,
    },
    UnboundedDelta {
        reason: String,
    },
    DeltaTargetMissing {
        id: usize,
    },
    RegenInvalidName {
        name: String,
        reason: String,
    },
}

Errors produced while extracting a workflow graph model from a package or regenerating Gleam from a bounded structural delta.

Variants

MissingEntrySource

The manifest names an entry module whose Gleam source is absent from the package src/ set, so the primitive structure cannot be derived.

A package may legitimately ship without source (beam-only deploys), but structure extraction requires the verbatim entry-module source to read.

Fields

module: String

Logical entry-module name named by the manifest.

EntrySourceNotUtf8

The entry-module source bytes are not valid UTF-8 and cannot be scanned for the workflow vocabulary.

Fields

module: String

Logical entry-module name whose bytes failed to decode.

NoWorkflowImport

The entry-module source never imports aion/workflow, so it invokes none of the recorded primitives and has no extractable structure.

This is reported rather than returning an empty graph, so a workflow the extractor cannot understand fails loudly instead of rendering as blank.

Fields

module: String

Logical entry-module name that lacked the import.

UnknownActivity

A run node names an activity the package manifest does not declare, so the extracted graph would not correspond to the workflow’s real activities.

Fields

activity: String

The activity name found in source but absent from the manifest.

EntryFunctionNotFound

The manifest names an entry function whose definition is absent from the entry-module source, so the control-flow walk has no root to start from.

Reported rather than returning an empty graph: a workflow whose entry function the extractor cannot locate fails loudly instead of rendering as blank.

Fields

module: String

Logical entry-module name searched.

function: String

Entry-function name named by the manifest but not found.

UnboundedDelta

A structural delta fell outside the bounded round-trip vocabulary, so it is refused rather than synthesising unbounded code (CN6, ADR-014).

Fields

reason: String

Why the delta is not part of the bounded set.

DeltaTargetMissing

A delta targeted a node id that is not present in the graph.

Fields

id: usize

The missing target node id.

RegenInvalidName

A regenerated identifier (an activity or module name) would not be a valid Gleam snake_case identifier, so emitting it would produce code that does not type-check.

Fields

name: String

The offending name.

reason: String

Why the name cannot be used.

Trait Implementations

impl Debug for StructureError

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

Formats the value using the given formatter.

impl Display for StructureError

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

Formats the value using the given formatter.

impl Eq for StructureError

impl Error for StructureError

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 PartialEq for StructureError

fn eq(&self, other: &StructureError) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for StructureError