dariuszp/cli-progress-bar

Cli progress bar

Maintainers

Details

github.com/dariuszp/cli-progress-bar

Source

Issues

Installs: 563 972

Dependents: 13

Suggesters: 0

Security: 0

Stars: 77

Watchers: 5

Forks: 11

Open Issues: 3

1.0.5 2018-11-24 20:35 UTC

Requires (Dev)

MIT 1be746082242092ce9e7c735be45f9d9a77be1aa

  • Dariusz Półtorak <poltorak.dariusz.woop@gmail.com>
  • Mason Phillips <math.matrix.woop@icloud.com>

This package is not auto-updated.

Last update: 2024-12-18 09:38:16 UTC

README

Progress bar for cli apps

example animation

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