Skip to main content

A python loading bar to use in terminal applications

Project description

Pyloading

How to install

Just use pip:

$ pip install pyloading-bar==0.0.2

How to use

For now pyloading_bar is a very simple package to draw a simple progress bar in the terminal:

There's two versions of the bar. The Bar (most simple version of the bar):

from pyloading_bar import Bar

number_of_steps = 2
bar = Bar(number_of_steps)
# do something
bar.next()
# do something
bar.next()

The usual bar is like this:
[##########]

And the RangeBar, this object is created to be used just like an interator on the for loop:

from pyloading_bar import RangeBar

for i in RangeBar(10):
  print(i)

You can chage the bar by the symbol parameter:

from pyloading_bar import RangeBar
  
number_of_steps = 10
for step in RangeBar(number_of_steps, symbol='@'):
  print(step)

now the bar look like this:
[@@@@@@@@@@]

or a full string and it'll iterate thru the string to display inner steps:

from pyloading_bar import RangeBar
  
number_of_steps = 10
for step in RangeBar(number_of_steps, symbol='▁▂▃▄▅▆▇█'):
  print(step)

now the bar look like this:
[█▇ ]

if you want to change the walls of the bar, you can use the template parameter: with the template you MUST use some char at the begining and at the end of the bar.

from pyloading_bar import RangeBar
  
number_of_steps = 10
for step in RangeBar(number_of_steps, template='|▁▂▃▄▅▆▇█|'):
  print(step)

now the bar look like this:
|█▇ |

And if you want that the terminal don't update the last line with the new progress bar state (the progress bar assume by default that you don't print anything to the terminal), just say to the progress bar print a new line to each step:

from pyloading_bar import Bar

# The paramenter "symbol" change the character used into the loading bar
number_of_steps = 10
for step in RangeBar(number_of_steps, symbol='@', update_terminal=False):
  print(step)

Contributors

Made with contrib.rocks.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

pyloading_bar-0.0.2-py3-none-any.whl (7.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page