Struct DoOrDiscard

pub struct DoOrDiscard<T>(/* private fields */);

Available on crate feature progress only.

An implementation of Progress which can be created easily from Option<impl Progress>.

Implementations

impl<T> DoOrDiscard<T>

where T: NestedProgress,

pub fn into_inner(self) -> Option<T>

Obtain either the original NestedProgress implementation or None.

pub fn take(&mut self) -> Option<T>

Take out the implementation of NestedProgress and replace it with Discard.

Trait Implementations

impl<T> Count for DoOrDiscard<T>

where T: Count,

fn set(&self, step: usize)

Set the current progress to the given step. The cost of this call is negligible, making manual throttling not necessary.

fn step(&self) -> usize

Returns the current step, as controlled by inc*(…) calls

fn inc_by(&self, step: usize)

Increment the current progress to the given step. The cost of this call is negligible, making manual throttling not necessary.

fn counter(&self) -> Arc<AtomicUsize>

Return an atomic counter for direct access to the underlying state.

fn inc(&self)

Increment the current progress to the given 1. The cost of this call is negligible, making manual throttling not necessary.

impl<T> From<Option<T>> for DoOrDiscard<T>

where T: NestedProgress,

fn from(p: Option<T>) -> DoOrDiscard<T>

Converts to this type from the input type.

impl<T> NestedProgress for DoOrDiscard<T>

where T: NestedProgress,

type SubProgress = DoOrDiscard<<T as NestedProgress>::SubProgress>

The type of progress returned by [add_child()][Progress::add_child()].

fn add_child( &mut self, name: impl Into<String>, ) -> <DoOrDiscard<T> as NestedProgress>::SubProgress

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

fn add_child_with_id( &mut self, name: impl Into<String>, id: [u8; 4], ) -> <DoOrDiscard<T> as NestedProgress>::SubProgress

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

impl<T> Progress for DoOrDiscard<T>

where T: Progress,

fn init(&mut self, max: Option<usize>, unit: Option<Unit>)

Initialize the Item for receiving progress information.

fn unit(&self) -> Option<Unit>

Returns the (cloned) unit associated with this Progress

fn max(&self) -> Option<usize>

Returns the maximum about of items we expect, as provided with the init(…) call

fn set_max(&mut self, max: Option<usize>) -> Option<usize>

Set the maximum value to max and return the old maximum value.

fn set_name(&mut self, name: String)

Set the name of the instance, altering the value given when crating it with add_child(…) The progress is allowed to discard it.

fn name(&self) -> Option<String>

Get the name of the instance as given when creating it with add_child(…) The progress is allowed to not be named, thus there is no guarantee that a previously set names ‘sticks’.

fn id(&self) -> [u8; 4]

Get a stable identifier for the progress instance. Note that it could be unknown.

fn message(&self, level: MessageLevel, message: String)

Create a message of the given level and store it with the progress tree.

fn info(&self, message: String)

Create a message providing additional information about the progress thus far.

fn done(&self, message: String)

Create a message indicating the task is done successfully

fn fail(&self, message: String)

Create a message indicating the task failed

fn show_throughput(&self, start: Instant)

A shorthand to print throughput information

fn show_throughput_with( &self, start: Instant, step: usize, unit: Unit, level: MessageLevel, )

A shorthand to print throughput information, with the given step and unit, and message level.