A Python port of the `cli-spinners` Node.js library, this package provides access to over 60 different terminal spinner definitions. Each definition includes the animation frames and the recommended interval between frames. It serves as a data source for spinner designs rather than a full-featured spinning utility. For more advanced usage, such as animating spinners with context managers or decorators, other libraries like `halo` or `yaspin` are often recommended as wrappers. The current version is 0.0.24, released in February 2020. [1, 2, 6]
pip install spinnersVerified import paths — ran on the pinned version, not inferred.
This quickstart demonstrates how to import the `Spinners` Enum and access the raw frame sequences and intervals for a specific spinner. It then provides a basic, manual loop to illustrate how this data can be used to animate a spinner in the terminal. It's important to note that this library only provides the spinner definitions; the animation logic itself needs to be implemented by the user or by using a wrapper library.
To animate spinners, users must implement custom display logic using the `Spinners.<name>.value` data (as shown in the quickstart), or integrate with more feature-rich wrapper libraries like `halo` or `yaspin`, which offer high-level APIs for terminal spinners. [2, 8]
For projects requiring ongoing support, more advanced features (e.g., text, colors, context managers), and active development, consider using `halo` or `yaspin`. These libraries often build upon similar spinner data but provide a comprehensive API for terminal interaction. [1, 2, 8]
No dependency data recorded yet.