Enum ShaclError 

pub enum ShaclError {
    ShapeParsing(String),
    ConstraintValidation(String),
    TargetSelection(String),
    PropertyPath(String),
    PathEvaluationError(String),
    SparqlExecution(String),
    ValidationEngine(String),
    ReportGeneration(String),
    Configuration(String),
    Core(OxirsError),
    Io(String),
    Regex(Error),
    Json(String),
    IriResolution(IriResolutionError),
    SecurityViolation(String),
    ShapeValidation(String),
    Timeout(String),
    MemoryLimit(String),
    RecursionLimit(String),
    MemoryPool(String),
    MemoryOptimization(String),
    AsyncOperation(String),
    UnsupportedOperation(String),
    ReportError(String),
}

Core error type for SHACL operations.

Every fallible API in this crate returns Result<T>, which is a type alias for std::result::Result<T, ShaclError>. The variants below cover the full surface area of the validation pipeline — parsing, constraint evaluation, property path traversal, SPARQL execution, reporting, and resource limits.

All variants derive thiserror::Error and provide a human-readable Display implementation suitable for inclusion in user-facing diagnostics. Errors that wrap foreign types (oxirs_core::OxirsError, regex::Error, IriResolutionError) implement From so the ? operator works without boilerplate.

Variants

ShapeParsing(String)

A shape document failed to parse (malformed Turtle/RDF, missing required terms, or invalid SHACL syntax).

ConstraintValidation(String)

A constraint definition was rejected during structural validation (e.g. invalid sh:pattern regex, contradictory cardinalities).

TargetSelection(String)

Target selection failed — typically a malformed sh:target* declaration or an inaccessible store.

PropertyPath(String)

A property path expression could not be parsed.

PathEvaluationError(String)

A property path evaluated correctly but produced an unexpected result during traversal (cycles, infinite paths beyond the recursion limit).

SparqlExecution(String)

A SPARQL query (used by SHACL-SPARQL constraints, SHACL-AF targets, or the optimizer) failed to execute.

ValidationEngine(String)

The validation engine itself reported an internal error (orchestration failure, scheduler error, etc.).

ReportGeneration(String)

Producing a validation report failed (serialisation, IO, or formatter error).

Configuration(String)

A user-supplied ValidationConfig or builder argument is invalid.

Core(OxirsError)

Wrapped error originating in the oxirs-core RDF data model.

Io(String)

Wrapped std::io::Error.

Regex(Error)

A sh:pattern regex failed to compile.

Json(String)

JSON serialisation/deserialisation error (used by the JSON-LD report writer and YAML config loader).

IriResolution(IriResolutionError)

IRI resolution failed (relative IRI without a base, malformed prefix, etc.).

SecurityViolation(String)

A SHACL-SPARQL constraint was rejected by the security policy (forbidden function, query too expensive, network egress denied).

ShapeValidation(String)

A higher-level shape contract was violated (e.g. inheritance cycle, conflicting sh:property definitions).

Timeout(String)

Validation exceeded the configured wall-clock timeout.

MemoryLimit(String)

Validation exceeded the configured memory budget.

RecursionLimit(String)

Recursive shape evaluation reached ValidationConfig::max_recursion_depth.

MemoryPool(String)

Internal pool used for short-lived allocations failed.

MemoryOptimization(String)

Memory-aware optimisation pass aborted.

AsyncOperation(String)

An async runtime task failed (only when the async feature is enabled).

UnsupportedOperation(String)

A construct was recognised but is not yet implemented in this build (typically gated behind a Cargo feature).

ReportError(String)

Generic report-related failure (writer IO, missing template, etc.).

Trait Implementations

impl Clone for ShaclError

fn clone(&self) -> ShaclError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ShaclError

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

Formats the value using the given formatter.

impl Display for ShaclError

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

Formats the value using the given formatter.

impl Error for ShaclError

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 ShaclError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ShaclError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ShaclError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ShaclError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ShaclError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ShaclError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<IriResolutionError> for ShaclError

fn from(source: IriResolutionError) -> Self

Converts to this type from the input type.

impl From<OxirsError> for ShaclError

fn from(source: OxirsError) -> Self

Converts to this type from the input type.

impl From<ShaclError> for IntegrationError

fn from(source: ShaclError) -> Self

Converts to this type from the input type.