Struct TreeBuilder 

pub struct TreeBuilder { /* private fields */ }

Builds a single tree level: deduplicates entries by name and emits them in Git’s canonical order so the written object is byte-identical to Git’s.

Start from TreeBuilder::new (empty) or TreeBuilder::from_tree (edit an existing level), upsert entries, then build / write.

Implementations

impl TreeBuilder

pub fn new() -> Self

pub fn from_tree(tree: Tree) -> Self

Seed the builder with an existing tree level’s entries.

pub fn upsert( &mut self, name: impl Into<BString>, kind: EntryKind, oid: ObjectId, )

Insert or replace the entry named name with one of Git’s canonical kinds.

pub fn upsert_raw(&mut self, name: impl Into<BString>, mode: u32, oid: ObjectId)

Insert or replace using a raw mode (for round-tripping non-canonical modes); prefer upsert for normal entries.

pub fn remove(&mut self, name: &[u8]) -> bool

Remove the entry named name, returning whether one was present.

pub fn is_empty(&self) -> bool

pub fn len(&self) -> usize

pub fn build(self) -> Tree

Collect into a Tree with entries in Git’s canonical order.

pub fn write(self) -> Vec<u8>

The canonical serialized tree body.

pub fn object_id(self, format: ObjectFormat) -> Result<ObjectId>

The OID this tree will have once written.

Trait Implementations

impl Clone for TreeBuilder

fn clone(&self) -> TreeBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TreeBuilder

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

Formats the value using the given formatter.

impl Default for TreeBuilder

fn default() -> TreeBuilder

Returns the “default value” for a type.