Yaspin provides a full-featured terminal spinner to show the progress during long-hanging operations.

It is easy to integrate into existing codebase by using it as a context manager or as a function decorator:

import time
from yaspin import yaspin

# Context manager:
with yaspin():
    time.sleep(3)  # time consuming code

# Function decorator:
@yaspin(text="Loading...")
def some_operations():
    time.sleep(3)  # time consuming code

some_operations()

Yaspin also provides an intuitive and powerful API. For example, you can easily summon a shark:

import time
from yaspin import yaspin

with yaspin().white.bold.shark.on_blue as sp:
    sp.text = "White bold shark in a blue sea"
    time.sleep(5)

Features

• Runs at all major CPython versions (3.10, 3.11, 3.12, 3.13, 3.14), PyPy
• Supports all (70+) spinners from cli-spinners
• Supports all colors, highlights, attributes and their mixes from termcolor library
• Easy to combine with other command-line libraries, e.g. prompt-toolkit
• Flexible API, easy to integrate with existing code
• User-friendly API for handling POSIX signals
• Safe pipes and redirects:

$ python script_that_uses_yaspin.py > script.log
$ python script_that_uses_yaspin.py | grep ERROR