mpb is a Go lib for rendering progress bars in terminal applications.
- Multiple Bars: Multiple progress bars are supported
- Dynamic Total: Set total while bar is running
- Dynamic Add/Remove: Dynamically add or remove bars
- Cancellation: Cancel whole rendering process
- Predefined Decorators: Elapsed time, ewma based ETA, Percentage, Bytes counter
- Decorator's width sync: Synchronized decorator's width among multiple bars
package main
import (
"math/rand""time""github.com/vbauerster/mpb/v5""github.com/vbauerster/mpb/v5/decor"
)
funcmain() {
// initialize progress container, with custom widthp:=mpb.New(mpb.WithWidth(64))
total:=100name:="Single Bar:"// adding a single bar, which will inherit container's widthbar:=p.AddBar(int64(total),
// override DefaultBarStyle, which is "[=>-]<+"mpb.BarStyle("╢▌▌░╟"),
mpb.PrependDecorators(
// display our name with one space on the rightdecor.Name(name, decor.WC{W: len(name) +1, C: decor.DidentRight}),
// replace ETA decorator with "done" message, OnComplete eventdecor.OnComplete(
decor.AverageETA(decor.ET_STYLE_GO, decor.WC{W: 4}), "done",
),
),
mpb.AppendDecorators(decor.Percentage()),
)
// simulating some workmax:=100*time.Millisecondfori:=0; i<total; i++ {
time.Sleep(time.Duration(rand.Intn(10)+1) *max/10)
bar.Increment()
}
// wait for our bar to complete and flushp.Wait()
}varwg sync.WaitGroup// pass &wg (optional), so p will wait for it eventuallyp:=mpb.New(mpb.WithWaitGroup(&wg))
total, numBars:=100, 3wg.Add(numBars)
fori:=0; i<numBars; i++ {
name:=fmt.Sprintf("Bar#%d:", i)
bar:=p.AddBar(int64(total),
mpb.PrependDecorators(
// simple name decoratordecor.Name(name),
// decor.DSyncWidth bit enables column width synchronizationdecor.Percentage(decor.WCSyncSpace),
),
mpb.AppendDecorators(
// replace ETA decorator with "done" message, OnComplete eventdecor.OnComplete(
// ETA decorator with ewma age of 60decor.EwmaETA(decor.ET_STYLE_GO, 60), "done",
),
),
)
// simulating some workgofunc() {
deferwg.Done()
rng:=rand.New(rand.NewSource(time.Now().UnixNano()))
max:=100*time.Millisecondfori:=0; i<total; i++ {
// start variable is solely for EWMA calculation// EWMA's unit of measure is an iteration's durationstart:=time.Now()
time.Sleep(time.Duration(rng.Intn(10)+1) *max/10)
bar.Increment()
// we need to call DecoratorEwmaUpdate to fulfill ewma decorator's contractbar.DecoratorEwmaUpdate(time.Since(start))
}
}()
}
// Waiting for passed &wg and for all bars to complete and flushp.Wait()
