Struct git_repository::progress::tree::Root

pub struct Root { /* private fields */ }

Available on crate feature progress-tree only.

The top-level of the progress tree.

Implementations

impl Root

pub fn new() -> Arc<Root>

Create a new tree with default configuration.

As opposed to Item instances, this type can be closed and sent safely across threads.

pub fn messages_capacity(&self) -> usize

Returns the maximum amount of messages we can keep before overwriting older ones.

pub fn num_tasks(&self) -> usize

Returns the current amount of Items stored in the tree. Note that this is at most a guess as tasks can be added and removed in parallel.

pub fn add_child(&self, name: impl Into<String>) -> Item

Adds a new child tree::Item, whose parent is this instance, with the given name.

This builds a hierarchy of tree::Items, each having their own progress. Use this method to track progress of your first tasks.

pub fn add_child_with_id(&self, name: impl Into<String>, id: [u8; 4]) -> Item

Adds a new child tree::Item, whose parent is this instance, with the given name and id.

This builds a hierarchy of tree::Items, each having their own progress. Use this method to track progress of your first tasks.

pub fn sorted_snapshot(&self, out: &mut Vec<(Key, Task), Global>)

Copy the entire progress tree into the given out vector, so that it can be traversed from beginning to end in order of hierarchy.

pub fn copy_messages(&self, out: &mut Vec<Message, Global>)

Copy all messages from the internal ring buffer into the given out vector. Messages are ordered from oldest to newest.

pub fn copy_new_messages(
    &self,
    out: &mut Vec<Message, Global>,
    prev: Option<MessageCopyState>
) -> MessageCopyState

Copy only new messages from the internal ring buffer into the given out vector. Messages are ordered from oldest to newest.

pub fn deep_clone(&self) -> Arc<Root>

Duplicate all content and return it.

This is an expensive operation, whereas clone() is not as it is shallow.

Trait Implementations

impl Debug for Root

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

Formats the value using the given formatter.

impl From<Options> for Root

fn from(_: Options) -> Root

Converts to this type from the input type.