GitHub - ManrajGrover/halo: Beautiful terminal spinners in Python
source link: https://github.com/ManrajGrover/halo
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
Beautiful spinners for terminal, IPython and Jupyter
Install
$ pip install halo
Usage
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()
Halo([text|text_color|spinner|animation|placement|color|interval|stream|enabled])
text
Type: str
Text shown along with spinner.
text_color
Type: str
Values: grey
, red
, green
, yellow
, blue
, magenta
, cyan
, white
Color of the spinner text. Defaults to None
.
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.
animation
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.
placement
Type: str
Values: left
, right
Which side of the text the spinner should be displayed. Defaults to left
color
Type: str
Values: grey
, red
, green
, yellow
, blue
, magenta
, cyan
, white
Color of the spinner. Defaults to cyan
.
interval
Type: float
Interval between each frame. Defaults to spinner interval (recommended).
stream
Type: file
Stream to write the output. Defaults to sys.stdout
.
enabled
Type: bool
Enable or disable the spinner. Defaults to True
.
Methods
Following are the methods available:
spinner.start([text])
Starts the spinner. If text
is passed, it is set as spinner text. Returns the instance.
spinner.stop()
Stops and clears the spinner. Returns the instance.
spinner.clear()
Clears the spinner. Returns the instance.
spinner.render()
Manually renders a new frame. Returns the instance.
spinner.frame()
Returns next frame to be rendered.
spinner.succeed([text])
text
: Type: str
Stops the spinner and changes symbol to ✔
. If text is provided, it is persisted else current text is persisted. Returns the instance.
spinner.fail([text])
text
: Type: str
Stops the spinner and changes symbol to ✖
. If text is provided, it is persisted else current text is persisted. Returns the instance.
spinner.warn([text])
text
: Type: str
Stops the spinner and changes symbol to ⚠
. If text is provided, it is persisted else current text is persisted. Returns the instance.
spinner.info([text])
text
: Type: str
Stops the spinner and changes symbol to ℹ
. If text is provided, it is persisted else current text is persisted. Returns the instance.
spinner.stop_and_persist([symbol|text])
Stops the spinner and changes symbol and text. Returns the instance.
symbol
Type: str
Symbol to replace the spinner with. Defaults to ' '
.
text
Type: str
Text to be persisted. Defaults to instance text.
spinner.text
Change the text of spinner.
spinner.color
Change the color of spinner
spinner.spinner
Change the spinner itself.
spinner.enabled
Enable or disable the spinner.
How to contribute?
Please see Contributing guidelines for more information.
Like it?
this repo to show support. Let me know you liked it on Twitter. Also, share the project.
Related
- py-spinners - Spinners in Python
- py-log-symbols - Log Symbols in Python
- ora - Elegant terminal spinners in JavaScript (inspiration behind this project)
License
MIT © Manraj Singh
Recommend
-
37
epic-spinners Easy to use css spinners collection with Vue3.js integration. Developed by Epicmax.
-
18
-
48
GitHub is where people build software. More than 28 million people use GitHub to discover, fork, and contribute to over 85 million projects.
-
41
A phenomenon we are seeing more of lately is flickering spinners. A brief splash of something spinning flashing before your eyes. Somehow you know it’s a spinner but you cannot make out the details. What just happened?
-
31
To make your web projects more interactive and user-friendly, you may find you want to add some additional features like notifications, or a spinner that shows a loading state. Today we are going to explore how w...
-
43
Practice your Node.js-terminal skills by building your own CLI spinners
-
22
Make your CLI tools more fun to use, with colorful spinners C...
-
2
Issues · manrajgrover/algorithms-js · GitHub Clear current search query, filters, and sorts Author...
-
3
Spinners collection A general situation that we all might face while going through websites/apps is to wait for some progress or something to get loaded. A most simple solution in such scenarios is to use a l...
-
8
We may earn a commission for purchases using our links. Learn more. Best Salad Spinners in 2022
About Joyk
Aggregate valuable and interesting links.
Joyk means Joy of geeK