dashbar

A progress-bar designed to be useful and easy to use.


Keywords
loading-spinner, pip-package, progress-bar
License
MIT
Install
pip install dashbar==2.1

Documentation

dashbar

PyPI - Version Pepy Total Downloads GitHub repo size

A progress-bar designed to be useful and easy to use.

dashbar-demo-preview

Usage

Iterating

To start dashbar, execute the following code:

for i in dashbar.dash(10, dash_type="pipe", desc="example"):
    time.sleep(1/10) #completion after one second
    if i == 5:
        dashbar.status("half-way complete")

If the progress is large, the autodash function can be used, which adjusts the step count to fit the terminal:

for i in dashbar.autodash(10):
    time.sleep(1/10)
    if i == 8:
        dashbar.log("eighty percent complete")

Customizing dashbar

Dashbars can be customized with the following code:

dashbar.customize(element="filler", value=" ")

List of dashbars:

  • classic
  • arrow
  • box
  • circle_charger
  • box_charger
  • striped
  • dollar
  • box_shade
  • pipe
  • heart
  • radioactive
  • benzene
  • custom

List of dashbar elements:

  • start
  • head
  • trail
  • filler
  • finish

Building a Dashbar

Dashbars can be built via the Dashbar class:

bar = dashbar.Dashbar(10, "box_shade")
for i in range(100):
    if i%10 == 0:
        bar.update(1, display=True)
    time.sleep(1/20) #completion after five seconds