dariuszp/cli-progress-bar

Cli progress bar

1.0.5 2018-11-24 20:35 UTC

Requires (Dev)

• phpunit/phpunit: ^7.4

MIT

• Dariusz Półtorak
• Mason Phillips

README

Progress bar for cli apps

Installation

composer require dariuszp/cli-progress-bar

Usage

use Dariuszp\CliProgressBar;
$bar = new CliProgressBar(10, 5);
$bar->display();
$bar->end();

Code above will show half full progress bar:

▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓░░░░░░░░░░░░░░░░░░░░ 50.0% (5/10)

Windows can't handle some UTF characters so there is an alternate method to display progress bar:

use Dariuszp\CliProgressBar;
$bar = new CliProgressBar();
$bar->displayAlternateProgressBar(); // this only switch style

$bar->display();
$bar->end();

Output will be:

XXXX____________________________________ 10.0% (10/100)

Add text to the progress bar using the following methods

use Dariuszp\CliProgressBar;
$bar = new CliProgressBar(50, 0, "My Custom Text");
$bar->display();
$bar->end();

or

use Dariuszp\CliProgressBar;
$bar = new CliProgressBar();
$bar->setDetails("My Custom Text");
$bar->display();
$bar->end();

Also update asynchronously with setDetails()

More features like:

• changing progress bar length (basicWithShortBar.php)
• changing bar color (colors.php)
• animation example (basic.php)
• etc...

in example directory.

License: MIT

Author: Półtorak Dariusz Contributors: @mathmatrix828 - Mason Phillips