README

Spinner - your task is running

🇺🇦 🏵️ PHP Console Spinner

Old version 0.55.0 is available in branch 0.55.x

New version 1.0.0

‼️ 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

composer require alecrabbit/php-console-spinner

Quick start (asynchronous)

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

Why?

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

Features

See Features and limitations for more details

"Zero" dependencies

"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"
    },

alecrabbit / php-console-spinner

Maintainers

Details