Struct MetadataSchemaBuilder 

pub struct MetadataSchemaBuilder { /* private fields */ }

Builder for MetadataSchema.

Its fmt::Debug output uses strict redaction with one cumulative diagnostic budget for the field map and builder state. If that budget is exceeded, Debug displays <redaction incomplete>. A stored build error is represented only by whether an error exists; Self::build returns its original details. Debug output is bounded, but field names are not treated as a confidentiality boundary.

Examples

use qubit_datatype::DataType;
use qubit_metadata::MetadataSchema;

let schema = MetadataSchema::builder()
    .required("tenant", DataType::String)
    .build()?;
assert!(schema.field("tenant").is_some());

Implementations

impl MetadataSchemaBuilder

pub fn required(self, key: &str, data_type: DataType) -> Self

Adds a required field definition.

Parameters

• key - Metadata key to declare.
• data_type - Concrete data type accepted by the field.

Returns

The updated builder.

pub fn optional(self, key: &str, data_type: DataType) -> Self

Adds an optional field definition.

Parameters

• key - Metadata key to declare.
• data_type - Concrete data type accepted by the field.

Returns

The updated builder.

pub fn replace_field(self, key: &str, field: MetadataField) -> Self

Explicitly replaces a field definition.

Parameters

• key - Metadata key to replace.
• field - Replacement definition.

Returns

The updated builder. This is the only declaration method that may overwrite an existing field.

pub fn unknown_metadata_field_policy( self, policy: UnknownMetadataFieldPolicy, ) -> Self

Sets the policy for metadata keys not declared by the schema.

Parameters

• policy - Unknown metadata-field policy to store.

Returns

The updated builder.

pub fn unknown_filter_field_policy( self, policy: UnknownFilterFieldPolicy, ) -> Self

Sets the policy for filter keys not declared by the schema.

Parameters

• policy - Unknown filter-field policy to store.

Returns

The updated builder.

pub fn build(self) -> MetadataResult<MetadataSchema>

Builds the schema.

Returns

The immutable schema described by this builder.

Errors

Returns MetadataError::DuplicateSchemaField when required or optional declare the same key more than once.

Trait Implementations

impl Clone for MetadataSchemaBuilder

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MetadataSchemaBuilder

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

Writes the strict-policy diagnostic representation.

Parameters

• formatter - Formatter receiving the redacted representation.

impl Default for MetadataSchemaBuilder

fn default() -> Self

Returns the “default value” for a type.

impl Eq for MetadataSchemaBuilder

impl PartialEq for MetadataSchemaBuilder

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Redact for MetadataSchemaBuilder

fn write_redacted(&self, writer: &mut RedactionWriter<'_>)

Writes builder fields through one cumulative diagnostic budget.

Parameters

• writer - Redaction writer receiving the builder representation.

impl StructuralPartialEq for MetadataSchemaBuilder