Enum SchemaTreeObject 

pub enum SchemaTreeObject {
    SingleLeaf {
        file_schema_id: ObjectId,
    },
    Directory {
        entries: Vec<(String, SchemaTreeEntry)>,
    },
}

An inner node of the project schema Merkle tree.

A SchemaTreeObject::Directory holds named entries sorted lexicographically by name so two directories with the same (name, entry) set hash to the same ObjectId regardless of how they were constructed. A SchemaTreeObject::SingleLeaf is a nameless wrapper over a single FileSchemaObject, produced by crate::tree::store_schema_as_tree when a caller needs to store a flat panproto_schema::Schema under the tree-based commit model. Keeping the two shapes as distinct variants of the object itself (rather than a name slot alongside a SingleLeaf entry) means a peer cannot forge a (name="x", SingleLeaf(id)) entry that walks identically to the canonical form but hashes differently.

Variants

SingleLeaf

Nameless wrapper around a single file schema.

Fields

file_schema_id: ObjectId

ObjectId of the wrapped FileSchemaObject.

Directory

Directory node holding named child entries.

Fields

entries: Vec<(String, SchemaTreeEntry)>

Child entries, canonically sorted lexicographically by name.

Callers consuming a deserialized Directory should iterate via SchemaTreeObject::sorted_entries to enforce the canonical ordering regardless of how the bytes arrived on the wire.

Implementations

impl SchemaTreeObject

pub fn sorted_entries(&self) -> Vec<(&str, &SchemaTreeEntry)>

Return a canonically ordered view of a directory’s entries, or an empty vector for a SchemaTreeObject::SingleLeaf.

Entries are sorted lexicographically by name. Use this anywhere the flat-schema hash or walk order is observable, so a remote cannot produce different flat hashes for the same tree ObjectId by permuting wire-order.

Trait Implementations

impl Clone for SchemaTreeObject

fn clone(&self) -> SchemaTreeObject

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SchemaTreeObject

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SchemaTreeObject

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SchemaTreeObject

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.