77 */
88final class ProgressBar
99{
10- /** Character to display current progress in progress bar */
10+ /** Character to display current progress in the progress bar */
1111 private string $ barCharacter = '# ' ;
1212
1313 /** Width of progress bar, in number of characters */
@@ -16,19 +16,19 @@ final class ProgressBar
1616 /** Minimum time in seconds between consecutive refreshes of display */
1717 private float $ drawFrequency = 0.25 ;
1818
19- /** Character to display remaining progress in progress bar */
19+ /** Character to display remaining progress in the progress bar */
2020 private string $ emptyBarCharacter = '. ' ;
2121
2222 /** Estimated time to finish in seconds */
2323 private int $ estimatedTime = 0 ;
2424
25- /** Timing of last display */
25+ /** Timing of the last display */
2626 private float $ lastDisplayTime = 0.0 ;
2727
2828 /** Current progress in percentage */
2929 private int $ percentage = 0 ;
3030
31- /** Time when progress bar starts displaying */
31+ /** Time when the progress bar starts displaying */
3232 private int $ startTime ;
3333
3434 /**
@@ -56,7 +56,7 @@ public function __construct(
5656 }
5757
5858 /**
59- * Move cursor to line start and clear whole line.
59+ * Move the cursor to line start and clear the whole line.
6060 */
6161 private function clearLine (): void
6262 {
@@ -85,7 +85,7 @@ private function display(): ProgressBar
8585 str_pad (string: $ this ->getPercentage (), length: 3 , pad_type: STR_PAD_LEFT )
8686 );
8787
88- /** Remove estimated time from display when done */
88+ /** Remove estimated time from the display when done */
8989 if ($ this ->percentage < 100 ) {
9090 echo sprintf (
9191 ' (%02d:%02d:%02d) ' ,
@@ -110,7 +110,7 @@ public function finish(): void
110110 }
111111
112112 /**
113- * Get estimated time for progress bar to complete.
113+ * Get estimated time for the progress bar to complete.
114114 */
115115 public function getEstimatedTime (): string
116116 {
@@ -146,7 +146,7 @@ public function getProgress(): int
146146 */
147147 private function hideCursor (): ProgressBar
148148 {
149- /** Show cursor again in case of any exit code */
149+ /** Show the cursor again in case of any exit code */
150150 register_shutdown_function (function () {
151151 $ this ->showCursor ();
152152 });
@@ -183,7 +183,7 @@ public function iterate(\Countable|iterable $iterable): iterable
183183 }
184184
185185 /**
186- * Change default character for completed progress
186+ * Change the default character for completed progress
187187 */
188188 public function setBarCharacter (string $ character ): ProgressBar
189189 {
@@ -193,7 +193,7 @@ public function setBarCharacter(string $character): ProgressBar
193193 }
194194
195195 /**
196- * Change default character for incomplete progress.
196+ * Change the default character for incomplete progress.
197197 */
198198 public function setEmptyBarCharacter (string $ character ): ProgressBar
199199 {
@@ -203,7 +203,7 @@ public function setEmptyBarCharacter(string $character): ProgressBar
203203 }
204204
205205 /**
206- * Calculate estimated time for completion of progress bar.
206+ * Calculate the estimated time for completion of the progress bar.
207207 */
208208 private function setEstimatedTime (): ProgressBar
209209 {
@@ -257,7 +257,7 @@ public function setProgress(int|float $progress): ProgressBar
257257 }
258258
259259 /**
260- * Show cursor again after finishing progress bar
260+ * Show the cursor again after finishing the progress bar
261261 */
262262 private function showCursor (): ProgressBar
263263 {
0 commit comments