Struct ProgressBar 

pub struct ProgressBar { /* private fields */ }

A thread safe, thread stable progress bar, abstracted for any frontend

Implementations

impl ProgressBar

pub fn custom<F>(&self, f: F)

where F: FnOnce() + Send + 'static,

Runs a custom closure for this progress bar.

Panics

Panics if the internal GLOBAL_SENDER thread cannot be communicated with. This usually signals critical failure somewhere

Notes

If the input closure panics, it will not kill the thread, it will instead log the error and return

pub fn flush(&self)

Waits until the flush is processed, allowing you to wait until all previous events have been processed

Panics

Panics if the internal GLOBAL_SENDER thread cannot be communicated with. This usually signals critical failure somewhere

pub fn increment(&self)

Increments the value of a progress bar by 1

Panics

Panics if the internal GLOBAL_SENDER thread cannot be communicated with. This usually signals critical failure somewhere

pub fn increment_and_run<P, Q>(&self, pre: Option<P>, post: Option<Q>)

where P: FnOnce() + Send + 'static, Q: FnOnce() + Send + 'static,

Increments the value of the progress bar by 1 and runs a pre-write and post-write closure

The pre closure, if some, will run before the value is incremented The post closure, if some, will run after the value is incremented, and before ProgressRenderer::on_update() method is run

Panics

Panics if the internal GLOBAL_SENDER thread cannot be communicated with. This usually signals critical failure somewhere

pub fn set_max(&self, max: usize)

Sets the max-value of the progress bar

Panics

Panics if the internal GLOBAL_SENDER thread cannot be communicated with. This usually signals critical failure somewhere

pub fn set_max_and_run<P, Q>(&self, max: usize, pre: Option<P>, post: Option<Q>)

where P: FnOnce() + Send + 'static, Q: FnOnce() + Send + 'static,

Sets the max-value of the progress bar and runs a pre-write and post-write closure

The pre closure, if some, will run before the value is incremented The post closure, if some, will run after the value is incremented, and before ProgressRenderer::on_update() method is run

Panics

Panics if the internal GLOBAL_SENDER thread cannot be communicated with. This usually signals critical failure somewhere

Notes

If the any of the input closures panic, it will not kill the thread, it will instead log the error and ignore it

pub fn set_value(&self, value: usize)

Sets the value of the progress bar

Panics

Panics if the internal GLOBAL_SENDER thread cannot be communicated with. This usually signals critical failure somewhere

pub fn set_value_and_run<P, Q>( &self, value: usize, pre: Option<P>, post: Option<Q>, )

where P: FnOnce() + Send + 'static, Q: FnOnce() + Send + 'static,

Sets the value of the progress bar and runs a pre-write and post-write closure

The pre closure, if some, will run before the value is incremented The post closure, if some, will run after the value is incremented, and before ProgressRenderer::on_update() method is run

Panics

Panics if the internal GLOBAL_SENDER thread cannot be communicated with. This usually signals critical failure somewhere

Notes

If the any of the input closures panic, it will not kill the thread, it will instead log the error and ignore it

pub fn start( value: usize, max: usize, renderer: Arc<dyn ProgressRenderer>, ) -> Self

Creates a new progress bar instance using the renderer

This progress bar can safely be shared and updated between threads

Trait Implementations

impl Clone for ProgressBar

fn clone(&self) -> ProgressBar

Returns a duplicate of the value.

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

Performs copy-assignment from source.