Struct EntityBuilder 

pub struct EntityBuilder<'a> { /* private fields */ }

A partially-specified entity, checked against the schema on build.

Implementations

impl<'a> EntityBuilder<'a>

pub fn new(schema: &'a Schema, entity: impl Into<String>) -> Self

Start building entity, whose type must be declared by schema.

The type is not checked here: an unknown type is reported by build, so that a caller assembling several entities gets every failure at the same point in its code rather than some at construction and some later.

pub fn set(self, attribute: impl Into<String>, value: Value) -> Self

Set one attribute by its declared name.

Names are matched case-insensitively, because EXPRESS declares GlobalId while STEP files and much prose write GLOBALID.

pub fn text( self, attribute: impl Into<String>, text: impl Into<Arc<str>>, ) -> Self

Set a text attribute.

pub fn real(self, attribute: impl Into<String>, value: f64) -> Self

Set a real-valued attribute.

pub fn reference(self, attribute: impl Into<String>, id: EntityId) -> Self

Set an entity-reference attribute.

pub fn enumeration( self, attribute: impl Into<String>, constant: impl Into<Arc<str>>, ) -> Self

Set an enumeration attribute (written .PLAN_VIEW. in STEP).

impl EntityBuilder<'_>

pub fn build(self) -> AuthorResult<Entity>

Resolve every named attribute to its STEP slot and produce the entity.

Errors

Refuses an unknown entity type, an attribute the schema does not declare, an attribute set twice, a required attribute left unset, a scalar/aggregate confusion, a value whose shape contradicts the declared type, and a malformed GlobalId.

pub fn insert(self, model: &mut Model) -> AuthorResult<EntityId>

Build the entity and append it to model, returning its new id.

The model is left untouched when construction fails, so a rejected entity cannot leave a half-written record behind.

Errors

Any failure from build.

Trait Implementations

impl<'a> Clone for EntityBuilder<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a> Debug for EntityBuilder<'a>

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

Formats the value using the given formatter.