1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
//! # stepq
//!
//! Query, inspect, split and reshape STEP (ISO 10303-21) files.
//!
//! `stepq` works on the *entity graph* of a Part 21 file. It never
//! evaluates geometry: there is no tessellation, no volume, no healing.
//! Everything it does — splitting assemblies, extracting a bill of
//! materials, validating structure — is a graph operation over the
//! original entity instances, which are preserved byte-for-byte.
//!
//! The crate is a library first. The `stepq` command-line tool is built
//! from the same code behind the `cli` feature (enabled by default).
//! Library users can depend on it with `default-features = false`.
//!
//! ## Pipeline
//!
//! Every command is built from the same four steps: [`p21::parse`] the
//! bytes into an [`Exchange`](p21::Exchange), index its references with a
//! [`model::Graph`], ask questions through the record and parameter
//! views, and write a selection back out with a [`p21::Writer`].
//!
//! ```
//! use stepq::model::Graph;
//! use stepq::p21::{Numbering, Writer, parse};
//!
//! let src = b"ISO-10303-21;HEADER;FILE_SCHEMA(('AP242'));ENDSEC;DATA;
//! #1=PRODUCT('p1','bracket','',(#2));
//! #2=PRODUCT_CONTEXT('',#3,'mechanical');
//! #3=APPLICATION_CONTEXT('design');
//! #4=PRODUCT_DEFINITION_FORMATION('','',#1);
//! ENDSEC;END-ISO-10303-21;";
//!
//! let graph = Graph::new(parse(src)?)?;
//! let exchange = graph.exchange();
//!
//! // Find instances by type and read their attributes.
//! let product = exchange.instances_of("PRODUCT").next().unwrap();
//! let record = exchange.records(graph.instance(product)).next().unwrap();
//! let name = record.param(1).and_then(|p| p.literal()).unwrap().decode()?;
//! assert_eq!(name, "bracket");
//!
//! // Follow references backwards: the formation points at the product.
//! let users: Vec<u64> = graph
//! .referenced_by(product)
//! .iter()
//! .map(|&node| graph.instance(node).id)
//! .collect();
//! assert_eq!(users, [4]);
//!
//! // Write the product and what it refers to, renumbered from #1.
//! let mut out = Vec::new();
//! Writer::new(exchange)
//! .numbering(Numbering::Dense)
//! .write_selection([0, 1, 2], &mut out)?;
//! # Ok::<(), stepq::Error>(())
//! ```
//!
//! ## Status
//!
//! Pre-1.0. The public API will change. See `ROADMAP.md` in the
//! repository for what is planned and `docs/ARCHITECTURE.md` for the
//! design decisions this crate is built on.
pub use ;