qubit-metadata 0.3.3

Type-safe extensible metadata model for the Qubit LLM SDK
Documentation 
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

/*******************************************************************************
 *
 *    Copyright (c) 2025 - 2026.
 *    Haixing Hu, Qubit Co. Ltd.
 *
 *    All rights reserved.
 *
 ******************************************************************************/
//! [`MetadataSchemaBuilder`] — fluent schema construction API.

use std::collections::BTreeMap;

use qubit_common::DataType;

use crate::schema::{MetadataField, MetadataSchema, UnknownFieldPolicy};

/// Builder for [`MetadataSchema`].
#[derive(Debug, Clone, PartialEq, Eq, Default)]
pub struct MetadataSchemaBuilder {
    /// Field definitions being built.
    fields: BTreeMap<String, MetadataField>,
    /// Unknown-field policy copied into the built schema.
    unknown_field_policy: UnknownFieldPolicy,
}

impl MetadataSchemaBuilder {
    /// Adds a required field definition.
    #[inline]
    #[must_use]
    pub fn required(mut self, key: &str, data_type: DataType) -> Self {
        self.fields
            .insert(key.to_string(), MetadataField::new(data_type, true));
        self
    }

    /// Adds an optional field definition.
    #[inline]
    #[must_use]
    pub fn optional(mut self, key: &str, data_type: DataType) -> Self {
        self.fields
            .insert(key.to_string(), MetadataField::new(data_type, false));
        self
    }

    /// Sets the policy for metadata keys not declared by the schema.
    #[inline]
    #[must_use]
    pub fn unknown_field_policy(mut self, policy: UnknownFieldPolicy) -> Self {
        self.unknown_field_policy = policy;
        self
    }

    /// Builds the schema.
    #[inline]
    #[must_use]
    pub fn build(self) -> MetadataSchema {
        MetadataSchema::new(self.fields, self.unknown_field_policy)
    }
}