Struct Topology 

pub struct Topology { /* private fields */ }

Shared planar layers and ordered rules with reusable, thread-safe geometry caches.

Implementations

impl Topology

pub fn new(tolerance: f64) -> Result<Self, Error>

Create an empty topology with tolerance in input coordinate units. Zero requests exact comparisons; no CRS transformation is performed.

Errors

Returns Error::Tolerance for a negative or non-finite tolerance.

pub fn tolerance(&self) -> f64

Return the configured planar tolerance.

pub fn add_layer(&mut self, layer: impl Into<Arc<Layer>>) -> LayerId

Register a layer without validating it, returning a topology-scoped ID. Pass an Arc<Layer> to share one layer, and its cached views, between topologies.

pub fn layer(&self, id: LayerId) -> Result<&Layer, Error>

Borrow a registered layer. IDs must originate from this topology.

Errors

Returns Error::UnknownLayer when the index is not registered.

pub fn layers(&self) -> impl Iterator<Item = (LayerId, &Layer)>

Iterate layers and their IDs in registration order.

pub fn rules(&self) -> impl ExactSizeIterator<Item = RuleSpec>

Iterate registered rules in registration order.

pub fn clear_rules(&mut self)

Remove every registered rule, keeping layers and their cached line graphs, so a different rule set can be validated without rebuilding them. Rule IDs restart at zero; IDs from earlier registrations must not be reused.

pub fn add_rule( &mut self, rule: Rule, layer: LayerId, other: Option<LayerId>, ) -> Result<RuleSpec, Error>

Register a rule after validating input families, finite coordinates and FIDs. Unary rules require no secondary layer; binary rules require a distinct one. Rules run in parallel, but reports retain registration order. The returned spec’s id locates this rule’s result with Report::rule.

Errors

Returns input-count, same-layer, unknown-layer, geometry-kind, duplicate-FID or non-finite-coordinate errors. Failed registration does not add a rule.

pub fn register_rule( &mut self, rule: Rule, layer: LayerInput, other: Option<LayerInput>, ) -> Result<RuleSpec, Error>

Validate and commit owned inputs and a rule as one transaction. Layer caches do not depend on registration IDs, so validation work done here is reused after commit.

Errors

Returns arity, same-layer, unknown-layer, geometry-kind, duplicate-FID or coordinate errors before committing any new layer or rule.

pub fn warnings(&self) -> Result<Vec<Warning>, Error>

Validate cached part views and report skipped degenerate parts without running rules.

Errors

Returns duplicate-FID or non-finite-coordinate errors from any registered layer, including layers that are not used by a rule.

pub fn validate(&self) -> Result<Report, Error>

Validate all layers and execute registered rules, reusing cached views. Topology violations are a successful report, not operational errors.

Errors

Returns invalid-layer errors from deferred validation or operational errors encountered while building rule inputs. No partial report is returned.

Trait Implementations

impl Debug for Topology

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

Formats the value using the given formatter.