Struct MergedTree 

pub struct MergedTree { /* private fields */ }

Presents a view of a merged set of trees at the root directory. In the future, this may store additional metadata like conflict labels, so tree IDs should be compared instead when checking for file changes.

Implementations

impl MergedTree

pub fn resolved(store: Arc<Store>, tree_id: TreeId) -> Self

Creates a MergedTree with the given resolved tree ID.

pub fn new(store: Arc<Store>, tree_ids: Merge<TreeId>) -> Self

Creates a MergedTree with the given tree IDs.

pub fn store(&self) -> &Arc<Store>

The Store associated with this tree.

pub fn tree_ids(&self) -> &Merge<TreeId>

The underlying tree IDs for this MergedTree. If there are file changes between two trees, then the tree IDs will be different.

pub fn into_tree_ids(self) -> Merge<TreeId>

Extracts the underlying tree IDs for this MergedTree.

pub fn trees(&self) -> BackendResult<Merge<Tree>>

Reads the merge of tree objects represented by this MergedTree.

pub async fn trees_async(&self) -> BackendResult<Merge<Tree>>

Async version of trees().

pub async fn resolve(self) -> BackendResult<Self>

Tries to resolve any conflicts, resolving any conflicts that can be automatically resolved and leaving the rest unresolved.

pub fn conflicts( &self, ) -> impl Iterator<Item = (RepoPathBuf, BackendResult<MergedTreeValue>)> + use<>

An iterator over the conflicts in this tree, including subtrees. Recurses into subtrees and yields conflicts in those, but only if all sides are trees, so tree/file conflicts will be reported as a single conflict, not one for each path in the tree.

pub fn has_conflict(&self) -> bool

Whether this tree has conflicts.

pub fn path_value(&self, path: &RepoPath) -> BackendResult<MergedTreeValue>

The value at the given path. The value can be Resolved even if self is a Conflict, which happens if the value at the path can be trivially merged.

pub async fn path_value_async( &self, path: &RepoPath, ) -> BackendResult<MergedTreeValue>

Async version of path_value().

pub fn entries(&self) -> TreeEntriesIterator<'static>

Iterator over the entries matching the given matcher. Subtrees are visited recursively. Subtrees that differ between the current MergedTree’s terms are merged on the fly. Missing terms are treated as empty directories. Subtrees that conflict with non-trees are not visited. For example, if current tree is a merge of 3 trees, and the entry for ‘foo’ is a conflict between a change subtree and a symlink (i.e. the subdirectory was replaced by symlink in one side of the conflict), then the entry for foo itself will be emitted, but no entries from inside foo/ from either of the trees will be.

pub fn entries_matching<'matcher>( &self, matcher: &'matcher dyn Matcher, ) -> TreeEntriesIterator<'matcher>

Like entries() but restricted by a matcher.

pub fn diff_stream<'matcher>( &self, other: &Self, matcher: &'matcher dyn Matcher, ) -> TreeDiffStream<'matcher>

Stream of the differences between this tree and another tree.

pub fn diff_stream_for_file_system<'matcher>( &self, other: &Self, matcher: &'matcher dyn Matcher, ) -> TreeDiffStream<'matcher>

Like diff_stream() but files in a removed tree will be returned before a file that replaces it.

pub fn diff_stream_with_copies<'a>( &self, other: &Self, matcher: &'a dyn Matcher, copy_records: &'a CopyRecords, ) -> BoxStream<'a, CopiesTreeDiffEntry>

Like diff_stream() but takes the given copy records into account.

pub async fn merge(self, base: Self, other: Self) -> BackendResult<Self>

Merges this tree with other, using base as base. Any conflicts will be resolved recursively if possible.

pub fn merge_no_resolve(self, base: Self, other: Self) -> Self

Merges this tree with other, using base as base, without attempting to resolve file conflicts.

Trait Implementations

impl Clone for MergedTree

fn clone(&self) -> MergedTree

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MergedTree

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

Formats the value using the given formatter.