123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424 |
- // Simple console progress bars
- package pb
- import (
- "fmt"
- "io"
- "math"
- "strings"
- "sync"
- "sync/atomic"
- "time"
- "unicode/utf8"
- )
- // Current version
- const Version = "1.0.1"
- const (
- // Default refresh rate - 200ms
- DEFAULT_REFRESH_RATE = time.Millisecond * 200
- FORMAT = "[=>-]"
- )
- // DEPRECATED
- // variables for backward compatibility, from now do not work
- // use pb.Format and pb.SetRefreshRate
- var (
- DefaultRefreshRate = DEFAULT_REFRESH_RATE
- BarStart, BarEnd, Empty, Current, CurrentN string
- )
- // Create new progress bar object
- func New(total int) *ProgressBar {
- return New64(int64(total))
- }
- // Create new progress bar object using int64 as total
- func New64(total int64) *ProgressBar {
- pb := &ProgressBar{
- Total: total,
- RefreshRate: DEFAULT_REFRESH_RATE,
- ShowPercent: true,
- ShowCounters: true,
- ShowBar: true,
- ShowTimeLeft: true,
- ShowFinalTime: true,
- Units: U_NO,
- ManualUpdate: false,
- finish: make(chan struct{}),
- currentValue: -1,
- mu: new(sync.Mutex),
- }
- return pb.Format(FORMAT)
- }
- // Create new object and start
- func StartNew(total int) *ProgressBar {
- return New(total).Start()
- }
- // Callback for custom output
- // For example:
- // bar.Callback = func(s string) {
- // mySuperPrint(s)
- // }
- //
- type Callback func(out string)
- type ProgressBar struct {
- current int64 // current must be first member of struct (https://code.google.com/p/go/issues/detail?id=5278)
- Total int64
- RefreshRate time.Duration
- ShowPercent, ShowCounters bool
- ShowSpeed, ShowTimeLeft, ShowBar bool
- ShowFinalTime bool
- Output io.Writer
- Callback Callback
- NotPrint bool
- Units Units
- Width int
- ForceWidth bool
- ManualUpdate bool
- // Default width for the time box.
- UnitsWidth int
- TimeBoxWidth int
- finishOnce sync.Once //Guards isFinish
- finish chan struct{}
- isFinish bool
- startTime time.Time
- startValue int64
- currentValue int64
- prefix, postfix string
- mu *sync.Mutex
- lastPrint string
- BarStart string
- BarEnd string
- Empty string
- Current string
- CurrentN string
- AlwaysUpdate bool
- }
- // Start print
- func (pb *ProgressBar) Start() *ProgressBar {
- pb.startTime = time.Now()
- pb.startValue = pb.current
- if pb.Total == 0 {
- pb.ShowTimeLeft = false
- pb.ShowPercent = false
- }
- if !pb.ManualUpdate {
- pb.Update() // Initial printing of the bar before running the bar refresher.
- go pb.refresher()
- }
- return pb
- }
- // Increment current value
- func (pb *ProgressBar) Increment() int {
- return pb.Add(1)
- }
- // Set current value
- func (pb *ProgressBar) Set(current int) *ProgressBar {
- return pb.Set64(int64(current))
- }
- // Set64 sets the current value as int64
- func (pb *ProgressBar) Set64(current int64) *ProgressBar {
- atomic.StoreInt64(&pb.current, current)
- return pb
- }
- // Add to current value
- func (pb *ProgressBar) Add(add int) int {
- return int(pb.Add64(int64(add)))
- }
- func (pb *ProgressBar) Add64(add int64) int64 {
- return atomic.AddInt64(&pb.current, add)
- }
- // Set prefix string
- func (pb *ProgressBar) Prefix(prefix string) *ProgressBar {
- pb.prefix = prefix
- return pb
- }
- // Set postfix string
- func (pb *ProgressBar) Postfix(postfix string) *ProgressBar {
- pb.postfix = postfix
- return pb
- }
- // Set custom format for bar
- // Example: bar.Format("[=>_]")
- // Example: bar.Format("[\x00=\x00>\x00-\x00]") // \x00 is the delimiter
- func (pb *ProgressBar) Format(format string) *ProgressBar {
- var formatEntries []string
- if len(format) == 5 {
- formatEntries = strings.Split(format, "")
- } else {
- formatEntries = strings.Split(format, "\x00")
- }
- if len(formatEntries) == 5 {
- pb.BarStart = formatEntries[0]
- pb.BarEnd = formatEntries[4]
- pb.Empty = formatEntries[3]
- pb.Current = formatEntries[1]
- pb.CurrentN = formatEntries[2]
- }
- return pb
- }
- // Set bar refresh rate
- func (pb *ProgressBar) SetRefreshRate(rate time.Duration) *ProgressBar {
- pb.RefreshRate = rate
- return pb
- }
- // Set units
- // bar.SetUnits(U_NO) - by default
- // bar.SetUnits(U_BYTES) - for Mb, Kb, etc
- func (pb *ProgressBar) SetUnits(units Units) *ProgressBar {
- pb.Units = units
- return pb
- }
- // Set max width, if width is bigger than terminal width, will be ignored
- func (pb *ProgressBar) SetMaxWidth(width int) *ProgressBar {
- pb.Width = width
- pb.ForceWidth = false
- return pb
- }
- // Set bar width
- func (pb *ProgressBar) SetWidth(width int) *ProgressBar {
- pb.Width = width
- pb.ForceWidth = true
- return pb
- }
- // End print
- func (pb *ProgressBar) Finish() {
- //Protect multiple calls
- pb.finishOnce.Do(func() {
- close(pb.finish)
- pb.write(atomic.LoadInt64(&pb.current))
- if !pb.NotPrint {
- fmt.Println()
- }
- pb.isFinish = true
- })
- }
- // End print and write string 'str'
- func (pb *ProgressBar) FinishPrint(str string) {
- pb.Finish()
- fmt.Println(str)
- }
- // implement io.Writer
- func (pb *ProgressBar) Write(p []byte) (n int, err error) {
- n = len(p)
- pb.Add(n)
- return
- }
- // implement io.Reader
- func (pb *ProgressBar) Read(p []byte) (n int, err error) {
- n = len(p)
- pb.Add(n)
- return
- }
- // Create new proxy reader over bar
- func (pb *ProgressBar) NewProxyReader(r io.Reader) *Reader {
- return &Reader{r, pb}
- }
- func (pb *ProgressBar) write(current int64) {
- width := pb.GetWidth()
- var percentBox, countersBox, timeLeftBox, speedBox, barBox, end, out string
- // percents
- if pb.ShowPercent {
- var percent float64
- if pb.Total > 0 {
- percent = float64(current) / (float64(pb.Total) / float64(100))
- } else {
- percent = float64(current) / float64(100)
- }
- percentBox = fmt.Sprintf(" %6.02f%%", percent)
- }
- // counters
- if pb.ShowCounters {
- current := Format(current).To(pb.Units).Width(pb.UnitsWidth)
- if pb.Total > 0 {
- total := Format(pb.Total).To(pb.Units).Width(pb.UnitsWidth)
- countersBox = fmt.Sprintf(" %s / %s ", current, total)
- } else {
- countersBox = fmt.Sprintf(" %s / ? ", current)
- }
- }
- // time left
- fromStart := time.Now().Sub(pb.startTime)
- currentFromStart := current - pb.startValue
- select {
- case <-pb.finish:
- if pb.ShowFinalTime {
- var left time.Duration
- if pb.Total > 0 {
- left = (fromStart / time.Second) * time.Second
- } else {
- left = (time.Duration(currentFromStart) / time.Second) * time.Second
- }
- timeLeftBox = left.String()
- }
- default:
- if pb.ShowTimeLeft && currentFromStart > 0 {
- perEntry := fromStart / time.Duration(currentFromStart)
- var left time.Duration
- if pb.Total > 0 {
- left = time.Duration(pb.Total-currentFromStart) * perEntry
- left = (left / time.Second) * time.Second
- } else {
- left = time.Duration(currentFromStart) * perEntry
- left = (left / time.Second) * time.Second
- }
- timeLeft := Format(int64(left)).To(U_DURATION).String()
- timeLeftBox = fmt.Sprintf(" %s", timeLeft)
- }
- }
- if len(timeLeftBox) < pb.TimeBoxWidth {
- timeLeftBox = fmt.Sprintf("%s%s", strings.Repeat(" ", pb.TimeBoxWidth-len(timeLeftBox)), timeLeftBox)
- }
- // speed
- if pb.ShowSpeed && currentFromStart > 0 {
- fromStart := time.Now().Sub(pb.startTime)
- speed := float64(currentFromStart) / (float64(fromStart) / float64(time.Second))
- speedBox = " " + Format(int64(speed)).To(pb.Units).Width(pb.UnitsWidth).PerSec().String()
- }
- barWidth := escapeAwareRuneCountInString(countersBox + pb.BarStart + pb.BarEnd + percentBox + timeLeftBox + speedBox + pb.prefix + pb.postfix)
- // bar
- if pb.ShowBar {
- size := width - barWidth
- if size > 0 {
- if pb.Total > 0 {
- curCount := int(math.Ceil((float64(current) / float64(pb.Total)) * float64(size)))
- emptCount := size - curCount
- barBox = pb.BarStart
- if emptCount < 0 {
- emptCount = 0
- }
- if curCount > size {
- curCount = size
- }
- if emptCount <= 0 {
- barBox += strings.Repeat(pb.Current, curCount)
- } else if curCount > 0 {
- barBox += strings.Repeat(pb.Current, curCount-1) + pb.CurrentN
- }
- barBox += strings.Repeat(pb.Empty, emptCount) + pb.BarEnd
- } else {
- barBox = pb.BarStart
- pos := size - int(current)%int(size)
- if pos-1 > 0 {
- barBox += strings.Repeat(pb.Empty, pos-1)
- }
- barBox += pb.Current
- if size-pos-1 > 0 {
- barBox += strings.Repeat(pb.Empty, size-pos-1)
- }
- barBox += pb.BarEnd
- }
- }
- }
- // check len
- out = pb.prefix + countersBox + barBox + percentBox + speedBox + timeLeftBox + pb.postfix
- if escapeAwareRuneCountInString(out) < width {
- end = strings.Repeat(" ", width-utf8.RuneCountInString(out))
- }
- // and print!
- pb.mu.Lock()
- pb.lastPrint = out + end
- pb.mu.Unlock()
- switch {
- case pb.isFinish:
- return
- case pb.Output != nil:
- fmt.Fprint(pb.Output, "\r"+out+end)
- case pb.Callback != nil:
- pb.Callback(out + end)
- case !pb.NotPrint:
- fmt.Print("\r" + out + end)
- }
- }
- // GetTerminalWidth - returns terminal width for all platforms.
- func GetTerminalWidth() (int, error) {
- return terminalWidth()
- }
- func (pb *ProgressBar) GetWidth() int {
- if pb.ForceWidth {
- return pb.Width
- }
- width := pb.Width
- termWidth, _ := terminalWidth()
- if width == 0 || termWidth <= width {
- width = termWidth
- }
- return width
- }
- // Write the current state of the progressbar
- func (pb *ProgressBar) Update() {
- c := atomic.LoadInt64(&pb.current)
- if pb.AlwaysUpdate || c != pb.currentValue {
- pb.write(c)
- pb.currentValue = c
- }
- }
- func (pb *ProgressBar) String() string {
- return pb.lastPrint
- }
- // Internal loop for refreshing the progressbar
- func (pb *ProgressBar) refresher() {
- for {
- select {
- case <-pb.finish:
- return
- case <-time.After(pb.RefreshRate):
- pb.Update()
- }
- }
- }
- type window struct {
- Row uint16
- Col uint16
- Xpixel uint16
- Ypixel uint16
- }
|