Logo

Spinner - your task is running

demo

PHP Version Tests Status

Build Status Scrutinizer Code Quality Code Coverage

Latest Stable Version Packagist Pre Release Version Latest Unstable Version

License

Old version 0.55.0 is available in branch 0.55.x

• !!️ ATTENTION !!️ Documentation is a bit clumsy at the moment and CAN BE MISLEADING

• WIP
• !!️ API is subject to change until 1.0.0-BETA.0
• is intended to be used with event loop (see limitations)

• Installation
• Quick start
• Why?
• How does it work?
• Usage
• Features
• Known issues
• Development
• Links

composer require alecrabbit/php-console-spinner

use AlecRabbit\Spinner\Facade;
// ...
$spinner = Facade::createSpinner();
// that's basically it :)

Fully working examples can be found in example directory

For more information see Usage

Main purpose of this library is to provide a simple way to show spinner in console applications (mainly long-running ones). Spinner could be an indicator of running task. For more information see Features and Examples.

alecrabbit/php-console-spinner-extras library provides additional components to extend functionality:

• show progress of running task
• messages of some sort, like status messages
• additional spinners

See Features and limitations for more details

"Zero" dependencies mode means that the library does not require any additional dependencies to work. The only exception is psr/container. That's why zero is in quotes.

 "require": {
 "php": ">=8.2",
 "psr/container": "^2.0"
 },

• Inspired by sindresorhus/cli-spinners