Enum GraphError 

#[non_exhaustive]
pub enum GraphError {
    UnresolvableModuleSource {
        module_source: Arc<str>,
        site: Box<Span>,
    },
    DepthExceeded {
        limit: u32,
        site: Box<Span>,
    },
    AddressCollision(Address),
    PathSafety {
        path: PathBuf,
        reason: Arc<str>,
    },
}

Errors the graph builder can surface.

Per 15-resource-graph.md § 7, UnresolvableModuleSource and DepthExceeded are not fatal — the builder records them as crate::Diagnostics and continues. Only GraphError::AddressCollision is fatal: it indicates a bug in the expansion logic, not user input.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

UnresolvableModuleSource

A module call’s source could not be resolved to a known local module. Treated as a diagnostic at the call site, never fatal.

Fields

module_source: Arc<str>

Verbatim source string from the call site.

site: Box<Span>

Span of the call site.

DepthExceeded

Module recursion exceeded the configured depth cap. Records the path where the cap fired.

Fields

limit: u32

Configured cap.

site: Box<Span>

Span of the offending call site.

AddressCollision(Address)

Two flattened resources resolved to the same Address. Fatal: the IR cannot represent two rows with the same address.

PathSafety

Path-safety check failed when resolving a local module source. Non-fatal in spec; the builder logs a diagnostic and skips the call.

Fields

path: PathBuf

Candidate path that failed.

reason: Arc<str>

Why it failed.

Trait Implementations

impl Debug for GraphError

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

Formats the value using the given formatter.

impl Display for GraphError

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

Formats the value using the given formatter.

impl Error for GraphError

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.