Comment on page
Progressbar
The progress bar printer can be used to display the current progress of an action
progressbar := pterm.DefaultProgressbar.WithTotal(totalSteps).Start()
// Logic here
progressbar.Increment()
// More logic
Name | Type | Description |
---|---|---|
Title | string | Title of the progress bar |
Total | int | Total amount of steps |
Current | int | Current amount of steps |
BarCharacter | string | Character that should be used for the bar filling |
LastCharacter | string | Las character of the progress bar |
ElapsedTimeRoundingFactor | time.Duration | Factor that determines how the time should be rounded (seconds, milliseconds, etc.) |
BarFiller | string | Character that is used when the bar has not yet reached its point |
MaxWidth | int | Maximum width of the progress bar |
ShowElapsedTime | bool | Sets if the elapsed time should be displayed |
ShowCount | bool | Sets if the current and total amount of steps should be displayed |
ShowTitle | bool | Sets if the title should be displayed |
ShowPercentage | bool | Sets if the current percentage should be displayed |
RemoveWhenDone | bool | Sets if the progress bar should be removed when Stop() is called |
TitleStyle | *Style | Style of the title |
BarStyle | *Style | Style of the progress bar itself |
IsActive | bool | True when the progress bar was started but not yet stopped |
Name | Description |
---|---|
Add(count int) | Adds count to the current progress |
GetElapsedTime() | Returns the duration since the progress bar was started |
Increment() | Adds 1 to the current progress - you can call this function when a step is done |
UpdateTitle() | Updates and re-renders the title of the progress bar |
This printer implements the
LivePrinter
interface.Method | Description |
---|---|
Start() | Returns itself and errors |
Stop() | Returns itself and errors |
GenericStart() | Returns the started LivePrinter and errors |
GenericStop() | Returns the stopped LivePrinter and errors |
pkg.go.dev contains the full specification for this printer and more technical descriptions.
Last modified 1yr ago