Function parse_with 

pub fn parse_with(
    input: &[u8],
    options: ParseOptions,
) -> Result<ParseOutcome, StepError>

Parses a physical file under explicit ParseOptions.

With OnMalformed::Skip an unparsable data record is reported as a Diagnostic and the parser resynchronizes on the next record or section end, so a consumer can load a damaged file and still show exactly what was dropped. Header structure stays strict under every policy: mandatory header records are file-level invariants, not recoverable payload.

Errors

Returns StepError for the wrong physical-file marker, for any header or section-structure defect, and for data defects when the policy is OnMalformed::Abort.

Examples found in repository

examples/recovery_probe.rs (line 12)

fn main() {
    let path = std::env::args().nth(1).expect("path");
    let bytes = std::fs::read(&path).expect("read");

    match openbim_step::parse(&bytes) {
        Ok(_) => println!("strict: OK (unexpected)"),
        Err(error) => println!("strict: {error}"),
    }

    let outcome = openbim_step::parse_with(&bytes, openbim_step::ParseOptions::lenient())
        .expect("lenient parse");
    println!(
        "lenient: {} records, {} diagnostics",
        outcome.exchange.data.records.len(),
        outcome.diagnostics.len()
    );
    for diagnostic in &outcome.diagnostics {
        println!("  {diagnostic}");
        let span = diagnostic.span();
        println!(
            "  dropped bytes: {:?}",
            String::from_utf8_lossy(&bytes[span.start..span.end])
        );
    }
    let boundaries = outcome
        .exchange
        .data
        .records
        .iter()
        .filter(|record| {
            record
                .as_simple()
                .is_some_and(|simple| simple.name == "IFCRELSPACEBOUNDARY")
        })
        .count();
    println!("IfcRelSpaceBoundary: {boundaries}");
    println!("schema: {:?}", outcome.exchange.header.standard().schema);
}