Skip to main content

Module express

Module express 

Source
Expand description

EXPRESS rule evaluation: WHERE rules, type rules, global rules and the FUNCTIONs they call, read from the release’s own schema text.

use ifc_validate::{express::ExpressRules, validate_with_options, ValidateOptions};

let schema = ifc_schema::ifc4();
// `exp` is the text of IFC4.exp, which the caller supplies.
let rules = ExpressRules::parse(exp, schema)?;
let report = validate_with_options(model, schema, &ValidateOptions::new().express(&rules));

§Why the rule text is supplied, not bundled

The IFC schemas are CC BY-ND 4.0. The bundled tables keep their structure and rule labels, never rule text, and generated code transcribing the rules would be a derivative of it. So the evaluator is an interpreter: ExpressRules::parse reads the .exp file the caller has (scripts/fetch-ifc-schemas.sh fetches and checksums all five releases), and nothing derived from it is written anywhere.

§Semantics

ISO 10303-11, with three-valued logic: a rule is violated when it evaluates to FALSE, and an UNKNOWN or ? result is reported as indeterminate, never as a pass or a violation. TYPEOF answers the SELECT types a value belongs to as well as its own types. One schema defect is worked around: rule strings naming a type in mixed case ('IFC4X3_ADD2.IfcMappedItem') are read upper-cased, as resolve.rs explains.

§Internal split

  • lexer.rs, parse.rs, parse_expr.rs, parse_stmt.rs: reading the text into ast.rs.
  • resolve.rs: binding names to slots, functions, entities and enumeration items.
  • tables.rs: attribute layout, cross-checked against the bundled tables, and TYPEOF names.
  • value.rs, machine.rs, eval.rs, ops.rs, builtins.rs, exec.rs, access.rs: the interpreter.
  • run.rs: applying every rule to a model and reporting.
  • rules.rs, options.rs, coverage.rs, error.rs: the public surface.

Structs§

Coverage
The evaluator’s coverage of one release.
EvalLimits
How much work rule evaluation may do on one model.
ExpressRules
The WHERE rules, type rules, global rules and functions of one IFC release, ready to evaluate.
RuleCount
Evaluable declarations of one kind.

Enums§

BudgetExceeded
Which limit stopped an evaluation.
ExpressError
The EXPRESS source could not be turned into evaluable rules.