Enum CompileError 

pub enum CompileError {
    Parse(Diagnostics),
    PremiseRedefinition {
        name: String,
    },
    MissingDomain {
        file: String,
    },
    DuplicateDomain {
        file: String,
    },
    UnknownDomain {
        domain: String,
    },
    DomainAliasClash {
        alias: String,
    },
    ImportNotFound(String),
    CircularImport(String),
    RuleDisjunctiveConsequent {
        name: String,
    },
    UnknownValue(Box<UnknownValue>),
    UnknownSet {
        file: String,
        line: u32,
        set: String,
        suggestion: String,
    },
    CyclicRelation {
        file: String,
        line: u32,
        relation: String,
        node: String,
    },
    UndeclaredPort {
        file: String,
        line: u32,
        name: String,
        suggestion: String,
    },
    UnknownPort {
        name: String,
        suggestion: String,
    },
    AmbiguousPort {
        name: String,
        domains: String,
    },
    UnknownExternalAtom {
        name: String,
    },
    PortConflict {
        name: String,
        a_value: bool,
        a_origin: String,
        b_value: bool,
        b_origin: String,
    },
    DataFileStatement {
        file: String,
        line: u32,
    },
}

Anything that can go wrong while compiling (and resolving imports).

Variants

Parse(Diagnostics)

A source failed to parse; carries the full syntax diagnostics (every error, each as a caret block with the keyword’s correct syntax). The source label is already inside the [Diagnostics] header.

PremiseRedefinition

A name was reused with a different body within the same source.

Fields

name: String

The clashing premise/rule name.

MissingDomain

A source did not declare its DOMAIN (required, once, as the first statement).

Fields

file: String

The source label that lacked a DOMAIN.

DuplicateDomain

A source declared DOMAIN more than once (a file has exactly one domain).

Fields

file: String

The source label with the duplicate DOMAIN.

UnknownDomain

An atom referenced a domain. prefix that is not the file’s own domain and was not imported in this file.

Fields

domain: String

The unresolved domain prefix.

DomainAliasClash

Two imports bound the same local domain name to different domains (use a distinct AS <alias> to tell them apart).

Fields

alias: String

The clashing local domain name.

ImportNotFound(String)

An IMPORT target could not be loaded by the [Resolver].

CircularImport(String)

Imports form a cycle (a source transitively imports itself).

RuleDisjunctiveConsequent

A RULE used OR in its THEN: forward chaining cannot derive a disjunction (it would not know which literal to assert). Model it as a PREMISE constraint instead.

Fields

name: String

The offending rule name.

UnknownValue(Box<UnknownValue>)

A reference used a value outside the closed set an ONEOF declared for that variable. Almost always a typo: the misspelling would otherwise mint a new atom that hangs in the air as UNKNOWN. Closed-world is opt-in — it only applies to a (subject, predicate) whose values an ONEOF enumerated. Boxed so this comparatively large payload does not bloat every Result.

UnknownSet

A FOR EACH … IN <set> named a set that was never declared with SET. Usually a typo in the set name; the suggestion offers the nearest declared set when one is close.

Fields

file: String

The source the offending FOR EACH is in.

line: u32

1-based line of the FOR EACH.

set: String

The undeclared set name that was referenced.

suggestion: String

— did you mean \x`?`, or empty when nothing is close enough.

CyclicRelation

CLOSE <relation> TRANSITIVE found a cycle: a node transitively reaches itself. Transitive closure requires a DAG (e.g. a dependency graph).

Fields

file: String

The source the CLOSE is in.

line: u32

1-based line of the CLOSE.

relation: String

The relation predicate being closed.

node: String

A node on the cycle (reaches itself).

UndeclaredPort

A bare proposition (a single-word atom like db_ready) was used in the program but never declared with VAR. Almost always a typo or a forgotten declaration; the suggestion offers the nearest declared port when close.

Fields

file: String

The source the offending reference is in.

line: u32

1-based line of the offending reference.

name: String

The undeclared bare-proposition name.

suggestion: String

— did you mean \x`?`, or empty when nothing is close enough.

UnknownPort

An external value (--set, API, or PROVIDE) named a port that no VAR declares. Strict by design: silently ignoring an unknown key would hide a mistake.

Fields

name: String

The supplied key that matches no declared port.

suggestion: String

— did you mean \x`?`, or empty when nothing is close enough.

AmbiguousPort

An external value named a bare target declared in more than one domain, so which one it sets is ambiguous. Resolve it by qualifying the key with a domain. prefix.

Fields

name: String

The ambiguous bare name (port or atom subject).

domains: String

The domains that declare this name, comma-joined (sorted).

UnknownExternalAtom

A multi-word external value (PROVIDE engine has_fuel: true or a --set/API key with a predicate) named an atom that no statement in the program uses. Strict by design — like CompileError::UnknownPort, a typo must not be silently injected as a new fact.

Fields

name: String

The atom reference (e.g. engine has_fuel) that matched nothing.

PortConflict

Two sources supplied different values for the same port. Ambiguity is a hard error: the engine is about determinism, so it never silently picks one.

Fields

name: String

The port set inconsistently.

a_value: bool

The first binding’s value.

a_origin: String

The first binding’s origin tag.

b_value: bool

The second (conflicting) binding’s value.

b_origin: String

The second binding’s origin tag.

DataFileStatement

A data file (loaded via --data) contained a statement other than PROVIDE (or DOMAIN). Data files carry only values, never logic.

Fields

file: String

The data file with the offending statement.

line: u32

1-based line of the offending statement.

Trait Implementations

impl Debug for CompileError

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

Formats the value using the given formatter.

impl Display for CompileError

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

Formats the value using the given formatter.

impl Eq for CompileError

impl Error for CompileError

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 CompileError

fn eq(&self, other: &CompileError) -> 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 CompileError