Skip to content

ifc-step ​

STEP physical file (ISO 10303-21) codec for the IFC model.

StatusImplemented
Latest release0.6.5 (2026-11-09)
Registriescrates.io ifc-step
Via the facadeopenbim-ifc feature step
API documentationrustdoc · docs.rs
Sourcecrates/ifc-step/

Overview ​

ifc-step — IFC adaptation over generic ISO 10303-21 syntax.

Generic tokenization, escaping, records, parameters, sections, parsing, writing, partitioning, spans, diagnostics, and event sinks live in openbim_step. This crate owns only conversion between that generic substrate and ifc_model::Model plus IFC codec detection and I/O policy.

ModuleRole
codecStepCodec/StepReader: detection, parse policy, I/O
errorSTEP-specific failure modes, ReadFailure
locationLines, columns and quotes of the source: SyntaxLocation, diagnostics
parserGeneric exchange to IFC record model
writerIFC record model to physical file

Depends on ​

Changes ​

Latest release, 0.6.5 (2026-11-09):

Fixed (#668) ​

  • Moved to openbim-step 0.11.4. A lenient read's recovery now stops before the next #id =, so a record missing its ; no longer swallows the record after it: that record is kept, and a conflicting duplicate id among them is reported as a DuplicateId diagnostic. Unit resolution therefore refuses it as damaged instead of trusting it or calling the model incomplete.

Fixed (#626) ​

  • Two records sharing one instance id are reported on every read, not only under check_references(true). A strict read now refuses the file with StepError::DuplicateId (ModelError::DuplicateId through the codec), naming the id and, in StepError, the later record's offset (public through Index::scan; ModelError carries the id alone): this is a behaviour change, a strict read of such a file used to succeed silently with the later record. Index::scan refuses such a file too. A lenient read keeps the later record, as it does under check_references(true), and reports a DuplicateId diagnostic carrying the instance, span, position and excerpt. StepReader::check refuses the same files. Detection happens on insert, with no second pass over a duplicate-free file. SyntaxLocation::of_step_error locates the error. Semver: patch (behaviour change: a strict read of a file with duplicate ids now fails).

Full history: crates/ifc-step/CHANGELOG.md

Dual-licensed under AGPL-3.0-or-later or a commercial licence. ISO and CEN standards material is not redistributed.