Beautiful spinners for terminal, IPython and Jupyter
$ pip install halo
from halo import Halo
spinner = Halo(text='Loading', spinner='dots')
spinner.start()
# Run time consuming work here
# You can also change properties for spinner as and when you want
spinner.stop()
Alternatively, you can use halo with Python's with
statement:
from halo import Halo
with Halo(text='Loading', spinner='dots'):
# Run time consuming work here
Finally, you can use halo as a decorator:
from halo import Halo
@Halo(text='Loading', spinner='dots')
def long_running_function():
# Run time consuming work here
pass
long_running_function()
Type: str
Text shown along with spinner.
Type: str|dict
If string, it should be one of the spinners listed in the given json file. If a dict is passed, it should define interval
and frames
. Something like:
{
'interval': 100,
'frames': ['-', '+', '*', '+', '-']
}
Defaults to dots
spinner. For Windows users, it defaults to line
spinner.
Type: str
Values: bounce
, marquee
Animation to apply to the text if it's too large and doesn't fit in the terminal. If no animation is defined, the text will be ellipsed.
Type: str
Values: left
, right
Which side of the text the spinner should be displayed. Defaults to left
Type: str
Values: grey
, red
, green
, yellow
, blue
, magenta
, cyan
, white
Color of the spinner. Defaults to cyan
.
Type: float
Interval between each frame. Defaults to spinner interval (recommended).
Type: file
Stream to write the output. Defaults to sys.stdout
.
Type: bool
Enable or disable the spinner. Defaults to True
.
Following are the methods available:
Starts the spinner. If text
is passed, it is set as spinner text. Returns the instance.
Stops and clears the spinner. Returns the instance.
Clears the spinner. Returns the instance.
Manually renders a new frame. Returns the instance.
Returns next frame to be rendered.
Stops the spinner and changes symbol to ✔
. If text is provided, it is persisted else current text is persisted. Returns the instance.
Stops the spinner and changes symbol to ✖
. If text is provided, it is persisted else current text is persisted. Returns the instance.
Stops the spinner and changes symbol to âš
. If text is provided, it is persisted else current text is persisted. Returns the instance.
Stops the spinner and changes symbol to ℹ
. If text is provided, it is persisted else current text is persisted. Returns the instance.
Stops the spinner and changes symbol and text. Returns the instance.
Type: str
Symbol to replace the spinner with. Defaults to ' '
.
Type: str
Text to be persisted. Defaults to instance text.
Change the text of spinner.
Change the color of spinner
Change the spinner itself.
Please see Contributing guidelines for more information.
🌟 this repo to show support. Let me know you liked it on Twitter. Also, share the project.
- py-spinners - Spinners in Python
- py-log-symbols - Log Symbols in Python
- ora - Elegant terminal spinners in JavaScript (inspiration behind this project)
MIT © Manraj Singh