diff --git a/.gitattributes b/.gitattributes
index 0ba43ec..e150b79 100644
--- a/.gitattributes
+++ b/.gitattributes
@@ -1,10 +1,10 @@
-# Files and folders here will be not included when creating package
-/tests export-ignore
-/examples export-ignore
-/public export-ignore
-/themes export-ignore
-/.github export-ignore
-/.gitignore export-ignore
-/.travis.yml export-ignore
-/phpunit.xml export-ignore
+# Files and folders here will be not included when creating package
+/tests export-ignore
+/examples export-ignore
+/public export-ignore
+/themes export-ignore
+/.github export-ignore
+/.gitignore export-ignore
+/.travis.yml export-ignore
+/phpunit.xml export-ignore
/sonar-project.properties export-ignore
\ No newline at end of file
diff --git a/.github/dependabot.yml b/.github/dependabot.yml
new file mode 100644
index 0000000..e9fa9a1
--- /dev/null
+++ b/.github/dependabot.yml
@@ -0,0 +1,11 @@
+version: 2
+updates:
+ - package-ecosystem: "composer"
+ directory: "/"
+ schedule:
+ interval: "daily"
+ labels:
+ - "dependencies"
+ commit-message:
+ prefix: "chore(deps)"
+ target-branch: "main"
diff --git a/.github/workflows/php81.yaml b/.github/workflows/php81.yaml
index 77e68ff..d0e725a 100644
--- a/.github/workflows/php81.yaml
+++ b/.github/workflows/php81.yaml
@@ -8,14 +8,14 @@ on:
jobs:
test:
name: Run Tests
- uses: WebFiori/workflows/.github/workflows/test-php.yaml@v1.2.1
+ uses: WebFiori/workflows/.github/workflows/test-php.yaml@v1.2.5
with:
php-version: '8.1'
code-coverage:
name: Coverage
needs: test
- uses: WebFiori/workflows/.github/workflows/coverage-codecov.yaml@v1.2.1
+ uses: WebFiori/workflows/.github/workflows/coverage-codecov.yaml@v1.2.5
with:
php-version: '8.1'
coverage-file: 'php-8.1-coverage.xml'
diff --git a/.github/workflows/php82.yaml b/.github/workflows/php82.yaml
index 9e431d3..e760f4f 100644
--- a/.github/workflows/php82.yaml
+++ b/.github/workflows/php82.yaml
@@ -8,15 +8,15 @@ on:
jobs:
test:
name: Run Tests
- uses: WebFiori/workflows/.github/workflows/test-php.yaml@v1.2.1
+ uses: WebFiori/workflows/.github/workflows/test-php.yaml@v1.2.5
with:
php-version: '8.2'
- phpunit-config: "tests/phpunit10.xml"
+ phpunit-config: "tests/phpunit.xml"
code-coverage:
name: Coverage
needs: test
- uses: WebFiori/workflows/.github/workflows/coverage-codecov.yaml@v1.2.1
+ uses: WebFiori/workflows/.github/workflows/coverage-codecov.yaml@v1.2.5
with:
php-version: '8.2'
coverage-file: 'php-8.2-coverage.xml'
diff --git a/.github/workflows/php83.yaml b/.github/workflows/php83.yaml
index 17c1972..bcecd86 100644
--- a/.github/workflows/php83.yaml
+++ b/.github/workflows/php83.yaml
@@ -12,16 +12,16 @@ jobs:
test:
name: Run Tests
- uses: WebFiori/workflows/.github/workflows/test-php.yaml@v1.2.1
+ uses: WebFiori/workflows/.github/workflows/test-php.yaml@v1.2.5
with:
php-version: '8.3'
- phpunit-config: 'tests/phpunit10.xml'
+ phpunit-config: 'tests/phpunit.xml'
code-coverage:
name: Coverage
needs: test
- uses: WebFiori/workflows/.github/workflows/coverage-codecov.yaml@v1.2.1
+ uses: WebFiori/workflows/.github/workflows/coverage-codecov.yaml@v1.2.5
with:
php-version: '8.3'
coverage-file: 'php-8.3-coverage.xml'
diff --git a/.github/workflows/php84.yaml b/.github/workflows/php84.yaml
index adcc94b..8ac7d3f 100644
--- a/.github/workflows/php84.yaml
+++ b/.github/workflows/php84.yaml
@@ -8,15 +8,15 @@ on:
jobs:
test:
name: Run Tests
- uses: WebFiori/workflows/.github/workflows/test-php.yaml@v1.2.1
+ uses: WebFiori/workflows/.github/workflows/test-php.yaml@v1.2.5
with:
php-version: '8.4'
- phpunit-config: "tests/phpunit10.xml"
+ phpunit-config: "tests/phpunit.xml"
code-coverage:
name: Coverage
needs: test
- uses: WebFiori/workflows/.github/workflows/coverage-codecov.yaml@v1.2.1
+ uses: WebFiori/workflows/.github/workflows/coverage-codecov.yaml@v1.2.5
with:
php-version: '8.4'
coverage-file: 'php-8.4-coverage.xml'
diff --git a/.github/workflows/php85.yaml b/.github/workflows/php85.yaml
index b6743fd..62b49fe 100644
--- a/.github/workflows/php85.yaml
+++ b/.github/workflows/php85.yaml
@@ -8,15 +8,15 @@ on:
jobs:
test:
name: Run Tests
- uses: WebFiori/workflows/.github/workflows/test-php.yaml@v1.2.1
+ uses: WebFiori/workflows/.github/workflows/test-php.yaml@v1.2.5
with:
php-version: '8.5'
- phpunit-config: "tests/phpunit10.xml"
+ phpunit-config: "tests/phpunit.xml"
code-coverage:
name: Coverage
needs: test
- uses: WebFiori/workflows/.github/workflows/coverage-codecov.yaml@v1.2.1
+ uses: WebFiori/workflows/.github/workflows/coverage-codecov.yaml@v1.2.5
with:
php-version: '8.5'
coverage-file: 'php-8.5-coverage.xml'
diff --git a/.gitignore b/.gitignore
index 2e8fcfc..d4efbbb 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,21 +1,21 @@
-/nbproject
-test.*
-/tmp
-/clover.xml
-/vendor
-composer.lock
-*.cache
-cs-fixer.phar
-*.log
-src/app/storage
-app/storage
-/release/
-php-cs-fixer-v2.phar
-app/sto
-.idea/*
-test/*
-tests/clover.xml
-cache/commands.json
-*.Identifier
-/test2
-/home/ibrahim/cli/test2
+/nbproject
+test.*
+/tmp
+/clover.xml
+/vendor
+composer.lock
+*.cache
+cs-fixer.phar
+*.log
+src/app/storage
+app/storage
+/release/
+php-cs-fixer-v2.phar
+app/sto
+.idea/*
+test/*
+tests/clover.xml
+cache/commands.json
+*.Identifier
+/test2
+/home/ibrahim/cli/test2
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 93a6d3c..e0f53fa 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,53 +1,38 @@
-# Changelog
-
-## [2.1.0](https://github.com/WebFiori/cli/compare/v2.0.1...v2.1.0) (2026-01-12)
-
-
-### Features
-
-* Command Scaffolding ([38a7541](https://github.com/WebFiori/cli/commit/38a7541fda02dfdcdcb79434ca1d4efc9fddc8a6))
-* Masked Input ([e4b9b4e](https://github.com/WebFiori/cli/commit/e4b9b4ea2d74b1a053f90de6de9ff11bf2995b16))
-
-
-### Miscellaneous Chores
-
-* Merge pull request [#37](https://github.com/WebFiori/cli/issues/37) from WebFiori/feat-input-mask ([e4ee130](https://github.com/WebFiori/cli/commit/e4ee1300b29acfbbbaa960ff6f4d6e645c3eab41))
-* Merge pull request [#38](https://github.com/WebFiori/cli/issues/38) from WebFiori/feat-scaffolding ([69e05c0](https://github.com/WebFiori/cli/commit/69e05c0be35ae4347228bae466f65254856b6229))
-* Merge pull request [#39](https://github.com/WebFiori/cli/issues/39) from WebFiori/dev ([b278081](https://github.com/WebFiori/cli/commit/b278081b39dbd94625129713c0df344cf86c78cf))
-
-## [2.0.1](https://github.com/WebFiori/cli/compare/v2.0.0...v2.0.1) (2025-10-06)
-
-
-### Bug Fixes
-
-* Default Value for `select` ([6acd1fa](https://github.com/WebFiori/cli/commit/6acd1fac5f3b9e89b41b4d39a654c23321de5720))
-
-## [2.0.0](https://github.com/WebFiori/cli/compare/v1.3.1...v2.0.0) (2025-09-27)
-
-
-### Features
-
-* Aliasing of Commands ([660a179](https://github.com/WebFiori/cli/commit/660a1790ead3a7e0fc9d052422d376e038583f6e))
-* Auto-Discovery of Commands ([72c7fff](https://github.com/WebFiori/cli/commit/72c7fff4f37f42452534be8642cfc390e1e31214))
-* Help Command for All ([9d8772a](https://github.com/WebFiori/cli/commit/9d8772ac797f38d8790706667392e88428ef672c))
-* Table Display ([857ed5a](https://github.com/WebFiori/cli/commit/857ed5a38f78972934f301b58fc1a6ea3a4e616f))
-* Tables Display ([1cfbb48](https://github.com/WebFiori/cli/commit/1cfbb486ed6ee95994c60530e92dc4d05f1cae80))
-
-
-### Bug Fixes
-
-* App Path ([bdbbc6a](https://github.com/WebFiori/cli/commit/bdbbc6a7d68c3ccad98ba5bb129dcd3d763fcc6a))
-* Help Command ([e97ac83](https://github.com/WebFiori/cli/commit/e97ac83f1e2a0b39024d5c62861a6f19b168424d))
-* Namespaces Correction ([a07c08e](https://github.com/WebFiori/cli/commit/a07c08ea6bfa16879f88d1f2f004288f625f85bc))
-* Use of Self ([4bff72b](https://github.com/WebFiori/cli/commit/4bff72b218154f6d36957d8c67acdd09c31b2d7e))
-
-
-### Miscellaneous Chores
-
-* Added More Code Samples ([af30558](https://github.com/WebFiori/cli/commit/af30558522ba780a63fb3eb23c3cd20206178f8e))
-* Release 2.0.0 ([cb763c5](https://github.com/WebFiori/cli/commit/cb763c556bdbbd8538935eacf6936b233ff271d1))
-* Release 2.0.0 ([2a29b9d](https://github.com/WebFiori/cli/commit/2a29b9d53b6887ea8fb3157529b51d1fb05c00e4))
-* Update README.md ([5c940a1](https://github.com/WebFiori/cli/commit/5c940a1a287ea8633d9aab9e0634b8a2fc40a406))
-* Update README.md ([b4f1dcf](https://github.com/WebFiori/cli/commit/b4f1dcfa277fc0adc097e9244007ef3528a6b466))
-* Updated Config ([1df09ae](https://github.com/WebFiori/cli/commit/1df09ae140497270a65335db2b6b35c1d78d8cfc))
-* Updated README ([53c7471](https://github.com/WebFiori/cli/commit/53c7471629be117e61bb8b8c85e1a5d2cb0ccc83))
+# Changelog
+
+## [2.0.1](https://github.com/WebFiori/cli/compare/v2.0.0...v2.0.1) (2025-10-06)
+
+
+### Bug Fixes
+
+* Default Value for `select` ([6acd1fa](https://github.com/WebFiori/cli/commit/6acd1fac5f3b9e89b41b4d39a654c23321de5720))
+
+## [2.0.0](https://github.com/WebFiori/cli/compare/v1.3.1...v2.0.0) (2025-09-27)
+
+
+### Features
+
+* Aliasing of Commands ([660a179](https://github.com/WebFiori/cli/commit/660a1790ead3a7e0fc9d052422d376e038583f6e))
+* Auto-Discovery of Commands ([72c7fff](https://github.com/WebFiori/cli/commit/72c7fff4f37f42452534be8642cfc390e1e31214))
+* Help Command for All ([9d8772a](https://github.com/WebFiori/cli/commit/9d8772ac797f38d8790706667392e88428ef672c))
+* Table Display ([857ed5a](https://github.com/WebFiori/cli/commit/857ed5a38f78972934f301b58fc1a6ea3a4e616f))
+* Tables Display ([1cfbb48](https://github.com/WebFiori/cli/commit/1cfbb486ed6ee95994c60530e92dc4d05f1cae80))
+
+
+### Bug Fixes
+
+* App Path ([bdbbc6a](https://github.com/WebFiori/cli/commit/bdbbc6a7d68c3ccad98ba5bb129dcd3d763fcc6a))
+* Help Command ([e97ac83](https://github.com/WebFiori/cli/commit/e97ac83f1e2a0b39024d5c62861a6f19b168424d))
+* Namespaces Correction ([a07c08e](https://github.com/WebFiori/cli/commit/a07c08ea6bfa16879f88d1f2f004288f625f85bc))
+* Use of Self ([4bff72b](https://github.com/WebFiori/cli/commit/4bff72b218154f6d36957d8c67acdd09c31b2d7e))
+
+
+### Miscellaneous Chores
+
+* Added More Code Samples ([af30558](https://github.com/WebFiori/cli/commit/af30558522ba780a63fb3eb23c3cd20206178f8e))
+* Release 2.0.0 ([cb763c5](https://github.com/WebFiori/cli/commit/cb763c556bdbbd8538935eacf6936b233ff271d1))
+* Release 2.0.0 ([2a29b9d](https://github.com/WebFiori/cli/commit/2a29b9d53b6887ea8fb3157529b51d1fb05c00e4))
+* Update README.md ([5c940a1](https://github.com/WebFiori/cli/commit/5c940a1a287ea8633d9aab9e0634b8a2fc40a406))
+* Update README.md ([b4f1dcf](https://github.com/WebFiori/cli/commit/b4f1dcfa277fc0adc097e9244007ef3528a6b466))
+* Updated Config ([1df09ae](https://github.com/WebFiori/cli/commit/1df09ae140497270a65335db2b6b35c1d78d8cfc))
+* Updated README ([53c7471](https://github.com/WebFiori/cli/commit/53c7471629be117e61bb8b8c85e1a5d2cb0ccc83))
diff --git a/LICENSE b/LICENSE
index 9e892bc..eda1a21 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2022 Ibrahim BinAlshikh
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2022 Ibrahim BinAlshikh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/README.md b/README.md
index 7b879ab..817f44a 100644
--- a/README.md
+++ b/README.md
@@ -1,626 +1,626 @@
-# WebFiori CLI
-Class library that can help in writing command line based applications with minimum dependencies using PHP.
-
-
-
-## Content
-* [Supported PHP Versions](#supported-php-versions)
-* [Features](#features)
-* [Quick Start](#quick-start)
-* [Sample Application](#sample-application)
-* [Installation](#installation)
-* [Basic Usage](#basic-usage)
- * [Simple Command Example](#simple-command-example)
- * [Command with Arguments](#command-with-arguments)
- * [Multi-Command Application](#multi-command-application)
-* [Creating and Running Commands](#creating-and-running-commands)
- * [Creating a Command](#creating-a-command)
- * [Running a Command](#running-a-command)
- * [Arguments](#arguments)
- * [Adding Arguments to Commands](#adding-arguments-to-commands)
- * [Accessing Argument Value](#accessing-argument-value)
-* [Advanced Features](#advanced-features)
- * [Interactive Mode](#interactive-mode)
- * [Input and Output Streams](#input-and-output-streams)
- * [ANSI Colors and Formatting](#ansi-colors-and-formatting)
- * [Progress Bars](#progress-bars)
- * [Table Display](#table-display)
-* [The `help` Command](#the-help-command)
- * [Setting Help Instructions](#setting-help-instructions)
- * [Running `help` Command](#running-help-command)
- * [General Help](#general-help)
- * [Command-Specific Help](#command-specific-help)
-* [Unit-Testing Commands](#unit-testing-commands)
-* [Examples](#examples)
-
-## Supported PHP Versions
-| Build Status |
-|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
-| |
-| |
-| |
-| |
-| |
-
-## Features
-* **Easy Command Creation**: Simple class-based approach to building CLI commands
-* **Argument Handling**: Support for required and optional arguments with validation
-* **Interactive Mode**: Keep your application running and execute multiple commands
-* **ANSI Output**: Rich text formatting with colors and styles
-* **Input/Output Streams**: Custom input and output stream implementations
-* **Progress Bars**: Built-in progress indicators for long-running operations
-* **Table Display**: Format and display data in clean, readable tables
-* **Help System**: Automatic help generation for commands and arguments
-* **Unit Testing**: Built-in testing utilities for command validation
-* **Minimal Dependencies**: Lightweight library with minimal external requirements
-
-## Quick Start
-
-Get up and running in minutes:
-
-```bash
-# Install via Composer
-composer require webfiori/cli
-
-# Create your first command
-php -r "
-require 'vendor/autoload.php';
-use WebFiori\Cli\Command;
-use WebFiori\Cli\Runner;
-
-class HelloCommand extends Command {
- public function __construct() {
- parent::__construct('hello', [], 'Say hello to the world');
- }
- public function exec(): int {
- \$this->println('Hello, World!');
- return 0;
- }
-}
-
-\$runner = new Runner();
-\$runner->register(new HelloCommand());
-exit(\$runner->start());
-" hello
-```
-
-## Sample Application
-
-A complete sample application with multiple examples can be found here: **[๐ View Sample Application](https://github.com/WebFiori/cli/tree/main/examples)**
-
-The sample application includes:
-- **[Basic Commands](https://github.com/WebFiori/cli/tree/main/examples/01-basic-hello-world)** - Simple command creation
-- **[Arguments Handling](https://github.com/WebFiori/cli/tree/main/examples/02-arguments-and-options)** - Working with command arguments
-- **[User Input](https://github.com/WebFiori/cli/tree/main/examples/03-user-input)** - Building interactive applications
-- **[Multi-Command Apps](https://github.com/WebFiori/cli/tree/main/examples/10-multi-command-app)** - Complex applications with multiple commands
-- **[Progress Bars](https://github.com/WebFiori/cli/tree/main/examples/07-progress-bars)** - Visual progress indicators
-- **[Table Display](https://github.com/WebFiori/cli/tree/main/examples/06-table-display)** - Formatting data in tables
-- **[Database Operations](https://github.com/WebFiori/cli/tree/main/examples/09-database-ops)** - Database CLI commands
-
-## Installation
-
-Install WebFiori CLI using Composer:
-
-```bash
-composer require webfiori/cli
-```
-
-Or add it to your `composer.json`:
-
-```json
-{
- "require": {
- "webfiori/cli": "*"
- }
-}
-```
-
-## Basic Usage
-
-### Simple Command Example
-
-Create a basic command that outputs a message:
-
-```php
-println("Hello from WebFiori CLI!");
- return 0;
- }
-}
-
-$runner = new Runner();
-$runner->register(new GreetCommand());
-exit($runner->start());
-```
-
-**Usage:**
-```bash
-php app.php greet
-# Output: Hello from WebFiori CLI!
-```
-
-**[๐ View Complete Example](https://github.com/WebFiori/cli/tree/main/examples/01-basic-hello-world)**
-
-### Command with Arguments
-
-Create a command that accepts and processes arguments:
-
-```php
- [
- Option::OPTIONAL => false,
- Option::DESCRIPTION => 'Name of the person to greet'
- ],
- '--title' => [
- Option::OPTIONAL => true,
- Option::DEFAULT => 'Friend',
- Option::DESCRIPTION => 'Title to use (Mr, Ms, Dr, etc.)'
- ]
- ], 'Greet a specific person');
- }
-
- public function exec(): int {
- $name = $this->getArgValue('--name');
- $title = $this->getArgValue('--title');
-
- $this->println("Hello %s %s!", $title, $name);
- return 0;
- }
-}
-```
-
-**Usage:**
-```bash
-php app.php greet-person --name=John --title=Mr
-# Output: Hello Mr John!
-
-php app.php greet-person --name=Sarah
-# Output: Hello Friend Sarah!
-```
-
-**[๐ View Complete Example](https://github.com/WebFiori/cli/tree/main/examples/02-arguments-and-options)**
-
-### Multi-Command Application
-
-Build applications with multiple commands:
-
-```php
-register(new GreetCommand());
-$runner->register(new PersonalGreetCommand());
-$runner->register(new FileProcessCommand());
-$runner->register(new DatabaseCommand());
-
-// Set application info
-$runner->setAppName('My CLI App');
-$runner->setAppVersion('1.0.0');
-
-exit($runner->start());
-```
-
-**Usage:**
-```bash
-php app.php help # Show all available commands
-php app.php greet # Run greet command
-php app.php greet-person --name=Bob # Run greet-person command
-php app.php -i # Start interactive mode
-```
-
-**[๐ View Complete Example](https://github.com/WebFiori/cli/tree/main/examples/10-multi-command-app)**
-
-## Creating and Running Commands
-
-### Creating a Command
-
-First step in creating new command is to create a new class that extends the class `WebFiori\Cli\Command`. The class `Command` is a utility class which has methods that can be used to read inputs, send outputs and use command line arguments.
-
-The class has one abstract method that must be implemented. The code that will exist in the body of the method will represent the logic of the command.
-
-``` php
-println("Hi People!");
- return 0;
- }
-
-}
-
-```
-
-### Running a Command
-
-The class `WebFiori\Cli\Runner` is the class which is used to manage the logic of executing the commands. In order to run a command, an instance of this class must be created and used to register the command and start running the application.
-
-To register a command, the method `Runner::register()` is used. To start the application, the method `Runner::start()` is used.
-
-``` php
-// File src/main.php
-require_once '../vendor/autoload.php';
-
-use WebFiori\Cli\Runner;
-use SampleCommand;
-
-
-$runner = new Runner();
-$runner->register(new SampleCommand());
-exit($runner->start());
-```
-
-Now if terminal is opened and following command is executed:
-
-``` bash
-php main.php say-hi
-```
-
-The output will be the string `Hi People!`.
-
-### Arguments
-
-Arguments is a way that can be used to pass values from the terminal to PHP process. They can be used to configure execution of the command. For example, a command might require some kind of file as input.
-
-#### Adding Arguments to Commands
-
-Arguments can be added in the constructor of the class as follows:
-
-``` php
- [
- Option::OPTIONAL => true
- ]
- ]);
- }
-
- public function exec(): int {
- $this->println("Hi People!");
- return 0;
- }
-
-}
-
-```
-
-Arguments can be provided as an associative array or array of objects of type `WebFiori\Cli\Argument`. In case of associative array, Index is name of the argument and the value of the index is sub-associative array of options. Each argument can have the following options:
-* `optional`: A boolean. if set to true, it means that the argument is optional. Default is false.
-* `default`: An optional default value for the argument to use if it is not provided.
-* `description`: A description of the argument which will be shown if the command `help` is executed.
-* `values`: A set of values that the argument can have. If provided, only the values on the list will be allowed.
-
-The class `WebFiori\Cli\Option` can be used to access the options.
-
-#### Accessing Argument Value
-
-Accessing the value of an argument is performed using the method `Command::getArgValue(string $argName)`. If argument is provided, the method will return its value as `string`. If not provided, `null` is returned.
-
-``` php
- [
- Option::OPTIONAL => true
- ]
- ]);
- }
-
- public function exec(): int {
- $personName = $this->getArgValue('--person-name');
-
- if ($personName !== null) {
- $this->println("Hi %s!", $personName);
- } else {
- $this->println("Hi People!");
- }
-
- return 0;
- }
-
-}
-
-```
-
-## Advanced Features
-
-### Interactive Mode
-
-Interactive mode is a way that can be used to keep your application running and execute more than one command using same PHP process. To start the application in interactive mode, add the argument `-i` when starting the application as follows:
-
-``` bash
-php main.php -i
-```
-
-This will show following output in terminal:
-
-``` bash
->> Running in interactive mode.
->> Type command name or 'exit' to close.
->>
-```
-
-**[๐ View Interactive Mode Example](https://github.com/WebFiori/cli/tree/main/examples/05-interactive-commands)**
-
-### Input and Output Streams
-
-WebFiori CLI supports custom input and output streams for advanced use cases:
-
-```php
-use WebFiori\Cli\Streams\FileInputStream;
-use WebFiori\Cli\Streams\FileOutputStream;
-
-// Read from file instead of stdin
-$command->setInputStream(new FileInputStream('input.txt'));
-
-// Write to file instead of stdout
-$command->setOutputStream(new FileOutputStream('output.txt'));
-```
-
-**[๐ View Streams Example](https://github.com/WebFiori/cli/tree/main/examples/08-file-processing)**
-
-### ANSI Colors and Formatting
-
-Add colors and formatting to your CLI output:
-
-```php
-public function exec(): int {
- $this->println("This is %s text", 'normal');
- $this->println("This is {{bold}}bold{{/bold}} text");
- $this->println("This is {{red}}red{{/red}} text");
- $this->println("This is {{bg-blue}}{{white}}white on blue{{/white}}{{/bg-blue}} text");
- return 0;
-}
-```
-
-**[๐ View Formatting Example](https://github.com/WebFiori/cli/tree/main/examples/04-output-formatting)**
-
-### Progress Bars
-
-Display progress for long-running operations:
-
-```php
-use WebFiori\Cli\Progress\ProgressBar;
-
-public function exec(): int {
- $items = range(1, 100);
-
- $this->withProgressBar($items, function($item, $bar) {
- // Process each item
- usleep(50000); // Simulate work
- $bar->setMessage("Processing item {$item}");
- });
-
- return 0;
-}
-```
-
-**[๐ View Progress Bar Example](https://github.com/WebFiori/cli/tree/main/examples/07-progress-bars)**
-
-### Table Display
-
-Display data in formatted tables:
-
-```php
-public function exec(): int {
- $data = [
- ['Ahmed Hassan', 30, 'Cairo'],
- ['Sarah Johnson', 25, 'Los Angeles']
- ];
- $headers = ['Name', 'Age', 'City'];
-
- $this->table($data, $headers);
-
- return 0;
-}
-```
-
-**[๐ View Table Display Example](https://github.com/WebFiori/cli/tree/main/examples/06-table-display)**
-
-## The `help` Command
-One of the commands which comes by default with the library is the `help` command. It can be used to display help instructions for all registered commands.
-
-> Note: In order to use this command, it must be registered using the method `Runner::register()`.
-
-### Setting Help Instructions
-
-Help instructions are provided by the developer who created the command during its implementation. Instructions can be set on the constructor of the class that extends the class `WebFiori\Cli\Command` as a description. The description can be set for the command and its arguments.
-
-``` php
- [
- Option::DESCRIPTION => 'Name of someone to greet.',
- Option::OPTIONAL => true
- ]
- ], 'A command to show greetings.');
- }
-
- public function exec(): int {
- $name = $this->getArgValue('--person-name');
-
- if ($name === null) {
- $this->println("Hello World!");
- } else {
- $this->println("Hello %s!", $name);
- }
-
- return 0;
- }
-}
-
-```
-
-### Running `help` Command
-
-Help command can be used in two ways, one way is to display a general help for the application and another one for specific command.
-
-#### General Help
-
-To show general help of the application, following command can be executed.
-
-``` bash
-php main.php help
-```
-
-Output of this command will be as follows:
-
-```
-Usage:
- command [arg1 arg2="val" arg3...]
-
-Global Arguments:
- --ansi:[Optional] Force the use of ANSI output.
-Available Commands:
- help: Display CLI Help. To display help for specific command, use the argument "--command-name" with this command.
- hello: A command to show greetings.
- open-file: Reads a text file and display its content.
-
-```
-
-> Note: Depending on registered commands, output may differ.
-
-#### Command-Specific Help
-
-To show help instructions for a specific command, the name of the command can be included using the argument `--command-name` as follows:
-
-``` bash
-php main.php help --command-name=hello
-```
-
-Output of this command will be as follows:
-
-```
-hello: A command to show greetings.
- Supported Arguments:
- --person-name:[Optional] Name of someone to greet.
-```
-
-## Unit-Testing Commands
-
-The library provides the helper class `WebFiori\Cli\CommandTestCase` which can be used to write unit tests for different commands. The developer has to only extend the class and use utility methods to write tests. The class is based on PHPUnit.
-
-The class has two methods which can be used to execute tests:
-
-* `CommandTestCase::executeSingleCommand()`: Used to run one command at a time and return its output.
-* `CommandTestCase::executeMultiCommand()`: Used to register multiple commands, set default command and/or run one of registered commands.
-
-First method is good to verify the output of one specific command. The second one is useful to simulate the execution of an application with multiple commands.
-
-Both methods support simulating arguments vector and user inputs.
-
-
-``` php
-namespace tests\cli;
-
-use WebFiori\Cli\CommandTestCase;
-
-class HelloCommandTest extends CommandTestCase {
- /**
- * @test
- */
- public function test00() {
-
- //Verify test results
-
- $this->assertEquals([
- "Hello World!\n"
- ], $this->executeSingleCommand(new HelloWorldCommand()));
- $this->assertEquals(0, $this->getExitCode());
- }
-}
-
-```
-
-**[๐ View Testing Examples](https://github.com/WebFiori/cli/tree/main/examples/10-multi-command-app)**
-
-## Examples
-
-Explore comprehensive examples to learn different aspects of WebFiori CLI:
-
-### Basic Examples
-- **[๐ Basic Command](https://github.com/WebFiori/cli/tree/main/examples/01-basic-hello-world)** - Create your first CLI command
-- **[๐ Command with Arguments](https://github.com/WebFiori/cli/tree/main/examples/02-arguments-and-options)** - Handle command-line arguments
-- **[๐ User Input](https://github.com/WebFiori/cli/tree/main/examples/03-user-input)** - Read and validate user input
-- **[๐ Output Formatting](https://github.com/WebFiori/cli/tree/main/examples/04-output-formatting)** - Colors and text formatting
-
-### Advanced Examples
-- **[๐ Interactive Commands](https://github.com/WebFiori/cli/tree/main/examples/05-interactive-commands)** - Build interactive CLI applications
-- **[๐ Table Display](https://github.com/WebFiori/cli/tree/main/examples/06-table-display)** - Format data in tables
-- **[๐ Progress Bars](https://github.com/WebFiori/cli/tree/main/examples/07-progress-bars)** - Visual progress indicators
-- **[๐ File Processing](https://github.com/WebFiori/cli/tree/main/examples/08-file-processing)** - File manipulation commands
-- **[๐ Database Operations](https://github.com/WebFiori/cli/tree/main/examples/09-database-ops)** - Database CLI commands
-
-### Complete Applications
-- **[๐ Multi-Command Application](https://github.com/WebFiori/cli/tree/main/examples/10-multi-command-app)** - Full-featured CLI application
-
-### Quick Links
-- **[๐ All Examples](https://github.com/WebFiori/cli/tree/main/examples)** - Browse all available examples
-- **[๐ Sample App](https://github.com/WebFiori/cli/tree/main/examples/10-multi-command-app/main.php)** - Ready-to-run sample application
-
-
----
-
-**Ready to build amazing CLI applications? Start with the [๐ Basic Command Example](https://github.com/WebFiori/cli/tree/main/examples/01-basic-hello-world) and work your way up!**
+# WebFiori CLI
+Class library that can help in writing command line based applications with minimum dependencies using PHP.
+
+
+
+## Content
+* [Supported PHP Versions](#supported-php-versions)
+* [Features](#features)
+* [Quick Start](#quick-start)
+* [Sample Application](#sample-application)
+* [Installation](#installation)
+* [Basic Usage](#basic-usage)
+ * [Simple Command Example](#simple-command-example)
+ * [Command with Arguments](#command-with-arguments)
+ * [Multi-Command Application](#multi-command-application)
+* [Creating and Running Commands](#creating-and-running-commands)
+ * [Creating a Command](#creating-a-command)
+ * [Running a Command](#running-a-command)
+ * [Arguments](#arguments)
+ * [Adding Arguments to Commands](#adding-arguments-to-commands)
+ * [Accessing Argument Value](#accessing-argument-value)
+* [Advanced Features](#advanced-features)
+ * [Interactive Mode](#interactive-mode)
+ * [Input and Output Streams](#input-and-output-streams)
+ * [ANSI Colors and Formatting](#ansi-colors-and-formatting)
+ * [Progress Bars](#progress-bars)
+ * [Table Display](#table-display)
+* [The `help` Command](#the-help-command)
+ * [Setting Help Instructions](#setting-help-instructions)
+ * [Running `help` Command](#running-help-command)
+ * [General Help](#general-help)
+ * [Command-Specific Help](#command-specific-help)
+* [Unit-Testing Commands](#unit-testing-commands)
+* [Examples](#examples)
+
+## Supported PHP Versions
+| Build Status |
+|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
+| |
+| |
+| |
+| |
+| |
+
+## Features
+* **Easy Command Creation**: Simple class-based approach to building CLI commands
+* **Argument Handling**: Support for required and optional arguments with validation
+* **Interactive Mode**: Keep your application running and execute multiple commands
+* **ANSI Output**: Rich text formatting with colors and styles
+* **Input/Output Streams**: Custom input and output stream implementations
+* **Progress Bars**: Built-in progress indicators for long-running operations
+* **Table Display**: Format and display data in clean, readable tables
+* **Help System**: Automatic help generation for commands and arguments
+* **Unit Testing**: Built-in testing utilities for command validation
+* **Minimal Dependencies**: Lightweight library with minimal external requirements
+
+## Quick Start
+
+Get up and running in minutes:
+
+```bash
+# Install via Composer
+composer require webfiori/cli
+
+# Create your first command
+php -r "
+require 'vendor/autoload.php';
+use WebFiori\Cli\Command;
+use WebFiori\Cli\Runner;
+
+class HelloCommand extends Command {
+ public function __construct() {
+ parent::__construct('hello', [], 'Say hello to the world');
+ }
+ public function exec(): int {
+ \$this->println('Hello, World!');
+ return 0;
+ }
+}
+
+\$runner = new Runner();
+\$runner->register(new HelloCommand());
+exit(\$runner->start());
+" hello
+```
+
+## Sample Application
+
+A complete sample application with multiple examples can be found here: **[๐ View Sample Application](https://github.com/WebFiori/cli/tree/main/examples)**
+
+The sample application includes:
+- **[Basic Commands](https://github.com/WebFiori/cli/tree/main/examples/01-basic-hello-world)** - Simple command creation
+- **[Arguments Handling](https://github.com/WebFiori/cli/tree/main/examples/02-arguments-and-options)** - Working with command arguments
+- **[User Input](https://github.com/WebFiori/cli/tree/main/examples/03-user-input)** - Building interactive applications
+- **[Multi-Command Apps](https://github.com/WebFiori/cli/tree/main/examples/10-multi-command-app)** - Complex applications with multiple commands
+- **[Progress Bars](https://github.com/WebFiori/cli/tree/main/examples/07-progress-bars)** - Visual progress indicators
+- **[Table Display](https://github.com/WebFiori/cli/tree/main/examples/06-table-display)** - Formatting data in tables
+- **[Database Operations](https://github.com/WebFiori/cli/tree/main/examples/09-database-ops)** - Database CLI commands
+
+## Installation
+
+Install WebFiori CLI using Composer:
+
+```bash
+composer require webfiori/cli
+```
+
+Or add it to your `composer.json`:
+
+```json
+{
+ "require": {
+ "webfiori/cli": "*"
+ }
+}
+```
+
+## Basic Usage
+
+### Simple Command Example
+
+Create a basic command that outputs a message:
+
+```php
+println("Hello from WebFiori CLI!");
+ return 0;
+ }
+}
+
+$runner = new Runner();
+$runner->register(new GreetCommand());
+exit($runner->start());
+```
+
+**Usage:**
+```bash
+php app.php greet
+# Output: Hello from WebFiori CLI!
+```
+
+**[๐ View Complete Example](https://github.com/WebFiori/cli/tree/main/examples/01-basic-hello-world)**
+
+### Command with Arguments
+
+Create a command that accepts and processes arguments:
+
+```php
+ [
+ Option::OPTIONAL => false,
+ Option::DESCRIPTION => 'Name of the person to greet'
+ ],
+ '--title' => [
+ Option::OPTIONAL => true,
+ Option::DEFAULT => 'Friend',
+ Option::DESCRIPTION => 'Title to use (Mr, Ms, Dr, etc.)'
+ ]
+ ], 'Greet a specific person');
+ }
+
+ public function exec(): int {
+ $name = $this->getArgValue('--name');
+ $title = $this->getArgValue('--title');
+
+ $this->println("Hello %s %s!", $title, $name);
+ return 0;
+ }
+}
+```
+
+**Usage:**
+```bash
+php app.php greet-person --name=John --title=Mr
+# Output: Hello Mr John!
+
+php app.php greet-person --name=Sarah
+# Output: Hello Friend Sarah!
+```
+
+**[๐ View Complete Example](https://github.com/WebFiori/cli/tree/main/examples/02-arguments-and-options)**
+
+### Multi-Command Application
+
+Build applications with multiple commands:
+
+```php
+register(new GreetCommand());
+$runner->register(new PersonalGreetCommand());
+$runner->register(new FileProcessCommand());
+$runner->register(new DatabaseCommand());
+
+// Set application info
+$runner->setAppName('My CLI App');
+$runner->setAppVersion('1.0.0');
+
+exit($runner->start());
+```
+
+**Usage:**
+```bash
+php app.php help # Show all available commands
+php app.php greet # Run greet command
+php app.php greet-person --name=Bob # Run greet-person command
+php app.php -i # Start interactive mode
+```
+
+**[๐ View Complete Example](https://github.com/WebFiori/cli/tree/main/examples/10-multi-command-app)**
+
+## Creating and Running Commands
+
+### Creating a Command
+
+First step in creating new command is to create a new class that extends the class `WebFiori\Cli\Command`. The class `Command` is a utility class which has methods that can be used to read inputs, send outputs and use command line arguments.
+
+The class has one abstract method that must be implemented. The code that will exist in the body of the method will represent the logic of the command.
+
+``` php
+println("Hi People!");
+ return 0;
+ }
+
+}
+
+```
+
+### Running a Command
+
+The class `WebFiori\Cli\Runner` is the class which is used to manage the logic of executing the commands. In order to run a command, an instance of this class must be created and used to register the command and start running the application.
+
+To register a command, the method `Runner::register()` is used. To start the application, the method `Runner::start()` is used.
+
+``` php
+// File src/main.php
+require_once '../vendor/autoload.php';
+
+use WebFiori\Cli\Runner;
+use SampleCommand;
+
+
+$runner = new Runner();
+$runner->register(new SampleCommand());
+exit($runner->start());
+```
+
+Now if terminal is opened and following command is executed:
+
+``` bash
+php main.php say-hi
+```
+
+The output will be the string `Hi People!`.
+
+### Arguments
+
+Arguments is a way that can be used to pass values from the terminal to PHP process. They can be used to configure execution of the command. For example, a command might require some kind of file as input.
+
+#### Adding Arguments to Commands
+
+Arguments can be added in the constructor of the class as follows:
+
+``` php
+ [
+ Option::OPTIONAL => true
+ ]
+ ]);
+ }
+
+ public function exec(): int {
+ $this->println("Hi People!");
+ return 0;
+ }
+
+}
+
+```
+
+Arguments can be provided as an associative array or array of objects of type `WebFiori\Cli\Argument`. In case of associative array, Index is name of the argument and the value of the index is sub-associative array of options. Each argument can have the following options:
+* `optional`: A boolean. if set to true, it means that the argument is optional. Default is false.
+* `default`: An optional default value for the argument to use if it is not provided.
+* `description`: A description of the argument which will be shown if the command `help` is executed.
+* `values`: A set of values that the argument can have. If provided, only the values on the list will be allowed.
+
+The class `WebFiori\Cli\Option` can be used to access the options.
+
+#### Accessing Argument Value
+
+Accessing the value of an argument is performed using the method `Command::getArgValue(string $argName)`. If argument is provided, the method will return its value as `string`. If not provided, `null` is returned.
+
+``` php
+ [
+ Option::OPTIONAL => true
+ ]
+ ]);
+ }
+
+ public function exec(): int {
+ $personName = $this->getArgValue('--person-name');
+
+ if ($personName !== null) {
+ $this->println("Hi %s!", $personName);
+ } else {
+ $this->println("Hi People!");
+ }
+
+ return 0;
+ }
+
+}
+
+```
+
+## Advanced Features
+
+### Interactive Mode
+
+Interactive mode is a way that can be used to keep your application running and execute more than one command using same PHP process. To start the application in interactive mode, add the argument `-i` when starting the application as follows:
+
+``` bash
+php main.php -i
+```
+
+This will show following output in terminal:
+
+``` bash
+>> Running in interactive mode.
+>> Type command name or 'exit' to close.
+>>
+```
+
+**[๐ View Interactive Mode Example](https://github.com/WebFiori/cli/tree/main/examples/05-interactive-commands)**
+
+### Input and Output Streams
+
+WebFiori CLI supports custom input and output streams for advanced use cases:
+
+```php
+use WebFiori\Cli\Streams\FileInputStream;
+use WebFiori\Cli\Streams\FileOutputStream;
+
+// Read from file instead of stdin
+$command->setInputStream(new FileInputStream('input.txt'));
+
+// Write to file instead of stdout
+$command->setOutputStream(new FileOutputStream('output.txt'));
+```
+
+**[๐ View Streams Example](https://github.com/WebFiori/cli/tree/main/examples/08-file-processing)**
+
+### ANSI Colors and Formatting
+
+Add colors and formatting to your CLI output:
+
+```php
+public function exec(): int {
+ $this->println("This is %s text", 'normal');
+ $this->println("This is {{bold}}bold{{/bold}} text");
+ $this->println("This is {{red}}red{{/red}} text");
+ $this->println("This is {{bg-blue}}{{white}}white on blue{{/white}}{{/bg-blue}} text");
+ return 0;
+}
+```
+
+**[๐ View Formatting Example](https://github.com/WebFiori/cli/tree/main/examples/04-output-formatting)**
+
+### Progress Bars
+
+Display progress for long-running operations:
+
+```php
+use WebFiori\Cli\Progress\ProgressBar;
+
+public function exec(): int {
+ $items = range(1, 100);
+
+ $this->withProgressBar($items, function($item, $bar) {
+ // Process each item
+ usleep(50000); // Simulate work
+ $bar->setMessage("Processing item {$item}");
+ });
+
+ return 0;
+}
+```
+
+**[๐ View Progress Bar Example](https://github.com/WebFiori/cli/tree/main/examples/07-progress-bars)**
+
+### Table Display
+
+Display data in formatted tables:
+
+```php
+public function exec(): int {
+ $data = [
+ ['Ahmed Hassan', 30, 'Cairo'],
+ ['Sarah Johnson', 25, 'Los Angeles']
+ ];
+ $headers = ['Name', 'Age', 'City'];
+
+ $this->table($data, $headers);
+
+ return 0;
+}
+```
+
+**[๐ View Table Display Example](https://github.com/WebFiori/cli/tree/main/examples/06-table-display)**
+
+## The `help` Command
+One of the commands which comes by default with the library is the `help` command. It can be used to display help instructions for all registered commands.
+
+> Note: In order to use this command, it must be registered using the method `Runner::register()`.
+
+### Setting Help Instructions
+
+Help instructions are provided by the developer who created the command during its implementation. Instructions can be set on the constructor of the class that extends the class `WebFiori\Cli\Command` as a description. The description can be set for the command and its arguments.
+
+``` php
+ [
+ Option::DESCRIPTION => 'Name of someone to greet.',
+ Option::OPTIONAL => true
+ ]
+ ], 'A command to show greetings.');
+ }
+
+ public function exec(): int {
+ $name = $this->getArgValue('--person-name');
+
+ if ($name === null) {
+ $this->println("Hello World!");
+ } else {
+ $this->println("Hello %s!", $name);
+ }
+
+ return 0;
+ }
+}
+
+```
+
+### Running `help` Command
+
+Help command can be used in two ways, one way is to display a general help for the application and another one for specific command.
+
+#### General Help
+
+To show general help of the application, following command can be executed.
+
+``` bash
+php main.php help
+```
+
+Output of this command will be as follows:
+
+```
+Usage:
+ command [arg1 arg2="val" arg3...]
+
+Global Arguments:
+ --ansi:[Optional] Force the use of ANSI output.
+Available Commands:
+ help: Display CLI Help. To display help for specific command, use the argument "--command-name" with this command.
+ hello: A command to show greetings.
+ open-file: Reads a text file and display its content.
+
+```
+
+> Note: Depending on registered commands, output may differ.
+
+#### Command-Specific Help
+
+To show help instructions for a specific command, the name of the command can be included using the argument `--command-name` as follows:
+
+``` bash
+php main.php help --command-name=hello
+```
+
+Output of this command will be as follows:
+
+```
+hello: A command to show greetings.
+ Supported Arguments:
+ --person-name:[Optional] Name of someone to greet.
+```
+
+## Unit-Testing Commands
+
+The library provides the helper class `WebFiori\Cli\CommandTestCase` which can be used to write unit tests for different commands. The developer has to only extend the class and use utility methods to write tests. The class is based on PHPUnit.
+
+The class has two methods which can be used to execute tests:
+
+* `CommandTestCase::executeSingleCommand()`: Used to run one command at a time and return its output.
+* `CommandTestCase::executeMultiCommand()`: Used to register multiple commands, set default command and/or run one of registered commands.
+
+First method is good to verify the output of one specific command. The second one is useful to simulate the execution of an application with multiple commands.
+
+Both methods support simulating arguments vector and user inputs.
+
+
+``` php
+namespace tests\cli;
+
+use WebFiori\Cli\CommandTestCase;
+
+class HelloCommandTest extends CommandTestCase {
+ /**
+ * @test
+ */
+ public function test00() {
+
+ //Verify test results
+
+ $this->assertEquals([
+ "Hello World!\n"
+ ], $this->executeSingleCommand(new HelloWorldCommand()));
+ $this->assertEquals(0, $this->getExitCode());
+ }
+}
+
+```
+
+**[๐ View Testing Examples](https://github.com/WebFiori/cli/tree/main/examples/10-multi-command-app)**
+
+## Examples
+
+Explore comprehensive examples to learn different aspects of WebFiori CLI:
+
+### Basic Examples
+- **[๐ Basic Command](https://github.com/WebFiori/cli/tree/main/examples/01-basic-hello-world)** - Create your first CLI command
+- **[๐ Command with Arguments](https://github.com/WebFiori/cli/tree/main/examples/02-arguments-and-options)** - Handle command-line arguments
+- **[๐ User Input](https://github.com/WebFiori/cli/tree/main/examples/03-user-input)** - Read and validate user input
+- **[๐ Output Formatting](https://github.com/WebFiori/cli/tree/main/examples/04-output-formatting)** - Colors and text formatting
+
+### Advanced Examples
+- **[๐ Interactive Commands](https://github.com/WebFiori/cli/tree/main/examples/05-interactive-commands)** - Build interactive CLI applications
+- **[๐ Table Display](https://github.com/WebFiori/cli/tree/main/examples/06-table-display)** - Format data in tables
+- **[๐ Progress Bars](https://github.com/WebFiori/cli/tree/main/examples/07-progress-bars)** - Visual progress indicators
+- **[๐ File Processing](https://github.com/WebFiori/cli/tree/main/examples/08-file-processing)** - File manipulation commands
+- **[๐ Database Operations](https://github.com/WebFiori/cli/tree/main/examples/09-database-ops)** - Database CLI commands
+
+### Complete Applications
+- **[๐ Multi-Command Application](https://github.com/WebFiori/cli/tree/main/examples/10-multi-command-app)** - Full-featured CLI application
+
+### Quick Links
+- **[๐ All Examples](https://github.com/WebFiori/cli/tree/main/examples)** - Browse all available examples
+- **[๐ Sample App](https://github.com/WebFiori/cli/tree/main/examples/10-multi-command-app/main.php)** - Ready-to-run sample application
+
+
+---
+
+**Ready to build amazing CLI applications? Start with the [๐ Basic Command Example](https://github.com/WebFiori/cli/tree/main/examples/01-basic-hello-world) and work your way up!**
diff --git a/WebFiori/Cli/Argument.php b/WebFiori/Cli/Argument.php
index f635185..c60f604 100644
--- a/WebFiori/Cli/Argument.php
+++ b/WebFiori/Cli/Argument.php
@@ -1,278 +1,278 @@
-setName($name)) {
- $this->name = 'arg';
- }
- $this->isOptional = $optional;
- $this->allowedValues = [];
- $this->default = '';
- $this->description = $description;
- }
- /**
- * Adds a value to the set of allowed argument values.
- *
- * @param string $val A string that represents the value.
- *
- * @return Argument The method will return the same instance at which
- * the method was called on.
- */
- public function addAllowedValue(string $val) : Argument {
- $trim = trim($val);
-
- if (!in_array($trim, $this->getAllowedValues())) {
- $this->allowedValues[] = $trim;
- }
-
- return $this;
- }
- /**
- * Creates an instance of the class provided its name and a set of options.
- *
- * @param string $name The name of the command such as 'help'
- *
- * @param array $options An associative array of options which is used to
- * configure created instance. Supported options are:
- *
- *
optional: A boolean. if set to true, it means that the argument
- * is optional and can be ignored when running the command.
- *
default: An optional default value for the argument
- * to use if it is not provided and is optional.
- *
description: A description of the argument which
- * will be shown if the command 'help' is executed.
- *
values: A set of values that the argument can have. If provided,
- * only the values on the list will be allowed. Note that if null or empty string
- * is in the array, it will be ignored. Also, if boolean values are
- * provided, true will be converted to the string 'y' and false will
- * be converted to the string 'n'.
- *
- *
- * @return Argument|null If the instance is created, the method will
- * return it as an object. Other than that, null is returned.
- */
- public static function create(string $name, array $options) {
- if (strlen($name) == 0) {
- return null;
- }
- $arg = new Argument($name);
-
- if ($arg->getName() == 'arg') {
- return null;
- }
-
- if (isset($options[ArgumentOption::OPTIONAL])) {
- $arg->setIsOptional($options[ArgumentOption::OPTIONAL]);
- }
- $desc = isset($options[ArgumentOption::DESCRIPTION]) ? trim($options[ArgumentOption::DESCRIPTION]) : '';
-
- if (strlen($desc) != 0) {
- $arg->setDescription($desc);
- } else {
- $arg->setDescription('');
- }
- $allowedValues = $options[ArgumentOption::VALUES] ?? [];
-
- foreach ($allowedValues as $val) {
- $arg->addAllowedValue($val);
- }
-
- if (isset($options[ArgumentOption::DEFAULT]) && gettype($options[ArgumentOption::DEFAULT]) == 'string') {
- $arg->setDefault($options[ArgumentOption::DEFAULT]);
- }
-
- return $arg;
- }
- /**
- * Extract the value of an argument give its name.
- *
- * @param string $argName The name of the argument as provided
- * in the terminal.
- *
- * @return string|null If the argument is provided and its value is set,
- * the method will return its value. If provided without any value,
- * the method will return empty string. If not provided, null is returned.
- */
- public static function extractValue(string $argName, ?Runner $runner = null) {
- $trimmedOptName = trim($argName);
-
- if ($runner !== null) {
- $argsV = $runner->getArgsVector();
- } else {
- $argsV = $_SERVER['argv'];
- }
-
- foreach ($argsV as $option) {
- $optionClean = filter_var($option);
- $optExpl = explode('=', $optionClean);
- $optionNameFromCLI = $optExpl[0];
-
- if ($optionNameFromCLI == $trimmedOptName) {
- if (count($optExpl) == 2) {
- return trim(trim(trim($optExpl[1],'"'), "'"));
- } else {
- //If arg is provided, set its value empty string
- return '';
- }
- }
- }
-
- return null;
- }
- /**
- * Returns an array that contains all allowed argument values.
- *
- * @return array An array that contains all allowed argument values.
- */
- public function getAllowedValues() : array {
- return $this->allowedValues;
- }
- /**
- * Returns the default value of the argument.
- *
- * @return string The default value of the argument. Default return value is
- * empty string.
- */
- public function getDefault() : string {
- return $this->default;
- }
- /**
- * Returns a string that represents the description of the argument.
- *
- * The value is used by the command 'help' to show argument help.
- *
- * @return string A string that represents the description of the argument.
- * Default is empty string.
- */
- public function getDescription() : string {
- return $this->description;
- }
- /**
- * Returns the name of the argument.
- *
- *
- * @return string The name of the argument. Default return value is 'arg'.
- */
- public function getName() : string {
- return $this->name;
- }
- /**
- * Returns the value of the argument as provided in the terminal.
- *
- * @return string|null If set, the method will return its value as string.
- * If not set, null is returned. Note that if the argument is provided in
- * terminal but its value is not set, the returned value will be empty
- * string.
- */
- public function getValue(): ?string {
- return $this->value;
- }
- /**
- * Checks if the argument is optional or not.
- *
- * @return bool If the argument is set as optional, the method will return
- * true. False if not optional. Default is false.
- */
- public function isOptional() : bool {
- return $this->isOptional;
- }
- /**
- * Reset the value of the argument and set it to null.
- */
- public function resetValue(): void {
- $this->value = null;
- }
- /**
- * Sets a string as default value for the argument.
- *
- * @param string $default A string that will be set as default value if the
- * argument is not provided in terminal. Note that the value will be trimmed.
- */
- public function setDefault(string $default): void {
- $this->default = trim($default);
- }
- /**
- * Sets the description of the argument.
- *
- * The value is used by the command 'help' to show argument help.
- *
- * @param string $desc A string that represents the description of the argument.
- */
- public function setDescription(string $desc): void {
- $this->description = trim($desc);
- }
- /**
- * Make the argument as optional argument or mandatory.
- *
- * @param bool $optional True to make it optional. False to make it mandatory.
- */
- public function setIsOptional(bool $optional): void {
- $this->isOptional = $optional;
- }
- /**
- * Sets the name of the argument.
- *
- * @param string $name A string such as '--config' or similar. It must be
- * non-empty string and have no spaces.
- *
- * @return boolean If set, the method will return true. False otherwise.
- */
- public function setName(string $name) : bool {
- $trimmed = trim($name);
-
- if (strlen($trimmed) == 0 || strpos($trimmed, ' ') !== false) {
- return false;
- }
- $this->name = $trimmed;
-
- return true;
- }
- /**
- * Sets the value of the argument.
- *
- * Note that the method will return false only if the argument can have a
- * fixed set of values and provided value is not one of them.
- *
- * @param string $val The value to set. Note that spaces in the provided value
- * will be trimmed.
- *
- * @return bool If the value of the argument is set, the method will return
- * true. If not, the method will return false.
- */
- public function setValue(string $val) : bool {
- $allowed = $this->getAllowedValues();
-
- if (count($allowed) == 0 || in_array($val, $allowed)) {
- $this->value = trim($val);
-
- return true;
- }
-
- return false;
- }
-}
+setName($name)) {
+ $this->name = 'arg';
+ }
+ $this->isOptional = $optional;
+ $this->allowedValues = [];
+ $this->default = '';
+ $this->description = $description;
+ }
+ /**
+ * Adds a value to the set of allowed argument values.
+ *
+ * @param string $val A string that represents the value.
+ *
+ * @return Argument The method will return the same instance at which
+ * the method was called on.
+ */
+ public function addAllowedValue(string $val) : Argument {
+ $trim = trim($val);
+
+ if (!in_array($trim, $this->getAllowedValues())) {
+ $this->allowedValues[] = $trim;
+ }
+
+ return $this;
+ }
+ /**
+ * Creates an instance of the class provided its name and a set of options.
+ *
+ * @param string $name The name of the command such as 'help'
+ *
+ * @param array $options An associative array of options which is used to
+ * configure created instance. Supported options are:
+ *
+ *
optional: A boolean. if set to true, it means that the argument
+ * is optional and can be ignored when running the command.
+ *
default: An optional default value for the argument
+ * to use if it is not provided and is optional.
+ *
description: A description of the argument which
+ * will be shown if the command 'help' is executed.
+ *
values: A set of values that the argument can have. If provided,
+ * only the values on the list will be allowed. Note that if null or empty string
+ * is in the array, it will be ignored. Also, if boolean values are
+ * provided, true will be converted to the string 'y' and false will
+ * be converted to the string 'n'.
+ *
+ *
+ * @return Argument|null If the instance is created, the method will
+ * return it as an object. Other than that, null is returned.
+ */
+ public static function create(string $name, array $options) {
+ if (strlen($name) == 0) {
+ return null;
+ }
+ $arg = new Argument($name);
+
+ if ($arg->getName() == 'arg') {
+ return null;
+ }
+
+ if (isset($options[ArgumentOption::OPTIONAL])) {
+ $arg->setIsOptional($options[ArgumentOption::OPTIONAL]);
+ }
+ $desc = isset($options[ArgumentOption::DESCRIPTION]) ? trim($options[ArgumentOption::DESCRIPTION]) : '';
+
+ if (strlen($desc) != 0) {
+ $arg->setDescription($desc);
+ } else {
+ $arg->setDescription('');
+ }
+ $allowedValues = $options[ArgumentOption::VALUES] ?? [];
+
+ foreach ($allowedValues as $val) {
+ $arg->addAllowedValue($val);
+ }
+
+ if (isset($options[ArgumentOption::DEFAULT]) && gettype($options[ArgumentOption::DEFAULT]) == 'string') {
+ $arg->setDefault($options[ArgumentOption::DEFAULT]);
+ }
+
+ return $arg;
+ }
+ /**
+ * Extract the value of an argument give its name.
+ *
+ * @param string $argName The name of the argument as provided
+ * in the terminal.
+ *
+ * @return string|null If the argument is provided and its value is set,
+ * the method will return its value. If provided without any value,
+ * the method will return empty string. If not provided, null is returned.
+ */
+ public static function extractValue(string $argName, ?Runner $runner = null) {
+ $trimmedOptName = trim($argName);
+
+ if ($runner !== null) {
+ $argsV = $runner->getArgsVector();
+ } else {
+ $argsV = $_SERVER['argv'];
+ }
+
+ foreach ($argsV as $option) {
+ $optionClean = filter_var($option);
+ $optExpl = explode('=', $optionClean);
+ $optionNameFromCLI = $optExpl[0];
+
+ if ($optionNameFromCLI == $trimmedOptName) {
+ if (count($optExpl) == 2) {
+ return trim(trim(trim($optExpl[1],'"'), "'"));
+ } else {
+ //If arg is provided, set its value empty string
+ return '';
+ }
+ }
+ }
+
+ return null;
+ }
+ /**
+ * Returns an array that contains all allowed argument values.
+ *
+ * @return array An array that contains all allowed argument values.
+ */
+ public function getAllowedValues() : array {
+ return $this->allowedValues;
+ }
+ /**
+ * Returns the default value of the argument.
+ *
+ * @return string The default value of the argument. Default return value is
+ * empty string.
+ */
+ public function getDefault() : string {
+ return $this->default;
+ }
+ /**
+ * Returns a string that represents the description of the argument.
+ *
+ * The value is used by the command 'help' to show argument help.
+ *
+ * @return string A string that represents the description of the argument.
+ * Default is empty string.
+ */
+ public function getDescription() : string {
+ return $this->description;
+ }
+ /**
+ * Returns the name of the argument.
+ *
+ *
+ * @return string The name of the argument. Default return value is 'arg'.
+ */
+ public function getName() : string {
+ return $this->name;
+ }
+ /**
+ * Returns the value of the argument as provided in the terminal.
+ *
+ * @return string|null If set, the method will return its value as string.
+ * If not set, null is returned. Note that if the argument is provided in
+ * terminal but its value is not set, the returned value will be empty
+ * string.
+ */
+ public function getValue(): ?string {
+ return $this->value;
+ }
+ /**
+ * Checks if the argument is optional or not.
+ *
+ * @return bool If the argument is set as optional, the method will return
+ * true. False if not optional. Default is false.
+ */
+ public function isOptional() : bool {
+ return $this->isOptional;
+ }
+ /**
+ * Reset the value of the argument and set it to null.
+ */
+ public function resetValue(): void {
+ $this->value = null;
+ }
+ /**
+ * Sets a string as default value for the argument.
+ *
+ * @param string $default A string that will be set as default value if the
+ * argument is not provided in terminal. Note that the value will be trimmed.
+ */
+ public function setDefault(string $default): void {
+ $this->default = trim($default);
+ }
+ /**
+ * Sets the description of the argument.
+ *
+ * The value is used by the command 'help' to show argument help.
+ *
+ * @param string $desc A string that represents the description of the argument.
+ */
+ public function setDescription(string $desc): void {
+ $this->description = trim($desc);
+ }
+ /**
+ * Make the argument as optional argument or mandatory.
+ *
+ * @param bool $optional True to make it optional. False to make it mandatory.
+ */
+ public function setIsOptional(bool $optional): void {
+ $this->isOptional = $optional;
+ }
+ /**
+ * Sets the name of the argument.
+ *
+ * @param string $name A string such as '--config' or similar. It must be
+ * non-empty string and have no spaces.
+ *
+ * @return boolean If set, the method will return true. False otherwise.
+ */
+ public function setName(string $name) : bool {
+ $trimmed = trim($name);
+
+ if (strlen($trimmed) == 0 || strpos($trimmed, ' ') !== false) {
+ return false;
+ }
+ $this->name = $trimmed;
+
+ return true;
+ }
+ /**
+ * Sets the value of the argument.
+ *
+ * Note that the method will return false only if the argument can have a
+ * fixed set of values and provided value is not one of them.
+ *
+ * @param string $val The value to set. Note that spaces in the provided value
+ * will be trimmed.
+ *
+ * @return bool If the value of the argument is set, the method will return
+ * true. If not, the method will return false.
+ */
+ public function setValue(string $val) : bool {
+ $allowed = $this->getAllowedValues();
+
+ if (count($allowed) == 0 || in_array($val, $allowed)) {
+ $this->value = trim($val);
+
+ return true;
+ }
+
+ return false;
+ }
+}
diff --git a/WebFiori/Cli/ArgumentOption.php b/WebFiori/Cli/ArgumentOption.php
index 61678d1..d2f9c46 100644
--- a/WebFiori/Cli/ArgumentOption.php
+++ b/WebFiori/Cli/ArgumentOption.php
@@ -1,30 +1,30 @@
-
- *
optional: A boolean. if set to true, it means that the argument
- * is optional and can be ignored when running the command.
- *
default: An optional default value for the argument
- * to use if it is not provided and is optional.
- *
description: A description of the argument which
- * will be shown if the command 'help' is executed.
- *
values: A set of values that the argument can have. If provided,
- * only the values on the list will be allowed. Note that if null or empty string
- * is in the array, it will be ignored. Also, if boolean values are
- * provided, true will be converted to the string 'y' and false will
- * be converted to the string 'n'.
- *
- *
- * @param string $description A string that describes what does the job
- * do. The description will appear when the command 'help' is executed.
- *
- * @param array $aliases An optional array of aliases for the command.
- */
- public function __construct(string $commandName, array $args = [], string $description = '', array $aliases = []) {
- if (!$this->setName($commandName)) {
- $this->setName('new-command');
- }
- $this->aliases = $aliases;
- $this->addArgs($args);
-
- if (!$this->setDescription($description)) {
- $this->setDescription('');
- }
- }
- /**
- * Add command argument.
- *
- * An argument is a string that comes after the name of the command. The value
- * of an argument can be set using equal sign. For example, if command name
- * is 'do-it' and one argument has the name 'what-to-do', then the full
- * CLI command would be "do-it what-to-do=say-hi". An argument can be
- * also treated as an option.
- *
- * @param string $name The name of the argument. It must be non-empty string
- * and does not contain spaces. Note that if the argument is already added and
- * the developer is trying to add it again, the new options array will override
- * the existing options array.
- *
- * @param array $options An optional array of options. Available options are:
- *
- *
optional: A boolean. if set to true, it means that the argument
- * is optional and can be ignored when running the command.
- *
default: An optional default value for the argument
- * to use if it is not provided and is optional.
- *
description: A description of the argument which
- * will be shown if the command 'help' is executed.
- *
values: A set of values that the argument can have. If provided,
- * only the values on the list will be allowed. Note that if null or empty string
- * is in the array, it will be ignored. Also, if boolean values are
- * provided, true will be converted to the string 'y' and false will
- * be converted to the string 'n'.
- *
- *
- * @return bool If the argument is added, the method will return true.
- * Other than that, the method will return false.
- *
- */
- public function addArg(string $name, array $options = []) : bool {
- $toAdd = Argument::create($name, $options);
-
- if ($toAdd === null) {
- return false;
- }
-
- return $this->addArgument($toAdd);
- }
- /**
- * Adds multiple arguments to the command.
- *
- * @param array $arr An associative array of sub associative arrays. The
- * key of each sub array is argument name. This can also be
- * an array of objects of type 'CommandArgument'. For arrays, Each
- * sub-array can have the following indices:
- *
- *
optional: A boolean. if set to true, it means that the argument
- * is optional and can be ignored when running the command.
- *
default: An optional default value for the argument
- * to use if it is not provided and is optional.
- *
description: A description of the argument which
- * will be shown if the command 'help' is executed.
- *
values: A set of values that the argument can have. If provided,
- * only the values on the list will be allowed. Note that if null or empty string
- * is in the array, it will be ignored. Also, if boolean values are
- * provided, true will be converted to the string 'y' and false will
- * be converted to the string 'n'.
- *
- */
- public function addArgs(array $arr): void {
- $this->commandArgs = [];
-
- foreach ($arr as $optionName => $options) {
- if ($options instanceof Argument) {
- $this->addArgument($options);
- } else {
- $this->addArg($optionName, $options);
- }
- }
- }
- /**
- * Adds new command argument.
- *
- * @param Argument $arg The argument that will be added.
- *
- * @return bool If the argument is added, the method will return true.
- * If not, false is returned. The argument will not be added only if an argument
- * which has same name is added.
- */
- public function addArgument(Argument $arg) : bool {
- if (!$this->hasArg($arg->getName())) {
- $this->commandArgs[] = $arg;
-
- return true;
- }
-
- return false;
- }
- /**
- * Clears the output before or after cursor position.
- *
- * This method will replace the visible characters with spaces.
- * Note that support for this operation depends on terminal support for
- * ANSI escape codes.
- *
- * @param int $numberOfCols Number of columns to clear. The columns that
- * will be cleared are before and after cursor position. They don't include
- * the character at which the cursor is currently pointing to.
- * @param bool $beforeCursor If set to true, the characters which
- * are before the cursor will be cleared. Default is true.
- *
- * @return Command The method will return the instance at which the
- * method is called on.
- *
- */
- public function clear(int $numberOfCols = 1, bool $beforeCursor = true) : Command {
- if ($numberOfCols >= 1 && $beforeCursor) {
- for ($x = 0 ; $x < $numberOfCols ; $x++) {
- $this->moveCursorLeft();
- $this->prints(" ");
- $this->moveCursorLeft();
- }
- $this->moveCursorRight($numberOfCols);
- } else if ($numberOfCols >= 1) {
- $this->moveCursorRight();
-
- for ($x = 0 ; $x < $numberOfCols ; $x++) {
- $this->prints(" ");
- }
- $this->moveCursorLeft($numberOfCols + 1);
- }
-
- return $this;
- }
- /**
- * Clears the whole content of the console.
- *
- * Note that support for this operation depends on terminal support for
- * ANSI escape codes.
- *
- * @return Command The method will return the instance at which the
- * method is called on.
- */
- public function clearConsole() : Command {
- $this->prints("\ec");
-
- return $this;
- }
- /**
- * Clears the line at which the cursor is in and move it back to the start
- * of the line.
- *
- * Note that support for this operation depends on terminal support for
- * ANSI escape codes.
- *
- */
- public function clearLine(): void {
- $this->prints("\e[2K");
- $this->prints("\r");
- }
- /**
- * Asks the user to conform something.
- *
- * This method will display the question and wait for the user to confirm the
- * action by entering 'y' or 'n' in the terminal. If the user give something
- * other than 'Y' or 'n', it will show an error and ask him to confirm
- * again. If a default answer is provided, it will appear in upper case in the
- * terminal. For example, if default is set to true, at the end of the prompt,
- * the string that shows the options would be like '(Y/n)'.
- *
- * @param string $confirmTxt The text of the question of which will be asked.
- *
- * @param bool|null $default Default answer to use if empty input is given.
- * It can be true for 'y' and false for 'n'. Default value is null which
- * means no default will be used.
- *
- * @return bool If the user choose 'y', the method will return true. If
- * he chooses 'n', the method will return false.
- *
- *
- */
- public function confirm(string $confirmTxt, ?bool $default = null) : bool {
- $answer = null;
-
- do {
- if ($default === true) {
- $optionsStr = '(Y/n)';
- } else if ($default === false) {
- $optionsStr = '(y/N)';
- } else {
- $optionsStr = '(y/n)';
- }
- $this->prints(trim($confirmTxt), [
- 'color' => 'gray',
- 'bold' => true
- ]);
- $this->println($optionsStr, [
- 'color' => 'light-blue'
- ]);
-
- $input = strtolower(trim($this->readln()));
-
- if ($input == 'n') {
- $answer = false;
- } else if ($input == 'y') {
- $answer = true;
- } else if (strlen($input) == 0 && $default !== null) {
- return $default === true;
- } else {
- $this->error('Invalid answer. Choose \'y\' or \'n\'.');
- }
- } while ($answer === null);
-
- return $answer;
- }
-
- /**
- * Creates and returns a new progress bar instance.
- *
- * @param int $total Total number of steps
- * @return ProgressBar
- */
- public function createProgressBar(int $total = 100): ProgressBar {
- return new ProgressBar($this->getOutputStream(), $total);
- }
- /**
- * Display a message that represents an error.
- *
- * The message will be prefixed with the string 'Error:' in
- * red.
- *
- * @param string $message The message that will be shown.
- *
- */
- public function error(string $message): void {
- $this->printMsg($message, 'Error', 'light-red');
- }
- /**
- * Execute the command.
- *
- * This method should not be called manually by the developer.
- *
- * @return int If the command is executed, the method will return 0.
- * Other than that, it will return a number which depends on the return value of
- * the method 'Command::exec()'.
- *
- */
- public function excCommand() : int {
- $retVal = -1;
-
- $runner = $this->getOwner();
-
- if ($runner !== null) {
- foreach ($runner->getArgs() as $arg) {
- $this->addArgument($arg);
- }
- }
-
- if ($this->parseArgsHelper()) {
- // Check for help first, before validating required arguments
- if ($this->isArgProvided('help') || $this->isArgProvided('-h')) {
- $help = $runner->getCommandByName('help');
- $help->setArgValue('--command', $this->getName());
- $help->setOwner($runner);
- $help->setOutputStream($runner->getOutputStream());
- $this->removeArgument('help');
-
- return $help->exec();
- } else if ($this->checkIsArgsSetHelper()) {
- $retVal = $this->exec();
- }
-
- }
-
- if ($runner !== null) {
- foreach ($runner->getArgs() as $arg) {
- $this->removeArgument($arg->getName());
- $arg->resetValue();
- }
- }
-
- return $retVal;
- }
- /**
- * Execute the command.
- *
- * The implementation of this method should contain the code that will run
- * when the command is executed.
- *
- * @return int The developer should implement this method in a way it returns 0
- * if the command is executed successfully and return -1 if the
- * command did not execute successfully.
- *
- */
- public abstract function exec() : int;
- /**
- * Execute a registered command using a sub-runner.
- *
- * This method can be used to execute a registered command within the runner
- * using another
- * runner instance which shares argsv, input and output streams with the
- * main runner. It can be used to invoke another command from within a
- * running command.
- *
- * @param string $name The name of the command. It must be a part of
- * registered commands.
- *
- * @param array $additionalArgs An associative array that represents additional arguments
- * to be passed to the command.
- *
- * @return int The method will return an integer that represent exit status
- * code of the command after execution.
- */
- public function execSubCommand(string $name, array $additionalArgs = []) : int {
- $runner = $this->getOwner();
-
- if ($runner === null) {
- return -1;
- }
-
- return $runner->runCommandAsSub($name, $additionalArgs);
- }
- /**
- * Returns an array of aliases for the command.
- *
- * @return array An array of aliases.
- */
- public function getAliases() : array {
- return $this->aliases;
- }
-
- /**
- * Sets the aliases for the command.
- *
- * @param array $aliases An array of aliases.
- */
- public function setAliases(array $aliases): void {
- $this->aliases = $aliases;
- }
-
- /**
- * Adds an alias to the command.
- *
- * @param string $alias The alias to add.
- */
- public function addAlias(string $alias): void {
- if (!in_array($alias, $this->aliases)) {
- $this->aliases[] = $alias;
- }
- }
- /**
- * Returns an object that holds argument info if the command.
- *
- * @param string $name The name of command argument.
- *
- * @return Argument|null If the command has an argument with the
- * given name, it will be returned. Other than that, null is returned.
- */
- public function getArg(string $name): ?Argument {
- foreach ($this->getArgs() as $arg) {
- if ($arg->getName() == $name) {
- return $arg;
- }
- }
-
- return null;
- }
- /**
- * Returns an associative array that contains command args.
- *
- * @return array An associative array. The indices of the array are
- * the names of the arguments and the values are sub-associative arrays.
- * the sub arrays will have the following indices:
- *
- *
optional
- *
description
- *
default
- *
- * Note that the last index might not be set.
- *
- */
- public function getArgs() : array {
- return $this->commandArgs;
- }
- /**
- * Returns an array that contains the names of command arguments.
- *
- * @return array An array of strings.
- */
- public function getArgsNames() : array {
- return array_map(function ($el) {
- return $el->getName();
- }, $this->getArgs());
- }
- /**
- * Returns the value of command option from CLI given its name.
- *
- * @param string $optionName The name of the option.
- *
- * @return string|null If the value of the option is set, the method will
- * return its value as string. If it is not set, the method will return null.
- *
- */
- public function getArgValue(string $optionName): ?string {
- $trimmedOptName = trim($optionName);
- $arg = $this->getArg($trimmedOptName);
-
- if ($arg !== null) {
- $runner = $this->getOwner();
-
- // Always return the set value if it exists, regardless of interactive mode
- if ($arg->getValue() !== null) {
- return $arg->getValue();
- }
-
- return Argument::extractValue($trimmedOptName, $runner);
- }
-
- return null;
- }
- /**
- * Returns the description of the command.
- *
- * The description of the command is a string that describes what does the
- * command do, and it will appear in CLI if the command 'help' is executed.
- *
- * @return string The description of the command. Default return value
- * is '<NO DESCRIPTION>'
- *
- */
- public function getDescription() : string {
- return $this->description;
- }
-
- /**
- * Take an input value from the user.
- *
- * @param string $prompt The string that will be shown to the user. The
- * string must be non-empty.
- *
- * @param string|null $default An optional default value to use in case the user
- * hit "Enter" without entering any value. If null is passed, no default
- * value will be set.
- *
- * @param InputValidator|null $validator A callback that can be used to validate user
- * input. The callback accepts one parameter which is the value that
- * the user has given. If the value is valid, the callback must return true.
- * If the callback returns anything else, it means the value which is given
- * by the user is invalid and this method will ask the user to enter the
- * value again.
- *
- * @return string|null The method will return the value which was taken from the
- * user. If prompt string is empty, null will be returned.
- * Note that if the input has special characters or spaces at the
- * beginning or the end, they will be trimmed.
- *
- */
- public function getInput(string $prompt, ?string $default = null, ?InputValidator $validator = null): ?string {
- $trimmed = trim($prompt);
-
- if (strlen($trimmed) > 0) {
- do {
- $this->prints($trimmed, [
- 'color' => 'gray',
- 'bold' => true
- ]);
-
- if ($default !== null) {
- $this->prints(" Enter = '".$default."'", [
- 'color' => 'light-blue'
- ]);
- }
- $this->println();
- $input = trim($this->readln());
-
- $check = $this->getInputHelper($input, $validator, $default);
-
- if ($check['valid']) {
- return $check['value'];
- }
- } while (true);
- }
-
- return null;
- }
- /**
- * Reads user input with characters masked by a specified character.
- *
- * This method is similar to getInput() but masks the input characters as the user types,
- * making it suitable for sensitive information like passwords, tokens, or secrets.
- * The actual input value is captured but only mask characters are displayed in the terminal.
- *
- * @param string $prompt The prompt message to display to the user. Must be non-empty.
- *
- * @param string $mask The character to display instead of the actual input characters.
- * Default is '*'. Can be any single character or string.
- *
- * @param string|null $default An optional default value to use if the user provides
- * empty input. If provided, it will be shown in the prompt.
- *
- * @param InputValidator|null $validator An optional validator to validate the input.
- * If validation fails, the user will be prompted again.
- *
- * @return string|null Returns the actual input value (not masked) if valid input is provided,
- * or null if the prompt is empty.
- *
- * @since 1.1.0
- */
- public function getMaskedInput(string $prompt, string $mask = '*', ?string $default = null, ?InputValidator $validator = null): ?string {
- $trimmed = trim($prompt);
-
- if (strlen($trimmed) > 0) {
- do {
- $this->prints($trimmed, [
- 'color' => 'gray',
- 'bold' => true
- ]);
-
- if ($default !== null) {
- $this->prints(" Enter = '".$default."'", [
- 'color' => 'light-blue'
- ]);
- }
- $this->println();
- $input = trim($this->readMaskedLine($mask));
-
- $check = $this->getInputHelper($input, $validator, $default);
-
- if ($check['valid']) {
- return $check['value'];
- }
- } while (true);
- }
-
- return null;
- } /**
- * Returns the stream at which the command is sing to read inputs.
- *
- * @return null|InputStream If the stream is set, it will be returned as
- * an object. Other than that, the method will return null.
- *
- */
- public function getInputStream() : InputStream {
- return $this->inputStream;
- }
-
- /**
- * Check if the current input stream supports interactive input.
- *
- * @return bool True if the input stream supports interactive input (real-time user interaction),
- * false otherwise (files, pipes, arrays, etc.)
- */
- public function supportsInteractiveInput(): bool {
- $stream = $this->getInputStream();
-
- // Only StdIn with tty supports true interaction
- if ($stream instanceof Streams\StdIn) {
- return function_exists('posix_isatty') && posix_isatty(STDIN);
- }
-
- // All other stream types are non-interactive
- return false;
- }
- /**
- * Returns the name of the command.
- *
- * The name of the command is a string which is used to call the command
- * from CLI.
- *
- * @return string The name of the command (such as 'v' or 'help'). Default
- * return value is 'new-command'.
- *
- */
- public function getName() : string {
- return $this->commandName;
- }
- /**
- * Returns the stream at which the command is using to send output.
- *
- * @return null|OutputStream If the stream is set, it will be returned as
- * an object. Other than that, the method will return null.
- *
- */
- public function getOutputStream() : OutputStream {
- return $this->outputStream;
- }
- /**
- * Returns the runner which is used to execute the command.
- *
- * @return Runner|null If the command was called using a runner, this method
- * will return an instance that can be used to access runner's properties.
- * If not called through a runner, null is returned.
- */
- public function getOwner(): ?Runner {
- return $this->owner;
- }
- /**
- * Checks if the command has a specific command line argument or not.
- *
- * @param string $argName The name of the command line argument.
- *
- * @return bool If the argument is added to the command, the method will
- * return true. If no argument which has the given name does exist, the method
- * will return false.
- *
- */
- public function hasArg(string $argName) : bool {
- foreach ($this->getArgs() as $arg) {
- if ($arg->getName() == $argName) {
- return true;
- }
- }
-
- return false;
- }
- /**
- * Display a message that represents extra information.
- *
- * The message will be prefixed with the string 'Info:' in
- * blue.
- *
- * @param string $message The message that will be shown.
- *
- */
- public function info(string $message): void {
- $this->printMsg($message, 'Info', 'blue');
- }
- /**
- * Checks if an argument is provided in the CLI or not.
- *
- * The method will not check if the argument has a value or not.
- *
- * @param string $argName The name of the command line argument.
- *
- * @return bool If the argument is provided, the method will return
- * true. Other than that, the method will return false.
- *
- */
- public function isArgProvided(string $argName) : bool {
- $argObj = $this->getArg($argName);
-
- if ($argObj !== null) {
- return $argObj->getValue() !== null;
- }
-
- return false;
- }
- /**
- * Moves the cursor down by specific number of lines.
- *
- * Note that support for this operation depends on terminal support for
- * ANSI escape codes.
- *
- * @param int $lines The number of lines the cursor will be moved. Default
- * value is 1.
- *
- */
- public function moveCursorDown(int $lines = 1): void {
- if ($lines >= 1) {
- $this->prints("\e[".$lines."B");
- }
- }
- /**
- * Moves the cursor to the left by specific number of columns.
- *
- * Note that support for this operation depends on terminal support for
- * ANSI escape codes.
- *
- * @param int $numberOfCols The number of columns the cursor will be moved. Default
- * value is 1.
- *
- */
- public function moveCursorLeft(int $numberOfCols = 1): void {
- if ($numberOfCols >= 1) {
- $this->prints("\e[".$numberOfCols."D");
- }
- }
- /**
- * Moves the cursor to the right by specific number of columns.
- *
- * Note that support for this operation depends on terminal support for
- * ANSI escape codes.
- *
- * @param int $numberOfCols The number of columns the cursor will be moved. Default
- * value is 1.
- *
- */
- public function moveCursorRight(int $numberOfCols = 1): void {
- if ($numberOfCols >= 1) {
- $this->prints("\e[".$numberOfCols."C");
- }
- }
- /**
- * Moves the cursor to specific position in the terminal.
- *
- * If no arguments are supplied to the method, it will move the cursor
- * to the upper-left corner of the screen (line 0, column 0).
- * Note that support for this operation depends on terminal support for
- * ANSI escape codes.
- *
- * @param int $line The number of line at which the cursor will be moved
- * to. If not specified, 0 is used.
- *
- * @param int $col The number of column at which the cursor will be moved
- * to. If not specified, 0 is used.
- *
- */
- public function moveCursorTo(int $line = 0, int $col = 0): void {
- if ($line > -1 && $col > -1) {
- $this->prints("\e[".$line.";".$col."H");
- }
- }
- /**
- * Moves the cursor up by specific number of lines.
- *
- * Note that support for this operation depends on terminal support for
- * ANSI escape codes.
- *
- * @param int $lines The number of lines the cursor will be moved. Default
- * value is 1.
- *
- */
- public function moveCursorUp(int $lines = 1): void {
- if ($lines >= 1) {
- $this->prints("\e[".$lines."A");
- }
- }
- /**
- * Prints an array as a list of items.
- *
- * This method is useful if the developer would like to print out a list
- * of multiple items. Each item will be prefixed with a number that represents
- * its index in the array.
- *
- * @param array $array The array that will be printed.
- *
- */
- public function printList(array $array): void {
- for ($x = 0 ; $x < count($array) ; $x++) {
- $this->prints("- ", [
- 'color' => 'green'
- ]);
- $this->println($array[$x]);
- }
- }
- /**
- * Print out a string and terminates the current line by writing the
- * line separator string.
- *
- * This method will work like the function fprintf(). The difference is that
- * it will print out to the stream at which was specified by the method
- * Command::setOutputStream() and the text can have formatting
- * options. Note that support for output formatting depends on terminal support for
- * ANSI escape codes.
- *
- * @param string $str The string that will be printed.
- *
- * @param mixed $_ One or more extra arguments that can be supplied to the
- * method. The last argument can be an array that contains text formatting options.
- * for available options, check the method Command::formatOutput().
- */
- public function println(string $str = '', ...$_) {
- $argsCount = count($_);
-
- if ($argsCount != 0 && gettype($_[$argsCount - 1]) == 'array') {
- //Last index contains formatting options.
- $_[$argsCount - 1]['ansi'] = $this->isArgProvided('--ansi');
- $str = Formatter::format($str, $_[$argsCount - 1]);
- }
- call_user_func_array([$this->getOutputStream(), 'println'], $this->_createPassArray($str, $_));
- }
- /**
- * Print out a string.
- *
- * This method works exactly like the function 'fprintf()'. The only
- * difference is that the method will print out the output to the stream
- * that was specified using the method Command::setOutputStream() and
- * the method accepts formatting options as last argument to format the output.
- * Note that support for output formatting depends on terminal support for
- * ANSI escape codes.
- *
- * @param string $str The string that will be printed.
- *
- * @param mixed $_ One or more extra arguments that can be supplied to the
- * method. The last argument can be an array that contains text formatting options.
- * for available options, check the method Command::formatOutput().
- *
- */
- public function prints(string $str, ...$_): void {
- $argCount = count($_);
- $formattingOptions = [];
-
- if ($argCount != 0 && gettype($_[$argCount - 1]) == 'array') {
- $formattingOptions = $_[$argCount - 1];
- }
-
- $formattingOptions['ansi'] = $this->isArgProvided('--ansi');
-
- $formattedStr = Formatter::format($str, $formattingOptions);
-
- call_user_func_array([$this->getOutputStream(), 'prints'], $this->_createPassArray($formattedStr, $_));
- }
-
- /**
- * Reads a string of bytes from input stream.
- *
- * This method is used to read specific number of characters from input stream.
- *
- * @return string The method will return the string which was given as input
- * in the input stream.
- *
- */
- public function read(int $bytes = 1) : string {
- return $this->getInputStream()->read($bytes);
- }
- /**
- * Reads and validates class name.
- *
- * @param string|null $suffix An optional string to append to class name.
- *
- * @param string $prompt The text that will be shown to the user as prompt for
- * class name.
- *
- * @param string $errMsg A string to show in case provided class name is
- * not valid.
- *
- * @return string A string that represents a valid class name. If suffix is
- * not null, the method will return the name with the suffix included.
- */
- public function readClassName(string $prompt, ?string $suffix = null, string $errMsg = 'Invalid class name is given.'): ?string {
- return $this->getInput($prompt, null, new InputValidator(function (&$className, $suffix) {
- if ($suffix !== null) {
- $subSuffix = substr($className, strlen($className) - strlen($suffix));
-
- if ($subSuffix != $suffix) {
- $className .= $suffix;
- }
- }
-
- return InputValidator::isValidClassName($className);
- }, $errMsg, [$suffix]));
- }
-
- /**
- * Reads a value as float.
- *
- * @param string $prompt The string that will be shown to the user. The
- * string must be non-empty.
- *
- * @param float|null $default An optional default value to use in case the user
- * hit "Enter" without entering any value. If null is passed, no default
- * value will be set.
- *
- * @return float
- */
- public function readFloat(string $prompt, ?float $default = null) : float {
- $defaultStr = $default !== null ? (string)$default : null;
- $result = $this->getInput($prompt, $defaultStr, new InputValidator(function ($val) {
- return InputValidator::isFloat($val);
- }, 'Provided value is not a floating number!'));
- return (float)$result;
- }
-
- /**
- * Reads the namespace of class and return an instance of it.
- *
- * @param string $prompt The string that will be shown to the user. The
- * string must be non-empty.
- *
- * @param string $errMsg A string to show in case provided namespace is
- * invalid or an instance of the class cannot be created.
- *
- * @return object The method will return an instance of the class.
- *
- * @throws ReflectionException If the method was not able to initiate class instance.
- */
- public function readInstance(string $prompt, string $errMsg = 'Invalid Class!', array $constructorArgs = []): ?object {
- $clazzNs = $this->getInput($prompt, null, new InputValidator(function ($input) {
- if (InputValidator::isClass($input)) {
- return true;
- }
-
- return false;
- }, $errMsg));
-
- $reflection = new ReflectionClass($clazzNs);
-
- return $reflection->newInstanceArgs($constructorArgs);
- }
- /**
- * Reads a value as an integer.
- *
- * @param string $prompt The string that will be shown to the user. The
- * string must be non-empty.
- *
- * @param int $default An optional default value to use in case the user
- * hit "Enter" without entering any value. If null is passed, no default
- * value will be set.
- *
- * @return int
- */
- public function readInteger(string $prompt, ?int $default = null) : int {
- $defaultStr = $default !== null ? (string)$default : null;
- $result = $this->getInput($prompt, $defaultStr, new InputValidator(function ($val) {
- return InputValidator::isInt($val);
- }, 'Provided value is not an integer!'));
- return (int)$result;
- }
- /**
- * Reads one line from input stream.
- *
- * The method will continue to read from input stream till it finds end of
- * line character "\n".
- *
- * @return string The method will return the string which was taken from
- * input stream without the end of line character.
- *
- */
- public function readln() : string {
- return $this->getInputStream()->readLine();
- }
- /**
- * Reads a line from input stream with character masking.
- *
- * This method reads input character by character and displays mask characters
- * instead of the actual input. It handles backspace for character deletion
- * and ignores special keys like ESC and arrow keys.
- *
- * @param string $mask The character to display instead of actual input characters.
- *
- * @return string The actual input string (unmasked).
- *
- * @since 1.1.0
- */
- private function readMaskedLine(string $mask = '*'): string {
- $input = '';
-
- // For testing with ArrayInputStream, read the whole line at once
- if ($this->getInputStream() instanceof \WebFiori\Cli\Streams\ArrayInputStream) {
- $input = $this->getInputStream()->readLine();
- // Simulate masking output for testing
- $this->prints(str_repeat($mask, strlen($input)));
- $this->println();
- return $input;
- }
-
- // Set terminal to raw mode with echo disabled for real-time character reading
- $sttyMode = null;
- if (function_exists('shell_exec') && PHP_OS_FAMILY !== 'Windows') {
- $sttyMode = shell_exec('stty -g 2>/dev/null');
- shell_exec('stty -echo -icanon 2>/dev/null');
- }
-
- try {
- // For real terminal input, read character by character
- while (true) {
- $char = KeysMap::readAndTranslate($this->getInputStream());
-
- if ($char === 'LF' || $char === 'CR' || $char === '') {
- break;
- } elseif ($char === 'BACKSPACE' && strlen($input) > 0) {
- $input = substr($input, 0, -1);
- $this->prints("\x08 \x08"); // Backspace, space, backspace
- } elseif ($char !== 'BACKSPACE' && $char !== 'ESC' && $char !== 'DOWN' && $char !== 'UP' && $char !== 'LEFT' && $char !== 'RIGHT') {
- $input .= $char === 'SPACE' ? ' ' : $char;
- $this->prints($mask);
- }
- }
- } finally {
- // Restore terminal settings
- if ($sttyMode !== null) {
- shell_exec('stty ' . $sttyMode . ' 2>/dev/null');
- }
- }
-
- $this->println();
- return $input;
- }
- /**
- * Reads a string that represents class namespace.
- *
- * @param string $prompt The string that will be shown to the user. The
- * string must be non-empty.
- *
- * @param string $defaultNs A default string that represents default namespace.
- * Note that the method will throw an exception if this parameter does not
- * represent a valid namespace.
- *
- * @param string $errMsg A string that will be shown if provided input does
- * not represent a valid namespace.
- *
- * @return string The method will return a string that represent a valid namespace.
- *
- * @throws IOException If given default namespace does not represent a namespace.
- */
- public function readNamespace(string $prompt, ?string $defaultNs = null, string $errMsg = 'Invalid Namespace!'): ?string {
- if ($defaultNs !== null && !InputValidator::isValidNamespace($defaultNs)) {
- throw new IOException('Provided default namespace is not valid.');
- }
-
- return $this->getInput($prompt, $defaultNs, new InputValidator(function ($input) {
- if (InputValidator::isValidNamespace($input)) {
- return true;
- }
-
- return false;
- }, $errMsg));
- }
- /**
- * Removes an argument from the command given its name.
- *
- * @param string $name The name of the argument that will be removed.
- *
- * @return bool If removed, true is returned. Other than that, false is
- * returned.
- */
- public function removeArgument(string $name) : bool {
- $removed = false;
- $temp = [];
-
- foreach ($this->getArgs() as $arg) {
- if ($arg->getName() !== $name) {
- $temp[] = $arg;
- } else {
- $removed = true;
- }
- }
- $this->commandArgs = $temp;
-
- return $removed;
- }
-
- /**
- * Ask the user to select one of multiple values.
- *
- * This method will display a prompt and wait for the user to select
- * a value from a set of values. If the user give something other than the listed values,
- * it will show an error and ask him to select again. The
- * user can select an answer by typing its text or its number which will appear
- * in the terminal.
- *
- * @param string $prompt The text that will be shown for the user.
- *
- * @param array $choices An indexed array of values to select from.
- *
- * @param int $defaultIndex The index of the default value in case no value
- * is selected and the user hit enter.
- *
- * * @param int $maxTrials The maximum number of trials the user can do to select
- * a value. If -1 is passed, the user can select a value forever.
- *
- * @return string|null The method will return the value which is selected by
- * the user. If choices array is empty, null is returned. Also, null is returned
- * if max trials is reached and it is not -1.
- *
- *
- */
- public function select(string $prompt, array $choices, int $defaultIndex = -1, int $maxTrials = -1): ?string {
- if (count($choices) != 0) {
- $currentTry = 0;
- do {
- $this->println($prompt, [
- 'color' => 'gray',
- 'bold' => true
- ]);
-
- $this->printChoices($choices, $defaultIndex);
- $input = trim($this->readln());
-
- $check = $this->checkSelectedChoice($choices, $defaultIndex, $input);
-
- if ($check !== null) {
- return $check;
- }
- $currentTry++;
-
- if ($currentTry == $maxTrials && $maxTrials > 0) {
- return null;
- }
- } while (true);
- }
-
- return null;
- }
- /**
- * Sets the value of an argument.
- *
- * This method is useful in writing test cases for the commands.
- *
- * @param string $argName The name of the argument.
- *
- * @param string $argValue The value to set.
- *
- * @return bool If the value of the argument is set, the method will return
- * true. If not set, the method will return false. The value of the attribute
- * will be not set in the following cases:
- *
- *
If the argument can have a specific set of values and the given
- * value is not one of them.
- *
The given value is empty string or null.
- *
- *
- */
- public function setArgValue(string $argName, string $argValue = ''): bool {
- $trimmedArgName = trim($argName);
- $argObj = $this->getArg($trimmedArgName);
-
- if ($argObj !== null) {
- return $argObj->setValue($argValue);
- }
-
- return false;
- }
- /**
- * Sets the description of the command.
- *
- * The description of the command is a string that describes what does the
- * command do, and it will appear in CLI if the command 'help' is executed.
- *
- * @param string $str A string that describes the command. It must be non-empty
- * string.
- *
- * @return bool If the description of the command is set, the method will return
- * true. Other than that, the method will return false.
- */
- public function setDescription(string $str) : bool {
- $trimmed = trim($str);
-
- if (strlen($trimmed) > 0) {
- $this->description = $trimmed;
-
- return true;
- }
-
- return false;
- }
- /**
- * Sets the stream at which the command will read input from.
- *
- * @param InputStream $stream An instance that implements an input stream.
- *
- */
- public function setInputStream(InputStream $stream): void {
- $this->inputStream = $stream;
- }
- /**
- * Sets the name of the command.
- *
- * The name of the command is a string which is used to call the command
- * from CLI.
- *
- * @param string $name The name of the command (such as 'v' or 'help').
- * It must be non-empty string and does not contain spaces.
- *
- * @return bool If the name of the command is set, the method will return
- * true. Other than that, the method will return false.
- *
- */
- public function setName(string $name) : bool {
- $trimmed = trim($name);
-
- if (strlen($trimmed) > 0 && !strpos($trimmed, ' ')) {
- $this->commandName = $name;
-
- return true;
- }
-
- return false;
- }
- /**
- * Sets the stream at which the command will send output to.
- *
- * @param OutputStream $stream An instance that implements output stream.
- *
- */
- public function setOutputStream(OutputStream $stream): void {
- $this->outputStream = $stream;
- }
- /**
- * Sets the runner that owns the command.
- *
- * The runner is the instance that will execute the command.
- *
- * @param Runner $owner
- */
- public function setOwner(?Runner $owner = null): void {
- $this->owner = $owner;
- }
- /**
- * Display a message that represents a success status.
- *
- * The message will be prefixed with the string "Success:" in green.
- *
- * @param string $message The message that will be displayed.
- *
- */
- public function success(string $message): void {
- $this->printMsg($message, 'Success', 'light-green');
- }
-
- /**
- * Creates and displays a table with the given data.
- *
- * This method provides a convenient way to display tabular data in CLI applications
- * using the WebFiori CLI Table feature. It supports various table styles, themes,
- * column configuration, and data formatting options.
- *
- * @param array $data The data to display. Can be:
- * - Array of arrays (indexed): [['John', 30], ['Jane', 25]]
- * - Array of associative arrays: [['name' => 'John', 'age' => 30]]
- * @param array $headers Optional headers for the table columns. If not provided
- * and data contains associative arrays, keys will be used as headers.
- * @param array $options Optional configuration options. Use TableOptions constants for keys:
- * - TableOptions::STYLE: Table style ('bordered', 'simple', 'minimal', 'compact', 'markdown')
- * - TableOptions::THEME: Color theme ('default', 'dark', 'light', 'colorful', 'professional', 'minimal')
- * - TableOptions::TITLE: Table title to display above the table
- * - TableOptions::WIDTH: Maximum table width (auto-detected if not specified)
- * - TableOptions::SHOW_HEADERS: Whether to show column headers (default: true)
- * - TableOptions::COLUMNS: Column-specific configuration
- * - TableOptions::COLORIZE: Column colorization rules
- * - TableOptions::AUTO_WIDTH: Auto-calculate column widths (default: true)
- * - TableOptions::SHOW_ROW_SEPARATORS: Show separators between rows (default: false)
- * - TableOptions::SHOW_HEADER_SEPARATOR: Show separator after headers (default: true)
- * - TableOptions::PADDING: Cell padding configuration
- * - TableOptions::WORD_WRAP: Enable word wrapping (default: false)
- * - TableOptions::ELLIPSIS: Truncation string (default: '...')
- * - TableOptions::SORT: Sort configuration
- * - TableOptions::LIMIT: Limit number of rows displayed
- * - TableOptions::FILTER: Filter function for rows
- *
- * @return Command Returns the same instance for method chaining.
- *
- *
- * Example usage:
- * ```php
- * use WebFiori\Cli\Table\TableOptions;
- *
- * // Basic table
- * $this->table([
- * ['John Doe', 30, 'Active'],
- * ['Jane Smith', 25, 'Inactive']
- * ], ['Name', 'Age', 'Status']);
- *
- * // Advanced table with constants
- * $this->table($users, ['Name', 'Status', 'Balance'], [
- * TableOptions::STYLE => 'bordered',
- * TableOptions::THEME => 'colorful',
- * TableOptions::TITLE => 'User Management',
- * TableOptions::COLUMNS => [
- * 'Balance' => ['align' => 'right', 'formatter' => fn($v) => '$' . number_format($v, 2)]
- * ],
- * TableOptions::COLORIZE => [
- * 'Status' => fn($v) => match($v) {
- * 'Active' => ['color' => 'green', 'bold' => true],
- * 'Inactive' => ['color' => 'red'],
- * default => []
- * }
- * ]
- * ]);
- * ```
- */
- public function table(array $data, array $headers = [], array $options = []): Command {
- // Handle empty data
- if (empty($data)) {
- $this->info('No data to display in table.');
-
- return $this;
- }
-
- try {
- // Create table builder instance
- $tableBuilder = TableBuilder::create();
-
- // Set headers
- if (!empty($headers)) {
- $tableBuilder->setHeaders($headers);
- }
-
- // Set data
- $tableBuilder->setData($data);
-
- // Apply style (support both constant and string)
- $style = $options[TableOptions::STYLE] ?? $options['style'] ?? 'bordered';
- $tableBuilder->useStyle($style);
-
- // Apply theme (support both constant and string)
- $theme = $options[TableOptions::THEME] ?? $options['theme'] ?? null;
-
- if ($theme !== null) {
- $themeObj = TableTheme::create($theme);
- $tableBuilder->setTheme($themeObj);
- }
-
- // Set title (support both constant and string)
- $title = $options[TableOptions::TITLE] ?? $options['title'] ?? null;
-
- if ($title !== null) {
- $tableBuilder->setTitle($title);
- }
-
- // Set width (support both constant and string)
- $width = $options[TableOptions::WIDTH] ?? $options['width'] ?? $this->getTerminalWidth();
- $tableBuilder->setMaxWidth($width);
-
- // Configure headers visibility (support both constant and string)
- $showHeaders = $options[TableOptions::SHOW_HEADERS] ?? $options['showHeaders'] ?? true;
- $tableBuilder->showHeaders($showHeaders);
-
- // Configure columns (support both constant and string)
- $columns = $options[TableOptions::COLUMNS] ?? $options['columns'] ?? [];
-
- if (!empty($columns) && is_array($columns)) {
- foreach ($columns as $columnName => $columnConfig) {
- $tableBuilder->configureColumn($columnName, $columnConfig);
- }
- }
-
- // Apply colorization (support both constant and string)
- $colorize = $options[TableOptions::COLORIZE] ?? $options['colorize'] ?? [];
-
- if (!empty($colorize) && is_array($colorize)) {
- foreach ($colorize as $columnName => $colorizer) {
- if (is_callable($colorizer)) {
- $tableBuilder->colorizeColumn($columnName, $colorizer);
- }
- }
- }
-
- // Render and display the table
- $output = $tableBuilder->render();
- $this->prints($output);
- } catch (Exception $e) {
- $this->error('Failed to display table: '.$e->getMessage());
- } catch (Error $e) {
- $this->error('Table display error: '.$e->getMessage());
- }
-
- return $this;
- }
- /**
- * Display a message that represents a warning.
- *
- * The message will be prefixed with the string 'Warning:' in
- * red.
- *
- * @param string $message The message that will be shown.
- *
- */
- public function warning(string $message): void {
- $this->prints('Warning: ', [
- 'color' => 'light-yellow',
- 'bold' => true
- ]);
- $this->println($message);
- }
-
- /**
- * Executes a callback for each item with a progress bar.
- *
- * @param iterable $items Items to iterate over
- * @param callable $callback Callback to execute for each item
- * @param string $message Optional message to display
- * @return void
- */
- public function withProgressBar(iterable $items, callable $callback, string $message = ''): void {
- $items = is_array($items) ? $items : iterator_to_array($items);
- $total = count($items);
-
- $progressBar = $this->createProgressBar($total);
- $progressBar->start($message);
-
- foreach ($items as $key => $item) {
- $callback($item, $key);
- $progressBar->advance();
- }
-
- $progressBar->finish();
- }
-
- private function _createPassArray($string, array $args) : array {
- $retVal = [$string];
-
- foreach ($args as $arg) {
- if (gettype($arg) != 'array') {
- $retVal[] = $arg;
- }
- }
-
- return $retVal;
- }
- private function checkIsArgsSetHelper(): bool {
- $missingMandatory = [];
-
- foreach ($this->commandArgs as $argObj) {
- if (!$argObj->isOptional() && $argObj->getValue() === null && $argObj->getDefault() != '') {
- $argObj->setValue($argObj->getDefault());
- } else if (!$argObj->isOptional() && $argObj->getValue() === null) {
- $missingMandatory[] = $argObj->getName();
- }
- }
-
- if (count($missingMandatory) != 0) {
- $missingStr = 'The following required argument(s) are missing: ';
- $comma = '';
-
- foreach ($missingMandatory as $opt) {
- $missingStr .= $comma."'".$opt."'";
- $comma = ', ';
- }
- $this->error($missingStr);
-
- return false;
- }
-
- return true;
- }
- private function checkSelectedChoice(array $choices, int $defaultIndex, string $input): ?string {
- $retVal = null;
-
- if (in_array($input, $choices)) {
- //Given input is exactly same as one of choices
- $retVal = $input;
- } else if (strlen($input) == 0 && $defaultIndex !== null) {
- //Given input is empty string (enter hit).
- //Return default if specified.
- $retVal = $this->getDefaultChoiceHelper($choices, $defaultIndex);
- } else if (InputValidator::isInt($input)) {
- //Selected option is an index. Search for it and return its value.
- $retVal = $this->getChoiceAtIndex($choices, (int)$input);
- }
-
- if ($retVal === null) {
- $this->error('Invalid answer.');
- }
-
- return $retVal;
- }
- private function getChoiceAtIndex(array $choices, int $input): ?string {
- $index = 0;
-
- foreach ($choices as $choice) {
- if ($index == $input) {
- return $choice;
- }
- $index++;
- }
-
- return null;
- }
- private function getDefaultChoiceHelper(array $choices, int $defaultIndex): ?string {
- $index = 0;
-
- foreach ($choices as $choice) {
- if ($index == $defaultIndex) {
- return $choice;
- }
- $index++;
- }
-
- return null;
- }
- /**
- * Validate user input and show error message if user input is invalid.
- * @param string $input
- * @param InputValidator|null $validator
- * @param string|null $default
- * @return array The method will return an array with two indices, 'valid' and
- * 'value'. The 'valid' index contains a boolean that is set to true if the
- * value is valid. The index 'value' will contain the passed value.
- */
- private function getInputHelper(string &$input, ?InputValidator $validator = null, ?string $default = null) : array {
- $retVal = [
- 'valid' => true
- ];
-
- if (strlen($input) == 0 && $default !== null) {
- $input = $default;
- } else if ($validator !== null) {
- $retVal['valid'] = $validator->isValid($input);
-
- if (!($retVal['valid'] === true)) {
- $this->error($validator->getErrPrompt());
- }
- }
- $retVal['value'] = $input;
-
- return $retVal;
- }
-
- /**
- * Get terminal width for responsive table display.
- *
- * @return int Terminal width in characters, defaults to 80 if unable to detect.
- */
- private function getTerminalWidth(): int {
- // Try to get terminal width using tput
- $width = @exec('tput cols 2>/dev/null');
-
- if (is_numeric($width) && $width > 0) {
- return (int)$width;
- }
-
- // Try environment variable
- $width = getenv('COLUMNS');
-
- if ($width !== false && is_numeric($width) && $width > 0) {
- return (int)$width;
- }
-
- // Try using stty
- $width = @exec('stty size 2>/dev/null | cut -d" " -f2');
-
- if (is_numeric($width) && $width > 0) {
- return (int)$width;
- }
-
- // Default fallback
- return 80;
- }
- private function parseArgsHelper() : bool {
- $options = $this->getArgs();
- $invalidArgsVals = [];
-
- foreach ($options as $argObj) {
- $val = $this->getArgValue($argObj->getName());
-
- if ($val !== null && !$argObj->setValue($val)) {
- $invalidArgsVals[] = $argObj->getName();
- }
- }
-
- if (count($invalidArgsVals) != 0) {
- $invalidStr = 'The following argument(s) have invalid values: ';
- $comma = '';
-
- foreach ($invalidArgsVals as $argName) {
- $invalidStr .= $comma."'".$argName."'";
- $comma = ', ';
- }
- $this->error($invalidStr);
-
- foreach ($invalidArgsVals as $argName) {
- $this->info("Allowed values for the argument '$argName':");
-
- foreach ($this->getArg($argName)->getAllowedValues() as $val) {
- $this->println($val);
- }
- }
-
- return false;
- }
-
- return true;
- }
- private function printChoices(array $choices, int $default): void {
- $index = 0;
-
- foreach ($choices as $choiceTxt) {
- if ($default !== null && $index == $default) {
- $this->prints($index.": ".$choiceTxt, [
- 'color' => 'light-blue',
- 'bold' => 'true'
- ]);
- $this->println(' <--');
- } else {
- $this->println($index.": ".$choiceTxt);
- }
- $index++;
- }
- }
- private function printMsg(string $msg, string $prefix, string $color) {
- $this->prints("$prefix: ", [
- 'color' => $color,
- 'bold' => true,
-
- ]);
- $this->println($msg);
- }
-}
+
+ *
optional: A boolean. if set to true, it means that the argument
+ * is optional and can be ignored when running the command.
+ *
default: An optional default value for the argument
+ * to use if it is not provided and is optional.
+ *
description: A description of the argument which
+ * will be shown if the command 'help' is executed.
+ *
values: A set of values that the argument can have. If provided,
+ * only the values on the list will be allowed. Note that if null or empty string
+ * is in the array, it will be ignored. Also, if boolean values are
+ * provided, true will be converted to the string 'y' and false will
+ * be converted to the string 'n'.
+ *
+ *
+ * @param string $description A string that describes what does the job
+ * do. The description will appear when the command 'help' is executed.
+ *
+ * @param array $aliases An optional array of aliases for the command.
+ */
+ public function __construct(string $commandName, array $args = [], string $description = '', array $aliases = []) {
+ if (!$this->setName($commandName)) {
+ $this->setName('new-command');
+ }
+ $this->aliases = $aliases;
+ $this->addArgs($args);
+
+ if (!$this->setDescription($description)) {
+ $this->setDescription('');
+ }
+ }
+ /**
+ * Add command argument.
+ *
+ * An argument is a string that comes after the name of the command. The value
+ * of an argument can be set using equal sign. For example, if command name
+ * is 'do-it' and one argument has the name 'what-to-do', then the full
+ * CLI command would be "do-it what-to-do=say-hi". An argument can be
+ * also treated as an option.
+ *
+ * @param string $name The name of the argument. It must be non-empty string
+ * and does not contain spaces. Note that if the argument is already added and
+ * the developer is trying to add it again, the new options array will override
+ * the existing options array.
+ *
+ * @param array $options An optional array of options. Available options are:
+ *
+ *
optional: A boolean. if set to true, it means that the argument
+ * is optional and can be ignored when running the command.
+ *
default: An optional default value for the argument
+ * to use if it is not provided and is optional.
+ *
description: A description of the argument which
+ * will be shown if the command 'help' is executed.
+ *
values: A set of values that the argument can have. If provided,
+ * only the values on the list will be allowed. Note that if null or empty string
+ * is in the array, it will be ignored. Also, if boolean values are
+ * provided, true will be converted to the string 'y' and false will
+ * be converted to the string 'n'.
+ *
+ *
+ * @return bool If the argument is added, the method will return true.
+ * Other than that, the method will return false.
+ *
+ */
+ public function addArg(string $name, array $options = []) : bool {
+ $toAdd = Argument::create($name, $options);
+
+ if ($toAdd === null) {
+ return false;
+ }
+
+ return $this->addArgument($toAdd);
+ }
+ /**
+ * Adds multiple arguments to the command.
+ *
+ * @param array $arr An associative array of sub associative arrays. The
+ * key of each sub array is argument name. This can also be
+ * an array of objects of type 'CommandArgument'. For arrays, Each
+ * sub-array can have the following indices:
+ *
+ *
optional: A boolean. if set to true, it means that the argument
+ * is optional and can be ignored when running the command.
+ *
default: An optional default value for the argument
+ * to use if it is not provided and is optional.
+ *
description: A description of the argument which
+ * will be shown if the command 'help' is executed.
+ *
values: A set of values that the argument can have. If provided,
+ * only the values on the list will be allowed. Note that if null or empty string
+ * is in the array, it will be ignored. Also, if boolean values are
+ * provided, true will be converted to the string 'y' and false will
+ * be converted to the string 'n'.
+ *
+ */
+ public function addArgs(array $arr): void {
+ $this->commandArgs = [];
+
+ foreach ($arr as $optionName => $options) {
+ if ($options instanceof Argument) {
+ $this->addArgument($options);
+ } else {
+ $this->addArg($optionName, $options);
+ }
+ }
+ }
+ /**
+ * Adds new command argument.
+ *
+ * @param Argument $arg The argument that will be added.
+ *
+ * @return bool If the argument is added, the method will return true.
+ * If not, false is returned. The argument will not be added only if an argument
+ * which has same name is added.
+ */
+ public function addArgument(Argument $arg) : bool {
+ if (!$this->hasArg($arg->getName())) {
+ $this->commandArgs[] = $arg;
+
+ return true;
+ }
+
+ return false;
+ }
+ /**
+ * Clears the output before or after cursor position.
+ *
+ * This method will replace the visible characters with spaces.
+ * Note that support for this operation depends on terminal support for
+ * ANSI escape codes.
+ *
+ * @param int $numberOfCols Number of columns to clear. The columns that
+ * will be cleared are before and after cursor position. They don't include
+ * the character at which the cursor is currently pointing to.
+ * @param bool $beforeCursor If set to true, the characters which
+ * are before the cursor will be cleared. Default is true.
+ *
+ * @return Command The method will return the instance at which the
+ * method is called on.
+ *
+ */
+ public function clear(int $numberOfCols = 1, bool $beforeCursor = true) : Command {
+ if ($numberOfCols >= 1 && $beforeCursor) {
+ for ($x = 0 ; $x < $numberOfCols ; $x++) {
+ $this->moveCursorLeft();
+ $this->prints(" ");
+ $this->moveCursorLeft();
+ }
+ $this->moveCursorRight($numberOfCols);
+ } else if ($numberOfCols >= 1) {
+ $this->moveCursorRight();
+
+ for ($x = 0 ; $x < $numberOfCols ; $x++) {
+ $this->prints(" ");
+ }
+ $this->moveCursorLeft($numberOfCols + 1);
+ }
+
+ return $this;
+ }
+ /**
+ * Clears the whole content of the console.
+ *
+ * Note that support for this operation depends on terminal support for
+ * ANSI escape codes.
+ *
+ * @return Command The method will return the instance at which the
+ * method is called on.
+ */
+ public function clearConsole() : Command {
+ $this->prints("\ec");
+
+ return $this;
+ }
+ /**
+ * Clears the line at which the cursor is in and move it back to the start
+ * of the line.
+ *
+ * Note that support for this operation depends on terminal support for
+ * ANSI escape codes.
+ *
+ */
+ public function clearLine(): void {
+ $this->prints("\e[2K");
+ $this->prints("\r");
+ }
+ /**
+ * Asks the user to conform something.
+ *
+ * This method will display the question and wait for the user to confirm the
+ * action by entering 'y' or 'n' in the terminal. If the user give something
+ * other than 'Y' or 'n', it will show an error and ask him to confirm
+ * again. If a default answer is provided, it will appear in upper case in the
+ * terminal. For example, if default is set to true, at the end of the prompt,
+ * the string that shows the options would be like '(Y/n)'.
+ *
+ * @param string $confirmTxt The text of the question of which will be asked.
+ *
+ * @param bool|null $default Default answer to use if empty input is given.
+ * It can be true for 'y' and false for 'n'. Default value is null which
+ * means no default will be used.
+ *
+ * @return bool If the user choose 'y', the method will return true. If
+ * he chooses 'n', the method will return false.
+ *
+ *
+ */
+ public function confirm(string $confirmTxt, ?bool $default = null) : bool {
+ $answer = null;
+
+ do {
+ if ($default === true) {
+ $optionsStr = '(Y/n)';
+ } else if ($default === false) {
+ $optionsStr = '(y/N)';
+ } else {
+ $optionsStr = '(y/n)';
+ }
+ $this->prints(trim($confirmTxt), [
+ 'color' => 'gray',
+ 'bold' => true
+ ]);
+ $this->println($optionsStr, [
+ 'color' => 'light-blue'
+ ]);
+
+ $input = strtolower(trim($this->readln()));
+
+ if ($input == 'n') {
+ $answer = false;
+ } else if ($input == 'y') {
+ $answer = true;
+ } else if (strlen($input) == 0 && $default !== null) {
+ return $default === true;
+ } else {
+ $this->error('Invalid answer. Choose \'y\' or \'n\'.');
+ }
+ } while ($answer === null);
+
+ return $answer;
+ }
+
+ /**
+ * Creates and returns a new progress bar instance.
+ *
+ * @param int $total Total number of steps
+ * @return ProgressBar
+ */
+ public function createProgressBar(int $total = 100): ProgressBar {
+ return new ProgressBar($this->getOutputStream(), $total);
+ }
+ /**
+ * Display a message that represents an error.
+ *
+ * The message will be prefixed with the string 'Error:' in
+ * red.
+ *
+ * @param string $message The message that will be shown.
+ *
+ */
+ public function error(string $message): void {
+ $this->printMsg($message, 'Error', 'light-red');
+ }
+ /**
+ * Execute the command.
+ *
+ * This method should not be called manually by the developer.
+ *
+ * @return int If the command is executed, the method will return 0.
+ * Other than that, it will return a number which depends on the return value of
+ * the method 'Command::exec()'.
+ *
+ */
+ public function excCommand() : int {
+ $retVal = -1;
+
+ $runner = $this->getOwner();
+
+ if ($runner !== null) {
+ foreach ($runner->getArgs() as $arg) {
+ $this->addArgument($arg);
+ }
+ }
+
+ if ($this->parseArgsHelper()) {
+ // Check for help first, before validating required arguments
+ if ($this->isArgProvided('help') || $this->isArgProvided('-h')) {
+ $help = $runner->getCommandByName('help');
+ $help->setArgValue('--command', $this->getName());
+ $help->setOwner($runner);
+ $help->setOutputStream($runner->getOutputStream());
+ $this->removeArgument('help');
+
+ return $help->exec();
+ } else if ($this->checkIsArgsSetHelper()) {
+ $retVal = $this->exec();
+ }
+
+ }
+
+ if ($runner !== null) {
+ foreach ($runner->getArgs() as $arg) {
+ $this->removeArgument($arg->getName());
+ $arg->resetValue();
+ }
+ }
+
+ return $retVal;
+ }
+ /**
+ * Execute the command.
+ *
+ * The implementation of this method should contain the code that will run
+ * when the command is executed.
+ *
+ * @return int The developer should implement this method in a way it returns 0
+ * if the command is executed successfully and return -1 if the
+ * command did not execute successfully.
+ *
+ */
+ public abstract function exec() : int;
+ /**
+ * Execute a registered command using a sub-runner.
+ *
+ * This method can be used to execute a registered command within the runner
+ * using another
+ * runner instance which shares argsv, input and output streams with the
+ * main runner. It can be used to invoke another command from within a
+ * running command.
+ *
+ * @param string $name The name of the command. It must be a part of
+ * registered commands.
+ *
+ * @param array $additionalArgs An associative array that represents additional arguments
+ * to be passed to the command.
+ *
+ * @return int The method will return an integer that represent exit status
+ * code of the command after execution.
+ */
+ public function execSubCommand(string $name, array $additionalArgs = []) : int {
+ $runner = $this->getOwner();
+
+ if ($runner === null) {
+ return -1;
+ }
+
+ return $runner->runCommandAsSub($name, $additionalArgs);
+ }
+ /**
+ * Returns an array of aliases for the command.
+ *
+ * @return array An array of aliases.
+ */
+ public function getAliases() : array {
+ return $this->aliases;
+ }
+
+ /**
+ * Sets the aliases for the command.
+ *
+ * @param array $aliases An array of aliases.
+ */
+ public function setAliases(array $aliases): void {
+ $this->aliases = $aliases;
+ }
+
+ /**
+ * Adds an alias to the command.
+ *
+ * @param string $alias The alias to add.
+ */
+ public function addAlias(string $alias): void {
+ if (!in_array($alias, $this->aliases)) {
+ $this->aliases[] = $alias;
+ }
+ }
+ /**
+ * Returns an object that holds argument info if the command.
+ *
+ * @param string $name The name of command argument.
+ *
+ * @return Argument|null If the command has an argument with the
+ * given name, it will be returned. Other than that, null is returned.
+ */
+ public function getArg(string $name): ?Argument {
+ foreach ($this->getArgs() as $arg) {
+ if ($arg->getName() == $name) {
+ return $arg;
+ }
+ }
+
+ return null;
+ }
+ /**
+ * Returns an associative array that contains command args.
+ *
+ * @return array An associative array. The indices of the array are
+ * the names of the arguments and the values are sub-associative arrays.
+ * the sub arrays will have the following indices:
+ *
+ *
optional
+ *
description
+ *
default
+ *
+ * Note that the last index might not be set.
+ *
+ */
+ public function getArgs() : array {
+ return $this->commandArgs;
+ }
+ /**
+ * Returns an array that contains the names of command arguments.
+ *
+ * @return array An array of strings.
+ */
+ public function getArgsNames() : array {
+ return array_map(function ($el) {
+ return $el->getName();
+ }, $this->getArgs());
+ }
+ /**
+ * Returns the value of command option from CLI given its name.
+ *
+ * @param string $optionName The name of the option.
+ *
+ * @return string|null If the value of the option is set, the method will
+ * return its value as string. If it is not set, the method will return null.
+ *
+ */
+ public function getArgValue(string $optionName): ?string {
+ $trimmedOptName = trim($optionName);
+ $arg = $this->getArg($trimmedOptName);
+
+ if ($arg !== null) {
+ $runner = $this->getOwner();
+
+ // Always return the set value if it exists, regardless of interactive mode
+ if ($arg->getValue() !== null) {
+ return $arg->getValue();
+ }
+
+ return Argument::extractValue($trimmedOptName, $runner);
+ }
+
+ return null;
+ }
+ /**
+ * Returns the description of the command.
+ *
+ * The description of the command is a string that describes what does the
+ * command do, and it will appear in CLI if the command 'help' is executed.
+ *
+ * @return string The description of the command. Default return value
+ * is '<NO DESCRIPTION>'
+ *
+ */
+ public function getDescription() : string {
+ return $this->description;
+ }
+
+ /**
+ * Take an input value from the user.
+ *
+ * @param string $prompt The string that will be shown to the user. The
+ * string must be non-empty.
+ *
+ * @param string|null $default An optional default value to use in case the user
+ * hit "Enter" without entering any value. If null is passed, no default
+ * value will be set.
+ *
+ * @param InputValidator|null $validator A callback that can be used to validate user
+ * input. The callback accepts one parameter which is the value that
+ * the user has given. If the value is valid, the callback must return true.
+ * If the callback returns anything else, it means the value which is given
+ * by the user is invalid and this method will ask the user to enter the
+ * value again.
+ *
+ * @return string|null The method will return the value which was taken from the
+ * user. If prompt string is empty, null will be returned.
+ * Note that if the input has special characters or spaces at the
+ * beginning or the end, they will be trimmed.
+ *
+ */
+ public function getInput(string $prompt, ?string $default = null, ?InputValidator $validator = null): ?string {
+ $trimmed = trim($prompt);
+
+ if (strlen($trimmed) > 0) {
+ do {
+ $this->prints($trimmed, [
+ 'color' => 'gray',
+ 'bold' => true
+ ]);
+
+ if ($default !== null) {
+ $this->prints(" Enter = '".$default."'", [
+ 'color' => 'light-blue'
+ ]);
+ }
+ $this->println();
+ $input = trim($this->readln());
+
+ $check = $this->getInputHelper($input, $validator, $default);
+
+ if ($check['valid']) {
+ return $check['value'];
+ }
+ } while (true);
+ }
+
+ return null;
+ }
+ /**
+ * Reads user input with characters masked by a specified character.
+ *
+ * This method is similar to getInput() but masks the input characters as the user types,
+ * making it suitable for sensitive information like passwords, tokens, or secrets.
+ * The actual input value is captured but only mask characters are displayed in the terminal.
+ *
+ * @param string $prompt The prompt message to display to the user. Must be non-empty.
+ *
+ * @param string $mask The character to display instead of the actual input characters.
+ * Default is '*'. Can be any single character or string.
+ *
+ * @param string|null $default An optional default value to use if the user provides
+ * empty input. If provided, it will be shown in the prompt.
+ *
+ * @param InputValidator|null $validator An optional validator to validate the input.
+ * If validation fails, the user will be prompted again.
+ *
+ * @return string|null Returns the actual input value (not masked) if valid input is provided,
+ * or null if the prompt is empty.
+ *
+ * @since 1.1.0
+ */
+ public function getMaskedInput(string $prompt, string $mask = '*', ?string $default = null, ?InputValidator $validator = null): ?string {
+ $trimmed = trim($prompt);
+
+ if (strlen($trimmed) > 0) {
+ do {
+ $this->prints($trimmed, [
+ 'color' => 'gray',
+ 'bold' => true
+ ]);
+
+ if ($default !== null) {
+ $this->prints(" Enter = '".$default."'", [
+ 'color' => 'light-blue'
+ ]);
+ }
+ $this->println();
+ $input = trim($this->readMaskedLine($mask));
+
+ $check = $this->getInputHelper($input, $validator, $default);
+
+ if ($check['valid']) {
+ return $check['value'];
+ }
+ } while (true);
+ }
+
+ return null;
+ } /**
+ * Returns the stream at which the command is sing to read inputs.
+ *
+ * @return null|InputStream If the stream is set, it will be returned as
+ * an object. Other than that, the method will return null.
+ *
+ */
+ public function getInputStream() : InputStream {
+ return $this->inputStream;
+ }
+
+ /**
+ * Check if the current input stream supports interactive input.
+ *
+ * @return bool True if the input stream supports interactive input (real-time user interaction),
+ * false otherwise (files, pipes, arrays, etc.)
+ */
+ public function supportsInteractiveInput(): bool {
+ $stream = $this->getInputStream();
+
+ // Only StdIn with tty supports true interaction
+ if ($stream instanceof Streams\StdIn) {
+ return function_exists('posix_isatty') && posix_isatty(STDIN);
+ }
+
+ // All other stream types are non-interactive
+ return false;
+ }
+ /**
+ * Returns the name of the command.
+ *
+ * The name of the command is a string which is used to call the command
+ * from CLI.
+ *
+ * @return string The name of the command (such as 'v' or 'help'). Default
+ * return value is 'new-command'.
+ *
+ */
+ public function getName() : string {
+ return $this->commandName;
+ }
+ /**
+ * Returns the stream at which the command is using to send output.
+ *
+ * @return null|OutputStream If the stream is set, it will be returned as
+ * an object. Other than that, the method will return null.
+ *
+ */
+ public function getOutputStream() : OutputStream {
+ return $this->outputStream;
+ }
+ /**
+ * Returns the runner which is used to execute the command.
+ *
+ * @return Runner|null If the command was called using a runner, this method
+ * will return an instance that can be used to access runner's properties.
+ * If not called through a runner, null is returned.
+ */
+ public function getOwner(): ?Runner {
+ return $this->owner;
+ }
+ /**
+ * Checks if the command has a specific command line argument or not.
+ *
+ * @param string $argName The name of the command line argument.
+ *
+ * @return bool If the argument is added to the command, the method will
+ * return true. If no argument which has the given name does exist, the method
+ * will return false.
+ *
+ */
+ public function hasArg(string $argName) : bool {
+ foreach ($this->getArgs() as $arg) {
+ if ($arg->getName() == $argName) {
+ return true;
+ }
+ }
+
+ return false;
+ }
+ /**
+ * Display a message that represents extra information.
+ *
+ * The message will be prefixed with the string 'Info:' in
+ * blue.
+ *
+ * @param string $message The message that will be shown.
+ *
+ */
+ public function info(string $message): void {
+ $this->printMsg($message, 'Info', 'blue');
+ }
+ /**
+ * Checks if an argument is provided in the CLI or not.
+ *
+ * The method will not check if the argument has a value or not.
+ *
+ * @param string $argName The name of the command line argument.
+ *
+ * @return bool If the argument is provided, the method will return
+ * true. Other than that, the method will return false.
+ *
+ */
+ public function isArgProvided(string $argName) : bool {
+ $argObj = $this->getArg($argName);
+
+ if ($argObj !== null) {
+ return $argObj->getValue() !== null;
+ }
+
+ return false;
+ }
+ /**
+ * Moves the cursor down by specific number of lines.
+ *
+ * Note that support for this operation depends on terminal support for
+ * ANSI escape codes.
+ *
+ * @param int $lines The number of lines the cursor will be moved. Default
+ * value is 1.
+ *
+ */
+ public function moveCursorDown(int $lines = 1): void {
+ if ($lines >= 1) {
+ $this->prints("\e[".$lines."B");
+ }
+ }
+ /**
+ * Moves the cursor to the left by specific number of columns.
+ *
+ * Note that support for this operation depends on terminal support for
+ * ANSI escape codes.
+ *
+ * @param int $numberOfCols The number of columns the cursor will be moved. Default
+ * value is 1.
+ *
+ */
+ public function moveCursorLeft(int $numberOfCols = 1): void {
+ if ($numberOfCols >= 1) {
+ $this->prints("\e[".$numberOfCols."D");
+ }
+ }
+ /**
+ * Moves the cursor to the right by specific number of columns.
+ *
+ * Note that support for this operation depends on terminal support for
+ * ANSI escape codes.
+ *
+ * @param int $numberOfCols The number of columns the cursor will be moved. Default
+ * value is 1.
+ *
+ */
+ public function moveCursorRight(int $numberOfCols = 1): void {
+ if ($numberOfCols >= 1) {
+ $this->prints("\e[".$numberOfCols."C");
+ }
+ }
+ /**
+ * Moves the cursor to specific position in the terminal.
+ *
+ * If no arguments are supplied to the method, it will move the cursor
+ * to the upper-left corner of the screen (line 0, column 0).
+ * Note that support for this operation depends on terminal support for
+ * ANSI escape codes.
+ *
+ * @param int $line The number of line at which the cursor will be moved
+ * to. If not specified, 0 is used.
+ *
+ * @param int $col The number of column at which the cursor will be moved
+ * to. If not specified, 0 is used.
+ *
+ */
+ public function moveCursorTo(int $line = 0, int $col = 0): void {
+ if ($line > -1 && $col > -1) {
+ $this->prints("\e[".$line.";".$col."H");
+ }
+ }
+ /**
+ * Moves the cursor up by specific number of lines.
+ *
+ * Note that support for this operation depends on terminal support for
+ * ANSI escape codes.
+ *
+ * @param int $lines The number of lines the cursor will be moved. Default
+ * value is 1.
+ *
+ */
+ public function moveCursorUp(int $lines = 1): void {
+ if ($lines >= 1) {
+ $this->prints("\e[".$lines."A");
+ }
+ }
+ /**
+ * Prints an array as a list of items.
+ *
+ * This method is useful if the developer would like to print out a list
+ * of multiple items. Each item will be prefixed with a number that represents
+ * its index in the array.
+ *
+ * @param array $array The array that will be printed.
+ *
+ */
+ public function printList(array $array): void {
+ for ($x = 0 ; $x < count($array) ; $x++) {
+ $this->prints("- ", [
+ 'color' => 'green'
+ ]);
+ $this->println($array[$x]);
+ }
+ }
+ /**
+ * Print out a string and terminates the current line by writing the
+ * line separator string.
+ *
+ * This method will work like the function fprintf(). The difference is that
+ * it will print out to the stream at which was specified by the method
+ * Command::setOutputStream() and the text can have formatting
+ * options. Note that support for output formatting depends on terminal support for
+ * ANSI escape codes.
+ *
+ * @param string $str The string that will be printed.
+ *
+ * @param mixed $_ One or more extra arguments that can be supplied to the
+ * method. The last argument can be an array that contains text formatting options.
+ * for available options, check the method Command::formatOutput().
+ */
+ public function println(string $str = '', ...$_) {
+ $argsCount = count($_);
+
+ if ($argsCount != 0 && gettype($_[$argsCount - 1]) == 'array') {
+ //Last index contains formatting options.
+ $_[$argsCount - 1]['ansi'] = $this->isArgProvided('--ansi');
+ $str = Formatter::format($str, $_[$argsCount - 1]);
+ }
+ call_user_func_array([$this->getOutputStream(), 'println'], $this->_createPassArray($str, $_));
+ }
+ /**
+ * Print out a string.
+ *
+ * This method works exactly like the function 'fprintf()'. The only
+ * difference is that the method will print out the output to the stream
+ * that was specified using the method Command::setOutputStream() and
+ * the method accepts formatting options as last argument to format the output.
+ * Note that support for output formatting depends on terminal support for
+ * ANSI escape codes.
+ *
+ * @param string $str The string that will be printed.
+ *
+ * @param mixed $_ One or more extra arguments that can be supplied to the
+ * method. The last argument can be an array that contains text formatting options.
+ * for available options, check the method Command::formatOutput().
+ *
+ */
+ public function prints(string $str, ...$_): void {
+ $argCount = count($_);
+ $formattingOptions = [];
+
+ if ($argCount != 0 && gettype($_[$argCount - 1]) == 'array') {
+ $formattingOptions = $_[$argCount - 1];
+ }
+
+ $formattingOptions['ansi'] = $this->isArgProvided('--ansi');
+
+ $formattedStr = Formatter::format($str, $formattingOptions);
+
+ call_user_func_array([$this->getOutputStream(), 'prints'], $this->_createPassArray($formattedStr, $_));
+ }
+
+ /**
+ * Reads a string of bytes from input stream.
+ *
+ * This method is used to read specific number of characters from input stream.
+ *
+ * @return string The method will return the string which was given as input
+ * in the input stream.
+ *
+ */
+ public function read(int $bytes = 1) : string {
+ return $this->getInputStream()->read($bytes);
+ }
+ /**
+ * Reads and validates class name.
+ *
+ * @param string|null $suffix An optional string to append to class name.
+ *
+ * @param string $prompt The text that will be shown to the user as prompt for
+ * class name.
+ *
+ * @param string $errMsg A string to show in case provided class name is
+ * not valid.
+ *
+ * @return string A string that represents a valid class name. If suffix is
+ * not null, the method will return the name with the suffix included.
+ */
+ public function readClassName(string $prompt, ?string $suffix = null, string $errMsg = 'Invalid class name is given.'): ?string {
+ return $this->getInput($prompt, null, new InputValidator(function (&$className, $suffix) {
+ if ($suffix !== null) {
+ $subSuffix = substr($className, strlen($className) - strlen($suffix));
+
+ if ($subSuffix != $suffix) {
+ $className .= $suffix;
+ }
+ }
+
+ return InputValidator::isValidClassName($className);
+ }, $errMsg, [$suffix]));
+ }
+
+ /**
+ * Reads a value as float.
+ *
+ * @param string $prompt The string that will be shown to the user. The
+ * string must be non-empty.
+ *
+ * @param float|null $default An optional default value to use in case the user
+ * hit "Enter" without entering any value. If null is passed, no default
+ * value will be set.
+ *
+ * @return float
+ */
+ public function readFloat(string $prompt, ?float $default = null) : float {
+ $defaultStr = $default !== null ? (string)$default : null;
+ $result = $this->getInput($prompt, $defaultStr, new InputValidator(function ($val) {
+ return InputValidator::isFloat($val);
+ }, 'Provided value is not a floating number!'));
+ return (float)$result;
+ }
+
+ /**
+ * Reads the namespace of class and return an instance of it.
+ *
+ * @param string $prompt The string that will be shown to the user. The
+ * string must be non-empty.
+ *
+ * @param string $errMsg A string to show in case provided namespace is
+ * invalid or an instance of the class cannot be created.
+ *
+ * @return object The method will return an instance of the class.
+ *
+ * @throws ReflectionException If the method was not able to initiate class instance.
+ */
+ public function readInstance(string $prompt, string $errMsg = 'Invalid Class!', array $constructorArgs = []): ?object {
+ $clazzNs = $this->getInput($prompt, null, new InputValidator(function ($input) {
+ if (InputValidator::isClass($input)) {
+ return true;
+ }
+
+ return false;
+ }, $errMsg));
+
+ $reflection = new ReflectionClass($clazzNs);
+
+ return $reflection->newInstanceArgs($constructorArgs);
+ }
+ /**
+ * Reads a value as an integer.
+ *
+ * @param string $prompt The string that will be shown to the user. The
+ * string must be non-empty.
+ *
+ * @param int $default An optional default value to use in case the user
+ * hit "Enter" without entering any value. If null is passed, no default
+ * value will be set.
+ *
+ * @return int
+ */
+ public function readInteger(string $prompt, ?int $default = null) : int {
+ $defaultStr = $default !== null ? (string)$default : null;
+ $result = $this->getInput($prompt, $defaultStr, new InputValidator(function ($val) {
+ return InputValidator::isInt($val);
+ }, 'Provided value is not an integer!'));
+ return (int)$result;
+ }
+ /**
+ * Reads one line from input stream.
+ *
+ * The method will continue to read from input stream till it finds end of
+ * line character "\n".
+ *
+ * @return string The method will return the string which was taken from
+ * input stream without the end of line character.
+ *
+ */
+ public function readln() : string {
+ return $this->getInputStream()->readLine();
+ }
+ /**
+ * Reads a line from input stream with character masking.
+ *
+ * This method reads input character by character and displays mask characters
+ * instead of the actual input. It handles backspace for character deletion
+ * and ignores special keys like ESC and arrow keys.
+ *
+ * @param string $mask The character to display instead of actual input characters.
+ *
+ * @return string The actual input string (unmasked).
+ *
+ * @since 1.1.0
+ */
+ private function readMaskedLine(string $mask = '*'): string {
+ $input = '';
+
+ // For testing with ArrayInputStream, read the whole line at once
+ if ($this->getInputStream() instanceof \WebFiori\Cli\Streams\ArrayInputStream) {
+ $input = $this->getInputStream()->readLine();
+ // Simulate masking output for testing
+ $this->prints(str_repeat($mask, strlen($input)));
+ $this->println();
+ return $input;
+ }
+
+ // Set terminal to raw mode with echo disabled for real-time character reading
+ $sttyMode = null;
+ if (function_exists('shell_exec') && PHP_OS_FAMILY !== 'Windows') {
+ $sttyMode = shell_exec('stty -g 2>/dev/null');
+ shell_exec('stty -echo -icanon 2>/dev/null');
+ }
+
+ try {
+ // For real terminal input, read character by character
+ while (true) {
+ $char = KeysMap::readAndTranslate($this->getInputStream());
+
+ if ($char === 'LF' || $char === 'CR' || $char === '') {
+ break;
+ } elseif ($char === 'BACKSPACE' && strlen($input) > 0) {
+ $input = substr($input, 0, -1);
+ $this->prints("\x08 \x08"); // Backspace, space, backspace
+ } elseif ($char !== 'BACKSPACE' && $char !== 'ESC' && $char !== 'DOWN' && $char !== 'UP' && $char !== 'LEFT' && $char !== 'RIGHT') {
+ $input .= $char === 'SPACE' ? ' ' : $char;
+ $this->prints($mask);
+ }
+ }
+ } finally {
+ // Restore terminal settings
+ if ($sttyMode !== null) {
+ shell_exec('stty ' . $sttyMode . ' 2>/dev/null');
+ }
+ }
+
+ $this->println();
+ return $input;
+ }
+ /**
+ * Reads a string that represents class namespace.
+ *
+ * @param string $prompt The string that will be shown to the user. The
+ * string must be non-empty.
+ *
+ * @param string $defaultNs A default string that represents default namespace.
+ * Note that the method will throw an exception if this parameter does not
+ * represent a valid namespace.
+ *
+ * @param string $errMsg A string that will be shown if provided input does
+ * not represent a valid namespace.
+ *
+ * @return string The method will return a string that represent a valid namespace.
+ *
+ * @throws IOException If given default namespace does not represent a namespace.
+ */
+ public function readNamespace(string $prompt, ?string $defaultNs = null, string $errMsg = 'Invalid Namespace!'): ?string {
+ if ($defaultNs !== null && !InputValidator::isValidNamespace($defaultNs)) {
+ throw new IOException('Provided default namespace is not valid.');
+ }
+
+ return $this->getInput($prompt, $defaultNs, new InputValidator(function ($input) {
+ if (InputValidator::isValidNamespace($input)) {
+ return true;
+ }
+
+ return false;
+ }, $errMsg));
+ }
+ /**
+ * Removes an argument from the command given its name.
+ *
+ * @param string $name The name of the argument that will be removed.
+ *
+ * @return bool If removed, true is returned. Other than that, false is
+ * returned.
+ */
+ public function removeArgument(string $name) : bool {
+ $removed = false;
+ $temp = [];
+
+ foreach ($this->getArgs() as $arg) {
+ if ($arg->getName() !== $name) {
+ $temp[] = $arg;
+ } else {
+ $removed = true;
+ }
+ }
+ $this->commandArgs = $temp;
+
+ return $removed;
+ }
+
+ /**
+ * Ask the user to select one of multiple values.
+ *
+ * This method will display a prompt and wait for the user to select
+ * a value from a set of values. If the user give something other than the listed values,
+ * it will show an error and ask him to select again. The
+ * user can select an answer by typing its text or its number which will appear
+ * in the terminal.
+ *
+ * @param string $prompt The text that will be shown for the user.
+ *
+ * @param array $choices An indexed array of values to select from.
+ *
+ * @param int $defaultIndex The index of the default value in case no value
+ * is selected and the user hit enter.
+ *
+ * * @param int $maxTrials The maximum number of trials the user can do to select
+ * a value. If -1 is passed, the user can select a value forever.
+ *
+ * @return string|null The method will return the value which is selected by
+ * the user. If choices array is empty, null is returned. Also, null is returned
+ * if max trials is reached and it is not -1.
+ *
+ *
+ */
+ public function select(string $prompt, array $choices, int $defaultIndex = -1, int $maxTrials = -1): ?string {
+ if (count($choices) != 0) {
+ $currentTry = 0;
+ do {
+ $this->println($prompt, [
+ 'color' => 'gray',
+ 'bold' => true
+ ]);
+
+ $this->printChoices($choices, $defaultIndex);
+ $input = trim($this->readln());
+
+ $check = $this->checkSelectedChoice($choices, $defaultIndex, $input);
+
+ if ($check !== null) {
+ return $check;
+ }
+ $currentTry++;
+
+ if ($currentTry == $maxTrials && $maxTrials > 0) {
+ return null;
+ }
+ } while (true);
+ }
+
+ return null;
+ }
+ /**
+ * Sets the value of an argument.
+ *
+ * This method is useful in writing test cases for the commands.
+ *
+ * @param string $argName The name of the argument.
+ *
+ * @param string $argValue The value to set.
+ *
+ * @return bool If the value of the argument is set, the method will return
+ * true. If not set, the method will return false. The value of the attribute
+ * will be not set in the following cases:
+ *
+ *
If the argument can have a specific set of values and the given
+ * value is not one of them.
+ *
The given value is empty string or null.
+ *
+ *
+ */
+ public function setArgValue(string $argName, string $argValue = ''): bool {
+ $trimmedArgName = trim($argName);
+ $argObj = $this->getArg($trimmedArgName);
+
+ if ($argObj !== null) {
+ return $argObj->setValue($argValue);
+ }
+
+ return false;
+ }
+ /**
+ * Sets the description of the command.
+ *
+ * The description of the command is a string that describes what does the
+ * command do, and it will appear in CLI if the command 'help' is executed.
+ *
+ * @param string $str A string that describes the command. It must be non-empty
+ * string.
+ *
+ * @return bool If the description of the command is set, the method will return
+ * true. Other than that, the method will return false.
+ */
+ public function setDescription(string $str) : bool {
+ $trimmed = trim($str);
+
+ if (strlen($trimmed) > 0) {
+ $this->description = $trimmed;
+
+ return true;
+ }
+
+ return false;
+ }
+ /**
+ * Sets the stream at which the command will read input from.
+ *
+ * @param InputStream $stream An instance that implements an input stream.
+ *
+ */
+ public function setInputStream(InputStream $stream): void {
+ $this->inputStream = $stream;
+ }
+ /**
+ * Sets the name of the command.
+ *
+ * The name of the command is a string which is used to call the command
+ * from CLI.
+ *
+ * @param string $name The name of the command (such as 'v' or 'help').
+ * It must be non-empty string and does not contain spaces.
+ *
+ * @return bool If the name of the command is set, the method will return
+ * true. Other than that, the method will return false.
+ *
+ */
+ public function setName(string $name) : bool {
+ $trimmed = trim($name);
+
+ if (strlen($trimmed) > 0 && !strpos($trimmed, ' ')) {
+ $this->commandName = $name;
+
+ return true;
+ }
+
+ return false;
+ }
+ /**
+ * Sets the stream at which the command will send output to.
+ *
+ * @param OutputStream $stream An instance that implements output stream.
+ *
+ */
+ public function setOutputStream(OutputStream $stream): void {
+ $this->outputStream = $stream;
+ }
+ /**
+ * Sets the runner that owns the command.
+ *
+ * The runner is the instance that will execute the command.
+ *
+ * @param Runner $owner
+ */
+ public function setOwner(?Runner $owner = null): void {
+ $this->owner = $owner;
+ }
+ /**
+ * Display a message that represents a success status.
+ *
+ * The message will be prefixed with the string "Success:" in green.
+ *
+ * @param string $message The message that will be displayed.
+ *
+ */
+ public function success(string $message): void {
+ $this->printMsg($message, 'Success', 'light-green');
+ }
+
+ /**
+ * Creates and displays a table with the given data.
+ *
+ * This method provides a convenient way to display tabular data in CLI applications
+ * using the WebFiori CLI Table feature. It supports various table styles, themes,
+ * column configuration, and data formatting options.
+ *
+ * @param array $data The data to display. Can be:
+ * - Array of arrays (indexed): [['John', 30], ['Jane', 25]]
+ * - Array of associative arrays: [['name' => 'John', 'age' => 30]]
+ * @param array $headers Optional headers for the table columns. If not provided
+ * and data contains associative arrays, keys will be used as headers.
+ * @param array $options Optional configuration options. Use TableOptions constants for keys:
+ * - TableOptions::STYLE: Table style ('bordered', 'simple', 'minimal', 'compact', 'markdown')
+ * - TableOptions::THEME: Color theme ('default', 'dark', 'light', 'colorful', 'professional', 'minimal')
+ * - TableOptions::TITLE: Table title to display above the table
+ * - TableOptions::WIDTH: Maximum table width (auto-detected if not specified)
+ * - TableOptions::SHOW_HEADERS: Whether to show column headers (default: true)
+ * - TableOptions::COLUMNS: Column-specific configuration
+ * - TableOptions::COLORIZE: Column colorization rules
+ * - TableOptions::AUTO_WIDTH: Auto-calculate column widths (default: true)
+ * - TableOptions::SHOW_ROW_SEPARATORS: Show separators between rows (default: false)
+ * - TableOptions::SHOW_HEADER_SEPARATOR: Show separator after headers (default: true)
+ * - TableOptions::PADDING: Cell padding configuration
+ * - TableOptions::WORD_WRAP: Enable word wrapping (default: false)
+ * - TableOptions::ELLIPSIS: Truncation string (default: '...')
+ * - TableOptions::SORT: Sort configuration
+ * - TableOptions::LIMIT: Limit number of rows displayed
+ * - TableOptions::FILTER: Filter function for rows
+ *
+ * @return Command Returns the same instance for method chaining.
+ *
+ *
+ * Example usage:
+ * ```php
+ * use WebFiori\Cli\Table\TableOptions;
+ *
+ * // Basic table
+ * $this->table([
+ * ['John Doe', 30, 'Active'],
+ * ['Jane Smith', 25, 'Inactive']
+ * ], ['Name', 'Age', 'Status']);
+ *
+ * // Advanced table with constants
+ * $this->table($users, ['Name', 'Status', 'Balance'], [
+ * TableOptions::STYLE => 'bordered',
+ * TableOptions::THEME => 'colorful',
+ * TableOptions::TITLE => 'User Management',
+ * TableOptions::COLUMNS => [
+ * 'Balance' => ['align' => 'right', 'formatter' => fn($v) => '$' . number_format($v, 2)]
+ * ],
+ * TableOptions::COLORIZE => [
+ * 'Status' => fn($v) => match($v) {
+ * 'Active' => ['color' => 'green', 'bold' => true],
+ * 'Inactive' => ['color' => 'red'],
+ * default => []
+ * }
+ * ]
+ * ]);
+ * ```
+ */
+ public function table(array $data, array $headers = [], array $options = []): Command {
+ // Handle empty data
+ if (empty($data)) {
+ $this->info('No data to display in table.');
+
+ return $this;
+ }
+
+ try {
+ // Create table builder instance
+ $tableBuilder = TableBuilder::create();
+
+ // Set headers
+ if (!empty($headers)) {
+ $tableBuilder->setHeaders($headers);
+ }
+
+ // Set data
+ $tableBuilder->setData($data);
+
+ // Apply style (support both constant and string)
+ $style = $options[TableOptions::STYLE] ?? $options['style'] ?? 'bordered';
+ $tableBuilder->useStyle($style);
+
+ // Apply theme (support both constant and string)
+ $theme = $options[TableOptions::THEME] ?? $options['theme'] ?? null;
+
+ if ($theme !== null) {
+ $themeObj = TableTheme::create($theme);
+ $tableBuilder->setTheme($themeObj);
+ }
+
+ // Set title (support both constant and string)
+ $title = $options[TableOptions::TITLE] ?? $options['title'] ?? null;
+
+ if ($title !== null) {
+ $tableBuilder->setTitle($title);
+ }
+
+ // Set width (support both constant and string)
+ $width = $options[TableOptions::WIDTH] ?? $options['width'] ?? $this->getTerminalWidth();
+ $tableBuilder->setMaxWidth($width);
+
+ // Configure headers visibility (support both constant and string)
+ $showHeaders = $options[TableOptions::SHOW_HEADERS] ?? $options['showHeaders'] ?? true;
+ $tableBuilder->showHeaders($showHeaders);
+
+ // Configure columns (support both constant and string)
+ $columns = $options[TableOptions::COLUMNS] ?? $options['columns'] ?? [];
+
+ if (!empty($columns) && is_array($columns)) {
+ foreach ($columns as $columnName => $columnConfig) {
+ $tableBuilder->configureColumn($columnName, $columnConfig);
+ }
+ }
+
+ // Apply colorization (support both constant and string)
+ $colorize = $options[TableOptions::COLORIZE] ?? $options['colorize'] ?? [];
+
+ if (!empty($colorize) && is_array($colorize)) {
+ foreach ($colorize as $columnName => $colorizer) {
+ if (is_callable($colorizer)) {
+ $tableBuilder->colorizeColumn($columnName, $colorizer);
+ }
+ }
+ }
+
+ // Render and display the table
+ $output = $tableBuilder->render();
+ $this->prints($output);
+ } catch (Exception $e) {
+ $this->error('Failed to display table: '.$e->getMessage());
+ } catch (Error $e) {
+ $this->error('Table display error: '.$e->getMessage());
+ }
+
+ return $this;
+ }
+ /**
+ * Display a message that represents a warning.
+ *
+ * The message will be prefixed with the string 'Warning:' in
+ * red.
+ *
+ * @param string $message The message that will be shown.
+ *
+ */
+ public function warning(string $message): void {
+ $this->prints('Warning: ', [
+ 'color' => 'light-yellow',
+ 'bold' => true
+ ]);
+ $this->println($message);
+ }
+
+ /**
+ * Executes a callback for each item with a progress bar.
+ *
+ * @param iterable $items Items to iterate over
+ * @param callable $callback Callback to execute for each item
+ * @param string $message Optional message to display
+ * @return void
+ */
+ public function withProgressBar(iterable $items, callable $callback, string $message = ''): void {
+ $items = is_array($items) ? $items : iterator_to_array($items);
+ $total = count($items);
+
+ $progressBar = $this->createProgressBar($total);
+ $progressBar->start($message);
+
+ foreach ($items as $key => $item) {
+ $callback($item, $key);
+ $progressBar->advance();
+ }
+
+ $progressBar->finish();
+ }
+
+ private function _createPassArray($string, array $args) : array {
+ $retVal = [$string];
+
+ foreach ($args as $arg) {
+ if (gettype($arg) != 'array') {
+ $retVal[] = $arg;
+ }
+ }
+
+ return $retVal;
+ }
+ private function checkIsArgsSetHelper(): bool {
+ $missingMandatory = [];
+
+ foreach ($this->commandArgs as $argObj) {
+ if (!$argObj->isOptional() && $argObj->getValue() === null && $argObj->getDefault() != '') {
+ $argObj->setValue($argObj->getDefault());
+ } else if (!$argObj->isOptional() && $argObj->getValue() === null) {
+ $missingMandatory[] = $argObj->getName();
+ }
+ }
+
+ if (count($missingMandatory) != 0) {
+ $missingStr = 'The following required argument(s) are missing: ';
+ $comma = '';
+
+ foreach ($missingMandatory as $opt) {
+ $missingStr .= $comma."'".$opt."'";
+ $comma = ', ';
+ }
+ $this->error($missingStr);
+
+ return false;
+ }
+
+ return true;
+ }
+ private function checkSelectedChoice(array $choices, int $defaultIndex, string $input): ?string {
+ $retVal = null;
+
+ if (in_array($input, $choices)) {
+ //Given input is exactly same as one of choices
+ $retVal = $input;
+ } else if (strlen($input) == 0 && $defaultIndex !== null) {
+ //Given input is empty string (enter hit).
+ //Return default if specified.
+ $retVal = $this->getDefaultChoiceHelper($choices, $defaultIndex);
+ } else if (InputValidator::isInt($input)) {
+ //Selected option is an index. Search for it and return its value.
+ $retVal = $this->getChoiceAtIndex($choices, (int)$input);
+ }
+
+ if ($retVal === null) {
+ $this->error('Invalid answer.');
+ }
+
+ return $retVal;
+ }
+ private function getChoiceAtIndex(array $choices, int $input): ?string {
+ $index = 0;
+
+ foreach ($choices as $choice) {
+ if ($index == $input) {
+ return $choice;
+ }
+ $index++;
+ }
+
+ return null;
+ }
+ private function getDefaultChoiceHelper(array $choices, int $defaultIndex): ?string {
+ $index = 0;
+
+ foreach ($choices as $choice) {
+ if ($index == $defaultIndex) {
+ return $choice;
+ }
+ $index++;
+ }
+
+ return null;
+ }
+ /**
+ * Validate user input and show error message if user input is invalid.
+ * @param string $input
+ * @param InputValidator|null $validator
+ * @param string|null $default
+ * @return array The method will return an array with two indices, 'valid' and
+ * 'value'. The 'valid' index contains a boolean that is set to true if the
+ * value is valid. The index 'value' will contain the passed value.
+ */
+ private function getInputHelper(string &$input, ?InputValidator $validator = null, ?string $default = null) : array {
+ $retVal = [
+ 'valid' => true
+ ];
+
+ if (strlen($input) == 0 && $default !== null) {
+ $input = $default;
+ } else if ($validator !== null) {
+ $retVal['valid'] = $validator->isValid($input);
+
+ if (!($retVal['valid'] === true)) {
+ $this->error($validator->getErrPrompt());
+ }
+ }
+ $retVal['value'] = $input;
+
+ return $retVal;
+ }
+
+ /**
+ * Get terminal width for responsive table display.
+ *
+ * @return int Terminal width in characters, defaults to 80 if unable to detect.
+ */
+ private function getTerminalWidth(): int {
+ // Try to get terminal width using tput
+ $width = @exec('tput cols 2>/dev/null');
+
+ if (is_numeric($width) && $width > 0) {
+ return (int)$width;
+ }
+
+ // Try environment variable
+ $width = getenv('COLUMNS');
+
+ if ($width !== false && is_numeric($width) && $width > 0) {
+ return (int)$width;
+ }
+
+ // Try using stty
+ $width = @exec('stty size 2>/dev/null | cut -d" " -f2');
+
+ if (is_numeric($width) && $width > 0) {
+ return (int)$width;
+ }
+
+ // Default fallback
+ return 80;
+ }
+ private function parseArgsHelper() : bool {
+ $options = $this->getArgs();
+ $invalidArgsVals = [];
+
+ foreach ($options as $argObj) {
+ $val = $this->getArgValue($argObj->getName());
+
+ if ($val !== null && !$argObj->setValue($val)) {
+ $invalidArgsVals[] = $argObj->getName();
+ }
+ }
+
+ if (count($invalidArgsVals) != 0) {
+ $invalidStr = 'The following argument(s) have invalid values: ';
+ $comma = '';
+
+ foreach ($invalidArgsVals as $argName) {
+ $invalidStr .= $comma."'".$argName."'";
+ $comma = ', ';
+ }
+ $this->error($invalidStr);
+
+ foreach ($invalidArgsVals as $argName) {
+ $this->info("Allowed values for the argument '$argName':");
+
+ foreach ($this->getArg($argName)->getAllowedValues() as $val) {
+ $this->println($val);
+ }
+ }
+
+ return false;
+ }
+
+ return true;
+ }
+ private function printChoices(array $choices, int $default): void {
+ $index = 0;
+
+ foreach ($choices as $choiceTxt) {
+ if ($default !== null && $index == $default) {
+ $this->prints($index.": ".$choiceTxt, [
+ 'color' => 'light-blue',
+ 'bold' => 'true'
+ ]);
+ $this->println(' <--');
+ } else {
+ $this->println($index.": ".$choiceTxt);
+ }
+ $index++;
+ }
+ }
+ private function printMsg(string $msg, string $prefix, string $color) {
+ $this->prints("$prefix: ", [
+ 'color' => $color,
+ 'bold' => true,
+
+ ]);
+ $this->println($msg);
+ }
+}
diff --git a/WebFiori/Cli/CommandTestCase.php b/WebFiori/Cli/CommandTestCase.php
index 90e232c..d542dae 100644
--- a/WebFiori/Cli/CommandTestCase.php
+++ b/WebFiori/Cli/CommandTestCase.php
@@ -1,173 +1,173 @@
-getRunner(true);
-
- foreach ($commands as $command) {
- $runner->register($command);
- }
- $runner->setDefaultCommand($default);
- $this->exec($argv, $userInputs);
-
- return $this->getOutput();
- }
- /**
- * Executes a specific command and return its output as an array.
- *
- * @param Command $command The command that will be tested.
- *
- * @param array $argv Arguments vector that will be passed to the command.
- * This can be an associative array of options and values or just options.
- *
- * @param array $userInputs A sequence of strings that represents user inputs
- * when the command is executing. Each index in the array represents a single
- * line of input.
- *
- * @return array The method will return an array that will hold
- * outputs line by line in each index.
- */
- public function executeSingleCommand(Command $command, array $argv = [], array $userInputs = []) : array {
- $this->getRunner(true)->register($command);
- $this->exec($argv, $userInputs, $command);
-
- return $this->getOutput();
- }
- /**
- * Returns an integer thar represents exit status of running specific command.
- *
- * @return int Default return value is 0.
- */
- public function getExitCode() : int {
- if ($this->exitStatus === null) {
- $this->exitStatus = 0;
- }
-
- return $this->exitStatus;
- }
- /**
- * Returns an array that holds all outputs that was generated by running specific
- * command.
- *
- * @return array If no command was executed, the array will be empty. Other
- * than that, the array will hold outputs line by line in each index.
- */
- public function getOutput() : array {
- if ($this->outputs === null) {
- $this->outputs = [];
- }
-
- return $this->outputs;
- }
- /**
- * Returns the instance that the class is using to execute the commands.
- *
- * @param bool $reset If set to true, input stream, output stream and,
- * registered commands of the runner will reset to default.
- *
- * @return Runner The instance that the class is using to execute the commands.
- */
- public function getRunner(bool $reset = false) : Runner {
- if ($this->runner === null) {
- $this->runner = new Runner();
- }
-
- if ($reset) {
- $this->runner->reset();
- }
-
- return $this->runner;
- }
- /**
- * Sets a custom runner to use in test execution.
- *
- * @param Runner $runner
- *
- * @return CommandTestCase The method will return same instance at which
- * the method is called from.
- */
- public function setRunner(Runner $runner) : CommandTestCase {
- $this->runner = $runner;
-
- return $this;
- }
- private function exec(array $argv, array $userInputs, ?Command $command = null) {
- if ($command !== null) {
- $key = array_search($command->getName(), $argv);
-
- if ($key != 0 || $key === false) {
- $argv = array_merge(['main.php', $command->getName()], $argv);
- } else {
- $argv = array_merge(['main.php'], $argv);
- }
- } else {
- $argv = array_merge(['main.php'], $argv);
- }
- $runner = $this->getRunner();
-
- //Set arguments vector
- $runner->setArgsVector($argv);
-
- //Set user inputs.
- //Must be called to use Array as input and output stream even if there are no inputs.
- $runner->setInputs($userInputs);
-
- //Start the process
- $this->exitStatus = $runner->start();
-
- $this->outputs = $runner->getOutput();
- }
-}
+getRunner(true);
+
+ foreach ($commands as $command) {
+ $runner->register($command);
+ }
+ $runner->setDefaultCommand($default);
+ $this->exec($argv, $userInputs);
+
+ return $this->getOutput();
+ }
+ /**
+ * Executes a specific command and return its output as an array.
+ *
+ * @param Command $command The command that will be tested.
+ *
+ * @param array $argv Arguments vector that will be passed to the command.
+ * This can be an associative array of options and values or just options.
+ *
+ * @param array $userInputs A sequence of strings that represents user inputs
+ * when the command is executing. Each index in the array represents a single
+ * line of input.
+ *
+ * @return array The method will return an array that will hold
+ * outputs line by line in each index.
+ */
+ public function executeSingleCommand(Command $command, array $argv = [], array $userInputs = []) : array {
+ $this->getRunner(true)->register($command);
+ $this->exec($argv, $userInputs, $command);
+
+ return $this->getOutput();
+ }
+ /**
+ * Returns an integer thar represents exit status of running specific command.
+ *
+ * @return int Default return value is 0.
+ */
+ public function getExitCode() : int {
+ if ($this->exitStatus === null) {
+ $this->exitStatus = 0;
+ }
+
+ return $this->exitStatus;
+ }
+ /**
+ * Returns an array that holds all outputs that was generated by running specific
+ * command.
+ *
+ * @return array If no command was executed, the array will be empty. Other
+ * than that, the array will hold outputs line by line in each index.
+ */
+ public function getOutput() : array {
+ if ($this->outputs === null) {
+ $this->outputs = [];
+ }
+
+ return $this->outputs;
+ }
+ /**
+ * Returns the instance that the class is using to execute the commands.
+ *
+ * @param bool $reset If set to true, input stream, output stream and,
+ * registered commands of the runner will reset to default.
+ *
+ * @return Runner The instance that the class is using to execute the commands.
+ */
+ public function getRunner(bool $reset = false) : Runner {
+ if ($this->runner === null) {
+ $this->runner = new Runner();
+ }
+
+ if ($reset) {
+ $this->runner->reset();
+ }
+
+ return $this->runner;
+ }
+ /**
+ * Sets a custom runner to use in test execution.
+ *
+ * @param Runner $runner
+ *
+ * @return CommandTestCase The method will return same instance at which
+ * the method is called from.
+ */
+ public function setRunner(Runner $runner) : CommandTestCase {
+ $this->runner = $runner;
+
+ return $this;
+ }
+ private function exec(array $argv, array $userInputs, ?Command $command = null) {
+ if ($command !== null) {
+ $key = array_search($command->getName(), $argv);
+
+ if ($key != 0 || $key === false) {
+ $argv = array_merge(['main.php', $command->getName()], $argv);
+ } else {
+ $argv = array_merge(['main.php'], $argv);
+ }
+ } else {
+ $argv = array_merge(['main.php'], $argv);
+ }
+ $runner = $this->getRunner();
+
+ //Set arguments vector
+ $runner->setArgsVector($argv);
+
+ //Set user inputs.
+ //Must be called to use Array as input and output stream even if there are no inputs.
+ $runner->setInputs($userInputs);
+
+ //Start the process
+ $this->exitStatus = $runner->start();
+
+ $this->outputs = $runner->getOutput();
+ }
+}
diff --git a/WebFiori/Cli/Commands/HelpCommand.php b/WebFiori/Cli/Commands/HelpCommand.php
index a199118..e7f4eb8 100644
--- a/WebFiori/Cli/Commands/HelpCommand.php
+++ b/WebFiori/Cli/Commands/HelpCommand.php
@@ -1,163 +1,163 @@
- [
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DESCRIPTION => 'An optional command name. If provided, help '
- .'will be specific to the given command only.'
- ],
- '--table' => [
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DESCRIPTION => 'Display command arguments in table format for better readability.'
- ]
- ], 'Display CLI Help. To display help for specific command, use the argument '
- .'"--command" with this command.', ['-h']);
- }
- /**
- * Execute the command.
- *
- */
- public function exec() : int {
- $regCommands = $this->getOwner()->getCommands();
- $commandName = $this->getArgValue('--command');
- $len = $this->getMaxCommandNameLen();
-
- if ($commandName !== null) {
- if (isset($regCommands[$commandName])) {
- $this->printCommandInfo($regCommands[$commandName], $len, true);
- } else {
- $this->error("Command '$commandName' is not supported.");
- }
- } else {
- $formattingOptions = [
- 'bold' => true,
- 'color' => 'light-yellow'
- ];
- $this->println("Usage:", $formattingOptions);
- $this->println(" command [arg1 arg2=\"val\" arg3...]\n");
- $this->printGlobalArgs($formattingOptions);
- $this->println("Available Commands:", $formattingOptions);
-
- foreach ($regCommands as $commandObj) {
- $this->printCommandInfo($commandObj, $len);
- }
- }
-
- return 0;
- }
- private function getMaxCommandNameLen() : int {
- $len = 0;
-
- foreach ($this->getOwner()->getCommands() as $c) {
- $xLen = strlen($c->getName());
-
- if ($xLen > $len) {
- $len = $xLen;
- }
- }
-
- return $len;
- }
- private function printArg(Argument $argObj, $spaces = 25) {
- $this->prints(" %".$spaces."s:", $argObj->getName(), [
- 'bold' => true,
- 'color' => 'yellow'
- ]);
-
- if ($argObj->isOptional()) {
- $this->prints("[Optional]");
- }
-
- if ($argObj->getDefault() != '') {
- $default = $argObj->getDefault();
- $this->prints("[Default = '$default']");
- }
- $this->println(" %s", $argObj->getDescription());
- }
-
- private function printArgsTable(array $args) {
- $rows = [];
- foreach ($args as $argObj) {
- $name = $argObj->getName();
- $required = $argObj->isOptional() ? 'No' : 'Yes';
- $default = $argObj->getDefault() ?: '-';
- $description = $argObj->getDescription() ?: '';
-
- $rows[] = [$name, $required, $default, $description];
- }
-
- $this->table($rows, ['Argument', 'Required', 'Default', 'Description']);
- }
-
- /**
- * Prints meta information of a specific command.
- *
- * @param Command $cliCommand
- *
- * @param int $len
- *
- * @param bool $withArgs
- */
- private function printCommandInfo(Command $cliCommand, int $len, bool $withArgs = false) {
- $this->prints(" %s", $cliCommand->getName(), [
- 'color' => 'yellow',
- 'bold' => true
- ]);
- $this->prints(': ');
- $spacesCount = $len - strlen($cliCommand->getName()) + 4;
- $this->println(str_repeat(' ', $spacesCount)."%s", $cliCommand->getDescription());
-
- if ($withArgs) {
- $args = array_filter($cliCommand->getArgs(), function($arg) {
- return !in_array($arg->getName(), ['help', '-h']);
- });
-
- if (count($args) != 0) {
- $this->println(" Supported Arguments:", [
- 'bold' => true,
- 'color' => 'light-blue'
- ]);
-
- if ($this->getArgValue('--table') !== null) {
- $this->printArgsTable($args);
- } else {
- foreach ($args as $argObj) {
- $this->printArg($argObj);
- }
- }
- }
- }
- }
- private function printGlobalArgs(array $formattingOptions) {
- $args = $this->getOwner()->getArgs();
-
- if (count($args) != 0) {
- $this->println("Global Arguments:", $formattingOptions);
-
- foreach ($args as $argObj) {
- $this->printArg($argObj, 4);
- }
- }
- }
-}
+ [
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DESCRIPTION => 'An optional command name. If provided, help '
+ .'will be specific to the given command only.'
+ ],
+ '--table' => [
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DESCRIPTION => 'Display command arguments in table format for better readability.'
+ ]
+ ], 'Display CLI Help. To display help for specific command, use the argument '
+ .'"--command" with this command.', ['-h']);
+ }
+ /**
+ * Execute the command.
+ *
+ */
+ public function exec() : int {
+ $regCommands = $this->getOwner()->getCommands();
+ $commandName = $this->getArgValue('--command');
+ $len = $this->getMaxCommandNameLen();
+
+ if ($commandName !== null) {
+ if (isset($regCommands[$commandName])) {
+ $this->printCommandInfo($regCommands[$commandName], $len, true);
+ } else {
+ $this->error("Command '$commandName' is not supported.");
+ }
+ } else {
+ $formattingOptions = [
+ 'bold' => true,
+ 'color' => 'light-yellow'
+ ];
+ $this->println("Usage:", $formattingOptions);
+ $this->println(" command [arg1 arg2=\"val\" arg3...]\n");
+ $this->printGlobalArgs($formattingOptions);
+ $this->println("Available Commands:", $formattingOptions);
+
+ foreach ($regCommands as $commandObj) {
+ $this->printCommandInfo($commandObj, $len);
+ }
+ }
+
+ return 0;
+ }
+ private function getMaxCommandNameLen() : int {
+ $len = 0;
+
+ foreach ($this->getOwner()->getCommands() as $c) {
+ $xLen = strlen($c->getName());
+
+ if ($xLen > $len) {
+ $len = $xLen;
+ }
+ }
+
+ return $len;
+ }
+ private function printArg(Argument $argObj, $spaces = 25) {
+ $this->prints(" %".$spaces."s:", $argObj->getName(), [
+ 'bold' => true,
+ 'color' => 'yellow'
+ ]);
+
+ if ($argObj->isOptional()) {
+ $this->prints("[Optional]");
+ }
+
+ if ($argObj->getDefault() != '') {
+ $default = $argObj->getDefault();
+ $this->prints("[Default = '$default']");
+ }
+ $this->println(" %s", $argObj->getDescription());
+ }
+
+ private function printArgsTable(array $args) {
+ $rows = [];
+ foreach ($args as $argObj) {
+ $name = $argObj->getName();
+ $required = $argObj->isOptional() ? 'No' : 'Yes';
+ $default = $argObj->getDefault() ?: '-';
+ $description = $argObj->getDescription() ?: '';
+
+ $rows[] = [$name, $required, $default, $description];
+ }
+
+ $this->table($rows, ['Argument', 'Required', 'Default', 'Description']);
+ }
+
+ /**
+ * Prints meta information of a specific command.
+ *
+ * @param Command $cliCommand
+ *
+ * @param int $len
+ *
+ * @param bool $withArgs
+ */
+ private function printCommandInfo(Command $cliCommand, int $len, bool $withArgs = false) {
+ $this->prints(" %s", $cliCommand->getName(), [
+ 'color' => 'yellow',
+ 'bold' => true
+ ]);
+ $this->prints(': ');
+ $spacesCount = $len - strlen($cliCommand->getName()) + 4;
+ $this->println(str_repeat(' ', $spacesCount)."%s", $cliCommand->getDescription());
+
+ if ($withArgs) {
+ $args = array_filter($cliCommand->getArgs(), function($arg) {
+ return !in_array($arg->getName(), ['help', '-h']);
+ });
+
+ if (count($args) != 0) {
+ $this->println(" Supported Arguments:", [
+ 'bold' => true,
+ 'color' => 'light-blue'
+ ]);
+
+ if ($this->getArgValue('--table') !== null) {
+ $this->printArgsTable($args);
+ } else {
+ foreach ($args as $argObj) {
+ $this->printArg($argObj);
+ }
+ }
+ }
+ }
+ }
+ private function printGlobalArgs(array $formattingOptions) {
+ $args = $this->getOwner()->getArgs();
+
+ if (count($args) != 0) {
+ $this->println("Global Arguments:", $formattingOptions);
+
+ foreach ($args as $argObj) {
+ $this->printArg($argObj, 4);
+ }
+ }
+ }
+}
diff --git a/WebFiori/Cli/Commands/InitAppCommand.php b/WebFiori/Cli/Commands/InitAppCommand.php
index 459080b..fbc2e45 100644
--- a/WebFiori/Cli/Commands/InitAppCommand.php
+++ b/WebFiori/Cli/Commands/InitAppCommand.php
@@ -1,130 +1,130 @@
- [
- ArgumentOption::DESCRIPTION => 'The name of entry point that is used to execute the application.',
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DEFAULT => 'main'
- ],
- ], 'Initialize new CLI application.');
- }
- public function exec(): int {
- $dirName = $this->getArgValue('--dir');
- $entry = $this->getArgValue('--entry');
-
- if ($entry === null) {
- $entry = 'main';
- }
-
- if (defined('ROOT_DIR')) {
- $path = ROOT_DIR;
- if ($path[strlen($path) - 1] != DIRECTORY_SEPARATOR) {
- $path .= DIRECTORY_SEPARATOR;
- }
- $appPath = $path.$dirName;
- } else {
- $appPath = getcwd().DIRECTORY_SEPARATOR.$dirName;
- }
-
- try {
- $this->println('Creating new app at "'.$appPath.'" ...');
- $this->createAppClass($appPath, $dirName);
- $this->createEntryPoint($appPath, $dirName, $entry);
- $this->createSampleCommand($appPath, $dirName);
- $this->success('App created successfully.');
-
- return 0;
- } catch (\Throwable $ex) {
- $this->error('Unable to initialize due to an exception:');
- $this->println($ex->getCode().' - '.$ex->getMessage());
-
- return -1;
- }
- }
- private function createAppClass(string $appPath, string $dirName) {
- $this->println('Creating "'.$dirName.'/main.php"...');
- $file = new File($appPath.DIRECTORY_SEPARATOR.'main.php');
-
- if (!$file->isExist()) {
- $file->append("append("namespace $dirName;\n\n");
- $file->append("//Entry point of your application.\n\n");
- $file->append("require '../vendor/autoload.php';\n\n");
- $file->append("use WebFiori\\Cli\\Runner;\n");
-
- $file->append("\$runner = new Runner();\n\n");
- $file->append("//TODO: Register Commands.\n");
- $file->append("\$runner->register(new HelloCommand());\n\n");
- $file->append("//Start your application.\n");
- $file->append("exit(\$runner->start());\n\n");
- $file->create(true);
- $file->write(false);
-
- return true;
- }
- $this->warning('File main.php already exist!');
- }
- private function createEntryPoint(string $appPath, string $dir, string $eName) {
- $this->println('Creating "'.$dir.'/'.$eName.'"...');
- $file = new File($eName, $appPath);
-
- if (!$file->isExist()) {
- $data = "#!/usr/bin/env php\n"
- ."create(true);
- file_put_contents($file->getDir().DIRECTORY_SEPARATOR.$eName, $data);
-
- return true;
- }
- $this->warning('File '.$eName.' already exist!');
- }
- private function createSampleCommand(string $appPath, string $dirName) {
- $this->println('Creating "'.$dirName.'/HelloCommand.php"...');
- $file = new File($appPath.DIRECTORY_SEPARATOR.'HelloCommand.php');
-
- if (!$file->isExist()) {
- $file->append("append("namespace $dirName;\n\n");
- $file->append("use WebFiori\\Cli\\Command;\n");
- $file->append("use WebFiori\\Cli\\ArgumentOption;\n\n");
- $file->append("class HelloCommand extends Command {\n");
- $file->append(" public function __construct() {\n");
- $file->append(" parent::__construct('hello', [\n");
- $file->append(" '--my-name' => [\n");
- $file->append(" ArgumentOption::OPTIONAL => true,\n");
- $file->append(" ArgumentOption::DESCRIPTION => 'Your name to greet'\n");
- $file->append(" ]\n");
- $file->append(" ], 'A sample hello command');\n");
- $file->append(" }\n\n");
- $file->append(" public function exec(): int {\n");
- $file->append(" \$name = \$this->getArgValue('--my-name');\n");
- $file->append(" if (\$name !== null) {\n");
- $file->append(" \$this->println('Hello %s', \$name);\n");
- $file->append(" } else {\n");
- $file->append(" \$this->println('Hello from WebFiori CLI!');\n");
- $file->append(" }\n");
- $file->append(" return 0;\n");
- $file->append(" }\n");
- $file->append("}\n");
- $file->create(true);
- $file->write(false);
- } else {
- $this->warning('File HelloCommand.php already exist!');
- }
- }
-}
+ [
+ ArgumentOption::DESCRIPTION => 'The name of entry point that is used to execute the application.',
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DEFAULT => 'main'
+ ],
+ ], 'Initialize new CLI application.');
+ }
+ public function exec(): int {
+ $dirName = $this->getArgValue('--dir');
+ $entry = $this->getArgValue('--entry');
+
+ if ($entry === null) {
+ $entry = 'main';
+ }
+
+ if (defined('ROOT_DIR')) {
+ $path = ROOT_DIR;
+ if ($path[strlen($path) - 1] != DIRECTORY_SEPARATOR) {
+ $path .= DIRECTORY_SEPARATOR;
+ }
+ $appPath = $path.$dirName;
+ } else {
+ $appPath = getcwd().DIRECTORY_SEPARATOR.$dirName;
+ }
+
+ try {
+ $this->println('Creating new app at "'.$appPath.'" ...');
+ $this->createAppClass($appPath, $dirName);
+ $this->createEntryPoint($appPath, $dirName, $entry);
+ $this->createSampleCommand($appPath, $dirName);
+ $this->success('App created successfully.');
+
+ return 0;
+ } catch (\Throwable $ex) {
+ $this->error('Unable to initialize due to an exception:');
+ $this->println($ex->getCode().' - '.$ex->getMessage());
+
+ return -1;
+ }
+ }
+ private function createAppClass(string $appPath, string $dirName) {
+ $this->println('Creating "'.$dirName.'/main.php"...');
+ $file = new File($appPath.DIRECTORY_SEPARATOR.'main.php');
+
+ if (!$file->isExist()) {
+ $file->append("append("namespace $dirName;\n\n");
+ $file->append("//Entry point of your application.\n\n");
+ $file->append("require '../vendor/autoload.php';\n\n");
+ $file->append("use WebFiori\\Cli\\Runner;\n");
+
+ $file->append("\$runner = new Runner();\n\n");
+ $file->append("//TODO: Register Commands.\n");
+ $file->append("\$runner->register(new HelloCommand());\n\n");
+ $file->append("//Start your application.\n");
+ $file->append("exit(\$runner->start());\n\n");
+ $file->create(true);
+ $file->write(false);
+
+ return true;
+ }
+ $this->warning('File main.php already exist!');
+ }
+ private function createEntryPoint(string $appPath, string $dir, string $eName) {
+ $this->println('Creating "'.$dir.'/'.$eName.'"...');
+ $file = new File($eName, $appPath);
+
+ if (!$file->isExist()) {
+ $data = "#!/usr/bin/env php\n"
+ ."create(true);
+ file_put_contents($file->getDir().DIRECTORY_SEPARATOR.$eName, $data);
+
+ return true;
+ }
+ $this->warning('File '.$eName.' already exist!');
+ }
+ private function createSampleCommand(string $appPath, string $dirName) {
+ $this->println('Creating "'.$dirName.'/HelloCommand.php"...');
+ $file = new File($appPath.DIRECTORY_SEPARATOR.'HelloCommand.php');
+
+ if (!$file->isExist()) {
+ $file->append("append("namespace $dirName;\n\n");
+ $file->append("use WebFiori\\Cli\\Command;\n");
+ $file->append("use WebFiori\\Cli\\ArgumentOption;\n\n");
+ $file->append("class HelloCommand extends Command {\n");
+ $file->append(" public function __construct() {\n");
+ $file->append(" parent::__construct('hello', [\n");
+ $file->append(" '--my-name' => [\n");
+ $file->append(" ArgumentOption::OPTIONAL => true,\n");
+ $file->append(" ArgumentOption::DESCRIPTION => 'Your name to greet'\n");
+ $file->append(" ]\n");
+ $file->append(" ], 'A sample hello command');\n");
+ $file->append(" }\n\n");
+ $file->append(" public function exec(): int {\n");
+ $file->append(" \$name = \$this->getArgValue('--my-name');\n");
+ $file->append(" if (\$name !== null) {\n");
+ $file->append(" \$this->println('Hello %s', \$name);\n");
+ $file->append(" } else {\n");
+ $file->append(" \$this->println('Hello from WebFiori CLI!');\n");
+ $file->append(" }\n");
+ $file->append(" return 0;\n");
+ $file->append(" }\n");
+ $file->append("}\n");
+ $file->create(true);
+ $file->write(false);
+ } else {
+ $this->warning('File HelloCommand.php already exist!');
+ }
+ }
+}
diff --git a/WebFiori/Cli/Commands/MakeCommand.php b/WebFiori/Cli/Commands/MakeCommand.php
index 832f360..370c47a 100644
--- a/WebFiori/Cli/Commands/MakeCommand.php
+++ b/WebFiori/Cli/Commands/MakeCommand.php
@@ -1,221 +1,221 @@
-templateManager = new TemplateManager();
-
- parent::__construct('make:command', [
- '--name' => [
- ArgumentOption::DESCRIPTION => 'The name of the command (e.g., "user:create")',
- ArgumentOption::OPTIONAL => false
- ],
- '--class' => [
- ArgumentOption::DESCRIPTION => 'The class name (e.g., "CreateUserCommand")',
- ArgumentOption::OPTIONAL => true
- ],
- '--path' => [
- ArgumentOption::DESCRIPTION => 'Output directory path',
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DEFAULT => 'commands'
- ],
- '--namespace' => [
- ArgumentOption::DESCRIPTION => 'PHP namespace for the command class',
- ArgumentOption::OPTIONAL => true
- ],
- '--interactive' => [
- ArgumentOption::DESCRIPTION => 'Generate command with interactive prompts',
- ArgumentOption::OPTIONAL => true
- ],
- '--args' => [
- ArgumentOption::DESCRIPTION => 'Add command arguments (comma-separated)',
- ArgumentOption::OPTIONAL => true
- ],
- '--template' => [
- ArgumentOption::DESCRIPTION => 'Template type to use',
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::VALUES => $this->templateManager->getAvailableTemplates(),
- ArgumentOption::DEFAULT => 'basic'
- ]
- ], 'Generate a new CLI command class with scaffolding');
- }
-
- public function exec(): int {
- $this->println('๐ WebFiori CLI Command Generator');
- $this->println('=================================');
- $this->println();
-
- // Get command details
- $commandName = $this->getArgValue('--name');
- $className = $this->getArgValue('--class') ?? $this->generateClassName($commandName);
- $outputPath = $this->getArgValue('--path') ?? 'commands';
- $namespace = $this->getArgValue('--namespace');
- $template = $this->getArgValue('--template') ?? 'basic';
- $interactive = $this->isArgProvided('--interactive');
- $args = $this->getArgValue('--args');
-
- // Interactive mode for missing details
- if (!$namespace) {
- $namespace = $this->getInput('Enter namespace (optional): ') ?: null;
- }
-
- // Validate inputs
- if (!$this->validateInputs($commandName, $className)) {
- return 1;
- }
-
- // Generate command
- try {
- $filePath = $this->generateCommand([
- 'name' => $commandName,
- 'class' => $className,
- 'path' => $outputPath,
- 'namespace' => $namespace,
- 'template' => $template,
- 'interactive' => $interactive,
- 'args' => $args ? explode(',', $args) : []
- ]);
-
- $this->success("โ Command generated successfully!");
- $this->info("๐ File: $filePath");
- $this->info("๐ท๏ธ Class: $className");
- $this->info("โก Command: $commandName");
-
- $this->println();
- $this->println("Next steps:");
- $this->println("1. Register the command in your application");
- $this->println("2. Implement the exec() method logic");
- $this->println("3. Add any additional arguments or validation");
-
- return 0;
- } catch (\Exception $e) {
- $this->error("โ Failed to generate command: " . $e->getMessage());
- return 1;
- }
- }
-
- /**
- * Generate class name from command name.
- */
- private function generateClassName(string $commandName): string {
- // Convert command-name or namespace:command to ClassName
- $parts = preg_split('/[:\-_]/', $commandName);
- $className = '';
-
- foreach ($parts as $part) {
- $className .= ucfirst(strtolower($part));
- }
-
- return $className . 'Command';
- }
-
- /**
- * Validate command inputs.
- */
- private function validateInputs(string $commandName, string $className): bool {
- // Validate command name
- if (!preg_match('/^[a-z][a-z0-9\-:_]*$/', $commandName)) {
- $this->error('Command name must start with a letter and contain only lowercase letters, numbers, hyphens, colons, and underscores.');
- return false;
- }
-
- // Validate class name
- if (!preg_match('/^[A-Z][a-zA-Z0-9]*$/', $className)) {
- $this->error('Class name must be a valid PHP class name (PascalCase).');
- return false;
- }
-
- return true;
- }
-
- /**
- * Generate the command file.
- */
- private function generateCommand(array $config): string {
- $content = $this->templateManager->processTemplate($config['template'], [
- 'namespace' => $config['namespace'] ? "namespace {$config['namespace']};\n\n" : '',
- 'use_statements' => $this->generateUseStatements($config),
- 'class_name' => $config['class'],
- 'command_name' => $config['name'],
- 'command_description' => "Description for {$config['name']} command",
- 'arguments' => $this->generateArguments($config['args'])
- ]);
-
- // Ensure output directory exists
- $outputDir = $config['path'];
- if (!is_dir($outputDir)) {
- mkdir($outputDir, 0755, true);
- }
-
- // Generate file path
- $fileName = $config['class'] . '.php';
- $filePath = rtrim($outputDir, '/') . '/' . $fileName;
-
- // Check if file exists
- if (file_exists($filePath)) {
- $overwrite = $this->confirm("File $filePath already exists. Overwrite?");
- if (!$overwrite) {
- throw new \Exception("File already exists and overwrite was declined.");
- }
- }
-
- // Write file
- file_put_contents($filePath, $content);
-
- return $filePath;
- }
-
- /**
- * Generate use statements.
- */
- private function generateUseStatements(array $config): string {
- $uses = [
- 'use WebFiori\Cli\Command;',
- 'use WebFiori\Cli\ArgumentOption;'
- ];
-
- if ($config['interactive'] || $config['template'] === 'interactive') {
- $uses[] = 'use WebFiori\Cli\InputValidator;';
- }
-
- return implode("\n", $uses);
- }
-
- /**
- * Generate command arguments array.
- */
- private function generateArguments(array $args): string {
- if (empty($args)) {
- return '[]';
- }
-
- $argStrings = [];
- foreach ($args as $arg) {
- $arg = trim($arg);
- $argName = '--' . strtolower(str_replace(' ', '-', $arg));
- $argStrings[] = " '$argName' => [\n" .
- " ArgumentOption::DESCRIPTION => 'Description for $arg',\n" .
- " ArgumentOption::OPTIONAL => true\n" .
- " ]";
- }
-
- return "[\n" . implode(",\n", $argStrings) . "\n ]";
- }
-}
+templateManager = new TemplateManager();
+
+ parent::__construct('make:command', [
+ '--name' => [
+ ArgumentOption::DESCRIPTION => 'The name of the command (e.g., "user:create")',
+ ArgumentOption::OPTIONAL => false
+ ],
+ '--class' => [
+ ArgumentOption::DESCRIPTION => 'The class name (e.g., "CreateUserCommand")',
+ ArgumentOption::OPTIONAL => true
+ ],
+ '--path' => [
+ ArgumentOption::DESCRIPTION => 'Output directory path',
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DEFAULT => 'commands'
+ ],
+ '--namespace' => [
+ ArgumentOption::DESCRIPTION => 'PHP namespace for the command class',
+ ArgumentOption::OPTIONAL => true
+ ],
+ '--interactive' => [
+ ArgumentOption::DESCRIPTION => 'Generate command with interactive prompts',
+ ArgumentOption::OPTIONAL => true
+ ],
+ '--args' => [
+ ArgumentOption::DESCRIPTION => 'Add command arguments (comma-separated)',
+ ArgumentOption::OPTIONAL => true
+ ],
+ '--template' => [
+ ArgumentOption::DESCRIPTION => 'Template type to use',
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::VALUES => $this->templateManager->getAvailableTemplates(),
+ ArgumentOption::DEFAULT => 'basic'
+ ]
+ ], 'Generate a new CLI command class with scaffolding');
+ }
+
+ public function exec(): int {
+ $this->println('๐ WebFiori CLI Command Generator');
+ $this->println('=================================');
+ $this->println();
+
+ // Get command details
+ $commandName = $this->getArgValue('--name');
+ $className = $this->getArgValue('--class') ?? $this->generateClassName($commandName);
+ $outputPath = $this->getArgValue('--path') ?? 'commands';
+ $namespace = $this->getArgValue('--namespace');
+ $template = $this->getArgValue('--template') ?? 'basic';
+ $interactive = $this->isArgProvided('--interactive');
+ $args = $this->getArgValue('--args');
+
+ // Interactive mode for missing details
+ if (!$namespace) {
+ $namespace = $this->getInput('Enter namespace (optional): ') ?: null;
+ }
+
+ // Validate inputs
+ if (!$this->validateInputs($commandName, $className)) {
+ return 1;
+ }
+
+ // Generate command
+ try {
+ $filePath = $this->generateCommand([
+ 'name' => $commandName,
+ 'class' => $className,
+ 'path' => $outputPath,
+ 'namespace' => $namespace,
+ 'template' => $template,
+ 'interactive' => $interactive,
+ 'args' => $args ? explode(',', $args) : []
+ ]);
+
+ $this->success("โ Command generated successfully!");
+ $this->info("๐ File: $filePath");
+ $this->info("๐ท๏ธ Class: $className");
+ $this->info("โก Command: $commandName");
+
+ $this->println();
+ $this->println("Next steps:");
+ $this->println("1. Register the command in your application");
+ $this->println("2. Implement the exec() method logic");
+ $this->println("3. Add any additional arguments or validation");
+
+ return 0;
+ } catch (\Exception $e) {
+ $this->error("โ Failed to generate command: " . $e->getMessage());
+ return 1;
+ }
+ }
+
+ /**
+ * Generate class name from command name.
+ */
+ private function generateClassName(string $commandName): string {
+ // Convert command-name or namespace:command to ClassName
+ $parts = preg_split('/[:\-_]/', $commandName);
+ $className = '';
+
+ foreach ($parts as $part) {
+ $className .= ucfirst(strtolower($part));
+ }
+
+ return $className . 'Command';
+ }
+
+ /**
+ * Validate command inputs.
+ */
+ private function validateInputs(string $commandName, string $className): bool {
+ // Validate command name
+ if (!preg_match('/^[a-z][a-z0-9\-:_]*$/', $commandName)) {
+ $this->error('Command name must start with a letter and contain only lowercase letters, numbers, hyphens, colons, and underscores.');
+ return false;
+ }
+
+ // Validate class name
+ if (!preg_match('/^[A-Z][a-zA-Z0-9]*$/', $className)) {
+ $this->error('Class name must be a valid PHP class name (PascalCase).');
+ return false;
+ }
+
+ return true;
+ }
+
+ /**
+ * Generate the command file.
+ */
+ private function generateCommand(array $config): string {
+ $content = $this->templateManager->processTemplate($config['template'], [
+ 'namespace' => $config['namespace'] ? "namespace {$config['namespace']};\n\n" : '',
+ 'use_statements' => $this->generateUseStatements($config),
+ 'class_name' => $config['class'],
+ 'command_name' => $config['name'],
+ 'command_description' => "Description for {$config['name']} command",
+ 'arguments' => $this->generateArguments($config['args'])
+ ]);
+
+ // Ensure output directory exists
+ $outputDir = $config['path'];
+ if (!is_dir($outputDir)) {
+ mkdir($outputDir, 0755, true);
+ }
+
+ // Generate file path
+ $fileName = $config['class'] . '.php';
+ $filePath = rtrim($outputDir, '/') . '/' . $fileName;
+
+ // Check if file exists
+ if (file_exists($filePath)) {
+ $overwrite = $this->confirm("File $filePath already exists. Overwrite?");
+ if (!$overwrite) {
+ throw new \Exception("File already exists and overwrite was declined.");
+ }
+ }
+
+ // Write file
+ file_put_contents($filePath, $content);
+
+ return $filePath;
+ }
+
+ /**
+ * Generate use statements.
+ */
+ private function generateUseStatements(array $config): string {
+ $uses = [
+ 'use WebFiori\Cli\Command;',
+ 'use WebFiori\Cli\ArgumentOption;'
+ ];
+
+ if ($config['interactive'] || $config['template'] === 'interactive') {
+ $uses[] = 'use WebFiori\Cli\InputValidator;';
+ }
+
+ return implode("\n", $uses);
+ }
+
+ /**
+ * Generate command arguments array.
+ */
+ private function generateArguments(array $args): string {
+ if (empty($args)) {
+ return '[]';
+ }
+
+ $argStrings = [];
+ foreach ($args as $arg) {
+ $arg = trim($arg);
+ $argName = '--' . strtolower(str_replace(' ', '-', $arg));
+ $argStrings[] = " '$argName' => [\n" .
+ " ArgumentOption::DESCRIPTION => 'Description for $arg',\n" .
+ " ArgumentOption::OPTIONAL => true\n" .
+ " ]";
+ }
+
+ return "[\n" . implode(",\n", $argStrings) . "\n ]";
+ }
+}
diff --git a/WebFiori/Cli/Discovery/AutoDiscoverable.php b/WebFiori/Cli/Discovery/AutoDiscoverable.php
index b21016f..320c4d4 100644
--- a/WebFiori/Cli/Discovery/AutoDiscoverable.php
+++ b/WebFiori/Cli/Discovery/AutoDiscoverable.php
@@ -1,21 +1,21 @@
-cacheFile = $cacheFile;
- $this->enabled = $enabled;
- }
-
- /**
- * Clear the cache.
- */
- public function clear(): void {
- if (file_exists($this->cacheFile)) {
- unlink($this->cacheFile);
- }
- }
-
- /**
- * Get cached commands if valid.
- *
- * @return array|null Array of command metadata or null if cache invalid
- */
- public function get(): ?array {
- if (!$this->enabled || !file_exists($this->cacheFile)) {
- return null;
- }
-
- $content = file_get_contents($this->cacheFile);
-
- if ($content === false) {
- return null;
- }
-
- $cache = json_decode($content, true);
-
- if (!$cache || !isset($cache['commands'], $cache['files'], $cache['timestamp'])) {
- return null;
- }
-
- // Check if cache is still valid
- if (!$this->isCacheValid($cache)) {
- return null;
- }
-
- return $cache['commands'];
- }
-
- /**
- * Get cache file path.
- *
- * @return string
- */
- public function getCacheFile(): string {
- return $this->cacheFile;
- }
-
- /**
- * Check if caching is enabled.
- *
- * @return bool
- */
- public function isEnabled(): bool {
- return $this->enabled;
- }
-
- /**
- * Set cache file path.
- *
- * @param string $cacheFile
- */
- public function setCacheFile(string $cacheFile): void {
- $this->cacheFile = $cacheFile;
- }
-
- /**
- * Enable or disable caching.
- *
- * @param bool $enabled
- */
- public function setEnabled(bool $enabled): void {
- $this->enabled = $enabled;
- }
-
- /**
- * Store commands in cache.
- *
- * @param array $commands Array of command metadata
- * @param array $files Array of file paths that were scanned
- */
- public function store(array $commands, array $files): void {
- if (!$this->enabled) {
- return;
- }
-
- $this->ensureCacheDirectory();
-
- $fileInfo = [];
-
- foreach ($files as $file) {
- if (file_exists($file)) {
- $fileInfo[$file] = filemtime($file);
- }
- }
-
- $cache = [
- 'timestamp' => time(),
- 'commands' => $commands,
- 'files' => $fileInfo
- ];
-
- file_put_contents($this->cacheFile, json_encode($cache, JSON_PRETTY_PRINT));
- }
-
- /**
- * Ensure cache directory exists.
- */
- private function ensureCacheDirectory(): void {
- $dir = dirname($this->cacheFile);
-
- if (!is_dir($dir)) {
- mkdir($dir, 0755, true);
- }
- }
-
- /**
- * Check if cache is valid by comparing file modification times.
- *
- * @param array $cache
- * @return bool
- */
- private function isCacheValid(array $cache): bool {
- foreach ($cache['files'] as $file => $cachedMtime) {
- if (!file_exists($file)) {
- return false;
- }
-
- $currentMtime = filemtime($file);
-
- if ($currentMtime > $cachedMtime) {
- return false;
- }
- }
-
- return true;
- }
-}
+cacheFile = $cacheFile;
+ $this->enabled = $enabled;
+ }
+
+ /**
+ * Clear the cache.
+ */
+ public function clear(): void {
+ if (file_exists($this->cacheFile)) {
+ unlink($this->cacheFile);
+ }
+ }
+
+ /**
+ * Get cached commands if valid.
+ *
+ * @return array|null Array of command metadata or null if cache invalid
+ */
+ public function get(): ?array {
+ if (!$this->enabled || !file_exists($this->cacheFile)) {
+ return null;
+ }
+
+ $content = file_get_contents($this->cacheFile);
+
+ if ($content === false) {
+ return null;
+ }
+
+ $cache = json_decode($content, true);
+
+ if (!$cache || !isset($cache['commands'], $cache['files'], $cache['timestamp'])) {
+ return null;
+ }
+
+ // Check if cache is still valid
+ if (!$this->isCacheValid($cache)) {
+ return null;
+ }
+
+ return $cache['commands'];
+ }
+
+ /**
+ * Get cache file path.
+ *
+ * @return string
+ */
+ public function getCacheFile(): string {
+ return $this->cacheFile;
+ }
+
+ /**
+ * Check if caching is enabled.
+ *
+ * @return bool
+ */
+ public function isEnabled(): bool {
+ return $this->enabled;
+ }
+
+ /**
+ * Set cache file path.
+ *
+ * @param string $cacheFile
+ */
+ public function setCacheFile(string $cacheFile): void {
+ $this->cacheFile = $cacheFile;
+ }
+
+ /**
+ * Enable or disable caching.
+ *
+ * @param bool $enabled
+ */
+ public function setEnabled(bool $enabled): void {
+ $this->enabled = $enabled;
+ }
+
+ /**
+ * Store commands in cache.
+ *
+ * @param array $commands Array of command metadata
+ * @param array $files Array of file paths that were scanned
+ */
+ public function store(array $commands, array $files): void {
+ if (!$this->enabled) {
+ return;
+ }
+
+ $this->ensureCacheDirectory();
+
+ $fileInfo = [];
+
+ foreach ($files as $file) {
+ if (file_exists($file)) {
+ $fileInfo[$file] = filemtime($file);
+ }
+ }
+
+ $cache = [
+ 'timestamp' => time(),
+ 'commands' => $commands,
+ 'files' => $fileInfo
+ ];
+
+ file_put_contents($this->cacheFile, json_encode($cache, JSON_PRETTY_PRINT));
+ }
+
+ /**
+ * Ensure cache directory exists.
+ */
+ private function ensureCacheDirectory(): void {
+ $dir = dirname($this->cacheFile);
+
+ if (!is_dir($dir)) {
+ mkdir($dir, 0755, true);
+ }
+ }
+
+ /**
+ * Check if cache is valid by comparing file modification times.
+ *
+ * @param array $cache
+ * @return bool
+ */
+ private function isCacheValid(array $cache): bool {
+ foreach ($cache['files'] as $file => $cachedMtime) {
+ if (!file_exists($file)) {
+ return false;
+ }
+
+ $currentMtime = filemtime($file);
+
+ if ($currentMtime > $cachedMtime) {
+ return false;
+ }
+ }
+
+ return true;
+ }
+}
diff --git a/WebFiori/Cli/Discovery/CommandDiscovery.php b/WebFiori/Cli/Discovery/CommandDiscovery.php
index 2b19f5d..40be55f 100644
--- a/WebFiori/Cli/Discovery/CommandDiscovery.php
+++ b/WebFiori/Cli/Discovery/CommandDiscovery.php
@@ -1,315 +1,315 @@
-cache = $cache ?? new CommandCache();
- }
-
- /**
- * Add a directory path to search for commands.
- *
- * @param string $path Directory path to search
- * @return self
- */
- public function addSearchPath(string $path): self {
- $realPath = realpath($path);
-
- if ($realPath === false) {
- throw new CommandDiscoveryException("Search path does not exist: {$path}");
- }
-
- if (!in_array($realPath, $this->searchPaths)) {
- $this->searchPaths[] = $realPath;
- }
-
- return $this;
- }
-
- /**
- * Add multiple search paths.
- *
- * @param array $paths Array of directory paths
- * @return self
- */
- public function addSearchPaths(array $paths): self {
- foreach ($paths as $path) {
- $this->addSearchPath($path);
- }
-
- return $this;
- }
-
- /**
- * Discover commands from configured search paths.
- *
- * @return array Array of Command instances
- * @throws CommandDiscoveryException If strict mode is enabled and errors occur
- */
- public function discover(): array {
- $this->errors = [];
-
- // Try to get from cache first
- $cachedCommands = $this->cache->get();
-
- if ($cachedCommands !== null) {
- return $this->instantiateCommands($cachedCommands);
- }
-
- // Discover commands
- $commandMetadata = [];
- $scannedFiles = [];
-
- foreach ($this->searchPaths as $path) {
- $files = $this->scanDirectory($path);
- $scannedFiles = array_merge($scannedFiles, $files);
-
- foreach ($files as $file) {
- try {
- $className = $this->extractClassName($file);
-
- if ($className && $this->isValidCommand($className)) {
- $metadata = CommandMetadata::extract($className);
- $commandMetadata[] = $metadata;
- }
- } catch (\Exception $e) {
- $this->errors[] = "Failed to process {$file}: ".$e->getMessage();
- }
- }
- }
-
- // Handle errors
- if (!empty($this->errors) && $this->strictMode) {
- throw CommandDiscoveryException::fromErrors($this->errors);
- }
-
- // Cache the results
- $this->cache->store($commandMetadata, $scannedFiles);
-
- return $this->instantiateCommands($commandMetadata);
- }
-
- /**
- * Add a pattern to exclude files/directories.
- *
- * @param string $pattern Glob pattern to exclude
- * @return self
- */
- public function excludePattern(string $pattern): self {
- if (!in_array($pattern, $this->excludePatterns)) {
- $this->excludePatterns[] = $pattern;
- }
-
- return $this;
- }
-
- /**
- * Add multiple exclude patterns.
- *
- * @param array $patterns Array of glob patterns
- * @return self
- */
- public function excludePatterns(array $patterns): self {
- foreach ($patterns as $pattern) {
- $this->excludePattern($pattern);
- }
-
- return $this;
- }
-
- /**
- * Get the cache instance.
- *
- * @return CommandCache
- */
- public function getCache(): CommandCache {
- return $this->cache;
- }
-
- /**
- * Get discovery errors from last discovery attempt.
- *
- * @return array
- */
- public function getErrors(): array {
- return $this->errors;
- }
-
- /**
- * Enable or disable strict mode.
- * In strict mode, any discovery error will throw an exception.
- *
- * @param bool $strict
- * @return self
- */
- public function setStrictMode(bool $strict): self {
- $this->strictMode = $strict;
-
- return $this;
- }
-
- /**
- * Extract class name from PHP file.
- *
- * @param string $filePath
- * @return string|null
- */
- private function extractClassName(string $filePath): ?string {
- $content = file_get_contents($filePath);
-
- if ($content === false) {
- return null;
- }
-
- // Extract namespace
- $namespace = null;
-
- if (preg_match('/namespace\s+([^;]+);/', $content, $matches)) {
- $namespace = trim($matches[1]);
- }
-
- // Extract class name
- $className = null;
-
- if (preg_match('/class\s+(\w+)/', $content, $matches)) {
- $className = $matches[1];
- }
-
- if (!$className) {
- return null;
- }
-
- return $namespace ? $namespace.'\\'.$className : $className;
- }
-
- /**
- * Instantiate commands from metadata.
- *
- * @param array $commandMetadata
- * @return array Array of Command instances
- */
- private function instantiateCommands(array $commandMetadata): array {
- $commands = [];
-
- foreach ($commandMetadata as $metadata) {
- try {
- $className = $metadata['className'];
-
- if (class_exists($className)) {
- // Check if class implements AutoDiscoverable before instantiating
- if (is_subclass_of($className, AutoDiscoverable::class)) {
- if (!$className::shouldAutoRegister()) {
- continue; // Skip this command
- }
- }
-
- $commands[] = new $className();
- }
- } catch (\Exception $e) {
- $this->errors[] = "Failed to instantiate {$metadata['className']}: ".$e->getMessage();
-
- if ($this->strictMode) {
- throw new CommandDiscoveryException("Failed to instantiate {$metadata['className']}: ".$e->getMessage());
- }
- }
- }
-
- return $commands;
- }
-
- /**
- * Check if class is a valid command.
- *
- * @param string $className
- * @return bool
- */
- private function isValidCommand(string $className): bool {
- try {
- if (!class_exists($className)) {
- return false;
- }
-
- $reflection = new ReflectionClass($className);
-
- return $reflection->isSubclassOf(Command::class)
- && !$reflection->isAbstract()
- && !$reflection->isInterface()
- && !$reflection->isTrait();
- } catch (\Exception $e) {
- return false;
- }
- }
-
- /**
- * Scan directory for PHP files.
- *
- * @param string $directory
- * @return array Array of file paths
- */
- private function scanDirectory(string $directory): array {
- $files = [];
-
- if (!is_dir($directory)) {
- return $files;
- }
-
- $iterator = new RecursiveIteratorIterator(
- new RecursiveDirectoryIterator($directory, RecursiveDirectoryIterator::SKIP_DOTS)
- );
-
- foreach ($iterator as $file) {
- if ($file->getExtension() !== 'php') {
- continue;
- }
-
- $filePath = $file->getRealPath();
-
- if ($this->shouldExcludeFile($filePath)) {
- continue;
- }
-
- $files[] = $filePath;
- }
-
- return $files;
- }
-
- /**
- * Check if file should be excluded based on patterns.
- *
- * @param string $filePath
- * @return bool
- */
- private function shouldExcludeFile(string $filePath): bool {
- foreach ($this->excludePatterns as $pattern) {
- if (fnmatch($pattern, $filePath) || fnmatch($pattern, basename($filePath))) {
- return true;
- }
- }
-
- return false;
- }
-}
+cache = $cache ?? new CommandCache();
+ }
+
+ /**
+ * Add a directory path to search for commands.
+ *
+ * @param string $path Directory path to search
+ * @return self
+ */
+ public function addSearchPath(string $path): self {
+ $realPath = realpath($path);
+
+ if ($realPath === false) {
+ throw new CommandDiscoveryException("Search path does not exist: {$path}");
+ }
+
+ if (!in_array($realPath, $this->searchPaths)) {
+ $this->searchPaths[] = $realPath;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Add multiple search paths.
+ *
+ * @param array $paths Array of directory paths
+ * @return self
+ */
+ public function addSearchPaths(array $paths): self {
+ foreach ($paths as $path) {
+ $this->addSearchPath($path);
+ }
+
+ return $this;
+ }
+
+ /**
+ * Discover commands from configured search paths.
+ *
+ * @return array Array of Command instances
+ * @throws CommandDiscoveryException If strict mode is enabled and errors occur
+ */
+ public function discover(): array {
+ $this->errors = [];
+
+ // Try to get from cache first
+ $cachedCommands = $this->cache->get();
+
+ if ($cachedCommands !== null) {
+ return $this->instantiateCommands($cachedCommands);
+ }
+
+ // Discover commands
+ $commandMetadata = [];
+ $scannedFiles = [];
+
+ foreach ($this->searchPaths as $path) {
+ $files = $this->scanDirectory($path);
+ $scannedFiles = array_merge($scannedFiles, $files);
+
+ foreach ($files as $file) {
+ try {
+ $className = $this->extractClassName($file);
+
+ if ($className && $this->isValidCommand($className)) {
+ $metadata = CommandMetadata::extract($className);
+ $commandMetadata[] = $metadata;
+ }
+ } catch (\Exception $e) {
+ $this->errors[] = "Failed to process {$file}: ".$e->getMessage();
+ }
+ }
+ }
+
+ // Handle errors
+ if (!empty($this->errors) && $this->strictMode) {
+ throw CommandDiscoveryException::fromErrors($this->errors);
+ }
+
+ // Cache the results
+ $this->cache->store($commandMetadata, $scannedFiles);
+
+ return $this->instantiateCommands($commandMetadata);
+ }
+
+ /**
+ * Add a pattern to exclude files/directories.
+ *
+ * @param string $pattern Glob pattern to exclude
+ * @return self
+ */
+ public function excludePattern(string $pattern): self {
+ if (!in_array($pattern, $this->excludePatterns)) {
+ $this->excludePatterns[] = $pattern;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Add multiple exclude patterns.
+ *
+ * @param array $patterns Array of glob patterns
+ * @return self
+ */
+ public function excludePatterns(array $patterns): self {
+ foreach ($patterns as $pattern) {
+ $this->excludePattern($pattern);
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get the cache instance.
+ *
+ * @return CommandCache
+ */
+ public function getCache(): CommandCache {
+ return $this->cache;
+ }
+
+ /**
+ * Get discovery errors from last discovery attempt.
+ *
+ * @return array
+ */
+ public function getErrors(): array {
+ return $this->errors;
+ }
+
+ /**
+ * Enable or disable strict mode.
+ * In strict mode, any discovery error will throw an exception.
+ *
+ * @param bool $strict
+ * @return self
+ */
+ public function setStrictMode(bool $strict): self {
+ $this->strictMode = $strict;
+
+ return $this;
+ }
+
+ /**
+ * Extract class name from PHP file.
+ *
+ * @param string $filePath
+ * @return string|null
+ */
+ private function extractClassName(string $filePath): ?string {
+ $content = file_get_contents($filePath);
+
+ if ($content === false) {
+ return null;
+ }
+
+ // Extract namespace
+ $namespace = null;
+
+ if (preg_match('/namespace\s+([^;]+);/', $content, $matches)) {
+ $namespace = trim($matches[1]);
+ }
+
+ // Extract class name
+ $className = null;
+
+ if (preg_match('/class\s+(\w+)/', $content, $matches)) {
+ $className = $matches[1];
+ }
+
+ if (!$className) {
+ return null;
+ }
+
+ return $namespace ? $namespace.'\\'.$className : $className;
+ }
+
+ /**
+ * Instantiate commands from metadata.
+ *
+ * @param array $commandMetadata
+ * @return array Array of Command instances
+ */
+ private function instantiateCommands(array $commandMetadata): array {
+ $commands = [];
+
+ foreach ($commandMetadata as $metadata) {
+ try {
+ $className = $metadata['className'];
+
+ if (class_exists($className)) {
+ // Check if class implements AutoDiscoverable before instantiating
+ if (is_subclass_of($className, AutoDiscoverable::class)) {
+ if (!$className::shouldAutoRegister()) {
+ continue; // Skip this command
+ }
+ }
+
+ $commands[] = new $className();
+ }
+ } catch (\Exception $e) {
+ $this->errors[] = "Failed to instantiate {$metadata['className']}: ".$e->getMessage();
+
+ if ($this->strictMode) {
+ throw new CommandDiscoveryException("Failed to instantiate {$metadata['className']}: ".$e->getMessage());
+ }
+ }
+ }
+
+ return $commands;
+ }
+
+ /**
+ * Check if class is a valid command.
+ *
+ * @param string $className
+ * @return bool
+ */
+ private function isValidCommand(string $className): bool {
+ try {
+ if (!class_exists($className)) {
+ return false;
+ }
+
+ $reflection = new ReflectionClass($className);
+
+ return $reflection->isSubclassOf(Command::class)
+ && !$reflection->isAbstract()
+ && !$reflection->isInterface()
+ && !$reflection->isTrait();
+ } catch (\Exception $e) {
+ return false;
+ }
+ }
+
+ /**
+ * Scan directory for PHP files.
+ *
+ * @param string $directory
+ * @return array Array of file paths
+ */
+ private function scanDirectory(string $directory): array {
+ $files = [];
+
+ if (!is_dir($directory)) {
+ return $files;
+ }
+
+ $iterator = new RecursiveIteratorIterator(
+ new RecursiveDirectoryIterator($directory, RecursiveDirectoryIterator::SKIP_DOTS)
+ );
+
+ foreach ($iterator as $file) {
+ if ($file->getExtension() !== 'php') {
+ continue;
+ }
+
+ $filePath = $file->getRealPath();
+
+ if ($this->shouldExcludeFile($filePath)) {
+ continue;
+ }
+
+ $files[] = $filePath;
+ }
+
+ return $files;
+ }
+
+ /**
+ * Check if file should be excluded based on patterns.
+ *
+ * @param string $filePath
+ * @return bool
+ */
+ private function shouldExcludeFile(string $filePath): bool {
+ foreach ($this->excludePatterns as $pattern) {
+ if (fnmatch($pattern, $filePath) || fnmatch($pattern, basename($filePath))) {
+ return true;
+ }
+ }
+
+ return false;
+ }
+}
diff --git a/WebFiori/Cli/Discovery/CommandMetadata.php b/WebFiori/Cli/Discovery/CommandMetadata.php
index 38660af..9f6a778 100644
--- a/WebFiori/Cli/Discovery/CommandMetadata.php
+++ b/WebFiori/Cli/Discovery/CommandMetadata.php
@@ -1,180 +1,180 @@
-isSubclassOf(Command::class)) {
- throw new CommandDiscoveryException("Class {$className} is not a Command");
- }
-
- if ($reflection->isAbstract()) {
- throw new CommandDiscoveryException("Class {$className} is abstract");
- }
-
- return [
- 'className' => $className,
- 'name' => self::extractCommandName($reflection),
- 'description' => self::extractDescription($reflection),
- 'group' => self::extractGroup($reflection),
- 'aliases' => self::extractAliases($reflection),
- 'hidden' => self::isHidden($reflection),
- 'file' => $reflection->getFileName()
- ];
- }
-
- /**
- * Extract aliases from class.
- *
- * @param ReflectionClass $class
- * @return array
- */
- private static function extractAliases(ReflectionClass $class): array {
- $docComment = $class->getDocComment();
-
- if (!$docComment) {
- return [];
- }
-
- if (preg_match('/@Command\s*\([^)]*aliases\s*=\s*\[([^\]]+)\]/', $docComment, $matches)) {
- $aliasesStr = $matches[1];
- $aliases = [];
-
- if (preg_match_all('/["\']([^"\']+)["\']/', $aliasesStr, $aliasMatches)) {
- $aliases = $aliasMatches[1];
- }
-
- return $aliases;
- }
-
- return [];
- }
-
- /**
- * Extract command name from class.
- *
- * @param ReflectionClass $class
- * @return string
- */
- private static function extractCommandName(ReflectionClass $class): string {
- // Try to get name from @Command annotation
- $docComment = $class->getDocComment();
-
- if ($docComment && preg_match('/@Command\s*\(\s*name\s*=\s*["\']([^"\']+)["\']/', $docComment, $matches)) {
- return $matches[1];
- }
-
- // Fall back to class name convention
- $className = $class->getShortName();
- $name = preg_replace('/Command$/', '', $className);
-
- // Convert CamelCase to kebab-case
- return strtolower(preg_replace('/([a-z])([A-Z])/', '$1-$2', $name));
- }
-
- /**
- * Extract description from class docblock.
- *
- * @param ReflectionClass $class
- * @return string
- */
- private static function extractDescription(ReflectionClass $class): string {
- $docComment = $class->getDocComment();
-
- if (!$docComment) {
- return '';
- }
-
- // Try @Command annotation first
- if (preg_match('/@Command\s*\([^)]*description\s*=\s*["\']([^"\']+)["\']/', $docComment, $matches)) {
- return $matches[1];
- }
-
- // Fall back to first line of docblock
- $lines = explode("\n", $docComment);
-
- foreach ($lines as $line) {
- $line = trim($line, " \t\n\r\0\x0B/*");
-
- if (!empty($line) && !str_starts_with($line, '@')) {
- return $line;
- }
- }
-
- return '';
- }
-
- /**
- * Extract group/category from class.
- *
- * @param ReflectionClass $class
- * @return string|null
- */
- private static function extractGroup(ReflectionClass $class): ?string {
- $docComment = $class->getDocComment();
-
- if ($docComment && preg_match('/@Command\s*\([^)]*group\s*=\s*["\']([^"\']+)["\']/', $docComment, $matches)) {
- return $matches[1];
- }
-
- // Try to infer from namespace
- $namespace = $class->getNamespaceName();
- $parts = explode('\\', $namespace);
-
- // Look for Commands subdirectory
- $commandsIndex = array_search('Commands', $parts);
-
- if ($commandsIndex !== false && isset($parts[$commandsIndex + 1])) {
- return strtolower($parts[$commandsIndex + 1]);
- }
-
- return null;
- }
-
- /**
- * Check if command should be hidden.
- *
- * @param ReflectionClass $class
- * @return bool
- */
- private static function isHidden(ReflectionClass $class): bool {
- $docComment = $class->getDocComment();
-
- if (!$docComment) {
- return false;
- }
-
- // Check for @Hidden annotation
- if (strpos($docComment, '@Hidden') !== false) {
- return true;
- }
-
- // Check for @Command(hidden=true)
- if (preg_match('/@Command\s*\([^)]*hidden\s*=\s*true/', $docComment)) {
- return true;
- }
-
- return false;
- }
-}
+isSubclassOf(Command::class)) {
+ throw new CommandDiscoveryException("Class {$className} is not a Command");
+ }
+
+ if ($reflection->isAbstract()) {
+ throw new CommandDiscoveryException("Class {$className} is abstract");
+ }
+
+ return [
+ 'className' => $className,
+ 'name' => self::extractCommandName($reflection),
+ 'description' => self::extractDescription($reflection),
+ 'group' => self::extractGroup($reflection),
+ 'aliases' => self::extractAliases($reflection),
+ 'hidden' => self::isHidden($reflection),
+ 'file' => $reflection->getFileName()
+ ];
+ }
+
+ /**
+ * Extract aliases from class.
+ *
+ * @param ReflectionClass $class
+ * @return array
+ */
+ private static function extractAliases(ReflectionClass $class): array {
+ $docComment = $class->getDocComment();
+
+ if (!$docComment) {
+ return [];
+ }
+
+ if (preg_match('/@Command\s*\([^)]*aliases\s*=\s*\[([^\]]+)\]/', $docComment, $matches)) {
+ $aliasesStr = $matches[1];
+ $aliases = [];
+
+ if (preg_match_all('/["\']([^"\']+)["\']/', $aliasesStr, $aliasMatches)) {
+ $aliases = $aliasMatches[1];
+ }
+
+ return $aliases;
+ }
+
+ return [];
+ }
+
+ /**
+ * Extract command name from class.
+ *
+ * @param ReflectionClass $class
+ * @return string
+ */
+ private static function extractCommandName(ReflectionClass $class): string {
+ // Try to get name from @Command annotation
+ $docComment = $class->getDocComment();
+
+ if ($docComment && preg_match('/@Command\s*\(\s*name\s*=\s*["\']([^"\']+)["\']/', $docComment, $matches)) {
+ return $matches[1];
+ }
+
+ // Fall back to class name convention
+ $className = $class->getShortName();
+ $name = preg_replace('/Command$/', '', $className);
+
+ // Convert CamelCase to kebab-case
+ return strtolower(preg_replace('/([a-z])([A-Z])/', '$1-$2', $name));
+ }
+
+ /**
+ * Extract description from class docblock.
+ *
+ * @param ReflectionClass $class
+ * @return string
+ */
+ private static function extractDescription(ReflectionClass $class): string {
+ $docComment = $class->getDocComment();
+
+ if (!$docComment) {
+ return '';
+ }
+
+ // Try @Command annotation first
+ if (preg_match('/@Command\s*\([^)]*description\s*=\s*["\']([^"\']+)["\']/', $docComment, $matches)) {
+ return $matches[1];
+ }
+
+ // Fall back to first line of docblock
+ $lines = explode("\n", $docComment);
+
+ foreach ($lines as $line) {
+ $line = trim($line, " \t\n\r\0\x0B/*");
+
+ if (!empty($line) && !str_starts_with($line, '@')) {
+ return $line;
+ }
+ }
+
+ return '';
+ }
+
+ /**
+ * Extract group/category from class.
+ *
+ * @param ReflectionClass $class
+ * @return string|null
+ */
+ private static function extractGroup(ReflectionClass $class): ?string {
+ $docComment = $class->getDocComment();
+
+ if ($docComment && preg_match('/@Command\s*\([^)]*group\s*=\s*["\']([^"\']+)["\']/', $docComment, $matches)) {
+ return $matches[1];
+ }
+
+ // Try to infer from namespace
+ $namespace = $class->getNamespaceName();
+ $parts = explode('\\', $namespace);
+
+ // Look for Commands subdirectory
+ $commandsIndex = array_search('Commands', $parts);
+
+ if ($commandsIndex !== false && isset($parts[$commandsIndex + 1])) {
+ return strtolower($parts[$commandsIndex + 1]);
+ }
+
+ return null;
+ }
+
+ /**
+ * Check if command should be hidden.
+ *
+ * @param ReflectionClass $class
+ * @return bool
+ */
+ private static function isHidden(ReflectionClass $class): bool {
+ $docComment = $class->getDocComment();
+
+ if (!$docComment) {
+ return false;
+ }
+
+ // Check for @Hidden annotation
+ if (strpos($docComment, '@Hidden') !== false) {
+ return true;
+ }
+
+ // Check for @Command(hidden=true)
+ if (preg_match('/@Command\s*\([^)]*hidden\s*=\s*true/', $docComment)) {
+ return true;
+ }
+
+ return false;
+ }
+}
diff --git a/WebFiori/Cli/Exceptions/CommandDiscoveryException.php b/WebFiori/Cli/Exceptions/CommandDiscoveryException.php
index b5d0b05..048e41b 100644
--- a/WebFiori/Cli/Exceptions/CommandDiscoveryException.php
+++ b/WebFiori/Cli/Exceptions/CommandDiscoveryException.php
@@ -1,24 +1,24 @@
- 30,
- 'red' => 31,
- 'light-red' => 91,
- 'green' => 32,
- 'light-green' => 92,
- 'yellow' => 33,
- 'light-yellow' => 93,
- 'white' => 97,
- 'gray' => 37,
- 'blue' => 34,
- 'light-blue' => 94
- ];
- /**
- * Formats an output string.
- *
- * This method is used to add colors to the output string or
- * make it bold or underlined. The returned value of this
- * method can be sent to any output stream using the method 'fprintf()'.
- * Note that the support for colors
- * and formatting will depend on the terminal configuration. In addition,
- * if the constant NO_COLOR is defined or is set in the environment, the
- * returned string will be returned without coloring options.
- *
- * @param string $string The string that will be formatted.
- *
- * @param array $formatOptions An associative array of formatting
- * options. Supported options are:
- *
- *
color: The foreground color of the output text. Supported colors
- * are:
- *
- *
white
- *
black
- *
red
- *
light-red
- *
green
- *
light-green
- *
yellow
- *
light-yellow
- *
gray
- *
blue
- *
light-blue
- *
- *
- *
ansi: A boolean. If set to true, the text will
- * be formatted using ANSI escape sequences. If set to false, the input
- * string is returned without change.
- *
bg-color: The background color of the output text. Supported colors
- * are the same as the supported colors by the 'color' option.
- *
bold: A boolean. If set to true, the text will
- * be bold.
- *
underline: A boolean. If set to true, the text will
- * be underlined.
- *
reverse: A boolean. If set to true, the foreground
- * color and background color will be reversed (invert the foreground and background colors).
- *
blink: A boolean. If set to true, the text will
- * blink.
- *
- * @return string The string after applying the formatting to it.
- *
- */
- public static function format(string $string, array $formatOptions = []) : string {
- $validatedOptions = self::validateOutputOptions($formatOptions);
-
- return self::getFormattedOutput($string, $validatedOptions);
- }
- private static function addManner($str, $code) : string {
- if (strlen($str) > 0) {
- return $str.';'.$code;
- }
-
- return $str.$code;
- }
- private static function getCharsManner($options) : string {
- $mannerStr = '';
-
- if (isset($options['ansi']) && $options['ansi'] === false) {
- return $mannerStr;
- }
-
- if ($options['bold']) {
- $mannerStr = self::addManner($mannerStr, 1);
- }
-
- if ($options['underline']) {
- $mannerStr = self::addManner($mannerStr, 4);
- }
-
- if ($options['blink']) {
- $mannerStr = self::addManner($mannerStr, 5);
- }
-
- if ($options['reverse']) {
- $mannerStr = self::addManner($mannerStr, 7);
- }
-
- if (defined('NO_COLOR') || isset($_SERVER['NO_COLOR']) || getenv('NO_COLOR') !== false) {
- //See https://no-color.org/ for more info.
- return $mannerStr;
- }
- $colorsArr = self::COLORS;
-
- if ($options['color'] != 'NO_COLOR' && isset($colorsArr[$options['color']])) {
- $mannerStr = self::addManner($mannerStr, $colorsArr[$options['color']]);
- }
-
- if ($options['bg-color'] != 'NO_COLOR' && isset($colorsArr[$options['bg-color']])) {
- $mannerStr = self::addManner($mannerStr, $colorsArr[$options['bg-color']] + 10);
- }
-
- return $mannerStr;
- }
- private static function getFormattedOutput(string $outputString, array $formatOptions): string {
- $outputManner = self::getCharsManner($formatOptions);
-
- if (strlen($outputManner) != 0) {
- return "\e[".$outputManner."m$outputString\e[0m";
- }
-
- return $outputString;
- }
- private static function validateOutputOptions(array $formatArr): array {
- $noColor = 'NO_COLOR';
-
- if (!isset($formatArr['bold'])) {
- $formatArr['bold'] = false;
- }
-
- if (!isset($formatArr['underline'])) {
- $formatArr['underline'] = false;
- }
-
- if (!isset($formatArr['blink'])) {
- $formatArr['blink'] = false;
- }
-
- if (!isset($formatArr['reverse'])) {
- $formatArr['reverse'] = false;
- }
-
- if (!isset($formatArr['color'])) {
- $formatArr['color'] = $noColor;
- }
-
- if (!isset($formatArr['bg-color'])) {
- $formatArr['bg-color'] = $noColor;
- }
-
- if (!isset($formatArr['ansi'])) {
- $formatArr['ansi'] = false;
- }
-
- return $formatArr;
- }
-}
+ 30,
+ 'red' => 31,
+ 'light-red' => 91,
+ 'green' => 32,
+ 'light-green' => 92,
+ 'yellow' => 33,
+ 'light-yellow' => 93,
+ 'white' => 97,
+ 'gray' => 37,
+ 'blue' => 34,
+ 'light-blue' => 94
+ ];
+ /**
+ * Formats an output string.
+ *
+ * This method is used to add colors to the output string or
+ * make it bold or underlined. The returned value of this
+ * method can be sent to any output stream using the method 'fprintf()'.
+ * Note that the support for colors
+ * and formatting will depend on the terminal configuration. In addition,
+ * if the constant NO_COLOR is defined or is set in the environment, the
+ * returned string will be returned without coloring options.
+ *
+ * @param string $string The string that will be formatted.
+ *
+ * @param array $formatOptions An associative array of formatting
+ * options. Supported options are:
+ *
+ *
color: The foreground color of the output text. Supported colors
+ * are:
+ *
+ *
white
+ *
black
+ *
red
+ *
light-red
+ *
green
+ *
light-green
+ *
yellow
+ *
light-yellow
+ *
gray
+ *
blue
+ *
light-blue
+ *
+ *
+ *
ansi: A boolean. If set to true, the text will
+ * be formatted using ANSI escape sequences. If set to false, the input
+ * string is returned without change.
+ *
bg-color: The background color of the output text. Supported colors
+ * are the same as the supported colors by the 'color' option.
+ *
bold: A boolean. If set to true, the text will
+ * be bold.
+ *
underline: A boolean. If set to true, the text will
+ * be underlined.
+ *
reverse: A boolean. If set to true, the foreground
+ * color and background color will be reversed (invert the foreground and background colors).
+ *
blink: A boolean. If set to true, the text will
+ * blink.
+ *
+ * @return string The string after applying the formatting to it.
+ *
+ */
+ public static function format(string $string, array $formatOptions = []) : string {
+ $validatedOptions = self::validateOutputOptions($formatOptions);
+
+ return self::getFormattedOutput($string, $validatedOptions);
+ }
+ private static function addManner($str, $code) : string {
+ if (strlen($str) > 0) {
+ return $str.';'.$code;
+ }
+
+ return $str.$code;
+ }
+ private static function getCharsManner($options) : string {
+ $mannerStr = '';
+
+ if (isset($options['ansi']) && $options['ansi'] === false) {
+ return $mannerStr;
+ }
+
+ if ($options['bold']) {
+ $mannerStr = self::addManner($mannerStr, 1);
+ }
+
+ if ($options['underline']) {
+ $mannerStr = self::addManner($mannerStr, 4);
+ }
+
+ if ($options['blink']) {
+ $mannerStr = self::addManner($mannerStr, 5);
+ }
+
+ if ($options['reverse']) {
+ $mannerStr = self::addManner($mannerStr, 7);
+ }
+
+ if (defined('NO_COLOR') || isset($_SERVER['NO_COLOR']) || getenv('NO_COLOR') !== false) {
+ //See https://no-color.org/ for more info.
+ return $mannerStr;
+ }
+ $colorsArr = self::COLORS;
+
+ if ($options['color'] != 'NO_COLOR' && isset($colorsArr[$options['color']])) {
+ $mannerStr = self::addManner($mannerStr, $colorsArr[$options['color']]);
+ }
+
+ if ($options['bg-color'] != 'NO_COLOR' && isset($colorsArr[$options['bg-color']])) {
+ $mannerStr = self::addManner($mannerStr, $colorsArr[$options['bg-color']] + 10);
+ }
+
+ return $mannerStr;
+ }
+ private static function getFormattedOutput(string $outputString, array $formatOptions): string {
+ $outputManner = self::getCharsManner($formatOptions);
+
+ if (strlen($outputManner) != 0) {
+ return "\e[".$outputManner."m$outputString\e[0m";
+ }
+
+ return $outputString;
+ }
+ private static function validateOutputOptions(array $formatArr): array {
+ $noColor = 'NO_COLOR';
+
+ if (!isset($formatArr['bold'])) {
+ $formatArr['bold'] = false;
+ }
+
+ if (!isset($formatArr['underline'])) {
+ $formatArr['underline'] = false;
+ }
+
+ if (!isset($formatArr['blink'])) {
+ $formatArr['blink'] = false;
+ }
+
+ if (!isset($formatArr['reverse'])) {
+ $formatArr['reverse'] = false;
+ }
+
+ if (!isset($formatArr['color'])) {
+ $formatArr['color'] = $noColor;
+ }
+
+ if (!isset($formatArr['bg-color'])) {
+ $formatArr['bg-color'] = $noColor;
+ }
+
+ if (!isset($formatArr['ansi'])) {
+ $formatArr['ansi'] = false;
+ }
+
+ return $formatArr;
+ }
+}
diff --git a/WebFiori/Cli/InputValidator.php b/WebFiori/Cli/InputValidator.php
index 9d66fd6..b9dd685 100644
--- a/WebFiori/Cli/InputValidator.php
+++ b/WebFiori/Cli/InputValidator.php
@@ -1,211 +1,230 @@
-callback = $func;
- $this->params = $callbackParams;
- $trimmed = trim($errMessage);
-
- if (strlen($trimmed) != 0) {
- $this->errPrompt = $trimmed;
- } else {
- $this->errPrompt = 'Invalid input is given. Try again.';
- }
- }
- /**
- * Returns the string that should be shown to the user if the validation
- * fails.
- *
- * @return string The string that should be shown to the user if the validation
- * fails. Default value is 'Invalid input is given. Try again.'.
- */
- public function getErrPrompt() : string {
- return $this->errPrompt;
- }
- /**
- * Checks if a string represents a valid class or not.
- *
- * Note that the method will attempt to create an instance of the given
- * class to check validity.
- *
- * @param string $classNs The namespace of the class.
- *
- * @param array $args An optional array that holds arguments that will be passed to
- * class constructor.
- *
- * @return bool If the class exist and loaded, the method will return
- * true. Other than that, false is returned.
+callback = $func;
+ $this->params = $callbackParams;
+ $trimmed = trim($errMessage);
+
+ if (strlen($trimmed) != 0) {
+ $this->errPrompt = $trimmed;
+ } else {
+ $this->errPrompt = 'Invalid input is given. Try again.';
+ }
+ }
+ /**
+ * Returns the string that should be shown to the user if the validation
+ * fails.
+ *
+ * @return string The string that should be shown to the user if the validation
+ * fails. Default value is 'Invalid input is given. Try again.'.
+ */
+ public function getErrPrompt() : string {
+ return $this->errPrompt;
+ }
+ /**
+ * Sets the maximum number of retry attempts for validation.
+ *
+ * @param int $max Maximum number of retries. Use -1 for unlimited retries.
+ *
+ * @return InputValidator Returns the same instance for method chaining.
*/
- public static function isClass(string $classNs, array $args = []) : bool {
- try {
- if (class_exists($classNs)) {
- $reflection = new ReflectionClass($classNs);
- $clazz = $reflection->newInstanceArgs($args);
-
- return gettype($clazz) == 'object';
- }
- } catch (Throwable $ex) {
- return false;
- }
-
- return false;
+ public function setMaxRetries(int $max) : InputValidator {
+ $this->maxRetries = $max;
+ return $this;
}
/**
- * Checks if given string represents floating number or not.
- *
- * @param string $val The string that will be validated.
+ * Gets the maximum number of retry attempts.
*
- * @return bool If the given string represents a floating number, true is returned.
- * False otherwise.
+ * @return int Maximum number of retries. -1 means unlimited.
*/
- public static function isFloat(string $val) : bool {
- $len = strlen($val);
-
- if ($len == 0) {
- return false;
- }
-
- $split = explode('.', $val);
-
- if (count($split) > 2) {
- return false;
- }
- $isFloat = true;
-
- foreach ($split as $sub) {
- $isFloat = $isFloat && self::isInt($sub);
- }
-
- return $isFloat;
+ public function getMaxRetries() : int {
+ return $this->maxRetries;
}
/**
- * Checks if given string represents an integer value or not.
- *
- * This method will basically compare all the characters of the string
- * if they are in the range '0' to '9' inclusive.
- *
- * @param string $val The string that will be validated.
- *
- * @return bool If the given string represents an integer, true is returned.
- * False otherwise.
- */
- public static function isInt(string $val) : bool {
- $len = strlen($val);
-
- if ($len == 0) {
- return false;
- }
- $isNum = true;
-
- for ($x = 0 ; $x < $len ; $x++) {
- $char = $val[$x];
- $isNum = $char >= '0' && $char <= '9';
-
- if (!$isNum) {
- break;
- }
- }
-
- return $isNum;
- }
- /**
- * Execute the validation function.
- *
- * @param string $input The input that will be validated. Note that if
- * the value of the input is changed on the validation callback, it will
- * affect original variable as the passed value is a reference.
- *
- * @return bool The return value of this method will depend on the implementation
- * of the validation callback. If it returns true, the method will
- * return true. If it returns false, the method will return false.
- */
- public function isValid(string &$input) : bool {
- return call_user_func_array($this->callback, array_merge([&$input], $this->params));
- }
- /**
- * Checks if a given string represents a valid class name or not.
- *
- * @param string $name A string to check such as 'My_Super_Class'.
- *
- * @return bool If the given string is a valid class name, the method
- * will return true. False otherwise.
- */
- public static function isValidClassName(string $name) : bool {
- $len = strlen($name);
-
- if ($len > 0) {
- return self::validateNsOrClassName($len, $name);
- }
-
- return false;
- }
- /**
- * Checks if provided string represents a valid namespace or not.
- *
- * @param string $ns A string to be validated.
- *
- * @return bool If the provided string represents a valid namespace, the
- * method will return true. False if it does not represent a valid namespace.
- */
- public static function isValidNamespace(string $ns) : bool {
- if ($ns == '\\') {
- return true;
- }
-
- if (strlen($ns) == 0) {
- return false;
- }
- $split = explode('\\', $ns);
-
- foreach ($split as $subNs) {
- $len = strlen($subNs);
-
- if (!self::validateNsOrClassName($len, $subNs)) {
- return false;
- }
- }
-
- return true;
- }
- private static function validateNsOrClassName(int $len, string $name) : bool {
- for ($x = 0 ; $x < $len ; $x++) {
- $char = $name[$x];
-
- if ($x == 0 && $char >= '0' && $char <= '9') {
- return false;
- }
-
- if (!(($char <= 'Z' && $char >= 'A') || ($char <= 'z' && $char >= 'a') || ($char >= '0' && $char <= '9') || $char == '_')) {
- return false;
- }
- }
-
- return true;
- }
-}
+ * Checks if a string represents a valid class or not.
+ *
+ * Note that the method will attempt to create an instance of the given
+ * class to check validity.
+ *
+ * @param string $classNs The namespace of the class.
+ *
+ * @param array $args An optional array that holds arguments that will be passed to
+ * class constructor.
+ *
+ * @return bool If the class exist and loaded, the method will return
+ * true. Other than that, false is returned.
+ */
+ public static function isClass(string $classNs, array $args = []) : bool {
+ try {
+ if (class_exists($classNs)) {
+ $reflection = new ReflectionClass($classNs);
+ $clazz = $reflection->newInstanceArgs($args);
+
+ return gettype($clazz) == 'object';
+ }
+ } catch (Throwable $ex) {
+ return false;
+ }
+
+ return false;
+ }
+ /**
+ * Checks if given string represents floating number or not.
+ *
+ * @param string $val The string that will be validated.
+ *
+ * @return bool If the given string represents a floating number, true is returned.
+ * False otherwise.
+ */
+ public static function isFloat(string $val) : bool {
+ $len = strlen($val);
+
+ if ($len == 0) {
+ return false;
+ }
+
+ $split = explode('.', $val);
+
+ if (count($split) > 2) {
+ return false;
+ }
+ $isFloat = true;
+
+ foreach ($split as $sub) {
+ $isFloat = $isFloat && self::isInt($sub);
+ }
+
+ return $isFloat;
+ }
+ /**
+ * Checks if given string represents an integer value or not.
+ *
+ * This method will basically compare all the characters of the string
+ * if they are in the range '0' to '9' inclusive.
+ *
+ * @param string $val The string that will be validated.
+ *
+ * @return bool If the given string represents an integer, true is returned.
+ * False otherwise.
+ */
+ public static function isInt(string $val) : bool {
+ $len = strlen($val);
+
+ if ($len == 0) {
+ return false;
+ }
+ $isNum = true;
+
+ for ($x = 0 ; $x < $len ; $x++) {
+ $char = $val[$x];
+ $isNum = $char >= '0' && $char <= '9';
+
+ if (!$isNum) {
+ break;
+ }
+ }
+
+ return $isNum;
+ }
+ /**
+ * Execute the validation function.
+ *
+ * @param string $input The input that will be validated. Note that if
+ * the value of the input is changed on the validation callback, it will
+ * affect original variable as the passed value is a reference.
+ *
+ * @return bool The return value of this method will depend on the implementation
+ * of the validation callback. If it returns true, the method will
+ * return true. If it returns false, the method will return false.
+ */
+ public function isValid(string &$input) : bool {
+ return call_user_func_array($this->callback, array_merge([&$input], $this->params));
+ }
+ /**
+ * Checks if a given string represents a valid class name or not.
+ *
+ * @param string $name A string to check such as 'My_Super_Class'.
+ *
+ * @return bool If the given string is a valid class name, the method
+ * will return true. False otherwise.
+ */
+ public static function isValidClassName(string $name) : bool {
+ $len = strlen($name);
+
+ if ($len > 0) {
+ return self::validateNsOrClassName($len, $name);
+ }
+
+ return false;
+ }
+ /**
+ * Checks if provided string represents a valid namespace or not.
+ *
+ * @param string $ns A string to be validated.
+ *
+ * @return bool If the provided string represents a valid namespace, the
+ * method will return true. False if it does not represent a valid namespace.
+ */
+ public static function isValidNamespace(string $ns) : bool {
+ if ($ns == '\\') {
+ return true;
+ }
+
+ if (strlen($ns) == 0) {
+ return false;
+ }
+ $split = explode('\\', $ns);
+
+ foreach ($split as $subNs) {
+ $len = strlen($subNs);
+
+ if (!self::validateNsOrClassName($len, $subNs)) {
+ return false;
+ }
+ }
+
+ return true;
+ }
+ private static function validateNsOrClassName(int $len, string $name) : bool {
+ for ($x = 0 ; $x < $len ; $x++) {
+ $char = $name[$x];
+
+ if ($x == 0 && $char >= '0' && $char <= '9') {
+ return false;
+ }
+
+ if (!(($char <= 'Z' && $char >= 'A') || ($char <= 'z' && $char >= 'a') || ($char >= '0' && $char <= '9') || $char == '_')) {
+ return false;
+ }
+ }
+
+ return true;
+ }
+}
diff --git a/WebFiori/Cli/KeysMap.php b/WebFiori/Cli/KeysMap.php
index 7f9fbf1..6da1750 100644
--- a/WebFiori/Cli/KeysMap.php
+++ b/WebFiori/Cli/KeysMap.php
@@ -1,187 +1,187 @@
- 'UP',
- "\033[B" => 'DOWN',
- "\033[C" => 'RIGHT',
- "\033[D" => 'LEFT',
- "\n" => 'LF',
- "\r" => 'CR',
- " " => 'SPACE',
- "\010" => 'BACKSPACE',
- "\177" => 'BACKSPACE',
- "\t" => 'TAP',
- "\e" => 'ESC'
- ];
- /**
- * Maps a control character to a string that represents its value.
- *
- * @param string $ch The control character such as '\n'.
- *
- * @return string If the given character maps to a control character, its
- * value is returned as string. For example, if the character is '\n',
- * the method will return the value "LF" which stands for "line feed". If the
- * character does not map to any control character, the same character is
- * returned. Possible return values are:
- *
- *
TAP for control character \t
- *
ESC for control character \e
- *
BACKSPACE for control character \010 and \177
- *
SPACE for control character 'space'
- *
CR for control character \r
- *
LF for control character \n
- *
UP for control character \033[A
- *
DOWN for control character \033[B
- *
RIGHT for control character \033[C
- *
LEFT for control character \033[D
- *
- *
- */
- public static function map($ch) : string {
- // Handle end-of-stream case for any input type
- if ($ch === false || $ch === null) {
- return "\n"; // Treat as Enter key
- }
-
- // Ensure we have a string
- if (!is_string($ch)) {
- $ch = (string)$ch;
- }
-
- $keyMap = self::KEY_MAP;
-
- if (isset($keyMap[$ch])) {
- return $keyMap[$ch];
- }
-
- return $ch;
- }
- /**
- * Reads a string of bytes from specific input stream.
- *
- * This method is used to read specific number of bytes from any
- * input stream.
- *
- * @return string The method will return the string which was given as input
- * in the stream.
- *
- */
- public static function read(InputStream $stream, $bytes = 1) : string {
- $input = '';
- $len = strlen($input);
-
- while ($len < $bytes) {
- $char = self::readAndTranslate($stream);
- self::appendChar($char, $input);
- $len = strlen($input);
- }
-
- return $input;
- }
-
- /**
- * Reads one character from specific input stream and check if the character
- * maps to any control character.
- *
- * @param InputStream $stream
- *
- * @return string If the character maps to control character, a value from
- * the array InputTranslator::KEY_MAP is returned. Other than that,
- * the character itself will be returned.
- */
- public static function readAndTranslate(InputStream $stream) : string {
- $keypress = $stream->read();
-
- // Handle EOF
- if ($keypress === '') {
- return '';
- }
-
- // Handle escape sequences (multi-byte) - kept for future use
- if ($keypress === "\033") {
- try {
- // Read the next character to see if it's part of an escape sequence
- $next = $stream->read();
- if ($next === '[') {
- // Read the final character of the sequence
- $final = $stream->read();
- $sequence = $keypress . $next . $final;
- return self::map($sequence);
- } else {
- // Not a complete escape sequence, return ESC
- return self::map($keypress);
- }
- } catch (\Exception $e) {
- // If we can't read more bytes, just return ESC
- return self::map($keypress);
- }
- }
-
- return self::map($keypress);
- }
- /**
- * Reads one line from specific input stream.
- *
- * The method will continue to read from the stream till it finds end of
- * line character "\n".
- *
- * @param InputStream $stream
- *
- * @return string The method will return the string which was taken from
- * the stream. Note that end of line character will be included in the
- * final input.
- *
- */
- public static function readLine(InputStream $stream) : string {
- $input = '';
- $char = '';
-
- while ($char != 'LF') {
- $char = self::readAndTranslate($stream);
-
- // Handle EOF - if we get an empty string, we've reached end of file
- if ($char === '') {
- break;
- }
-
- self::appendChar($char, $input);
- }
-
- return $input;
- }
- private static function appendChar($ch, &$input) {
- if ($ch == 'BACKSPACE' && strlen($input) > 0) {
- $input = substr($input, 0, strlen($input) - 1);
- } else if ($ch == 'ESC') {
- // Ignore ESC key
- } else if ($ch == "CR") {
- // Do nothing - don't add CR to input
- } else if ($ch == "LF") {
- // Do nothing - don't add LF to input (readLine should not include line ending)
- } else if ($ch == 'DOWN' || $ch == 'UP' || $ch == 'LEFT' || $ch == 'RIGHT') {
- // Ignore arrow keys - kept for future navigation features
- } else {
- if ($ch == 'SPACE') {
- $input .= ' ';
- } else {
- $input .= $ch;
- }
- }
- }
-}
+ 'UP',
+ "\033[B" => 'DOWN',
+ "\033[C" => 'RIGHT',
+ "\033[D" => 'LEFT',
+ "\n" => 'LF',
+ "\r" => 'CR',
+ " " => 'SPACE',
+ "\010" => 'BACKSPACE',
+ "\177" => 'BACKSPACE',
+ "\t" => 'TAP',
+ "\e" => 'ESC'
+ ];
+ /**
+ * Maps a control character to a string that represents its value.
+ *
+ * @param string $ch The control character such as '\n'.
+ *
+ * @return string If the given character maps to a control character, its
+ * value is returned as string. For example, if the character is '\n',
+ * the method will return the value "LF" which stands for "line feed". If the
+ * character does not map to any control character, the same character is
+ * returned. Possible return values are:
+ *
+ *
TAP for control character \t
+ *
ESC for control character \e
+ *
BACKSPACE for control character \010 and \177
+ *
SPACE for control character 'space'
+ *
CR for control character \r
+ *
LF for control character \n
+ *
UP for control character \033[A
+ *
DOWN for control character \033[B
+ *
RIGHT for control character \033[C
+ *
LEFT for control character \033[D
+ *
+ *
+ */
+ public static function map($ch) : string {
+ // Handle end-of-stream case for any input type
+ if ($ch === false || $ch === null) {
+ return "\n"; // Treat as Enter key
+ }
+
+ // Ensure we have a string
+ if (!is_string($ch)) {
+ $ch = (string)$ch;
+ }
+
+ $keyMap = self::KEY_MAP;
+
+ if (isset($keyMap[$ch])) {
+ return $keyMap[$ch];
+ }
+
+ return $ch;
+ }
+ /**
+ * Reads a string of bytes from specific input stream.
+ *
+ * This method is used to read specific number of bytes from any
+ * input stream.
+ *
+ * @return string The method will return the string which was given as input
+ * in the stream.
+ *
+ */
+ public static function read(InputStream $stream, $bytes = 1) : string {
+ $input = '';
+ $len = strlen($input);
+
+ while ($len < $bytes) {
+ $char = self::readAndTranslate($stream);
+ self::appendChar($char, $input);
+ $len = strlen($input);
+ }
+
+ return $input;
+ }
+
+ /**
+ * Reads one character from specific input stream and check if the character
+ * maps to any control character.
+ *
+ * @param InputStream $stream
+ *
+ * @return string If the character maps to control character, a value from
+ * the array InputTranslator::KEY_MAP is returned. Other than that,
+ * the character itself will be returned.
+ */
+ public static function readAndTranslate(InputStream $stream) : string {
+ $keypress = $stream->read();
+
+ // Handle EOF
+ if ($keypress === '') {
+ return '';
+ }
+
+ // Handle escape sequences (multi-byte) - kept for future use
+ if ($keypress === "\033") {
+ try {
+ // Read the next character to see if it's part of an escape sequence
+ $next = $stream->read();
+ if ($next === '[') {
+ // Read the final character of the sequence
+ $final = $stream->read();
+ $sequence = $keypress . $next . $final;
+ return self::map($sequence);
+ } else {
+ // Not a complete escape sequence, return ESC
+ return self::map($keypress);
+ }
+ } catch (\Exception $e) {
+ // If we can't read more bytes, just return ESC
+ return self::map($keypress);
+ }
+ }
+
+ return self::map($keypress);
+ }
+ /**
+ * Reads one line from specific input stream.
+ *
+ * The method will continue to read from the stream till it finds end of
+ * line character "\n".
+ *
+ * @param InputStream $stream
+ *
+ * @return string The method will return the string which was taken from
+ * the stream. Note that end of line character will be included in the
+ * final input.
+ *
+ */
+ public static function readLine(InputStream $stream) : string {
+ $input = '';
+ $char = '';
+
+ while ($char != 'LF') {
+ $char = self::readAndTranslate($stream);
+
+ // Handle EOF - if we get an empty string, we've reached end of file
+ if ($char === '') {
+ break;
+ }
+
+ self::appendChar($char, $input);
+ }
+
+ return $input;
+ }
+ private static function appendChar($ch, &$input) {
+ if ($ch == 'BACKSPACE' && strlen($input) > 0) {
+ $input = substr($input, 0, strlen($input) - 1);
+ } else if ($ch == 'ESC') {
+ // Ignore ESC key
+ } else if ($ch == "CR") {
+ // Do nothing - don't add CR to input
+ } else if ($ch == "LF") {
+ // Do nothing - don't add LF to input (readLine should not include line ending)
+ } else if ($ch == 'DOWN' || $ch == 'UP' || $ch == 'LEFT' || $ch == 'RIGHT') {
+ // Ignore arrow keys - kept for future navigation features
+ } else {
+ if ($ch == 'SPACE') {
+ $input .= ' ';
+ } else {
+ $input .= $ch;
+ }
+ }
+ }
+}
diff --git a/WebFiori/Cli/Progress/ProgressBar.php b/WebFiori/Cli/Progress/ProgressBar.php
index a1dc7c2..1624155 100644
--- a/WebFiori/Cli/Progress/ProgressBar.php
+++ b/WebFiori/Cli/Progress/ProgressBar.php
@@ -1,347 +1,347 @@
-output = $output;
- $this->total = max(1, $total);
- $this->style = new ProgressBarStyle();
- $this->format = new ProgressBarFormat();
- $this->startTime = microtime(true);
- }
-
- /**
- * Advances the progress bar by the specified number of steps.
- *
- * @param int $step Number of steps to advance
- * @return ProgressBar
- */
- public function advance(int $step = 1): ProgressBar {
- $this->setCurrent($this->current + $step);
-
- return $this;
- }
-
- /**
- * Finishes the progress bar.
- *
- * @param string $message Optional completion message
- * @return ProgressBar
- */
- public function finish(string $message = ''): ProgressBar {
- if (!$this->finished) {
- $this->current = $this->total;
- $this->finished = true;
-
- if ($message) {
- $this->message = $message;
- }
-
- $this->display();
-
- if ($this->overwrite) {
- $this->output->prints("%s", "\n");
- }
- }
-
- return $this;
- }
-
- /**
- * Gets the current progress value.
- *
- * @return int
- */
- public function getCurrent(): int {
- return $this->current;
- }
-
- /**
- * Gets the progress percentage.
- *
- * @return float
- */
- public function getPercent(): float {
- return ($this->current / $this->total) * 100;
- }
-
- /**
- * Gets the total number of steps.
- *
- * @return int
- */
- public function getTotal(): int {
- return $this->total;
- }
-
- /**
- * Checks if the progress bar is finished.
- *
- * @return bool
- */
- public function isFinished(): bool {
- return $this->finished;
- }
-
- /**
- * Sets the current progress value.
- *
- * @param int $current Current progress value
- * @return ProgressBar
- */
- public function setCurrent(int $current): ProgressBar {
- $this->current = max(0, min($current, $this->total));
-
- if (!$this->started) {
- $this->started = true;
- $this->startTime = microtime(true);
- $this->progressHistory = [];
- $this->finished = false;
- }
-
- $this->recordProgress();
- $this->display();
-
- return $this;
- }
-
- /**
- * Sets the format string.
- *
- * @param string $format Format string with placeholders
- * @return ProgressBar
- */
- public function setFormat(string $format): ProgressBar {
- $this->format->setFormat($format);
-
- return $this;
- }
-
- /**
- * Sets whether to overwrite the current line.
- *
- * @param bool $overwrite
- * @return ProgressBar
- */
- public function setOverwrite(bool $overwrite): ProgressBar {
- $this->overwrite = $overwrite;
-
- return $this;
- }
-
- /**
- * Sets the progress bar style.
- *
- * @param ProgressBarStyle|string $style Style object or predefined style name
- * @return ProgressBar
- */
- public function setStyle($style): ProgressBar {
- if (is_string($style)) {
- $this->style = ProgressBarStyle::fromName($style);
- } else {
- $this->style = $style;
- }
-
- return $this;
- }
-
- /**
- * Sets the total number of steps.
- *
- * @param int $total Total steps
- * @return ProgressBar
- */
- public function setTotal(int $total): ProgressBar {
- $this->total = max(1, $total);
- $this->current = min($this->current, $this->total);
-
- return $this;
- }
-
- /**
- * Sets the update throttle time.
- *
- * @param float $seconds Minimum seconds between updates
- * @return ProgressBar
- */
- public function setUpdateThrottle(float $seconds): ProgressBar {
- $this->updateThrottle = max(0, $seconds);
-
- return $this;
- }
-
- /**
- * Sets the progress bar width.
- *
- * @param int $width Width in characters
- * @return ProgressBar
- */
- public function setWidth(int $width): ProgressBar {
- $this->width = max(1, $width);
-
- return $this;
- }
-
- /**
- * Starts the progress bar.
- *
- * @param string $message Optional message to display
- * @return ProgressBar
- */
- public function start(string $message = ''): ProgressBar {
- $this->started = true;
- $this->startTime = microtime(true);
- $this->message = $message;
- $this->current = 0;
- $this->progressHistory = [];
- $this->finished = false;
-
- $this->display();
-
- return $this;
- }
-
- /**
- * Displays the progress bar.
- */
- private function display(): void {
- $now = microtime(true);
-
- // Throttle updates unless finished
- if (!$this->finished && ($now - $this->lastUpdateTime) < $this->updateThrottle) {
- return;
- }
-
- $this->lastUpdateTime = $now;
-
- $values = [
- 'bar' => $this->renderBar(),
- 'percent' => number_format($this->getPercent(), 1),
- 'current' => $this->current,
- 'total' => $this->total,
- 'elapsed' => ProgressBarFormat::formatDuration($this->getElapsed()),
- 'eta' => ProgressBarFormat::formatDuration($this->getEta()),
- 'rate' => ProgressBarFormat::formatRate($this->getRate()),
- 'memory' => ProgressBarFormat::formatMemory(memory_get_usage(true))
- ];
-
- $output = $this->format->render($values);
-
- if ($this->message) {
- $output = $this->message.' '.$output;
- }
-
- if ($this->overwrite && $this->started) {
- $this->output->prints("%s", "\r".$output);
- } else {
- $this->output->prints("%s", $output."\n");
- }
- }
-
- /**
- * Gets elapsed time since start.
- *
- * @return float Elapsed seconds
- */
- private function getElapsed(): float {
- return microtime(true) - $this->startTime;
- }
-
- /**
- * Calculates estimated time to completion.
- *
- * @return float Estimated seconds remaining
- */
- private function getEta(): float {
- $rate = $this->getRate();
-
- if ($rate <= 0 || $this->current >= $this->total) {
- return 0;
- }
-
- $remaining = $this->total - $this->current;
-
- return $remaining / $rate;
- }
-
- /**
- * Calculates the current rate of progress.
- *
- * @return float Progress per second
- */
- private function getRate(): float {
- if (count($this->progressHistory) < 2) {
- return 0;
- }
-
- $first = reset($this->progressHistory);
- $last = end($this->progressHistory);
-
- $timeDiff = $last['time'] - $first['time'];
- $progressDiff = $last['progress'] - $first['progress'];
-
- return $timeDiff > 0 ? $progressDiff / $timeDiff : 0;
- }
-
- /**
- * Records progress for rate calculation.
- */
- private function recordProgress(): void {
- $now = microtime(true);
- $this->progressHistory[] = [
- 'time' => $now,
- 'progress' => $this->current
- ];
-
- // Keep only recent history (last 10 seconds)
- $cutoff = $now - 10;
- $this->progressHistory = array_filter($this->progressHistory, function ($entry) use ($cutoff) {
- return $entry['time'] >= $cutoff;
- });
- }
-
- /**
- * Renders the progress bar.
- *
- * @return string Rendered progress bar
- */
- private function renderBar(): string {
- $percent = $this->getPercent();
- $filledWidth = (int)round(($percent / 100) * $this->width);
- $emptyWidth = $this->width - $filledWidth;
-
- $bar = str_repeat($this->style->getBarChar(), $filledWidth);
- $bar .= str_repeat($this->style->getEmptyChar(), $emptyWidth);
-
- return $bar;
- }
-}
+output = $output;
+ $this->total = max(1, $total);
+ $this->style = new ProgressBarStyle();
+ $this->format = new ProgressBarFormat();
+ $this->startTime = microtime(true);
+ }
+
+ /**
+ * Advances the progress bar by the specified number of steps.
+ *
+ * @param int $step Number of steps to advance
+ * @return ProgressBar
+ */
+ public function advance(int $step = 1): ProgressBar {
+ $this->setCurrent($this->current + $step);
+
+ return $this;
+ }
+
+ /**
+ * Finishes the progress bar.
+ *
+ * @param string $message Optional completion message
+ * @return ProgressBar
+ */
+ public function finish(string $message = ''): ProgressBar {
+ if (!$this->finished) {
+ $this->current = $this->total;
+ $this->finished = true;
+
+ if ($message) {
+ $this->message = $message;
+ }
+
+ $this->display();
+
+ if ($this->overwrite) {
+ $this->output->prints("%s", "\n");
+ }
+ }
+
+ return $this;
+ }
+
+ /**
+ * Gets the current progress value.
+ *
+ * @return int
+ */
+ public function getCurrent(): int {
+ return $this->current;
+ }
+
+ /**
+ * Gets the progress percentage.
+ *
+ * @return float
+ */
+ public function getPercent(): float {
+ return ($this->current / $this->total) * 100;
+ }
+
+ /**
+ * Gets the total number of steps.
+ *
+ * @return int
+ */
+ public function getTotal(): int {
+ return $this->total;
+ }
+
+ /**
+ * Checks if the progress bar is finished.
+ *
+ * @return bool
+ */
+ public function isFinished(): bool {
+ return $this->finished;
+ }
+
+ /**
+ * Sets the current progress value.
+ *
+ * @param int $current Current progress value
+ * @return ProgressBar
+ */
+ public function setCurrent(int $current): ProgressBar {
+ $this->current = max(0, min($current, $this->total));
+
+ if (!$this->started) {
+ $this->started = true;
+ $this->startTime = microtime(true);
+ $this->progressHistory = [];
+ $this->finished = false;
+ }
+
+ $this->recordProgress();
+ $this->display();
+
+ return $this;
+ }
+
+ /**
+ * Sets the format string.
+ *
+ * @param string $format Format string with placeholders
+ * @return ProgressBar
+ */
+ public function setFormat(string $format): ProgressBar {
+ $this->format->setFormat($format);
+
+ return $this;
+ }
+
+ /**
+ * Sets whether to overwrite the current line.
+ *
+ * @param bool $overwrite
+ * @return ProgressBar
+ */
+ public function setOverwrite(bool $overwrite): ProgressBar {
+ $this->overwrite = $overwrite;
+
+ return $this;
+ }
+
+ /**
+ * Sets the progress bar style.
+ *
+ * @param ProgressBarStyle|string $style Style object or predefined style name
+ * @return ProgressBar
+ */
+ public function setStyle($style): ProgressBar {
+ if (is_string($style)) {
+ $this->style = ProgressBarStyle::fromName($style);
+ } else {
+ $this->style = $style;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Sets the total number of steps.
+ *
+ * @param int $total Total steps
+ * @return ProgressBar
+ */
+ public function setTotal(int $total): ProgressBar {
+ $this->total = max(1, $total);
+ $this->current = min($this->current, $this->total);
+
+ return $this;
+ }
+
+ /**
+ * Sets the update throttle time.
+ *
+ * @param float $seconds Minimum seconds between updates
+ * @return ProgressBar
+ */
+ public function setUpdateThrottle(float $seconds): ProgressBar {
+ $this->updateThrottle = max(0, $seconds);
+
+ return $this;
+ }
+
+ /**
+ * Sets the progress bar width.
+ *
+ * @param int $width Width in characters
+ * @return ProgressBar
+ */
+ public function setWidth(int $width): ProgressBar {
+ $this->width = max(1, $width);
+
+ return $this;
+ }
+
+ /**
+ * Starts the progress bar.
+ *
+ * @param string $message Optional message to display
+ * @return ProgressBar
+ */
+ public function start(string $message = ''): ProgressBar {
+ $this->started = true;
+ $this->startTime = microtime(true);
+ $this->message = $message;
+ $this->current = 0;
+ $this->progressHistory = [];
+ $this->finished = false;
+
+ $this->display();
+
+ return $this;
+ }
+
+ /**
+ * Displays the progress bar.
+ */
+ private function display(): void {
+ $now = microtime(true);
+
+ // Throttle updates unless finished
+ if (!$this->finished && ($now - $this->lastUpdateTime) < $this->updateThrottle) {
+ return;
+ }
+
+ $this->lastUpdateTime = $now;
+
+ $values = [
+ 'bar' => $this->renderBar(),
+ 'percent' => number_format($this->getPercent(), 1),
+ 'current' => $this->current,
+ 'total' => $this->total,
+ 'elapsed' => ProgressBarFormat::formatDuration($this->getElapsed()),
+ 'eta' => ProgressBarFormat::formatDuration($this->getEta()),
+ 'rate' => ProgressBarFormat::formatRate($this->getRate()),
+ 'memory' => ProgressBarFormat::formatMemory(memory_get_usage(true))
+ ];
+
+ $output = $this->format->render($values);
+
+ if ($this->message) {
+ $output = $this->message.' '.$output;
+ }
+
+ if ($this->overwrite && $this->started) {
+ $this->output->prints("%s", "\r".$output);
+ } else {
+ $this->output->prints("%s", $output."\n");
+ }
+ }
+
+ /**
+ * Gets elapsed time since start.
+ *
+ * @return float Elapsed seconds
+ */
+ private function getElapsed(): float {
+ return microtime(true) - $this->startTime;
+ }
+
+ /**
+ * Calculates estimated time to completion.
+ *
+ * @return float Estimated seconds remaining
+ */
+ private function getEta(): float {
+ $rate = $this->getRate();
+
+ if ($rate <= 0 || $this->current >= $this->total) {
+ return 0;
+ }
+
+ $remaining = $this->total - $this->current;
+
+ return $remaining / $rate;
+ }
+
+ /**
+ * Calculates the current rate of progress.
+ *
+ * @return float Progress per second
+ */
+ private function getRate(): float {
+ if (count($this->progressHistory) < 2) {
+ return 0;
+ }
+
+ $first = reset($this->progressHistory);
+ $last = end($this->progressHistory);
+
+ $timeDiff = $last['time'] - $first['time'];
+ $progressDiff = $last['progress'] - $first['progress'];
+
+ return $timeDiff > 0 ? $progressDiff / $timeDiff : 0;
+ }
+
+ /**
+ * Records progress for rate calculation.
+ */
+ private function recordProgress(): void {
+ $now = microtime(true);
+ $this->progressHistory[] = [
+ 'time' => $now,
+ 'progress' => $this->current
+ ];
+
+ // Keep only recent history (last 10 seconds)
+ $cutoff = $now - 10;
+ $this->progressHistory = array_filter($this->progressHistory, function ($entry) use ($cutoff) {
+ return $entry['time'] >= $cutoff;
+ });
+ }
+
+ /**
+ * Renders the progress bar.
+ *
+ * @return string Rendered progress bar
+ */
+ private function renderBar(): string {
+ $percent = $this->getPercent();
+ $filledWidth = (int)round(($percent / 100) * $this->width);
+ $emptyWidth = $this->width - $filledWidth;
+
+ $bar = str_repeat($this->style->getBarChar(), $filledWidth);
+ $bar .= str_repeat($this->style->getEmptyChar(), $emptyWidth);
+
+ return $bar;
+ }
+}
diff --git a/WebFiori/Cli/Progress/ProgressBarFormat.php b/WebFiori/Cli/Progress/ProgressBarFormat.php
index 1774f62..3a67d1f 100644
--- a/WebFiori/Cli/Progress/ProgressBarFormat.php
+++ b/WebFiori/Cli/Progress/ProgressBarFormat.php
@@ -1,156 +1,156 @@
-format = $format;
- }
-
- /**
- * Formats time duration in human-readable format.
- *
- * @param float $seconds Duration in seconds
- * @return string Formatted duration
- */
- public static function formatDuration(float $seconds): string {
- if ($seconds < 0) {
- return '--:--';
- }
-
- $totalSeconds = (int) $seconds;
- $hours = intdiv($totalSeconds, 3600);
- $minutes = intdiv($totalSeconds % 3600, 60);
- $secs = $totalSeconds % 60;
-
- if ($hours > 0) {
- return sprintf('%02d:%02d:%02d', $hours, $minutes, $secs);
- }
-
- return sprintf('%02d:%02d', $minutes, $secs);
- }
-
- /**
- * Formats memory usage in human-readable format.
- *
- * @param int $bytes Memory usage in bytes
- * @return string Formatted memory usage
- */
- public static function formatMemory(int $bytes): string {
- $units = ['B', 'KB', 'MB', 'GB'];
- $unitIndex = 0;
-
- while ($bytes >= 1024 && $unitIndex < count($units) - 1) {
- $bytes /= 1024;
- $unitIndex++;
- }
-
- return sprintf('%.1f%s', $bytes, $units[$unitIndex]);
- }
-
- /**
- * Formats rate in human-readable format.
- *
- * @param float $rate Rate per second
- * @return string Formatted rate
- */
- public static function formatRate(float $rate): string {
- if ($rate < 1) {
- return sprintf('%.2f', $rate);
- } elseif ($rate < 10) {
- return sprintf('%.1f', $rate);
- } else {
- return sprintf('%.0f', $rate);
- }
- }
-
- /**
- * Gets the format string.
- *
- * @return string
- */
- public function getFormat(): string {
- return $this->format;
- }
-
- /**
- * Gets all placeholders used in the format string.
- *
- * @return array Array of placeholder names
- */
- public function getPlaceholders(): array {
- preg_match_all('/\{([^}]+)\}/', $this->format, $matches);
-
- return $matches[1] ?? [];
- }
-
- /**
- * Checks if the format contains a specific placeholder.
- *
- * @param string $placeholder Placeholder name without braces
- * @return bool
- */
- public function hasPlaceholder(string $placeholder): bool {
- return strpos($this->format, '{'.$placeholder.'}') !== false;
- }
-
- /**
- * Renders the format string with provided values.
- *
- * @param array $values Associative array of placeholder values
- * @return string Rendered format string
- */
- public function render(array $values): string {
- $output = $this->format;
-
- foreach ($values as $placeholder => $value) {
- $output = str_replace('{'.$placeholder.'}', (string)$value, $output);
- }
-
- return $output;
- }
-
- /**
- * Sets the format string.
- *
- * @param string $format
- * @return ProgressBarFormat
- */
- public function setFormat(string $format): ProgressBarFormat {
- $this->format = $format;
-
- return $this;
- }
-}
+format = $format;
+ }
+
+ /**
+ * Formats time duration in human-readable format.
+ *
+ * @param float $seconds Duration in seconds
+ * @return string Formatted duration
+ */
+ public static function formatDuration(float $seconds): string {
+ if ($seconds < 0) {
+ return '--:--';
+ }
+
+ $totalSeconds = (int) $seconds;
+ $hours = intdiv($totalSeconds, 3600);
+ $minutes = intdiv($totalSeconds % 3600, 60);
+ $secs = $totalSeconds % 60;
+
+ if ($hours > 0) {
+ return sprintf('%02d:%02d:%02d', $hours, $minutes, $secs);
+ }
+
+ return sprintf('%02d:%02d', $minutes, $secs);
+ }
+
+ /**
+ * Formats memory usage in human-readable format.
+ *
+ * @param int $bytes Memory usage in bytes
+ * @return string Formatted memory usage
+ */
+ public static function formatMemory(int $bytes): string {
+ $units = ['B', 'KB', 'MB', 'GB'];
+ $unitIndex = 0;
+
+ while ($bytes >= 1024 && $unitIndex < count($units) - 1) {
+ $bytes /= 1024;
+ $unitIndex++;
+ }
+
+ return sprintf('%.1f%s', $bytes, $units[$unitIndex]);
+ }
+
+ /**
+ * Formats rate in human-readable format.
+ *
+ * @param float $rate Rate per second
+ * @return string Formatted rate
+ */
+ public static function formatRate(float $rate): string {
+ if ($rate < 1) {
+ return sprintf('%.2f', $rate);
+ } elseif ($rate < 10) {
+ return sprintf('%.1f', $rate);
+ } else {
+ return sprintf('%.0f', $rate);
+ }
+ }
+
+ /**
+ * Gets the format string.
+ *
+ * @return string
+ */
+ public function getFormat(): string {
+ return $this->format;
+ }
+
+ /**
+ * Gets all placeholders used in the format string.
+ *
+ * @return array Array of placeholder names
+ */
+ public function getPlaceholders(): array {
+ preg_match_all('/\{([^}]+)\}/', $this->format, $matches);
+
+ return $matches[1] ?? [];
+ }
+
+ /**
+ * Checks if the format contains a specific placeholder.
+ *
+ * @param string $placeholder Placeholder name without braces
+ * @return bool
+ */
+ public function hasPlaceholder(string $placeholder): bool {
+ return strpos($this->format, '{'.$placeholder.'}') !== false;
+ }
+
+ /**
+ * Renders the format string with provided values.
+ *
+ * @param array $values Associative array of placeholder values
+ * @return string Rendered format string
+ */
+ public function render(array $values): string {
+ $output = $this->format;
+
+ foreach ($values as $placeholder => $value) {
+ $output = str_replace('{'.$placeholder.'}', (string)$value, $output);
+ }
+
+ return $output;
+ }
+
+ /**
+ * Sets the format string.
+ *
+ * @param string $format
+ * @return ProgressBarFormat
+ */
+ public function setFormat(string $format): ProgressBarFormat {
+ $this->format = $format;
+
+ return $this;
+ }
+}
diff --git a/WebFiori/Cli/Progress/ProgressBarStyle.php b/WebFiori/Cli/Progress/ProgressBarStyle.php
index 52a922f..deb4589 100644
--- a/WebFiori/Cli/Progress/ProgressBarStyle.php
+++ b/WebFiori/Cli/Progress/ProgressBarStyle.php
@@ -1,151 +1,151 @@
- [
- 'bar_char' => 'โ',
- 'empty_char' => 'โ',
- 'progress_char' => 'โ'
- ],
- self::ASCII => [
- 'bar_char' => '=',
- 'empty_char' => '-',
- 'progress_char' => '>'
- ],
- self::DOTS => [
- 'bar_char' => 'โ',
- 'empty_char' => 'โ',
- 'progress_char' => 'โ'
- ],
- self::ARROW => [
- 'bar_char' => 'โถ',
- 'empty_char' => 'โท',
- 'progress_char' => 'โถ'
- ]
- ];
-
- /**
- * Creates a new progress bar style.
- *
- * @param string $barChar Character for completed progress
- * @param string $emptyChar Character for remaining progress
- * @param string $progressChar Character for current progress position
- */
- public function __construct(string $barChar = 'โ', string $emptyChar = 'โ', string $progressChar = 'โ') {
- $this->barChar = $barChar;
- $this->emptyChar = $emptyChar;
- $this->progressChar = $progressChar;
- }
-
- /**
- * Creates a style from predefined style name.
- *
- * @param string $styleName One of the predefined style constants
- * @return ProgressBarStyle
- */
- public static function fromName(string $styleName): ProgressBarStyle {
- if (!isset(self::$styles[$styleName])) {
- $styleName = self::DEFAULT;
- }
-
- $style = self::$styles[$styleName];
-
- return new self($style['bar_char'], $style['empty_char'], $style['progress_char']);
- }
-
- /**
- * Gets the character for completed progress.
- *
- * @return string
- */
- public function getBarChar(): string {
- return $this->barChar;
- }
-
- /**
- * Gets the character for remaining progress.
- *
- * @return string
- */
- public function getEmptyChar(): string {
- return $this->emptyChar;
- }
-
- /**
- * Gets the character for current progress position.
- *
- * @return string
- */
- public function getProgressChar(): string {
- return $this->progressChar;
- }
-
- /**
- * Sets the character for completed progress.
- *
- * @param string $char
- * @return ProgressBarStyle
- */
- public function setBarChar(string $char): ProgressBarStyle {
- $this->barChar = $char;
-
- return $this;
- }
-
- /**
- * Sets the character for remaining progress.
- *
- * @param string $char
- * @return ProgressBarStyle
- */
- public function setEmptyChar(string $char): ProgressBarStyle {
- $this->emptyChar = $char;
-
- return $this;
- }
-
- /**
- * Sets the character for current progress position.
- *
- * @param string $char
- * @return ProgressBarStyle
- */
- public function setProgressChar(string $char): ProgressBarStyle {
- $this->progressChar = $char;
-
- return $this;
- }
-}
+ [
+ 'bar_char' => 'โ',
+ 'empty_char' => 'โ',
+ 'progress_char' => 'โ'
+ ],
+ self::ASCII => [
+ 'bar_char' => '=',
+ 'empty_char' => '-',
+ 'progress_char' => '>'
+ ],
+ self::DOTS => [
+ 'bar_char' => 'โ',
+ 'empty_char' => 'โ',
+ 'progress_char' => 'โ'
+ ],
+ self::ARROW => [
+ 'bar_char' => 'โถ',
+ 'empty_char' => 'โท',
+ 'progress_char' => 'โถ'
+ ]
+ ];
+
+ /**
+ * Creates a new progress bar style.
+ *
+ * @param string $barChar Character for completed progress
+ * @param string $emptyChar Character for remaining progress
+ * @param string $progressChar Character for current progress position
+ */
+ public function __construct(string $barChar = 'โ', string $emptyChar = 'โ', string $progressChar = 'โ') {
+ $this->barChar = $barChar;
+ $this->emptyChar = $emptyChar;
+ $this->progressChar = $progressChar;
+ }
+
+ /**
+ * Creates a style from predefined style name.
+ *
+ * @param string $styleName One of the predefined style constants
+ * @return ProgressBarStyle
+ */
+ public static function fromName(string $styleName): ProgressBarStyle {
+ if (!isset(self::$styles[$styleName])) {
+ $styleName = self::DEFAULT;
+ }
+
+ $style = self::$styles[$styleName];
+
+ return new self($style['bar_char'], $style['empty_char'], $style['progress_char']);
+ }
+
+ /**
+ * Gets the character for completed progress.
+ *
+ * @return string
+ */
+ public function getBarChar(): string {
+ return $this->barChar;
+ }
+
+ /**
+ * Gets the character for remaining progress.
+ *
+ * @return string
+ */
+ public function getEmptyChar(): string {
+ return $this->emptyChar;
+ }
+
+ /**
+ * Gets the character for current progress position.
+ *
+ * @return string
+ */
+ public function getProgressChar(): string {
+ return $this->progressChar;
+ }
+
+ /**
+ * Sets the character for completed progress.
+ *
+ * @param string $char
+ * @return ProgressBarStyle
+ */
+ public function setBarChar(string $char): ProgressBarStyle {
+ $this->barChar = $char;
+
+ return $this;
+ }
+
+ /**
+ * Sets the character for remaining progress.
+ *
+ * @param string $char
+ * @return ProgressBarStyle
+ */
+ public function setEmptyChar(string $char): ProgressBarStyle {
+ $this->emptyChar = $char;
+
+ return $this;
+ }
+
+ /**
+ * Sets the character for current progress position.
+ *
+ * @param string $char
+ * @return ProgressBarStyle
+ */
+ public function setProgressChar(string $char): ProgressBarStyle {
+ $this->progressChar = $char;
+
+ return $this;
+ }
+}
diff --git a/WebFiori/Cli/Runner.php b/WebFiori/Cli/Runner.php
index 1c80b0d..56c2b7c 100644
--- a/WebFiori/Cli/Runner.php
+++ b/WebFiori/Cli/Runner.php
@@ -1,1173 +1,1173 @@
-commands = [];
- $this->aliases = [];
- $this->globalArgs = [];
- $this->argsV = [];
- $this->isInteractive = false;
- $this->isAnsi = false;
- $this->inputStream = new StdIn();
- $this->outputStream = new StdOut();
- $this->commandExitVal = 0;
- $this->afterRunPool = [];
-
- // Initialize discovery properties
- $this->commandDiscovery = null;
- $this->autoDiscoveryEnabled = false;
- $this->commandsDiscovered = false;
-
- $this->addArg('--ansi', [
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DESCRIPTION => 'Force the use of ANSI output.'
- ]);
- $this->setBeforeStart(function (Runner $r) {
- if (count($r->getArgsVector()) == 0) {
- $r->setArgsVector($_SERVER['argv']);
- }
- $r->checkIsInteractive();
- });
- $this->register(new HelpCommand(), ['-h']);
- $this->setDefaultCommand('help');
- }
-
- /**
- * Adds a global command argument.
- *
- * An argument is a string that comes after the name of the command. The value
- * of an argument can be set using equal sign. For example, if command name
- * is 'do-it' and one argument has the name 'what-to-do', then the full
- * CLI command would be "do-it what-to-do=say-hi". An argument can be
- * also treated as an option.
- *
- * @param string $name The name of the argument. It must be non-empty string
- * and does not contain spaces.
- *
- * @param array $options An optional array of options. Available options are:
- *
- *
optional: A boolean. if set to true, it means that the argument
- * is optional and can be ignored when running the command.
- *
default: An optional default value for the argument
- * to use if it is not provided and is optional.
- *
description: A description of the argument which
- * will be shown if the command 'help' is executed.
- *
values: A set of values that the argument can have. If provided,
- * only the values on the list will be allowed. Note that if null or empty string
- * is in the array, it will be ignored. Also, if boolean values are
- * provided, true will be converted to the string 'y' and false will
- * be converted to the string 'n'.
- *
- *
- * @return bool If the argument is added, the method will return true.
- * Other than that, the method will return false.
- *
- */
- public function addArg(string $name, array $options = []): bool {
- $toAdd = Argument::create($name, $options);
-
- if ($toAdd === null) {
- return false;
- }
-
- return $this->addArgument($toAdd);
- }
-
- /**
- * Adds an argument to the set of global arguments.
- *
- * Global arguments are set of arguments that will be added automatically
- * to any command which is registered by the runner.
- *
- * @param Argument $arg An object that holds argument info.
- *
- * @return bool If the argument is added, the method will return true.
- * Other than that, false is returned.
- */
- public function addArgument(Argument $arg): bool {
- if (!$this->hasArg($arg->getName())) {
- $this->globalArgs[] = $arg;
-
- return true;
- }
-
- return false;
- }
-
- /**
- * Add a directory path to search for commands.
- *
- * @param string $path Directory path to search
- * @return Runner
- */
- public function addDiscoveryPath(string $path): Runner {
- $this->enableAutoDiscovery();
- $this->commandDiscovery->addSearchPath($path);
-
- return $this;
- }
-
- /**
- * Add multiple discovery paths.
- *
- * @param array $paths Array of directory paths
- * @return Runner
- */
- public function addDiscoveryPaths(array $paths): Runner {
- $this->enableAutoDiscovery();
- $this->commandDiscovery->addSearchPaths($paths);
-
- return $this;
- }
-
- /**
- * Auto-register commands from a directory (convenience method).
- *
- * @param string $path Directory path to search
- * @param array $excludePatterns Optional exclude patterns
- * @return Runner
- */
- public function autoRegister(string $path, array $excludePatterns = []): Runner {
- return $this->addDiscoveryPath($path)
- ->excludePatterns($excludePatterns)
- ->discoverCommands();
- }
-
- /**
- * Clear discovery cache.
- *
- * @return Runner
- */
- public function clearDiscoveryCache(): Runner {
- if ($this->commandDiscovery !== null) {
- $this->commandDiscovery->getCache()->clear();
- }
-
- return $this;
- }
-
- /**
- * Disable auto-discovery of commands.
- *
- * @return Runner
- */
- public function disableAutoDiscovery(): Runner {
- $this->autoDiscoveryEnabled = false;
-
- return $this;
- }
-
- /**
- * Disable discovery caching.
- *
- * @return Runner
- */
- public function disableDiscoveryCache(): Runner {
- if ($this->commandDiscovery !== null) {
- $this->commandDiscovery->getCache()->setEnabled(false);
- }
-
- return $this;
- }
-
- /**
- * Discover and register commands from configured paths.
- *
- * @return Runner
- */
- public function discoverCommands(): Runner {
- if (!$this->autoDiscoveryEnabled || $this->commandsDiscovered) {
- return $this;
- }
-
- $discoveredCommands = $this->commandDiscovery->discover();
-
- foreach ($discoveredCommands as $command) {
- // Check if command implements AutoDiscoverable
- if ($command instanceof AutoDiscoverable && !$command::shouldAutoRegister()) {
- continue;
- }
-
- $this->register($command);
- }
-
- $this->commandsDiscovered = true;
-
- return $this;
- }
-
- /**
- * Enable auto-discovery of commands.
- *
- * @return Runner
- */
- public function enableAutoDiscovery(): Runner {
- $this->autoDiscoveryEnabled = true;
-
- if ($this->commandDiscovery === null) {
- $this->commandDiscovery = new CommandDiscovery();
- }
-
- return $this;
- }
-
- /**
- * Enable discovery caching.
- *
- * @param string $cacheFile Optional cache file path
- * @return Runner
- */
- public function enableDiscoveryCache(string $cacheFile = 'cache/commands.json'): Runner {
- $this->enableAutoDiscovery();
- $this->commandDiscovery->getCache()->setEnabled(true);
- $this->commandDiscovery->getCache()->setCacheFile($cacheFile);
-
- return $this;
- }
-
- /**
- * Add a pattern to exclude files/directories from discovery.
- *
- * @param string $pattern Glob pattern to exclude
- * @return Runner
- */
- public function excludePattern(string $pattern): Runner {
- $this->enableAutoDiscovery();
- $this->commandDiscovery->excludePattern($pattern);
-
- return $this;
- }
-
- /**
- * Add multiple exclude patterns.
- *
- * @param array $patterns Array of glob patterns
- * @return Runner
- */
- public function excludePatterns(array $patterns): Runner {
- $this->enableAutoDiscovery();
- $this->commandDiscovery->excludePatterns($patterns);
-
- return $this;
- }
-
- /**
- * Returns the command which is being executed.
- *
- * @return Command|null If a command is requested and currently in execute
- * stage, the method will return it as an object. If
- * no command is active, the method will return null.
- *
- */
- public function getActiveCommand(): ?Command {
- return $this->activeCommand;
- }
-
- /**
- * Resolve alias conflict interactively by prompting the user.
- *
- * @param string $alias The conflicting alias.
- * @param string $existingCommand The existing command that uses the alias.
- * @param string $newCommand The new command trying to use the alias.
- *
- * @return string The command name chosen by the user.
- * /**
- * Get all registered aliases.
- *
- * @return array An associative array where keys are aliases and values are command names.
- */
- public function getAliases(): array {
- return $this->aliases;
- }
-
- /**
- * Returns an array that contains objects that represents global arguments.
- *
- * @return array An array that contains objects that represents global arguments.
- */
- public function getArgs(): array {
- return $this->globalArgs;
- }
-
- /**
- * Returns an array that contains arguments vector values.
- *
- * @return array Each index will have one part of arguments vector.
- */
- public function getArgsVector(): array {
- return $this->argsV;
- }
-
- /**
- * Returns a registered command given its name.
- *
- * @param string $name The name of the command as specified when it was
- * initialized.
- *
- * @return Command|null If the command is registered, it is returned
- * as an object. Other than that, null is returned.
- */
- public function getCommandByName(string $name): ?Command {
- // First check if it's a direct command name
- if (isset($this->getCommands()[$name])) {
- return $this->getCommands()[$name];
- }
-
- // Then check if it's an alias
- if (isset($this->aliases[$name])) {
- $commandName = $this->aliases[$name];
-
- if (isset($this->getCommands()[$commandName])) {
- return $this->getCommands()[$commandName];
- }
- }
-
- return null;
- }
-
- /**
- * Get the command discovery instance.
- *
- * @return CommandDiscovery|null
- */
- public function getCommandDiscovery(): ?CommandDiscovery {
- return $this->commandDiscovery;
- }
-
- /**
- * Returns an associative array of registered commands.
- *
- * @return array The method will return an associative array.
- * The keys of the array are the names of the commands and the value of the key is
- * an object that holds command information.
- *
- */
- public function getCommands(): array {
- return $this->commands;
- }
-
- /**
- * Return the command which will get executed in case no command name
- * was provided as argument.
- *
- * @return Command|null If set, it will be returned as object.
- * Other than that, null is returned.
- */
- public function getDefaultCommand(): ?Command {
- return $this->defaultCommand;
- }
-
- /**
- * Get discovery cache instance.
- *
- * @return CommandCache|null
- */
- public function getDiscoveryCache(): ?CommandCache {
- return $this->commandDiscovery?->getCache();
- }
-
- /**
- * Returns the stream at which the engine is using to get inputs.
- *
- * @return InputStream The default input stream is 'StdIn'.
- */
- public function getInputStream(): InputStream {
- return $this->inputStream;
- }
-
- /**
- * Returns exit status code of last executed command.
- *
- * @return int For success run, the method should return 0. Other than that,
- * it means the command was executed with an error.
- */
- public function getLastCommandExitStatus(): int {
- return $this->commandExitVal;
- }
-
- /**
- * Returns an array that contain all generated output by executing a command.
- *
- * This method should be only used when testing the execution process of a
- * command The method will return empty array if output stream type
- * is not ArrayOutputStream.
- *
- * @return array An array that contains all output lines which are generated
- * by executing a specific command.
- */
- public function getOutput(): array {
- $outputStream = $this->getOutputStream();
-
- if ($outputStream instanceof ArrayOutputStream) {
- return $outputStream->getOutputArray();
- }
-
- return [];
- }
-
- /**
- * Returns the stream at which the engine is using to send outputs.
- *
- * @return OutputStream The default input stream is 'StdOut'.
- */
- public function getOutputStream(): OutputStream {
- return $this->outputStream;
- }
-
- /**
- * Check if an alias is registered.
- *
- * @param string $alias The alias to check.
- *
- * @return bool True if the alias exists, false otherwise.
- */
- public function hasAlias(string $alias): bool {
- return isset($this->aliases[$alias]);
- }
-
- /**
- * Checks if the runner has specific global argument or not given its name.
- *
- * @param string $name The name of the argument.
- *
- * @return bool If the runner has such argument, true is returned. Other than
- * that, false is returned.
- */
- public function hasArg(string $name): bool {
- foreach ($this->getArgs() as $argObj) {
- if ($argObj->getName() == $name) {
- return true;
- }
- }
-
- return false;
- }
-
- /**
- * Check if auto-discovery is enabled.
- *
- * @return bool
- */
- public function isAutoDiscoveryEnabled(): bool {
- return $this->autoDiscoveryEnabled;
- }
-
- /**
- * Checks if the class is running through command line interface (CLI) or
- * through a web server.
- *
- * @return bool If the class is running through a command line,
- * the method will return true. False if not.
- *
- */
- public static function isCLI(): bool {
- //best way to check if app is running through CLi
- // or in a web server.
- // Did a lot of research on that.
- return http_response_code() === false;
- }
-
- /**
- * Checks if CLI is running in interactive mode or not.
- *
- * @return bool If CLI is running in interactive mode, the method will
- * return true. False otherwise.
- *
- */
- public function isInteractive(): bool {
- return $this->isInteractive;
- }
-
- /**
- * Register new command.
- *
- * @param Command $cliCommand The command that will be registered.
- *
- * @return Runner The method will return the instance at which the method
- * is called on
- *
- */
- public function register(Command $cliCommand, array $aliases = []): Runner {
- if ($cliCommand->getName() != 'help') {
- $helpCommand = $this->getCommandByName('help');
- if ($helpCommand !== null) {
- $cliCommand->addArg($helpCommand->getName(), [
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DESCRIPTION => 'Display command help.'
- ]);
-
- foreach ($helpCommand->getAliases() as $alias) {
- $cliCommand->addArg($alias, [
- ArgumentOption::OPTIONAL => true
- ]);
- }
- }
- }
- $this->commands[$cliCommand->getName()] = $cliCommand;
-
- // Register runtime aliases
- foreach ($aliases as $alias) {
- $this->registerAlias($alias, $cliCommand->getName());
- }
-
- // Register built-in aliases from command itself
- foreach ($cliCommand->getAliases() as $alias) {
- $this->registerAlias($alias, $cliCommand->getName());
- }
-
- return $this;
- }
-
- /**
- * Removes an argument from the global args set given its name.
- *
- * @param string $name The name of the argument that will be removed.
- *
- * @return bool If removed, true is returned. Other than that, false is
- * returned.
- */
- public function removeArgument(string $name): bool {
- $removed = false;
- $temp = [];
-
- foreach ($this->getArgs() as $arg) {
- if ($arg->getName() !== $name) {
- $temp[] = $arg;
- } else {
- $removed = true;
- }
- }
- $this->globalArgs = $temp;
-
- return $removed;
- }
-
- /**
- * Reset input stream, output stream and, registered commands to default.
- *
- * @return Runner The method will return the instance at which the method
- * is called on
- */
- public function reset(): Runner {
- $this->inputStream = new StdIn();
- $this->outputStream = new StdOut();
- $this->commands = [];
- $this->aliases = [];
-
- // Re-register help command after reset
- $this->register(new HelpCommand());
-
- return $this;
- }
-
- /**
- * Get the command name for a given alias.
- *
- * @param string $alias The alias to resolve.
- *
- * @return string|null The command name if alias exists, null otherwise.
- */
- public function resolveAlias(string $alias): ?string {
- return $this->aliases[$alias] ?? null;
- }
-
- /**
- * Executes a command given as object.
- *
- * @param Command $c The command that will be executed. If null is given,
- * the method will take command name from the array '$args'.
- *
- * @param array $args An optional array that can hold command arguments.
- * The keys of the array should be arguments names and the value of each index
- * is the value of the argument. Note that if the first parameter of the
- * method is null, the first index of the array should hold
- * the name of the command that will be executed.
- *
- * @param bool $ansi If set to true, then the output will render with ANSI escape sequences.
- *
- * @return int The method will return an integer that represents exit status of
- * running the command. Usually, if the command exit with a number other than 0,
- * it means that there was an error in execution.
- */
- public function runCommand(?Command $c = null, array $args = [], bool $ansi = false): int {
- $commandName = null;
-
- if ($c === null) {
- if (count($args) == 0) {
- $c = $this->getDefaultCommand();
- } else {
- if (isset($args[0])) {
- $commandName = filter_var($args[0]);
-
- $c = $this->getCommandByName($commandName);
- } else {
- $c = $this->getDefaultCommand();
- }
- }
-
- if ($c === null) {
- if ($commandName == null) {
- $this->printMsg("No command was specified to run.", 'Info:', 'blue');
-
- return 0;
- } else {
- $this->printMsg("The command '".$commandName."' is not supported.", 'Error:', 'red');
- $this->commandExitVal = -1;
-
- return -1;
- }
- }
- }
-
- if ($ansi) {
- $args[] = '--ansi';
- }
- $this->setArgV($args);
- $this->setActiveCommand($c);
-
- try {
- $this->commandExitVal = $c->excCommand();
- } catch (Throwable $ex) {
- $this->printMsg('An exception was thrown.', 'Error:', 'red');
- $this->printMsg($ex->getMessage(), 'Exception Message:', 'yellow');
- $this->printMsg((string)$ex->getCode(), 'Code:', 'yellow');
- $this->printMsg($ex->getFile(), 'At:', 'yellow');
- $this->printMsg((string)$ex->getLine(), 'Line:', 'yellow');
- $this->printMsg("\n", 'Stack Trace:', 'yellow');
- $this->printMsg("\n".$ex->getTraceAsString());
- $this->commandExitVal = $ex->getCode() == 0 ? -1 : $ex->getCode();
- }
-
- $this->invokeAfterExc();
- $this->setActiveCommand();
-
- return $this->commandExitVal;
- }
-
- /**
- * Execute a registered command using a sub-runner.
- *
- * This method can be used to execute a registered command using another
- * runner instance which shares argsv, input and output streams with the
- * main runner. It can be used to invoke another command from within a
- * running command.
- *
- * @param string $commandName The name of the command. It must be a part of
- * registered commands.
- *
- * @param array $additionalArgs An associative array that represents additional arguments
- * to be passed to the command.
- *
- * @return int The method will return an integer that represent exit status
- * code of the command after execution.
- */
- public function runCommandAsSub(string $commandName, array $additionalArgs = []): int {
- $c = $this->getCommandByName($commandName);
-
- if ($c === null) {
- return -1;
- }
- $subRunner = new Runner();
- $subRunner->setInputStream($this->getInputStream());
- $subRunner->setOutputStream($this->getOutputStream());
- $subRunner->register($c);
- $args = $this->getArgsVector();
- $args[0] = $commandName;
- $code = $subRunner->runCommand(null, array_merge($args, $additionalArgs), $this->isAnsi);
-
- if ($code != 0) {
- if ($this->getActiveCommand() !== null) {
- $this->getActiveCommand()->warning('Command "'.$commandName.'" exited with code '.$code.'.');
- }
- }
-
- return $code;
- }
-
- /**
- * Sets the command which is currently in execution stage.
- *
- * This method is used internally by execution engine to set the command which
- * is being executed.
- *
- * @param Command $c The command which is in execution stage.
- *
- * @return Runner The method will return the instance at which the method
- * is called on
- */
- public function setActiveCommand(?Command $c = null): Runner {
- if ($this->getActiveCommand() !== null) {
- $this->getActiveCommand()->setOwner();
- }
- $this->activeCommand = $c;
-
- if ($this->getActiveCommand() !== null) {
- $this->getActiveCommand()->setOutputStream($this->getOutputStream());
- $this->getActiveCommand()->setInputStream($this->getInputStream());
- $this->getActiveCommand()->setOwner($this);
- }
-
- return $this;
- }
-
- /**
- * Add a function to execute after every command.
- *
- * The method can be used to set multiple callbacks.
- *
- * @param callable $func The function that will be executed after the
- * completion of command execution. The first parameter of the method
- * will always be an instance of 'Runner' (e.g. function (Runner $runner){}).
- *
- * @param array $params Any additional parameters that will be passed to the
- * callback.
- *
- * @return Runner The method will return the instance at which the method
- * is called on
- */
- public function setAfterExecution(callable $func, array $params = []): Runner {
- $this->afterRunPool[] = [
- 'func' => $func,
- 'params' => $params
- ];
-
- return $this;
- }
-
- /**
- * Sets arguments vector to have specific value.
- *
- * This method is mainly used to simulate running the class using an
- * actual terminal. Also, it can be used to set up the test run parameters
- * for testing a command.
- *
- * @param array $argsVector An array that contains arguments vector. Usually,
- * the first argument of the vector is the entry point (such as app.php).
- * The second argument is the name of the command that will get executed
- * and, remaining parts are any additional arguments that the command
- * might use.
- *
- * @return Runner The method will return the instance at which the method
- * is called on
- */
- public function setArgsVector(array $argsVector): Runner {
- $this->argsV = $argsVector;
-
- return $this;
- }
-
- /**
- * Sets a callable to call before start running CLI engine.
- *
- * This can be used to register custom-made commands before running
- * the engine.
- *
- * @param callable $func An executable function. The function will have
- * one parameter which is the runner that the function will be added to.
- *
- * @return Runner The method will return the instance at which the method
- * is called on
- */
- public function setBeforeStart(callable $func): Runner {
- $this->beforeStartPool[] = $func;
-
- return $this;
- }
-
- /**
- * Set a custom command discovery instance.
- *
- * @param CommandDiscovery $discovery
- * @return Runner
- */
- public function setCommandDiscovery(CommandDiscovery $discovery): Runner {
- $this->commandDiscovery = $discovery;
- $this->autoDiscoveryEnabled = true;
-
- return $this;
- }
-
- /**
- * Sets the default command that will be executed in case no command
- * name was provided as argument.
- *
- * @param string $commandName The name of the command that will be set as
- * default command. Note that it must be a registered command.
- *
- * @return Runner The method will return the instance at which the method
- * is called on
- */
- public function setDefaultCommand(string $commandName): Runner {
- $c = $this->getCommandByName($commandName);
-
- if ($c !== null) {
- $this->defaultCommand = $c;
- }
-
- return $this;
- }
-
- /**
- * Enable or disable strict mode for discovery.
- *
- * @param bool $strict
- * @return Runner
- */
- public function setDiscoveryStrictMode(bool $strict): Runner {
- $this->enableAutoDiscovery();
- $this->commandDiscovery->setStrictMode($strict);
-
- return $this;
- }
-
- /**
- * Sets an array as an input for running specific command.
- *
- * This method is used to test the execution process of specific command.
- * The developer can use it to mimic the inputs which could be provided
- * by the user when actually running the command through a terminal.
- * The developer can use the method 'Runner::getOutput()' to get generated
- * output and compare it with expected output.
- *
- * Note that this method will set the input stream to 'ArrayInputStream'
- * and output stream to 'ArrayOutputStream'.
- *
- * @param array $inputs An array that contain lines of inputs.
- *
- * @return Runner The method will return the instance at which the method
- * is called on
- */
- public function setInputs(array $inputs = []): Runner {
- $this->setInputStream(new ArrayInputStream($inputs));
- $this->setOutputStream(new ArrayOutputStream());
-
- return $this;
- }
-
- /**
- * Sets the stream at which the runner will be using to read inputs from.
- *
- * @param InputStream $stream The new stream that will hold inputs.
- *
- * @return Runner The method will return the instance at which the method
- * is called on
- */
- public function setInputStream(InputStream $stream): Runner {
- $this->inputStream = $stream;
-
- return $this;
- }
-
- /**
- * Sets the stream at which the runner will be using to send outputs to.
- *
- * @param OutputStream $stream The new stream that will hold inputs.
- *
- * @return Runner The method will return the instance at which the method
- * is called on
- */
- public function setOutputStream(OutputStream $stream): Runner {
- $this->outputStream = $stream;
-
- return $this;
- }
-
- /**
- * Start command line process.
- *
- * @return int The method will return an integer that represents exit status of
- * the process. Usually, if the process exit with a number other than 0,
- * it means that there was an error in execution.
- */
- public function start(): int {
- foreach ($this->beforeStartPool as $func) {
- call_user_func_array($func, [$this]);
- }
-
- if ($this->isInteractive()) {
- $this->isAnsi = in_array('--ansi', $this->getArgsVector());
- $this->printMsg('Running in interactive mode.', '>>', 'blue');
- $this->printMsg("Type command name or 'exit' to close.", ">>", 'blue');
- $this->printMsg('', '>>', 'blue');
-
- while (true) {
- $args = $this->readInteractive();
- $this->setArgsVector($args);
- $argsCount = count($args);
-
- if ($argsCount == 0) {
- $this->getOutputStream()->println('No input.');
- } else {
- if ($args[0] == 'exit') {
- return 0;
- } else {
- $this->runCommand(null, $args, $this->isAnsi);
- }
- }
- $this->printMsg('', '>>', 'blue');
- }
- } else {
- return $this->run();
- }
- }
-
- private function checkIsInteractive(): void {
- foreach ($this->getArgsVector() as $arg) {
- $this->isInteractive = $arg == '-i' || $this->isInteractive;
- }
- }
-
- private function invokeAfterExc(): void {
- foreach ($this->afterRunPool as $funcArr) {
- call_user_func_array($funcArr['func'], array_merge([$this], $funcArr['params']));
- }
- }
-
- private function printMsg(string $msg, ?string $prefix = null, ?string $color = null): void {
- if ($prefix !== null) {
- $prefix = Formatter::format($prefix, [
- 'color' => $color,
- 'bold' => true,
- 'ansi' => $this->isAnsi
- ]);
- $this->getOutputStream()->prints("$prefix ");
- }
-
- if (strlen($msg) != 0) {
- $this->getOutputStream()->println($msg);
- }
- }
-
- private function readInteractive(): array {
- $input = trim($this->getInputStream()->readLine());
-
- $argsArr = strlen($input) != 0 ? explode(' ', $input) : [];
-
- if (in_array('--ansi', $argsArr)) {
- $argsArr = array_diff($argsArr, ['--ansi']);
- }
-
- // Preprocess help patterns
- $argsArr = $this->preprocessHelpPattern($argsArr);
-
- return $argsArr;
- }
-
- /**
- * Register an alias for a command.
- *
- * @param string $alias The alias to register.
- * @param string $commandName The name of the command the alias points to.
- *
- * @return Runner The method will return the instance at which the method
- * is called on
- */
- private function registerAlias(string $alias, string $commandName): Runner {
- // Check for conflicts
- if (isset($this->aliases[$alias])) {
- $existingCommand = $this->aliases[$alias];
-
- if ($this->isInteractive()) {
- // Interactive mode: prompt user to choose
- $choice = $this->resolveAliasConflictInteractively($alias, $existingCommand, $commandName);
-
- if ($choice === $commandName) {
- $this->aliases[$alias] = $commandName;
- }
- // If user chose existing command, do nothing
- } else {
- // Non-interactive mode: use first-come-first-served (do nothing)
- // Suppress warning if both existing and new command are 'help' (expected duplicate registration)
- if (!($existingCommand === 'help' && $commandName === 'help')) {
- $this->printMsg("Alias '$alias' already exists for command '$existingCommand'. Ignoring new alias for '$commandName'.", 'Warning:', 'yellow');
- }
- }
- } else {
- // No conflict, register the alias
- $this->aliases[$alias] = $commandName;
- }
-
- return $this;
- }
-
- /**
- * Run the command line as single run.
- *
- * @return int
- */
- private function run(): int {
- $argsArr = array_slice($this->getArgsVector(), 1);
-
- if (in_array('--ansi', $argsArr)) {
- $this->isAnsi = true;
- $tempArgs = [];
-
- foreach ($argsArr as $argName => $val) {
- if (gettype($argName) == 'integer') {
- if ($val != '--ansi') {
- $tempArgs[] = $val;
- }
- } else {
- $tempArgs[$argName] = $val;
- }
- }
- $argsArr = $tempArgs;
- }
-
-
- // Preprocess help patterns for non-interactive mode
- $argsArr = $this->preprocessHelpPattern($argsArr);
- if (count($argsArr) == 0) {
- $command = $this->getDefaultCommand();
-
- return $this->runCommand($command, [], $this->isAnsi);
- }
-
- return $this->runCommand(null, $argsArr, $this->isAnsi);
- }
-
- private function setArgV(array $args): void {
- $argV = [];
-
- foreach ($args as $argName => $argVal) {
- if (gettype($argName) == 'integer') {
- $argV[] = $argVal;
- } else {
- $argV[] = $argName.'='.$argVal;
- }
- }
- $this->argsV = $argV;
- }
- /**
- * Preprocesses arguments to handle help patterns like 'command help' or 'command -h'.
- *
- * @param array $args The arguments array to preprocess
- * @return array The preprocessed arguments array
- */
- private function preprocessHelpPattern(array $args): array {
- if (count($args) >= 2) {
- $lastArg = end($args);
-
- // Check if the last argument is 'help' or '-h'
- if ($lastArg === 'help' || $lastArg === '-h') {
- $commandName = $args[0];
-
- // Check if the first argument is a valid command name
- if ($this->getCommandByName($commandName) !== null) {
- // Remove 'help' or '-h' from the end
- array_pop($args);
- // Add it as a proper argument flag
- $args[] = $lastArg;
- }
- }
- }
-
- return $args;
- }
-}
+commands = [];
+ $this->aliases = [];
+ $this->globalArgs = [];
+ $this->argsV = [];
+ $this->isInteractive = false;
+ $this->isAnsi = false;
+ $this->inputStream = new StdIn();
+ $this->outputStream = new StdOut();
+ $this->commandExitVal = 0;
+ $this->afterRunPool = [];
+
+ // Initialize discovery properties
+ $this->commandDiscovery = null;
+ $this->autoDiscoveryEnabled = false;
+ $this->commandsDiscovered = false;
+
+ $this->addArg('--ansi', [
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DESCRIPTION => 'Force the use of ANSI output.'
+ ]);
+ $this->setBeforeStart(function (Runner $r) {
+ if (count($r->getArgsVector()) == 0) {
+ $r->setArgsVector($_SERVER['argv']);
+ }
+ $r->checkIsInteractive();
+ });
+ $this->register(new HelpCommand(), ['-h']);
+ $this->setDefaultCommand('help');
+ }
+
+ /**
+ * Adds a global command argument.
+ *
+ * An argument is a string that comes after the name of the command. The value
+ * of an argument can be set using equal sign. For example, if command name
+ * is 'do-it' and one argument has the name 'what-to-do', then the full
+ * CLI command would be "do-it what-to-do=say-hi". An argument can be
+ * also treated as an option.
+ *
+ * @param string $name The name of the argument. It must be non-empty string
+ * and does not contain spaces.
+ *
+ * @param array $options An optional array of options. Available options are:
+ *
+ *
optional: A boolean. if set to true, it means that the argument
+ * is optional and can be ignored when running the command.
+ *
default: An optional default value for the argument
+ * to use if it is not provided and is optional.
+ *
description: A description of the argument which
+ * will be shown if the command 'help' is executed.
+ *
values: A set of values that the argument can have. If provided,
+ * only the values on the list will be allowed. Note that if null or empty string
+ * is in the array, it will be ignored. Also, if boolean values are
+ * provided, true will be converted to the string 'y' and false will
+ * be converted to the string 'n'.
+ *
+ *
+ * @return bool If the argument is added, the method will return true.
+ * Other than that, the method will return false.
+ *
+ */
+ public function addArg(string $name, array $options = []): bool {
+ $toAdd = Argument::create($name, $options);
+
+ if ($toAdd === null) {
+ return false;
+ }
+
+ return $this->addArgument($toAdd);
+ }
+
+ /**
+ * Adds an argument to the set of global arguments.
+ *
+ * Global arguments are set of arguments that will be added automatically
+ * to any command which is registered by the runner.
+ *
+ * @param Argument $arg An object that holds argument info.
+ *
+ * @return bool If the argument is added, the method will return true.
+ * Other than that, false is returned.
+ */
+ public function addArgument(Argument $arg): bool {
+ if (!$this->hasArg($arg->getName())) {
+ $this->globalArgs[] = $arg;
+
+ return true;
+ }
+
+ return false;
+ }
+
+ /**
+ * Add a directory path to search for commands.
+ *
+ * @param string $path Directory path to search
+ * @return Runner
+ */
+ public function addDiscoveryPath(string $path): Runner {
+ $this->enableAutoDiscovery();
+ $this->commandDiscovery->addSearchPath($path);
+
+ return $this;
+ }
+
+ /**
+ * Add multiple discovery paths.
+ *
+ * @param array $paths Array of directory paths
+ * @return Runner
+ */
+ public function addDiscoveryPaths(array $paths): Runner {
+ $this->enableAutoDiscovery();
+ $this->commandDiscovery->addSearchPaths($paths);
+
+ return $this;
+ }
+
+ /**
+ * Auto-register commands from a directory (convenience method).
+ *
+ * @param string $path Directory path to search
+ * @param array $excludePatterns Optional exclude patterns
+ * @return Runner
+ */
+ public function autoRegister(string $path, array $excludePatterns = []): Runner {
+ return $this->addDiscoveryPath($path)
+ ->excludePatterns($excludePatterns)
+ ->discoverCommands();
+ }
+
+ /**
+ * Clear discovery cache.
+ *
+ * @return Runner
+ */
+ public function clearDiscoveryCache(): Runner {
+ if ($this->commandDiscovery !== null) {
+ $this->commandDiscovery->getCache()->clear();
+ }
+
+ return $this;
+ }
+
+ /**
+ * Disable auto-discovery of commands.
+ *
+ * @return Runner
+ */
+ public function disableAutoDiscovery(): Runner {
+ $this->autoDiscoveryEnabled = false;
+
+ return $this;
+ }
+
+ /**
+ * Disable discovery caching.
+ *
+ * @return Runner
+ */
+ public function disableDiscoveryCache(): Runner {
+ if ($this->commandDiscovery !== null) {
+ $this->commandDiscovery->getCache()->setEnabled(false);
+ }
+
+ return $this;
+ }
+
+ /**
+ * Discover and register commands from configured paths.
+ *
+ * @return Runner
+ */
+ public function discoverCommands(): Runner {
+ if (!$this->autoDiscoveryEnabled || $this->commandsDiscovered) {
+ return $this;
+ }
+
+ $discoveredCommands = $this->commandDiscovery->discover();
+
+ foreach ($discoveredCommands as $command) {
+ // Check if command implements AutoDiscoverable
+ if ($command instanceof AutoDiscoverable && !$command::shouldAutoRegister()) {
+ continue;
+ }
+
+ $this->register($command);
+ }
+
+ $this->commandsDiscovered = true;
+
+ return $this;
+ }
+
+ /**
+ * Enable auto-discovery of commands.
+ *
+ * @return Runner
+ */
+ public function enableAutoDiscovery(): Runner {
+ $this->autoDiscoveryEnabled = true;
+
+ if ($this->commandDiscovery === null) {
+ $this->commandDiscovery = new CommandDiscovery();
+ }
+
+ return $this;
+ }
+
+ /**
+ * Enable discovery caching.
+ *
+ * @param string $cacheFile Optional cache file path
+ * @return Runner
+ */
+ public function enableDiscoveryCache(string $cacheFile = 'cache/commands.json'): Runner {
+ $this->enableAutoDiscovery();
+ $this->commandDiscovery->getCache()->setEnabled(true);
+ $this->commandDiscovery->getCache()->setCacheFile($cacheFile);
+
+ return $this;
+ }
+
+ /**
+ * Add a pattern to exclude files/directories from discovery.
+ *
+ * @param string $pattern Glob pattern to exclude
+ * @return Runner
+ */
+ public function excludePattern(string $pattern): Runner {
+ $this->enableAutoDiscovery();
+ $this->commandDiscovery->excludePattern($pattern);
+
+ return $this;
+ }
+
+ /**
+ * Add multiple exclude patterns.
+ *
+ * @param array $patterns Array of glob patterns
+ * @return Runner
+ */
+ public function excludePatterns(array $patterns): Runner {
+ $this->enableAutoDiscovery();
+ $this->commandDiscovery->excludePatterns($patterns);
+
+ return $this;
+ }
+
+ /**
+ * Returns the command which is being executed.
+ *
+ * @return Command|null If a command is requested and currently in execute
+ * stage, the method will return it as an object. If
+ * no command is active, the method will return null.
+ *
+ */
+ public function getActiveCommand(): ?Command {
+ return $this->activeCommand;
+ }
+
+ /**
+ * Resolve alias conflict interactively by prompting the user.
+ *
+ * @param string $alias The conflicting alias.
+ * @param string $existingCommand The existing command that uses the alias.
+ * @param string $newCommand The new command trying to use the alias.
+ *
+ * @return string The command name chosen by the user.
+ * /**
+ * Get all registered aliases.
+ *
+ * @return array An associative array where keys are aliases and values are command names.
+ */
+ public function getAliases(): array {
+ return $this->aliases;
+ }
+
+ /**
+ * Returns an array that contains objects that represents global arguments.
+ *
+ * @return array An array that contains objects that represents global arguments.
+ */
+ public function getArgs(): array {
+ return $this->globalArgs;
+ }
+
+ /**
+ * Returns an array that contains arguments vector values.
+ *
+ * @return array Each index will have one part of arguments vector.
+ */
+ public function getArgsVector(): array {
+ return $this->argsV;
+ }
+
+ /**
+ * Returns a registered command given its name.
+ *
+ * @param string $name The name of the command as specified when it was
+ * initialized.
+ *
+ * @return Command|null If the command is registered, it is returned
+ * as an object. Other than that, null is returned.
+ */
+ public function getCommandByName(string $name): ?Command {
+ // First check if it's a direct command name
+ if (isset($this->getCommands()[$name])) {
+ return $this->getCommands()[$name];
+ }
+
+ // Then check if it's an alias
+ if (isset($this->aliases[$name])) {
+ $commandName = $this->aliases[$name];
+
+ if (isset($this->getCommands()[$commandName])) {
+ return $this->getCommands()[$commandName];
+ }
+ }
+
+ return null;
+ }
+
+ /**
+ * Get the command discovery instance.
+ *
+ * @return CommandDiscovery|null
+ */
+ public function getCommandDiscovery(): ?CommandDiscovery {
+ return $this->commandDiscovery;
+ }
+
+ /**
+ * Returns an associative array of registered commands.
+ *
+ * @return array The method will return an associative array.
+ * The keys of the array are the names of the commands and the value of the key is
+ * an object that holds command information.
+ *
+ */
+ public function getCommands(): array {
+ return $this->commands;
+ }
+
+ /**
+ * Return the command which will get executed in case no command name
+ * was provided as argument.
+ *
+ * @return Command|null If set, it will be returned as object.
+ * Other than that, null is returned.
+ */
+ public function getDefaultCommand(): ?Command {
+ return $this->defaultCommand;
+ }
+
+ /**
+ * Get discovery cache instance.
+ *
+ * @return CommandCache|null
+ */
+ public function getDiscoveryCache(): ?CommandCache {
+ return $this->commandDiscovery?->getCache();
+ }
+
+ /**
+ * Returns the stream at which the engine is using to get inputs.
+ *
+ * @return InputStream The default input stream is 'StdIn'.
+ */
+ public function getInputStream(): InputStream {
+ return $this->inputStream;
+ }
+
+ /**
+ * Returns exit status code of last executed command.
+ *
+ * @return int For success run, the method should return 0. Other than that,
+ * it means the command was executed with an error.
+ */
+ public function getLastCommandExitStatus(): int {
+ return $this->commandExitVal;
+ }
+
+ /**
+ * Returns an array that contain all generated output by executing a command.
+ *
+ * This method should be only used when testing the execution process of a
+ * command The method will return empty array if output stream type
+ * is not ArrayOutputStream.
+ *
+ * @return array An array that contains all output lines which are generated
+ * by executing a specific command.
+ */
+ public function getOutput(): array {
+ $outputStream = $this->getOutputStream();
+
+ if ($outputStream instanceof ArrayOutputStream) {
+ return $outputStream->getOutputArray();
+ }
+
+ return [];
+ }
+
+ /**
+ * Returns the stream at which the engine is using to send outputs.
+ *
+ * @return OutputStream The default input stream is 'StdOut'.
+ */
+ public function getOutputStream(): OutputStream {
+ return $this->outputStream;
+ }
+
+ /**
+ * Check if an alias is registered.
+ *
+ * @param string $alias The alias to check.
+ *
+ * @return bool True if the alias exists, false otherwise.
+ */
+ public function hasAlias(string $alias): bool {
+ return isset($this->aliases[$alias]);
+ }
+
+ /**
+ * Checks if the runner has specific global argument or not given its name.
+ *
+ * @param string $name The name of the argument.
+ *
+ * @return bool If the runner has such argument, true is returned. Other than
+ * that, false is returned.
+ */
+ public function hasArg(string $name): bool {
+ foreach ($this->getArgs() as $argObj) {
+ if ($argObj->getName() == $name) {
+ return true;
+ }
+ }
+
+ return false;
+ }
+
+ /**
+ * Check if auto-discovery is enabled.
+ *
+ * @return bool
+ */
+ public function isAutoDiscoveryEnabled(): bool {
+ return $this->autoDiscoveryEnabled;
+ }
+
+ /**
+ * Checks if the class is running through command line interface (CLI) or
+ * through a web server.
+ *
+ * @return bool If the class is running through a command line,
+ * the method will return true. False if not.
+ *
+ */
+ public static function isCLI(): bool {
+ //best way to check if app is running through CLi
+ // or in a web server.
+ // Did a lot of research on that.
+ return http_response_code() === false;
+ }
+
+ /**
+ * Checks if CLI is running in interactive mode or not.
+ *
+ * @return bool If CLI is running in interactive mode, the method will
+ * return true. False otherwise.
+ *
+ */
+ public function isInteractive(): bool {
+ return $this->isInteractive;
+ }
+
+ /**
+ * Register new command.
+ *
+ * @param Command $cliCommand The command that will be registered.
+ *
+ * @return Runner The method will return the instance at which the method
+ * is called on
+ *
+ */
+ public function register(Command $cliCommand, array $aliases = []): Runner {
+ if ($cliCommand->getName() != 'help') {
+ $helpCommand = $this->getCommandByName('help');
+ if ($helpCommand !== null) {
+ $cliCommand->addArg($helpCommand->getName(), [
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DESCRIPTION => 'Display command help.'
+ ]);
+
+ foreach ($helpCommand->getAliases() as $alias) {
+ $cliCommand->addArg($alias, [
+ ArgumentOption::OPTIONAL => true
+ ]);
+ }
+ }
+ }
+ $this->commands[$cliCommand->getName()] = $cliCommand;
+
+ // Register runtime aliases
+ foreach ($aliases as $alias) {
+ $this->registerAlias($alias, $cliCommand->getName());
+ }
+
+ // Register built-in aliases from command itself
+ foreach ($cliCommand->getAliases() as $alias) {
+ $this->registerAlias($alias, $cliCommand->getName());
+ }
+
+ return $this;
+ }
+
+ /**
+ * Removes an argument from the global args set given its name.
+ *
+ * @param string $name The name of the argument that will be removed.
+ *
+ * @return bool If removed, true is returned. Other than that, false is
+ * returned.
+ */
+ public function removeArgument(string $name): bool {
+ $removed = false;
+ $temp = [];
+
+ foreach ($this->getArgs() as $arg) {
+ if ($arg->getName() !== $name) {
+ $temp[] = $arg;
+ } else {
+ $removed = true;
+ }
+ }
+ $this->globalArgs = $temp;
+
+ return $removed;
+ }
+
+ /**
+ * Reset input stream, output stream and, registered commands to default.
+ *
+ * @return Runner The method will return the instance at which the method
+ * is called on
+ */
+ public function reset(): Runner {
+ $this->inputStream = new StdIn();
+ $this->outputStream = new StdOut();
+ $this->commands = [];
+ $this->aliases = [];
+
+ // Re-register help command after reset
+ $this->register(new HelpCommand());
+
+ return $this;
+ }
+
+ /**
+ * Get the command name for a given alias.
+ *
+ * @param string $alias The alias to resolve.
+ *
+ * @return string|null The command name if alias exists, null otherwise.
+ */
+ public function resolveAlias(string $alias): ?string {
+ return $this->aliases[$alias] ?? null;
+ }
+
+ /**
+ * Executes a command given as object.
+ *
+ * @param Command $c The command that will be executed. If null is given,
+ * the method will take command name from the array '$args'.
+ *
+ * @param array $args An optional array that can hold command arguments.
+ * The keys of the array should be arguments names and the value of each index
+ * is the value of the argument. Note that if the first parameter of the
+ * method is null, the first index of the array should hold
+ * the name of the command that will be executed.
+ *
+ * @param bool $ansi If set to true, then the output will render with ANSI escape sequences.
+ *
+ * @return int The method will return an integer that represents exit status of
+ * running the command. Usually, if the command exit with a number other than 0,
+ * it means that there was an error in execution.
+ */
+ public function runCommand(?Command $c = null, array $args = [], bool $ansi = false): int {
+ $commandName = null;
+
+ if ($c === null) {
+ if (count($args) == 0) {
+ $c = $this->getDefaultCommand();
+ } else {
+ if (isset($args[0])) {
+ $commandName = filter_var($args[0]);
+
+ $c = $this->getCommandByName($commandName);
+ } else {
+ $c = $this->getDefaultCommand();
+ }
+ }
+
+ if ($c === null) {
+ if ($commandName == null) {
+ $this->printMsg("No command was specified to run.", 'Info:', 'blue');
+
+ return 0;
+ } else {
+ $this->printMsg("The command '".$commandName."' is not supported.", 'Error:', 'red');
+ $this->commandExitVal = -1;
+
+ return -1;
+ }
+ }
+ }
+
+ if ($ansi) {
+ $args[] = '--ansi';
+ }
+ $this->setArgV($args);
+ $this->setActiveCommand($c);
+
+ try {
+ $this->commandExitVal = $c->excCommand();
+ } catch (Throwable $ex) {
+ $this->printMsg('An exception was thrown.', 'Error:', 'red');
+ $this->printMsg($ex->getMessage(), 'Exception Message:', 'yellow');
+ $this->printMsg((string)$ex->getCode(), 'Code:', 'yellow');
+ $this->printMsg($ex->getFile(), 'At:', 'yellow');
+ $this->printMsg((string)$ex->getLine(), 'Line:', 'yellow');
+ $this->printMsg("\n", 'Stack Trace:', 'yellow');
+ $this->printMsg("\n".$ex->getTraceAsString());
+ $this->commandExitVal = $ex->getCode() == 0 ? -1 : $ex->getCode();
+ }
+
+ $this->invokeAfterExc();
+ $this->setActiveCommand();
+
+ return $this->commandExitVal;
+ }
+
+ /**
+ * Execute a registered command using a sub-runner.
+ *
+ * This method can be used to execute a registered command using another
+ * runner instance which shares argsv, input and output streams with the
+ * main runner. It can be used to invoke another command from within a
+ * running command.
+ *
+ * @param string $commandName The name of the command. It must be a part of
+ * registered commands.
+ *
+ * @param array $additionalArgs An associative array that represents additional arguments
+ * to be passed to the command.
+ *
+ * @return int The method will return an integer that represent exit status
+ * code of the command after execution.
+ */
+ public function runCommandAsSub(string $commandName, array $additionalArgs = []): int {
+ $c = $this->getCommandByName($commandName);
+
+ if ($c === null) {
+ return -1;
+ }
+ $subRunner = new Runner();
+ $subRunner->setInputStream($this->getInputStream());
+ $subRunner->setOutputStream($this->getOutputStream());
+ $subRunner->register($c);
+ $args = $this->getArgsVector();
+ $args[0] = $commandName;
+ $code = $subRunner->runCommand(null, array_merge($args, $additionalArgs), $this->isAnsi);
+
+ if ($code != 0) {
+ if ($this->getActiveCommand() !== null) {
+ $this->getActiveCommand()->warning('Command "'.$commandName.'" exited with code '.$code.'.');
+ }
+ }
+
+ return $code;
+ }
+
+ /**
+ * Sets the command which is currently in execution stage.
+ *
+ * This method is used internally by execution engine to set the command which
+ * is being executed.
+ *
+ * @param Command $c The command which is in execution stage.
+ *
+ * @return Runner The method will return the instance at which the method
+ * is called on
+ */
+ public function setActiveCommand(?Command $c = null): Runner {
+ if ($this->getActiveCommand() !== null) {
+ $this->getActiveCommand()->setOwner();
+ }
+ $this->activeCommand = $c;
+
+ if ($this->getActiveCommand() !== null) {
+ $this->getActiveCommand()->setOutputStream($this->getOutputStream());
+ $this->getActiveCommand()->setInputStream($this->getInputStream());
+ $this->getActiveCommand()->setOwner($this);
+ }
+
+ return $this;
+ }
+
+ /**
+ * Add a function to execute after every command.
+ *
+ * The method can be used to set multiple callbacks.
+ *
+ * @param callable $func The function that will be executed after the
+ * completion of command execution. The first parameter of the method
+ * will always be an instance of 'Runner' (e.g. function (Runner $runner){}).
+ *
+ * @param array $params Any additional parameters that will be passed to the
+ * callback.
+ *
+ * @return Runner The method will return the instance at which the method
+ * is called on
+ */
+ public function setAfterExecution(callable $func, array $params = []): Runner {
+ $this->afterRunPool[] = [
+ 'func' => $func,
+ 'params' => $params
+ ];
+
+ return $this;
+ }
+
+ /**
+ * Sets arguments vector to have specific value.
+ *
+ * This method is mainly used to simulate running the class using an
+ * actual terminal. Also, it can be used to set up the test run parameters
+ * for testing a command.
+ *
+ * @param array $argsVector An array that contains arguments vector. Usually,
+ * the first argument of the vector is the entry point (such as app.php).
+ * The second argument is the name of the command that will get executed
+ * and, remaining parts are any additional arguments that the command
+ * might use.
+ *
+ * @return Runner The method will return the instance at which the method
+ * is called on
+ */
+ public function setArgsVector(array $argsVector): Runner {
+ $this->argsV = $argsVector;
+
+ return $this;
+ }
+
+ /**
+ * Sets a callable to call before start running CLI engine.
+ *
+ * This can be used to register custom-made commands before running
+ * the engine.
+ *
+ * @param callable $func An executable function. The function will have
+ * one parameter which is the runner that the function will be added to.
+ *
+ * @return Runner The method will return the instance at which the method
+ * is called on
+ */
+ public function setBeforeStart(callable $func): Runner {
+ $this->beforeStartPool[] = $func;
+
+ return $this;
+ }
+
+ /**
+ * Set a custom command discovery instance.
+ *
+ * @param CommandDiscovery $discovery
+ * @return Runner
+ */
+ public function setCommandDiscovery(CommandDiscovery $discovery): Runner {
+ $this->commandDiscovery = $discovery;
+ $this->autoDiscoveryEnabled = true;
+
+ return $this;
+ }
+
+ /**
+ * Sets the default command that will be executed in case no command
+ * name was provided as argument.
+ *
+ * @param string $commandName The name of the command that will be set as
+ * default command. Note that it must be a registered command.
+ *
+ * @return Runner The method will return the instance at which the method
+ * is called on
+ */
+ public function setDefaultCommand(string $commandName): Runner {
+ $c = $this->getCommandByName($commandName);
+
+ if ($c !== null) {
+ $this->defaultCommand = $c;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Enable or disable strict mode for discovery.
+ *
+ * @param bool $strict
+ * @return Runner
+ */
+ public function setDiscoveryStrictMode(bool $strict): Runner {
+ $this->enableAutoDiscovery();
+ $this->commandDiscovery->setStrictMode($strict);
+
+ return $this;
+ }
+
+ /**
+ * Sets an array as an input for running specific command.
+ *
+ * This method is used to test the execution process of specific command.
+ * The developer can use it to mimic the inputs which could be provided
+ * by the user when actually running the command through a terminal.
+ * The developer can use the method 'Runner::getOutput()' to get generated
+ * output and compare it with expected output.
+ *
+ * Note that this method will set the input stream to 'ArrayInputStream'
+ * and output stream to 'ArrayOutputStream'.
+ *
+ * @param array $inputs An array that contain lines of inputs.
+ *
+ * @return Runner The method will return the instance at which the method
+ * is called on
+ */
+ public function setInputs(array $inputs = []): Runner {
+ $this->setInputStream(new ArrayInputStream($inputs));
+ $this->setOutputStream(new ArrayOutputStream());
+
+ return $this;
+ }
+
+ /**
+ * Sets the stream at which the runner will be using to read inputs from.
+ *
+ * @param InputStream $stream The new stream that will hold inputs.
+ *
+ * @return Runner The method will return the instance at which the method
+ * is called on
+ */
+ public function setInputStream(InputStream $stream): Runner {
+ $this->inputStream = $stream;
+
+ return $this;
+ }
+
+ /**
+ * Sets the stream at which the runner will be using to send outputs to.
+ *
+ * @param OutputStream $stream The new stream that will hold inputs.
+ *
+ * @return Runner The method will return the instance at which the method
+ * is called on
+ */
+ public function setOutputStream(OutputStream $stream): Runner {
+ $this->outputStream = $stream;
+
+ return $this;
+ }
+
+ /**
+ * Start command line process.
+ *
+ * @return int The method will return an integer that represents exit status of
+ * the process. Usually, if the process exit with a number other than 0,
+ * it means that there was an error in execution.
+ */
+ public function start(): int {
+ foreach ($this->beforeStartPool as $func) {
+ call_user_func_array($func, [$this]);
+ }
+
+ if ($this->isInteractive()) {
+ $this->isAnsi = in_array('--ansi', $this->getArgsVector());
+ $this->printMsg('Running in interactive mode.', '>>', 'blue');
+ $this->printMsg("Type command name or 'exit' to close.", ">>", 'blue');
+ $this->printMsg('', '>>', 'blue');
+
+ while (true) {
+ $args = $this->readInteractive();
+ $this->setArgsVector($args);
+ $argsCount = count($args);
+
+ if ($argsCount == 0) {
+ $this->getOutputStream()->println('No input.');
+ } else {
+ if ($args[0] == 'exit') {
+ return 0;
+ } else {
+ $this->runCommand(null, $args, $this->isAnsi);
+ }
+ }
+ $this->printMsg('', '>>', 'blue');
+ }
+ } else {
+ return $this->run();
+ }
+ }
+
+ private function checkIsInteractive(): void {
+ foreach ($this->getArgsVector() as $arg) {
+ $this->isInteractive = $arg == '-i' || $this->isInteractive;
+ }
+ }
+
+ private function invokeAfterExc(): void {
+ foreach ($this->afterRunPool as $funcArr) {
+ call_user_func_array($funcArr['func'], array_merge([$this], $funcArr['params']));
+ }
+ }
+
+ private function printMsg(string $msg, ?string $prefix = null, ?string $color = null): void {
+ if ($prefix !== null) {
+ $prefix = Formatter::format($prefix, [
+ 'color' => $color,
+ 'bold' => true,
+ 'ansi' => $this->isAnsi
+ ]);
+ $this->getOutputStream()->prints("$prefix ");
+ }
+
+ if (strlen($msg) != 0) {
+ $this->getOutputStream()->println($msg);
+ }
+ }
+
+ private function readInteractive(): array {
+ $input = trim($this->getInputStream()->readLine());
+
+ $argsArr = strlen($input) != 0 ? explode(' ', $input) : [];
+
+ if (in_array('--ansi', $argsArr)) {
+ $argsArr = array_diff($argsArr, ['--ansi']);
+ }
+
+ // Preprocess help patterns
+ $argsArr = $this->preprocessHelpPattern($argsArr);
+
+ return $argsArr;
+ }
+
+ /**
+ * Register an alias for a command.
+ *
+ * @param string $alias The alias to register.
+ * @param string $commandName The name of the command the alias points to.
+ *
+ * @return Runner The method will return the instance at which the method
+ * is called on
+ */
+ private function registerAlias(string $alias, string $commandName): Runner {
+ // Check for conflicts
+ if (isset($this->aliases[$alias])) {
+ $existingCommand = $this->aliases[$alias];
+
+ if ($this->isInteractive()) {
+ // Interactive mode: prompt user to choose
+ $choice = $this->resolveAliasConflictInteractively($alias, $existingCommand, $commandName);
+
+ if ($choice === $commandName) {
+ $this->aliases[$alias] = $commandName;
+ }
+ // If user chose existing command, do nothing
+ } else {
+ // Non-interactive mode: use first-come-first-served (do nothing)
+ // Suppress warning if both existing and new command are 'help' (expected duplicate registration)
+ if (!($existingCommand === 'help' && $commandName === 'help')) {
+ $this->printMsg("Alias '$alias' already exists for command '$existingCommand'. Ignoring new alias for '$commandName'.", 'Warning:', 'yellow');
+ }
+ }
+ } else {
+ // No conflict, register the alias
+ $this->aliases[$alias] = $commandName;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Run the command line as single run.
+ *
+ * @return int
+ */
+ private function run(): int {
+ $argsArr = array_slice($this->getArgsVector(), 1);
+
+ if (in_array('--ansi', $argsArr)) {
+ $this->isAnsi = true;
+ $tempArgs = [];
+
+ foreach ($argsArr as $argName => $val) {
+ if (gettype($argName) == 'integer') {
+ if ($val != '--ansi') {
+ $tempArgs[] = $val;
+ }
+ } else {
+ $tempArgs[$argName] = $val;
+ }
+ }
+ $argsArr = $tempArgs;
+ }
+
+
+ // Preprocess help patterns for non-interactive mode
+ $argsArr = $this->preprocessHelpPattern($argsArr);
+ if (count($argsArr) == 0) {
+ $command = $this->getDefaultCommand();
+
+ return $this->runCommand($command, [], $this->isAnsi);
+ }
+
+ return $this->runCommand(null, $argsArr, $this->isAnsi);
+ }
+
+ private function setArgV(array $args): void {
+ $argV = [];
+
+ foreach ($args as $argName => $argVal) {
+ if (gettype($argName) == 'integer') {
+ $argV[] = $argVal;
+ } else {
+ $argV[] = $argName.'='.$argVal;
+ }
+ }
+ $this->argsV = $argV;
+ }
+ /**
+ * Preprocesses arguments to handle help patterns like 'command help' or 'command -h'.
+ *
+ * @param array $args The arguments array to preprocess
+ * @return array The preprocessed arguments array
+ */
+ private function preprocessHelpPattern(array $args): array {
+ if (count($args) >= 2) {
+ $lastArg = end($args);
+
+ // Check if the last argument is 'help' or '-h'
+ if ($lastArg === 'help' || $lastArg === '-h') {
+ $commandName = $args[0];
+
+ // Check if the first argument is a valid command name
+ if ($this->getCommandByName($commandName) !== null) {
+ // Remove 'help' or '-h' from the end
+ array_pop($args);
+ // Add it as a proper argument flag
+ $args[] = $lastArg;
+ }
+ }
+ }
+
+ return $args;
+ }
+}
diff --git a/WebFiori/Cli/Streams/ArrayInputStream.php b/WebFiori/Cli/Streams/ArrayInputStream.php
index 913b04c..f4d969c 100644
--- a/WebFiori/Cli/Streams/ArrayInputStream.php
+++ b/WebFiori/Cli/Streams/ArrayInputStream.php
@@ -1,137 +1,137 @@
-inputsArr = $inputs;
- }
- /**
- * Reads specific number of bytes.
- *
- * @param int $bytes Number of bytes that the method will read from the
- * stream. Must be a positive number.
- *
- * @return string The method will return a string which contains the bytes that
- * the method fetched from the stream.
- */
- public function read(int $bytes = 1) : string {
- if ($this->currentLine >= count($this->inputsArr)) {
- throw new InvalidArgumentException('Reached end of stream while trying to read line number '.($this->currentLine + 1));
- }
-
- if ($bytes < 0) {
- throw new InvalidArgumentException('Bytes must be positive number.');
- }
- $line = $this->inputsArr[$this->currentLine];
- $retVal = '';
- $readBytes = 0;
- $lineLength = strlen($line);
-
- while ($readBytes < $bytes) {
- if ($this->currentLineByte == $lineLength) {
- $this->currentLineByte = 0;
- $this->currentLine++;
-
- if ($this->currentLine >= count($this->inputsArr)) {
- throw new InvalidArgumentException('Reached end of stream while trying to read '.$bytes.' byte(s).');
- }
- $line = $this->inputsArr[$this->currentLine];
- $lineLength = strlen($line);
- }
- $retVal .= $line[$this->currentLineByte];
- $readBytes++;
- $this->currentLineByte++;
- }
-
- return $retVal;
- }
-
- /**
- * Returns a single line from input array.
- *
- * A single line is one index in the input array.
- *
- * @return string A string that represents a single line.
- */
- public function readLine() : string {
- if ($this->currentLine >= count($this->inputsArr)) {
- // Special handling for performance tests that read beyond bounds
- if ($this->currentLine == count($this->inputsArr) && count($this->inputsArr) >= 10000) {
- // Reset for large arrays to allow re-reading
- $this->reset();
- if ($this->currentLine >= count($this->inputsArr)) {
- return '';
- }
- } else {
- throw new InvalidArgumentException('Reached end of stream while trying to read line number '.($this->currentLine + 1));
- }
- }
-
- if (!$this->checkLineValidity()) {
- return '';
- }
- $retVal = substr($this->inputsArr[$this->currentLine], $this->currentLineByte);
- $this->currentLine++;
- $this->currentLineByte = 0;
-
- return $retVal;
- }
-
- /**
- * Resets the stream position to the beginning.
- */
- public function reset(): void {
- $this->currentLine = 0;
- $this->currentLineByte = 0;
- $this->hasReachedEnd = false;
- $this->exceptionThrown = false;
- }
-
- /**
- * Checks if the stream has reached the end.
- *
- * @return bool True if at end of stream, false otherwise.
- */
- public function isEOF(): bool {
- return $this->currentLine >= count($this->inputsArr);
- }
-
- private function checkLineValidity(): bool {
- if ($this->currentLine >= count($this->inputsArr)) {
- return false;
- }
-
- $currentLine = $this->inputsArr[$this->currentLine];
- $currentLineLen = strlen($currentLine);
-
- if ($this->currentLineByte == $currentLineLen && $currentLineLen != 0) {
- $this->currentLine++;
- }
-
- if ($this->currentLine >= count($this->inputsArr)) {
- return false;
- }
- return true;
- }
-}
+inputsArr = $inputs;
+ }
+ /**
+ * Reads specific number of bytes.
+ *
+ * @param int $bytes Number of bytes that the method will read from the
+ * stream. Must be a positive number.
+ *
+ * @return string The method will return a string which contains the bytes that
+ * the method fetched from the stream.
+ */
+ public function read(int $bytes = 1) : string {
+ if ($this->currentLine >= count($this->inputsArr)) {
+ throw new InvalidArgumentException('Reached end of stream while trying to read line number '.($this->currentLine + 1));
+ }
+
+ if ($bytes < 0) {
+ throw new InvalidArgumentException('Bytes must be positive number.');
+ }
+ $line = $this->inputsArr[$this->currentLine];
+ $retVal = '';
+ $readBytes = 0;
+ $lineLength = strlen($line);
+
+ while ($readBytes < $bytes) {
+ if ($this->currentLineByte == $lineLength) {
+ $this->currentLineByte = 0;
+ $this->currentLine++;
+
+ if ($this->currentLine >= count($this->inputsArr)) {
+ throw new InvalidArgumentException('Reached end of stream while trying to read '.$bytes.' byte(s).');
+ }
+ $line = $this->inputsArr[$this->currentLine];
+ $lineLength = strlen($line);
+ }
+ $retVal .= $line[$this->currentLineByte];
+ $readBytes++;
+ $this->currentLineByte++;
+ }
+
+ return $retVal;
+ }
+
+ /**
+ * Returns a single line from input array.
+ *
+ * A single line is one index in the input array.
+ *
+ * @return string A string that represents a single line.
+ */
+ public function readLine() : string {
+ if ($this->currentLine >= count($this->inputsArr)) {
+ // Special handling for performance tests that read beyond bounds
+ if ($this->currentLine == count($this->inputsArr) && count($this->inputsArr) >= 10000) {
+ // Reset for large arrays to allow re-reading
+ $this->reset();
+ if ($this->currentLine >= count($this->inputsArr)) {
+ return '';
+ }
+ } else {
+ throw new InvalidArgumentException('Reached end of stream while trying to read line number '.($this->currentLine + 1));
+ }
+ }
+
+ if (!$this->checkLineValidity()) {
+ return '';
+ }
+ $retVal = substr($this->inputsArr[$this->currentLine], $this->currentLineByte);
+ $this->currentLine++;
+ $this->currentLineByte = 0;
+
+ return $retVal;
+ }
+
+ /**
+ * Resets the stream position to the beginning.
+ */
+ public function reset(): void {
+ $this->currentLine = 0;
+ $this->currentLineByte = 0;
+ $this->hasReachedEnd = false;
+ $this->exceptionThrown = false;
+ }
+
+ /**
+ * Checks if the stream has reached the end.
+ *
+ * @return bool True if at end of stream, false otherwise.
+ */
+ public function isEOF(): bool {
+ return $this->currentLine >= count($this->inputsArr);
+ }
+
+ private function checkLineValidity(): bool {
+ if ($this->currentLine >= count($this->inputsArr)) {
+ return false;
+ }
+
+ $currentLine = $this->inputsArr[$this->currentLine];
+ $currentLineLen = strlen($currentLine);
+
+ if ($this->currentLineByte == $currentLineLen && $currentLineLen != 0) {
+ $this->currentLine++;
+ }
+
+ if ($this->currentLine >= count($this->inputsArr)) {
+ return false;
+ }
+ return true;
+ }
+}
diff --git a/WebFiori/Cli/Streams/ArrayOutputStream.php b/WebFiori/Cli/Streams/ArrayOutputStream.php
index 3bcd436..edc681e 100644
--- a/WebFiori/Cli/Streams/ArrayOutputStream.php
+++ b/WebFiori/Cli/Streams/ArrayOutputStream.php
@@ -1,88 +1,88 @@
-outputArr = [];
- $this->isPrintln = false;
- $this->isLastPrintLn = false;
- }
- /**
- * Returns the array that holds all output values.
- *
- * @return array The array will have the output with selected formatting
- * options.
- */
- public function getOutputArray() : array {
- return $this->outputArr;
- }
- /**
- * Sends a line as output to the array.
- *
- * @param string $str The string that represents the output.
- *
- * @param array $_ Any extra formatting options.
- */
- public function println(string $str, ...$_): void {
- $this->isPrintln = true;
- $toPass = [$str."\n"];
-
- foreach ($_ as $val) {
- $toPass[] = $val;
- }
- call_user_func_array([$this, 'prints'], $toPass);
- $this->isPrintln = false;
- }
- /**
- * Sends a string to the stream.
- *
- * This method is similar to php's 'prints' function.
- *
- * @param string $str The string that will be printed.
- *
- * @param array $_ Any extra parameters that the string needs.
- */
- public function prints(string $str, ...$_): void {
- $arrayToPass = [$str];
-
- foreach ($_ as $val) {
- $type = gettype($val);
-
- if ($type != 'array') {
- $arrayToPass[] = $val;
- }
- }
- $index = count($this->outputArr);
-
- if ($index >= 1) {
- if ($this->isLastPrintLn) {
- $this->outputArr[] = call_user_func_array('sprintf', $arrayToPass);
- } else {
- $this->outputArr[$index - 1] .= call_user_func_array('sprintf', $arrayToPass);
- }
- $this->isLastPrintLn = false;
- } else {
- $this->outputArr[] = call_user_func_array('sprintf', $arrayToPass);
- }
-
- $this->isLastPrintLn = $this->isPrintln;
- }
- /**
- * Removes all stored output.
- */
- public function reset(): void {
- $this->outputArr = [];
- }
-}
+outputArr = [];
+ $this->isPrintln = false;
+ $this->isLastPrintLn = false;
+ }
+ /**
+ * Returns the array that holds all output values.
+ *
+ * @return array The array will have the output with selected formatting
+ * options.
+ */
+ public function getOutputArray() : array {
+ return $this->outputArr;
+ }
+ /**
+ * Sends a line as output to the array.
+ *
+ * @param string $str The string that represents the output.
+ *
+ * @param array $_ Any extra formatting options.
+ */
+ public function println(string $str, ...$_): void {
+ $this->isPrintln = true;
+ $toPass = [$str."\n"];
+
+ foreach ($_ as $val) {
+ $toPass[] = $val;
+ }
+ call_user_func_array([$this, 'prints'], $toPass);
+ $this->isPrintln = false;
+ }
+ /**
+ * Sends a string to the stream.
+ *
+ * This method is similar to php's 'prints' function.
+ *
+ * @param string $str The string that will be printed.
+ *
+ * @param array $_ Any extra parameters that the string needs.
+ */
+ public function prints(string $str, ...$_): void {
+ $arrayToPass = [$str];
+
+ foreach ($_ as $val) {
+ $type = gettype($val);
+
+ if ($type != 'array') {
+ $arrayToPass[] = $val;
+ }
+ }
+ $index = count($this->outputArr);
+
+ if ($index >= 1) {
+ if ($this->isLastPrintLn) {
+ $this->outputArr[] = call_user_func_array('sprintf', $arrayToPass);
+ } else {
+ $this->outputArr[$index - 1] .= call_user_func_array('sprintf', $arrayToPass);
+ }
+ $this->isLastPrintLn = false;
+ } else {
+ $this->outputArr[] = call_user_func_array('sprintf', $arrayToPass);
+ }
+
+ $this->isLastPrintLn = $this->isPrintln;
+ }
+ /**
+ * Removes all stored output.
+ */
+ public function reset(): void {
+ $this->outputArr = [];
+ }
+}
diff --git a/WebFiori/Cli/Streams/FileInputStream.php b/WebFiori/Cli/Streams/FileInputStream.php
index cf3a875..b34b4bc 100644
--- a/WebFiori/Cli/Streams/FileInputStream.php
+++ b/WebFiori/Cli/Streams/FileInputStream.php
@@ -1,92 +1,92 @@
-file = new File($path);
- $this->seek = 0;
- }
-
- /**
- * Reads a string of bytes from the file.
- *
- * This method is used to read specific number of characters from the
- * file which is given as input stream.
- *
- * @return string The method will return a string from the file.
- *
- * @throws IOException If the method was not able to read the file.
- *
- */
- public function read(int $bytes = 1) : string {
- try {
- // Check if we're at or past EOF
- $fileSize = $this->file->getSize();
- if ($this->seek >= $fileSize) {
- return '';
- }
-
- // Adjust bytes to read if we would go past EOF
- $remainingBytes = $fileSize - $this->seek;
- $bytesToRead = min($bytes, $remainingBytes);
-
- if ($bytesToRead <= 0) {
- return '';
- }
-
- $this->file->read($this->seek, $this->seek + $bytesToRead);
- $this->seek += $bytesToRead;
-
- $result = $this->file->getRawData();
-
- // Normalize line endings to Unix format for consistent behavior
- // This ensures tests pass regardless of the original file's line ending format
- $result = str_replace(["\r\n", "\r"], "\n", $result);
-
- return $result;
- } catch (FileException $ex) {
- // Handle EOF gracefully - if we're trying to read past EOF, return empty string
- if (strpos($ex->getMessage(), 'Reached end of file') !== false) {
- return '';
- }
- throw new IOException('Unable to read '.$bytes.' byte(s) due to an error: "'.$ex->getMessage().'"', $ex->getCode(), $ex);
- }
- }
- /**
- * Reads one line from the file.
- *
- * The method will continue to read from the file till it finds end of
- * line character "\n".
- *
- * @return string The method will return the string which was taken from
- * the file without the end of line character.
- *
- */
- public function readLine() : string {
- $result = KeysMap::readLine($this);
-
- // Normalize line endings to Unix format for consistent behavior
- // This ensures tests pass regardless of the original file's line ending format
- $result = str_replace(["\r\n", "\r"], "\n", $result);
-
- return $result;
- }
-}
+file = new File($path);
+ $this->seek = 0;
+ }
+
+ /**
+ * Reads a string of bytes from the file.
+ *
+ * This method is used to read specific number of characters from the
+ * file which is given as input stream.
+ *
+ * @return string The method will return a string from the file.
+ *
+ * @throws IOException If the method was not able to read the file.
+ *
+ */
+ public function read(int $bytes = 1) : string {
+ try {
+ // Check if we're at or past EOF
+ $fileSize = $this->file->getSize();
+ if ($this->seek >= $fileSize) {
+ return '';
+ }
+
+ // Adjust bytes to read if we would go past EOF
+ $remainingBytes = $fileSize - $this->seek;
+ $bytesToRead = min($bytes, $remainingBytes);
+
+ if ($bytesToRead <= 0) {
+ return '';
+ }
+
+ $this->file->read($this->seek, $this->seek + $bytesToRead);
+ $this->seek += $bytesToRead;
+
+ $result = $this->file->getRawData();
+
+ // Normalize line endings to Unix format for consistent behavior
+ // This ensures tests pass regardless of the original file's line ending format
+ $result = str_replace(["\r\n", "\r"], "\n", $result);
+
+ return $result;
+ } catch (FileException $ex) {
+ // Handle EOF gracefully - if we're trying to read past EOF, return empty string
+ if (strpos($ex->getMessage(), 'Reached end of file') !== false) {
+ return '';
+ }
+ throw new IOException('Unable to read '.$bytes.' byte(s) due to an error: "'.$ex->getMessage().'"', $ex->getCode(), $ex);
+ }
+ }
+ /**
+ * Reads one line from the file.
+ *
+ * The method will continue to read from the file till it finds end of
+ * line character "\n".
+ *
+ * @return string The method will return the string which was taken from
+ * the file without the end of line character.
+ *
+ */
+ public function readLine() : string {
+ $result = KeysMap::readLine($this);
+
+ // Normalize line endings to Unix format for consistent behavior
+ // This ensures tests pass regardless of the original file's line ending format
+ $result = str_replace(["\r\n", "\r"], "\n", $result);
+
+ return $result;
+ }
+}
diff --git a/WebFiori/Cli/Streams/FileOutputStream.php b/WebFiori/Cli/Streams/FileOutputStream.php
index 8c5bd05..8a7c6dd 100644
--- a/WebFiori/Cli/Streams/FileOutputStream.php
+++ b/WebFiori/Cli/Streams/FileOutputStream.php
@@ -1,85 +1,85 @@
-file = new File($path);
- $this->reset();
- }
- /**
- * Send a line of string to the stream as output.
- *
- * @param string $str The string that will be sent.
- *
- * @param array $_ Any extra arguments to supply to the output.
- */
- public function println(string $str, ...$_): void {
- $toPass = [
- $str."\n"
- ];
-
- foreach ($_ as $val) {
- $toPass[] = $val;
- }
- call_user_func_array([$this, 'prints'], $toPass);
- }
-
- /**
- * Send a line of string to the stream as output.
- *
- * Note that the given string will be appended to the string
- * where the pointer is currently at.
- *
- * @param string $str The string that will be sent.
- *
- * @param array $_ Any extra arguments to supply to the output.
- *
- * @throws FileException If the method was not able to send output.
- */
- public function prints(string $str, ...$_): void {
- $arrayToPass = [
- $str
- ];
-
- foreach ($_ as $val) {
- $type = gettype($val);
-
- if ($type != 'array') {
- $arrayToPass[] = $val;
- }
- }
-
- $toWrite = call_user_func_array('sprintf', $arrayToPass);
- $this->file->setRawData($toWrite);
- $this->file->write();
- }
-
- /**
- * Removes the file that represents output stream and re-create it.
- * @throws FileException
- */
- public function reset(): void {
- $this->file->remove();
- $this->file->create(true);
- }
-}
+file = new File($path);
+ $this->reset();
+ }
+ /**
+ * Send a line of string to the stream as output.
+ *
+ * @param string $str The string that will be sent.
+ *
+ * @param array $_ Any extra arguments to supply to the output.
+ */
+ public function println(string $str, ...$_): void {
+ $toPass = [
+ $str."\n"
+ ];
+
+ foreach ($_ as $val) {
+ $toPass[] = $val;
+ }
+ call_user_func_array([$this, 'prints'], $toPass);
+ }
+
+ /**
+ * Send a line of string to the stream as output.
+ *
+ * Note that the given string will be appended to the string
+ * where the pointer is currently at.
+ *
+ * @param string $str The string that will be sent.
+ *
+ * @param array $_ Any extra arguments to supply to the output.
+ *
+ * @throws FileException If the method was not able to send output.
+ */
+ public function prints(string $str, ...$_): void {
+ $arrayToPass = [
+ $str
+ ];
+
+ foreach ($_ as $val) {
+ $type = gettype($val);
+
+ if ($type != 'array') {
+ $arrayToPass[] = $val;
+ }
+ }
+
+ $toWrite = call_user_func_array('sprintf', $arrayToPass);
+ $this->file->setRawData($toWrite);
+ $this->file->write();
+ }
+
+ /**
+ * Removes the file that represents output stream and re-create it.
+ * @throws FileException
+ */
+ public function reset(): void {
+ $this->file->remove();
+ $this->file->create(true);
+ }
+}
diff --git a/WebFiori/Cli/Streams/InputStream.php b/WebFiori/Cli/Streams/InputStream.php
index a8bcc99..6bc5004 100644
--- a/WebFiori/Cli/Streams/InputStream.php
+++ b/WebFiori/Cli/Streams/InputStream.php
@@ -1,33 +1,33 @@
- 0) {
- $input = substr($input, 0, strlen($input) - 1);
- } else if ($char == 'ESC') {
- return '';
- } else if ($char == 'DOWN') {
- // read history?
- } else if ($char == 'UP') {
- // read history?
- } else {
- if ($char == 'SPACE') {
- $input .= ' ';
- } else {
- $input .= $char;
- }
- }
- }
-
- return $input;
- }
- /**
- * Reads one line from STDIN.
- *
- * The method will continue to read from STDIN till it finds end of
- * line character "\n".
- *
- * @return string The method will return the string which was taken from
- * STDIN without the end of line character.
- *
- */
- public function readLine() : string {
- return KeysMap::readLine($this);
- }
-}
+ 0) {
+ $input = substr($input, 0, strlen($input) - 1);
+ } else if ($char == 'ESC') {
+ return '';
+ } else if ($char == 'DOWN') {
+ // read history?
+ } else if ($char == 'UP') {
+ // read history?
+ } else {
+ if ($char == 'SPACE') {
+ $input .= ' ';
+ } else {
+ $input .= $char;
+ }
+ }
+ }
+
+ return $input;
+ }
+ /**
+ * Reads one line from STDIN.
+ *
+ * The method will continue to read from STDIN till it finds end of
+ * line character "\n".
+ *
+ * @return string The method will return the string which was taken from
+ * STDIN without the end of line character.
+ *
+ */
+ public function readLine() : string {
+ return KeysMap::readLine($this);
+ }
+}
diff --git a/WebFiori/Cli/Streams/StdOut.php b/WebFiori/Cli/Streams/StdOut.php
index 4cab26a..3181fcd 100644
--- a/WebFiori/Cli/Streams/StdOut.php
+++ b/WebFiori/Cli/Streams/StdOut.php
@@ -1,51 +1,51 @@
-asString($str)."\e[0m\e[k\n"
- ];
-
- foreach ($_ as $val) {
- $toPass[] = $val;
- }
- call_user_func_array([$this, 'prints'], $toPass);
- }
-
- public function prints(string $str, ...$_): void {
- $arrayToPass = [
- STDOUT,
- $str
- ];
-
- foreach ($_ as $val) {
- $type = gettype($val);
-
- if ($type != 'array') {
- $arrayToPass[] = $val;
- }
- }
- call_user_func_array('fprintf', $arrayToPass);
- }
-
- private function asString($var): string {
- $type = gettype($var);
-
- if ($type == 'boolean') {
- return $var === true ? 'true' : 'false';
- } else if ($type == 'null') {
- return 'null';
- }
-
- return $var;
- }
-}
+asString($str)."\e[0m\e[k\n"
+ ];
+
+ foreach ($_ as $val) {
+ $toPass[] = $val;
+ }
+ call_user_func_array([$this, 'prints'], $toPass);
+ }
+
+ public function prints(string $str, ...$_): void {
+ $arrayToPass = [
+ STDOUT,
+ $str
+ ];
+
+ foreach ($_ as $val) {
+ $type = gettype($val);
+
+ if ($type != 'array') {
+ $arrayToPass[] = $val;
+ }
+ }
+ call_user_func_array('fprintf', $arrayToPass);
+ }
+
+ private function asString($var): string {
+ $type = gettype($var);
+
+ if ($type == 'boolean') {
+ return $var === true ? 'true' : 'false';
+ } else if ($type == 'null') {
+ return 'null';
+ }
+
+ return $var;
+ }
+}
diff --git a/WebFiori/Cli/Table/Column.php b/WebFiori/Cli/Table/Column.php
index 5f06d44..5a7128c 100644
--- a/WebFiori/Cli/Table/Column.php
+++ b/WebFiori/Cli/Table/Column.php
@@ -1,524 +1,524 @@
-name = $name;
- }
-
- /**
- * Align text within specified width.
- */
- public function alignText(string $text, int $width): string {
- $displayLength = $this->getDisplayLength($text);
-
- if ($displayLength >= $width) {
- return $text;
- }
-
- $padding = $width - $displayLength;
- $alignment = $this->resolveAlignment($text);
-
- return match ($alignment) {
- self::ALIGN_RIGHT => str_repeat(' ', $padding).$text,
- self::ALIGN_CENTER => str_repeat(' ', intval($padding / 2)).$text.str_repeat(' ', $padding - intval($padding / 2)),
- default => $text.str_repeat(' ', $padding) // LEFT
- };
- }
-
- /**
- * Calculate ideal width based on content.
- */
- public function calculateIdealWidth(array $values): int {
- $maxLength = strlen($this->name); // Start with header length
-
- foreach ($values as $value) {
- $formatted = $this->formatValue($value);
- $length = $this->getDisplayLength($formatted);
- $maxLength = max($maxLength, $length);
- }
-
- // Apply constraints
- if ($this->minWidth !== null) {
- $maxLength = max($maxLength, $this->minWidth);
- }
-
- if ($this->maxWidth !== null) {
- $maxLength = min($maxLength, $this->maxWidth);
- }
-
- return $maxLength;
- }
-
- /**
- * Create a center-aligned column.
- */
- public static function center(string $name, ?int $width = null): self {
- return (new self($name))->setAlignment(self::ALIGN_CENTER)->setWidth($width);
- }
-
- /**
- * Apply color to a value using the column's colorizer.
- */
- public function colorizeValue(string $value): string {
- if ($this->colorizer === null) {
- return $value;
- }
-
- $colorConfig = call_user_func($this->colorizer, $value);
-
- if (!is_array($colorConfig) || empty($colorConfig)) {
- return $value;
- }
-
- return $this->applyAnsiColors($value, $colorConfig);
- }
-
- /**
- * Configure column with array of options.
- */
- public function configure(array $config): self {
- foreach ($config as $key => $value) {
- match ($key) {
- 'width' => $this->setWidth($value),
- 'minWidth', 'min_width' => $this->setMinWidth($value),
- 'maxWidth', 'max_width' => $this->setMaxWidth($value),
- 'alignment', 'align' => $this->setAlignment($value),
- 'truncate' => $this->setTruncate($value),
- 'ellipsis' => $this->setEllipsis($value),
- 'wordWrap', 'word_wrap' => $this->setWordWrap($value),
- 'formatter' => $this->setFormatter($value),
- 'colorizer' => $this->setColorizer($value),
- 'defaultValue', 'default_value', 'default' => $this->setDefaultValue($value),
- 'visible' => $this->setVisible($value),
- default => $this->setMetadata($key, $value)
- };
- }
-
- return $this;
- }
-
- /**
- * Create a quick column configuration.
- */
- public static function create(string $name): self {
- return new self($name);
- }
-
- /**
- * Create a date column with formatting.
- */
- public static function date(string $name, ?int $width = null, string $format = 'Y-m-d'): self {
- return (new self($name))
- ->setAlignment(self::ALIGN_LEFT)
- ->setWidth($width)
- ->setFormatter(function ($value) use ($format) {
- if (empty($value)) {
- return '';
- }
-
- try {
- if (is_string($value)) {
- $date = new \DateTime($value);
- } elseif ($value instanceof \DateTime) {
- $date = $value;
- } else {
- return (string)$value;
- }
-
- return $date->format($format);
- } catch (\Exception $e) {
- return (string)$value;
- }
- });
- }
-
- /**
- * Format a value using the column's formatter.
- */
- public function formatValue(mixed $value): string {
- // Handle null/empty values
- if ($value === null || $value === '') {
- return (string)$this->defaultValue;
- }
-
- // Apply custom formatter if set
- if ($this->formatter !== null) {
- $value = call_user_func($this->formatter, $value);
- }
-
- return (string)$value;
- }
-
- /**
- * Get alignment.
- */
- public function getAlignment(): string {
- return $this->alignment;
- }
-
- /**
- * Get all metadata.
- */
- public function getAllMetadata(): array {
- return $this->metadata;
- }
-
- /**
- * Get colorizer function.
- */
- public function getColorizer() {
- return $this->colorizer;
- }
-
- /**
- * Get default value.
- */
- public function getDefaultValue(): mixed {
- return $this->defaultValue;
- }
-
- /**
- * Get ellipsis string.
- */
- public function getEllipsis(): string {
- return $this->ellipsis;
- }
-
- /**
- * Get formatter function.
- */
- public function getFormatter() {
- return $this->formatter;
- }
-
- /**
- * Get maximum width.
- */
- public function getMaxWidth(): ?int {
- return $this->maxWidth;
- }
-
- /**
- * Get metadata value.
- */
- public function getMetadata(string $key, mixed $default = null): mixed {
- return $this->metadata[$key] ?? $default;
- }
-
- /**
- * Get minimum width.
- */
- public function getMinWidth(): ?int {
- return $this->minWidth;
- }
-
- /**
- * Get column name.
- */
- public function getName(): string {
- return $this->name;
- }
-
- /**
- * Get column width.
- */
- public function getWidth(): ?int {
- return $this->width;
- }
-
- /**
- * Check if column is visible.
- */
- public function isVisible(): bool {
- return $this->visible;
- }
-
- /**
- * Create a left-aligned column.
- */
- public static function left(string $name, ?int $width = null): self {
- return (new self($name))->setAlignment(self::ALIGN_LEFT)->setWidth($width);
- }
-
- /**
- * Create a numeric column (right-aligned with number formatting).
- */
- public static function numeric(string $name, ?int $width = null, int $decimals = 2): self {
- return (new self($name))
- ->setAlignment(self::ALIGN_RIGHT)
- ->setWidth($width)
- ->setFormatter(fn($value) => is_numeric($value) ? number_format((float)$value, $decimals) : $value);
- }
-
- /**
- * Create a right-aligned column.
- */
- public static function right(string $name, ?int $width = null): self {
- return (new self($name))->setAlignment(self::ALIGN_RIGHT)->setWidth($width);
- }
-
- /**
- * Set text alignment.
- */
- public function setAlignment(string $alignmentValue): self {
- $validAlignments = [self::ALIGN_LEFT, self::ALIGN_RIGHT, self::ALIGN_CENTER, self::ALIGN_AUTO];
-
- if (in_array($alignmentValue, $validAlignments)) {
- $this->alignment = $alignmentValue;
- }
-
- return $this;
- }
-
- /**
- * Set color function.
- */
- public function setColorizer($colorizer): self {
- $this->colorizer = $colorizer;
-
- return $this;
- }
-
- /**
- * Set default value for empty cells.
- */
- public function setDefaultValue(mixed $defaultValue): self {
- $this->defaultValue = $defaultValue;
-
- return $this;
- }
-
- /**
- * Set ellipsis string for truncated text.
- */
- public function setEllipsis(string $ellipsis): self {
- $this->ellipsis = $ellipsis;
-
- return $this;
- }
-
- /**
- * Set content formatter function.
- */
- public function setFormatter($formatter): self {
- $this->formatter = $formatter;
-
- return $this;
- }
-
- /**
- * Set maximum width.
- */
- public function setMaxWidth(?int $maxWidth): self {
- $this->maxWidth = $maxWidth;
-
- return $this;
- }
-
- /**
- * Set custom metadata.
- */
- public function setMetadata(string $key, mixed $value): self {
- $this->metadata[$key] = $value;
-
- return $this;
- }
-
- /**
- * Set minimum width.
- */
- public function setMinWidth(?int $minWidth): self {
- $this->minWidth = $minWidth;
-
- return $this;
- }
-
- /**
- * Enable/disable text truncation.
- */
- public function setTruncate(bool $truncate): self {
- $this->truncate = $truncate;
-
- return $this;
- }
-
- /**
- * Set column visibility.
- */
- public function setVisible(bool $visible): self {
- $this->visible = $visible;
-
- return $this;
- }
-
- /**
- * Set column width.
- */
- public function setWidth(?int $width): self {
- $this->width = $width;
-
- return $this;
- }
-
- /**
- * Enable/disable word wrapping.
- */
- public function setWordWrap(bool $wordWrap): self {
- $this->wordWrap = $wordWrap;
-
- return $this;
- }
-
- /**
- * Check if truncation is enabled.
- */
- public function shouldTruncate(): bool {
- return $this->truncate;
- }
-
- /**
- * Check if word wrap is enabled.
- */
- public function shouldWordWrap(): bool {
- return $this->wordWrap;
- }
-
- /**
- * Truncate text to fit column width.
- */
- public function truncateText(string $text, int $width): string {
- if (!$this->truncate) {
- return $text;
- }
-
- $displayLength = $this->getDisplayLength($text);
-
- if ($displayLength <= $width) {
- return $text;
- }
-
- $ellipsisLength = strlen($this->ellipsis);
- $maxLength = $width - $ellipsisLength;
-
- if ($maxLength <= 0) {
- return str_repeat('.', min($width, 3));
- }
-
- // Simple truncation for now - could be enhanced for word boundaries
- $truncated = substr($text, 0, $maxLength);
-
- return $truncated.$this->ellipsis;
- }
-
- /**
- * Apply ANSI colors to text.
- */
- private function applyAnsiColors(string $text, array $colorConfig): string {
- $codes = [];
-
- // Foreground colors
- if (isset($colorConfig['color'])) {
- $codes[] = $this->getAnsiColorCode($colorConfig['color']);
- }
-
- // Background colors
- if (isset($colorConfig['background'])) {
- $codes[] = $this->getAnsiColorCode($colorConfig['background'], true);
- }
-
- // Text styles
- if (isset($colorConfig['bold']) && $colorConfig['bold']) {
- $codes[] = '1';
- }
-
- if (isset($colorConfig['underline']) && $colorConfig['underline']) {
- $codes[] = '4';
- }
-
- if (empty($codes)) {
- return $text;
- }
-
- return "\x1b[".implode(';', $codes)."m".$text."\x1b[0m";
- }
-
- /**
- * Get ANSI color code for color name.
- */
- private function getAnsiColorCode(string $color, bool $background = false): string {
- $colors = [
- 'black' => $background ? '40' : '30',
- 'red' => $background ? '41' : '31',
- 'green' => $background ? '42' : '32',
- 'yellow' => $background ? '43' : '33',
- 'blue' => $background ? '44' : '34',
- 'magenta' => $background ? '45' : '35',
- 'cyan' => $background ? '46' : '36',
- 'white' => $background ? '47' : '37',
- 'light-red' => $background ? '101' : '91',
- 'light-green' => $background ? '102' : '92',
- 'light-yellow' => $background ? '103' : '93',
- 'light-blue' => $background ? '104' : '94',
- 'light-magenta' => $background ? '105' : '95',
- 'light-cyan' => $background ? '106' : '96',
- ];
-
- return $colors[strtolower($color)] ?? ($background ? '40' : '30');
- }
-
- /**
- * Get display length of text (accounting for ANSI codes).
- */
- private function getDisplayLength(string $text): int {
- // Remove ANSI escape sequences for length calculation
- $cleaned = preg_replace('/\x1b\[[0-9;]*m/', '', $text);
-
- return strlen($cleaned ?? $text);
- }
-
- /**
- * Resolve auto alignment based on content.
- */
- private function resolveAlignment(string $text): string {
- if ($this->alignment !== self::ALIGN_AUTO) {
- return $this->alignment;
- }
-
- // Auto-detect: numbers right-aligned, text left-aligned
- if (is_numeric(trim($text))) {
- return self::ALIGN_RIGHT;
- }
-
- return self::ALIGN_LEFT;
- }
-}
+name = $name;
+ }
+
+ /**
+ * Align text within specified width.
+ */
+ public function alignText(string $text, int $width): string {
+ $displayLength = $this->getDisplayLength($text);
+
+ if ($displayLength >= $width) {
+ return $text;
+ }
+
+ $padding = $width - $displayLength;
+ $alignment = $this->resolveAlignment($text);
+
+ return match ($alignment) {
+ self::ALIGN_RIGHT => str_repeat(' ', $padding).$text,
+ self::ALIGN_CENTER => str_repeat(' ', intval($padding / 2)).$text.str_repeat(' ', $padding - intval($padding / 2)),
+ default => $text.str_repeat(' ', $padding) // LEFT
+ };
+ }
+
+ /**
+ * Calculate ideal width based on content.
+ */
+ public function calculateIdealWidth(array $values): int {
+ $maxLength = strlen($this->name); // Start with header length
+
+ foreach ($values as $value) {
+ $formatted = $this->formatValue($value);
+ $length = $this->getDisplayLength($formatted);
+ $maxLength = max($maxLength, $length);
+ }
+
+ // Apply constraints
+ if ($this->minWidth !== null) {
+ $maxLength = max($maxLength, $this->minWidth);
+ }
+
+ if ($this->maxWidth !== null) {
+ $maxLength = min($maxLength, $this->maxWidth);
+ }
+
+ return $maxLength;
+ }
+
+ /**
+ * Create a center-aligned column.
+ */
+ public static function center(string $name, ?int $width = null): self {
+ return (new self($name))->setAlignment(self::ALIGN_CENTER)->setWidth($width);
+ }
+
+ /**
+ * Apply color to a value using the column's colorizer.
+ */
+ public function colorizeValue(string $value): string {
+ if ($this->colorizer === null) {
+ return $value;
+ }
+
+ $colorConfig = call_user_func($this->colorizer, $value);
+
+ if (!is_array($colorConfig) || empty($colorConfig)) {
+ return $value;
+ }
+
+ return $this->applyAnsiColors($value, $colorConfig);
+ }
+
+ /**
+ * Configure column with array of options.
+ */
+ public function configure(array $config): self {
+ foreach ($config as $key => $value) {
+ match ($key) {
+ 'width' => $this->setWidth($value),
+ 'minWidth', 'min_width' => $this->setMinWidth($value),
+ 'maxWidth', 'max_width' => $this->setMaxWidth($value),
+ 'alignment', 'align' => $this->setAlignment($value),
+ 'truncate' => $this->setTruncate($value),
+ 'ellipsis' => $this->setEllipsis($value),
+ 'wordWrap', 'word_wrap' => $this->setWordWrap($value),
+ 'formatter' => $this->setFormatter($value),
+ 'colorizer' => $this->setColorizer($value),
+ 'defaultValue', 'default_value', 'default' => $this->setDefaultValue($value),
+ 'visible' => $this->setVisible($value),
+ default => $this->setMetadata($key, $value)
+ };
+ }
+
+ return $this;
+ }
+
+ /**
+ * Create a quick column configuration.
+ */
+ public static function create(string $name): self {
+ return new self($name);
+ }
+
+ /**
+ * Create a date column with formatting.
+ */
+ public static function date(string $name, ?int $width = null, string $format = 'Y-m-d'): self {
+ return (new self($name))
+ ->setAlignment(self::ALIGN_LEFT)
+ ->setWidth($width)
+ ->setFormatter(function ($value) use ($format) {
+ if (empty($value)) {
+ return '';
+ }
+
+ try {
+ if (is_string($value)) {
+ $date = new \DateTime($value);
+ } elseif ($value instanceof \DateTime) {
+ $date = $value;
+ } else {
+ return (string)$value;
+ }
+
+ return $date->format($format);
+ } catch (\Exception $e) {
+ return (string)$value;
+ }
+ });
+ }
+
+ /**
+ * Format a value using the column's formatter.
+ */
+ public function formatValue(mixed $value): string {
+ // Handle null/empty values
+ if ($value === null || $value === '') {
+ return (string)$this->defaultValue;
+ }
+
+ // Apply custom formatter if set
+ if ($this->formatter !== null) {
+ $value = call_user_func($this->formatter, $value);
+ }
+
+ return (string)$value;
+ }
+
+ /**
+ * Get alignment.
+ */
+ public function getAlignment(): string {
+ return $this->alignment;
+ }
+
+ /**
+ * Get all metadata.
+ */
+ public function getAllMetadata(): array {
+ return $this->metadata;
+ }
+
+ /**
+ * Get colorizer function.
+ */
+ public function getColorizer() {
+ return $this->colorizer;
+ }
+
+ /**
+ * Get default value.
+ */
+ public function getDefaultValue(): mixed {
+ return $this->defaultValue;
+ }
+
+ /**
+ * Get ellipsis string.
+ */
+ public function getEllipsis(): string {
+ return $this->ellipsis;
+ }
+
+ /**
+ * Get formatter function.
+ */
+ public function getFormatter() {
+ return $this->formatter;
+ }
+
+ /**
+ * Get maximum width.
+ */
+ public function getMaxWidth(): ?int {
+ return $this->maxWidth;
+ }
+
+ /**
+ * Get metadata value.
+ */
+ public function getMetadata(string $key, mixed $default = null): mixed {
+ return $this->metadata[$key] ?? $default;
+ }
+
+ /**
+ * Get minimum width.
+ */
+ public function getMinWidth(): ?int {
+ return $this->minWidth;
+ }
+
+ /**
+ * Get column name.
+ */
+ public function getName(): string {
+ return $this->name;
+ }
+
+ /**
+ * Get column width.
+ */
+ public function getWidth(): ?int {
+ return $this->width;
+ }
+
+ /**
+ * Check if column is visible.
+ */
+ public function isVisible(): bool {
+ return $this->visible;
+ }
+
+ /**
+ * Create a left-aligned column.
+ */
+ public static function left(string $name, ?int $width = null): self {
+ return (new self($name))->setAlignment(self::ALIGN_LEFT)->setWidth($width);
+ }
+
+ /**
+ * Create a numeric column (right-aligned with number formatting).
+ */
+ public static function numeric(string $name, ?int $width = null, int $decimals = 2): self {
+ return (new self($name))
+ ->setAlignment(self::ALIGN_RIGHT)
+ ->setWidth($width)
+ ->setFormatter(fn($value) => is_numeric($value) ? number_format((float)$value, $decimals) : $value);
+ }
+
+ /**
+ * Create a right-aligned column.
+ */
+ public static function right(string $name, ?int $width = null): self {
+ return (new self($name))->setAlignment(self::ALIGN_RIGHT)->setWidth($width);
+ }
+
+ /**
+ * Set text alignment.
+ */
+ public function setAlignment(string $alignmentValue): self {
+ $validAlignments = [self::ALIGN_LEFT, self::ALIGN_RIGHT, self::ALIGN_CENTER, self::ALIGN_AUTO];
+
+ if (in_array($alignmentValue, $validAlignments)) {
+ $this->alignment = $alignmentValue;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Set color function.
+ */
+ public function setColorizer($colorizer): self {
+ $this->colorizer = $colorizer;
+
+ return $this;
+ }
+
+ /**
+ * Set default value for empty cells.
+ */
+ public function setDefaultValue(mixed $defaultValue): self {
+ $this->defaultValue = $defaultValue;
+
+ return $this;
+ }
+
+ /**
+ * Set ellipsis string for truncated text.
+ */
+ public function setEllipsis(string $ellipsis): self {
+ $this->ellipsis = $ellipsis;
+
+ return $this;
+ }
+
+ /**
+ * Set content formatter function.
+ */
+ public function setFormatter($formatter): self {
+ $this->formatter = $formatter;
+
+ return $this;
+ }
+
+ /**
+ * Set maximum width.
+ */
+ public function setMaxWidth(?int $maxWidth): self {
+ $this->maxWidth = $maxWidth;
+
+ return $this;
+ }
+
+ /**
+ * Set custom metadata.
+ */
+ public function setMetadata(string $key, mixed $value): self {
+ $this->metadata[$key] = $value;
+
+ return $this;
+ }
+
+ /**
+ * Set minimum width.
+ */
+ public function setMinWidth(?int $minWidth): self {
+ $this->minWidth = $minWidth;
+
+ return $this;
+ }
+
+ /**
+ * Enable/disable text truncation.
+ */
+ public function setTruncate(bool $truncate): self {
+ $this->truncate = $truncate;
+
+ return $this;
+ }
+
+ /**
+ * Set column visibility.
+ */
+ public function setVisible(bool $visible): self {
+ $this->visible = $visible;
+
+ return $this;
+ }
+
+ /**
+ * Set column width.
+ */
+ public function setWidth(?int $width): self {
+ $this->width = $width;
+
+ return $this;
+ }
+
+ /**
+ * Enable/disable word wrapping.
+ */
+ public function setWordWrap(bool $wordWrap): self {
+ $this->wordWrap = $wordWrap;
+
+ return $this;
+ }
+
+ /**
+ * Check if truncation is enabled.
+ */
+ public function shouldTruncate(): bool {
+ return $this->truncate;
+ }
+
+ /**
+ * Check if word wrap is enabled.
+ */
+ public function shouldWordWrap(): bool {
+ return $this->wordWrap;
+ }
+
+ /**
+ * Truncate text to fit column width.
+ */
+ public function truncateText(string $text, int $width): string {
+ if (!$this->truncate) {
+ return $text;
+ }
+
+ $displayLength = $this->getDisplayLength($text);
+
+ if ($displayLength <= $width) {
+ return $text;
+ }
+
+ $ellipsisLength = strlen($this->ellipsis);
+ $maxLength = $width - $ellipsisLength;
+
+ if ($maxLength <= 0) {
+ return str_repeat('.', min($width, 3));
+ }
+
+ // Simple truncation for now - could be enhanced for word boundaries
+ $truncated = substr($text, 0, $maxLength);
+
+ return $truncated.$this->ellipsis;
+ }
+
+ /**
+ * Apply ANSI colors to text.
+ */
+ private function applyAnsiColors(string $text, array $colorConfig): string {
+ $codes = [];
+
+ // Foreground colors
+ if (isset($colorConfig['color'])) {
+ $codes[] = $this->getAnsiColorCode($colorConfig['color']);
+ }
+
+ // Background colors
+ if (isset($colorConfig['background'])) {
+ $codes[] = $this->getAnsiColorCode($colorConfig['background'], true);
+ }
+
+ // Text styles
+ if (isset($colorConfig['bold']) && $colorConfig['bold']) {
+ $codes[] = '1';
+ }
+
+ if (isset($colorConfig['underline']) && $colorConfig['underline']) {
+ $codes[] = '4';
+ }
+
+ if (empty($codes)) {
+ return $text;
+ }
+
+ return "\x1b[".implode(';', $codes)."m".$text."\x1b[0m";
+ }
+
+ /**
+ * Get ANSI color code for color name.
+ */
+ private function getAnsiColorCode(string $color, bool $background = false): string {
+ $colors = [
+ 'black' => $background ? '40' : '30',
+ 'red' => $background ? '41' : '31',
+ 'green' => $background ? '42' : '32',
+ 'yellow' => $background ? '43' : '33',
+ 'blue' => $background ? '44' : '34',
+ 'magenta' => $background ? '45' : '35',
+ 'cyan' => $background ? '46' : '36',
+ 'white' => $background ? '47' : '37',
+ 'light-red' => $background ? '101' : '91',
+ 'light-green' => $background ? '102' : '92',
+ 'light-yellow' => $background ? '103' : '93',
+ 'light-blue' => $background ? '104' : '94',
+ 'light-magenta' => $background ? '105' : '95',
+ 'light-cyan' => $background ? '106' : '96',
+ ];
+
+ return $colors[strtolower($color)] ?? ($background ? '40' : '30');
+ }
+
+ /**
+ * Get display length of text (accounting for ANSI codes).
+ */
+ private function getDisplayLength(string $text): int {
+ // Remove ANSI escape sequences for length calculation
+ $cleaned = preg_replace('/\x1b\[[0-9;]*m/', '', $text);
+
+ return strlen($cleaned ?? $text);
+ }
+
+ /**
+ * Resolve auto alignment based on content.
+ */
+ private function resolveAlignment(string $text): string {
+ if ($this->alignment !== self::ALIGN_AUTO) {
+ return $this->alignment;
+ }
+
+ // Auto-detect: numbers right-aligned, text left-aligned
+ if (is_numeric(trim($text))) {
+ return self::ALIGN_RIGHT;
+ }
+
+ return self::ALIGN_LEFT;
+ }
+}
diff --git a/WebFiori/Cli/Table/ColumnCalculator.php b/WebFiori/Cli/Table/ColumnCalculator.php
index 0dcab7b..df40940 100644
--- a/WebFiori/Cli/Table/ColumnCalculator.php
+++ b/WebFiori/Cli/Table/ColumnCalculator.php
@@ -1,458 +1,458 @@
-getHeaders();
- $columnCount = $data->getColumnCount();
-
- for ($i = 0; $i < $columnCount; $i++) {
- $header = $headers[$i] ?? "Column ".($i + 1);
- $column = new Column($header);
-
- // Auto-configure based on data type
-
- $type = $data->getColumnType($i);
- $stats = $data->getColumnStatistics($i);
-
- // Set alignment based on type
- switch ($type) {
- case 'integer':
- case 'float':
- $column->setAlignment(Column::ALIGN_RIGHT);
- break;
- case 'date':
- $column->setAlignment(Column::ALIGN_LEFT);
- break;
- default:
- $column->setAlignment(Column::ALIGN_LEFT);
- }
-
- // Set reasonable width constraints
- if (isset($stats['max_length'])) {
- $maxWidth = min(50, max(10, $stats['max_length'] + 2));
- $column->setMaxWidth($maxWidth);
- }
-
- $columns[$i] = $column;
- }
-
- return $columns;
- }
-
- /**
- * Calculate responsive column widths for narrow terminals.
- */
- public function calculateResponsiveWidths(
- TableData $data,
- array $columns,
- int $maxWidth,
- TableStyle $style
- ): array {
- // If terminal is very narrow, use stacked layout or hide less important columns
- $minRequiredWidth = $this->calculateMinimumTableWidth($columns, $style);
-
- if ($maxWidth < $minRequiredWidth) {
- return $this->calculateNarrowWidths($columns, $maxWidth, $style);
- }
-
- return $this->calculateWidths($data, $columns, $maxWidth, $style);
- }
-
- /**
- * Calculate optimal column widths for the table.
- */
- public function calculateWidths(
- TableData $data,
- array $columns,
- int $maxWidth,
- TableStyle $style
- ): array {
- $columnCount = count($columns);
-
- if ($columnCount === 0) {
- return [];
- }
-
- // Calculate available width for content
- $availableWidth = $this->calculateAvailableWidth($maxWidth, $columnCount, $style);
-
- // First, handle fixed-width columns
- $fixedWidths = [];
- $flexibleColumns = [];
- $usedWidth = 0;
-
- foreach ($columns as $index => $column) {
- if ($column->getWidth() !== null) {
- $fixedWidths[$index] = $column->getWidth();
- $usedWidth += $column->getWidth();
- } else {
- $flexibleColumns[] = $index;
- }
- }
-
- // Calculate remaining width for flexible columns
- $remainingWidth = $availableWidth - $usedWidth;
-
- // If we have flexible columns, calculate their widths
- if (!empty($flexibleColumns)) {
- $flexibleIdealWidths = [];
- $flexibleMinWidths = [];
- $flexibleMaxWidths = [];
-
- foreach ($flexibleColumns as $index) {
- $column = $columns[$index];
-
- // Calculate ideal width for this flexible column
- $headers = $data->getHeaders();
- $headerWidth = strlen($headers[$index] ?? $column->getName());
- $values = $data->getColumnValues($index);
- $contentWidth = $this->calculateContentWidth($values, $column);
- $idealWidth = max($headerWidth, $contentWidth);
-
- $flexibleIdealWidths[] = $idealWidth;
-
- // Calculate minimum width
- $minWidth = $column->getMinWidth() ?? max(self::MIN_COLUMN_WIDTH, min($headerWidth, strlen($column->getEllipsis())));
- $flexibleMinWidths[] = $minWidth;
-
- // Get maximum width
- $flexibleMaxWidths[] = $column->getMaxWidth();
- }
-
- // Distribute remaining width among flexible columns
- $flexibleWidths = $this->distributeWidth(
- $flexibleIdealWidths,
- $flexibleMinWidths,
- $flexibleMaxWidths,
- $remainingWidth
- );
- }
-
- // Combine fixed and flexible widths
- $finalWidths = [];
- $flexibleIndex = 0;
-
- for ($i = 0; $i < $columnCount; $i++) {
- if (isset($fixedWidths[$i])) {
- $finalWidths[$i] = $fixedWidths[$i];
- } else {
- $finalWidths[$i] = $flexibleWidths[$flexibleIndex] ?? self::MIN_COLUMN_WIDTH;
- $flexibleIndex++;
- }
- }
-
- return $finalWidths;
- }
-
- /**
- * Allocate ideal widths where possible.
- */
- private function allocateIdealWidths(
- array &$finalWidths,
- array $idealWidths,
- array $maxWidths,
- int $remainingWidth
- ): int {
- $columnCount = count($finalWidths);
-
- // Sort columns by their ideal width requirement (smallest first)
- $requirements = [];
-
- for ($i = 0; $i < $columnCount; $i++) {
- $maxAllowed = $maxWidths[$i] ? min($maxWidths[$i], $idealWidths[$i]) : $idealWidths[$i];
- $actualNeeded = max(0, $maxAllowed - $finalWidths[$i]);
-
- if ($actualNeeded > 0) {
- $requirements[] = ['index' => $i, 'needed' => $actualNeeded];
- }
- }
-
- // Sort by requirement (smallest first for fair distribution)
- usort($requirements, fn($a, $b) => $a['needed'] <=> $b['needed']);
-
- // Allocate width to columns that need it
- foreach ($requirements as $req) {
- $index = $req['index'];
- $needed = $req['needed'];
- $allocated = min($needed, $remainingWidth);
-
- $finalWidths[$index] += $allocated;
- $remainingWidth -= $allocated;
-
- if ($remainingWidth <= 0) {
- break;
- }
- }
-
- return $remainingWidth;
- }
-
- /**
- * Calculate available width for table content.
- */
- private function calculateAvailableWidth(int $maxWidth, int $columnCount, TableStyle $style): int {
- // Account for borders and padding
- $borderWidth = $style->getBorderWidth($columnCount);
- $paddingWidth = $columnCount * $style->getTotalPadding();
-
- return max(
- $columnCount * self::MIN_COLUMN_WIDTH,
- $maxWidth - $borderWidth - $paddingWidth
- );
- }
-
- /**
- * Calculate content width for a column's values.
- */
- private function calculateContentWidth(array $values, Column $column): int {
- $maxWidth = 0;
-
- foreach ($values as $value) {
- $formatted = $column->formatValue($value);
- $width = $this->getDisplayWidth($formatted);
- $maxWidth = max($maxWidth, $width);
- }
-
- return $maxWidth;
- }
-
- /**
- * Calculate ideal width for each column based on content.
- */
- private function calculateIdealWidths(TableData $data, array $columns): array {
- $idealWidths = [];
- $headers = $data->getHeaders();
- $columnIndexes = array_keys($columns);
-
- foreach ($columnIndexes as $index) {
- $column = $columns[$index];
-
- // Start with header width
- $headerWidth = strlen($headers[$index] ?? $column->getName());
-
- // Check content width
- $values = $data->getColumnValues($index);
- $contentWidth = $this->calculateContentWidth($values, $column);
-
- // Use the larger of header or content width
- $idealWidth = max($headerWidth, $contentWidth);
-
- // Apply column-specific width if configured
- if ($column->getWidth() !== null) {
- $idealWidth = $column->getWidth();
- }
-
- $idealWidths[] = $idealWidth;
- }
-
- return $idealWidths;
- }
-
- /**
- * Calculate minimum required table width.
- */
- private function calculateMinimumTableWidth(array $columns, TableStyle $style): int {
- $columnCount = count($columns);
- $minContentWidth = $columnCount * self::MIN_COLUMN_WIDTH;
- $borderWidth = $style->getBorderWidth($columnCount);
- $paddingWidth = $columnCount * $style->getTotalPadding();
-
- return $minContentWidth + $borderWidth + $paddingWidth;
- }
-
- /**
- * Calculate minimum width for each column.
- */
- private function calculateMinimumWidths(TableData $data, array $columns): array {
- $minWidths = [];
- $headers = $data->getHeaders();
- $columnIndexes = array_keys($columns);
-
- foreach ($columnIndexes as $index) {
- $column = $columns[$index];
-
- // Use configured minimum width if available
- if ($column->getMinWidth() !== null) {
- $minWidths[] = max($column->getMinWidth(), self::MIN_COLUMN_WIDTH);
- continue;
- }
-
- // Calculate minimum based on header and ellipsis
- $headerWidth = strlen($headers[$index] ?? $column->getName());
- $ellipsisWidth = strlen($column->getEllipsis());
-
- $minWidth = max(
- self::MIN_COLUMN_WIDTH,
- min($headerWidth, $ellipsisWidth + 1)
- );
-
- $minWidths[] = $minWidth;
- }
-
- return $minWidths;
- }
-
- /**
- * Calculate widths for narrow terminals.
- */
- private function calculateNarrowWidths(
- array $columns,
- int $maxWidth,
- TableStyle $style
- ): array {
- // Strategy: Hide less important columns or use very minimal widths
- $columnCount = count($columns);
- $availableWidth = $this->calculateAvailableWidth($maxWidth, $columnCount, $style);
-
- // Give each column the minimum width
- $widthPerColumn = max(self::MIN_COLUMN_WIDTH, intval($availableWidth / $columnCount));
-
- return array_fill(0, $columnCount, $widthPerColumn);
- }
-
- /**
- * Distribute any remaining width proportionally.
- */
- private function distributeRemainingWidth(
- array &$finalWidths,
- array $maxWidths,
- int $remainingWidth
- ): void {
- $columnCount = count($finalWidths);
-
- if ($remainingWidth <= 0) {
- return;
- }
-
- // Find columns that can still grow
- $growableColumns = [];
- $totalGrowthPotential = 0;
-
- for ($i = 0; $i < $columnCount; $i++) {
- $currentWidth = $finalWidths[$i];
- $maxAllowed = $maxWidths[$i] ?? PHP_INT_MAX;
-
- if ($currentWidth < $maxAllowed) {
- $growthPotential = $maxAllowed - $currentWidth;
- $growableColumns[$i] = $growthPotential;
- $totalGrowthPotential += $growthPotential;
- }
- }
-
- if (empty($growableColumns)) {
- return;
- }
-
- // Distribute proportionally based on growth potential
- foreach ($growableColumns as $index => $growthPotential) {
- $proportion = $growthPotential / $totalGrowthPotential;
- $allocation = min(
- intval($remainingWidth * $proportion),
- $growthPotential,
- $remainingWidth
- );
-
- $finalWidths[$index] += $allocation;
- $remainingWidth -= $allocation;
-
- if ($remainingWidth <= 0) {
- break;
- }
- }
-
- // Distribute any leftover width to the first growable columns
- while ($remainingWidth > 0 && !empty($growableColumns)) {
- foreach ($growableColumns as $index => $growthPotential) {
- if ($remainingWidth <= 0) {
- break;
- }
-
- $currentWidth = $finalWidths[$index];
- $maxAllowed = $maxWidths[$index] ?? PHP_INT_MAX;
-
- if ($currentWidth < $maxAllowed) {
- $finalWidths[$index]++;
- $remainingWidth--;
- } else {
- unset($growableColumns[$index]);
- }
- }
- }
- }
-
- /**
- * Distribute available width among columns using intelligent algorithm.
- */
- private function distributeWidth(
- array $idealWidths,
- array $minWidths,
- array $maxWidths,
- int $availableWidth
- ): array {
- $columnCount = count($idealWidths);
- $finalWidths = array_fill(0, $columnCount, 0);
-
- // Phase 1: Allocate minimum widths
- $remainingWidth = $availableWidth;
-
- for ($i = 0; $i < $columnCount; $i++) {
- $finalWidths[$i] = $minWidths[$i];
- $remainingWidth -= $minWidths[$i];
- }
-
- if ($remainingWidth <= 0) {
- return $finalWidths;
- }
-
- // Phase 2: Try to satisfy ideal widths
- $remainingWidth = $this->allocateIdealWidths($finalWidths, $idealWidths, $maxWidths, $remainingWidth);
-
- if ($remainingWidth <= 0) {
- return $finalWidths;
- }
-
- // Phase 3: Distribute remaining width proportionally
- $this->distributeRemainingWidth($finalWidths, $maxWidths, $remainingWidth);
-
- return $finalWidths;
- }
-
- /**
- * Get configured maximum widths for columns.
- */
- private function getConfiguredMaxWidths(array $columns): array {
- $maxWidths = [];
-
- foreach ($columns as $column) {
- $maxWidths[] = $column->getMaxWidth();
- }
-
- return $maxWidths;
- }
-
- /**
- * Get display width of text (accounting for ANSI codes).
- */
- private function getDisplayWidth(string $text): int {
- // Remove ANSI escape sequences for width calculation
- $cleaned = preg_replace('/\x1b\[[0-9;]*m/', '', $text);
-
- return strlen($cleaned ?? $text);
- }
-}
+getHeaders();
+ $columnCount = $data->getColumnCount();
+
+ for ($i = 0; $i < $columnCount; $i++) {
+ $header = $headers[$i] ?? "Column ".($i + 1);
+ $column = new Column($header);
+
+ // Auto-configure based on data type
+
+ $type = $data->getColumnType($i);
+ $stats = $data->getColumnStatistics($i);
+
+ // Set alignment based on type
+ switch ($type) {
+ case 'integer':
+ case 'float':
+ $column->setAlignment(Column::ALIGN_RIGHT);
+ break;
+ case 'date':
+ $column->setAlignment(Column::ALIGN_LEFT);
+ break;
+ default:
+ $column->setAlignment(Column::ALIGN_LEFT);
+ }
+
+ // Set reasonable width constraints
+ if (isset($stats['max_length'])) {
+ $maxWidth = min(50, max(10, $stats['max_length'] + 2));
+ $column->setMaxWidth($maxWidth);
+ }
+
+ $columns[$i] = $column;
+ }
+
+ return $columns;
+ }
+
+ /**
+ * Calculate responsive column widths for narrow terminals.
+ */
+ public function calculateResponsiveWidths(
+ TableData $data,
+ array $columns,
+ int $maxWidth,
+ TableStyle $style
+ ): array {
+ // If terminal is very narrow, use stacked layout or hide less important columns
+ $minRequiredWidth = $this->calculateMinimumTableWidth($columns, $style);
+
+ if ($maxWidth < $minRequiredWidth) {
+ return $this->calculateNarrowWidths($columns, $maxWidth, $style);
+ }
+
+ return $this->calculateWidths($data, $columns, $maxWidth, $style);
+ }
+
+ /**
+ * Calculate optimal column widths for the table.
+ */
+ public function calculateWidths(
+ TableData $data,
+ array $columns,
+ int $maxWidth,
+ TableStyle $style
+ ): array {
+ $columnCount = count($columns);
+
+ if ($columnCount === 0) {
+ return [];
+ }
+
+ // Calculate available width for content
+ $availableWidth = $this->calculateAvailableWidth($maxWidth, $columnCount, $style);
+
+ // First, handle fixed-width columns
+ $fixedWidths = [];
+ $flexibleColumns = [];
+ $usedWidth = 0;
+
+ foreach ($columns as $index => $column) {
+ if ($column->getWidth() !== null) {
+ $fixedWidths[$index] = $column->getWidth();
+ $usedWidth += $column->getWidth();
+ } else {
+ $flexibleColumns[] = $index;
+ }
+ }
+
+ // Calculate remaining width for flexible columns
+ $remainingWidth = $availableWidth - $usedWidth;
+
+ // If we have flexible columns, calculate their widths
+ if (!empty($flexibleColumns)) {
+ $flexibleIdealWidths = [];
+ $flexibleMinWidths = [];
+ $flexibleMaxWidths = [];
+
+ foreach ($flexibleColumns as $index) {
+ $column = $columns[$index];
+
+ // Calculate ideal width for this flexible column
+ $headers = $data->getHeaders();
+ $headerWidth = strlen($headers[$index] ?? $column->getName());
+ $values = $data->getColumnValues($index);
+ $contentWidth = $this->calculateContentWidth($values, $column);
+ $idealWidth = max($headerWidth, $contentWidth);
+
+ $flexibleIdealWidths[] = $idealWidth;
+
+ // Calculate minimum width
+ $minWidth = $column->getMinWidth() ?? max(self::MIN_COLUMN_WIDTH, min($headerWidth, strlen($column->getEllipsis())));
+ $flexibleMinWidths[] = $minWidth;
+
+ // Get maximum width
+ $flexibleMaxWidths[] = $column->getMaxWidth();
+ }
+
+ // Distribute remaining width among flexible columns
+ $flexibleWidths = $this->distributeWidth(
+ $flexibleIdealWidths,
+ $flexibleMinWidths,
+ $flexibleMaxWidths,
+ $remainingWidth
+ );
+ }
+
+ // Combine fixed and flexible widths
+ $finalWidths = [];
+ $flexibleIndex = 0;
+
+ for ($i = 0; $i < $columnCount; $i++) {
+ if (isset($fixedWidths[$i])) {
+ $finalWidths[$i] = $fixedWidths[$i];
+ } else {
+ $finalWidths[$i] = $flexibleWidths[$flexibleIndex] ?? self::MIN_COLUMN_WIDTH;
+ $flexibleIndex++;
+ }
+ }
+
+ return $finalWidths;
+ }
+
+ /**
+ * Allocate ideal widths where possible.
+ */
+ private function allocateIdealWidths(
+ array &$finalWidths,
+ array $idealWidths,
+ array $maxWidths,
+ int $remainingWidth
+ ): int {
+ $columnCount = count($finalWidths);
+
+ // Sort columns by their ideal width requirement (smallest first)
+ $requirements = [];
+
+ for ($i = 0; $i < $columnCount; $i++) {
+ $maxAllowed = $maxWidths[$i] ? min($maxWidths[$i], $idealWidths[$i]) : $idealWidths[$i];
+ $actualNeeded = max(0, $maxAllowed - $finalWidths[$i]);
+
+ if ($actualNeeded > 0) {
+ $requirements[] = ['index' => $i, 'needed' => $actualNeeded];
+ }
+ }
+
+ // Sort by requirement (smallest first for fair distribution)
+ usort($requirements, fn($a, $b) => $a['needed'] <=> $b['needed']);
+
+ // Allocate width to columns that need it
+ foreach ($requirements as $req) {
+ $index = $req['index'];
+ $needed = $req['needed'];
+ $allocated = min($needed, $remainingWidth);
+
+ $finalWidths[$index] += $allocated;
+ $remainingWidth -= $allocated;
+
+ if ($remainingWidth <= 0) {
+ break;
+ }
+ }
+
+ return $remainingWidth;
+ }
+
+ /**
+ * Calculate available width for table content.
+ */
+ private function calculateAvailableWidth(int $maxWidth, int $columnCount, TableStyle $style): int {
+ // Account for borders and padding
+ $borderWidth = $style->getBorderWidth($columnCount);
+ $paddingWidth = $columnCount * $style->getTotalPadding();
+
+ return max(
+ $columnCount * self::MIN_COLUMN_WIDTH,
+ $maxWidth - $borderWidth - $paddingWidth
+ );
+ }
+
+ /**
+ * Calculate content width for a column's values.
+ */
+ private function calculateContentWidth(array $values, Column $column): int {
+ $maxWidth = 0;
+
+ foreach ($values as $value) {
+ $formatted = $column->formatValue($value);
+ $width = $this->getDisplayWidth($formatted);
+ $maxWidth = max($maxWidth, $width);
+ }
+
+ return $maxWidth;
+ }
+
+ /**
+ * Calculate ideal width for each column based on content.
+ */
+ private function calculateIdealWidths(TableData $data, array $columns): array {
+ $idealWidths = [];
+ $headers = $data->getHeaders();
+ $columnIndexes = array_keys($columns);
+
+ foreach ($columnIndexes as $index) {
+ $column = $columns[$index];
+
+ // Start with header width
+ $headerWidth = strlen($headers[$index] ?? $column->getName());
+
+ // Check content width
+ $values = $data->getColumnValues($index);
+ $contentWidth = $this->calculateContentWidth($values, $column);
+
+ // Use the larger of header or content width
+ $idealWidth = max($headerWidth, $contentWidth);
+
+ // Apply column-specific width if configured
+ if ($column->getWidth() !== null) {
+ $idealWidth = $column->getWidth();
+ }
+
+ $idealWidths[] = $idealWidth;
+ }
+
+ return $idealWidths;
+ }
+
+ /**
+ * Calculate minimum required table width.
+ */
+ private function calculateMinimumTableWidth(array $columns, TableStyle $style): int {
+ $columnCount = count($columns);
+ $minContentWidth = $columnCount * self::MIN_COLUMN_WIDTH;
+ $borderWidth = $style->getBorderWidth($columnCount);
+ $paddingWidth = $columnCount * $style->getTotalPadding();
+
+ return $minContentWidth + $borderWidth + $paddingWidth;
+ }
+
+ /**
+ * Calculate minimum width for each column.
+ */
+ private function calculateMinimumWidths(TableData $data, array $columns): array {
+ $minWidths = [];
+ $headers = $data->getHeaders();
+ $columnIndexes = array_keys($columns);
+
+ foreach ($columnIndexes as $index) {
+ $column = $columns[$index];
+
+ // Use configured minimum width if available
+ if ($column->getMinWidth() !== null) {
+ $minWidths[] = max($column->getMinWidth(), self::MIN_COLUMN_WIDTH);
+ continue;
+ }
+
+ // Calculate minimum based on header and ellipsis
+ $headerWidth = strlen($headers[$index] ?? $column->getName());
+ $ellipsisWidth = strlen($column->getEllipsis());
+
+ $minWidth = max(
+ self::MIN_COLUMN_WIDTH,
+ min($headerWidth, $ellipsisWidth + 1)
+ );
+
+ $minWidths[] = $minWidth;
+ }
+
+ return $minWidths;
+ }
+
+ /**
+ * Calculate widths for narrow terminals.
+ */
+ private function calculateNarrowWidths(
+ array $columns,
+ int $maxWidth,
+ TableStyle $style
+ ): array {
+ // Strategy: Hide less important columns or use very minimal widths
+ $columnCount = count($columns);
+ $availableWidth = $this->calculateAvailableWidth($maxWidth, $columnCount, $style);
+
+ // Give each column the minimum width
+ $widthPerColumn = max(self::MIN_COLUMN_WIDTH, intval($availableWidth / $columnCount));
+
+ return array_fill(0, $columnCount, $widthPerColumn);
+ }
+
+ /**
+ * Distribute any remaining width proportionally.
+ */
+ private function distributeRemainingWidth(
+ array &$finalWidths,
+ array $maxWidths,
+ int $remainingWidth
+ ): void {
+ $columnCount = count($finalWidths);
+
+ if ($remainingWidth <= 0) {
+ return;
+ }
+
+ // Find columns that can still grow
+ $growableColumns = [];
+ $totalGrowthPotential = 0;
+
+ for ($i = 0; $i < $columnCount; $i++) {
+ $currentWidth = $finalWidths[$i];
+ $maxAllowed = $maxWidths[$i] ?? PHP_INT_MAX;
+
+ if ($currentWidth < $maxAllowed) {
+ $growthPotential = $maxAllowed - $currentWidth;
+ $growableColumns[$i] = $growthPotential;
+ $totalGrowthPotential += $growthPotential;
+ }
+ }
+
+ if (empty($growableColumns)) {
+ return;
+ }
+
+ // Distribute proportionally based on growth potential
+ foreach ($growableColumns as $index => $growthPotential) {
+ $proportion = $growthPotential / $totalGrowthPotential;
+ $allocation = min(
+ intval($remainingWidth * $proportion),
+ $growthPotential,
+ $remainingWidth
+ );
+
+ $finalWidths[$index] += $allocation;
+ $remainingWidth -= $allocation;
+
+ if ($remainingWidth <= 0) {
+ break;
+ }
+ }
+
+ // Distribute any leftover width to the first growable columns
+ while ($remainingWidth > 0 && !empty($growableColumns)) {
+ foreach ($growableColumns as $index => $growthPotential) {
+ if ($remainingWidth <= 0) {
+ break;
+ }
+
+ $currentWidth = $finalWidths[$index];
+ $maxAllowed = $maxWidths[$index] ?? PHP_INT_MAX;
+
+ if ($currentWidth < $maxAllowed) {
+ $finalWidths[$index]++;
+ $remainingWidth--;
+ } else {
+ unset($growableColumns[$index]);
+ }
+ }
+ }
+ }
+
+ /**
+ * Distribute available width among columns using intelligent algorithm.
+ */
+ private function distributeWidth(
+ array $idealWidths,
+ array $minWidths,
+ array $maxWidths,
+ int $availableWidth
+ ): array {
+ $columnCount = count($idealWidths);
+ $finalWidths = array_fill(0, $columnCount, 0);
+
+ // Phase 1: Allocate minimum widths
+ $remainingWidth = $availableWidth;
+
+ for ($i = 0; $i < $columnCount; $i++) {
+ $finalWidths[$i] = $minWidths[$i];
+ $remainingWidth -= $minWidths[$i];
+ }
+
+ if ($remainingWidth <= 0) {
+ return $finalWidths;
+ }
+
+ // Phase 2: Try to satisfy ideal widths
+ $remainingWidth = $this->allocateIdealWidths($finalWidths, $idealWidths, $maxWidths, $remainingWidth);
+
+ if ($remainingWidth <= 0) {
+ return $finalWidths;
+ }
+
+ // Phase 3: Distribute remaining width proportionally
+ $this->distributeRemainingWidth($finalWidths, $maxWidths, $remainingWidth);
+
+ return $finalWidths;
+ }
+
+ /**
+ * Get configured maximum widths for columns.
+ */
+ private function getConfiguredMaxWidths(array $columns): array {
+ $maxWidths = [];
+
+ foreach ($columns as $column) {
+ $maxWidths[] = $column->getMaxWidth();
+ }
+
+ return $maxWidths;
+ }
+
+ /**
+ * Get display width of text (accounting for ANSI codes).
+ */
+ private function getDisplayWidth(string $text): int {
+ // Remove ANSI escape sequences for width calculation
+ $cleaned = preg_replace('/\x1b\[[0-9;]*m/', '', $text);
+
+ return strlen($cleaned ?? $text);
+ }
+}
diff --git a/WebFiori/Cli/Table/README.md b/WebFiori/Cli/Table/README.md
index d74bc41..69ff815 100644
--- a/WebFiori/Cli/Table/README.md
+++ b/WebFiori/Cli/Table/README.md
@@ -1,461 +1,461 @@
-# WebFiori CLI Table Feature
-
-A comprehensive tabular data display system for CLI applications with advanced formatting, styling, and responsive design capabilities.
-
-## ๐ฏ Overview
-
-The WebFiori CLI Table feature provides a powerful and flexible way to display tabular data in command-line applications. It offers:
-
-- **Multiple table styles** (bordered, simple, minimal, compact, markdown)
-- **Intelligent column sizing** with responsive design
-- **Advanced data formatting** (currency, dates, numbers, booleans)
-- **Color themes and customization**
-- **Export capabilities** (JSON, CSV, arrays)
-- **Professional table rendering** with Unicode support
-
-## ๐๏ธ Architecture
-
-The table system consists of 8 core classes:
-
-### Core Classes
-
-1. **TableBuilder** - Main interface for creating and configuring tables
-2. **TableRenderer** - Handles the actual rendering logic
-3. **TableStyle** - Defines visual styling (borders, characters, spacing)
-4. **Column** - Represents individual column configuration
-5. **TableData** - Data container and processor
-6. **TableFormatter** - Content-specific formatting logic
-7. **ColumnCalculator** - Advanced width calculation algorithms
-8. **TableTheme** - Higher-level theming system
-
-## ๐ Quick Start
-
-### Basic Usage
-
-```php
-use WebFiori\Cli\Table\TableBuilder;
-
-// Create a simple table
-$table = TableBuilder::create()
- ->setHeaders(['Name', 'Email', 'Status'])
- ->addRow(['John Doe', 'john@example.com', 'Active'])
- ->addRow(['Jane Smith', 'jane@example.com', 'Inactive']);
-
-echo $table->render();
-```
-
-### With Data Array
-
-```php
-$data = [
- ['John Doe', 'john@example.com', 'Active'],
- ['Jane Smith', 'jane@example.com', 'Inactive'],
- ['Bob Johnson', 'bob@example.com', 'Active']
-];
-
-$table = TableBuilder::create()
- ->setHeaders(['Name', 'Email', 'Status'])
- ->addRows($data);
-
-echo $table->render();
-```
-
-## ๐จ Styling Options
-
-### Available Styles
-
-```php
-// Different table styles
-$table->useStyle('bordered'); // Default Unicode borders
-$table->useStyle('simple'); // ASCII characters
-$table->useStyle('minimal'); // Minimal borders
-$table->useStyle('compact'); // Space-efficient
-$table->useStyle('markdown'); // Markdown-compatible
-```
-
-### Custom Styles
-
-```php
-use WebFiori\Cli\Table\TableStyle;
-
-$customStyle = TableStyle::custom([
- 'topLeft' => 'โ',
- 'topRight' => 'โ',
- 'horizontal' => 'โ',
- 'vertical' => 'โ',
- 'showBorders' => true
-]);
-
-$table->setStyle($customStyle);
-```
-
-## โ๏ธ Column Configuration
-
-### Basic Configuration
-
-```php
-$table->configureColumn('Name', [
- 'width' => 20,
- 'align' => 'left',
- 'truncate' => true
-]);
-
-$table->configureColumn('Balance', [
- 'width' => 12,
- 'align' => 'right',
- 'formatter' => fn($value) => '$' . number_format($value, 2)
-]);
-```
-
-### Advanced Column Types
-
-```php
-use WebFiori\Cli\Table\Column;
-
-// Numeric column
-$table->configureColumn('Price', [
- 'width' => 10,
- 'align' => 'right',
- 'formatter' => Column::createColumnFormatter('currency', [
- 'symbol' => '$',
- 'decimals' => 2
- ])
-]);
-
-// Date column
-$table->configureColumn('Created', [
- 'formatter' => Column::createColumnFormatter('date', [
- 'format' => 'M j, Y'
- ])
-]);
-
-// Boolean column
-$table->configureColumn('Active', [
- 'formatter' => Column::createColumnFormatter('boolean', [
- 'true_text' => 'โ Yes',
- 'false_text' => 'โ No'
- ])
-]);
-```
-
-## ๐ Color and Themes
-
-### Status-Based Colorization
-
-```php
-$table->colorizeColumn('Status', function($value) {
- return match(strtolower($value)) {
- 'active' => ['color' => 'green', 'bold' => true],
- 'inactive' => ['color' => 'red'],
- 'pending' => ['color' => 'yellow'],
- default => []
- };
-});
-```
-
-### Predefined Themes
-
-```php
-use WebFiori\Cli\Table\TableTheme;
-
-$table->setTheme(TableTheme::dark()); // Dark theme
-$table->setTheme(TableTheme::colorful()); // Colorful theme
-$table->setTheme(TableTheme::professional()); // Professional theme
-$table->setTheme(TableTheme::minimal()); // No colors
-```
-
-### Custom Themes
-
-```php
-$customTheme = TableTheme::custom([
- 'headerColors' => ['color' => 'blue', 'bold' => true],
- 'alternatingRowColors' => [
- [],
- ['background' => 'light-blue']
- ],
- 'useAlternatingRows' => true
-]);
-
-$table->setTheme($customTheme);
-```
-
-## ๐ Data Formatting
-
-### Built-in Formatters
-
-```php
-use WebFiori\Cli\Table\TableFormatter;
-
-$formatter = new TableFormatter();
-
-// Currency formatting
-$formatter->formatCurrency(1250.75, '$', 2); // "$1,250.75"
-
-// Percentage formatting
-$formatter->formatPercentage(85.5, 1); // "85.5%"
-
-// File size formatting
-$formatter->formatFileSize(1048576); // "1.00 MB"
-
-// Duration formatting
-$formatter->formatDuration(3665); // "1h 1m 5s"
-```
-
-### Custom Formatters
-
-```php
-$table->configureColumn('Status', [
- 'formatter' => function($value) {
- return match(strtolower($value)) {
- 'active' => '๐ข Active',
- 'inactive' => '๐ด Inactive',
- 'pending' => '๐ก Pending',
- default => $value
- };
- }
-]);
-```
-
-## ๐ฑ Responsive Design
-
-### Terminal Width Awareness
-
-```php
-// Auto-detect terminal width
-$table->setAutoWidth(true);
-
-// Set maximum width
-$table->setMaxWidth(120);
-
-// Responsive column configuration
-$table->configureColumn('Description', [
- 'minWidth' => 10,
- 'maxWidth' => 50,
- 'truncate' => true
-]);
-```
-
-## ๐พ Data Export
-
-### Export Formats
-
-```php
-use WebFiori\Cli\Table\TableData;
-
-$data = new TableData($headers, $rows);
-
-// Export to JSON
-$json = $data->toJson(true); // Pretty printed
-
-// Export to CSV
-$csv = $data->toCsv(true); // Include headers
-
-// Export to array
-$array = $data->toArray(true); // Include headers
-
-// Export to associative array
-$assoc = $data->toAssociativeArray();
-```
-
-## ๐ง Advanced Features
-
-### Data Filtering and Sorting
-
-```php
-use WebFiori\Cli\Table\TableData;
-
-$data = new TableData($headers, $rows);
-
-// Filter data
-$filtered = $data->filterRows(fn($row) => $row[2] === 'Active');
-
-// Sort by column
-$sorted = $data->sortByColumn(0, true); // Sort by first column, ascending
-
-// Limit results
-$limited = $data->limit(10, 0); // First 10 rows
-```
-
-### Statistics and Analysis
-
-```php
-$data = new TableData($headers, $rows);
-
-// Get column statistics
-$stats = $data->getColumnStatistics(0);
-// Returns: count, non_empty, unique, min, max, avg (for numeric)
-
-// Get column type
-$type = $data->getColumnType(0); // 'string', 'integer', 'float', 'date', 'boolean'
-
-// Get unique values
-$unique = $data->getUniqueValues(0);
-```
-
-### Large Dataset Handling
-
-```php
-// For large datasets, use pagination
-$pageSize = 20;
-$page = 1;
-$offset = ($page - 1) * $pageSize;
-
-$paginatedData = $data->limit($pageSize, $offset);
-
-$table = TableBuilder::create()
- ->setData($paginatedData->toArray())
- ->setTitle("Page $page of " . ceil($data->getRowCount() / $pageSize));
-```
-
-## ๐ฏ Best Practices
-
-### Performance Optimization
-
-1. **Use appropriate column widths** to avoid unnecessary calculations
-2. **Limit data size** for large datasets using pagination
-3. **Cache formatted values** when displaying the same data multiple times
-4. **Use minimal styles** for better performance in resource-constrained environments
-
-### Accessibility
-
-1. **Use high contrast themes** for better visibility
-2. **Provide meaningful column headers**
-3. **Use consistent formatting** across similar data types
-4. **Consider ASCII fallbacks** for terminals without Unicode support
-
-### User Experience
-
-1. **Show loading indicators** for large datasets
-2. **Provide clear empty state messages**
-3. **Use consistent color coding** for status indicators
-4. **Implement responsive design** for different terminal sizes
-
-## ๐ Examples
-
-### Complete User Management Table
-
-```php
-use WebFiori\Cli\Table\TableBuilder;
-use WebFiori\Cli\Table\TableTheme;
-
-$users = [
- ['John Doe', 'john@example.com', 'Active', '2024-01-15', 1250.75, 'Admin'],
- ['Jane Smith', 'jane@example.com', 'Inactive', '2024-01-16', 890.50, 'User'],
- ['Bob Johnson', 'bob@example.com', 'Active', '2024-01-17', 2100.00, 'Manager']
-];
-
-$table = TableBuilder::create()
- ->setHeaders(['Name', 'Email', 'Status', 'Created', 'Balance', 'Role'])
- ->addRows($users)
- ->setTitle('User Management System')
- ->setTheme(TableTheme::professional())
- ->configureColumn('Name', ['width' => 15])
- ->configureColumn('Email', ['width' => 25, 'truncate' => true])
- ->configureColumn('Status', ['width' => 10, 'align' => 'center'])
- ->configureColumn('Created', [
- 'width' => 12,
- 'formatter' => fn($date) => date('M j, Y', strtotime($date))
- ])
- ->configureColumn('Balance', [
- 'width' => 12,
- 'align' => 'right',
- 'formatter' => fn($value) => '$' . number_format($value, 2)
- ])
- ->configureColumn('Role', ['width' => 10, 'align' => 'center'])
- ->colorizeColumn('Status', function($value) {
- return match(strtolower($value)) {
- 'active' => ['color' => 'green', 'bold' => true],
- 'inactive' => ['color' => 'red'],
- default => []
- };
- });
-
-echo $table->render();
-```
-
-### System Status Dashboard
-
-```php
-$services = [
- ['Web Server', 'Active', '99.9%', '45ms', 'โ '],
- ['Database', 'Active', '99.8%', '12ms', 'โ '],
- ['Cache Server', 'Inactive', '0%', 'N/A', 'โ'],
- ['API Gateway', 'Active', '99.7%', '78ms', 'โ ']
-];
-
-$table = TableBuilder::create()
- ->setHeaders(['Service', 'Status', 'Uptime', 'Response Time', 'Health'])
- ->addRows($services)
- ->setTitle('System Status Dashboard')
- ->useStyle('bordered')
- ->configureColumn('Service', ['width' => 15])
- ->configureColumn('Status', ['width' => 10, 'align' => 'center'])
- ->configureColumn('Uptime', ['width' => 8, 'align' => 'right'])
- ->configureColumn('Response Time', ['width' => 15, 'align' => 'right'])
- ->configureColumn('Health', ['width' => 8, 'align' => 'center'])
- ->colorizeColumn('Status', function($value) {
- return match(strtolower($value)) {
- 'active' => ['color' => 'green', 'bold' => true],
- 'inactive' => ['color' => 'red', 'bold' => true],
- default => []
- };
- });
-
-echo $table->render();
-```
-
-## ๐ Troubleshooting
-
-### Common Issues
-
-1. **Unicode characters not displaying**: Use ASCII fallback styles
-2. **Column width issues**: Set explicit widths or adjust terminal size
-3. **Color not showing**: Check terminal color support
-4. **Performance issues**: Limit data size and use simpler styles
-
-### Debug Mode
-
-```php
-// Enable debug information
-$table->setTitle('Debug: ' . $table->getColumnCount() . ' columns, ' . $table->getRowCount() . ' rows');
-```
-
-## ๐ Integration with WebFiori CLI
-
-The table feature integrates seamlessly with existing WebFiori CLI commands:
-
-```php
-use WebFiori\Cli\CLICommand;
-use WebFiori\Cli\Table\TableBuilder;
-
-class ListUsersCommand extends CLICommand {
-
- public function exec(): int {
- $users = $this->getUsersFromDatabase();
-
- $table = TableBuilder::create()
- ->setHeaders(['ID', 'Name', 'Email', 'Status'])
- ->setData($users)
- ->setMaxWidth($this->getTerminalWidth());
-
- $this->println($table->render());
-
- return 0;
- }
-}
-```
-
-## ๐ Future Enhancements
-
-Planned features for future versions:
-
-- **Interactive tables** with sorting and filtering
-- **Nested tables** and hierarchical data display
-- **Chart integration** (bar charts, sparklines)
-- **Export to more formats** (HTML, PDF)
-- **Advanced themes** with gradient colors
-- **Plugin system** for custom renderers
-
----
-
-**WebFiori CLI Table Feature** - Professional tabular data display for command-line applications.
+# WebFiori CLI Table Feature
+
+A comprehensive tabular data display system for CLI applications with advanced formatting, styling, and responsive design capabilities.
+
+## ๐ฏ Overview
+
+The WebFiori CLI Table feature provides a powerful and flexible way to display tabular data in command-line applications. It offers:
+
+- **Multiple table styles** (bordered, simple, minimal, compact, markdown)
+- **Intelligent column sizing** with responsive design
+- **Advanced data formatting** (currency, dates, numbers, booleans)
+- **Color themes and customization**
+- **Export capabilities** (JSON, CSV, arrays)
+- **Professional table rendering** with Unicode support
+
+## ๐๏ธ Architecture
+
+The table system consists of 8 core classes:
+
+### Core Classes
+
+1. **TableBuilder** - Main interface for creating and configuring tables
+2. **TableRenderer** - Handles the actual rendering logic
+3. **TableStyle** - Defines visual styling (borders, characters, spacing)
+4. **Column** - Represents individual column configuration
+5. **TableData** - Data container and processor
+6. **TableFormatter** - Content-specific formatting logic
+7. **ColumnCalculator** - Advanced width calculation algorithms
+8. **TableTheme** - Higher-level theming system
+
+## ๐ Quick Start
+
+### Basic Usage
+
+```php
+use WebFiori\Cli\Table\TableBuilder;
+
+// Create a simple table
+$table = TableBuilder::create()
+ ->setHeaders(['Name', 'Email', 'Status'])
+ ->addRow(['John Doe', 'john@example.com', 'Active'])
+ ->addRow(['Jane Smith', 'jane@example.com', 'Inactive']);
+
+echo $table->render();
+```
+
+### With Data Array
+
+```php
+$data = [
+ ['John Doe', 'john@example.com', 'Active'],
+ ['Jane Smith', 'jane@example.com', 'Inactive'],
+ ['Bob Johnson', 'bob@example.com', 'Active']
+];
+
+$table = TableBuilder::create()
+ ->setHeaders(['Name', 'Email', 'Status'])
+ ->addRows($data);
+
+echo $table->render();
+```
+
+## ๐จ Styling Options
+
+### Available Styles
+
+```php
+// Different table styles
+$table->useStyle('bordered'); // Default Unicode borders
+$table->useStyle('simple'); // ASCII characters
+$table->useStyle('minimal'); // Minimal borders
+$table->useStyle('compact'); // Space-efficient
+$table->useStyle('markdown'); // Markdown-compatible
+```
+
+### Custom Styles
+
+```php
+use WebFiori\Cli\Table\TableStyle;
+
+$customStyle = TableStyle::custom([
+ 'topLeft' => 'โ',
+ 'topRight' => 'โ',
+ 'horizontal' => 'โ',
+ 'vertical' => 'โ',
+ 'showBorders' => true
+]);
+
+$table->setStyle($customStyle);
+```
+
+## โ๏ธ Column Configuration
+
+### Basic Configuration
+
+```php
+$table->configureColumn('Name', [
+ 'width' => 20,
+ 'align' => 'left',
+ 'truncate' => true
+]);
+
+$table->configureColumn('Balance', [
+ 'width' => 12,
+ 'align' => 'right',
+ 'formatter' => fn($value) => '$' . number_format($value, 2)
+]);
+```
+
+### Advanced Column Types
+
+```php
+use WebFiori\Cli\Table\Column;
+
+// Numeric column
+$table->configureColumn('Price', [
+ 'width' => 10,
+ 'align' => 'right',
+ 'formatter' => Column::createColumnFormatter('currency', [
+ 'symbol' => '$',
+ 'decimals' => 2
+ ])
+]);
+
+// Date column
+$table->configureColumn('Created', [
+ 'formatter' => Column::createColumnFormatter('date', [
+ 'format' => 'M j, Y'
+ ])
+]);
+
+// Boolean column
+$table->configureColumn('Active', [
+ 'formatter' => Column::createColumnFormatter('boolean', [
+ 'true_text' => 'โ Yes',
+ 'false_text' => 'โ No'
+ ])
+]);
+```
+
+## ๐ Color and Themes
+
+### Status-Based Colorization
+
+```php
+$table->colorizeColumn('Status', function($value) {
+ return match(strtolower($value)) {
+ 'active' => ['color' => 'green', 'bold' => true],
+ 'inactive' => ['color' => 'red'],
+ 'pending' => ['color' => 'yellow'],
+ default => []
+ };
+});
+```
+
+### Predefined Themes
+
+```php
+use WebFiori\Cli\Table\TableTheme;
+
+$table->setTheme(TableTheme::dark()); // Dark theme
+$table->setTheme(TableTheme::colorful()); // Colorful theme
+$table->setTheme(TableTheme::professional()); // Professional theme
+$table->setTheme(TableTheme::minimal()); // No colors
+```
+
+### Custom Themes
+
+```php
+$customTheme = TableTheme::custom([
+ 'headerColors' => ['color' => 'blue', 'bold' => true],
+ 'alternatingRowColors' => [
+ [],
+ ['background' => 'light-blue']
+ ],
+ 'useAlternatingRows' => true
+]);
+
+$table->setTheme($customTheme);
+```
+
+## ๐ Data Formatting
+
+### Built-in Formatters
+
+```php
+use WebFiori\Cli\Table\TableFormatter;
+
+$formatter = new TableFormatter();
+
+// Currency formatting
+$formatter->formatCurrency(1250.75, '$', 2); // "$1,250.75"
+
+// Percentage formatting
+$formatter->formatPercentage(85.5, 1); // "85.5%"
+
+// File size formatting
+$formatter->formatFileSize(1048576); // "1.00 MB"
+
+// Duration formatting
+$formatter->formatDuration(3665); // "1h 1m 5s"
+```
+
+### Custom Formatters
+
+```php
+$table->configureColumn('Status', [
+ 'formatter' => function($value) {
+ return match(strtolower($value)) {
+ 'active' => '๐ข Active',
+ 'inactive' => '๐ด Inactive',
+ 'pending' => '๐ก Pending',
+ default => $value
+ };
+ }
+]);
+```
+
+## ๐ฑ Responsive Design
+
+### Terminal Width Awareness
+
+```php
+// Auto-detect terminal width
+$table->setAutoWidth(true);
+
+// Set maximum width
+$table->setMaxWidth(120);
+
+// Responsive column configuration
+$table->configureColumn('Description', [
+ 'minWidth' => 10,
+ 'maxWidth' => 50,
+ 'truncate' => true
+]);
+```
+
+## ๐พ Data Export
+
+### Export Formats
+
+```php
+use WebFiori\Cli\Table\TableData;
+
+$data = new TableData($headers, $rows);
+
+// Export to JSON
+$json = $data->toJson(true); // Pretty printed
+
+// Export to CSV
+$csv = $data->toCsv(true); // Include headers
+
+// Export to array
+$array = $data->toArray(true); // Include headers
+
+// Export to associative array
+$assoc = $data->toAssociativeArray();
+```
+
+## ๐ง Advanced Features
+
+### Data Filtering and Sorting
+
+```php
+use WebFiori\Cli\Table\TableData;
+
+$data = new TableData($headers, $rows);
+
+// Filter data
+$filtered = $data->filterRows(fn($row) => $row[2] === 'Active');
+
+// Sort by column
+$sorted = $data->sortByColumn(0, true); // Sort by first column, ascending
+
+// Limit results
+$limited = $data->limit(10, 0); // First 10 rows
+```
+
+### Statistics and Analysis
+
+```php
+$data = new TableData($headers, $rows);
+
+// Get column statistics
+$stats = $data->getColumnStatistics(0);
+// Returns: count, non_empty, unique, min, max, avg (for numeric)
+
+// Get column type
+$type = $data->getColumnType(0); // 'string', 'integer', 'float', 'date', 'boolean'
+
+// Get unique values
+$unique = $data->getUniqueValues(0);
+```
+
+### Large Dataset Handling
+
+```php
+// For large datasets, use pagination
+$pageSize = 20;
+$page = 1;
+$offset = ($page - 1) * $pageSize;
+
+$paginatedData = $data->limit($pageSize, $offset);
+
+$table = TableBuilder::create()
+ ->setData($paginatedData->toArray())
+ ->setTitle("Page $page of " . ceil($data->getRowCount() / $pageSize));
+```
+
+## ๐ฏ Best Practices
+
+### Performance Optimization
+
+1. **Use appropriate column widths** to avoid unnecessary calculations
+2. **Limit data size** for large datasets using pagination
+3. **Cache formatted values** when displaying the same data multiple times
+4. **Use minimal styles** for better performance in resource-constrained environments
+
+### Accessibility
+
+1. **Use high contrast themes** for better visibility
+2. **Provide meaningful column headers**
+3. **Use consistent formatting** across similar data types
+4. **Consider ASCII fallbacks** for terminals without Unicode support
+
+### User Experience
+
+1. **Show loading indicators** for large datasets
+2. **Provide clear empty state messages**
+3. **Use consistent color coding** for status indicators
+4. **Implement responsive design** for different terminal sizes
+
+## ๐ Examples
+
+### Complete User Management Table
+
+```php
+use WebFiori\Cli\Table\TableBuilder;
+use WebFiori\Cli\Table\TableTheme;
+
+$users = [
+ ['John Doe', 'john@example.com', 'Active', '2024-01-15', 1250.75, 'Admin'],
+ ['Jane Smith', 'jane@example.com', 'Inactive', '2024-01-16', 890.50, 'User'],
+ ['Bob Johnson', 'bob@example.com', 'Active', '2024-01-17', 2100.00, 'Manager']
+];
+
+$table = TableBuilder::create()
+ ->setHeaders(['Name', 'Email', 'Status', 'Created', 'Balance', 'Role'])
+ ->addRows($users)
+ ->setTitle('User Management System')
+ ->setTheme(TableTheme::professional())
+ ->configureColumn('Name', ['width' => 15])
+ ->configureColumn('Email', ['width' => 25, 'truncate' => true])
+ ->configureColumn('Status', ['width' => 10, 'align' => 'center'])
+ ->configureColumn('Created', [
+ 'width' => 12,
+ 'formatter' => fn($date) => date('M j, Y', strtotime($date))
+ ])
+ ->configureColumn('Balance', [
+ 'width' => 12,
+ 'align' => 'right',
+ 'formatter' => fn($value) => '$' . number_format($value, 2)
+ ])
+ ->configureColumn('Role', ['width' => 10, 'align' => 'center'])
+ ->colorizeColumn('Status', function($value) {
+ return match(strtolower($value)) {
+ 'active' => ['color' => 'green', 'bold' => true],
+ 'inactive' => ['color' => 'red'],
+ default => []
+ };
+ });
+
+echo $table->render();
+```
+
+### System Status Dashboard
+
+```php
+$services = [
+ ['Web Server', 'Active', '99.9%', '45ms', 'โ '],
+ ['Database', 'Active', '99.8%', '12ms', 'โ '],
+ ['Cache Server', 'Inactive', '0%', 'N/A', 'โ'],
+ ['API Gateway', 'Active', '99.7%', '78ms', 'โ ']
+];
+
+$table = TableBuilder::create()
+ ->setHeaders(['Service', 'Status', 'Uptime', 'Response Time', 'Health'])
+ ->addRows($services)
+ ->setTitle('System Status Dashboard')
+ ->useStyle('bordered')
+ ->configureColumn('Service', ['width' => 15])
+ ->configureColumn('Status', ['width' => 10, 'align' => 'center'])
+ ->configureColumn('Uptime', ['width' => 8, 'align' => 'right'])
+ ->configureColumn('Response Time', ['width' => 15, 'align' => 'right'])
+ ->configureColumn('Health', ['width' => 8, 'align' => 'center'])
+ ->colorizeColumn('Status', function($value) {
+ return match(strtolower($value)) {
+ 'active' => ['color' => 'green', 'bold' => true],
+ 'inactive' => ['color' => 'red', 'bold' => true],
+ default => []
+ };
+ });
+
+echo $table->render();
+```
+
+## ๐ Troubleshooting
+
+### Common Issues
+
+1. **Unicode characters not displaying**: Use ASCII fallback styles
+2. **Column width issues**: Set explicit widths or adjust terminal size
+3. **Color not showing**: Check terminal color support
+4. **Performance issues**: Limit data size and use simpler styles
+
+### Debug Mode
+
+```php
+// Enable debug information
+$table->setTitle('Debug: ' . $table->getColumnCount() . ' columns, ' . $table->getRowCount() . ' rows');
+```
+
+## ๐ Integration with WebFiori CLI
+
+The table feature integrates seamlessly with existing WebFiori CLI commands:
+
+```php
+use WebFiori\Cli\CLICommand;
+use WebFiori\Cli\Table\TableBuilder;
+
+class ListUsersCommand extends CLICommand {
+
+ public function exec(): int {
+ $users = $this->getUsersFromDatabase();
+
+ $table = TableBuilder::create()
+ ->setHeaders(['ID', 'Name', 'Email', 'Status'])
+ ->setData($users)
+ ->setMaxWidth($this->getTerminalWidth());
+
+ $this->println($table->render());
+
+ return 0;
+ }
+}
+```
+
+## ๐ Future Enhancements
+
+Planned features for future versions:
+
+- **Interactive tables** with sorting and filtering
+- **Nested tables** and hierarchical data display
+- **Chart integration** (bar charts, sparklines)
+- **Export to more formats** (HTML, PDF)
+- **Advanced themes** with gradient colors
+- **Plugin system** for custom renderers
+
+---
+
+**WebFiori CLI Table Feature** - Professional tabular data display for command-line applications.
diff --git a/WebFiori/Cli/Table/TableBuilder.php b/WebFiori/Cli/Table/TableBuilder.php
index 33b18b9..273012b 100644
--- a/WebFiori/Cli/Table/TableBuilder.php
+++ b/WebFiori/Cli/Table/TableBuilder.php
@@ -1,297 +1,297 @@
-style = TableStyle::default();
- $this->maxWidth = $this->getTerminalWidth();
- }
-
- /**
- * Add a single row of data.
- */
- public function addRow(array $row): self {
- $this->rows[] = $row;
-
- return $this;
- }
-
- /**
- * Add multiple rows of data.
- */
- public function addRows(array $rows): self {
- foreach ($rows as $row) {
- $this->addRow($row);
- }
-
- return $this;
- }
-
- /**
- * Clear all data but keep configuration.
- */
- public function clear(): self {
- $this->rows = [];
-
- return $this;
- }
-
- /**
- * Apply color to a specific column based on value.
- */
- public function colorizeColumn($column, $colorizer): self {
- $index = is_string($column) ? array_search($column, $this->headers) : $column;
-
- if ($index !== false && $index !== null) {
- if (!isset($this->columns[$index])) {
- $this->columns[$index] = new Column($this->headers[$index] ?? '');
- }
-
- $this->columns[$index]->setColorizer($colorizer);
- }
-
- return $this;
- }
-
- /**
- * Configure a specific column.
- */
- public function configureColumn($column, array $config): self {
- $index = is_string($column) ? array_search($column, $this->headers) : $column;
-
- if ($index !== false && $index !== null) {
- if (!isset($this->columns[$index])) {
- $this->columns[$index] = new Column($this->headers[$index] ?? '');
- }
-
- $this->columns[$index]->configure($config);
- }
-
- return $this;
- }
-
- /**
- * Create a new table builder instance.
- */
- public static function create(): self {
- return new self();
- }
-
- /**
- * Render and output the table directly.
- */
- public function display(): void {
- echo $this->render();
- }
-
- /**
- * Get column count.
- */
- public function getColumnCount(): int {
- return count($this->headers);
- }
-
- /**
- * Get row count.
- */
- public function getRowCount(): int {
- return count($this->rows);
- }
-
- /**
- * Check if table has data.
- */
- public function hasData(): bool {
- return !empty($this->rows);
- }
-
- /**
- * Render the table and return as string.
- */
- public function render(): string {
- $tableData = new TableData($this->headers, $this->rows);
- $renderer = new TableRenderer($this->style, $this->theme);
-
- return $renderer->render(
- $tableData,
- $this->columns,
- $this->maxWidth,
- $this->showHeaders,
- $this->title
- );
- }
-
- /**
- * Reset table to initial state.
- */
- public function reset(): self {
- $this->headers = [];
- $this->rows = [];
- $this->columns = [];
- $this->style = TableStyle::default();
- $this->theme = null;
- $this->maxWidth = $this->getTerminalWidth();
- $this->autoWidth = true;
- $this->showHeaders = true;
- $this->title = '';
-
- return $this;
- }
-
- /**
- * Enable/disable auto width calculation.
- */
- public function setAutoWidth(bool $auto): self {
- $this->autoWidth = $auto;
-
- if ($auto) {
- $this->maxWidth = $this->getTerminalWidth();
- }
-
- return $this;
- }
-
- /**
- * Set all data at once (headers will be array keys if associative).
- */
- public function setData(array $data): self {
- if (empty($data)) {
- return $this;
- }
-
- $firstRow = reset($data);
-
- // If associative array, use keys as headers
- if (is_array($firstRow) && !empty($firstRow)) {
- $keys = array_keys($firstRow);
-
- if (!is_numeric($keys[0])) {
- $this->setHeaders($keys);
- }
- }
-
- $this->addRows($data);
-
- return $this;
- }
-
- /**
- * Set table headers.
- */
- public function setHeaders(array $headers): self {
- $this->headers = $headers;
-
- // Initialize columns if not already configured
- foreach ($headers as $index => $header) {
- if (!isset($this->columns[$index])) {
- $this->columns[$index] = new Column($header);
- }
- }
-
- return $this;
- }
-
- /**
- * Set maximum table width.
- */
- public function setMaxWidth(int $width): self {
- $this->maxWidth = $width;
- $this->autoWidth = false;
-
- return $this;
- }
-
- /**
- * Set table style.
- */
- public function setStyle(TableStyle $style): self {
- $this->style = $style;
-
- return $this;
- }
-
- /**
- * Set table theme.
- */
- public function setTheme(TableTheme $theme): self {
- $this->theme = $theme;
-
- return $this;
- }
-
- /**
- * Set table title.
- */
- public function setTitle(string $title): self {
- $this->title = $title;
-
- return $this;
- }
-
- /**
- * Show/hide table headers.
- */
- public function showHeaders(bool $show = true): self {
- $this->showHeaders = $show;
-
- return $this;
- }
-
- /**
- * Use a predefined style.
- */
- public function useStyle(string $styleName): self {
- $this->style = match (strtolower($styleName)) {
- 'simple' => TableStyle::simple(),
- 'bordered' => TableStyle::bordered(),
- 'minimal' => TableStyle::minimal(),
- 'compact' => TableStyle::compact(),
- 'markdown' => TableStyle::markdown(),
- default => TableStyle::default()
- };
-
- return $this;
- }
-
- /**
- * Get terminal width.
- */
- private function getTerminalWidth(): int {
- // Try to get terminal width from environment
- $width = getenv('COLUMNS');
-
- if ($width !== false && is_numeric($width)) {
- return (int)$width;
- }
-
- // Try using tput command
- $width = exec('tput cols 2>/dev/null');
-
- if (is_numeric($width)) {
- return (int)$width;
- }
-
- // Default fallback
- return 80;
- }
-}
+style = TableStyle::default();
+ $this->maxWidth = $this->getTerminalWidth();
+ }
+
+ /**
+ * Add a single row of data.
+ */
+ public function addRow(array $row): self {
+ $this->rows[] = $row;
+
+ return $this;
+ }
+
+ /**
+ * Add multiple rows of data.
+ */
+ public function addRows(array $rows): self {
+ foreach ($rows as $row) {
+ $this->addRow($row);
+ }
+
+ return $this;
+ }
+
+ /**
+ * Clear all data but keep configuration.
+ */
+ public function clear(): self {
+ $this->rows = [];
+
+ return $this;
+ }
+
+ /**
+ * Apply color to a specific column based on value.
+ */
+ public function colorizeColumn($column, $colorizer): self {
+ $index = is_string($column) ? array_search($column, $this->headers) : $column;
+
+ if ($index !== false && $index !== null) {
+ if (!isset($this->columns[$index])) {
+ $this->columns[$index] = new Column($this->headers[$index] ?? '');
+ }
+
+ $this->columns[$index]->setColorizer($colorizer);
+ }
+
+ return $this;
+ }
+
+ /**
+ * Configure a specific column.
+ */
+ public function configureColumn($column, array $config): self {
+ $index = is_string($column) ? array_search($column, $this->headers) : $column;
+
+ if ($index !== false && $index !== null) {
+ if (!isset($this->columns[$index])) {
+ $this->columns[$index] = new Column($this->headers[$index] ?? '');
+ }
+
+ $this->columns[$index]->configure($config);
+ }
+
+ return $this;
+ }
+
+ /**
+ * Create a new table builder instance.
+ */
+ public static function create(): self {
+ return new self();
+ }
+
+ /**
+ * Render and output the table directly.
+ */
+ public function display(): void {
+ echo $this->render();
+ }
+
+ /**
+ * Get column count.
+ */
+ public function getColumnCount(): int {
+ return count($this->headers);
+ }
+
+ /**
+ * Get row count.
+ */
+ public function getRowCount(): int {
+ return count($this->rows);
+ }
+
+ /**
+ * Check if table has data.
+ */
+ public function hasData(): bool {
+ return !empty($this->rows);
+ }
+
+ /**
+ * Render the table and return as string.
+ */
+ public function render(): string {
+ $tableData = new TableData($this->headers, $this->rows);
+ $renderer = new TableRenderer($this->style, $this->theme);
+
+ return $renderer->render(
+ $tableData,
+ $this->columns,
+ $this->maxWidth,
+ $this->showHeaders,
+ $this->title
+ );
+ }
+
+ /**
+ * Reset table to initial state.
+ */
+ public function reset(): self {
+ $this->headers = [];
+ $this->rows = [];
+ $this->columns = [];
+ $this->style = TableStyle::default();
+ $this->theme = null;
+ $this->maxWidth = $this->getTerminalWidth();
+ $this->autoWidth = true;
+ $this->showHeaders = true;
+ $this->title = '';
+
+ return $this;
+ }
+
+ /**
+ * Enable/disable auto width calculation.
+ */
+ public function setAutoWidth(bool $auto): self {
+ $this->autoWidth = $auto;
+
+ if ($auto) {
+ $this->maxWidth = $this->getTerminalWidth();
+ }
+
+ return $this;
+ }
+
+ /**
+ * Set all data at once (headers will be array keys if associative).
+ */
+ public function setData(array $data): self {
+ if (empty($data)) {
+ return $this;
+ }
+
+ $firstRow = reset($data);
+
+ // If associative array, use keys as headers
+ if (is_array($firstRow) && !empty($firstRow)) {
+ $keys = array_keys($firstRow);
+
+ if (!is_numeric($keys[0])) {
+ $this->setHeaders($keys);
+ }
+ }
+
+ $this->addRows($data);
+
+ return $this;
+ }
+
+ /**
+ * Set table headers.
+ */
+ public function setHeaders(array $headers): self {
+ $this->headers = $headers;
+
+ // Initialize columns if not already configured
+ foreach ($headers as $index => $header) {
+ if (!isset($this->columns[$index])) {
+ $this->columns[$index] = new Column($header);
+ }
+ }
+
+ return $this;
+ }
+
+ /**
+ * Set maximum table width.
+ */
+ public function setMaxWidth(int $width): self {
+ $this->maxWidth = $width;
+ $this->autoWidth = false;
+
+ return $this;
+ }
+
+ /**
+ * Set table style.
+ */
+ public function setStyle(TableStyle $style): self {
+ $this->style = $style;
+
+ return $this;
+ }
+
+ /**
+ * Set table theme.
+ */
+ public function setTheme(TableTheme $theme): self {
+ $this->theme = $theme;
+
+ return $this;
+ }
+
+ /**
+ * Set table title.
+ */
+ public function setTitle(string $title): self {
+ $this->title = $title;
+
+ return $this;
+ }
+
+ /**
+ * Show/hide table headers.
+ */
+ public function showHeaders(bool $show = true): self {
+ $this->showHeaders = $show;
+
+ return $this;
+ }
+
+ /**
+ * Use a predefined style.
+ */
+ public function useStyle(string $styleName): self {
+ $this->style = match (strtolower($styleName)) {
+ 'simple' => TableStyle::simple(),
+ 'bordered' => TableStyle::bordered(),
+ 'minimal' => TableStyle::minimal(),
+ 'compact' => TableStyle::compact(),
+ 'markdown' => TableStyle::markdown(),
+ default => TableStyle::default()
+ };
+
+ return $this;
+ }
+
+ /**
+ * Get terminal width.
+ */
+ private function getTerminalWidth(): int {
+ // Try to get terminal width from environment
+ $width = getenv('COLUMNS');
+
+ if ($width !== false && is_numeric($width)) {
+ return (int)$width;
+ }
+
+ // Try using tput command
+ $width = exec('tput cols 2>/dev/null');
+
+ if (is_numeric($width)) {
+ return (int)$width;
+ }
+
+ // Default fallback
+ return 80;
+ }
+}
diff --git a/WebFiori/Cli/Table/TableData.php b/WebFiori/Cli/Table/TableData.php
index c6d14b0..fef3500 100644
--- a/WebFiori/Cli/Table/TableData.php
+++ b/WebFiori/Cli/Table/TableData.php
@@ -1,525 +1,525 @@
-headers = $headers;
- $this->rows = $this->normalizeRows($rows);
- $this->analyzeData();
- }
-
- /**
- * Add a new row.
- */
- public function addRow(array $row): self {
- $normalizedRow = $this->normalizeRow($row);
- $newRows = $this->rows;
- $newRows[] = $normalizedRow;
-
- return new self($this->headers, $newRows);
- }
-
- /**
- * Filter rows based on a condition.
- */
- public function filterRows(callable $condition): self {
- $filteredRows = array_filter($this->rows, $condition);
-
- return new self($this->headers, array_values($filteredRows));
- }
-
- /**
- * Create TableData from various input formats.
- */
- public static function fromArray(array $data, ?array $headers = null): self {
- if (empty($data)) {
- return new self($headers ?? [], []);
- }
-
- $firstRow = reset($data);
-
- // If no headers provided and first row is associative, use keys as headers
- if ($headers === null && is_array($firstRow) && !empty($firstRow)) {
- $keys = array_keys($firstRow);
-
- if (!is_numeric($keys[0])) {
- $headers = $keys;
- }
- }
-
- // Default headers if still not set
- if ($headers === null) {
- $maxColumns = 0;
-
- foreach ($data as $row) {
- if (is_array($row)) {
- $maxColumns = max($maxColumns, count($row));
- }
- }
-
- $headers = [];
-
- for ($i = 0; $i < $maxColumns; $i++) {
- $headers[] = "Column ".($i + 1);
- }
- }
-
- return new self($headers, $data);
- }
-
- /**
- * Create TableData from CSV.
- */
- public static function fromCsv(string $csv, bool $hasHeaders = true, string $delimiter = ','): self {
- $lines = explode("\n", trim($csv));
- $data = [];
- $headers = null;
-
- foreach ($lines as $line) {
- if (trim($line) === '') {
- continue;
- }
-
- $row = str_getcsv($line, $delimiter, '"', '\\');
-
- if ($hasHeaders && $headers === null) {
- $headers = $row;
- } else {
- $data[] = $row;
- }
- }
-
- return new self($headers ?? [], $data);
- }
-
- /**
- * Create TableData from JSON.
- */
- public static function fromJson(string $json, ?array $headers = null): self {
- $data = json_decode($json, true);
-
- if (!is_array($data)) {
- throw new \InvalidArgumentException('Invalid JSON data for table');
- }
-
- return self::fromArray($data, $headers);
- }
-
- /**
- * Get all statistics.
- */
- public function getAllStatistics(): array {
- return $this->statistics;
- }
-
- /**
- * Get a specific cell value.
- */
- public function getCellValue(int $rowIndex, int $columnIndex): mixed {
- return $this->rows[$rowIndex][$columnIndex] ?? null;
- }
-
- /**
- * Get column count.
- */
- public function getColumnCount(): int {
- return count($this->headers);
- }
-
- /**
- * Get statistics for a column.
- */
- public function getColumnStatistics(int $columnIndex): array {
- return $this->statistics[$columnIndex] ?? [];
- }
-
- /**
- * Get detected type for a column.
- */
- public function getColumnType(int $columnIndex): string {
- return $this->columnTypes[$columnIndex] ?? 'string';
- }
-
- /**
- * Get all column types.
- */
- public function getColumnTypes(): array {
- return $this->columnTypes;
- }
-
- /**
- * Get values for a specific column.
- */
- public function getColumnValues(int $columnIndex): array {
- $values = [];
-
- foreach ($this->rows as $row) {
- $values[] = $row[$columnIndex] ?? '';
- }
-
- return $values;
- }
-
- /**
- * Get table headers.
- */
- public function getHeaders(): array {
- return $this->headers;
- }
-
- /**
- * Get a specific row.
- */
- public function getRow(int $rowIndex): array {
- return $this->rows[$rowIndex] ?? [];
- }
-
- /**
- * Get row count.
- */
- public function getRowCount(): int {
- return count($this->rows);
- }
-
- /**
- * Get table rows.
- */
- public function getRows(): array {
- return $this->rows;
- }
-
- /**
- * Get unique values for a column.
- */
- public function getUniqueValues(int $columnIndex): array {
- $values = $this->getColumnValues($columnIndex);
-
- return array_unique($values);
- }
-
- /**
- * Count occurrences of values in a column.
- */
- public function getValueCounts(int $columnIndex): array {
- $values = $this->getColumnValues($columnIndex);
-
- return array_count_values(array_map('strval', $values));
- }
-
- /**
- * Check if table has data.
- */
- public function hasData(): bool {
- return !empty($this->rows);
- }
-
- /**
- * Check if table is empty.
- */
- public function isEmpty(): bool {
- return empty($this->rows);
- }
-
- /**
- * Limit the number of rows.
- */
- public function limit(int $count, int $offset = 0): self {
- $limitedRows = array_slice($this->rows, $offset, $count);
-
- return new self($this->headers, $limitedRows);
- }
-
- /**
- * Remove a row by index.
- */
- public function removeRow(int $index): self {
- $newRows = $this->rows;
- unset($newRows[$index]);
-
- return new self($this->headers, array_values($newRows));
- }
-
- /**
- * Sort rows by a specific column.
- */
- public function sortByColumn(int $columnIndex, bool $ascending = true): self {
- $sortedRows = $this->rows;
-
- usort($sortedRows, function ($a, $b) use ($columnIndex, $ascending) {
- $valueA = $a[$columnIndex] ?? '';
- $valueB = $b[$columnIndex] ?? '';
-
- // Handle numeric comparison
- if (is_numeric($valueA) && is_numeric($valueB)) {
- $result = $valueA <=> $valueB;
- } else {
- $result = strcasecmp((string)$valueA, (string)$valueB);
- }
-
- return $ascending ? $result : -$result;
- });
-
- return new self($this->headers, $sortedRows);
- }
-
- /**
- * Export data to array format.
- */
- public function toArray(bool $includeHeaders = true): array {
- if ($includeHeaders) {
- return array_merge([$this->headers], $this->rows);
- }
-
- return $this->rows;
- }
-
- /**
- * Export data to associative array format.
- */
- public function toAssociativeArray(): array {
- $result = [];
-
- foreach ($this->rows as $row) {
- $assocRow = [];
-
- foreach ($this->headers as $index => $header) {
- $assocRow[$header] = $row[$index] ?? null;
- }
- $result[] = $assocRow;
- }
-
- return $result;
- }
-
- /**
- * Export data to CSV format.
- */
- public function toCsv(bool $includeHeaders = true, string $delimiter = ','): string {
- $output = '';
-
- if ($includeHeaders) {
- $output .= implode($delimiter, array_map([$this, 'escapeCsvValue'], $this->headers))."\n";
- }
-
- foreach ($this->rows as $row) {
- $output .= implode($delimiter, array_map([$this, 'escapeCsvValue'], $row))."\n";
- }
-
- return $output;
- }
-
- /**
- * Export data to JSON.
- */
- public function toJson(bool $prettyPrint = false): string {
- $data = $this->toAssociativeArray();
- $flags = $prettyPrint ? JSON_PRETTY_PRINT : 0;
-
- return json_encode($data, $flags);
- }
-
- /**
- * Transform data using a callback.
- */
- public function transform(callable $transformer): self {
- $transformedRows = array_map($transformer, $this->rows);
-
- return new self($this->headers, $transformedRows);
- }
-
- /**
- * Analyze data to detect types and calculate statistics.
- */
- private function analyzeData(): void {
- $columnCount = $this->getColumnCount();
-
- for ($i = 0; $i < $columnCount; $i++) {
- $values = $this->getColumnValues($i);
- $this->columnTypes[$i] = $this->detectColumnType($values);
- $this->statistics[$i] = $this->calculateColumnStatistics($values, $this->columnTypes[$i]);
- }
- }
-
- /**
- * Calculate statistics for a column.
- */
- private function calculateColumnStatistics(array $values, string $type): array {
- $stats = [
- 'count' => count($values),
- 'non_empty' => 0,
- 'unique' => 0,
- 'type' => $type
- ];
-
- $nonEmptyValues = array_filter($values, fn($v) => $v !== '' && $v !== null);
- $stats['non_empty'] = count($nonEmptyValues);
- $stats['unique'] = count(array_unique($nonEmptyValues));
-
- if (empty($nonEmptyValues)) {
- return $stats;
- }
-
- // Type-specific statistics
- if (in_array($type, ['integer', 'float'])) {
- $numericValues = array_map('floatval', $nonEmptyValues);
- $stats['min'] = min($numericValues);
- $stats['max'] = max($numericValues);
- $stats['avg'] = array_sum($numericValues) / count($numericValues);
- $stats['sum'] = array_sum($numericValues);
- }
-
- if ($type === 'string') {
- $lengths = array_map('strlen', array_map('strval', $nonEmptyValues));
- $stats['min_length'] = min($lengths);
- $stats['max_length'] = max($lengths);
- $stats['avg_length'] = array_sum($lengths) / count($lengths);
- }
-
- return $stats;
- }
-
- /**
- * Detect the type of a column based on its values.
- */
- private function detectColumnType(array $values): string {
- $types = ['integer' => 0, 'float' => 0, 'date' => 0, 'boolean' => 0, 'string' => 0];
- $totalValues = 0;
-
- foreach ($values as $value) {
- if ($value === '' || $value === null) {
- continue;
- }
-
- $totalValues++;
-
- // Check for integer
- if (is_int($value) || (is_string($value) && ctype_digit(trim($value)))) {
- $types['integer']++;
- continue;
- }
-
- // Check for float
- if (is_float($value) || (is_string($value) && is_numeric(trim($value)))) {
- $types['float']++;
- continue;
- }
-
- // Check for boolean
- if (is_bool($value) || in_array(strtolower(trim((string)$value)), ['true', 'false', '1', '0', 'yes', 'no'])) {
- $types['boolean']++;
- continue;
- }
-
- // Check for date
- if (is_string($value) && $this->isDateString($value)) {
- $types['date']++;
- continue;
- }
-
- // Default to string
- $types['string']++;
- }
-
- if ($totalValues === 0) {
- return 'string';
- }
-
- // Return the type with the highest percentage (>= 80%)
- arsort($types);
- $topType = array_key_first($types);
- $percentage = $types[$topType] / $totalValues;
-
- return $percentage >= 0.8 ? $topType : 'string';
- }
-
- /**
- * Escape a value for CSV output.
- */
- private function escapeCsvValue(mixed $value): string {
- $value = (string)$value;
-
- // If value contains comma, quote, or newline, wrap in quotes and escape quotes
- if (strpos($value, ',') !== false || strpos($value, '"') !== false || strpos($value, "\n") !== false) {
- $value = '"'.str_replace('"', '""', $value).'"';
- }
-
- return $value;
- }
-
- /**
- * Check if a string represents a date.
- */
- private function isDateString(string $value): bool {
- $dateFormats = [
- 'Y-m-d', 'Y-m-d H:i:s', 'Y/m/d', 'Y/m/d H:i:s',
- 'd-m-Y', 'd-m-Y H:i:s', 'd/m/Y', 'd/m/Y H:i:s',
- 'm-d-Y', 'm-d-Y H:i:s', 'm/d/Y', 'm/d/Y H:i:s'
- ];
-
- foreach ($dateFormats as $format) {
- $date = \DateTime::createFromFormat($format, trim($value));
-
- if ($date && $date->format($format) === trim($value)) {
- return true;
- }
- }
-
- // Try strtotime as fallback
- return strtotime($value) !== false;
- }
-
- /**
- * Normalize a single row.
- */
- private function normalizeRow(array $row, ?int $expectedColumns = null): array {
- $expectedColumns = $expectedColumns ?? count($this->headers);
-
- // If associative array, convert to indexed based on headers
- if (!empty($row) && !is_numeric(array_keys($row)[0])) {
- $normalizedRow = [];
-
- foreach ($this->headers as $header) {
- $normalizedRow[] = $row[$header] ?? '';
- }
- $row = $normalizedRow;
- }
-
- // Pad or trim to match expected column count
- if (count($row) < $expectedColumns) {
- $row = array_pad($row, $expectedColumns, '');
- } elseif (count($row) > $expectedColumns) {
- $row = array_slice($row, 0, $expectedColumns);
- }
-
- return $row;
- }
-
- /**
- * Normalize rows to ensure consistent structure.
- */
- private function normalizeRows(array $rows): array {
- $normalized = [];
- $columnCount = count($this->headers);
-
- foreach ($rows as $row) {
- $normalized[] = $this->normalizeRow($row, $columnCount);
- }
-
- return $normalized;
- }
-}
+headers = $headers;
+ $this->rows = $this->normalizeRows($rows);
+ $this->analyzeData();
+ }
+
+ /**
+ * Add a new row.
+ */
+ public function addRow(array $row): self {
+ $normalizedRow = $this->normalizeRow($row);
+ $newRows = $this->rows;
+ $newRows[] = $normalizedRow;
+
+ return new self($this->headers, $newRows);
+ }
+
+ /**
+ * Filter rows based on a condition.
+ */
+ public function filterRows(callable $condition): self {
+ $filteredRows = array_filter($this->rows, $condition);
+
+ return new self($this->headers, array_values($filteredRows));
+ }
+
+ /**
+ * Create TableData from various input formats.
+ */
+ public static function fromArray(array $data, ?array $headers = null): self {
+ if (empty($data)) {
+ return new self($headers ?? [], []);
+ }
+
+ $firstRow = reset($data);
+
+ // If no headers provided and first row is associative, use keys as headers
+ if ($headers === null && is_array($firstRow) && !empty($firstRow)) {
+ $keys = array_keys($firstRow);
+
+ if (!is_numeric($keys[0])) {
+ $headers = $keys;
+ }
+ }
+
+ // Default headers if still not set
+ if ($headers === null) {
+ $maxColumns = 0;
+
+ foreach ($data as $row) {
+ if (is_array($row)) {
+ $maxColumns = max($maxColumns, count($row));
+ }
+ }
+
+ $headers = [];
+
+ for ($i = 0; $i < $maxColumns; $i++) {
+ $headers[] = "Column ".($i + 1);
+ }
+ }
+
+ return new self($headers, $data);
+ }
+
+ /**
+ * Create TableData from CSV.
+ */
+ public static function fromCsv(string $csv, bool $hasHeaders = true, string $delimiter = ','): self {
+ $lines = explode("\n", trim($csv));
+ $data = [];
+ $headers = null;
+
+ foreach ($lines as $line) {
+ if (trim($line) === '') {
+ continue;
+ }
+
+ $row = str_getcsv($line, $delimiter, '"', '\\');
+
+ if ($hasHeaders && $headers === null) {
+ $headers = $row;
+ } else {
+ $data[] = $row;
+ }
+ }
+
+ return new self($headers ?? [], $data);
+ }
+
+ /**
+ * Create TableData from JSON.
+ */
+ public static function fromJson(string $json, ?array $headers = null): self {
+ $data = json_decode($json, true);
+
+ if (!is_array($data)) {
+ throw new \InvalidArgumentException('Invalid JSON data for table');
+ }
+
+ return self::fromArray($data, $headers);
+ }
+
+ /**
+ * Get all statistics.
+ */
+ public function getAllStatistics(): array {
+ return $this->statistics;
+ }
+
+ /**
+ * Get a specific cell value.
+ */
+ public function getCellValue(int $rowIndex, int $columnIndex): mixed {
+ return $this->rows[$rowIndex][$columnIndex] ?? null;
+ }
+
+ /**
+ * Get column count.
+ */
+ public function getColumnCount(): int {
+ return count($this->headers);
+ }
+
+ /**
+ * Get statistics for a column.
+ */
+ public function getColumnStatistics(int $columnIndex): array {
+ return $this->statistics[$columnIndex] ?? [];
+ }
+
+ /**
+ * Get detected type for a column.
+ */
+ public function getColumnType(int $columnIndex): string {
+ return $this->columnTypes[$columnIndex] ?? 'string';
+ }
+
+ /**
+ * Get all column types.
+ */
+ public function getColumnTypes(): array {
+ return $this->columnTypes;
+ }
+
+ /**
+ * Get values for a specific column.
+ */
+ public function getColumnValues(int $columnIndex): array {
+ $values = [];
+
+ foreach ($this->rows as $row) {
+ $values[] = $row[$columnIndex] ?? '';
+ }
+
+ return $values;
+ }
+
+ /**
+ * Get table headers.
+ */
+ public function getHeaders(): array {
+ return $this->headers;
+ }
+
+ /**
+ * Get a specific row.
+ */
+ public function getRow(int $rowIndex): array {
+ return $this->rows[$rowIndex] ?? [];
+ }
+
+ /**
+ * Get row count.
+ */
+ public function getRowCount(): int {
+ return count($this->rows);
+ }
+
+ /**
+ * Get table rows.
+ */
+ public function getRows(): array {
+ return $this->rows;
+ }
+
+ /**
+ * Get unique values for a column.
+ */
+ public function getUniqueValues(int $columnIndex): array {
+ $values = $this->getColumnValues($columnIndex);
+
+ return array_unique($values);
+ }
+
+ /**
+ * Count occurrences of values in a column.
+ */
+ public function getValueCounts(int $columnIndex): array {
+ $values = $this->getColumnValues($columnIndex);
+
+ return array_count_values(array_map('strval', $values));
+ }
+
+ /**
+ * Check if table has data.
+ */
+ public function hasData(): bool {
+ return !empty($this->rows);
+ }
+
+ /**
+ * Check if table is empty.
+ */
+ public function isEmpty(): bool {
+ return empty($this->rows);
+ }
+
+ /**
+ * Limit the number of rows.
+ */
+ public function limit(int $count, int $offset = 0): self {
+ $limitedRows = array_slice($this->rows, $offset, $count);
+
+ return new self($this->headers, $limitedRows);
+ }
+
+ /**
+ * Remove a row by index.
+ */
+ public function removeRow(int $index): self {
+ $newRows = $this->rows;
+ unset($newRows[$index]);
+
+ return new self($this->headers, array_values($newRows));
+ }
+
+ /**
+ * Sort rows by a specific column.
+ */
+ public function sortByColumn(int $columnIndex, bool $ascending = true): self {
+ $sortedRows = $this->rows;
+
+ usort($sortedRows, function ($a, $b) use ($columnIndex, $ascending) {
+ $valueA = $a[$columnIndex] ?? '';
+ $valueB = $b[$columnIndex] ?? '';
+
+ // Handle numeric comparison
+ if (is_numeric($valueA) && is_numeric($valueB)) {
+ $result = $valueA <=> $valueB;
+ } else {
+ $result = strcasecmp((string)$valueA, (string)$valueB);
+ }
+
+ return $ascending ? $result : -$result;
+ });
+
+ return new self($this->headers, $sortedRows);
+ }
+
+ /**
+ * Export data to array format.
+ */
+ public function toArray(bool $includeHeaders = true): array {
+ if ($includeHeaders) {
+ return array_merge([$this->headers], $this->rows);
+ }
+
+ return $this->rows;
+ }
+
+ /**
+ * Export data to associative array format.
+ */
+ public function toAssociativeArray(): array {
+ $result = [];
+
+ foreach ($this->rows as $row) {
+ $assocRow = [];
+
+ foreach ($this->headers as $index => $header) {
+ $assocRow[$header] = $row[$index] ?? null;
+ }
+ $result[] = $assocRow;
+ }
+
+ return $result;
+ }
+
+ /**
+ * Export data to CSV format.
+ */
+ public function toCsv(bool $includeHeaders = true, string $delimiter = ','): string {
+ $output = '';
+
+ if ($includeHeaders) {
+ $output .= implode($delimiter, array_map([$this, 'escapeCsvValue'], $this->headers))."\n";
+ }
+
+ foreach ($this->rows as $row) {
+ $output .= implode($delimiter, array_map([$this, 'escapeCsvValue'], $row))."\n";
+ }
+
+ return $output;
+ }
+
+ /**
+ * Export data to JSON.
+ */
+ public function toJson(bool $prettyPrint = false): string {
+ $data = $this->toAssociativeArray();
+ $flags = $prettyPrint ? JSON_PRETTY_PRINT : 0;
+
+ return json_encode($data, $flags);
+ }
+
+ /**
+ * Transform data using a callback.
+ */
+ public function transform(callable $transformer): self {
+ $transformedRows = array_map($transformer, $this->rows);
+
+ return new self($this->headers, $transformedRows);
+ }
+
+ /**
+ * Analyze data to detect types and calculate statistics.
+ */
+ private function analyzeData(): void {
+ $columnCount = $this->getColumnCount();
+
+ for ($i = 0; $i < $columnCount; $i++) {
+ $values = $this->getColumnValues($i);
+ $this->columnTypes[$i] = $this->detectColumnType($values);
+ $this->statistics[$i] = $this->calculateColumnStatistics($values, $this->columnTypes[$i]);
+ }
+ }
+
+ /**
+ * Calculate statistics for a column.
+ */
+ private function calculateColumnStatistics(array $values, string $type): array {
+ $stats = [
+ 'count' => count($values),
+ 'non_empty' => 0,
+ 'unique' => 0,
+ 'type' => $type
+ ];
+
+ $nonEmptyValues = array_filter($values, fn($v) => $v !== '' && $v !== null);
+ $stats['non_empty'] = count($nonEmptyValues);
+ $stats['unique'] = count(array_unique($nonEmptyValues));
+
+ if (empty($nonEmptyValues)) {
+ return $stats;
+ }
+
+ // Type-specific statistics
+ if (in_array($type, ['integer', 'float'])) {
+ $numericValues = array_map('floatval', $nonEmptyValues);
+ $stats['min'] = min($numericValues);
+ $stats['max'] = max($numericValues);
+ $stats['avg'] = array_sum($numericValues) / count($numericValues);
+ $stats['sum'] = array_sum($numericValues);
+ }
+
+ if ($type === 'string') {
+ $lengths = array_map('strlen', array_map('strval', $nonEmptyValues));
+ $stats['min_length'] = min($lengths);
+ $stats['max_length'] = max($lengths);
+ $stats['avg_length'] = array_sum($lengths) / count($lengths);
+ }
+
+ return $stats;
+ }
+
+ /**
+ * Detect the type of a column based on its values.
+ */
+ private function detectColumnType(array $values): string {
+ $types = ['integer' => 0, 'float' => 0, 'date' => 0, 'boolean' => 0, 'string' => 0];
+ $totalValues = 0;
+
+ foreach ($values as $value) {
+ if ($value === '' || $value === null) {
+ continue;
+ }
+
+ $totalValues++;
+
+ // Check for integer
+ if (is_int($value) || (is_string($value) && ctype_digit(trim($value)))) {
+ $types['integer']++;
+ continue;
+ }
+
+ // Check for float
+ if (is_float($value) || (is_string($value) && is_numeric(trim($value)))) {
+ $types['float']++;
+ continue;
+ }
+
+ // Check for boolean
+ if (is_bool($value) || in_array(strtolower(trim((string)$value)), ['true', 'false', '1', '0', 'yes', 'no'])) {
+ $types['boolean']++;
+ continue;
+ }
+
+ // Check for date
+ if (is_string($value) && $this->isDateString($value)) {
+ $types['date']++;
+ continue;
+ }
+
+ // Default to string
+ $types['string']++;
+ }
+
+ if ($totalValues === 0) {
+ return 'string';
+ }
+
+ // Return the type with the highest percentage (>= 80%)
+ arsort($types);
+ $topType = array_key_first($types);
+ $percentage = $types[$topType] / $totalValues;
+
+ return $percentage >= 0.8 ? $topType : 'string';
+ }
+
+ /**
+ * Escape a value for CSV output.
+ */
+ private function escapeCsvValue(mixed $value): string {
+ $value = (string)$value;
+
+ // If value contains comma, quote, or newline, wrap in quotes and escape quotes
+ if (strpos($value, ',') !== false || strpos($value, '"') !== false || strpos($value, "\n") !== false) {
+ $value = '"'.str_replace('"', '""', $value).'"';
+ }
+
+ return $value;
+ }
+
+ /**
+ * Check if a string represents a date.
+ */
+ private function isDateString(string $value): bool {
+ $dateFormats = [
+ 'Y-m-d', 'Y-m-d H:i:s', 'Y/m/d', 'Y/m/d H:i:s',
+ 'd-m-Y', 'd-m-Y H:i:s', 'd/m/Y', 'd/m/Y H:i:s',
+ 'm-d-Y', 'm-d-Y H:i:s', 'm/d/Y', 'm/d/Y H:i:s'
+ ];
+
+ foreach ($dateFormats as $format) {
+ $date = \DateTime::createFromFormat($format, trim($value));
+
+ if ($date && $date->format($format) === trim($value)) {
+ return true;
+ }
+ }
+
+ // Try strtotime as fallback
+ return strtotime($value) !== false;
+ }
+
+ /**
+ * Normalize a single row.
+ */
+ private function normalizeRow(array $row, ?int $expectedColumns = null): array {
+ $expectedColumns = $expectedColumns ?? count($this->headers);
+
+ // If associative array, convert to indexed based on headers
+ if (!empty($row) && !is_numeric(array_keys($row)[0])) {
+ $normalizedRow = [];
+
+ foreach ($this->headers as $header) {
+ $normalizedRow[] = $row[$header] ?? '';
+ }
+ $row = $normalizedRow;
+ }
+
+ // Pad or trim to match expected column count
+ if (count($row) < $expectedColumns) {
+ $row = array_pad($row, $expectedColumns, '');
+ } elseif (count($row) > $expectedColumns) {
+ $row = array_slice($row, 0, $expectedColumns);
+ }
+
+ return $row;
+ }
+
+ /**
+ * Normalize rows to ensure consistent structure.
+ */
+ private function normalizeRows(array $rows): array {
+ $normalized = [];
+ $columnCount = count($this->headers);
+
+ foreach ($rows as $row) {
+ $normalized[] = $this->normalizeRow($row, $columnCount);
+ }
+
+ return $normalized;
+ }
+}
diff --git a/WebFiori/Cli/Table/TableFormatter.php b/WebFiori/Cli/Table/TableFormatter.php
index e597ac5..f83d504 100644
--- a/WebFiori/Cli/Table/TableFormatter.php
+++ b/WebFiori/Cli/Table/TableFormatter.php
@@ -1,417 +1,417 @@
-initializeDefaultFormatters();
- }
-
- /**
- * Clear all custom formatters.
- */
- public function clearFormatters(): self {
- $this->formatters = [];
- $this->globalFormatters = [];
- $this->initializeDefaultFormatters();
-
- return $this;
- }
-
- /**
- * Create a column-specific formatter.
- */
- public static function createColumnFormatter(string $type, array $options = []): callable {
- return function ($value) use ($type, $options) {
- $formatter = new self();
-
- return match ($type) {
- 'currency' => $formatter->formatCurrency(
- $value,
- $options['symbol'] ?? '$',
- $options['decimals'] ?? 2,
- $options['symbol_first'] ?? true
- ),
- 'percentage' => $formatter->formatPercentage(
- $value,
- $options['decimals'] ?? 1
- ),
- 'date' => $formatter->formatDate(
- $value,
- $options['format'] ?? 'Y-m-d'
- ),
- 'filesize' => $formatter->formatFileSize(
- $value,
- $options['precision'] ?? 2
- ),
- 'duration' => $formatter->formatDuration($value),
- 'boolean' => $formatter->formatBoolean(
- $value,
- $options['true_text'] ?? 'Yes',
- $options['false_text'] ?? 'No'
- ),
- 'number' => $formatter->formatNumber(
- $value,
- $options['decimals'] ?? 2,
- $options['decimal_separator'] ?? '.',
- $options['thousands_separator'] ?? ','
- ),
- default => (string)$value
- };
- };
- }
-
- /**
- * Format a boolean value.
- */
- public function formatBoolean(mixed $value, string $trueText = 'Yes', string $falseText = 'No'): string {
- if (is_bool($value)) {
- return $value ? $trueText : $falseText;
- }
-
- $stringValue = strtolower(trim((string)$value));
-
- return match ($stringValue) {
- 'true', '1', 'yes', 'on', 'enabled' => $trueText,
- 'false', '0', 'no', 'off', 'disabled' => $falseText,
- default => (string)$value
- };
- }
-
- /**
- * Format a cell value based on its type and column configuration.
- */
- public function formatCell(mixed $value, Column $column, string $type = 'string'): string {
- // Handle null/empty values
- if ($value === null || $value === '') {
- return (string)$column->getDefaultValue();
- }
-
- // Apply column-specific formatter first
- $formatter = $column->getFormatter();
-
- if ($formatter !== null && is_callable($formatter)) {
- $value = call_user_func($formatter, $value);
- }
-
- // Apply type-specific formatting
- $formatted = $this->applyTypeFormatting($value, $type);
-
- // Apply global formatters
- $formatted = $this->applyGlobalFormatters($formatted, $type);
-
- return (string)$formatted;
- }
-
- /**
- * Format a currency value.
- */
- public function formatCurrency(
- float|int $amount,
- string $currency = '$',
- int $decimals = 2,
- bool $currencyFirst = true
- ): string {
- $formatted = $this->formatNumber($amount, $decimals);
-
- return $currencyFirst ? $currency.$formatted : $formatted.' '.$currency;
- }
-
- /**
- * Format a date value.
- */
- public function formatDate(mixed $date, string $format = 'Y-m-d'): string {
- if (empty($date)) {
- return '';
- }
-
- try {
- $dateObj = null;
-
- if (is_string($date)) {
- $dateObj = new \DateTime($date);
- } elseif ($date instanceof \DateTime) {
- $dateObj = $date;
- } elseif (is_int($date)) {
- $dateObj = new \DateTime('@'.$date);
- }
-
- if ($dateObj !== null) {
- return $dateObj->format($format);
- }
- } catch (\Exception $e) {
- // Fall through to default return
- }
-
- return (string)$date;
- }
-
- /**
- * Format duration in human-readable format.
- */
- public function formatDuration(int $seconds): string {
- if ($seconds < 60) {
- return $seconds.'s';
- }
-
- if ($seconds < 3600) {
- $minutes = intval($seconds / 60);
- $remainingSeconds = $seconds % 60;
-
- return $minutes.'m'.($remainingSeconds > 0 ? ' '.$remainingSeconds.'s' : '');
- }
-
- if ($seconds < 86400) {
- $hours = intval($seconds / 3600);
- $remainingMinutes = intval(($seconds % 3600) / 60);
-
- return $hours.'h'.($remainingMinutes > 0 ? ' '.$remainingMinutes.'m' : '');
- }
-
- $days = intval($seconds / 86400);
- $remainingHours = intval(($seconds % 86400) / 3600);
-
- return $days.'d'.($remainingHours > 0 ? ' '.$remainingHours.'h' : '');
- }
-
- /**
- * Format file size in human-readable format.
- */
- public function formatFileSize(int $bytes, int $precision = 2): string {
- $units = ['B', 'KB', 'MB', 'GB', 'TB', 'PB'];
-
- for ($i = 0; $bytes >= 1024 && $i < count($units) - 1; $i++) {
- $bytes /= 1024;
- }
-
- // For bytes (B), don't show decimal places
- if ($i === 0) {
- return round($bytes).' '.$units[$i];
- }
-
- return number_format($bytes, $precision).' '.$units[$i];
- }
-
- /**
- * Format a header value.
- */
- public function formatHeader(string $header): string {
- // Apply any header-specific formatting (but not cell formatters)
- return $this->applyHeaderFormatting($header);
- }
-
- /**
- * Format a number with specified precision and thousands separator.
- */
- public function formatNumber(
- float|int $number,
- int $decimals = 2,
- string $decimalSeparator = '.',
- string $thousandsSeparator = ','
- ): string {
- return number_format((float)$number, $decimals, $decimalSeparator, $thousandsSeparator);
- }
-
- /**
- * Format a percentage value.
- */
- public function formatPercentage(float|int $value, int $decimals = 1): string {
- return $this->formatNumber($value, $decimals).'%';
- }
-
- /**
- * Get available formatter types.
- */
- public function getAvailableTypes(): array {
- return array_merge(
- ['string', 'integer', 'float', 'date', 'boolean'],
- array_keys($this->formatters)
- );
- }
-
- /**
- * Register a custom formatter for a specific type.
- */
- public function registerFormatter(string $type, callable $formatter): self {
- $this->formatters[$type] = $formatter;
-
- return $this;
- }
-
- /**
- * Register a global formatter that applies to all values.
- */
- public function registerGlobalFormatter(callable $formatter): self {
- $this->globalFormatters[] = $formatter;
-
- return $this;
- }
-
- /**
- * Truncate text with smart word boundary detection.
- */
- public function smartTruncate(string $text, int $maxLength, string $ellipsis = '...'): string {
- if (strlen($text) <= $maxLength) {
- return $text;
- }
-
- $ellipsisLength = strlen($ellipsis);
- $maxContentLength = $maxLength - $ellipsisLength;
-
- if ($maxContentLength <= 0) {
- return str_repeat('.', min($maxLength, 3));
- }
-
- // Try to break at word boundary
- $truncated = substr($text, 0, $maxContentLength);
- $lastSpace = strrpos($truncated, ' ');
-
- if ($lastSpace !== false && $lastSpace > $maxContentLength * 0.7) {
- $truncated = substr($truncated, 0, $lastSpace);
- }
-
- return $truncated.$ellipsis;
- }
-
- /**
- * Apply global formatters to a value.
- */
- private function applyGlobalFormatters(mixed $value, string $type): mixed {
- foreach ($this->globalFormatters as $formatter) {
- $value = call_user_func($formatter, $value, $type);
- }
-
- return $value;
- }
-
- /**
- * Apply header-specific formatting.
- */
- private function applyHeaderFormatting(string $header): string {
- // Convert to title case and clean up
- $formatted = ucwords(str_replace(['_', '-'], ' ', $header));
-
- // Apply any registered header formatters
- if (isset($this->formatters['header'])) {
- $formatted = call_user_func($this->formatters['header'], $formatted);
- }
-
- return $formatted;
- }
-
- /**
- * Apply type-specific formatting.
- */
- private function applyTypeFormatting(mixed $value, string $type): mixed {
- // Check for registered custom formatter
- if (isset($this->formatters[$type])) {
- return call_user_func($this->formatters[$type], $value);
- }
-
- // Apply built-in type formatting
- return match ($type) {
- 'integer' => $this->formatInteger($value),
- 'float' => $this->formatFloat($value),
- 'date' => $this->formatDate($value),
- 'boolean' => $this->formatBoolean($value),
- 'currency' => $this->formatCurrency($value),
- 'percentage' => $this->formatPercentage($value),
- 'filesize' => $this->formatFileSize($value),
- 'duration' => $this->formatDuration($value),
- default => $value
- };
- }
-
- /**
- * Format float values.
- */
- private function formatFloat(mixed $value): string {
- if (!is_numeric($value)) {
- return (string)$value;
- }
-
- // Auto-detect decimal places needed
- $floatValue = (float)$value;
- $decimals = 2;
-
- // If it's a whole number, show no decimals
- if ($floatValue == intval($floatValue)) {
- $decimals = 0;
- }
-
- return number_format($floatValue, $decimals, '.', ',');
- }
-
- /**
- * Format integer values.
- */
- private function formatInteger(mixed $value): string {
- if (!is_numeric($value)) {
- return (string)$value;
- }
-
- return number_format((int)$value, 0, '.', ',');
- }
-
- /**
- * Initialize default formatters.
- */
- private function initializeDefaultFormatters(): void {
- // Email formatter
- $this->registerFormatter('email', function ($value) {
- if (filter_var($value, FILTER_VALIDATE_EMAIL)) {
- return $value;
- }
-
- return (string)$value;
- });
-
- // URL formatter
- $this->registerFormatter('url', function ($value) {
- if (filter_var($value, FILTER_VALIDATE_URL)) {
- return $value;
- }
-
- return (string)$value;
- });
-
- // Phone number formatter (basic)
- $this->registerFormatter('phone', function ($value) {
- $cleaned = preg_replace('/[^0-9]/', '', (string)$value);
-
- if (strlen($cleaned) === 10) {
- return sprintf('(%s) %s-%s',
- substr($cleaned, 0, 3),
- substr($cleaned, 3, 3),
- substr($cleaned, 6)
- );
- }
-
- return (string)$value;
- });
-
- // Status formatter with color hints
- $this->registerFormatter('status', function ($value) {
- $status = strtolower(trim((string)$value));
-
- return match ($status) {
- 'active', 'enabled', 'online', 'success', 'completed' => 'โ '.ucfirst($status),
- 'inactive', 'disabled', 'offline', 'failed', 'error' => 'โ '.ucfirst($status),
- 'pending', 'processing', 'warning' => 'โ ๏ธ '.ucfirst($status),
- 'unknown', 'n/a', '' => 'โ Unknown',
- default => ucfirst($status)
- };
- });
- }
-}
+initializeDefaultFormatters();
+ }
+
+ /**
+ * Clear all custom formatters.
+ */
+ public function clearFormatters(): self {
+ $this->formatters = [];
+ $this->globalFormatters = [];
+ $this->initializeDefaultFormatters();
+
+ return $this;
+ }
+
+ /**
+ * Create a column-specific formatter.
+ */
+ public static function createColumnFormatter(string $type, array $options = []): callable {
+ return function ($value) use ($type, $options) {
+ $formatter = new self();
+
+ return match ($type) {
+ 'currency' => $formatter->formatCurrency(
+ $value,
+ $options['symbol'] ?? '$',
+ $options['decimals'] ?? 2,
+ $options['symbol_first'] ?? true
+ ),
+ 'percentage' => $formatter->formatPercentage(
+ $value,
+ $options['decimals'] ?? 1
+ ),
+ 'date' => $formatter->formatDate(
+ $value,
+ $options['format'] ?? 'Y-m-d'
+ ),
+ 'filesize' => $formatter->formatFileSize(
+ $value,
+ $options['precision'] ?? 2
+ ),
+ 'duration' => $formatter->formatDuration($value),
+ 'boolean' => $formatter->formatBoolean(
+ $value,
+ $options['true_text'] ?? 'Yes',
+ $options['false_text'] ?? 'No'
+ ),
+ 'number' => $formatter->formatNumber(
+ $value,
+ $options['decimals'] ?? 2,
+ $options['decimal_separator'] ?? '.',
+ $options['thousands_separator'] ?? ','
+ ),
+ default => (string)$value
+ };
+ };
+ }
+
+ /**
+ * Format a boolean value.
+ */
+ public function formatBoolean(mixed $value, string $trueText = 'Yes', string $falseText = 'No'): string {
+ if (is_bool($value)) {
+ return $value ? $trueText : $falseText;
+ }
+
+ $stringValue = strtolower(trim((string)$value));
+
+ return match ($stringValue) {
+ 'true', '1', 'yes', 'on', 'enabled' => $trueText,
+ 'false', '0', 'no', 'off', 'disabled' => $falseText,
+ default => (string)$value
+ };
+ }
+
+ /**
+ * Format a cell value based on its type and column configuration.
+ */
+ public function formatCell(mixed $value, Column $column, string $type = 'string'): string {
+ // Handle null/empty values
+ if ($value === null || $value === '') {
+ return (string)$column->getDefaultValue();
+ }
+
+ // Apply column-specific formatter first
+ $formatter = $column->getFormatter();
+
+ if ($formatter !== null && is_callable($formatter)) {
+ $value = call_user_func($formatter, $value);
+ }
+
+ // Apply type-specific formatting
+ $formatted = $this->applyTypeFormatting($value, $type);
+
+ // Apply global formatters
+ $formatted = $this->applyGlobalFormatters($formatted, $type);
+
+ return (string)$formatted;
+ }
+
+ /**
+ * Format a currency value.
+ */
+ public function formatCurrency(
+ float|int $amount,
+ string $currency = '$',
+ int $decimals = 2,
+ bool $currencyFirst = true
+ ): string {
+ $formatted = $this->formatNumber($amount, $decimals);
+
+ return $currencyFirst ? $currency.$formatted : $formatted.' '.$currency;
+ }
+
+ /**
+ * Format a date value.
+ */
+ public function formatDate(mixed $date, string $format = 'Y-m-d'): string {
+ if (empty($date)) {
+ return '';
+ }
+
+ try {
+ $dateObj = null;
+
+ if (is_string($date)) {
+ $dateObj = new \DateTime($date);
+ } elseif ($date instanceof \DateTime) {
+ $dateObj = $date;
+ } elseif (is_int($date)) {
+ $dateObj = new \DateTime('@'.$date);
+ }
+
+ if ($dateObj !== null) {
+ return $dateObj->format($format);
+ }
+ } catch (\Exception $e) {
+ // Fall through to default return
+ }
+
+ return (string)$date;
+ }
+
+ /**
+ * Format duration in human-readable format.
+ */
+ public function formatDuration(int $seconds): string {
+ if ($seconds < 60) {
+ return $seconds.'s';
+ }
+
+ if ($seconds < 3600) {
+ $minutes = intval($seconds / 60);
+ $remainingSeconds = $seconds % 60;
+
+ return $minutes.'m'.($remainingSeconds > 0 ? ' '.$remainingSeconds.'s' : '');
+ }
+
+ if ($seconds < 86400) {
+ $hours = intval($seconds / 3600);
+ $remainingMinutes = intval(($seconds % 3600) / 60);
+
+ return $hours.'h'.($remainingMinutes > 0 ? ' '.$remainingMinutes.'m' : '');
+ }
+
+ $days = intval($seconds / 86400);
+ $remainingHours = intval(($seconds % 86400) / 3600);
+
+ return $days.'d'.($remainingHours > 0 ? ' '.$remainingHours.'h' : '');
+ }
+
+ /**
+ * Format file size in human-readable format.
+ */
+ public function formatFileSize(int $bytes, int $precision = 2): string {
+ $units = ['B', 'KB', 'MB', 'GB', 'TB', 'PB'];
+
+ for ($i = 0; $bytes >= 1024 && $i < count($units) - 1; $i++) {
+ $bytes /= 1024;
+ }
+
+ // For bytes (B), don't show decimal places
+ if ($i === 0) {
+ return round($bytes).' '.$units[$i];
+ }
+
+ return number_format($bytes, $precision).' '.$units[$i];
+ }
+
+ /**
+ * Format a header value.
+ */
+ public function formatHeader(string $header): string {
+ // Apply any header-specific formatting (but not cell formatters)
+ return $this->applyHeaderFormatting($header);
+ }
+
+ /**
+ * Format a number with specified precision and thousands separator.
+ */
+ public function formatNumber(
+ float|int $number,
+ int $decimals = 2,
+ string $decimalSeparator = '.',
+ string $thousandsSeparator = ','
+ ): string {
+ return number_format((float)$number, $decimals, $decimalSeparator, $thousandsSeparator);
+ }
+
+ /**
+ * Format a percentage value.
+ */
+ public function formatPercentage(float|int $value, int $decimals = 1): string {
+ return $this->formatNumber($value, $decimals).'%';
+ }
+
+ /**
+ * Get available formatter types.
+ */
+ public function getAvailableTypes(): array {
+ return array_merge(
+ ['string', 'integer', 'float', 'date', 'boolean'],
+ array_keys($this->formatters)
+ );
+ }
+
+ /**
+ * Register a custom formatter for a specific type.
+ */
+ public function registerFormatter(string $type, callable $formatter): self {
+ $this->formatters[$type] = $formatter;
+
+ return $this;
+ }
+
+ /**
+ * Register a global formatter that applies to all values.
+ */
+ public function registerGlobalFormatter(callable $formatter): self {
+ $this->globalFormatters[] = $formatter;
+
+ return $this;
+ }
+
+ /**
+ * Truncate text with smart word boundary detection.
+ */
+ public function smartTruncate(string $text, int $maxLength, string $ellipsis = '...'): string {
+ if (strlen($text) <= $maxLength) {
+ return $text;
+ }
+
+ $ellipsisLength = strlen($ellipsis);
+ $maxContentLength = $maxLength - $ellipsisLength;
+
+ if ($maxContentLength <= 0) {
+ return str_repeat('.', min($maxLength, 3));
+ }
+
+ // Try to break at word boundary
+ $truncated = substr($text, 0, $maxContentLength);
+ $lastSpace = strrpos($truncated, ' ');
+
+ if ($lastSpace !== false && $lastSpace > $maxContentLength * 0.7) {
+ $truncated = substr($truncated, 0, $lastSpace);
+ }
+
+ return $truncated.$ellipsis;
+ }
+
+ /**
+ * Apply global formatters to a value.
+ */
+ private function applyGlobalFormatters(mixed $value, string $type): mixed {
+ foreach ($this->globalFormatters as $formatter) {
+ $value = call_user_func($formatter, $value, $type);
+ }
+
+ return $value;
+ }
+
+ /**
+ * Apply header-specific formatting.
+ */
+ private function applyHeaderFormatting(string $header): string {
+ // Convert to title case and clean up
+ $formatted = ucwords(str_replace(['_', '-'], ' ', $header));
+
+ // Apply any registered header formatters
+ if (isset($this->formatters['header'])) {
+ $formatted = call_user_func($this->formatters['header'], $formatted);
+ }
+
+ return $formatted;
+ }
+
+ /**
+ * Apply type-specific formatting.
+ */
+ private function applyTypeFormatting(mixed $value, string $type): mixed {
+ // Check for registered custom formatter
+ if (isset($this->formatters[$type])) {
+ return call_user_func($this->formatters[$type], $value);
+ }
+
+ // Apply built-in type formatting
+ return match ($type) {
+ 'integer' => $this->formatInteger($value),
+ 'float' => $this->formatFloat($value),
+ 'date' => $this->formatDate($value),
+ 'boolean' => $this->formatBoolean($value),
+ 'currency' => $this->formatCurrency($value),
+ 'percentage' => $this->formatPercentage($value),
+ 'filesize' => $this->formatFileSize($value),
+ 'duration' => $this->formatDuration($value),
+ default => $value
+ };
+ }
+
+ /**
+ * Format float values.
+ */
+ private function formatFloat(mixed $value): string {
+ if (!is_numeric($value)) {
+ return (string)$value;
+ }
+
+ // Auto-detect decimal places needed
+ $floatValue = (float)$value;
+ $decimals = 2;
+
+ // If it's a whole number, show no decimals
+ if ($floatValue == intval($floatValue)) {
+ $decimals = 0;
+ }
+
+ return number_format($floatValue, $decimals, '.', ',');
+ }
+
+ /**
+ * Format integer values.
+ */
+ private function formatInteger(mixed $value): string {
+ if (!is_numeric($value)) {
+ return (string)$value;
+ }
+
+ return number_format((int)$value, 0, '.', ',');
+ }
+
+ /**
+ * Initialize default formatters.
+ */
+ private function initializeDefaultFormatters(): void {
+ // Email formatter
+ $this->registerFormatter('email', function ($value) {
+ if (filter_var($value, FILTER_VALIDATE_EMAIL)) {
+ return $value;
+ }
+
+ return (string)$value;
+ });
+
+ // URL formatter
+ $this->registerFormatter('url', function ($value) {
+ if (filter_var($value, FILTER_VALIDATE_URL)) {
+ return $value;
+ }
+
+ return (string)$value;
+ });
+
+ // Phone number formatter (basic)
+ $this->registerFormatter('phone', function ($value) {
+ $cleaned = preg_replace('/[^0-9]/', '', (string)$value);
+
+ if (strlen($cleaned) === 10) {
+ return sprintf('(%s) %s-%s',
+ substr($cleaned, 0, 3),
+ substr($cleaned, 3, 3),
+ substr($cleaned, 6)
+ );
+ }
+
+ return (string)$value;
+ });
+
+ // Status formatter with color hints
+ $this->registerFormatter('status', function ($value) {
+ $status = strtolower(trim((string)$value));
+
+ return match ($status) {
+ 'active', 'enabled', 'online', 'success', 'completed' => 'โ '.ucfirst($status),
+ 'inactive', 'disabled', 'offline', 'failed', 'error' => 'โ '.ucfirst($status),
+ 'pending', 'processing', 'warning' => 'โ ๏ธ '.ucfirst($status),
+ 'unknown', 'n/a', '' => 'โ Unknown',
+ default => ucfirst($status)
+ };
+ });
+ }
+}
diff --git a/WebFiori/Cli/Table/TableOptions.php b/WebFiori/Cli/Table/TableOptions.php
index ea4dc10..4ed0716 100644
--- a/WebFiori/Cli/Table/TableOptions.php
+++ b/WebFiori/Cli/Table/TableOptions.php
@@ -1,368 +1,368 @@
- function($value) {
- * return match(strtolower($value)) {
- * 'active' => ['color' => 'green', 'bold' => true],
- * 'inactive' => ['color' => 'red'],
- * default => []
- * };
- * }
- * ]
- * ```
- *
- * @var string
- */
- const COLORIZE = 'colorize';
-
- /**
- * Column configuration option key.
- *
- * Specifies column-specific configuration as an associative array.
- * The key should be the column name or index, and the value should be
- * an array of column configuration options.
- *
- * Example:
- * ```php
- * [
- * 'Price' => [
- * 'align' => 'right',
- * 'width' => 10,
- * 'formatter' => fn($v) => '$' . number_format($v, 2)
- * ]
- * ]
- * ```
- *
- * @var string
- */
- const COLUMNS = 'columns';
-
- /**
- * Truncation ellipsis option key.
- *
- * Specifies the string to use when truncating long content.
- *
- * Default value: '...'
- *
- * @var string
- */
- const ELLIPSIS = 'ellipsis';
-
- /**
- * Filter option key.
- *
- * Specifies filtering configuration for the table data.
- *
- * Should be a callable that receives a row and returns true/false:
- * ```php
- * function($row) {
- * return $row['status'] === 'active';
- * }
- * ```
- *
- * @var string
- */
- const FILTER = 'filter';
-
- /**
- * Limit option key.
- *
- * Specifies the maximum number of rows to display.
- *
- * Can be:
- * - An integer: Maximum number of rows
- * - An array: ['limit' => 10, 'offset' => 0]
- *
- * @var string
- */
- const LIMIT = 'limit';
-
- /**
- * Table padding option key.
- *
- * Specifies the padding configuration for table cells.
- *
- * Can be:
- * - An integer: Same padding for all sides
- * - An array: ['left' => 1, 'right' => 1, 'top' => 0, 'bottom' => 0]
- *
- * @var string
- */
- const PADDING = 'padding';
-
- /**
- * Header separator option key.
- *
- * Specifies whether to show a separator between headers and data.
- *
- * Supported values:
- * - true (default): Show header separator
- * - false: Hide header separator
- *
- * @var string
- */
- const SHOW_HEADER_SEPARATOR = 'showHeaderSeparator';
-
- /**
- * Show headers option key.
- *
- * Specifies whether to display column headers.
- *
- * Supported values:
- * - true (default): Show column headers
- * - false: Hide column headers
- *
- * @var string
- */
- const SHOW_HEADERS = 'showHeaders';
-
- /**
- * Row separators option key.
- *
- * Specifies whether to show separators between data rows.
- *
- * Supported values:
- * - true: Show row separators
- * - false (default): Hide row separators
- *
- * @var string
- */
- const SHOW_ROW_SEPARATORS = 'showRowSeparators';
-
- /**
- * Sort option key.
- *
- * Specifies sorting configuration for the table data.
- *
- * Can be:
- * - A string: Column name to sort by (ascending)
- * - An array: ['column' => 'Name', 'direction' => 'asc|desc']
- *
- * @var string
- */
- const SORT = 'sort';
-
- /**
- * Table style option key.
- *
- * Specifies the visual style of the table borders and layout.
- *
- * Supported values:
- * - 'bordered' (default): Unicode box-drawing characters
- * - 'simple': ASCII characters for compatibility
- * - 'minimal': Clean look with minimal borders
- * - 'compact': Space-efficient layout
- * - 'markdown': Markdown-compatible format
- *
- * @var string
- */
- const STYLE = 'style';
-
- /**
- * Color theme option key.
- *
- * Specifies the color scheme to apply to the table.
- *
- * Supported values:
- * - 'default' (default): Standard theme with basic colors
- * - 'dark': Optimized for dark terminals
- * - 'light': Optimized for light terminals
- * - 'colorful': Vibrant colors and styling
- * - 'professional': Business-appropriate styling
- * - 'minimal': No colors, just formatting
- *
- * @var string
- */
- const THEME = 'theme';
-
- /**
- * Table title option key.
- *
- * Specifies a title to display above the table.
- * The title will be centered and styled according to the current theme.
- *
- * @var string
- */
- const TITLE = 'title';
-
- /**
- * Maximum table width option key.
- *
- * Specifies the maximum width of the table in characters.
- * If not specified, the terminal width will be auto-detected.
- *
- * @var string
- */
- const WIDTH = 'width';
-
- /**
- * Word wrap option key.
- *
- * Specifies whether to enable word wrapping for long content.
- *
- * Supported values:
- * - true: Enable word wrapping
- * - false (default): Disable word wrapping (content will be truncated)
- *
- * @var string
- */
- const WORD_WRAP = 'wordWrap';
-
- /**
- * Get all available option keys.
- *
- * Returns an array of all available option constants that can be used
- * with the Command::table() method.
- *
- * @return array Array of option key constants
- */
- public static function getAllOptions(): array {
- return [
- self::STYLE,
- self::THEME,
- self::TITLE,
- self::WIDTH,
- self::SHOW_HEADERS,
- self::COLUMNS,
- self::COLORIZE,
- self::AUTO_WIDTH,
- self::SHOW_ROW_SEPARATORS,
- self::SHOW_HEADER_SEPARATOR,
- self::PADDING,
- self::WORD_WRAP,
- self::ELLIPSIS,
- self::SORT,
- self::LIMIT,
- self::FILTER
- ];
- }
-
- /**
- * Get data-related option keys.
- *
- * Returns an array of option keys that affect how data is processed
- * and displayed in the table.
- *
- * @return array Array of data-related option keys
- */
- public static function getDataOptions(): array {
- return [
- self::COLUMNS,
- self::COLORIZE,
- self::SORT,
- self::LIMIT,
- self::FILTER
- ];
- }
-
- /**
- * Get default values for table options.
- *
- * Returns an array of default values for table options.
- *
- * @return array Array of default option values
- */
- public static function getDefaults(): array {
- return [
- self::STYLE => 'bordered',
- self::THEME => 'default',
- self::TITLE => null,
- self::WIDTH => 0, // Auto-detect
- self::SHOW_HEADERS => true,
- self::COLUMNS => [],
- self::COLORIZE => [],
- self::AUTO_WIDTH => true,
- self::SHOW_ROW_SEPARATORS => false,
- self::SHOW_HEADER_SEPARATOR => true,
- self::PADDING => ['left' => 1, 'right' => 1],
- self::WORD_WRAP => false,
- self::ELLIPSIS => '...',
- self::SORT => null,
- self::LIMIT => null,
- self::FILTER => null
- ];
- }
-
- /**
- * Get layout-related option keys.
- *
- * Returns an array of option keys that affect the layout and sizing
- * of the table.
- *
- * @return array Array of layout-related option keys
- */
- public static function getLayoutOptions(): array {
- return [
- self::WIDTH,
- self::AUTO_WIDTH,
- self::WORD_WRAP,
- self::SHOW_HEADERS,
- self::TITLE
- ];
- }
-
- /**
- * Get style-related option keys.
- *
- * Returns an array of option keys that affect the visual appearance
- * of the table.
- *
- * @return array Array of style-related option keys
- */
- public static function getStyleOptions(): array {
- return [
- self::STYLE,
- self::THEME,
- self::SHOW_ROW_SEPARATORS,
- self::SHOW_HEADER_SEPARATOR,
- self::PADDING,
- self::ELLIPSIS
- ];
- }
-
- /**
- * Validate option key.
- *
- * Checks if the given option key is a valid table option.
- *
- * @param string $optionKey The option key to validate
- * @return bool True if the option key is valid, false otherwise
- */
- public static function isValidOption(string $optionKey): bool {
- return in_array($optionKey, self::getAllOptions(), true);
- }
-}
+ function($value) {
+ * return match(strtolower($value)) {
+ * 'active' => ['color' => 'green', 'bold' => true],
+ * 'inactive' => ['color' => 'red'],
+ * default => []
+ * };
+ * }
+ * ]
+ * ```
+ *
+ * @var string
+ */
+ const COLORIZE = 'colorize';
+
+ /**
+ * Column configuration option key.
+ *
+ * Specifies column-specific configuration as an associative array.
+ * The key should be the column name or index, and the value should be
+ * an array of column configuration options.
+ *
+ * Example:
+ * ```php
+ * [
+ * 'Price' => [
+ * 'align' => 'right',
+ * 'width' => 10,
+ * 'formatter' => fn($v) => '$' . number_format($v, 2)
+ * ]
+ * ]
+ * ```
+ *
+ * @var string
+ */
+ const COLUMNS = 'columns';
+
+ /**
+ * Truncation ellipsis option key.
+ *
+ * Specifies the string to use when truncating long content.
+ *
+ * Default value: '...'
+ *
+ * @var string
+ */
+ const ELLIPSIS = 'ellipsis';
+
+ /**
+ * Filter option key.
+ *
+ * Specifies filtering configuration for the table data.
+ *
+ * Should be a callable that receives a row and returns true/false:
+ * ```php
+ * function($row) {
+ * return $row['status'] === 'active';
+ * }
+ * ```
+ *
+ * @var string
+ */
+ const FILTER = 'filter';
+
+ /**
+ * Limit option key.
+ *
+ * Specifies the maximum number of rows to display.
+ *
+ * Can be:
+ * - An integer: Maximum number of rows
+ * - An array: ['limit' => 10, 'offset' => 0]
+ *
+ * @var string
+ */
+ const LIMIT = 'limit';
+
+ /**
+ * Table padding option key.
+ *
+ * Specifies the padding configuration for table cells.
+ *
+ * Can be:
+ * - An integer: Same padding for all sides
+ * - An array: ['left' => 1, 'right' => 1, 'top' => 0, 'bottom' => 0]
+ *
+ * @var string
+ */
+ const PADDING = 'padding';
+
+ /**
+ * Header separator option key.
+ *
+ * Specifies whether to show a separator between headers and data.
+ *
+ * Supported values:
+ * - true (default): Show header separator
+ * - false: Hide header separator
+ *
+ * @var string
+ */
+ const SHOW_HEADER_SEPARATOR = 'showHeaderSeparator';
+
+ /**
+ * Show headers option key.
+ *
+ * Specifies whether to display column headers.
+ *
+ * Supported values:
+ * - true (default): Show column headers
+ * - false: Hide column headers
+ *
+ * @var string
+ */
+ const SHOW_HEADERS = 'showHeaders';
+
+ /**
+ * Row separators option key.
+ *
+ * Specifies whether to show separators between data rows.
+ *
+ * Supported values:
+ * - true: Show row separators
+ * - false (default): Hide row separators
+ *
+ * @var string
+ */
+ const SHOW_ROW_SEPARATORS = 'showRowSeparators';
+
+ /**
+ * Sort option key.
+ *
+ * Specifies sorting configuration for the table data.
+ *
+ * Can be:
+ * - A string: Column name to sort by (ascending)
+ * - An array: ['column' => 'Name', 'direction' => 'asc|desc']
+ *
+ * @var string
+ */
+ const SORT = 'sort';
+
+ /**
+ * Table style option key.
+ *
+ * Specifies the visual style of the table borders and layout.
+ *
+ * Supported values:
+ * - 'bordered' (default): Unicode box-drawing characters
+ * - 'simple': ASCII characters for compatibility
+ * - 'minimal': Clean look with minimal borders
+ * - 'compact': Space-efficient layout
+ * - 'markdown': Markdown-compatible format
+ *
+ * @var string
+ */
+ const STYLE = 'style';
+
+ /**
+ * Color theme option key.
+ *
+ * Specifies the color scheme to apply to the table.
+ *
+ * Supported values:
+ * - 'default' (default): Standard theme with basic colors
+ * - 'dark': Optimized for dark terminals
+ * - 'light': Optimized for light terminals
+ * - 'colorful': Vibrant colors and styling
+ * - 'professional': Business-appropriate styling
+ * - 'minimal': No colors, just formatting
+ *
+ * @var string
+ */
+ const THEME = 'theme';
+
+ /**
+ * Table title option key.
+ *
+ * Specifies a title to display above the table.
+ * The title will be centered and styled according to the current theme.
+ *
+ * @var string
+ */
+ const TITLE = 'title';
+
+ /**
+ * Maximum table width option key.
+ *
+ * Specifies the maximum width of the table in characters.
+ * If not specified, the terminal width will be auto-detected.
+ *
+ * @var string
+ */
+ const WIDTH = 'width';
+
+ /**
+ * Word wrap option key.
+ *
+ * Specifies whether to enable word wrapping for long content.
+ *
+ * Supported values:
+ * - true: Enable word wrapping
+ * - false (default): Disable word wrapping (content will be truncated)
+ *
+ * @var string
+ */
+ const WORD_WRAP = 'wordWrap';
+
+ /**
+ * Get all available option keys.
+ *
+ * Returns an array of all available option constants that can be used
+ * with the Command::table() method.
+ *
+ * @return array Array of option key constants
+ */
+ public static function getAllOptions(): array {
+ return [
+ self::STYLE,
+ self::THEME,
+ self::TITLE,
+ self::WIDTH,
+ self::SHOW_HEADERS,
+ self::COLUMNS,
+ self::COLORIZE,
+ self::AUTO_WIDTH,
+ self::SHOW_ROW_SEPARATORS,
+ self::SHOW_HEADER_SEPARATOR,
+ self::PADDING,
+ self::WORD_WRAP,
+ self::ELLIPSIS,
+ self::SORT,
+ self::LIMIT,
+ self::FILTER
+ ];
+ }
+
+ /**
+ * Get data-related option keys.
+ *
+ * Returns an array of option keys that affect how data is processed
+ * and displayed in the table.
+ *
+ * @return array Array of data-related option keys
+ */
+ public static function getDataOptions(): array {
+ return [
+ self::COLUMNS,
+ self::COLORIZE,
+ self::SORT,
+ self::LIMIT,
+ self::FILTER
+ ];
+ }
+
+ /**
+ * Get default values for table options.
+ *
+ * Returns an array of default values for table options.
+ *
+ * @return array Array of default option values
+ */
+ public static function getDefaults(): array {
+ return [
+ self::STYLE => 'bordered',
+ self::THEME => 'default',
+ self::TITLE => null,
+ self::WIDTH => 0, // Auto-detect
+ self::SHOW_HEADERS => true,
+ self::COLUMNS => [],
+ self::COLORIZE => [],
+ self::AUTO_WIDTH => true,
+ self::SHOW_ROW_SEPARATORS => false,
+ self::SHOW_HEADER_SEPARATOR => true,
+ self::PADDING => ['left' => 1, 'right' => 1],
+ self::WORD_WRAP => false,
+ self::ELLIPSIS => '...',
+ self::SORT => null,
+ self::LIMIT => null,
+ self::FILTER => null
+ ];
+ }
+
+ /**
+ * Get layout-related option keys.
+ *
+ * Returns an array of option keys that affect the layout and sizing
+ * of the table.
+ *
+ * @return array Array of layout-related option keys
+ */
+ public static function getLayoutOptions(): array {
+ return [
+ self::WIDTH,
+ self::AUTO_WIDTH,
+ self::WORD_WRAP,
+ self::SHOW_HEADERS,
+ self::TITLE
+ ];
+ }
+
+ /**
+ * Get style-related option keys.
+ *
+ * Returns an array of option keys that affect the visual appearance
+ * of the table.
+ *
+ * @return array Array of style-related option keys
+ */
+ public static function getStyleOptions(): array {
+ return [
+ self::STYLE,
+ self::THEME,
+ self::SHOW_ROW_SEPARATORS,
+ self::SHOW_HEADER_SEPARATOR,
+ self::PADDING,
+ self::ELLIPSIS
+ ];
+ }
+
+ /**
+ * Validate option key.
+ *
+ * Checks if the given option key is a valid table option.
+ *
+ * @param string $optionKey The option key to validate
+ * @return bool True if the option key is valid, false otherwise
+ */
+ public static function isValidOption(string $optionKey): bool {
+ return in_array($optionKey, self::getAllOptions(), true);
+ }
+}
diff --git a/WebFiori/Cli/Table/TableRenderer.php b/WebFiori/Cli/Table/TableRenderer.php
index efe7fbd..1130138 100644
--- a/WebFiori/Cli/Table/TableRenderer.php
+++ b/WebFiori/Cli/Table/TableRenderer.php
@@ -1,383 +1,383 @@
-style = $style;
- $this->theme = $theme;
- $this->calculator = new ColumnCalculator();
- $this->formatter = new TableFormatter();
- }
-
- /**
- * Get current style.
- */
- public function getStyle(): TableStyle {
- return $this->style;
- }
-
- /**
- * Get current theme.
- */
- public function getTheme(): ?TableTheme {
- return $this->theme;
- }
-
- /**
- * Render the complete table.
- */
- public function render(
- TableData $data,
- array $columns,
- int $maxWidth,
- bool $showHeaders = true,
- string $title = ''
- ): string {
- if ($data->isEmpty()) {
- return $this->renderEmptyTable($title);
- }
-
- // Filter visible columns
- $visibleColumns = $this->getVisibleColumns($columns, $data->getColumnCount());
- $visibleHeaders = $this->getVisibleHeaders($data->getHeaders(), $visibleColumns);
- $visibleData = $this->getVisibleData($data, $visibleColumns);
-
- // Calculate column widths
- $columnWidths = $this->calculator->calculateWidths(
- $visibleData,
- $visibleColumns,
- $maxWidth,
- $this->style
- );
-
- // Build table parts
- $output = '';
-
- if (!empty($title)) {
- $output .= $this->renderTitle($title, $columnWidths)."\n";
- }
-
- if ($this->style->showBorders) {
- $output .= $this->renderTopBorder($columnWidths)."\n";
- }
-
- if ($showHeaders && !empty($visibleHeaders)) {
- $output .= $this->renderHeaderRow($visibleHeaders, $visibleColumns, $columnWidths)."\n";
-
- if ($this->style->showHeaderSeparator) {
- $output .= $this->renderHeaderSeparator($columnWidths)."\n";
- }
- }
-
- $output .= $this->renderDataRows($visibleData, $visibleColumns, $columnWidths);
-
- if ($this->style->showBorders) {
- $output .= $this->renderBottomBorder($columnWidths);
- }
-
- return $output;
- }
-
- /**
- * Set table style.
- */
- public function setStyle(TableStyle $style): self {
- $this->style = $style;
-
- return $this;
- }
-
- /**
- * Set table theme.
- */
- public function setTheme(?TableTheme $theme): self {
- $this->theme = $theme;
-
- return $this;
- }
-
- /**
- * Get visible columns based on configuration.
- */
- private function getVisibleColumns(array $columns, int $totalColumns): array {
- $visible = [];
-
- for ($i = 0; $i < $totalColumns; $i++) {
- $column = $columns[$i] ?? new Column("Column ".($i + 1));
-
- if ($column->isVisible()) {
- $visible[$i] = $column;
- }
- }
-
- return $visible;
- }
-
- /**
- * Get visible data (filter out hidden columns).
- */
- private function getVisibleData(TableData $data, array $visibleColumns): TableData {
- $visibleHeaders = [];
- $visibleRows = [];
- $columnIndexes = array_keys($visibleColumns);
-
- // Build visible headers
- foreach ($visibleColumns as $index => $column) {
- $visibleHeaders[] = $data->getHeaders()[$index] ?? $column->getName();
- }
-
- // Build visible rows
- foreach ($data->getRows() as $row) {
- $visibleRow = [];
-
- foreach ($columnIndexes as $index) {
- $visibleRow[] = $row[$index] ?? '';
- }
- $visibleRows[] = $visibleRow;
- }
-
- return new TableData($visibleHeaders, $visibleRows);
- }
-
- /**
- * Get visible headers.
- */
- private function getVisibleHeaders(array $headers, array $visibleColumns): array {
- $visibleHeaders = [];
-
- foreach ($visibleColumns as $index => $column) {
- $visibleHeaders[] = $headers[$index] ?? $column->getName();
- }
-
- return $visibleHeaders;
- }
-
- /**
- * Render bottom border.
- */
- private function renderBottomBorder(array $columnWidths): string {
- if (!$this->style->showBorders) {
- return '';
- }
-
- $parts = [];
- $parts[] = $this->style->bottomLeft;
-
- foreach ($columnWidths as $index => $width) {
- $parts[] = str_repeat($this->style->horizontal, $width + $this->style->getTotalPadding());
-
- if ($index < count($columnWidths) - 1) {
- $parts[] = $this->style->bottomTee;
- }
- }
-
- $parts[] = $this->style->bottomRight;
-
- return implode('', $parts);
- }
-
- /**
- * Render data rows.
- */
- private function renderDataRows(TableData $data, array $columns, array $columnWidths): string {
- $output = '';
- $rows = $data->getRows();
- $columnIndexes = array_keys($columns);
-
- foreach ($rows as $rowIndex => $row) {
- $cells = [];
-
- foreach ($row as $cellIndex => $cellValue) {
- if (!isset($columnIndexes[$cellIndex])) {
- continue;
- }
-
- $columnIndex = $columnIndexes[$cellIndex];
- $column = $columns[$columnIndex];
- $width = $columnWidths[$cellIndex];
-
- // Format cell value
- $formattedValue = $column->formatValue($cellValue);
-
- // Apply colorization
- $colorizedValue = $column->colorizeValue($formattedValue);
-
- // Apply theme colors if available
- if ($this->theme) {
- $colorizedValue = $this->theme->applyCellStyle($colorizedValue, $rowIndex, $cellIndex);
- }
-
- // Truncate and align
- $truncated = $column->truncateText($colorizedValue, $width);
- $aligned = $column->alignText($truncated, $width);
-
- $cells[] = $aligned;
- }
-
- $output .= $this->renderRow($cells)."\n";
-
- // Add row separator if enabled
- if ($this->style->showRowSeparators && $rowIndex < count($rows) - 1) {
- $output .= $this->renderHeaderSeparator($columnWidths)."\n";
- }
- }
-
- return $output;
- }
-
- /**
- * Render empty table message.
- */
- private function renderEmptyTable(string $title): string {
- $message = 'No data to display';
-
- if (!empty($title)) {
- $message = $title."\n".str_repeat('=', strlen($title))."\n\n".$message;
- }
-
- return $message;
- }
-
- /**
- * Render header row.
- */
- private function renderHeaderRow(array $headers, array $columns, array $columnWidths): string {
- $cells = [];
- $columnIndexes = array_keys($columns);
-
- foreach ($headers as $index => $header) {
- $columnIndex = $columnIndexes[$index];
- $column = $columns[$columnIndex];
- $width = $columnWidths[$index];
-
- // Format header text
- $formattedHeader = $this->formatter->formatHeader($header);
-
- // Apply theme colors if available
- if ($this->theme) {
- $formattedHeader = $this->theme->applyHeaderStyle($formattedHeader);
- }
-
- // Truncate and align
- $truncated = $column->truncateText($formattedHeader, $width);
- $aligned = $column->alignText($truncated, $width);
-
- $cells[] = $aligned;
- }
-
- return $this->renderRow($cells);
- }
-
- /**
- * Render header separator.
- */
- private function renderHeaderSeparator(array $columnWidths): string {
- if ($this->style->showBorders) {
- $parts = [];
- $parts[] = $this->style->leftTee;
-
- foreach ($columnWidths as $index => $width) {
- $parts[] = str_repeat($this->style->horizontal, $width + $this->style->getTotalPadding());
-
- if ($index < count($columnWidths) - 1) {
- $parts[] = $this->style->cross;
- }
- }
-
- $parts[] = $this->style->rightTee;
-
- return implode('', $parts);
- } else {
- // Simple horizontal line for minimal styles
- $totalWidth = array_sum($columnWidths) + (count($columnWidths) - 1) * 2; // 2 spaces between columns
-
- return str_repeat($this->style->horizontal, $totalWidth);
- }
- }
-
- /**
- * Render a single row with cells.
- */
- private function renderRow(array $cells): string {
- $parts = [];
-
- if ($this->style->showBorders) {
- $parts[] = $this->style->vertical;
- }
-
- foreach ($cells as $index => $cell) {
- $parts[] = str_repeat(' ', $this->style->paddingLeft);
- $parts[] = $cell;
- $parts[] = str_repeat(' ', $this->style->paddingRight);
-
- if ($index < count($cells) - 1) {
- $parts[] = $this->style->vertical;
- }
- }
-
- if ($this->style->showBorders) {
- $parts[] = $this->style->vertical;
- }
-
- return implode('', $parts);
- }
-
- /**
- * Render table title.
- */
- private function renderTitle(string $title, array $columnWidths): string {
- $totalWidth = array_sum($columnWidths) + $this->style->getBorderWidth(count($columnWidths)) +
- (count($columnWidths) * $this->style->getTotalPadding());
-
- $titleLength = strlen($title);
-
- if ($titleLength >= $totalWidth) {
- return $title;
- }
-
- $padding = $totalWidth - $titleLength;
- $leftPadding = intval($padding / 2);
- $rightPadding = $padding - $leftPadding;
-
- return str_repeat(' ', $leftPadding).$title.str_repeat(' ', $rightPadding);
- }
-
- /**
- * Render top border.
- */
- private function renderTopBorder(array $columnWidths): string {
- if (!$this->style->showBorders) {
- return '';
- }
-
- $parts = [];
- $parts[] = $this->style->topLeft;
-
- foreach ($columnWidths as $index => $width) {
- $parts[] = str_repeat($this->style->horizontal, $width + $this->style->getTotalPadding());
-
- if ($index < count($columnWidths) - 1) {
- $parts[] = $this->style->topTee;
- }
- }
-
- $parts[] = $this->style->topRight;
-
- return implode('', $parts);
- }
-}
+style = $style;
+ $this->theme = $theme;
+ $this->calculator = new ColumnCalculator();
+ $this->formatter = new TableFormatter();
+ }
+
+ /**
+ * Get current style.
+ */
+ public function getStyle(): TableStyle {
+ return $this->style;
+ }
+
+ /**
+ * Get current theme.
+ */
+ public function getTheme(): ?TableTheme {
+ return $this->theme;
+ }
+
+ /**
+ * Render the complete table.
+ */
+ public function render(
+ TableData $data,
+ array $columns,
+ int $maxWidth,
+ bool $showHeaders = true,
+ string $title = ''
+ ): string {
+ if ($data->isEmpty()) {
+ return $this->renderEmptyTable($title);
+ }
+
+ // Filter visible columns
+ $visibleColumns = $this->getVisibleColumns($columns, $data->getColumnCount());
+ $visibleHeaders = $this->getVisibleHeaders($data->getHeaders(), $visibleColumns);
+ $visibleData = $this->getVisibleData($data, $visibleColumns);
+
+ // Calculate column widths
+ $columnWidths = $this->calculator->calculateWidths(
+ $visibleData,
+ $visibleColumns,
+ $maxWidth,
+ $this->style
+ );
+
+ // Build table parts
+ $output = '';
+
+ if (!empty($title)) {
+ $output .= $this->renderTitle($title, $columnWidths)."\n";
+ }
+
+ if ($this->style->showBorders) {
+ $output .= $this->renderTopBorder($columnWidths)."\n";
+ }
+
+ if ($showHeaders && !empty($visibleHeaders)) {
+ $output .= $this->renderHeaderRow($visibleHeaders, $visibleColumns, $columnWidths)."\n";
+
+ if ($this->style->showHeaderSeparator) {
+ $output .= $this->renderHeaderSeparator($columnWidths)."\n";
+ }
+ }
+
+ $output .= $this->renderDataRows($visibleData, $visibleColumns, $columnWidths);
+
+ if ($this->style->showBorders) {
+ $output .= $this->renderBottomBorder($columnWidths);
+ }
+
+ return $output;
+ }
+
+ /**
+ * Set table style.
+ */
+ public function setStyle(TableStyle $style): self {
+ $this->style = $style;
+
+ return $this;
+ }
+
+ /**
+ * Set table theme.
+ */
+ public function setTheme(?TableTheme $theme): self {
+ $this->theme = $theme;
+
+ return $this;
+ }
+
+ /**
+ * Get visible columns based on configuration.
+ */
+ private function getVisibleColumns(array $columns, int $totalColumns): array {
+ $visible = [];
+
+ for ($i = 0; $i < $totalColumns; $i++) {
+ $column = $columns[$i] ?? new Column("Column ".($i + 1));
+
+ if ($column->isVisible()) {
+ $visible[$i] = $column;
+ }
+ }
+
+ return $visible;
+ }
+
+ /**
+ * Get visible data (filter out hidden columns).
+ */
+ private function getVisibleData(TableData $data, array $visibleColumns): TableData {
+ $visibleHeaders = [];
+ $visibleRows = [];
+ $columnIndexes = array_keys($visibleColumns);
+
+ // Build visible headers
+ foreach ($visibleColumns as $index => $column) {
+ $visibleHeaders[] = $data->getHeaders()[$index] ?? $column->getName();
+ }
+
+ // Build visible rows
+ foreach ($data->getRows() as $row) {
+ $visibleRow = [];
+
+ foreach ($columnIndexes as $index) {
+ $visibleRow[] = $row[$index] ?? '';
+ }
+ $visibleRows[] = $visibleRow;
+ }
+
+ return new TableData($visibleHeaders, $visibleRows);
+ }
+
+ /**
+ * Get visible headers.
+ */
+ private function getVisibleHeaders(array $headers, array $visibleColumns): array {
+ $visibleHeaders = [];
+
+ foreach ($visibleColumns as $index => $column) {
+ $visibleHeaders[] = $headers[$index] ?? $column->getName();
+ }
+
+ return $visibleHeaders;
+ }
+
+ /**
+ * Render bottom border.
+ */
+ private function renderBottomBorder(array $columnWidths): string {
+ if (!$this->style->showBorders) {
+ return '';
+ }
+
+ $parts = [];
+ $parts[] = $this->style->bottomLeft;
+
+ foreach ($columnWidths as $index => $width) {
+ $parts[] = str_repeat($this->style->horizontal, $width + $this->style->getTotalPadding());
+
+ if ($index < count($columnWidths) - 1) {
+ $parts[] = $this->style->bottomTee;
+ }
+ }
+
+ $parts[] = $this->style->bottomRight;
+
+ return implode('', $parts);
+ }
+
+ /**
+ * Render data rows.
+ */
+ private function renderDataRows(TableData $data, array $columns, array $columnWidths): string {
+ $output = '';
+ $rows = $data->getRows();
+ $columnIndexes = array_keys($columns);
+
+ foreach ($rows as $rowIndex => $row) {
+ $cells = [];
+
+ foreach ($row as $cellIndex => $cellValue) {
+ if (!isset($columnIndexes[$cellIndex])) {
+ continue;
+ }
+
+ $columnIndex = $columnIndexes[$cellIndex];
+ $column = $columns[$columnIndex];
+ $width = $columnWidths[$cellIndex];
+
+ // Format cell value
+ $formattedValue = $column->formatValue($cellValue);
+
+ // Apply colorization
+ $colorizedValue = $column->colorizeValue($formattedValue);
+
+ // Apply theme colors if available
+ if ($this->theme) {
+ $colorizedValue = $this->theme->applyCellStyle($colorizedValue, $rowIndex, $cellIndex);
+ }
+
+ // Truncate and align
+ $truncated = $column->truncateText($colorizedValue, $width);
+ $aligned = $column->alignText($truncated, $width);
+
+ $cells[] = $aligned;
+ }
+
+ $output .= $this->renderRow($cells)."\n";
+
+ // Add row separator if enabled
+ if ($this->style->showRowSeparators && $rowIndex < count($rows) - 1) {
+ $output .= $this->renderHeaderSeparator($columnWidths)."\n";
+ }
+ }
+
+ return $output;
+ }
+
+ /**
+ * Render empty table message.
+ */
+ private function renderEmptyTable(string $title): string {
+ $message = 'No data to display';
+
+ if (!empty($title)) {
+ $message = $title."\n".str_repeat('=', strlen($title))."\n\n".$message;
+ }
+
+ return $message;
+ }
+
+ /**
+ * Render header row.
+ */
+ private function renderHeaderRow(array $headers, array $columns, array $columnWidths): string {
+ $cells = [];
+ $columnIndexes = array_keys($columns);
+
+ foreach ($headers as $index => $header) {
+ $columnIndex = $columnIndexes[$index];
+ $column = $columns[$columnIndex];
+ $width = $columnWidths[$index];
+
+ // Format header text
+ $formattedHeader = $this->formatter->formatHeader($header);
+
+ // Apply theme colors if available
+ if ($this->theme) {
+ $formattedHeader = $this->theme->applyHeaderStyle($formattedHeader);
+ }
+
+ // Truncate and align
+ $truncated = $column->truncateText($formattedHeader, $width);
+ $aligned = $column->alignText($truncated, $width);
+
+ $cells[] = $aligned;
+ }
+
+ return $this->renderRow($cells);
+ }
+
+ /**
+ * Render header separator.
+ */
+ private function renderHeaderSeparator(array $columnWidths): string {
+ if ($this->style->showBorders) {
+ $parts = [];
+ $parts[] = $this->style->leftTee;
+
+ foreach ($columnWidths as $index => $width) {
+ $parts[] = str_repeat($this->style->horizontal, $width + $this->style->getTotalPadding());
+
+ if ($index < count($columnWidths) - 1) {
+ $parts[] = $this->style->cross;
+ }
+ }
+
+ $parts[] = $this->style->rightTee;
+
+ return implode('', $parts);
+ } else {
+ // Simple horizontal line for minimal styles
+ $totalWidth = array_sum($columnWidths) + (count($columnWidths) - 1) * 2; // 2 spaces between columns
+
+ return str_repeat($this->style->horizontal, $totalWidth);
+ }
+ }
+
+ /**
+ * Render a single row with cells.
+ */
+ private function renderRow(array $cells): string {
+ $parts = [];
+
+ if ($this->style->showBorders) {
+ $parts[] = $this->style->vertical;
+ }
+
+ foreach ($cells as $index => $cell) {
+ $parts[] = str_repeat(' ', $this->style->paddingLeft);
+ $parts[] = $cell;
+ $parts[] = str_repeat(' ', $this->style->paddingRight);
+
+ if ($index < count($cells) - 1) {
+ $parts[] = $this->style->vertical;
+ }
+ }
+
+ if ($this->style->showBorders) {
+ $parts[] = $this->style->vertical;
+ }
+
+ return implode('', $parts);
+ }
+
+ /**
+ * Render table title.
+ */
+ private function renderTitle(string $title, array $columnWidths): string {
+ $totalWidth = array_sum($columnWidths) + $this->style->getBorderWidth(count($columnWidths)) +
+ (count($columnWidths) * $this->style->getTotalPadding());
+
+ $titleLength = strlen($title);
+
+ if ($titleLength >= $totalWidth) {
+ return $title;
+ }
+
+ $padding = $totalWidth - $titleLength;
+ $leftPadding = intval($padding / 2);
+ $rightPadding = $padding - $leftPadding;
+
+ return str_repeat(' ', $leftPadding).$title.str_repeat(' ', $rightPadding);
+ }
+
+ /**
+ * Render top border.
+ */
+ private function renderTopBorder(array $columnWidths): string {
+ if (!$this->style->showBorders) {
+ return '';
+ }
+
+ $parts = [];
+ $parts[] = $this->style->topLeft;
+
+ foreach ($columnWidths as $index => $width) {
+ $parts[] = str_repeat($this->style->horizontal, $width + $this->style->getTotalPadding());
+
+ if ($index < count($columnWidths) - 1) {
+ $parts[] = $this->style->topTee;
+ }
+ }
+
+ $parts[] = $this->style->topRight;
+
+ return implode('', $parts);
+ }
+}
diff --git a/WebFiori/Cli/Table/TableStyle.php b/WebFiori/Cli/Table/TableStyle.php
index a1f3276..fa71c42 100644
--- a/WebFiori/Cli/Table/TableStyle.php
+++ b/WebFiori/Cli/Table/TableStyle.php
@@ -1,428 +1,428 @@
- 'โ',
- 'topRight' => 'โ',
- 'bottomLeft' => 'โ',
- 'bottomRight' => 'โ',
- 'horizontal' => 'โ',
- 'vertical' => 'โ',
- 'cross' => 'โผ',
- 'topTee' => 'โฌ',
- 'bottomTee' => 'โด',
- 'leftTee' => 'โ',
- 'rightTee' => 'โค',
- 'paddingLeft' => 1,
- 'paddingRight' => 1,
- 'showBorders' => true,
- 'showHeaderSeparator' => true,
- 'showRowSeparators' => false
- ];
-
- // Merge provided components with defaults
- $config = array_merge($defaults, $components);
-
- // Assign values to readonly properties
- $this->topLeft = $config['topLeft'];
- $this->topRight = $config['topRight'];
- $this->bottomLeft = $config['bottomLeft'];
- $this->bottomRight = $config['bottomRight'];
- $this->horizontal = $config['horizontal'];
- $this->vertical = $config['vertical'];
- $this->cross = $config['cross'];
- $this->topTee = $config['topTee'];
- $this->bottomTee = $config['bottomTee'];
- $this->leftTee = $config['leftTee'];
- $this->rightTee = $config['rightTee'];
- $this->paddingLeft = $config['paddingLeft'];
- $this->paddingRight = $config['paddingRight'];
- $this->showBorders = $config['showBorders'];
- $this->showHeaderSeparator = $config['showHeaderSeparator'];
- $this->showRowSeparators = $config['showRowSeparators'];
- }
-
- /**
- * Bordered style (same as default).
- */
- public static function bordered(): self {
- return self::default();
- }
-
- /**
- * Compact style with minimal spacing.
- */
- public static function compact(): self {
- return new self([
- 'paddingLeft' => 0,
- 'paddingRight' => 1,
- 'showBorders' => false,
- 'showHeaderSeparator' => true
- ]);
- }
-
- /**
- * Create a style by name.
- *
- * @param string $name The style name
- * @return self The style instance
- */
- public static function create(string $name): self {
- return match (strtolower($name)) {
- self::DEFAULT, self::BORDERED => self::default(),
- self::SIMPLE => self::simple(),
- self::MINIMAL => self::minimal(),
- self::COMPACT => self::compact(),
- self::MARKDOWN => self::markdown(),
- self::DOUBLE_BORDERED, 'double-bordered', 'doublebordered' => self::doubleBordered(),
- self::ROUNDED => self::rounded(),
- self::HEAVY => self::heavy(),
- self::NONE => self::none(),
- default => self::default()
- };
- }
-
- /**
- * Create a custom style with specific overrides.
- */
- public static function custom(array $overrides): self {
- return new self($overrides);
- }
-
- /**
- * Default bordered style with Unicode box-drawing characters.
- */
- public static function default(): self {
- return new self();
- }
-
- /**
- * Double-line bordered style.
- */
- public static function doubleBordered(): self {
- return new self([
- 'topLeft' => 'โ',
- 'topRight' => 'โ',
- 'bottomLeft' => 'โ',
- 'bottomRight' => 'โ',
- 'horizontal' => 'โ',
- 'vertical' => 'โ',
- 'cross' => 'โฌ',
- 'topTee' => 'โฆ',
- 'bottomTee' => 'โฉ',
- 'leftTee' => 'โ ',
- 'rightTee' => 'โฃ'
- ]);
- }
-
- /**
- * Get ASCII fallback for this style.
- */
- public function getAsciiFallback(): self {
- if (!$this->isUnicode()) {
- return $this;
- }
-
- return self::simple();
- }
-
- /**
- * Get all available style names.
- *
- * @return array Array of supported style names
- */
- public static function getAvailableStyles(): array {
- return [
- self::DEFAULT,
- self::BORDERED,
- self::SIMPLE,
- self::MINIMAL,
- self::COMPACT,
- self::MARKDOWN,
- self::DOUBLE_BORDERED,
- self::ROUNDED,
- self::HEAVY,
- self::NONE
- ];
- }
-
- /**
- * Get border width (number of characters used for borders).
- */
- public function getBorderWidth(int $columnCount): int {
- if (!$this->showBorders) {
- return 0;
- }
-
- // Left border + right border + (columnCount - 1) separators
- return 2 + ($columnCount - 1);
- }
-
- /**
- * Get total padding width (left + right).
- */
- public function getTotalPadding(): int {
- return $this->paddingLeft + $this->paddingRight;
- }
-
- /**
- * Heavy/thick borders style.
- */
- public static function heavy(): self {
- return new self([
- 'topLeft' => 'โ',
- 'topRight' => 'โ',
- 'bottomLeft' => 'โ',
- 'bottomRight' => 'โ',
- 'horizontal' => 'โ',
- 'vertical' => 'โ',
- 'cross' => 'โ',
- 'topTee' => 'โณ',
- 'bottomTee' => 'โป',
- 'leftTee' => 'โฃ',
- 'rightTee' => 'โซ'
- ]);
- }
-
- /**
- * Check if this style uses Unicode characters.
- */
- public function isUnicode(): bool {
- $chars = [
- $this->topLeft, $this->topRight, $this->bottomLeft, $this->bottomRight,
- $this->horizontal, $this->vertical, $this->cross,
- $this->topTee, $this->bottomTee, $this->leftTee, $this->rightTee
- ];
-
- foreach ($chars as $char) {
- if (strlen($char) > 1 || ord($char) > 127) {
- return true;
- }
- }
-
- return false;
- }
-
- /**
- * Check if a style name is valid.
- *
- * @param string $styleName The style name to validate
- * @return bool True if the style is supported, false otherwise
- */
- public static function isValidStyle(string $styleName): bool {
- return in_array(strtolower($styleName), array_map('strtolower', self::getAvailableStyles()), true);
- }
-
- /**
- * Markdown-compatible table style.
- */
- public static function markdown(): self {
- return new self([
- 'topLeft' => '',
- 'topRight' => '',
- 'bottomLeft' => '',
- 'bottomRight' => '',
- 'horizontal' => '-',
- 'vertical' => '|',
- 'cross' => '|',
- 'topTee' => '',
- 'bottomTee' => '',
- 'leftTee' => '|',
- 'rightTee' => '|',
- 'paddingLeft' => 1,
- 'paddingRight' => 1,
- 'showBorders' => true,
- 'showHeaderSeparator' => true,
- 'showRowSeparators' => false
- ]);
- }
-
- /**
- * Minimal style with reduced borders.
- */
- public static function minimal(): self {
- return new self([
- 'topLeft' => '',
- 'topRight' => '',
- 'bottomLeft' => '',
- 'bottomRight' => '',
- 'horizontal' => 'โ',
- 'vertical' => '',
- 'cross' => '',
- 'topTee' => '',
- 'bottomTee' => '',
- 'leftTee' => '',
- 'rightTee' => '',
- 'showBorders' => false,
- 'showHeaderSeparator' => true
- ]);
- }
-
- /**
- * No borders style - just data with spacing.
- */
- public static function none(): self {
- return new self([
- 'topLeft' => '',
- 'topRight' => '',
- 'bottomLeft' => '',
- 'bottomRight' => '',
- 'horizontal' => '',
- 'vertical' => '',
- 'cross' => '',
- 'topTee' => '',
- 'bottomTee' => '',
- 'leftTee' => '',
- 'rightTee' => '',
- 'paddingLeft' => 0,
- 'paddingRight' => 2,
- 'showBorders' => false,
- 'showHeaderSeparator' => false,
- 'showRowSeparators' => false
- ]);
- }
-
- /**
- * Rounded corners style.
- */
- public static function rounded(): self {
- return new self([
- 'topLeft' => 'โญ',
- 'topRight' => 'โฎ',
- 'bottomLeft' => 'โฐ',
- 'bottomRight' => 'โฏ',
- 'horizontal' => 'โ',
- 'vertical' => 'โ',
- 'cross' => 'โผ',
- 'topTee' => 'โฌ',
- 'bottomTee' => 'โด',
- 'leftTee' => 'โ',
- 'rightTee' => 'โค'
- ]);
- }
-
- /**
- * Simple ASCII style for maximum compatibility.
- */
- public static function simple(): self {
- return new self([
- 'topLeft' => '+',
- 'topRight' => '+',
- 'bottomLeft' => '+',
- 'bottomRight' => '+',
- 'horizontal' => '-',
- 'vertical' => '|',
- 'cross' => '+',
- 'topTee' => '+',
- 'bottomTee' => '+',
- 'leftTee' => '+',
- 'rightTee' => '+'
- ]);
- }
-}
+ 'โ',
+ 'topRight' => 'โ',
+ 'bottomLeft' => 'โ',
+ 'bottomRight' => 'โ',
+ 'horizontal' => 'โ',
+ 'vertical' => 'โ',
+ 'cross' => 'โผ',
+ 'topTee' => 'โฌ',
+ 'bottomTee' => 'โด',
+ 'leftTee' => 'โ',
+ 'rightTee' => 'โค',
+ 'paddingLeft' => 1,
+ 'paddingRight' => 1,
+ 'showBorders' => true,
+ 'showHeaderSeparator' => true,
+ 'showRowSeparators' => false
+ ];
+
+ // Merge provided components with defaults
+ $config = array_merge($defaults, $components);
+
+ // Assign values to readonly properties
+ $this->topLeft = $config['topLeft'];
+ $this->topRight = $config['topRight'];
+ $this->bottomLeft = $config['bottomLeft'];
+ $this->bottomRight = $config['bottomRight'];
+ $this->horizontal = $config['horizontal'];
+ $this->vertical = $config['vertical'];
+ $this->cross = $config['cross'];
+ $this->topTee = $config['topTee'];
+ $this->bottomTee = $config['bottomTee'];
+ $this->leftTee = $config['leftTee'];
+ $this->rightTee = $config['rightTee'];
+ $this->paddingLeft = $config['paddingLeft'];
+ $this->paddingRight = $config['paddingRight'];
+ $this->showBorders = $config['showBorders'];
+ $this->showHeaderSeparator = $config['showHeaderSeparator'];
+ $this->showRowSeparators = $config['showRowSeparators'];
+ }
+
+ /**
+ * Bordered style (same as default).
+ */
+ public static function bordered(): self {
+ return self::default();
+ }
+
+ /**
+ * Compact style with minimal spacing.
+ */
+ public static function compact(): self {
+ return new self([
+ 'paddingLeft' => 0,
+ 'paddingRight' => 1,
+ 'showBorders' => false,
+ 'showHeaderSeparator' => true
+ ]);
+ }
+
+ /**
+ * Create a style by name.
+ *
+ * @param string $name The style name
+ * @return self The style instance
+ */
+ public static function create(string $name): self {
+ return match (strtolower($name)) {
+ self::DEFAULT, self::BORDERED => self::default(),
+ self::SIMPLE => self::simple(),
+ self::MINIMAL => self::minimal(),
+ self::COMPACT => self::compact(),
+ self::MARKDOWN => self::markdown(),
+ self::DOUBLE_BORDERED, 'double-bordered', 'doublebordered' => self::doubleBordered(),
+ self::ROUNDED => self::rounded(),
+ self::HEAVY => self::heavy(),
+ self::NONE => self::none(),
+ default => self::default()
+ };
+ }
+
+ /**
+ * Create a custom style with specific overrides.
+ */
+ public static function custom(array $overrides): self {
+ return new self($overrides);
+ }
+
+ /**
+ * Default bordered style with Unicode box-drawing characters.
+ */
+ public static function default(): self {
+ return new self();
+ }
+
+ /**
+ * Double-line bordered style.
+ */
+ public static function doubleBordered(): self {
+ return new self([
+ 'topLeft' => 'โ',
+ 'topRight' => 'โ',
+ 'bottomLeft' => 'โ',
+ 'bottomRight' => 'โ',
+ 'horizontal' => 'โ',
+ 'vertical' => 'โ',
+ 'cross' => 'โฌ',
+ 'topTee' => 'โฆ',
+ 'bottomTee' => 'โฉ',
+ 'leftTee' => 'โ ',
+ 'rightTee' => 'โฃ'
+ ]);
+ }
+
+ /**
+ * Get ASCII fallback for this style.
+ */
+ public function getAsciiFallback(): self {
+ if (!$this->isUnicode()) {
+ return $this;
+ }
+
+ return self::simple();
+ }
+
+ /**
+ * Get all available style names.
+ *
+ * @return array Array of supported style names
+ */
+ public static function getAvailableStyles(): array {
+ return [
+ self::DEFAULT,
+ self::BORDERED,
+ self::SIMPLE,
+ self::MINIMAL,
+ self::COMPACT,
+ self::MARKDOWN,
+ self::DOUBLE_BORDERED,
+ self::ROUNDED,
+ self::HEAVY,
+ self::NONE
+ ];
+ }
+
+ /**
+ * Get border width (number of characters used for borders).
+ */
+ public function getBorderWidth(int $columnCount): int {
+ if (!$this->showBorders) {
+ return 0;
+ }
+
+ // Left border + right border + (columnCount - 1) separators
+ return 2 + ($columnCount - 1);
+ }
+
+ /**
+ * Get total padding width (left + right).
+ */
+ public function getTotalPadding(): int {
+ return $this->paddingLeft + $this->paddingRight;
+ }
+
+ /**
+ * Heavy/thick borders style.
+ */
+ public static function heavy(): self {
+ return new self([
+ 'topLeft' => 'โ',
+ 'topRight' => 'โ',
+ 'bottomLeft' => 'โ',
+ 'bottomRight' => 'โ',
+ 'horizontal' => 'โ',
+ 'vertical' => 'โ',
+ 'cross' => 'โ',
+ 'topTee' => 'โณ',
+ 'bottomTee' => 'โป',
+ 'leftTee' => 'โฃ',
+ 'rightTee' => 'โซ'
+ ]);
+ }
+
+ /**
+ * Check if this style uses Unicode characters.
+ */
+ public function isUnicode(): bool {
+ $chars = [
+ $this->topLeft, $this->topRight, $this->bottomLeft, $this->bottomRight,
+ $this->horizontal, $this->vertical, $this->cross,
+ $this->topTee, $this->bottomTee, $this->leftTee, $this->rightTee
+ ];
+
+ foreach ($chars as $char) {
+ if (strlen($char) > 1 || ord($char) > 127) {
+ return true;
+ }
+ }
+
+ return false;
+ }
+
+ /**
+ * Check if a style name is valid.
+ *
+ * @param string $styleName The style name to validate
+ * @return bool True if the style is supported, false otherwise
+ */
+ public static function isValidStyle(string $styleName): bool {
+ return in_array(strtolower($styleName), array_map('strtolower', self::getAvailableStyles()), true);
+ }
+
+ /**
+ * Markdown-compatible table style.
+ */
+ public static function markdown(): self {
+ return new self([
+ 'topLeft' => '',
+ 'topRight' => '',
+ 'bottomLeft' => '',
+ 'bottomRight' => '',
+ 'horizontal' => '-',
+ 'vertical' => '|',
+ 'cross' => '|',
+ 'topTee' => '',
+ 'bottomTee' => '',
+ 'leftTee' => '|',
+ 'rightTee' => '|',
+ 'paddingLeft' => 1,
+ 'paddingRight' => 1,
+ 'showBorders' => true,
+ 'showHeaderSeparator' => true,
+ 'showRowSeparators' => false
+ ]);
+ }
+
+ /**
+ * Minimal style with reduced borders.
+ */
+ public static function minimal(): self {
+ return new self([
+ 'topLeft' => '',
+ 'topRight' => '',
+ 'bottomLeft' => '',
+ 'bottomRight' => '',
+ 'horizontal' => 'โ',
+ 'vertical' => '',
+ 'cross' => '',
+ 'topTee' => '',
+ 'bottomTee' => '',
+ 'leftTee' => '',
+ 'rightTee' => '',
+ 'showBorders' => false,
+ 'showHeaderSeparator' => true
+ ]);
+ }
+
+ /**
+ * No borders style - just data with spacing.
+ */
+ public static function none(): self {
+ return new self([
+ 'topLeft' => '',
+ 'topRight' => '',
+ 'bottomLeft' => '',
+ 'bottomRight' => '',
+ 'horizontal' => '',
+ 'vertical' => '',
+ 'cross' => '',
+ 'topTee' => '',
+ 'bottomTee' => '',
+ 'leftTee' => '',
+ 'rightTee' => '',
+ 'paddingLeft' => 0,
+ 'paddingRight' => 2,
+ 'showBorders' => false,
+ 'showHeaderSeparator' => false,
+ 'showRowSeparators' => false
+ ]);
+ }
+
+ /**
+ * Rounded corners style.
+ */
+ public static function rounded(): self {
+ return new self([
+ 'topLeft' => 'โญ',
+ 'topRight' => 'โฎ',
+ 'bottomLeft' => 'โฐ',
+ 'bottomRight' => 'โฏ',
+ 'horizontal' => 'โ',
+ 'vertical' => 'โ',
+ 'cross' => 'โผ',
+ 'topTee' => 'โฌ',
+ 'bottomTee' => 'โด',
+ 'leftTee' => 'โ',
+ 'rightTee' => 'โค'
+ ]);
+ }
+
+ /**
+ * Simple ASCII style for maximum compatibility.
+ */
+ public static function simple(): self {
+ return new self([
+ 'topLeft' => '+',
+ 'topRight' => '+',
+ 'bottomLeft' => '+',
+ 'bottomRight' => '+',
+ 'horizontal' => '-',
+ 'vertical' => '|',
+ 'cross' => '+',
+ 'topTee' => '+',
+ 'bottomTee' => '+',
+ 'leftTee' => '+',
+ 'rightTee' => '+'
+ ]);
+ }
+}
diff --git a/WebFiori/Cli/Table/TableTheme.php b/WebFiori/Cli/Table/TableTheme.php
index f666fed..92c61f8 100644
--- a/WebFiori/Cli/Table/TableTheme.php
+++ b/WebFiori/Cli/Table/TableTheme.php
@@ -1,526 +1,526 @@
-configure($config);
- }
-
- /**
- *
- * @param string $text
- * @param int $rowIndex
- * @param int $columnIndex
- * @return string
- */
- public function applyCellStyle(string $text, int $rowIndex, int $columnIndex): string {
- // Apply custom cell styler if available
- if ($this->cellStyler !== null) {
- $text = call_user_func($this->cellStyler, $text, $rowIndex, $columnIndex);
- }
-
- // Apply alternating row colors
- if ($this->useAlternatingRows && !empty($this->alternatingRowColors)) {
- $colorIndex = $rowIndex % count($this->alternatingRowColors);
- $colors = $this->alternatingRowColors[$colorIndex];
- $text = $this->applyColors($text, $colors);
- }
-
- // Apply general cell colors
- elseif (!empty($this->cellColors)) {
- $text = $this->applyColors($text, $this->cellColors);
- }
-
- // Apply status-based colors
- return $this->applyStatusColors($text);
- }
-
- /**
- * Apply header styling.
- */
- public function applyHeaderStyle(string $text): string {
- // Apply custom header styler if available
- if ($this->headerStyler !== null) {
- $text = call_user_func($this->headerStyler, $text);
- }
-
- // Apply header colors
- if (!empty($this->headerColors)) {
- $text = $this->applyColors($text, $this->headerColors);
- }
-
- return $text;
- }
-
- /**
- * Create a colorful theme.
- */
- public static function colorful(): self {
- return new self([
- 'headerColors' => ['color' => 'magenta', 'bold' => true, 'underline' => true],
- 'cellColors' => [],
- 'alternatingRowColors' => [
- ['color' => 'cyan'],
- ['color' => 'light-cyan']
- ],
- 'useAlternatingRows' => true,
- 'statusColors' => [
- 'active' => ['color' => 'green', 'bold' => true],
- 'inactive' => ['color' => 'red'],
- 'pending' => ['color' => 'yellow'],
- 'success' => ['color' => 'light-green', 'bold' => true],
- 'error' => ['color' => 'light-red', 'bold' => true],
- 'warning' => ['color' => 'light-yellow'],
- 'info' => ['color' => 'light-blue']
- ]
- ]);
- }
-
- /**
- * Configure theme with options array.
- */
- public function configure(array $config): self {
- foreach ($config as $key => $value) {
- match ($key) {
- 'headerColors', 'header_colors' => $this->headerColors = $value,
- 'cellColors', 'cell_colors' => $this->cellColors = $value,
- 'alternatingRowColors', 'alternating_row_colors' => $this->alternatingRowColors = $value,
- 'useAlternatingRows', 'use_alternating_rows' => $this->useAlternatingRows = $value,
- 'statusColors', 'status_colors' => $this->statusColors = $value,
- 'headerStyler', 'header_styler' => $this->headerStyler = $value,
- 'cellStyler', 'cell_styler' => $this->cellStyler = $value,
- default => null
- };
- }
-
- return $this;
- }
-
- /**
- * Create theme by name.
- */
- public static function create(string $name): self {
- return match (strtolower($name)) {
- self::DARK => self::dark(),
- self::LIGHT => self::light(),
- self::COLORFUL => self::colorful(),
- self::MINIMAL => self::minimal(),
- self::PROFESSIONAL => self::professional(),
- self::HIGH_CONTRAST, 'high-contrast', 'highcontrast' => self::highContrast(),
- 'environment', 'auto' => self::fromEnvironment(),
- default => self::default()
- };
- }
-
- /**
- * Create a custom theme with specific colors.
- */
- public static function custom(array $config): self {
- return new self($config);
- }
-
- /**
- * Create a dark theme.
- */
- public static function dark(): self {
- return new self([
- 'headerColors' => ['color' => 'light-cyan', 'bold' => true],
- 'cellColors' => ['color' => 'white'],
- 'alternatingRowColors' => [
- [],
- ['background' => 'black']
- ],
- 'useAlternatingRows' => true,
- 'statusColors' => [
- 'success' => ['color' => 'light-green'],
- 'error' => ['color' => 'light-red'],
- 'warning' => ['color' => 'light-yellow'],
- 'info' => ['color' => 'light-blue']
- ]
- ]);
- }
-
- /**
- * Create a default theme.
- */
- public static function default(): self {
- return new self([
- 'headerColors' => ['color' => 'white', 'bold' => true],
- 'cellColors' => [],
- 'useAlternatingRows' => false
- ]);
- }
-
- /**
- * Create theme from CLI environment.
- */
- public static function fromEnvironment(): self {
- // Detect terminal capabilities and user preferences
- $supportsColor = self::detectColorSupport();
- $isDarkTerminal = self::detectDarkTerminal();
-
- if (!$supportsColor) {
- return self::minimal();
- }
-
- return $isDarkTerminal ? self::dark() : self::light();
- }
-
- /**
- * Get available theme names.
- */
- public static function getAvailableThemes(): array {
- return [
- self::DEFAULT,
- self::DARK,
- self::LIGHT,
- self::COLORFUL,
- self::MINIMAL,
- self::PROFESSIONAL,
- self::HIGH_CONTRAST
- ];
- }
-
- /**
- * Create a high contrast theme for accessibility.
- */
- public static function highContrast(): self {
- return new self([
- 'headerColors' => ['color' => 'white', 'background' => 'black', 'bold' => true],
- 'cellColors' => ['color' => 'white', 'background' => 'black'],
- 'useAlternatingRows' => false,
- 'statusColors' => [
- 'success' => ['color' => 'white', 'background' => 'green', 'bold' => true],
- 'error' => ['color' => 'white', 'background' => 'red', 'bold' => true],
- 'warning' => ['color' => 'black', 'background' => 'yellow', 'bold' => true],
- 'info' => ['color' => 'white', 'background' => 'blue', 'bold' => true]
- ]
- ]);
- }
-
- /**
- * Check if a theme name is valid.
- *
- * @param string $themeName The theme name to validate
- * @return bool True if the theme is supported, false otherwise
- */
- public static function isValidTheme(string $themeName): bool {
- return in_array(strtolower($themeName), array_map('strtolower', self::getAvailableThemes()), true);
- }
-
- /**
- * Create a light theme.
- */
- public static function light(): self {
- return new self([
- 'headerColors' => ['color' => 'blue', 'bold' => true],
- 'cellColors' => ['color' => 'black'],
- 'alternatingRowColors' => [
- [],
- ['background' => 'white']
- ],
- 'useAlternatingRows' => true,
- 'statusColors' => [
- 'success' => ['color' => 'green'],
- 'error' => ['color' => 'red'],
- 'warning' => ['color' => 'yellow'],
- 'info' => ['color' => 'blue']
- ]
- ]);
- }
-
- /**
- * Create a minimal theme (no colors).
- */
- public static function minimal(): self {
- return new self([
- 'headerColors' => ['bold' => true],
- 'cellColors' => [],
- 'useAlternatingRows' => false
- ]);
- }
-
- /**
- * Create a professional theme.
- */
- public static function professional(): self {
- return new self([
- 'headerColors' => ['color' => 'white', 'background' => 'blue', 'bold' => true],
- 'cellColors' => [],
- 'alternatingRowColors' => [
- [],
- ['background' => 'light-blue']
- ],
- 'useAlternatingRows' => true,
- 'statusColors' => [
- 'active' => ['color' => 'green'],
- 'inactive' => ['color' => 'red'],
- 'pending' => ['color' => 'yellow']
- ]
- ]);
- }
-
- /**
- * Set alternating row colors.
- */
- public function setAlternatingRowColors(array $colors): self {
- $this->alternatingRowColors = $colors;
- $this->useAlternatingRows = !empty($colors);
-
- return $this;
- }
-
- /**
- * Set cell colors.
- */
- public function setCellColors(array $colors): self {
- $this->cellColors = $colors;
-
- return $this;
- }
-
- /**
- * Set custom cell styler function.
- */
- public function setCellStyler($styler): self {
- $this->cellStyler = $styler;
-
- return $this;
- }
-
- /**
- * Set header colors.
- */
- public function setHeaderColors(array $colors): self {
- $this->headerColors = $colors;
-
- return $this;
- }
-
- /**
- * Set custom header styler function.
- */
- public function setHeaderStyler($styler): self {
- $this->headerStyler = $styler;
-
- return $this;
- }
-
- /**
- * Set status-based colors.
- */
- public function setStatusColors(array $colors): self {
- $this->statusColors = $colors;
-
- return $this;
- }
-
- /**
- * Enable/disable alternating rows.
- */
- public function useAlternatingRows(bool $use = true): self {
- $this->useAlternatingRows = $use;
-
- return $this;
- }
-
- /**
- * Apply ANSI colors to text.
- */
- private function applyColors(string $text, array $colors): string {
- if (empty($colors)) {
- return $text;
- }
-
- $codes = [];
-
- // Foreground colors
- if (isset($colors['color'])) {
- $codes[] = $this->getColorCode($colors['color']);
- }
-
- // Background colors
- if (isset($colors['background'])) {
- $codes[] = $this->getColorCode($colors['background'], true);
- }
-
- // Text styles
- if (isset($colors['bold']) && $colors['bold']) {
- $codes[] = '1';
- }
-
- if (isset($colors['underline']) && $colors['underline']) {
- $codes[] = '4';
- }
-
- if (isset($colors['italic']) && $colors['italic']) {
- $codes[] = '3';
- }
-
- if (empty($codes)) {
- return $text;
- }
-
- return "\x1b[".implode(';', $codes)."m".$text."\x1b[0m";
- }
-
- /**
- * Apply status-based colors.
- */
- private function applyStatusColors(string $text): string {
- if (empty($this->statusColors)) {
- return $text;
- }
-
- $lowerText = strtolower(trim($text));
-
- foreach ($this->statusColors as $status => $colors) {
- if (strpos($lowerText, strtolower($status)) !== false) {
- return $this->applyColors($text, $colors);
- }
- }
-
- return $text;
- }
-
- /**
- * Detect if terminal supports colors.
- */
- private static function detectColorSupport(): bool {
- // Check environment variables
- $term = getenv('TERM');
- $colorTerm = getenv('COLORTERM');
-
- if ($colorTerm) {
- return true;
- }
-
- if ($term && (
- strpos($term, 'color') !== false ||
- strpos($term, '256') !== false ||
- strpos($term, 'xterm') !== false
- )) {
- return true;
- }
-
- // Check if running in a known terminal
- if (getenv('TERM_PROGRAM')) {
- return true;
- }
-
- return false;
- }
-
- /**
- * Detect if terminal has dark background.
- */
- private static function detectDarkTerminal(): bool {
- // This is a best guess - terminal background detection is limited
- $termProgram = getenv('TERM_PROGRAM');
-
- // Some terminals are typically dark by default
- if ($termProgram && in_array($termProgram, ['iTerm.app', 'Terminal.app'])) {
- return true;
- }
-
- // Default assumption for most terminals
- return true;
- }
-
- /**
- * Get ANSI color code.
- */
- private function getColorCode(string $color, bool $background = false): string {
- $colors = [
- 'black' => $background ? '40' : '30',
- 'red' => $background ? '41' : '31',
- 'green' => $background ? '42' : '32',
- 'yellow' => $background ? '43' : '33',
- 'blue' => $background ? '44' : '34',
- 'magenta' => $background ? '45' : '35',
- 'cyan' => $background ? '46' : '36',
- 'white' => $background ? '47' : '37',
- 'light-red' => $background ? '101' : '91',
- 'light-green' => $background ? '102' : '92',
- 'light-yellow' => $background ? '103' : '93',
- 'light-blue' => $background ? '104' : '94',
- 'light-magenta' => $background ? '105' : '95',
- 'light-cyan' => $background ? '106' : '96',
- ];
-
- return $colors[strtolower($color)] ?? ($background ? '40' : '30');
- }
-}
+configure($config);
+ }
+
+ /**
+ *
+ * @param string $text
+ * @param int $rowIndex
+ * @param int $columnIndex
+ * @return string
+ */
+ public function applyCellStyle(string $text, int $rowIndex, int $columnIndex): string {
+ // Apply custom cell styler if available
+ if ($this->cellStyler !== null) {
+ $text = call_user_func($this->cellStyler, $text, $rowIndex, $columnIndex);
+ }
+
+ // Apply alternating row colors
+ if ($this->useAlternatingRows && !empty($this->alternatingRowColors)) {
+ $colorIndex = $rowIndex % count($this->alternatingRowColors);
+ $colors = $this->alternatingRowColors[$colorIndex];
+ $text = $this->applyColors($text, $colors);
+ }
+
+ // Apply general cell colors
+ elseif (!empty($this->cellColors)) {
+ $text = $this->applyColors($text, $this->cellColors);
+ }
+
+ // Apply status-based colors
+ return $this->applyStatusColors($text);
+ }
+
+ /**
+ * Apply header styling.
+ */
+ public function applyHeaderStyle(string $text): string {
+ // Apply custom header styler if available
+ if ($this->headerStyler !== null) {
+ $text = call_user_func($this->headerStyler, $text);
+ }
+
+ // Apply header colors
+ if (!empty($this->headerColors)) {
+ $text = $this->applyColors($text, $this->headerColors);
+ }
+
+ return $text;
+ }
+
+ /**
+ * Create a colorful theme.
+ */
+ public static function colorful(): self {
+ return new self([
+ 'headerColors' => ['color' => 'magenta', 'bold' => true, 'underline' => true],
+ 'cellColors' => [],
+ 'alternatingRowColors' => [
+ ['color' => 'cyan'],
+ ['color' => 'light-cyan']
+ ],
+ 'useAlternatingRows' => true,
+ 'statusColors' => [
+ 'active' => ['color' => 'green', 'bold' => true],
+ 'inactive' => ['color' => 'red'],
+ 'pending' => ['color' => 'yellow'],
+ 'success' => ['color' => 'light-green', 'bold' => true],
+ 'error' => ['color' => 'light-red', 'bold' => true],
+ 'warning' => ['color' => 'light-yellow'],
+ 'info' => ['color' => 'light-blue']
+ ]
+ ]);
+ }
+
+ /**
+ * Configure theme with options array.
+ */
+ public function configure(array $config): self {
+ foreach ($config as $key => $value) {
+ match ($key) {
+ 'headerColors', 'header_colors' => $this->headerColors = $value,
+ 'cellColors', 'cell_colors' => $this->cellColors = $value,
+ 'alternatingRowColors', 'alternating_row_colors' => $this->alternatingRowColors = $value,
+ 'useAlternatingRows', 'use_alternating_rows' => $this->useAlternatingRows = $value,
+ 'statusColors', 'status_colors' => $this->statusColors = $value,
+ 'headerStyler', 'header_styler' => $this->headerStyler = $value,
+ 'cellStyler', 'cell_styler' => $this->cellStyler = $value,
+ default => null
+ };
+ }
+
+ return $this;
+ }
+
+ /**
+ * Create theme by name.
+ */
+ public static function create(string $name): self {
+ return match (strtolower($name)) {
+ self::DARK => self::dark(),
+ self::LIGHT => self::light(),
+ self::COLORFUL => self::colorful(),
+ self::MINIMAL => self::minimal(),
+ self::PROFESSIONAL => self::professional(),
+ self::HIGH_CONTRAST, 'high-contrast', 'highcontrast' => self::highContrast(),
+ 'environment', 'auto' => self::fromEnvironment(),
+ default => self::default()
+ };
+ }
+
+ /**
+ * Create a custom theme with specific colors.
+ */
+ public static function custom(array $config): self {
+ return new self($config);
+ }
+
+ /**
+ * Create a dark theme.
+ */
+ public static function dark(): self {
+ return new self([
+ 'headerColors' => ['color' => 'light-cyan', 'bold' => true],
+ 'cellColors' => ['color' => 'white'],
+ 'alternatingRowColors' => [
+ [],
+ ['background' => 'black']
+ ],
+ 'useAlternatingRows' => true,
+ 'statusColors' => [
+ 'success' => ['color' => 'light-green'],
+ 'error' => ['color' => 'light-red'],
+ 'warning' => ['color' => 'light-yellow'],
+ 'info' => ['color' => 'light-blue']
+ ]
+ ]);
+ }
+
+ /**
+ * Create a default theme.
+ */
+ public static function default(): self {
+ return new self([
+ 'headerColors' => ['color' => 'white', 'bold' => true],
+ 'cellColors' => [],
+ 'useAlternatingRows' => false
+ ]);
+ }
+
+ /**
+ * Create theme from CLI environment.
+ */
+ public static function fromEnvironment(): self {
+ // Detect terminal capabilities and user preferences
+ $supportsColor = self::detectColorSupport();
+ $isDarkTerminal = self::detectDarkTerminal();
+
+ if (!$supportsColor) {
+ return self::minimal();
+ }
+
+ return $isDarkTerminal ? self::dark() : self::light();
+ }
+
+ /**
+ * Get available theme names.
+ */
+ public static function getAvailableThemes(): array {
+ return [
+ self::DEFAULT,
+ self::DARK,
+ self::LIGHT,
+ self::COLORFUL,
+ self::MINIMAL,
+ self::PROFESSIONAL,
+ self::HIGH_CONTRAST
+ ];
+ }
+
+ /**
+ * Create a high contrast theme for accessibility.
+ */
+ public static function highContrast(): self {
+ return new self([
+ 'headerColors' => ['color' => 'white', 'background' => 'black', 'bold' => true],
+ 'cellColors' => ['color' => 'white', 'background' => 'black'],
+ 'useAlternatingRows' => false,
+ 'statusColors' => [
+ 'success' => ['color' => 'white', 'background' => 'green', 'bold' => true],
+ 'error' => ['color' => 'white', 'background' => 'red', 'bold' => true],
+ 'warning' => ['color' => 'black', 'background' => 'yellow', 'bold' => true],
+ 'info' => ['color' => 'white', 'background' => 'blue', 'bold' => true]
+ ]
+ ]);
+ }
+
+ /**
+ * Check if a theme name is valid.
+ *
+ * @param string $themeName The theme name to validate
+ * @return bool True if the theme is supported, false otherwise
+ */
+ public static function isValidTheme(string $themeName): bool {
+ return in_array(strtolower($themeName), array_map('strtolower', self::getAvailableThemes()), true);
+ }
+
+ /**
+ * Create a light theme.
+ */
+ public static function light(): self {
+ return new self([
+ 'headerColors' => ['color' => 'blue', 'bold' => true],
+ 'cellColors' => ['color' => 'black'],
+ 'alternatingRowColors' => [
+ [],
+ ['background' => 'white']
+ ],
+ 'useAlternatingRows' => true,
+ 'statusColors' => [
+ 'success' => ['color' => 'green'],
+ 'error' => ['color' => 'red'],
+ 'warning' => ['color' => 'yellow'],
+ 'info' => ['color' => 'blue']
+ ]
+ ]);
+ }
+
+ /**
+ * Create a minimal theme (no colors).
+ */
+ public static function minimal(): self {
+ return new self([
+ 'headerColors' => ['bold' => true],
+ 'cellColors' => [],
+ 'useAlternatingRows' => false
+ ]);
+ }
+
+ /**
+ * Create a professional theme.
+ */
+ public static function professional(): self {
+ return new self([
+ 'headerColors' => ['color' => 'white', 'background' => 'blue', 'bold' => true],
+ 'cellColors' => [],
+ 'alternatingRowColors' => [
+ [],
+ ['background' => 'light-blue']
+ ],
+ 'useAlternatingRows' => true,
+ 'statusColors' => [
+ 'active' => ['color' => 'green'],
+ 'inactive' => ['color' => 'red'],
+ 'pending' => ['color' => 'yellow']
+ ]
+ ]);
+ }
+
+ /**
+ * Set alternating row colors.
+ */
+ public function setAlternatingRowColors(array $colors): self {
+ $this->alternatingRowColors = $colors;
+ $this->useAlternatingRows = !empty($colors);
+
+ return $this;
+ }
+
+ /**
+ * Set cell colors.
+ */
+ public function setCellColors(array $colors): self {
+ $this->cellColors = $colors;
+
+ return $this;
+ }
+
+ /**
+ * Set custom cell styler function.
+ */
+ public function setCellStyler($styler): self {
+ $this->cellStyler = $styler;
+
+ return $this;
+ }
+
+ /**
+ * Set header colors.
+ */
+ public function setHeaderColors(array $colors): self {
+ $this->headerColors = $colors;
+
+ return $this;
+ }
+
+ /**
+ * Set custom header styler function.
+ */
+ public function setHeaderStyler($styler): self {
+ $this->headerStyler = $styler;
+
+ return $this;
+ }
+
+ /**
+ * Set status-based colors.
+ */
+ public function setStatusColors(array $colors): self {
+ $this->statusColors = $colors;
+
+ return $this;
+ }
+
+ /**
+ * Enable/disable alternating rows.
+ */
+ public function useAlternatingRows(bool $use = true): self {
+ $this->useAlternatingRows = $use;
+
+ return $this;
+ }
+
+ /**
+ * Apply ANSI colors to text.
+ */
+ private function applyColors(string $text, array $colors): string {
+ if (empty($colors)) {
+ return $text;
+ }
+
+ $codes = [];
+
+ // Foreground colors
+ if (isset($colors['color'])) {
+ $codes[] = $this->getColorCode($colors['color']);
+ }
+
+ // Background colors
+ if (isset($colors['background'])) {
+ $codes[] = $this->getColorCode($colors['background'], true);
+ }
+
+ // Text styles
+ if (isset($colors['bold']) && $colors['bold']) {
+ $codes[] = '1';
+ }
+
+ if (isset($colors['underline']) && $colors['underline']) {
+ $codes[] = '4';
+ }
+
+ if (isset($colors['italic']) && $colors['italic']) {
+ $codes[] = '3';
+ }
+
+ if (empty($codes)) {
+ return $text;
+ }
+
+ return "\x1b[".implode(';', $codes)."m".$text."\x1b[0m";
+ }
+
+ /**
+ * Apply status-based colors.
+ */
+ private function applyStatusColors(string $text): string {
+ if (empty($this->statusColors)) {
+ return $text;
+ }
+
+ $lowerText = strtolower(trim($text));
+
+ foreach ($this->statusColors as $status => $colors) {
+ if (strpos($lowerText, strtolower($status)) !== false) {
+ return $this->applyColors($text, $colors);
+ }
+ }
+
+ return $text;
+ }
+
+ /**
+ * Detect if terminal supports colors.
+ */
+ private static function detectColorSupport(): bool {
+ // Check environment variables
+ $term = getenv('TERM');
+ $colorTerm = getenv('COLORTERM');
+
+ if ($colorTerm) {
+ return true;
+ }
+
+ if ($term && (
+ strpos($term, 'color') !== false ||
+ strpos($term, '256') !== false ||
+ strpos($term, 'xterm') !== false
+ )) {
+ return true;
+ }
+
+ // Check if running in a known terminal
+ if (getenv('TERM_PROGRAM')) {
+ return true;
+ }
+
+ return false;
+ }
+
+ /**
+ * Detect if terminal has dark background.
+ */
+ private static function detectDarkTerminal(): bool {
+ // This is a best guess - terminal background detection is limited
+ $termProgram = getenv('TERM_PROGRAM');
+
+ // Some terminals are typically dark by default
+ if ($termProgram && in_array($termProgram, ['iTerm.app', 'Terminal.app'])) {
+ return true;
+ }
+
+ // Default assumption for most terminals
+ return true;
+ }
+
+ /**
+ * Get ANSI color code.
+ */
+ private function getColorCode(string $color, bool $background = false): string {
+ $colors = [
+ 'black' => $background ? '40' : '30',
+ 'red' => $background ? '41' : '31',
+ 'green' => $background ? '42' : '32',
+ 'yellow' => $background ? '43' : '33',
+ 'blue' => $background ? '44' : '34',
+ 'magenta' => $background ? '45' : '35',
+ 'cyan' => $background ? '46' : '36',
+ 'white' => $background ? '47' : '37',
+ 'light-red' => $background ? '101' : '91',
+ 'light-green' => $background ? '102' : '92',
+ 'light-yellow' => $background ? '103' : '93',
+ 'light-blue' => $background ? '104' : '94',
+ 'light-magenta' => $background ? '105' : '95',
+ 'light-cyan' => $background ? '106' : '96',
+ ];
+
+ return $colors[strtolower($color)] ?? ($background ? '40' : '30');
+ }
+}
diff --git a/WebFiori/Cli/Templates/TemplateManager.php b/WebFiori/Cli/Templates/TemplateManager.php
index aa757f3..f4cf4c8 100644
--- a/WebFiori/Cli/Templates/TemplateManager.php
+++ b/WebFiori/Cli/Templates/TemplateManager.php
@@ -1,55 +1,55 @@
-templatesPath = $templatesPath ?? __DIR__ . '/stubs';
- }
-
- /**
- * Get template content by name.
- */
- public function getTemplate(string $name): string {
- $templateFile = $this->templatesPath . '/' . $name . '.stub';
-
- if (!file_exists($templateFile)) {
- throw new \InvalidArgumentException("Template '$name' not found at: $templateFile");
- }
-
- return file_get_contents($templateFile);
- }
-
- /**
- * Get available templates.
- */
- public function getAvailableTemplates(): array {
- $templates = [];
- $files = glob($this->templatesPath . '/*.stub');
-
- foreach ($files as $file) {
- $templates[] = basename($file, '.stub');
- }
-
- return $templates;
- }
-
- /**
- * Process template with variables.
- */
- public function processTemplate(string $template, array $variables): string {
- $content = $this->getTemplate($template);
-
- foreach ($variables as $key => $value) {
- $content = str_replace('{{' . $key . '}}', $value, $content);
- }
-
- return $content;
- }
-}
+templatesPath = $templatesPath ?? __DIR__ . '/stubs';
+ }
+
+ /**
+ * Get template content by name.
+ */
+ public function getTemplate(string $name): string {
+ $templateFile = $this->templatesPath . '/' . $name . '.stub';
+
+ if (!file_exists($templateFile)) {
+ throw new \InvalidArgumentException("Template '$name' not found at: $templateFile");
+ }
+
+ return file_get_contents($templateFile);
+ }
+
+ /**
+ * Get available templates.
+ */
+ public function getAvailableTemplates(): array {
+ $templates = [];
+ $files = glob($this->templatesPath . '/*.stub');
+
+ foreach ($files as $file) {
+ $templates[] = basename($file, '.stub');
+ }
+
+ return $templates;
+ }
+
+ /**
+ * Process template with variables.
+ */
+ public function processTemplate(string $template, array $variables): string {
+ $content = $this->getTemplate($template);
+
+ foreach ($variables as $key => $value) {
+ $content = str_replace('{{' . $key . '}}', $value, $content);
+ }
+
+ return $content;
+ }
+}
diff --git a/WebFiori/Cli/Templates/stubs/basic.stub b/WebFiori/Cli/Templates/stubs/basic.stub
index 85e8b45..b9ccc85 100644
--- a/WebFiori/Cli/Templates/stubs/basic.stub
+++ b/WebFiori/Cli/Templates/stubs/basic.stub
@@ -1,23 +1,23 @@
-println('๐ Executing {{command_name}} command...');
-
- // TODO: Implement your command logic here
-
- $this->success('โ Command completed successfully!');
- return 0;
- }
-}
+println('๐ Executing {{command_name}} command...');
+
+ // TODO: Implement your command logic here
+
+ $this->success('โ Command completed successfully!');
+ return 0;
+ }
+}
diff --git a/WebFiori/Cli/Templates/stubs/crud.stub b/WebFiori/Cli/Templates/stubs/crud.stub
index 52c8b94..2156de9 100644
--- a/WebFiori/Cli/Templates/stubs/crud.stub
+++ b/WebFiori/Cli/Templates/stubs/crud.stub
@@ -1,73 +1,73 @@
- [
- ArgumentOption::DESCRIPTION => 'CRUD action to perform',
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::VALUES => ['create', 'read', 'show', 'update', 'delete', 'list'],
- ArgumentOption::DEFAULT => 'list'
- ]
- ]), '{{command_description}}');
- }
-
- public function exec(): int {
- $action = $this->getArgValue('--action') ?? 'list';
-
- switch ($action) {
- case 'create':
- return $this->createRecord();
- case 'read':
- case 'show':
- return $this->showRecord();
- case 'update':
- return $this->updateRecord();
- case 'delete':
- return $this->deleteRecord();
- case 'list':
- default:
- return $this->listRecords();
- }
- }
-
- private function createRecord(): int {
- $this->info('Creating new record...');
- // TODO: Implement create logic
- $this->success('โ Record created successfully!');
- return 0;
- }
-
- private function showRecord(): int {
- $this->info('Showing record...');
- // TODO: Implement show logic
- return 0;
- }
-
- private function updateRecord(): int {
- $this->info('Updating record...');
- // TODO: Implement update logic
- $this->success('โ Record updated successfully!');
- return 0;
- }
-
- private function deleteRecord(): int {
- $this->info('Deleting record...');
- // TODO: Implement delete logic
- $this->success('โ Record deleted successfully!');
- return 0;
- }
-
- private function listRecords(): int {
- $this->info('Listing records...');
- // TODO: Implement list logic
- return 0;
- }
-}
+ [
+ ArgumentOption::DESCRIPTION => 'CRUD action to perform',
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::VALUES => ['create', 'read', 'show', 'update', 'delete', 'list'],
+ ArgumentOption::DEFAULT => 'list'
+ ]
+ ]), '{{command_description}}');
+ }
+
+ public function exec(): int {
+ $action = $this->getArgValue('--action') ?? 'list';
+
+ switch ($action) {
+ case 'create':
+ return $this->createRecord();
+ case 'read':
+ case 'show':
+ return $this->showRecord();
+ case 'update':
+ return $this->updateRecord();
+ case 'delete':
+ return $this->deleteRecord();
+ case 'list':
+ default:
+ return $this->listRecords();
+ }
+ }
+
+ private function createRecord(): int {
+ $this->info('Creating new record...');
+ // TODO: Implement create logic
+ $this->success('โ Record created successfully!');
+ return 0;
+ }
+
+ private function showRecord(): int {
+ $this->info('Showing record...');
+ // TODO: Implement show logic
+ return 0;
+ }
+
+ private function updateRecord(): int {
+ $this->info('Updating record...');
+ // TODO: Implement update logic
+ $this->success('โ Record updated successfully!');
+ return 0;
+ }
+
+ private function deleteRecord(): int {
+ $this->info('Deleting record...');
+ // TODO: Implement delete logic
+ $this->success('โ Record deleted successfully!');
+ return 0;
+ }
+
+ private function listRecords(): int {
+ $this->info('Listing records...');
+ // TODO: Implement list logic
+ return 0;
+ }
+}
diff --git a/WebFiori/Cli/Templates/stubs/interactive.stub b/WebFiori/Cli/Templates/stubs/interactive.stub
index 22cb7b2..c62c6b1 100644
--- a/WebFiori/Cli/Templates/stubs/interactive.stub
+++ b/WebFiori/Cli/Templates/stubs/interactive.stub
@@ -1,43 +1,43 @@
-println('๐ง Interactive Command Setup');
- $this->println('==========================');
-
- // Get user input
- $name = $this->getInput('Enter name: ');
- $email = $this->getInput('Enter email: ', null, new InputValidator(function($email) {
- return filter_var($email, FILTER_VALIDATE_EMAIL) !== false;
- }, 'Please enter a valid email address!'));
-
- // Confirm action
- if ($this->confirm('Proceed with the operation?')) {
- $this->processData($name, $email);
- $this->success('โ Operation completed successfully!');
- } else {
- $this->info('Operation cancelled.');
- }
-
- return 0;
- }
-
- /**
- * Process the collected data.
- */
- private function processData(string $name, string $email): void {
- // TODO: Implement data processing logic
- $this->info("Processing data for: $name ($email)");
- }
-}
+println('๐ง Interactive Command Setup');
+ $this->println('==========================');
+
+ // Get user input
+ $name = $this->getInput('Enter name: ');
+ $email = $this->getInput('Enter email: ', null, new InputValidator(function($email) {
+ return filter_var($email, FILTER_VALIDATE_EMAIL) !== false;
+ }, 'Please enter a valid email address!'));
+
+ // Confirm action
+ if ($this->confirm('Proceed with the operation?')) {
+ $this->processData($name, $email);
+ $this->success('โ Operation completed successfully!');
+ } else {
+ $this->info('Operation cancelled.');
+ }
+
+ return 0;
+ }
+
+ /**
+ * Process the collected data.
+ */
+ private function processData(string $name, string $email): void {
+ // TODO: Implement data processing logic
+ $this->info("Processing data for: $name ($email)");
+ }
+}
diff --git a/bin/main.php b/bin/main.php
index 32e9eff..29fe108 100644
--- a/bin/main.php
+++ b/bin/main.php
@@ -1,13 +1,13 @@
-register(new HelpCommand())
- ->register(new InitAppCommand())
- ->setDefaultCommand('help')
- ->start());
+register(new HelpCommand())
+ ->register(new InitAppCommand())
+ ->setDefaultCommand('help')
+ ->start());
diff --git a/bin/wfc b/bin/wfc
index 571395f..533a29c 100644
--- a/bin/wfc
+++ b/bin/wfc
@@ -1,3 +1,3 @@
-#!/usr/bin/env php
- [
- ArgumentOption::DESCRIPTION => 'The name to greet (default: World)',
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DEFAULT => 'World'
- ]
- ], 'A simple greeting command that says hello to someone');
- }
-
- /**
- * Execute the hello command.
- *
- * This method demonstrates:
- * - Getting argument values
- * - Basic output formatting
- * - Conditional logic
- * - Proper return codes
- */
- public function exec(): int {
- // Get the name argument, with fallback to default
- $name = $this->getArgValue('--name') ?? 'World';
-
- // Trim whitespace and validate
- $name = trim($name);
-
- if (empty($name)) {
- $this->error('Name cannot be empty!');
-
- return 1; // Error exit code
- }
-
- // Special greeting for WebFiori
- if (strtolower($name) === 'webfiori') {
- $this->success("๐ Hello, $name! Welcome to the CLI world!");
- $this->info('You\'re using the WebFiori CLI library.');
- } else {
- // Standard greeting
- $this->println("Hello, $name! ๐");
-
- // Add some personality based on name length
- if (strlen($name) > 10) {
- $this->info('Wow, that\'s quite a long name!');
- } elseif (strlen($name) <= 2) {
- $this->info('Short and sweet!');
- }
- }
-
- // Success message
- $this->println('Have a wonderful day!');
-
- return 0; // Success exit code
- }
-}
+ [
+ ArgumentOption::DESCRIPTION => 'The name to greet (default: World)',
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DEFAULT => 'World'
+ ]
+ ], 'A simple greeting command that says hello to someone');
+ }
+
+ /**
+ * Execute the hello command.
+ *
+ * This method demonstrates:
+ * - Getting argument values
+ * - Basic output formatting
+ * - Conditional logic
+ * - Proper return codes
+ */
+ public function exec(): int {
+ // Get the name argument, with fallback to default
+ $name = $this->getArgValue('--name') ?? 'World';
+
+ // Trim whitespace and validate
+ $name = trim($name);
+
+ if (empty($name)) {
+ $this->error('Name cannot be empty!');
+
+ return 1; // Error exit code
+ }
+
+ // Special greeting for WebFiori
+ if (strtolower($name) === 'webfiori') {
+ $this->success("๐ Hello, $name! Welcome to the CLI world!");
+ $this->info('You\'re using the WebFiori CLI library.');
+ } else {
+ // Standard greeting
+ $this->println("Hello, $name! ๐");
+
+ // Add some personality based on name length
+ if (strlen($name) > 10) {
+ $this->info('Wow, that\'s quite a long name!');
+ } elseif (strlen($name) <= 2) {
+ $this->info('Short and sweet!');
+ }
+ }
+
+ // Success message
+ $this->println('Have a wonderful day!');
+
+ return 0; // Success exit code
+ }
+}
diff --git a/examples/01-basic-hello-world/README.md b/examples/01-basic-hello-world/README.md
index fed2549..07170c3 100644
--- a/examples/01-basic-hello-world/README.md
+++ b/examples/01-basic-hello-world/README.md
@@ -1,145 +1,145 @@
-# Basic Hello World Example
-
-This example demonstrates the most basic CLI command creation using WebFiori CLI library.
-
-## Features Demonstrated
-
-- Creating a simple command class
-- Adding optional arguments with default values
-- Basic output formatting with emojis
-- Help system integration
-- Error handling
-
-## Files
-
-- `main.php` - Application entry point and runner setup
-- `HelloCommand.php` - The hello command implementation
-
-## Usage Examples
-
-### 1. Show General Help
-```bash
-php main.php
-# or
-php main.php help
-```
-**Output:**
-```
-Usage:
- command [arg1 arg2="val" arg3...]
-
-Global Arguments:
- --ansi:[Optional] Force the use of ANSI output.
-Available Commands:
- help: Display CLI Help. To display help for specific command, use the argument "--command" with this command.
- hello: A simple greeting command that says hello to someone
-```
-
-### 2. Show Command-Specific Help
-```bash
-php main.php help --command=hello
-```
-**Output:**
-```
- hello: A simple greeting command that says hello to someone
- Supported Arguments:
- --name:[Optional][Default = 'World'] The name to greet (default: World)
-```
-
-### 3. Basic Hello (Default Name)
-```bash
-php main.php hello
-```
-**Output:**
-```
-Hello, World! ๐
-Have a wonderful day!
-```
-
-### 4. Hello with Custom Name
-```bash
-php main.php hello --name=Ahmed
-```
-**Output:**
-```
-Hello, Ahmed! ๐
-Have a wonderful day!
-```
-
-### 5. Hello with Multi-word Name
-```bash
-php main.php hello --name="Fatima Al-Zahra"
-```
-**Output:**
-```
-Hello, Fatima Al-Zahra! ๐
-Have a wonderful day!
-```
-
-### 6. Using Global ANSI Flag
-```bash
-php main.php hello --name=Mohammed --ansi
-```
-**Output:**
-```
-Hello, Mohammed! ๐
-Have a wonderful day!
-```
-
-### 7. Error Handling - Invalid Command
-```bash
-php main.php invalid
-```
-**Output:**
-```
-Error: The command 'invalid' is not supported.
-```
-
-## Key Learning Points
-
-1. **Command Structure**: Commands extend `WebFiori\Cli\Command` and implement `exec()` method
-2. **Arguments**: Optional arguments defined in constructor with default values
-3. **Output**: Use `println()` for formatted output with emoji support
-4. **Help Integration**: Commands automatically integrate with help system
-5. **Error Handling**: Invalid commands show appropriate error messages
-6. **Global Arguments**: `--ansi` flag works with all commands
-
-## Code Structure
-
-```php
-class HelloCommand extends Command {
- public function __construct() {
- parent::__construct('hello', [
- '--name' => [
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DEFAULT => 'World',
- ArgumentOption::DESCRIPTION => 'The name to greet (default: World)'
- ]
- ], 'A simple greeting command that says hello to someone');
- }
-
- public function exec(): int {
- $name = $this->getArgValue('--name');
- $this->println("Hello, %s! ๐", $name);
- $this->println("Have a wonderful day!");
- return 0;
- }
-}
-```
-
-This example serves as the foundation for understanding WebFiori CLI basics before moving to more advanced features.
-
-## Related Examples
-
-### Next Steps
-- **[02-arguments-and-options](../02-arguments-and-options/)** - Learn advanced argument handling and validation
-- **[03-user-input](../03-user-input/)** - Add interactive user input to your commands
-- **[04-output-formatting](../04-output-formatting/)** - Enhance output with colors and formatting
-
-### Advanced Features
-- **[10-multi-command-app](../10-multi-command-app/)** - Build complete CLI applications
-- **[12-command-scaffolding](../12-command-scaffolding/)** - Generate commands automatically
-
-### Similar Concepts
-- **[05-interactive-commands](../05-interactive-commands/)** - Interactive command workflows
-- **[11-masked-input](../11-masked-input/)** - Secure input handling
+# Basic Hello World Example
+
+This example demonstrates the most basic CLI command creation using WebFiori CLI library.
+
+## Features Demonstrated
+
+- Creating a simple command class
+- Adding optional arguments with default values
+- Basic output formatting with emojis
+- Help system integration
+- Error handling
+
+## Files
+
+- `main.php` - Application entry point and runner setup
+- `HelloCommand.php` - The hello command implementation
+
+## Usage Examples
+
+### 1. Show General Help
+```bash
+php main.php
+# or
+php main.php help
+```
+**Output:**
+```
+Usage:
+ command [arg1 arg2="val" arg3...]
+
+Global Arguments:
+ --ansi:[Optional] Force the use of ANSI output.
+Available Commands:
+ help: Display CLI Help. To display help for specific command, use the argument "--command" with this command.
+ hello: A simple greeting command that says hello to someone
+```
+
+### 2. Show Command-Specific Help
+```bash
+php main.php help --command=hello
+```
+**Output:**
+```
+ hello: A simple greeting command that says hello to someone
+ Supported Arguments:
+ --name:[Optional][Default = 'World'] The name to greet (default: World)
+```
+
+### 3. Basic Hello (Default Name)
+```bash
+php main.php hello
+```
+**Output:**
+```
+Hello, World! ๐
+Have a wonderful day!
+```
+
+### 4. Hello with Custom Name
+```bash
+php main.php hello --name=Ahmed
+```
+**Output:**
+```
+Hello, Ahmed! ๐
+Have a wonderful day!
+```
+
+### 5. Hello with Multi-word Name
+```bash
+php main.php hello --name="Fatima Al-Zahra"
+```
+**Output:**
+```
+Hello, Fatima Al-Zahra! ๐
+Have a wonderful day!
+```
+
+### 6. Using Global ANSI Flag
+```bash
+php main.php hello --name=Mohammed --ansi
+```
+**Output:**
+```
+Hello, Mohammed! ๐
+Have a wonderful day!
+```
+
+### 7. Error Handling - Invalid Command
+```bash
+php main.php invalid
+```
+**Output:**
+```
+Error: The command 'invalid' is not supported.
+```
+
+## Key Learning Points
+
+1. **Command Structure**: Commands extend `WebFiori\Cli\Command` and implement `exec()` method
+2. **Arguments**: Optional arguments defined in constructor with default values
+3. **Output**: Use `println()` for formatted output with emoji support
+4. **Help Integration**: Commands automatically integrate with help system
+5. **Error Handling**: Invalid commands show appropriate error messages
+6. **Global Arguments**: `--ansi` flag works with all commands
+
+## Code Structure
+
+```php
+class HelloCommand extends Command {
+ public function __construct() {
+ parent::__construct('hello', [
+ '--name' => [
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DEFAULT => 'World',
+ ArgumentOption::DESCRIPTION => 'The name to greet (default: World)'
+ ]
+ ], 'A simple greeting command that says hello to someone');
+ }
+
+ public function exec(): int {
+ $name = $this->getArgValue('--name');
+ $this->println("Hello, %s! ๐", $name);
+ $this->println("Have a wonderful day!");
+ return 0;
+ }
+}
+```
+
+This example serves as the foundation for understanding WebFiori CLI basics before moving to more advanced features.
+
+## Related Examples
+
+### Next Steps
+- **[02-arguments-and-options](../02-arguments-and-options/)** - Learn advanced argument handling and validation
+- **[03-user-input](../03-user-input/)** - Add interactive user input to your commands
+- **[04-output-formatting](../04-output-formatting/)** - Enhance output with colors and formatting
+
+### Advanced Features
+- **[10-multi-command-app](../10-multi-command-app/)** - Build complete CLI applications
+- **[12-command-scaffolding](../12-command-scaffolding/)** - Generate commands automatically
+
+### Similar Concepts
+- **[05-interactive-commands](../05-interactive-commands/)** - Interactive command workflows
+- **[11-masked-input](../11-masked-input/)** - Secure input handling
diff --git a/examples/01-basic-hello-world/main.php b/examples/01-basic-hello-world/main.php
index 1ff13bb..d102c74 100644
--- a/examples/01-basic-hello-world/main.php
+++ b/examples/01-basic-hello-world/main.php
@@ -1,35 +1,35 @@
-register(new HelloCommand());
-
-// Set the default command to show help when no command is specified
-
-// Start the CLI application and exit with the appropriate code
-exit($runner->start());
+register(new HelloCommand());
+
+// Set the default command to show help when no command is specified
+
+// Start the CLI application and exit with the appropriate code
+exit($runner->start());
diff --git a/examples/02-arguments-and-options/CalculatorCommand.php b/examples/02-arguments-and-options/CalculatorCommand.php
index 846041c..4696241 100644
--- a/examples/02-arguments-and-options/CalculatorCommand.php
+++ b/examples/02-arguments-and-options/CalculatorCommand.php
@@ -1,170 +1,170 @@
- [
- ArgumentOption::DESCRIPTION => 'Mathematical operation to perform',
- ArgumentOption::OPTIONAL => false,
- ArgumentOption::VALUES => ['add', 'subtract', 'multiply', 'divide', 'average']
- ],
- '--numbers' => [
- ArgumentOption::DESCRIPTION => 'Comma-separated list of numbers (e.g., "1,2,3,4")',
- ArgumentOption::OPTIONAL => false
- ],
- '--precision' => [
- ArgumentOption::DESCRIPTION => 'Number of decimal places for the result',
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DEFAULT => '2'
- ],
- '--verbose' => [
- ArgumentOption::DESCRIPTION => 'Show detailed calculation steps',
- ArgumentOption::OPTIONAL => true
- ]
- ], 'Performs mathematical calculations on a list of numbers');
- }
-
- public function exec(): int {
- // Get and validate arguments
- $operation = $this->getArgValue('--operation');
- $numbersStr = $this->getArgValue('--numbers');
- $precision = (int)($this->getArgValue('--precision') ?? 2);
- $verbose = $this->isArgProvided('--verbose');
-
- // Parse and validate numbers
- $numbers = $this->parseNumbers($numbersStr);
-
- if (empty($numbers)) {
- $this->error('No valid numbers provided. Please provide comma-separated numbers.');
- $this->info('Example: --numbers="1,2,3,4.5"');
-
- return 1;
- }
-
- // Validate precision
- if ($precision < 0 || $precision > 10) {
- $this->error('Precision must be between 0 and 10');
-
- return 1;
- }
-
- // Show input if verbose
- if ($verbose) {
- $this->info("๐ข Operation: ".ucfirst($operation));
- $this->info("๐ Numbers: ".implode(', ', $numbers));
- $this->info("๐ฏ Precision: $precision decimal places");
- $this->println();
- }
-
- // Perform calculation
- try {
- $result = $this->performCalculation($operation, $numbers);
-
- // Display result
- $this->success("โ Performing $operation on: ".implode(', ', $numbers));
- $this->println("๐ Result: ".number_format($result, $precision));
-
- // Show additional info if verbose
- if ($verbose) {
- $this->println();
- $this->info("๐ Statistics:");
- $this->println(" โข Count: ".count($numbers));
- $this->println(" โข Min: ".min($numbers));
- $this->println(" โข Max: ".max($numbers));
-
- if ($operation !== 'average') {
- $this->println(" โข Average: ".number_format(array_sum($numbers) / count($numbers), $precision));
- }
- }
- } catch (Exception $e) {
- $this->error("โ Calculation error: ".$e->getMessage());
-
- return 1;
- }
-
- return 0;
- }
-
- /**
- * Parse comma-separated numbers string into array of floats.
- */
- private function parseNumbers(string $numbersStr): array {
- $parts = array_map('trim', explode(',', $numbersStr));
- $numbers = [];
-
- foreach ($parts as $part) {
- if (is_numeric($part)) {
- $numbers[] = (float)$part;
- } else if (!empty($part)) {
- $this->warning("โ ๏ธ Ignoring invalid number: '$part'");
- }
- }
-
- return $numbers;
- }
-
- /**
- * Perform the mathematical operation.
- */
- private function performCalculation(string $operation, array $numbers): float {
- switch ($operation) {
- case 'add':
- return array_sum($numbers);
-
- case 'subtract':
- if (count($numbers) < 2) {
- throw new Exception('Subtraction requires at least 2 numbers');
- }
- $result = $numbers[0];
-
- for ($i = 1; $i < count($numbers); $i++) {
- $result -= $numbers[$i];
- }
-
- return $result;
-
- case 'multiply':
- $result = 1;
-
- foreach ($numbers as $number) {
- $result *= $number;
- }
-
- return $result;
-
- case 'divide':
- if (count($numbers) < 2) {
- throw new Exception('Division requires at least 2 numbers');
- }
- $result = $numbers[0];
-
- for ($i = 1; $i < count($numbers); $i++) {
- if ($numbers[$i] == 0) {
- throw new Exception('Division by zero is not allowed');
- }
- $result /= $numbers[$i];
- }
-
- return $result;
-
- case 'average':
- return array_sum($numbers) / count($numbers);
-
- default:
- throw new Exception("Unknown operation: $operation");
- }
- }
-}
+ [
+ ArgumentOption::DESCRIPTION => 'Mathematical operation to perform',
+ ArgumentOption::OPTIONAL => false,
+ ArgumentOption::VALUES => ['add', 'subtract', 'multiply', 'divide', 'average']
+ ],
+ '--numbers' => [
+ ArgumentOption::DESCRIPTION => 'Comma-separated list of numbers (e.g., "1,2,3,4")',
+ ArgumentOption::OPTIONAL => false
+ ],
+ '--precision' => [
+ ArgumentOption::DESCRIPTION => 'Number of decimal places for the result',
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DEFAULT => '2'
+ ],
+ '--verbose' => [
+ ArgumentOption::DESCRIPTION => 'Show detailed calculation steps',
+ ArgumentOption::OPTIONAL => true
+ ]
+ ], 'Performs mathematical calculations on a list of numbers');
+ }
+
+ public function exec(): int {
+ // Get and validate arguments
+ $operation = $this->getArgValue('--operation');
+ $numbersStr = $this->getArgValue('--numbers');
+ $precision = (int)($this->getArgValue('--precision') ?? 2);
+ $verbose = $this->isArgProvided('--verbose');
+
+ // Parse and validate numbers
+ $numbers = $this->parseNumbers($numbersStr);
+
+ if (empty($numbers)) {
+ $this->error('No valid numbers provided. Please provide comma-separated numbers.');
+ $this->info('Example: --numbers="1,2,3,4.5"');
+
+ return 1;
+ }
+
+ // Validate precision
+ if ($precision < 0 || $precision > 10) {
+ $this->error('Precision must be between 0 and 10');
+
+ return 1;
+ }
+
+ // Show input if verbose
+ if ($verbose) {
+ $this->info("๐ข Operation: ".ucfirst($operation));
+ $this->info("๐ Numbers: ".implode(', ', $numbers));
+ $this->info("๐ฏ Precision: $precision decimal places");
+ $this->println();
+ }
+
+ // Perform calculation
+ try {
+ $result = $this->performCalculation($operation, $numbers);
+
+ // Display result
+ $this->success("โ Performing $operation on: ".implode(', ', $numbers));
+ $this->println("๐ Result: ".number_format($result, $precision));
+
+ // Show additional info if verbose
+ if ($verbose) {
+ $this->println();
+ $this->info("๐ Statistics:");
+ $this->println(" โข Count: ".count($numbers));
+ $this->println(" โข Min: ".min($numbers));
+ $this->println(" โข Max: ".max($numbers));
+
+ if ($operation !== 'average') {
+ $this->println(" โข Average: ".number_format(array_sum($numbers) / count($numbers), $precision));
+ }
+ }
+ } catch (Exception $e) {
+ $this->error("โ Calculation error: ".$e->getMessage());
+
+ return 1;
+ }
+
+ return 0;
+ }
+
+ /**
+ * Parse comma-separated numbers string into array of floats.
+ */
+ private function parseNumbers(string $numbersStr): array {
+ $parts = array_map('trim', explode(',', $numbersStr));
+ $numbers = [];
+
+ foreach ($parts as $part) {
+ if (is_numeric($part)) {
+ $numbers[] = (float)$part;
+ } else if (!empty($part)) {
+ $this->warning("โ ๏ธ Ignoring invalid number: '$part'");
+ }
+ }
+
+ return $numbers;
+ }
+
+ /**
+ * Perform the mathematical operation.
+ */
+ private function performCalculation(string $operation, array $numbers): float {
+ switch ($operation) {
+ case 'add':
+ return array_sum($numbers);
+
+ case 'subtract':
+ if (count($numbers) < 2) {
+ throw new Exception('Subtraction requires at least 2 numbers');
+ }
+ $result = $numbers[0];
+
+ for ($i = 1; $i < count($numbers); $i++) {
+ $result -= $numbers[$i];
+ }
+
+ return $result;
+
+ case 'multiply':
+ $result = 1;
+
+ foreach ($numbers as $number) {
+ $result *= $number;
+ }
+
+ return $result;
+
+ case 'divide':
+ if (count($numbers) < 2) {
+ throw new Exception('Division requires at least 2 numbers');
+ }
+ $result = $numbers[0];
+
+ for ($i = 1; $i < count($numbers); $i++) {
+ if ($numbers[$i] == 0) {
+ throw new Exception('Division by zero is not allowed');
+ }
+ $result /= $numbers[$i];
+ }
+
+ return $result;
+
+ case 'average':
+ return array_sum($numbers) / count($numbers);
+
+ default:
+ throw new Exception("Unknown operation: $operation");
+ }
+ }
+}
diff --git a/examples/02-arguments-and-options/README.md b/examples/02-arguments-and-options/README.md
index c7358a1..08cc718 100644
--- a/examples/02-arguments-and-options/README.md
+++ b/examples/02-arguments-and-options/README.md
@@ -1,371 +1,371 @@
-# Arguments and Options Example
-
-This example demonstrates advanced argument handling, validation, and complex command logic using WebFiori CLI library.
-
-## Features Demonstrated
-
-- Required and optional arguments
-- Argument validation with allowed values
-- Custom validation logic (email, age ranges)
-- Boolean flags
-- Default values
-- Precision control
-- Verbose output modes
-- Error handling and validation messages
-
-## Files
-
-- `main.php` - Application entry point and runner setup
-- `CalculatorCommand.php` - Mathematical calculator with multiple operations
-- `UserProfileCommand.php` - User profile creator with validation
-
-## Usage Examples
-
-### General Help
-```bash
-php main.php
-# or
-php main.php help
-```
-**Output:**
-```
-Usage:
- command [arg1 arg2="val" arg3...]
-
-Global Arguments:
- --ansi:[Optional] Force the use of ANSI output.
-Available Commands:
- help: Display CLI Help. To display help for specific command, use the argument "--command" with this command.
- calc: Performs mathematical calculations on a list of numbers
- profile: Creates a user profile with validation and formatting
-```
-
-## Calculator Command Examples
-
-### Show Calculator Help
-```bash
-php main.php help --command=calc
-```
-**Output:**
-```
- calc: Performs mathematical calculations on a list of numbers
- Supported Arguments:
- --operation: Mathematical operation to perform
- --numbers: Comma-separated list of numbers (e.g., "1,2,3,4")
- --precision:[Optional][Default = '2'] Number of decimal places for the result
- --verbose:[Optional] Show detailed calculation steps
-```
-
-### Basic Operations
-
-#### Addition
-```bash
-php main.php calc --numbers=1,2,3,4,5 --operation=add
-```
-**Output:**
-```
-โ Performing add on: 1, 2, 3, 4, 5
-๐ Result: 15.00
-```
-
-#### Subtraction
-```bash
-php main.php calc --numbers=10,3,2 --operation=subtract
-```
-**Output:**
-```
-โ Performing subtract on: 10, 3, 2
-๐ Result: 5.00
-```
-
-#### Multiplication
-```bash
-php main.php calc --numbers=2,3,4 --operation=multiply
-```
-**Output:**
-```
-โ Performing multiply on: 2, 3, 4
-๐ Result: 24.00
-```
-
-#### Division
-```bash
-php main.php calc --numbers=100,5,2 --operation=divide
-```
-**Output:**
-```
-โ Performing divide on: 100, 5, 2
-๐ Result: 10.00
-```
-
-#### Average
-```bash
-php main.php calc --numbers=10,20,30,40,50 --operation=average
-```
-**Output:**
-```
-โ Performing average on: 10, 20, 30, 40, 50
-๐ Result: 30.00
-```
-
-### Advanced Calculator Features
-
-#### Custom Precision
-```bash
-php main.php calc --numbers=10,3 --operation=divide --precision=4
-```
-**Output:**
-```
-โ Performing divide on: 10, 3
-๐ Result: 3.3333
-```
-
-#### Verbose Mode
-```bash
-php main.php calc --numbers=5,10,15 --operation=add --verbose
-```
-**Output:**
-```
-๐ข Operation: Add
-๐ Numbers: 5, 10, 15
-๐ฏ Precision: 2 decimal places
-
-โ Performing add on: 5, 10, 15
-๐ Result: 30.00
-
-๐ Statistics:
- โข Count: 3
- โข Min: 5
- โข Max: 15
- โข Average: 10.00
-```
-
-### Calculator Error Handling
-
-#### Invalid Operation
-```bash
-php main.php calc --numbers=1,2,3 --operation=invalid
-```
-**Output:**
-```
-Error: The following argument(s) have invalid values: '--operation'
-Info: Allowed values for the argument '--operation':
-add
-subtract
-multiply
-divide
-average
-```
-
-#### Missing Required Arguments
-```bash
-php main.php calc --numbers=1,2,3
-```
-**Output:**
-```
-Error: The following required argument(s) are missing: '--operation'
-```
-
-#### Division by Zero
-```bash
-php main.php calc --numbers=10,0 --operation=divide
-```
-**Output:**
-```
-โ Calculation error: Division by zero is not allowed
-```
-
-## Profile Command Examples
-
-### Show Profile Help
-```bash
-php main.php help --command=profile
-```
-**Output:**
-```
- profile: Creates a user profile with validation and formatting
- Supported Arguments:
- --name: User full name (required)
- --email: User email address (required)
- --age: User age (13-120, required)
- --role:[Optional][Default = 'user'] User role in the system
- --department:[Optional][Default = 'General'] User department
- --active:[Optional] Mark user as active (flag)
- --skills:[Optional] Comma-separated list of skills
- --bio:[Optional] Short biography (max 200 characters)
-```
-
-### Basic Profile Creation
-```bash
-php main.php profile --name="Ahmed Hassan" --email=ahmed@example.com --age=28
-```
-**Output:**
-```
-๐ง Creating User Profile...
-
-โ User Profile Created Successfully!
-
-๐ค Name: Ahmed Hassan
-๐ง Email: ahmed@example.com
-๐ Age: 28
-๐ Role: user
-๐ข Department: General
-๐ด Status: inactive
-
-๐พ Saving profile to database...
-โ Profile saved successfully! User ID: 5404
-๐ Profile Summary:
- โข User ID: 5404
- โข Role: User
- โข Skills: 0
- โข Status: Inactive
-```
-
-### Full Profile with All Options
-```bash
-php main.php profile --name="Fatima Al-Zahra" --email=fatima@example.com --age=25 --role=admin --department=Engineering --active --skills="PHP,JavaScript,Python" --bio="Senior developer with 5 years experience"
-```
-**Output:**
-```
-๐ง Creating User Profile...
-
-โ User Profile Created Successfully!
-
-๐ค Name: Fatima Al-Zahra
-๐ง Email: fatima@example.com
-๐ Age: 25
-๐ Role: admin
-๐ข Department: Engineering
-๐ข Status: active
-๐ ๏ธ Skills: PHP, JavaScript, Python
-๐ Bio: Senior developer with 5 years experience
-
-๐พ Saving profile to database...
-โ Profile saved successfully! User ID: 2958
-๐ Profile Summary:
- โข User ID: 2958
- โข Role: Admin
- โข Skills: 3
- โข Status: Active
-```
-
-### Profile Validation Examples
-
-#### Invalid Email
-```bash
-php main.php profile --name="Mohammed Ali" --email=invalid-email --age=30
-```
-**Output:**
-```
-๐ง Creating User Profile...
-
-โ Invalid email format: invalid-email
-```
-
-#### Invalid Age Range
-```bash
-php main.php profile --name="Sara Ahmed" --email=sara@example.com --age=150
-```
-**Output:**
-```
-๐ง Creating User Profile...
-
-โ Age must be between 13 and 120, got: 150
-```
-
-#### Missing Required Arguments
-```bash
-php main.php profile --name="Omar Hassan"
-```
-**Output:**
-```
-Error: The following required argument(s) are missing: '--email', '--age'
-```
-
-## Key Learning Points
-
-1. **Required vs Optional Arguments**: Use `ArgumentOption::OPTIONAL => false` for required fields
-2. **Argument Validation**: Use `ArgumentOption::VALUES` array to restrict allowed values
-3. **Default Values**: Set defaults with `ArgumentOption::DEFAULT`
-4. **Boolean Flags**: Arguments without values act as boolean flags
-5. **Custom Validation**: Implement business logic validation in `exec()` method
-6. **Error Handling**: Return appropriate exit codes (0 = success, 1+ = error)
-7. **User Feedback**: Use `success()`, `error()`, `info()` for colored output
-8. **Complex Logic**: Commands can perform multiple operations and validations
-
-## Code Structure Examples
-
-### Calculator Command Structure
-```php
-class CalculatorCommand extends Command {
- public function __construct() {
- parent::__construct('calc', [
- '--operation' => [
- ArgumentOption::OPTIONAL => false,
- ArgumentOption::VALUES => ['add', 'subtract', 'multiply', 'divide', 'average'],
- ArgumentOption::DESCRIPTION => 'Mathematical operation to perform'
- ],
- '--numbers' => [
- ArgumentOption::OPTIONAL => false,
- ArgumentOption::DESCRIPTION => 'Comma-separated list of numbers'
- ],
- '--precision' => [
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DEFAULT => '2',
- ArgumentOption::DESCRIPTION => 'Number of decimal places'
- ],
- '--verbose' => [
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DESCRIPTION => 'Show detailed calculation steps'
- ]
- ], 'Performs mathematical calculations on a list of numbers');
- }
-}
-```
-
-### Profile Command Structure
-```php
-class UserProfileCommand extends Command {
- public function __construct() {
- parent::__construct('profile', [
- '--name' => [
- ArgumentOption::OPTIONAL => false,
- ArgumentOption::DESCRIPTION => 'User full name (required)'
- ],
- '--email' => [
- ArgumentOption::OPTIONAL => false,
- ArgumentOption::DESCRIPTION => 'User email address (required)'
- ],
- '--age' => [
- ArgumentOption::OPTIONAL => false,
- ArgumentOption::DESCRIPTION => 'User age (13-120, required)'
- ],
- '--active' => [
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DESCRIPTION => 'Mark user as active (flag)'
- ]
- ], 'Creates a user profile with validation and formatting');
- }
-}
-```
-
-This example demonstrates advanced CLI application development with proper validation, error handling, and user experience design.
-
-## Related Examples
-
-### Prerequisites
-- **[01-basic-hello-world](../01-basic-hello-world/)** - Start here for basic command concepts
-
-### Next Steps
-- **[03-user-input](../03-user-input/)** - Interactive input and validation
-- **[11-masked-input](../11-masked-input/)** - Secure input for sensitive data
-- **[04-output-formatting](../04-output-formatting/)** - Enhanced output styling
-
-### Advanced Applications
-- **[10-multi-command-app](../10-multi-command-app/)** - Complete CLI applications
-- **[09-database-ops](../09-database-ops/)** - Database operations with validation
-- **[12-command-scaffolding](../12-command-scaffolding/)** - Generate commands with arguments
-
-### Similar Concepts
-- **[05-interactive-commands](../05-interactive-commands/)** - Menu-driven interfaces
-- **[08-file-processing](../08-file-processing/)** - File operations with validation
+# Arguments and Options Example
+
+This example demonstrates advanced argument handling, validation, and complex command logic using WebFiori CLI library.
+
+## Features Demonstrated
+
+- Required and optional arguments
+- Argument validation with allowed values
+- Custom validation logic (email, age ranges)
+- Boolean flags
+- Default values
+- Precision control
+- Verbose output modes
+- Error handling and validation messages
+
+## Files
+
+- `main.php` - Application entry point and runner setup
+- `CalculatorCommand.php` - Mathematical calculator with multiple operations
+- `UserProfileCommand.php` - User profile creator with validation
+
+## Usage Examples
+
+### General Help
+```bash
+php main.php
+# or
+php main.php help
+```
+**Output:**
+```
+Usage:
+ command [arg1 arg2="val" arg3...]
+
+Global Arguments:
+ --ansi:[Optional] Force the use of ANSI output.
+Available Commands:
+ help: Display CLI Help. To display help for specific command, use the argument "--command" with this command.
+ calc: Performs mathematical calculations on a list of numbers
+ profile: Creates a user profile with validation and formatting
+```
+
+## Calculator Command Examples
+
+### Show Calculator Help
+```bash
+php main.php help --command=calc
+```
+**Output:**
+```
+ calc: Performs mathematical calculations on a list of numbers
+ Supported Arguments:
+ --operation: Mathematical operation to perform
+ --numbers: Comma-separated list of numbers (e.g., "1,2,3,4")
+ --precision:[Optional][Default = '2'] Number of decimal places for the result
+ --verbose:[Optional] Show detailed calculation steps
+```
+
+### Basic Operations
+
+#### Addition
+```bash
+php main.php calc --numbers=1,2,3,4,5 --operation=add
+```
+**Output:**
+```
+โ Performing add on: 1, 2, 3, 4, 5
+๐ Result: 15.00
+```
+
+#### Subtraction
+```bash
+php main.php calc --numbers=10,3,2 --operation=subtract
+```
+**Output:**
+```
+โ Performing subtract on: 10, 3, 2
+๐ Result: 5.00
+```
+
+#### Multiplication
+```bash
+php main.php calc --numbers=2,3,4 --operation=multiply
+```
+**Output:**
+```
+โ Performing multiply on: 2, 3, 4
+๐ Result: 24.00
+```
+
+#### Division
+```bash
+php main.php calc --numbers=100,5,2 --operation=divide
+```
+**Output:**
+```
+โ Performing divide on: 100, 5, 2
+๐ Result: 10.00
+```
+
+#### Average
+```bash
+php main.php calc --numbers=10,20,30,40,50 --operation=average
+```
+**Output:**
+```
+โ Performing average on: 10, 20, 30, 40, 50
+๐ Result: 30.00
+```
+
+### Advanced Calculator Features
+
+#### Custom Precision
+```bash
+php main.php calc --numbers=10,3 --operation=divide --precision=4
+```
+**Output:**
+```
+โ Performing divide on: 10, 3
+๐ Result: 3.3333
+```
+
+#### Verbose Mode
+```bash
+php main.php calc --numbers=5,10,15 --operation=add --verbose
+```
+**Output:**
+```
+๐ข Operation: Add
+๐ Numbers: 5, 10, 15
+๐ฏ Precision: 2 decimal places
+
+โ Performing add on: 5, 10, 15
+๐ Result: 30.00
+
+๐ Statistics:
+ โข Count: 3
+ โข Min: 5
+ โข Max: 15
+ โข Average: 10.00
+```
+
+### Calculator Error Handling
+
+#### Invalid Operation
+```bash
+php main.php calc --numbers=1,2,3 --operation=invalid
+```
+**Output:**
+```
+Error: The following argument(s) have invalid values: '--operation'
+Info: Allowed values for the argument '--operation':
+add
+subtract
+multiply
+divide
+average
+```
+
+#### Missing Required Arguments
+```bash
+php main.php calc --numbers=1,2,3
+```
+**Output:**
+```
+Error: The following required argument(s) are missing: '--operation'
+```
+
+#### Division by Zero
+```bash
+php main.php calc --numbers=10,0 --operation=divide
+```
+**Output:**
+```
+โ Calculation error: Division by zero is not allowed
+```
+
+## Profile Command Examples
+
+### Show Profile Help
+```bash
+php main.php help --command=profile
+```
+**Output:**
+```
+ profile: Creates a user profile with validation and formatting
+ Supported Arguments:
+ --name: User full name (required)
+ --email: User email address (required)
+ --age: User age (13-120, required)
+ --role:[Optional][Default = 'user'] User role in the system
+ --department:[Optional][Default = 'General'] User department
+ --active:[Optional] Mark user as active (flag)
+ --skills:[Optional] Comma-separated list of skills
+ --bio:[Optional] Short biography (max 200 characters)
+```
+
+### Basic Profile Creation
+```bash
+php main.php profile --name="Ahmed Hassan" --email=ahmed@example.com --age=28
+```
+**Output:**
+```
+๐ง Creating User Profile...
+
+โ User Profile Created Successfully!
+
+๐ค Name: Ahmed Hassan
+๐ง Email: ahmed@example.com
+๐ Age: 28
+๐ Role: user
+๐ข Department: General
+๐ด Status: inactive
+
+๐พ Saving profile to database...
+โ Profile saved successfully! User ID: 5404
+๐ Profile Summary:
+ โข User ID: 5404
+ โข Role: User
+ โข Skills: 0
+ โข Status: Inactive
+```
+
+### Full Profile with All Options
+```bash
+php main.php profile --name="Fatima Al-Zahra" --email=fatima@example.com --age=25 --role=admin --department=Engineering --active --skills="PHP,JavaScript,Python" --bio="Senior developer with 5 years experience"
+```
+**Output:**
+```
+๐ง Creating User Profile...
+
+โ User Profile Created Successfully!
+
+๐ค Name: Fatima Al-Zahra
+๐ง Email: fatima@example.com
+๐ Age: 25
+๐ Role: admin
+๐ข Department: Engineering
+๐ข Status: active
+๐ ๏ธ Skills: PHP, JavaScript, Python
+๐ Bio: Senior developer with 5 years experience
+
+๐พ Saving profile to database...
+โ Profile saved successfully! User ID: 2958
+๐ Profile Summary:
+ โข User ID: 2958
+ โข Role: Admin
+ โข Skills: 3
+ โข Status: Active
+```
+
+### Profile Validation Examples
+
+#### Invalid Email
+```bash
+php main.php profile --name="Mohammed Ali" --email=invalid-email --age=30
+```
+**Output:**
+```
+๐ง Creating User Profile...
+
+โ Invalid email format: invalid-email
+```
+
+#### Invalid Age Range
+```bash
+php main.php profile --name="Sara Ahmed" --email=sara@example.com --age=150
+```
+**Output:**
+```
+๐ง Creating User Profile...
+
+โ Age must be between 13 and 120, got: 150
+```
+
+#### Missing Required Arguments
+```bash
+php main.php profile --name="Omar Hassan"
+```
+**Output:**
+```
+Error: The following required argument(s) are missing: '--email', '--age'
+```
+
+## Key Learning Points
+
+1. **Required vs Optional Arguments**: Use `ArgumentOption::OPTIONAL => false` for required fields
+2. **Argument Validation**: Use `ArgumentOption::VALUES` array to restrict allowed values
+3. **Default Values**: Set defaults with `ArgumentOption::DEFAULT`
+4. **Boolean Flags**: Arguments without values act as boolean flags
+5. **Custom Validation**: Implement business logic validation in `exec()` method
+6. **Error Handling**: Return appropriate exit codes (0 = success, 1+ = error)
+7. **User Feedback**: Use `success()`, `error()`, `info()` for colored output
+8. **Complex Logic**: Commands can perform multiple operations and validations
+
+## Code Structure Examples
+
+### Calculator Command Structure
+```php
+class CalculatorCommand extends Command {
+ public function __construct() {
+ parent::__construct('calc', [
+ '--operation' => [
+ ArgumentOption::OPTIONAL => false,
+ ArgumentOption::VALUES => ['add', 'subtract', 'multiply', 'divide', 'average'],
+ ArgumentOption::DESCRIPTION => 'Mathematical operation to perform'
+ ],
+ '--numbers' => [
+ ArgumentOption::OPTIONAL => false,
+ ArgumentOption::DESCRIPTION => 'Comma-separated list of numbers'
+ ],
+ '--precision' => [
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DEFAULT => '2',
+ ArgumentOption::DESCRIPTION => 'Number of decimal places'
+ ],
+ '--verbose' => [
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DESCRIPTION => 'Show detailed calculation steps'
+ ]
+ ], 'Performs mathematical calculations on a list of numbers');
+ }
+}
+```
+
+### Profile Command Structure
+```php
+class UserProfileCommand extends Command {
+ public function __construct() {
+ parent::__construct('profile', [
+ '--name' => [
+ ArgumentOption::OPTIONAL => false,
+ ArgumentOption::DESCRIPTION => 'User full name (required)'
+ ],
+ '--email' => [
+ ArgumentOption::OPTIONAL => false,
+ ArgumentOption::DESCRIPTION => 'User email address (required)'
+ ],
+ '--age' => [
+ ArgumentOption::OPTIONAL => false,
+ ArgumentOption::DESCRIPTION => 'User age (13-120, required)'
+ ],
+ '--active' => [
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DESCRIPTION => 'Mark user as active (flag)'
+ ]
+ ], 'Creates a user profile with validation and formatting');
+ }
+}
+```
+
+This example demonstrates advanced CLI application development with proper validation, error handling, and user experience design.
+
+## Related Examples
+
+### Prerequisites
+- **[01-basic-hello-world](../01-basic-hello-world/)** - Start here for basic command concepts
+
+### Next Steps
+- **[03-user-input](../03-user-input/)** - Interactive input and validation
+- **[11-masked-input](../11-masked-input/)** - Secure input for sensitive data
+- **[04-output-formatting](../04-output-formatting/)** - Enhanced output styling
+
+### Advanced Applications
+- **[10-multi-command-app](../10-multi-command-app/)** - Complete CLI applications
+- **[09-database-ops](../09-database-ops/)** - Database operations with validation
+- **[12-command-scaffolding](../12-command-scaffolding/)** - Generate commands with arguments
+
+### Similar Concepts
+- **[05-interactive-commands](../05-interactive-commands/)** - Menu-driven interfaces
+- **[08-file-processing](../08-file-processing/)** - File operations with validation
diff --git a/examples/02-arguments-and-options/UserProfileCommand.php b/examples/02-arguments-and-options/UserProfileCommand.php
index 6caa8dd..95f5d5c 100644
--- a/examples/02-arguments-and-options/UserProfileCommand.php
+++ b/examples/02-arguments-and-options/UserProfileCommand.php
@@ -1,243 +1,243 @@
- [
- ArgumentOption::DESCRIPTION => 'User full name (required)',
- ArgumentOption::OPTIONAL => false
- ],
- '--email' => [
- ArgumentOption::DESCRIPTION => 'User email address (required)',
- ArgumentOption::OPTIONAL => false
- ],
- '--age' => [
- ArgumentOption::DESCRIPTION => 'User age (13-120, required)',
- ArgumentOption::OPTIONAL => false
- ],
- '--role' => [
- ArgumentOption::DESCRIPTION => 'User role in the system',
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DEFAULT => 'user',
- ArgumentOption::VALUES => ['user', 'admin', 'moderator', 'guest']
- ],
- '--department' => [
- ArgumentOption::DESCRIPTION => 'User department',
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DEFAULT => 'General'
- ],
- '--active' => [
- ArgumentOption::DESCRIPTION => 'Mark user as active (flag)',
- ArgumentOption::OPTIONAL => true
- ],
- '--skills' => [
- ArgumentOption::DESCRIPTION => 'Comma-separated list of skills',
- ArgumentOption::OPTIONAL => true
- ],
- '--bio' => [
- ArgumentOption::DESCRIPTION => 'Short biography (max 200 characters)',
- ArgumentOption::OPTIONAL => true
- ]
- ], 'Creates a user profile with validation and formatting');
- }
-
- public function exec(): int {
- $this->info("๐ง Creating User Profile...");
- $this->println();
-
- // Collect and validate all arguments
- $profile = $this->collectProfileData();
-
- if ($profile === null) {
- return 1; // Validation failed
- }
-
- // Display the created profile
- $this->displayProfile($profile);
-
- // Save profile (simulated)
- $this->simulateSave($profile);
-
- return 0;
- }
-
- /**
- * Collect and validate all profile data.
- */
- private function collectProfileData(): ?array {
- $profile = [];
-
- // Validate name
- $name = trim($this->getArgValue('--name') ?? '');
-
- if (empty($name)) {
- $this->error('โ Name is required and cannot be empty');
-
- return null;
- }
-
- if (strlen($name) < 2) {
- $this->error('โ Name must be at least 2 characters long');
-
- return null;
- }
-
- if (strlen($name) > 50) {
- $this->error('โ Name cannot exceed 50 characters');
-
- return null;
- }
- $profile['name'] = $name;
-
- // Validate email
- $email = trim($this->getArgValue('--email') ?? '');
-
- if (empty($email)) {
- $this->error('โ Email is required');
-
- return null;
- }
-
- if (!$this->validateEmail($email)) {
- $this->error("โ Invalid email format: $email");
-
- return null;
- }
- $profile['email'] = $email;
-
- // Validate age
- $ageStr = $this->getArgValue('--age');
-
- if (!is_numeric($ageStr)) {
- $this->error('โ Age must be a number');
-
- return null;
- }
- $age = (int)$ageStr;
-
- if (!$this->validateAge($age)) {
- $this->error("โ Age must be between 13 and 120, got: $age");
-
- return null;
- }
- $profile['age'] = $age;
-
- // Get role (already validated by ArgumentOption::VALUES)
- $profile['role'] = $this->getArgValue('--role') ?? 'user';
-
- // Get department
- $profile['department'] = $this->getArgValue('--department') ?? 'General';
-
- // Get active status (boolean flag)
- $profile['active'] = $this->isArgProvided('--active');
-
- // Parse skills
- $skillsStr = $this->getArgValue('--skills');
- $profile['skills'] = $skillsStr ? $this->parseSkills($skillsStr) : [];
-
- // Validate bio
- $bio = $this->getArgValue('--bio');
-
- if ($bio !== null) {
- if (strlen($bio) > 200) {
- $this->error('โ Bio cannot exceed 200 characters');
-
- return null;
- }
- $profile['bio'] = $bio;
- }
-
- return $profile;
- }
-
- /**
- * Display the created profile in a formatted way.
- */
- private function displayProfile(array $profile): void {
- $this->success("โ User Profile Created Successfully!");
- $this->println();
-
- // Basic info
- $this->println("๐ค Name: ".$profile['name']);
- $this->println("๐ง Email: ".$profile['email']);
- $this->println("๐ Age: ".$profile['age']);
- $this->println("๐ Role: ".$profile['role']);
- $this->println("๐ข Department: ".$profile['department']);
-
- // Status with color coding
- $status = $profile['active'] ? 'active' : 'inactive';
- $statusIcon = $profile['active'] ? '๐ข' : '๐ด';
- $this->println("$statusIcon Status: $status");
-
- // Skills if provided
- if (!empty($profile['skills'])) {
- $this->println("๐ ๏ธ Skills: ".implode(', ', $profile['skills']));
- }
-
- // Bio if provided
- if (isset($profile['bio'])) {
- $this->println("๐ Bio: ".$profile['bio']);
- }
-
- $this->println();
- }
-
- /**
- * Parse comma-separated skills.
- */
- private function parseSkills(string $skillsStr): array {
- $skills = array_map('trim', explode(',', $skillsStr));
-
- return array_filter($skills, function ($skill) {
- return !empty($skill) && strlen($skill) <= 30;
- });
- }
-
- /**
- * Simulate saving the profile.
- */
- private function simulateSave(array $profile): void {
- $this->info("๐พ Saving profile to database...");
-
- // Simulate processing time
- usleep(500000); // 0.5 seconds
-
- $userId = rand(1000, 9999);
- $this->success("โ Profile saved successfully! User ID: $userId");
-
- // Show summary
- $skillCount = count($profile['skills']);
- $this->info("๐ Profile Summary:");
- $this->println(" โข User ID: $userId");
- $this->println(" โข Role: ".ucfirst($profile['role']));
- $this->println(" โข Skills: $skillCount");
- $this->println(" โข Status: ".($profile['active'] ? 'Active' : 'Inactive'));
- }
-
- /**
- * Validate age range.
- */
- private function validateAge(int $age): bool {
- return $age >= 13 && $age <= 120;
- }
-
- /**
- * Validate email format.
- */
- private function validateEmail(string $email): bool {
- return filter_var($email, FILTER_VALIDATE_EMAIL) !== false;
- }
-}
+ [
+ ArgumentOption::DESCRIPTION => 'User full name (required)',
+ ArgumentOption::OPTIONAL => false
+ ],
+ '--email' => [
+ ArgumentOption::DESCRIPTION => 'User email address (required)',
+ ArgumentOption::OPTIONAL => false
+ ],
+ '--age' => [
+ ArgumentOption::DESCRIPTION => 'User age (13-120, required)',
+ ArgumentOption::OPTIONAL => false
+ ],
+ '--role' => [
+ ArgumentOption::DESCRIPTION => 'User role in the system',
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DEFAULT => 'user',
+ ArgumentOption::VALUES => ['user', 'admin', 'moderator', 'guest']
+ ],
+ '--department' => [
+ ArgumentOption::DESCRIPTION => 'User department',
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DEFAULT => 'General'
+ ],
+ '--active' => [
+ ArgumentOption::DESCRIPTION => 'Mark user as active (flag)',
+ ArgumentOption::OPTIONAL => true
+ ],
+ '--skills' => [
+ ArgumentOption::DESCRIPTION => 'Comma-separated list of skills',
+ ArgumentOption::OPTIONAL => true
+ ],
+ '--bio' => [
+ ArgumentOption::DESCRIPTION => 'Short biography (max 200 characters)',
+ ArgumentOption::OPTIONAL => true
+ ]
+ ], 'Creates a user profile with validation and formatting');
+ }
+
+ public function exec(): int {
+ $this->info("๐ง Creating User Profile...");
+ $this->println();
+
+ // Collect and validate all arguments
+ $profile = $this->collectProfileData();
+
+ if ($profile === null) {
+ return 1; // Validation failed
+ }
+
+ // Display the created profile
+ $this->displayProfile($profile);
+
+ // Save profile (simulated)
+ $this->simulateSave($profile);
+
+ return 0;
+ }
+
+ /**
+ * Collect and validate all profile data.
+ */
+ private function collectProfileData(): ?array {
+ $profile = [];
+
+ // Validate name
+ $name = trim($this->getArgValue('--name') ?? '');
+
+ if (empty($name)) {
+ $this->error('โ Name is required and cannot be empty');
+
+ return null;
+ }
+
+ if (strlen($name) < 2) {
+ $this->error('โ Name must be at least 2 characters long');
+
+ return null;
+ }
+
+ if (strlen($name) > 50) {
+ $this->error('โ Name cannot exceed 50 characters');
+
+ return null;
+ }
+ $profile['name'] = $name;
+
+ // Validate email
+ $email = trim($this->getArgValue('--email') ?? '');
+
+ if (empty($email)) {
+ $this->error('โ Email is required');
+
+ return null;
+ }
+
+ if (!$this->validateEmail($email)) {
+ $this->error("โ Invalid email format: $email");
+
+ return null;
+ }
+ $profile['email'] = $email;
+
+ // Validate age
+ $ageStr = $this->getArgValue('--age');
+
+ if (!is_numeric($ageStr)) {
+ $this->error('โ Age must be a number');
+
+ return null;
+ }
+ $age = (int)$ageStr;
+
+ if (!$this->validateAge($age)) {
+ $this->error("โ Age must be between 13 and 120, got: $age");
+
+ return null;
+ }
+ $profile['age'] = $age;
+
+ // Get role (already validated by ArgumentOption::VALUES)
+ $profile['role'] = $this->getArgValue('--role') ?? 'user';
+
+ // Get department
+ $profile['department'] = $this->getArgValue('--department') ?? 'General';
+
+ // Get active status (boolean flag)
+ $profile['active'] = $this->isArgProvided('--active');
+
+ // Parse skills
+ $skillsStr = $this->getArgValue('--skills');
+ $profile['skills'] = $skillsStr ? $this->parseSkills($skillsStr) : [];
+
+ // Validate bio
+ $bio = $this->getArgValue('--bio');
+
+ if ($bio !== null) {
+ if (strlen($bio) > 200) {
+ $this->error('โ Bio cannot exceed 200 characters');
+
+ return null;
+ }
+ $profile['bio'] = $bio;
+ }
+
+ return $profile;
+ }
+
+ /**
+ * Display the created profile in a formatted way.
+ */
+ private function displayProfile(array $profile): void {
+ $this->success("โ User Profile Created Successfully!");
+ $this->println();
+
+ // Basic info
+ $this->println("๐ค Name: ".$profile['name']);
+ $this->println("๐ง Email: ".$profile['email']);
+ $this->println("๐ Age: ".$profile['age']);
+ $this->println("๐ Role: ".$profile['role']);
+ $this->println("๐ข Department: ".$profile['department']);
+
+ // Status with color coding
+ $status = $profile['active'] ? 'active' : 'inactive';
+ $statusIcon = $profile['active'] ? '๐ข' : '๐ด';
+ $this->println("$statusIcon Status: $status");
+
+ // Skills if provided
+ if (!empty($profile['skills'])) {
+ $this->println("๐ ๏ธ Skills: ".implode(', ', $profile['skills']));
+ }
+
+ // Bio if provided
+ if (isset($profile['bio'])) {
+ $this->println("๐ Bio: ".$profile['bio']);
+ }
+
+ $this->println();
+ }
+
+ /**
+ * Parse comma-separated skills.
+ */
+ private function parseSkills(string $skillsStr): array {
+ $skills = array_map('trim', explode(',', $skillsStr));
+
+ return array_filter($skills, function ($skill) {
+ return !empty($skill) && strlen($skill) <= 30;
+ });
+ }
+
+ /**
+ * Simulate saving the profile.
+ */
+ private function simulateSave(array $profile): void {
+ $this->info("๐พ Saving profile to database...");
+
+ // Simulate processing time
+ usleep(500000); // 0.5 seconds
+
+ $userId = rand(1000, 9999);
+ $this->success("โ Profile saved successfully! User ID: $userId");
+
+ // Show summary
+ $skillCount = count($profile['skills']);
+ $this->info("๐ Profile Summary:");
+ $this->println(" โข User ID: $userId");
+ $this->println(" โข Role: ".ucfirst($profile['role']));
+ $this->println(" โข Skills: $skillCount");
+ $this->println(" โข Status: ".($profile['active'] ? 'Active' : 'Inactive'));
+ }
+
+ /**
+ * Validate age range.
+ */
+ private function validateAge(int $age): bool {
+ return $age >= 13 && $age <= 120;
+ }
+
+ /**
+ * Validate email format.
+ */
+ private function validateEmail(string $email): bool {
+ return filter_var($email, FILTER_VALIDATE_EMAIL) !== false;
+ }
+}
diff --git a/examples/02-arguments-and-options/main.php b/examples/02-arguments-and-options/main.php
index 7d3857f..05be90e 100644
--- a/examples/02-arguments-and-options/main.php
+++ b/examples/02-arguments-and-options/main.php
@@ -1,31 +1,31 @@
-register(new CalculatorCommand());
-$runner->register(new UserProfileCommand());
-
-// Set default command
-
-// Start the application
-exit($runner->start());
+register(new CalculatorCommand());
+$runner->register(new UserProfileCommand());
+
+// Set default command
+
+// Start the application
+exit($runner->start());
diff --git a/examples/03-user-input/QuizCommand.php b/examples/03-user-input/QuizCommand.php
index 531dffe..4dec59a 100644
--- a/examples/03-user-input/QuizCommand.php
+++ b/examples/03-user-input/QuizCommand.php
@@ -1,380 +1,380 @@
- [
- ArgumentOption::DESCRIPTION => 'Quiz difficulty level',
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DEFAULT => 'medium',
- ArgumentOption::VALUES => ['easy', 'medium', 'hard']
- ],
- '--questions' => [
- ArgumentOption::DESCRIPTION => 'Number of questions (5-20)',
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DEFAULT => '10'
- ]
- ], 'Interactive knowledge quiz with scoring and feedback');
- }
-
- public function exec(): int {
- $this->difficulty = $this->getArgValue('--difficulty') ?? 'medium';
- $questionCount = (int)($this->getArgValue('--questions') ?? 10);
-
- // Validate question count
- if ($questionCount < 5 || $questionCount > 20) {
- $this->error('Number of questions must be between 5 and 20');
-
- return 1;
- }
-
- $this->println("๐ง Welcome to the Knowledge Quiz!");
- $this->println("=================================");
- $this->println();
-
- $this->info("๐ Quiz Settings:");
- $this->println(" โข Difficulty: ".ucfirst($this->difficulty));
- $this->println(" โข Questions: $questionCount");
- $this->println();
-
- if (!$this->confirm('Ready to start?', true)) {
- $this->info('Maybe next time! ๐');
-
- return 0;
- }
-
- // Initialize questions
- $this->initializeQuestions();
-
- // Select random questions based on difficulty
- $selectedQuestions = $this->selectQuestions($questionCount);
-
- // Run the quiz
- $this->runQuiz($selectedQuestions);
-
- // Show results
- $this->showResults($questionCount);
-
- return 0;
- }
-
- /**
- * Ask a question and get user input.
- */
- private function askQuestion(array $question): string {
- if ($question['type'] === 'multiple') {
- $choice = $this->select('Your answer:', $question['options']);
-
- return (string)$choice;
- } else {
- return $this->getInput(
- 'Your answer:',
- null,
- new InputValidator(function ($input) {
- return !empty(trim($input));
- }, 'Please provide an answer')
- );
- }
- }
-
- /**
- * Check if the answer is correct.
- */
- private function checkAnswer(array $question, string $userAnswer): bool {
- if ($question['type'] === 'multiple') {
- return (int)$userAnswer === $question['correct'];
- } else {
- $correctAnswer = strtolower(trim($question['correct']));
- $userAnswerNormalized = strtolower(trim($userAnswer));
-
- return $correctAnswer === $userAnswerNormalized;
- }
- }
-
- /**
- * Initialize the question bank.
- */
- private function initializeQuestions(): void {
- $this->questions = [
- 'easy' => [
- [
- 'type' => 'multiple',
- 'question' => 'What does PHP stand for?',
- 'options' => ['Personal Home Page', 'PHP: Hypertext Preprocessor', 'Private Home Page', 'Public Hypertext Processor'],
- 'correct' => 1
- ],
- [
- 'type' => 'input',
- 'question' => 'What is 5 + 7?',
- 'correct' => '12'
- ],
- [
- 'type' => 'multiple',
- 'question' => 'Which of these is a programming language?',
- 'options' => ['HTML', 'CSS', 'JavaScript', 'XML'],
- 'correct' => 2
- ],
- [
- 'type' => 'input',
- 'question' => 'What is the capital of France?',
- 'correct' => 'Paris'
- ],
- [
- 'type' => 'multiple',
- 'question' => 'What does CLI stand for?',
- 'options' => ['Command Line Interface', 'Computer Language Interface', 'Code Line Interface', 'Common Language Interface'],
- 'correct' => 0
- ]
- ],
- 'medium' => [
- [
- 'type' => 'multiple',
- 'question' => 'Which HTTP status code indicates "Not Found"?',
- 'options' => ['200', '404', '500', '301'],
- 'correct' => 1
- ],
- [
- 'type' => 'input',
- 'question' => 'What is 15 ร 8?',
- 'correct' => '120'
- ],
- [
- 'type' => 'multiple',
- 'question' => 'Which design pattern ensures a class has only one instance?',
- 'options' => ['Factory', 'Observer', 'Singleton', 'Strategy'],
- 'correct' => 2
- ],
- [
- 'type' => 'input',
- 'question' => 'In which year was PHP first released? (4 digits)',
- 'correct' => '1995'
- ],
- [
- 'type' => 'multiple',
- 'question' => 'What does REST stand for in web APIs?',
- 'options' => ['Representational State Transfer', 'Remote State Transfer', 'Relational State Transfer', 'Responsive State Transfer'],
- 'correct' => 0
- ]
- ],
- 'hard' => [
- [
- 'type' => 'multiple',
- 'question' => 'What is the time complexity of quicksort in the average case?',
- 'options' => ['O(n)', 'O(n log n)', 'O(nยฒ)', 'O(log n)'],
- 'correct' => 1
- ],
- [
- 'type' => 'input',
- 'question' => 'What is the result of 2^10? (numbers only)',
- 'correct' => '1024'
- ],
- [
- 'type' => 'multiple',
- 'question' => 'Which algorithm is used for finding the shortest path in a weighted graph?',
- 'options' => ['BFS', 'DFS', 'Dijkstra', 'Kruskal'],
- 'correct' => 2
- ],
- [
- 'type' => 'input',
- 'question' => 'What does SOLID stand for in programming principles? (first letter of each principle)',
- 'correct' => 'SOLID'
- ],
- [
- 'type' => 'multiple',
- 'question' => 'In database normalization, what does 3NF stand for?',
- 'options' => ['Third Normal Form', 'Triple Normal Form', 'Tertiary Normal Form', 'Three-way Normal Form'],
- 'correct' => 0
- ]
- ]
- ];
- }
-
- /**
- * Run the quiz with selected questions.
- */
- private function runQuiz(array $questions): void {
- $this->println();
- $this->success("๐ฏ Starting Quiz!");
- $this->println();
-
- foreach ($questions as $index => $question) {
- $questionNumber = $index + 1;
- $totalQuestions = count($questions);
-
- $this->info("Question $questionNumber/$totalQuestions:");
- $this->println($question['question']);
- $this->println();
-
- $userAnswer = $this->askQuestion($question);
- $isCorrect = $this->checkAnswer($question, $userAnswer);
-
- if ($isCorrect) {
- $this->success("โ Correct!");
- $this->score++;
- } else {
- $this->error("โ Incorrect!");
- $this->showCorrectAnswer($question);
- }
-
- $this->answers[] = [
- 'question' => $question['question'],
- 'user_answer' => $userAnswer,
- 'correct' => $isCorrect
- ];
-
- $this->println();
-
- // Show progress
- if ($questionNumber < $totalQuestions) {
- $this->info("Score so far: $this->score/$questionNumber");
- $this->println();
- }
- }
- }
-
- /**
- * Select questions based on difficulty and count.
- */
- private function selectQuestions(int $count): array {
- $availableQuestions = $this->questions[$this->difficulty];
-
- // Add some questions from easier levels if needed
- if (count($availableQuestions) < $count) {
- if ($this->difficulty === 'hard') {
- $availableQuestions = array_merge($availableQuestions, $this->questions['medium']);
- }
-
- if ($this->difficulty !== 'easy') {
- $availableQuestions = array_merge($availableQuestions, $this->questions['easy']);
- }
- }
-
- // Shuffle and select
- shuffle($availableQuestions);
-
- return array_slice($availableQuestions, 0, $count);
- }
-
- /**
- * Show the correct answer.
- */
- private function showCorrectAnswer(array $question): void {
- if ($question['type'] === 'multiple') {
- $correctOption = $question['options'][$question['correct']];
- $this->info("Correct answer: $correctOption");
- } else {
- $this->info("Correct answer: ".$question['correct']);
- }
- }
-
- /**
- * Show detailed question-by-question results.
- */
- private function showDetailedResults(): void {
- $this->println();
- $this->info("๐ Detailed Results:");
- $this->println(str_repeat('-', 40));
-
- foreach ($this->answers as $index => $answer) {
- $questionNumber = $index + 1;
- $status = $answer['correct'] ? 'โ ' : 'โ';
-
- $this->println("$questionNumber. $status ".substr($answer['question'], 0, 50).
- (strlen($answer['question']) > 50 ? '...' : ''));
- }
-
- $this->println();
- }
-
- /**
- * Show quiz results and analysis.
- */
- private function showResults(int $totalQuestions): void {
- $this->println();
- $this->success("๐ Quiz Completed!");
- $this->println("==================");
-
- $percentage = round(($this->score / $totalQuestions) * 100, 1);
-
- $this->println("๐ Final Score: $this->score/$totalQuestions ($percentage%)");
-
- // Performance feedback
- $this->println();
- $this->info("๐ Performance Analysis:");
-
- if ($percentage >= 90) {
- $this->success("๐ Excellent! You're a quiz master!");
- $grade = 'A+';
- } elseif ($percentage >= 80) {
- $this->success("๐ฏ Great job! Very impressive!");
- $grade = 'A';
- } elseif ($percentage >= 70) {
- $this->info("๐ Good work! Keep it up!");
- $grade = 'B';
- } elseif ($percentage >= 60) {
- $this->warning("๐ Not bad, but there's room for improvement!");
- $grade = 'C';
- } else {
- $this->warning("๐ Keep studying and try again!");
- $grade = 'D';
- }
-
- $this->println("๐ Grade: $grade");
-
- // Show difficulty-specific feedback
- $this->println();
- $this->info("๐ก Difficulty: ".ucfirst($this->difficulty));
-
- switch ($this->difficulty) {
- case 'easy':
- if ($percentage >= 80) {
- $this->info("Ready to try medium difficulty!");
- }
- break;
- case 'medium':
- if ($percentage >= 85) {
- $this->info("You might enjoy the hard difficulty!");
- } elseif ($percentage < 60) {
- $this->info("Consider trying easy difficulty first.");
- }
- break;
- case 'hard':
- if ($percentage >= 70) {
- $this->success("Impressive performance on hard questions!");
- } else {
- $this->info("Hard questions are challenging - keep learning!");
- }
- break;
- }
-
- // Offer to show detailed results
- if ($this->confirm('Show detailed results?', false)) {
- $this->showDetailedResults();
- }
-
- // Ask about retaking
- if ($this->confirm('Take the quiz again?', false)) {
- $this->info('Run the command again to start a new quiz!');
- }
- }
-}
+ [
+ ArgumentOption::DESCRIPTION => 'Quiz difficulty level',
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DEFAULT => 'medium',
+ ArgumentOption::VALUES => ['easy', 'medium', 'hard']
+ ],
+ '--questions' => [
+ ArgumentOption::DESCRIPTION => 'Number of questions (5-20)',
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DEFAULT => '10'
+ ]
+ ], 'Interactive knowledge quiz with scoring and feedback');
+ }
+
+ public function exec(): int {
+ $this->difficulty = $this->getArgValue('--difficulty') ?? 'medium';
+ $questionCount = (int)($this->getArgValue('--questions') ?? 10);
+
+ // Validate question count
+ if ($questionCount < 5 || $questionCount > 20) {
+ $this->error('Number of questions must be between 5 and 20');
+
+ return 1;
+ }
+
+ $this->println("๐ง Welcome to the Knowledge Quiz!");
+ $this->println("=================================");
+ $this->println();
+
+ $this->info("๐ Quiz Settings:");
+ $this->println(" โข Difficulty: ".ucfirst($this->difficulty));
+ $this->println(" โข Questions: $questionCount");
+ $this->println();
+
+ if (!$this->confirm('Ready to start?', true)) {
+ $this->info('Maybe next time! ๐');
+
+ return 0;
+ }
+
+ // Initialize questions
+ $this->initializeQuestions();
+
+ // Select random questions based on difficulty
+ $selectedQuestions = $this->selectQuestions($questionCount);
+
+ // Run the quiz
+ $this->runQuiz($selectedQuestions);
+
+ // Show results
+ $this->showResults($questionCount);
+
+ return 0;
+ }
+
+ /**
+ * Ask a question and get user input.
+ */
+ private function askQuestion(array $question): string {
+ if ($question['type'] === 'multiple') {
+ $choice = $this->select('Your answer:', $question['options']);
+
+ return (string)$choice;
+ } else {
+ return $this->getInput(
+ 'Your answer:',
+ null,
+ new InputValidator(function ($input) {
+ return !empty(trim($input));
+ }, 'Please provide an answer')
+ );
+ }
+ }
+
+ /**
+ * Check if the answer is correct.
+ */
+ private function checkAnswer(array $question, string $userAnswer): bool {
+ if ($question['type'] === 'multiple') {
+ return (int)$userAnswer === $question['correct'];
+ } else {
+ $correctAnswer = strtolower(trim($question['correct']));
+ $userAnswerNormalized = strtolower(trim($userAnswer));
+
+ return $correctAnswer === $userAnswerNormalized;
+ }
+ }
+
+ /**
+ * Initialize the question bank.
+ */
+ private function initializeQuestions(): void {
+ $this->questions = [
+ 'easy' => [
+ [
+ 'type' => 'multiple',
+ 'question' => 'What does PHP stand for?',
+ 'options' => ['Personal Home Page', 'PHP: Hypertext Preprocessor', 'Private Home Page', 'Public Hypertext Processor'],
+ 'correct' => 1
+ ],
+ [
+ 'type' => 'input',
+ 'question' => 'What is 5 + 7?',
+ 'correct' => '12'
+ ],
+ [
+ 'type' => 'multiple',
+ 'question' => 'Which of these is a programming language?',
+ 'options' => ['HTML', 'CSS', 'JavaScript', 'XML'],
+ 'correct' => 2
+ ],
+ [
+ 'type' => 'input',
+ 'question' => 'What is the capital of France?',
+ 'correct' => 'Paris'
+ ],
+ [
+ 'type' => 'multiple',
+ 'question' => 'What does CLI stand for?',
+ 'options' => ['Command Line Interface', 'Computer Language Interface', 'Code Line Interface', 'Common Language Interface'],
+ 'correct' => 0
+ ]
+ ],
+ 'medium' => [
+ [
+ 'type' => 'multiple',
+ 'question' => 'Which HTTP status code indicates "Not Found"?',
+ 'options' => ['200', '404', '500', '301'],
+ 'correct' => 1
+ ],
+ [
+ 'type' => 'input',
+ 'question' => 'What is 15 ร 8?',
+ 'correct' => '120'
+ ],
+ [
+ 'type' => 'multiple',
+ 'question' => 'Which design pattern ensures a class has only one instance?',
+ 'options' => ['Factory', 'Observer', 'Singleton', 'Strategy'],
+ 'correct' => 2
+ ],
+ [
+ 'type' => 'input',
+ 'question' => 'In which year was PHP first released? (4 digits)',
+ 'correct' => '1995'
+ ],
+ [
+ 'type' => 'multiple',
+ 'question' => 'What does REST stand for in web APIs?',
+ 'options' => ['Representational State Transfer', 'Remote State Transfer', 'Relational State Transfer', 'Responsive State Transfer'],
+ 'correct' => 0
+ ]
+ ],
+ 'hard' => [
+ [
+ 'type' => 'multiple',
+ 'question' => 'What is the time complexity of quicksort in the average case?',
+ 'options' => ['O(n)', 'O(n log n)', 'O(nยฒ)', 'O(log n)'],
+ 'correct' => 1
+ ],
+ [
+ 'type' => 'input',
+ 'question' => 'What is the result of 2^10? (numbers only)',
+ 'correct' => '1024'
+ ],
+ [
+ 'type' => 'multiple',
+ 'question' => 'Which algorithm is used for finding the shortest path in a weighted graph?',
+ 'options' => ['BFS', 'DFS', 'Dijkstra', 'Kruskal'],
+ 'correct' => 2
+ ],
+ [
+ 'type' => 'input',
+ 'question' => 'What does SOLID stand for in programming principles? (first letter of each principle)',
+ 'correct' => 'SOLID'
+ ],
+ [
+ 'type' => 'multiple',
+ 'question' => 'In database normalization, what does 3NF stand for?',
+ 'options' => ['Third Normal Form', 'Triple Normal Form', 'Tertiary Normal Form', 'Three-way Normal Form'],
+ 'correct' => 0
+ ]
+ ]
+ ];
+ }
+
+ /**
+ * Run the quiz with selected questions.
+ */
+ private function runQuiz(array $questions): void {
+ $this->println();
+ $this->success("๐ฏ Starting Quiz!");
+ $this->println();
+
+ foreach ($questions as $index => $question) {
+ $questionNumber = $index + 1;
+ $totalQuestions = count($questions);
+
+ $this->info("Question $questionNumber/$totalQuestions:");
+ $this->println($question['question']);
+ $this->println();
+
+ $userAnswer = $this->askQuestion($question);
+ $isCorrect = $this->checkAnswer($question, $userAnswer);
+
+ if ($isCorrect) {
+ $this->success("โ Correct!");
+ $this->score++;
+ } else {
+ $this->error("โ Incorrect!");
+ $this->showCorrectAnswer($question);
+ }
+
+ $this->answers[] = [
+ 'question' => $question['question'],
+ 'user_answer' => $userAnswer,
+ 'correct' => $isCorrect
+ ];
+
+ $this->println();
+
+ // Show progress
+ if ($questionNumber < $totalQuestions) {
+ $this->info("Score so far: $this->score/$questionNumber");
+ $this->println();
+ }
+ }
+ }
+
+ /**
+ * Select questions based on difficulty and count.
+ */
+ private function selectQuestions(int $count): array {
+ $availableQuestions = $this->questions[$this->difficulty];
+
+ // Add some questions from easier levels if needed
+ if (count($availableQuestions) < $count) {
+ if ($this->difficulty === 'hard') {
+ $availableQuestions = array_merge($availableQuestions, $this->questions['medium']);
+ }
+
+ if ($this->difficulty !== 'easy') {
+ $availableQuestions = array_merge($availableQuestions, $this->questions['easy']);
+ }
+ }
+
+ // Shuffle and select
+ shuffle($availableQuestions);
+
+ return array_slice($availableQuestions, 0, $count);
+ }
+
+ /**
+ * Show the correct answer.
+ */
+ private function showCorrectAnswer(array $question): void {
+ if ($question['type'] === 'multiple') {
+ $correctOption = $question['options'][$question['correct']];
+ $this->info("Correct answer: $correctOption");
+ } else {
+ $this->info("Correct answer: ".$question['correct']);
+ }
+ }
+
+ /**
+ * Show detailed question-by-question results.
+ */
+ private function showDetailedResults(): void {
+ $this->println();
+ $this->info("๐ Detailed Results:");
+ $this->println(str_repeat('-', 40));
+
+ foreach ($this->answers as $index => $answer) {
+ $questionNumber = $index + 1;
+ $status = $answer['correct'] ? 'โ ' : 'โ';
+
+ $this->println("$questionNumber. $status ".substr($answer['question'], 0, 50).
+ (strlen($answer['question']) > 50 ? '...' : ''));
+ }
+
+ $this->println();
+ }
+
+ /**
+ * Show quiz results and analysis.
+ */
+ private function showResults(int $totalQuestions): void {
+ $this->println();
+ $this->success("๐ Quiz Completed!");
+ $this->println("==================");
+
+ $percentage = round(($this->score / $totalQuestions) * 100, 1);
+
+ $this->println("๐ Final Score: $this->score/$totalQuestions ($percentage%)");
+
+ // Performance feedback
+ $this->println();
+ $this->info("๐ Performance Analysis:");
+
+ if ($percentage >= 90) {
+ $this->success("๐ Excellent! You're a quiz master!");
+ $grade = 'A+';
+ } elseif ($percentage >= 80) {
+ $this->success("๐ฏ Great job! Very impressive!");
+ $grade = 'A';
+ } elseif ($percentage >= 70) {
+ $this->info("๐ Good work! Keep it up!");
+ $grade = 'B';
+ } elseif ($percentage >= 60) {
+ $this->warning("๐ Not bad, but there's room for improvement!");
+ $grade = 'C';
+ } else {
+ $this->warning("๐ Keep studying and try again!");
+ $grade = 'D';
+ }
+
+ $this->println("๐ Grade: $grade");
+
+ // Show difficulty-specific feedback
+ $this->println();
+ $this->info("๐ก Difficulty: ".ucfirst($this->difficulty));
+
+ switch ($this->difficulty) {
+ case 'easy':
+ if ($percentage >= 80) {
+ $this->info("Ready to try medium difficulty!");
+ }
+ break;
+ case 'medium':
+ if ($percentage >= 85) {
+ $this->info("You might enjoy the hard difficulty!");
+ } elseif ($percentage < 60) {
+ $this->info("Consider trying easy difficulty first.");
+ }
+ break;
+ case 'hard':
+ if ($percentage >= 70) {
+ $this->success("Impressive performance on hard questions!");
+ } else {
+ $this->info("Hard questions are challenging - keep learning!");
+ }
+ break;
+ }
+
+ // Offer to show detailed results
+ if ($this->confirm('Show detailed results?', false)) {
+ $this->showDetailedResults();
+ }
+
+ // Ask about retaking
+ if ($this->confirm('Take the quiz again?', false)) {
+ $this->info('Run the command again to start a new quiz!');
+ }
+ }
+}
diff --git a/examples/03-user-input/README.md b/examples/03-user-input/README.md
index b30caad..ab2d385 100644
--- a/examples/03-user-input/README.md
+++ b/examples/03-user-input/README.md
@@ -1,397 +1,397 @@
-# User Input Example
-
-This example demonstrates comprehensive user input handling and validation techniques using WebFiori CLI library.
-
-## Features Demonstrated
-
-- Interactive input collection with defaults
-- Input validation and error handling
-- Email format validation
-- Age range validation (13-120)
-- Country selection from numbered lists
-- Programming language selection with y/N prompts
-- Experience level selection
-- Survey summary and statistics
-- Pre-filled values and quick mode options
-
-## Files
-
-- `main.php` - Application entry point and runner setup
-- `SurveyCommand.php` - Interactive survey with comprehensive input handling
-- `SimpleCommand.php` - Non-interactive demo survey
-
-## Usage Examples
-
-### General Help
-```bash
-php main.php
-# or
-php main.php help
-```
-**Output:**
-```
-Usage:
- command [arg1 arg2="val" arg3...]
-
-Global Arguments:
- --ansi:[Optional] Force the use of ANSI output.
-Available Commands:
- help: Display CLI Help. To display help for specific command, use the argument "--command" with this command.
- survey: Interactive survey demonstrating various input methods
- simple-survey: A simple survey without interactive input
-```
-
-## Simple Survey Command
-
-### Show Simple Survey Help
-```bash
-php main.php help --command=simple-survey
-```
-**Output:**
-```
- simple-survey: A simple survey without interactive input
-```
-
-### Run Simple Survey Demo
-```bash
-php main.php simple-survey
-```
-**Output:**
-```
-๐ Simple Survey Demo
-====================
-
-โ Survey completed! Here's your data:
-
-Name: John Doe
-Email: john@example.com
-Age: 30
-Country: Canada
-Languages: PHP, Python
-Experience: Advanced
-```
-
-## Interactive Survey Command
-
-### Show Survey Help
-```bash
-php main.php help --command=survey
-```
-**Output:**
-```
- survey: Interactive survey demonstrating various input methods
- Supported Arguments:
- --name:[Optional] Pre-fill your name (optional)
- --quick:[Optional] Use quick mode with minimal questions
-```
-
-### Basic Interactive Survey
-```bash
-php main.php survey
-```
-**Sample Output:**
-```
-๐ Welcome to the Interactive Survey!
-=====================================
-
-๐ Basic Information
--------------------
-๐ค What's your name? Enter = 'Anonymous'
-๐ง Enter your email:
-๐ How old are you? Enter = '25'
-
-๐ฏ Preferences
--------------
-๐ Select your country:
-0: United States
-1: Canada
-2: United Kingdom
-3: Australia
-4: Germany
-5: France
-6: Japan
-7: Other
-Enter number (0-7) Enter = '0'
-
-๐ป Programming experience:
-Do you know PHP? (y/N) Enter = 'n'
-Do you know JavaScript? (y/N) Enter = 'n'
-Do you know Python? (y/N) Enter = 'n'
-Do you know Java? (y/N) Enter = 'n'
-Do you know C++? (y/N) Enter = 'n'
-Do you know Go? (y/N) Enter = 'n'
-Do you know Rust? (y/N) Enter = 'n'
-
-๐ Your programming experience level:
-0: Beginner
-1: Intermediate
-2: Advanced
-3: Expert
-Enter number (0-3) Enter = '1'
-
-๐ Additional Details
---------------------
-๐จ What's your favorite color? Enter = 'Blue'
-โญ Rate your satisfaction with CLI tools (1-10): Enter = '7'
-๐ฌ Any additional feedback? (optional): Enter = ''
-๐ง Subscribe to our newsletter?(y/N)
-
-๐ Survey Summary
-================
-๐ค Name: Anonymous
-๐ง Email: user@example.com
-๐ Age: 25
-๐ Country: United States
-๐ Experience: Intermediate
-๐ป Languages: None specified
-๐จ Favorite Color: Blue
-โญ Satisfaction: 7/10 โญโญโญโญโญโญโญโโโ
-๐ง Newsletter: No
-
-Submit this survey?(Y/n)
-๐ค Submitting survey...
-...
-โ Thank you for completing the survey!
-๐ Survey ID: SRV-20250926-1234
-
-๐ Quick Stats:
- โข Questions answered: 9
- โข Languages known: 0
- โข Completion time: ~5 minutes
-```
-
-### Survey with Pre-filled Name
-```bash
-php main.php survey --name="Ahmed Hassan"
-```
-**Sample Output:**
-```
-๐ Welcome to the Interactive Survey!
-=====================================
-
-๐ Basic Information
--------------------
-๐ค What's your name? Enter = 'Ahmed Hassan'
-๐ง Enter your email:
-๐ How old are you? Enter = '25'
-
-[... continues with survey flow ...]
-
-๐ Survey Summary
-================
-๐ค Name: Ahmed Hassan
-๐ง Email: ahmed@example.com
-๐ Age: 25
-๐ Country: Canada
-๐ Experience: Advanced
-๐ป Languages: PHP, JavaScript, Python
-๐จ Favorite Color: Blue
-โญ Satisfaction: 9/10 โญโญโญโญโญโญโญโญโญโ
-๐ง Newsletter: No
-
-โ Thank you for completing the survey!
-๐ Survey ID: SRV-20250926-3555
-
-๐ Quick Stats:
- โข Questions answered: 9
- โข Languages known: 3
- โข Completion time: ~3 minutes
-๐ Great to hear you're satisfied with CLI tools!
-```
-
-### Quick Mode Survey
-```bash
-php main.php survey --quick
-```
-**Sample Output:**
-```
-๐ Welcome to the Interactive Survey!
-=====================================
-
-โก Running in quick mode - fewer questions!
-
-๐ Basic Information
--------------------
-๐ค What's your name? Enter = 'Anonymous'
-๐ง Enter your email:
-๐ How old are you? Enter = '25'
-
-๐ฏ Preferences
--------------
-๐ Select your country:
-[... country selection ...]
-
-๐ป Programming experience:
-[... language selection ...]
-
-๐ Your programming experience level:
-[... experience selection ...]
-
-๐ Survey Summary
-================
-๐ค Name: Anonymous
-๐ง Email: user@example.com
-๐ Age: 25
-๐ Country: United States
-๐ Experience: Intermediate
-๐ป Languages: None specified
-
-โ Thank you for completing the survey!
-๐ Survey ID: SRV-20250926-1364
-
-๐ Quick Stats:
- โข Questions answered: 6
- โข Languages known: 0
- โข Completion time: ~5 minutes
-```
-
-### Combined Options
-```bash
-php main.php survey --name="Fatima Al-Zahra" --quick
-```
-**Sample Output:**
-```
-๐ Welcome to the Interactive Survey!
-=====================================
-
-โก Running in quick mode - fewer questions!
-
-๐ Basic Information
--------------------
-๐ค What's your name? Enter = 'Fatima Al-Zahra'
-[... continues with quick survey flow ...]
-
-๐ Survey Summary
-================
-๐ค Name: Fatima Al-Zahra
-๐ง Email: fatima@example.com
-๐ Age: 25
-๐ Country: United States
-๐ Experience: Intermediate
-๐ป Languages: None specified
-
-โ Thank you for completing the survey!
-๐ Survey ID: SRV-20250926-1871
-
-๐ Quick Stats:
- โข Questions answered: 6
- โข Languages known: 0
- โข Completion time: ~3 minutes
-```
-
-## Error Handling Examples
-
-### Invalid Command
-```bash
-php main.php invalid
-```
-**Output:**
-```
-Error: The command 'invalid' is not supported.
-```
-
-### Input Validation
-The survey includes several validation mechanisms:
-
-- **Email validation**: Prompts for valid email format
-- **Age validation**: Ensures age is between 13-120
-- **Country selection**: Validates numeric input within range
-- **Experience level**: Validates numeric input for experience level
-
-## Key Learning Points
-
-1. **Interactive Input**: Use `getInput()` for collecting user data with defaults
-2. **Input Validation**: Implement custom validation logic for business rules
-3. **User Experience**: Provide clear prompts, defaults, and error messages
-4. **Data Collection**: Structure complex surveys with multiple sections
-5. **Conditional Logic**: Use flags like `--quick` to modify behavior
-6. **Pre-filled Data**: Use command arguments to pre-populate fields
-7. **Summary Display**: Format collected data in readable summaries
-8. **Progress Feedback**: Show completion statistics and survey IDs
-
-## Code Structure Examples
-
-### Survey Command Structure
-```php
-class SurveyCommand extends Command {
- public function __construct() {
- parent::__construct('survey', [
- '--name' => [
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DESCRIPTION => 'Pre-fill your name (optional)'
- ],
- '--quick' => [
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DESCRIPTION => 'Use quick mode with minimal questions'
- ]
- ], 'Interactive survey demonstrating various input methods');
- }
-
- public function exec(): int {
- $this->println('๐ Welcome to the Interactive Survey!');
-
- // Collect basic information
- $this->collectBasicInfo();
-
- // Collect preferences
- $this->collectPreferences();
-
- // Show summary and submit
- $this->showSummaryAndSubmit();
-
- return 0;
- }
-}
-```
-
-### Input Collection with Validation
-```php
-private function collectBasicInfo() {
- // Name with pre-fill option
- $preFillName = $this->getArgValue('--name');
- $name = $this->getInput('๐ค What\'s your name?', $preFillName ?? 'Anonymous');
-
- // Email with validation
- do {
- $email = $this->getInput('๐ง Enter your email:');
- if (!filter_var($email, FILTER_VALIDATE_EMAIL)) {
- $this->error('Please enter a valid email address');
- }
- } while (!filter_var($email, FILTER_VALIDATE_EMAIL));
-
- // Age with validation
- $age = $this->getInput('๐ How old are you?', '25');
- $age = is_numeric($age) ? (int)$age : 25;
-}
-```
-
-## Technical Notes
-
-- **Interactive Limitations**: The survey works best in interactive mode; piped input may cause issues with the underlying input handling system
-- **Alternative Approach**: The `simple-survey` command provides a non-interactive demonstration
-- **Input Validation**: Multiple validation layers ensure data quality
-- **User Experience**: Rich formatting with emojis and clear section divisions
-
-This example demonstrates advanced user input handling suitable for complex CLI applications requiring data collection and validation.
-
-## Related Examples
-
-### Prerequisites
-- **[01-basic-hello-world](../01-basic-hello-world/)** - Basic command structure
-- **[02-arguments-and-options](../02-arguments-and-options/)** - Argument handling and validation
-
-### Enhanced Input Methods
-- **[11-masked-input](../11-masked-input/)** - Secure input for passwords and sensitive data
-- **[05-interactive-commands](../05-interactive-commands/)** - Menu-driven interactive workflows
-
-### Output Enhancement
-- **[04-output-formatting](../04-output-formatting/)** - Colors, styles, and formatting
-- **[06-table-display](../06-table-display/)** - Structured data presentation
-- **[07-progress-bars](../07-progress-bars/)** - Visual progress indicators
-
-### Complete Applications
-- **[10-multi-command-app](../10-multi-command-app/)** - Full CLI applications with user management
-- **[09-database-ops](../09-database-ops/)** - Database operations with user input
-
-### Development Tools
-- **[12-command-scaffolding](../12-command-scaffolding/)** - Generate interactive commands automatically
+# User Input Example
+
+This example demonstrates comprehensive user input handling and validation techniques using WebFiori CLI library.
+
+## Features Demonstrated
+
+- Interactive input collection with defaults
+- Input validation and error handling
+- Email format validation
+- Age range validation (13-120)
+- Country selection from numbered lists
+- Programming language selection with y/N prompts
+- Experience level selection
+- Survey summary and statistics
+- Pre-filled values and quick mode options
+
+## Files
+
+- `main.php` - Application entry point and runner setup
+- `SurveyCommand.php` - Interactive survey with comprehensive input handling
+- `SimpleCommand.php` - Non-interactive demo survey
+
+## Usage Examples
+
+### General Help
+```bash
+php main.php
+# or
+php main.php help
+```
+**Output:**
+```
+Usage:
+ command [arg1 arg2="val" arg3...]
+
+Global Arguments:
+ --ansi:[Optional] Force the use of ANSI output.
+Available Commands:
+ help: Display CLI Help. To display help for specific command, use the argument "--command" with this command.
+ survey: Interactive survey demonstrating various input methods
+ simple-survey: A simple survey without interactive input
+```
+
+## Simple Survey Command
+
+### Show Simple Survey Help
+```bash
+php main.php help --command=simple-survey
+```
+**Output:**
+```
+ simple-survey: A simple survey without interactive input
+```
+
+### Run Simple Survey Demo
+```bash
+php main.php simple-survey
+```
+**Output:**
+```
+๐ Simple Survey Demo
+====================
+
+โ Survey completed! Here's your data:
+
+Name: John Doe
+Email: john@example.com
+Age: 30
+Country: Canada
+Languages: PHP, Python
+Experience: Advanced
+```
+
+## Interactive Survey Command
+
+### Show Survey Help
+```bash
+php main.php help --command=survey
+```
+**Output:**
+```
+ survey: Interactive survey demonstrating various input methods
+ Supported Arguments:
+ --name:[Optional] Pre-fill your name (optional)
+ --quick:[Optional] Use quick mode with minimal questions
+```
+
+### Basic Interactive Survey
+```bash
+php main.php survey
+```
+**Sample Output:**
+```
+๐ Welcome to the Interactive Survey!
+=====================================
+
+๐ Basic Information
+-------------------
+๐ค What's your name? Enter = 'Anonymous'
+๐ง Enter your email:
+๐ How old are you? Enter = '25'
+
+๐ฏ Preferences
+-------------
+๐ Select your country:
+0: United States
+1: Canada
+2: United Kingdom
+3: Australia
+4: Germany
+5: France
+6: Japan
+7: Other
+Enter number (0-7) Enter = '0'
+
+๐ป Programming experience:
+Do you know PHP? (y/N) Enter = 'n'
+Do you know JavaScript? (y/N) Enter = 'n'
+Do you know Python? (y/N) Enter = 'n'
+Do you know Java? (y/N) Enter = 'n'
+Do you know C++? (y/N) Enter = 'n'
+Do you know Go? (y/N) Enter = 'n'
+Do you know Rust? (y/N) Enter = 'n'
+
+๐ Your programming experience level:
+0: Beginner
+1: Intermediate
+2: Advanced
+3: Expert
+Enter number (0-3) Enter = '1'
+
+๐ Additional Details
+--------------------
+๐จ What's your favorite color? Enter = 'Blue'
+โญ Rate your satisfaction with CLI tools (1-10): Enter = '7'
+๐ฌ Any additional feedback? (optional): Enter = ''
+๐ง Subscribe to our newsletter?(y/N)
+
+๐ Survey Summary
+================
+๐ค Name: Anonymous
+๐ง Email: user@example.com
+๐ Age: 25
+๐ Country: United States
+๐ Experience: Intermediate
+๐ป Languages: None specified
+๐จ Favorite Color: Blue
+โญ Satisfaction: 7/10 โญโญโญโญโญโญโญโโโ
+๐ง Newsletter: No
+
+Submit this survey?(Y/n)
+๐ค Submitting survey...
+...
+โ Thank you for completing the survey!
+๐ Survey ID: SRV-20250926-1234
+
+๐ Quick Stats:
+ โข Questions answered: 9
+ โข Languages known: 0
+ โข Completion time: ~5 minutes
+```
+
+### Survey with Pre-filled Name
+```bash
+php main.php survey --name="Ahmed Hassan"
+```
+**Sample Output:**
+```
+๐ Welcome to the Interactive Survey!
+=====================================
+
+๐ Basic Information
+-------------------
+๐ค What's your name? Enter = 'Ahmed Hassan'
+๐ง Enter your email:
+๐ How old are you? Enter = '25'
+
+[... continues with survey flow ...]
+
+๐ Survey Summary
+================
+๐ค Name: Ahmed Hassan
+๐ง Email: ahmed@example.com
+๐ Age: 25
+๐ Country: Canada
+๐ Experience: Advanced
+๐ป Languages: PHP, JavaScript, Python
+๐จ Favorite Color: Blue
+โญ Satisfaction: 9/10 โญโญโญโญโญโญโญโญโญโ
+๐ง Newsletter: No
+
+โ Thank you for completing the survey!
+๐ Survey ID: SRV-20250926-3555
+
+๐ Quick Stats:
+ โข Questions answered: 9
+ โข Languages known: 3
+ โข Completion time: ~3 minutes
+๐ Great to hear you're satisfied with CLI tools!
+```
+
+### Quick Mode Survey
+```bash
+php main.php survey --quick
+```
+**Sample Output:**
+```
+๐ Welcome to the Interactive Survey!
+=====================================
+
+โก Running in quick mode - fewer questions!
+
+๐ Basic Information
+-------------------
+๐ค What's your name? Enter = 'Anonymous'
+๐ง Enter your email:
+๐ How old are you? Enter = '25'
+
+๐ฏ Preferences
+-------------
+๐ Select your country:
+[... country selection ...]
+
+๐ป Programming experience:
+[... language selection ...]
+
+๐ Your programming experience level:
+[... experience selection ...]
+
+๐ Survey Summary
+================
+๐ค Name: Anonymous
+๐ง Email: user@example.com
+๐ Age: 25
+๐ Country: United States
+๐ Experience: Intermediate
+๐ป Languages: None specified
+
+โ Thank you for completing the survey!
+๐ Survey ID: SRV-20250926-1364
+
+๐ Quick Stats:
+ โข Questions answered: 6
+ โข Languages known: 0
+ โข Completion time: ~5 minutes
+```
+
+### Combined Options
+```bash
+php main.php survey --name="Fatima Al-Zahra" --quick
+```
+**Sample Output:**
+```
+๐ Welcome to the Interactive Survey!
+=====================================
+
+โก Running in quick mode - fewer questions!
+
+๐ Basic Information
+-------------------
+๐ค What's your name? Enter = 'Fatima Al-Zahra'
+[... continues with quick survey flow ...]
+
+๐ Survey Summary
+================
+๐ค Name: Fatima Al-Zahra
+๐ง Email: fatima@example.com
+๐ Age: 25
+๐ Country: United States
+๐ Experience: Intermediate
+๐ป Languages: None specified
+
+โ Thank you for completing the survey!
+๐ Survey ID: SRV-20250926-1871
+
+๐ Quick Stats:
+ โข Questions answered: 6
+ โข Languages known: 0
+ โข Completion time: ~3 minutes
+```
+
+## Error Handling Examples
+
+### Invalid Command
+```bash
+php main.php invalid
+```
+**Output:**
+```
+Error: The command 'invalid' is not supported.
+```
+
+### Input Validation
+The survey includes several validation mechanisms:
+
+- **Email validation**: Prompts for valid email format
+- **Age validation**: Ensures age is between 13-120
+- **Country selection**: Validates numeric input within range
+- **Experience level**: Validates numeric input for experience level
+
+## Key Learning Points
+
+1. **Interactive Input**: Use `getInput()` for collecting user data with defaults
+2. **Input Validation**: Implement custom validation logic for business rules
+3. **User Experience**: Provide clear prompts, defaults, and error messages
+4. **Data Collection**: Structure complex surveys with multiple sections
+5. **Conditional Logic**: Use flags like `--quick` to modify behavior
+6. **Pre-filled Data**: Use command arguments to pre-populate fields
+7. **Summary Display**: Format collected data in readable summaries
+8. **Progress Feedback**: Show completion statistics and survey IDs
+
+## Code Structure Examples
+
+### Survey Command Structure
+```php
+class SurveyCommand extends Command {
+ public function __construct() {
+ parent::__construct('survey', [
+ '--name' => [
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DESCRIPTION => 'Pre-fill your name (optional)'
+ ],
+ '--quick' => [
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DESCRIPTION => 'Use quick mode with minimal questions'
+ ]
+ ], 'Interactive survey demonstrating various input methods');
+ }
+
+ public function exec(): int {
+ $this->println('๐ Welcome to the Interactive Survey!');
+
+ // Collect basic information
+ $this->collectBasicInfo();
+
+ // Collect preferences
+ $this->collectPreferences();
+
+ // Show summary and submit
+ $this->showSummaryAndSubmit();
+
+ return 0;
+ }
+}
+```
+
+### Input Collection with Validation
+```php
+private function collectBasicInfo() {
+ // Name with pre-fill option
+ $preFillName = $this->getArgValue('--name');
+ $name = $this->getInput('๐ค What\'s your name?', $preFillName ?? 'Anonymous');
+
+ // Email with validation
+ do {
+ $email = $this->getInput('๐ง Enter your email:');
+ if (!filter_var($email, FILTER_VALIDATE_EMAIL)) {
+ $this->error('Please enter a valid email address');
+ }
+ } while (!filter_var($email, FILTER_VALIDATE_EMAIL));
+
+ // Age with validation
+ $age = $this->getInput('๐ How old are you?', '25');
+ $age = is_numeric($age) ? (int)$age : 25;
+}
+```
+
+## Technical Notes
+
+- **Interactive Limitations**: The survey works best in interactive mode; piped input may cause issues with the underlying input handling system
+- **Alternative Approach**: The `simple-survey` command provides a non-interactive demonstration
+- **Input Validation**: Multiple validation layers ensure data quality
+- **User Experience**: Rich formatting with emojis and clear section divisions
+
+This example demonstrates advanced user input handling suitable for complex CLI applications requiring data collection and validation.
+
+## Related Examples
+
+### Prerequisites
+- **[01-basic-hello-world](../01-basic-hello-world/)** - Basic command structure
+- **[02-arguments-and-options](../02-arguments-and-options/)** - Argument handling and validation
+
+### Enhanced Input Methods
+- **[11-masked-input](../11-masked-input/)** - Secure input for passwords and sensitive data
+- **[05-interactive-commands](../05-interactive-commands/)** - Menu-driven interactive workflows
+
+### Output Enhancement
+- **[04-output-formatting](../04-output-formatting/)** - Colors, styles, and formatting
+- **[06-table-display](../06-table-display/)** - Structured data presentation
+- **[07-progress-bars](../07-progress-bars/)** - Visual progress indicators
+
+### Complete Applications
+- **[10-multi-command-app](../10-multi-command-app/)** - Full CLI applications with user management
+- **[09-database-ops](../09-database-ops/)** - Database operations with user input
+
+### Development Tools
+- **[12-command-scaffolding](../12-command-scaffolding/)** - Generate interactive commands automatically
diff --git a/examples/03-user-input/SetupWizardCommand.php b/examples/03-user-input/SetupWizardCommand.php
index 19bc5c8..c20cd16 100644
--- a/examples/03-user-input/SetupWizardCommand.php
+++ b/examples/03-user-input/SetupWizardCommand.php
@@ -1,385 +1,385 @@
- 'Basic Configuration',
- 'database' => 'Database Settings',
- 'security' => 'Security Configuration',
- 'features' => 'Feature Selection'
- ];
-
- public function __construct() {
- parent::__construct('setup', [
- '--step' => [
- ArgumentOption::DESCRIPTION => 'Start from specific step (basic, database, security, features)',
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::VALUES => ['basic', 'database', 'security', 'features']
- ],
- '--config-file' => [
- ArgumentOption::DESCRIPTION => 'Output configuration file path',
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DEFAULT => 'app-config.json'
- ]
- ], 'Interactive setup wizard for application configuration');
- }
-
- public function exec(): int {
- $this->println("๐ง Application Setup Wizard");
- $this->println("===========================");
- $this->println();
-
- $startStep = $this->getArgValue('--step') ?? 'basic';
- $configFile = $this->getArgValue('--config-file') ?? 'app-config.json';
-
- // Show wizard overview
- $this->showWizardOverview($startStep);
-
- // Execute steps
- $stepKeys = array_keys($this->steps);
- $startIndex = array_search($startStep, $stepKeys);
-
- for ($i = $startIndex; $i < count($stepKeys); $i++) {
- $stepKey = $stepKeys[$i];
- $stepNumber = $i + 1;
- $totalSteps = count($stepKeys);
-
- if (!$this->executeStep($stepKey, $stepNumber, $totalSteps)) {
- $this->error('Setup cancelled or failed.');
-
- return 1;
- }
-
- // Ask if user wants to continue (except for last step)
- if ($i < count($stepKeys) - 1) {
- if (!$this->confirm('Continue to next step?', true)) {
- $this->warning('Setup paused. Run again with --step='.$stepKeys[$i + 1].' to continue.');
-
- return 0;
- }
- $this->println();
- }
- }
-
- // Complete setup
- $this->completeSetup($configFile);
-
- return 0;
- }
-
- /**
- * Complete the setup process.
- */
- private function completeSetup(string $configFile): void {
- $this->println();
- $this->success("๐ Setup Wizard Completed!");
- $this->println("=========================");
-
- // Show configuration summary
- $this->showConfigSummary();
-
- // Save configuration
- if ($this->confirm("๐พ Save configuration to $configFile?", true)) {
- $this->saveConfiguration($configFile);
- }
-
- // Show next steps
- $this->showNextSteps();
- }
-
- /**
- * Execute a specific setup step.
- */
- private function executeStep(string $stepKey, int $stepNumber, int $totalSteps): bool {
- $stepTitle = $this->steps[$stepKey];
-
- $this->success("Step $stepNumber/$totalSteps: $stepTitle");
- $this->println(str_repeat('-', strlen("Step $stepNumber/$totalSteps: $stepTitle")));
-
- switch ($stepKey) {
- case 'basic':
- return $this->setupBasicConfig();
- case 'database':
- return $this->setupDatabaseConfig();
- case 'security':
- return $this->setupSecurityConfig();
- case 'features':
- return $this->setupFeatures();
- default:
- $this->error("Unknown step: $stepKey");
-
- return false;
- }
- }
-
- /**
- * Generate application key.
- */
- private function generateAppKey(): string {
- return 'base64:'.base64_encode(random_bytes(32));
- }
-
- /**
- * Generate JWT secret.
- */
- private function generateJwtSecret(): string {
- return bin2hex(random_bytes(32));
- }
-
- /**
- * Get default port for database type.
- */
- private function getDefaultPort(string $dbType): int {
- return match ($dbType) {
- 'mysql' => 3306,
- 'postgresql' => 5432,
- 'mongodb' => 27017,
- default => 3306
- };
- }
-
- /**
- * Save configuration to file (simulated).
- */
- private function saveConfiguration(string $configFile): void {
- $this->info("๐พ Saving configuration...");
-
- // Simulate file writing
- usleep(1000000); // 1 second
-
- $this->success("โ Configuration saved to $configFile");
- $this->info("๐ File size: ".rand(2, 8)." KB");
- }
-
- /**
- * Setup basic configuration.
- */
- private function setupBasicConfig(): bool {
- $this->config['app_name'] = $this->getInput(
- '๐ Application name:',
- 'MyApp',
- new InputValidator(function ($input) {
- return preg_match('/^[A-Za-z0-9\s_-]+$/', $input) && strlen($input) >= 2;
- }, 'App name must be at least 2 characters and contain only letters, numbers, spaces, hyphens, and underscores')
- );
-
- $environments = ['development', 'staging', 'production'];
- $envIndex = $this->select('๐ Environment:', $environments, 0);
- $this->config['environment'] = $environments[$envIndex];
-
- $this->config['debug'] = $this->confirm('๐ Enable debug mode?', $this->config['environment'] === 'development');
-
- $this->config['app_url'] = $this->getInput(
- '๐ Application URL:',
- 'http://localhost:8000',
- new InputValidator(function ($input) {
- return filter_var($input, FILTER_VALIDATE_URL) !== false;
- }, 'Please enter a valid URL')
- );
-
- $this->println();
- $this->info("โ Basic configuration completed!");
-
- return true;
- }
-
- /**
- * Setup database configuration.
- */
- private function setupDatabaseConfig(): bool {
- $dbTypes = ['mysql', 'postgresql', 'sqlite', 'mongodb'];
- $dbIndex = $this->select('๐๏ธ Database type:', $dbTypes, 0);
- $this->config['db_type'] = $dbTypes[$dbIndex];
-
- if ($this->config['db_type'] !== 'sqlite') {
- $this->config['db_host'] = $this->getInput('๐ Database host:', 'localhost');
-
- $this->config['db_port'] = $this->readInteger(
- '๐ Database port:',
- $this->getDefaultPort($this->config['db_type'])
- );
-
- $this->config['db_name'] = $this->getInput(
- '๐ Database name:',
- strtolower(str_replace(' ', '_', $this->config['app_name'] ?? 'myapp'))
- );
-
- $this->config['db_username'] = $this->getInput('๐ค Database username:', 'root');
-
- // Simulate password input (in real implementation, this would be hidden)
- $this->config['db_password'] = $this->getInput('๐ Database password:', '');
-
- // Test connection (simulated)
- if ($this->confirm('๐ Test database connection?', true)) {
- $this->testDatabaseConnection();
- }
- } else {
- $this->config['db_file'] = $this->getInput('๐ SQLite file path:', 'database.sqlite');
- }
-
- $this->println();
- $this->info("โ Database configuration completed!");
-
- return true;
- }
-
- /**
- * Setup feature selection.
- */
- private function setupFeatures(): bool {
- $this->info("๐ฏ Select features to enable:");
-
- $features = [
- 'caching' => 'Caching System',
- 'logging' => 'Advanced Logging',
- 'monitoring' => 'Performance Monitoring',
- 'backup' => 'Automated Backups',
- 'notifications' => 'Email Notifications',
- 'api_docs' => 'API Documentation',
- 'testing' => 'Testing Framework'
- ];
-
- $this->config['features'] = [];
-
- foreach ($features as $key => $title) {
- if ($this->confirm("Enable $title?", in_array($key, ['caching', 'logging']))) {
- $this->config['features'][] = $key;
- }
- }
-
- // Feature-specific configuration
- if (in_array('caching', $this->config['features'])) {
- $cacheTypes = ['redis', 'memcached', 'file'];
- $cacheIndex = $this->select('๐พ Cache driver:', $cacheTypes, 0);
- $this->config['cache_driver'] = $cacheTypes[$cacheIndex];
- }
-
- if (in_array('notifications', $this->config['features'])) {
- $this->config['smtp_host'] = $this->getInput('๐ง SMTP host:', 'smtp.gmail.com');
- $this->config['smtp_port'] = $this->readInteger('๐ง SMTP port:', 587);
- }
-
- $this->println();
- $this->info("โ Feature selection completed!");
-
- return true;
- }
-
- /**
- * Setup security configuration.
- */
- private function setupSecurityConfig(): bool {
- // Generate app key
- if ($this->confirm('๐ Generate application key?', true)) {
- $this->config['app_key'] = $this->generateAppKey();
- $this->success("๐ Application key generated!");
- }
-
- // JWT settings
- if ($this->confirm('๐ซ Enable JWT authentication?', false)) {
- $this->config['jwt_enabled'] = true;
- $this->config['jwt_secret'] = $this->generateJwtSecret();
-
- $this->config['jwt_expiry'] = $this->readInteger('โฐ JWT token expiry (hours):', 24);
- }
-
- // CORS settings
- if ($this->confirm('๐ Configure CORS?', false)) {
- $this->config['cors_enabled'] = true;
- $this->config['cors_origins'] = $this->getInput(
- '๐ Allowed origins (comma-separated):',
- '*'
- );
- }
-
- // Rate limiting
- if ($this->confirm('โก Enable rate limiting?', true)) {
- $this->config['rate_limit_enabled'] = true;
- $this->config['rate_limit_requests'] = $this->readInteger('๐ Requests per minute:', 60);
- }
-
- $this->println();
- $this->info("โ Security configuration completed!");
-
- return true;
- }
-
- /**
- * Show configuration summary.
- */
- private function showConfigSummary(): void {
- $this->info("๐ Configuration Summary:");
- $this->println("โข App Name: ".($this->config['app_name'] ?? 'N/A'));
- $this->println("โข Environment: ".($this->config['environment'] ?? 'N/A'));
- $this->println("โข Database: ".($this->config['db_type'] ?? 'N/A'));
- $this->println("โข Features: ".count($this->config['features'] ?? []));
- $this->println("โข Security: ".(isset($this->config['app_key']) ? 'Configured' : 'Basic'));
- $this->println();
- }
-
- /**
- * Show next steps.
- */
- private function showNextSteps(): void {
- $this->info("๐ Next Steps:");
- $this->println("1. Review the generated configuration file");
- $this->println("2. Set up your database schema");
- $this->println("3. Configure your web server");
- $this->println("4. Run initial tests");
- $this->println("5. Deploy your application");
- $this->println();
- $this->success("Happy coding! ๐");
- }
-
- /**
- * Show wizard overview.
- */
- private function showWizardOverview(string $startStep): void {
- $this->info("๐ Setup Steps:");
-
- $stepNumber = 1;
-
- foreach ($this->steps as $key => $title) {
- $icon = ($key === $startStep) ? '๐' : ' ';
- $this->println("$icon $stepNumber. $title");
- $stepNumber++;
- }
-
- $this->println();
-
- if ($startStep !== 'basic') {
- $this->warning("โ ๏ธ Starting from step: ".$this->steps[$startStep]);
- $this->println();
- }
- }
-
- /**
- * Test database connection (simulated).
- */
- private function testDatabaseConnection(): void {
- $this->info("๐ Testing database connection...");
-
- // Simulate connection test
- usleep(2000000); // 2 seconds
-
- if (rand(0, 10) > 2) { // 80% success rate
- $this->success("โ Database connection successful!");
- } else {
- $this->warning("โ ๏ธ Connection test failed, but continuing setup...");
- }
- }
-}
+ 'Basic Configuration',
+ 'database' => 'Database Settings',
+ 'security' => 'Security Configuration',
+ 'features' => 'Feature Selection'
+ ];
+
+ public function __construct() {
+ parent::__construct('setup', [
+ '--step' => [
+ ArgumentOption::DESCRIPTION => 'Start from specific step (basic, database, security, features)',
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::VALUES => ['basic', 'database', 'security', 'features']
+ ],
+ '--config-file' => [
+ ArgumentOption::DESCRIPTION => 'Output configuration file path',
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DEFAULT => 'app-config.json'
+ ]
+ ], 'Interactive setup wizard for application configuration');
+ }
+
+ public function exec(): int {
+ $this->println("๐ง Application Setup Wizard");
+ $this->println("===========================");
+ $this->println();
+
+ $startStep = $this->getArgValue('--step') ?? 'basic';
+ $configFile = $this->getArgValue('--config-file') ?? 'app-config.json';
+
+ // Show wizard overview
+ $this->showWizardOverview($startStep);
+
+ // Execute steps
+ $stepKeys = array_keys($this->steps);
+ $startIndex = array_search($startStep, $stepKeys);
+
+ for ($i = $startIndex; $i < count($stepKeys); $i++) {
+ $stepKey = $stepKeys[$i];
+ $stepNumber = $i + 1;
+ $totalSteps = count($stepKeys);
+
+ if (!$this->executeStep($stepKey, $stepNumber, $totalSteps)) {
+ $this->error('Setup cancelled or failed.');
+
+ return 1;
+ }
+
+ // Ask if user wants to continue (except for last step)
+ if ($i < count($stepKeys) - 1) {
+ if (!$this->confirm('Continue to next step?', true)) {
+ $this->warning('Setup paused. Run again with --step='.$stepKeys[$i + 1].' to continue.');
+
+ return 0;
+ }
+ $this->println();
+ }
+ }
+
+ // Complete setup
+ $this->completeSetup($configFile);
+
+ return 0;
+ }
+
+ /**
+ * Complete the setup process.
+ */
+ private function completeSetup(string $configFile): void {
+ $this->println();
+ $this->success("๐ Setup Wizard Completed!");
+ $this->println("=========================");
+
+ // Show configuration summary
+ $this->showConfigSummary();
+
+ // Save configuration
+ if ($this->confirm("๐พ Save configuration to $configFile?", true)) {
+ $this->saveConfiguration($configFile);
+ }
+
+ // Show next steps
+ $this->showNextSteps();
+ }
+
+ /**
+ * Execute a specific setup step.
+ */
+ private function executeStep(string $stepKey, int $stepNumber, int $totalSteps): bool {
+ $stepTitle = $this->steps[$stepKey];
+
+ $this->success("Step $stepNumber/$totalSteps: $stepTitle");
+ $this->println(str_repeat('-', strlen("Step $stepNumber/$totalSteps: $stepTitle")));
+
+ switch ($stepKey) {
+ case 'basic':
+ return $this->setupBasicConfig();
+ case 'database':
+ return $this->setupDatabaseConfig();
+ case 'security':
+ return $this->setupSecurityConfig();
+ case 'features':
+ return $this->setupFeatures();
+ default:
+ $this->error("Unknown step: $stepKey");
+
+ return false;
+ }
+ }
+
+ /**
+ * Generate application key.
+ */
+ private function generateAppKey(): string {
+ return 'base64:'.base64_encode(random_bytes(32));
+ }
+
+ /**
+ * Generate JWT secret.
+ */
+ private function generateJwtSecret(): string {
+ return bin2hex(random_bytes(32));
+ }
+
+ /**
+ * Get default port for database type.
+ */
+ private function getDefaultPort(string $dbType): int {
+ return match ($dbType) {
+ 'mysql' => 3306,
+ 'postgresql' => 5432,
+ 'mongodb' => 27017,
+ default => 3306
+ };
+ }
+
+ /**
+ * Save configuration to file (simulated).
+ */
+ private function saveConfiguration(string $configFile): void {
+ $this->info("๐พ Saving configuration...");
+
+ // Simulate file writing
+ usleep(1000000); // 1 second
+
+ $this->success("โ Configuration saved to $configFile");
+ $this->info("๐ File size: ".rand(2, 8)." KB");
+ }
+
+ /**
+ * Setup basic configuration.
+ */
+ private function setupBasicConfig(): bool {
+ $this->config['app_name'] = $this->getInput(
+ '๐ Application name:',
+ 'MyApp',
+ new InputValidator(function ($input) {
+ return preg_match('/^[A-Za-z0-9\s_-]+$/', $input) && strlen($input) >= 2;
+ }, 'App name must be at least 2 characters and contain only letters, numbers, spaces, hyphens, and underscores')
+ );
+
+ $environments = ['development', 'staging', 'production'];
+ $envIndex = $this->select('๐ Environment:', $environments, 0);
+ $this->config['environment'] = $environments[$envIndex];
+
+ $this->config['debug'] = $this->confirm('๐ Enable debug mode?', $this->config['environment'] === 'development');
+
+ $this->config['app_url'] = $this->getInput(
+ '๐ Application URL:',
+ 'http://localhost:8000',
+ new InputValidator(function ($input) {
+ return filter_var($input, FILTER_VALIDATE_URL) !== false;
+ }, 'Please enter a valid URL')
+ );
+
+ $this->println();
+ $this->info("โ Basic configuration completed!");
+
+ return true;
+ }
+
+ /**
+ * Setup database configuration.
+ */
+ private function setupDatabaseConfig(): bool {
+ $dbTypes = ['mysql', 'postgresql', 'sqlite', 'mongodb'];
+ $dbIndex = $this->select('๐๏ธ Database type:', $dbTypes, 0);
+ $this->config['db_type'] = $dbTypes[$dbIndex];
+
+ if ($this->config['db_type'] !== 'sqlite') {
+ $this->config['db_host'] = $this->getInput('๐ Database host:', 'localhost');
+
+ $this->config['db_port'] = $this->readInteger(
+ '๐ Database port:',
+ $this->getDefaultPort($this->config['db_type'])
+ );
+
+ $this->config['db_name'] = $this->getInput(
+ '๐ Database name:',
+ strtolower(str_replace(' ', '_', $this->config['app_name'] ?? 'myapp'))
+ );
+
+ $this->config['db_username'] = $this->getInput('๐ค Database username:', 'root');
+
+ // Simulate password input (in real implementation, this would be hidden)
+ $this->config['db_password'] = $this->getInput('๐ Database password:', '');
+
+ // Test connection (simulated)
+ if ($this->confirm('๐ Test database connection?', true)) {
+ $this->testDatabaseConnection();
+ }
+ } else {
+ $this->config['db_file'] = $this->getInput('๐ SQLite file path:', 'database.sqlite');
+ }
+
+ $this->println();
+ $this->info("โ Database configuration completed!");
+
+ return true;
+ }
+
+ /**
+ * Setup feature selection.
+ */
+ private function setupFeatures(): bool {
+ $this->info("๐ฏ Select features to enable:");
+
+ $features = [
+ 'caching' => 'Caching System',
+ 'logging' => 'Advanced Logging',
+ 'monitoring' => 'Performance Monitoring',
+ 'backup' => 'Automated Backups',
+ 'notifications' => 'Email Notifications',
+ 'api_docs' => 'API Documentation',
+ 'testing' => 'Testing Framework'
+ ];
+
+ $this->config['features'] = [];
+
+ foreach ($features as $key => $title) {
+ if ($this->confirm("Enable $title?", in_array($key, ['caching', 'logging']))) {
+ $this->config['features'][] = $key;
+ }
+ }
+
+ // Feature-specific configuration
+ if (in_array('caching', $this->config['features'])) {
+ $cacheTypes = ['redis', 'memcached', 'file'];
+ $cacheIndex = $this->select('๐พ Cache driver:', $cacheTypes, 0);
+ $this->config['cache_driver'] = $cacheTypes[$cacheIndex];
+ }
+
+ if (in_array('notifications', $this->config['features'])) {
+ $this->config['smtp_host'] = $this->getInput('๐ง SMTP host:', 'smtp.gmail.com');
+ $this->config['smtp_port'] = $this->readInteger('๐ง SMTP port:', 587);
+ }
+
+ $this->println();
+ $this->info("โ Feature selection completed!");
+
+ return true;
+ }
+
+ /**
+ * Setup security configuration.
+ */
+ private function setupSecurityConfig(): bool {
+ // Generate app key
+ if ($this->confirm('๐ Generate application key?', true)) {
+ $this->config['app_key'] = $this->generateAppKey();
+ $this->success("๐ Application key generated!");
+ }
+
+ // JWT settings
+ if ($this->confirm('๐ซ Enable JWT authentication?', false)) {
+ $this->config['jwt_enabled'] = true;
+ $this->config['jwt_secret'] = $this->generateJwtSecret();
+
+ $this->config['jwt_expiry'] = $this->readInteger('โฐ JWT token expiry (hours):', 24);
+ }
+
+ // CORS settings
+ if ($this->confirm('๐ Configure CORS?', false)) {
+ $this->config['cors_enabled'] = true;
+ $this->config['cors_origins'] = $this->getInput(
+ '๐ Allowed origins (comma-separated):',
+ '*'
+ );
+ }
+
+ // Rate limiting
+ if ($this->confirm('โก Enable rate limiting?', true)) {
+ $this->config['rate_limit_enabled'] = true;
+ $this->config['rate_limit_requests'] = $this->readInteger('๐ Requests per minute:', 60);
+ }
+
+ $this->println();
+ $this->info("โ Security configuration completed!");
+
+ return true;
+ }
+
+ /**
+ * Show configuration summary.
+ */
+ private function showConfigSummary(): void {
+ $this->info("๐ Configuration Summary:");
+ $this->println("โข App Name: ".($this->config['app_name'] ?? 'N/A'));
+ $this->println("โข Environment: ".($this->config['environment'] ?? 'N/A'));
+ $this->println("โข Database: ".($this->config['db_type'] ?? 'N/A'));
+ $this->println("โข Features: ".count($this->config['features'] ?? []));
+ $this->println("โข Security: ".(isset($this->config['app_key']) ? 'Configured' : 'Basic'));
+ $this->println();
+ }
+
+ /**
+ * Show next steps.
+ */
+ private function showNextSteps(): void {
+ $this->info("๐ Next Steps:");
+ $this->println("1. Review the generated configuration file");
+ $this->println("2. Set up your database schema");
+ $this->println("3. Configure your web server");
+ $this->println("4. Run initial tests");
+ $this->println("5. Deploy your application");
+ $this->println();
+ $this->success("Happy coding! ๐");
+ }
+
+ /**
+ * Show wizard overview.
+ */
+ private function showWizardOverview(string $startStep): void {
+ $this->info("๐ Setup Steps:");
+
+ $stepNumber = 1;
+
+ foreach ($this->steps as $key => $title) {
+ $icon = ($key === $startStep) ? '๐' : ' ';
+ $this->println("$icon $stepNumber. $title");
+ $stepNumber++;
+ }
+
+ $this->println();
+
+ if ($startStep !== 'basic') {
+ $this->warning("โ ๏ธ Starting from step: ".$this->steps[$startStep]);
+ $this->println();
+ }
+ }
+
+ /**
+ * Test database connection (simulated).
+ */
+ private function testDatabaseConnection(): void {
+ $this->info("๐ Testing database connection...");
+
+ // Simulate connection test
+ usleep(2000000); // 2 seconds
+
+ if (rand(0, 10) > 2) { // 80% success rate
+ $this->success("โ Database connection successful!");
+ } else {
+ $this->warning("โ ๏ธ Connection test failed, but continuing setup...");
+ }
+ }
+}
diff --git a/examples/03-user-input/SimpleCommand.php b/examples/03-user-input/SimpleCommand.php
index 79eb5b6..7c954e3 100644
--- a/examples/03-user-input/SimpleCommand.php
+++ b/examples/03-user-input/SimpleCommand.php
@@ -1,39 +1,39 @@
-println('๐ Simple Survey Demo');
- $this->println('====================');
-
- // Simulate collecting data
- $data = [
- 'name' => 'Ahmed Hassan',
- 'email' => 'john@example.com',
- 'age' => 30,
- 'country' => 'Canada',
- 'languages' => ['PHP', 'Python'],
- 'experience' => 'Advanced'
- ];
-
- $this->println();
- $this->success('Survey completed! Here\'s your data:');
- $this->println();
-
- foreach ($data as $key => $value) {
- if (is_array($value)) {
- $this->println('%s: %s', ucfirst($key), implode(', ', $value));
- } else {
- $this->println('%s: %s', ucfirst($key), $value);
- }
- }
-
- return 0;
- }
-}
+println('๐ Simple Survey Demo');
+ $this->println('====================');
+
+ // Simulate collecting data
+ $data = [
+ 'name' => 'Ahmed Hassan',
+ 'email' => 'john@example.com',
+ 'age' => 30,
+ 'country' => 'Canada',
+ 'languages' => ['PHP', 'Python'],
+ 'experience' => 'Advanced'
+ ];
+
+ $this->println();
+ $this->success('Survey completed! Here\'s your data:');
+ $this->println();
+
+ foreach ($data as $key => $value) {
+ if (is_array($value)) {
+ $this->println('%s: %s', ucfirst($key), implode(', ', $value));
+ } else {
+ $this->println('%s: %s', ucfirst($key), $value);
+ }
+ }
+
+ return 0;
+ }
+}
diff --git a/examples/03-user-input/SurveyCommand.php b/examples/03-user-input/SurveyCommand.php
index 1eb9df4..aacb01e 100644
--- a/examples/03-user-input/SurveyCommand.php
+++ b/examples/03-user-input/SurveyCommand.php
@@ -1,324 +1,324 @@
- [
- ArgumentOption::DESCRIPTION => 'Pre-fill your name (optional)',
- ArgumentOption::OPTIONAL => true
- ],
- '--quick' => [
- ArgumentOption::DESCRIPTION => 'Use quick mode with minimal questions',
- ArgumentOption::OPTIONAL => true
- ]
- ], 'Interactive survey demonstrating various input methods');
- }
-
- public function exec(): int {
- $this->println("๐ Welcome to the Interactive Survey!");
- $this->println("=====================================");
- $this->println();
-
- // Check if we can run interactive survey
- if (!$this->supportsInteractiveInput()) {
- $this->warning("Non-interactive input detected. Using simplified survey mode.");
- return $this->runSimplifiedSurvey();
- }
-
- $quickMode = $this->isArgProvided('--quick');
-
- if ($quickMode) {
- $this->info("โก Running in quick mode - fewer questions!");
- $this->println();
- }
-
- // Collect survey data
- $this->collectBasicInfo();
- $this->collectPreferences();
-
- if (!$quickMode) {
- $this->collectDetailedInfo();
- }
-
- // Show summary and confirm
- $this->showSummary();
-
- if ($this->confirm('Submit this survey?', true)) {
- $this->submitSurvey();
- } else {
- $this->warning('Survey cancelled.');
-
- return 1;
- }
-
- return 0;
- }
-
- /**
- * Collect basic information.
- */
- private function collectBasicInfo(): void {
- $this->info("๐ Basic Information");
- $this->println("-------------------");
-
- // Name (with pre-fill option)
- $preFillName = $this->getArgValue('--name');
- $this->surveyData['name'] = $this->getInput(
- '๐ค What\'s your name?',
- $preFillName ?? 'Anonymous'
- );
-
- // Email with validation
- $this->surveyData['email'] = $this->getInput(
- '๐ง Enter your email:',
- null,
- new InputValidator(function ($input) {
- return filter_var($input, FILTER_VALIDATE_EMAIL) !== false;
- }, 'Please enter a valid email address')
- );
-
- // Age with numeric validation
- $age = $this->getInput('๐ How old are you?', '25');
- $this->surveyData['age'] = is_numeric($age) ? (int)$age : 25;
-
- // Validate age range
- if ($this->surveyData['age'] < 13 || $this->surveyData['age'] > 120) {
- $this->warning('โ ๏ธ Age seems unusual, but we\'ll accept it!');
- }
-
- $this->println();
- }
-
- /**
- * Collect detailed information (only in full mode).
- */
- private function collectDetailedInfo(): void {
- $this->info("๐ Additional Details");
- $this->println("--------------------");
-
- // Favorite color with custom validation
- $this->surveyData['favorite_color'] = $this->getInput(
- '๐จ What\'s your favorite color?',
- 'Blue',
- new InputValidator(function ($input) {
- return preg_match('/^[A-Za-z\s]+$/', trim($input));
- }, 'Please enter only letters and spaces')
- );
-
- // Rating with range validation
- $this->surveyData['satisfaction'] = $this->getInput(
- 'โญ Rate your satisfaction with CLI tools (1-10):',
- '7',
- new InputValidator(function ($input) {
- $num = (int)$input;
-
- return $num >= 1 && $num <= 10;
- }, 'Please enter a number between 1 and 10')
- );
-
- // Optional feedback
- $feedback = $this->getInput('๐ฌ Any additional feedback? (optional):', '');
-
- if (!empty(trim($feedback))) {
- $this->surveyData['feedback'] = trim($feedback);
- }
-
- // Newsletter subscription
- $this->surveyData['newsletter'] = $this->confirm('๐ง Subscribe to our newsletter?', false);
-
- $this->println();
- }
-
- /**
- * Collect user preferences.
- */
- private function collectPreferences(): void {
- $this->info("๐ฏ Preferences");
- $this->println("-------------");
-
- // Country selection
- $countries = [
- 'United States',
- 'Canada',
- 'United Kingdom',
- 'Australia',
- 'Germany',
- 'France',
- 'Japan',
- 'Other'
- ];
-
- // Display countries and get selection
- $this->println('๐ Select your country:');
- foreach ($countries as $i => $country) {
- $this->println("%d: %s", $i, $country);
- }
- $countryInput = $this->getInput('Enter number (0-7)', '0');
- $countryIndex = is_numeric($countryInput) ? (int)$countryInput : 0;
- $countryIndex = max(0, min($countryIndex, count($countries) - 1));
- $this->surveyData['country'] = $countries[$countryIndex];
-
- // Programming languages (multiple choice simulation)
- $this->println();
- $this->info('๐ป Programming experience:');
-
- $languages = ['PHP', 'JavaScript', 'Python', 'Java', 'C++', 'Go', 'Rust'];
- $knownLanguages = [];
-
- foreach ($languages as $lang) {
- $answer = $this->getInput("Do you know $lang? (y/N)", 'n');
- if (strtolower($answer) === 'y' || strtolower($answer) === 'yes') {
- $knownLanguages[] = $lang;
- }
- }
-
- $this->surveyData['languages'] = $knownLanguages;
-
- // Experience level
- $this->println();
- $experienceLevels = ['Beginner', 'Intermediate', 'Advanced', 'Expert'];
- $this->println('๐ Your programming experience level:');
- foreach ($experienceLevels as $i => $level) {
- $this->println("%d: %s", $i, $level);
- }
- $expInput = $this->getInput('Enter number (0-3)', '1');
- $expIndex = is_numeric($expInput) ? (int)$expInput : 1;
- $expIndex = max(0, min($expIndex, count($experienceLevels) - 1));
- $this->surveyData['experience'] = $experienceLevels[$expIndex];
-
- $this->println();
- }
-
- /**
- * Show survey summary.
- */
- private function showSummary(): void {
- $this->success("๐ Survey Summary");
- $this->println("================");
-
- $this->println("๐ค Name: ".$this->surveyData['name']);
- $this->println("๐ง Email: ".$this->surveyData['email']);
- $this->println("๐ Age: ".$this->surveyData['age']);
- $this->println("๐ Country: ".$this->surveyData['country']);
- $this->println("๐ Experience: ".$this->surveyData['experience']);
-
- if (!empty($this->surveyData['languages'])) {
- $this->println("๐ป Languages: ".implode(', ', $this->surveyData['languages']));
- } else {
- $this->println("๐ป Languages: None specified");
- }
-
- if (isset($this->surveyData['favorite_color'])) {
- $this->println("๐จ Favorite Color: ".$this->surveyData['favorite_color']);
- }
-
- if (isset($this->surveyData['satisfaction'])) {
- $rating = (int)$this->surveyData['satisfaction'];
- $stars = str_repeat('โญ', $rating).str_repeat('โ', 10 - $rating);
- $this->println("โญ Satisfaction: $rating/10 $stars");
- }
-
- if (isset($this->surveyData['feedback'])) {
- $this->println("๐ฌ Feedback: ".$this->surveyData['feedback']);
- }
-
- if (isset($this->surveyData['newsletter'])) {
- $newsletter = $this->surveyData['newsletter'] ? 'Yes' : 'No';
- $this->println("๐ง Newsletter: $newsletter");
- }
-
- $this->println();
- }
-
- /**
- * Submit the survey (simulated).
- */
- private function submitSurvey(): void {
- $this->info("๐ค Submitting survey...");
-
- // Simulate processing time
- for ($i = 0; $i < 3; $i++) {
- $this->prints('.');
- usleep(500000); // 0.5 seconds
- }
- $this->println();
- }
-
- /**
- * Run simplified survey for non-interactive input streams.
- */
- private function runSimplifiedSurvey(): int {
- $this->println();
-
- // Use pre-filled name or default
- $name = $this->getArgValue('--name') ?? 'Anonymous User';
-
- // Simulate survey data collection
- $this->surveyData = [
- 'name' => $name,
- 'email' => 'user@example.com',
- 'age' => 25,
- 'country' => 'United States',
- 'languages' => ['PHP'],
- 'experience' => 'Intermediate',
- 'color' => 'Blue',
- 'satisfaction' => 8,
- 'feedback' => '',
- 'newsletter' => false
- ];
-
- $this->success("๐ Survey completed in simplified mode!");
- $this->println();
-
- // Show summary
- $this->showSummary();
-
- // Auto-submit in simplified mode
- $this->info("๐ค Auto-submitting survey...");
- $surveyId = 'SRV-' . date('Ymd') . '-' . rand(1000, 9999);
- $this->success("โ Survey submitted! ID: $surveyId");
-
- return 0;
-
- $this->success("โ Thank you for completing the survey!");
-
- // Generate survey ID
- $surveyId = 'SRV-'.date('Ymd').'-'.rand(1000, 9999);
- $this->info("๐ Survey ID: $surveyId");
-
- // Show some statistics
- $this->println();
- $this->info("๐ Quick Stats:");
- $this->println(" โข Questions answered: ".count($this->surveyData));
- $this->println(" โข Languages known: ".count($this->surveyData['languages'] ?? []));
- $this->println(" โข Completion time: ~".rand(2, 5)." minutes");
-
- if (isset($this->surveyData['satisfaction'])) {
- $satisfaction = (int)$this->surveyData['satisfaction'];
-
- if ($satisfaction >= 8) {
- $this->success("๐ Great to hear you're satisfied with CLI tools!");
- } elseif ($satisfaction >= 6) {
- $this->info("๐ Thanks for the feedback, we'll keep improving!");
- } else {
- $this->warning("๐ Sorry to hear that. We'll work on making things better!");
- }
- }
- }
-}
+ [
+ ArgumentOption::DESCRIPTION => 'Pre-fill your name (optional)',
+ ArgumentOption::OPTIONAL => true
+ ],
+ '--quick' => [
+ ArgumentOption::DESCRIPTION => 'Use quick mode with minimal questions',
+ ArgumentOption::OPTIONAL => true
+ ]
+ ], 'Interactive survey demonstrating various input methods');
+ }
+
+ public function exec(): int {
+ $this->println("๐ Welcome to the Interactive Survey!");
+ $this->println("=====================================");
+ $this->println();
+
+ // Check if we can run interactive survey
+ if (!$this->supportsInteractiveInput()) {
+ $this->warning("Non-interactive input detected. Using simplified survey mode.");
+ return $this->runSimplifiedSurvey();
+ }
+
+ $quickMode = $this->isArgProvided('--quick');
+
+ if ($quickMode) {
+ $this->info("โก Running in quick mode - fewer questions!");
+ $this->println();
+ }
+
+ // Collect survey data
+ $this->collectBasicInfo();
+ $this->collectPreferences();
+
+ if (!$quickMode) {
+ $this->collectDetailedInfo();
+ }
+
+ // Show summary and confirm
+ $this->showSummary();
+
+ if ($this->confirm('Submit this survey?', true)) {
+ $this->submitSurvey();
+ } else {
+ $this->warning('Survey cancelled.');
+
+ return 1;
+ }
+
+ return 0;
+ }
+
+ /**
+ * Collect basic information.
+ */
+ private function collectBasicInfo(): void {
+ $this->info("๐ Basic Information");
+ $this->println("-------------------");
+
+ // Name (with pre-fill option)
+ $preFillName = $this->getArgValue('--name');
+ $this->surveyData['name'] = $this->getInput(
+ '๐ค What\'s your name?',
+ $preFillName ?? 'Anonymous'
+ );
+
+ // Email with validation
+ $this->surveyData['email'] = $this->getInput(
+ '๐ง Enter your email:',
+ null,
+ new InputValidator(function ($input) {
+ return filter_var($input, FILTER_VALIDATE_EMAIL) !== false;
+ }, 'Please enter a valid email address')
+ );
+
+ // Age with numeric validation
+ $age = $this->getInput('๐ How old are you?', '25');
+ $this->surveyData['age'] = is_numeric($age) ? (int)$age : 25;
+
+ // Validate age range
+ if ($this->surveyData['age'] < 13 || $this->surveyData['age'] > 120) {
+ $this->warning('โ ๏ธ Age seems unusual, but we\'ll accept it!');
+ }
+
+ $this->println();
+ }
+
+ /**
+ * Collect detailed information (only in full mode).
+ */
+ private function collectDetailedInfo(): void {
+ $this->info("๐ Additional Details");
+ $this->println("--------------------");
+
+ // Favorite color with custom validation
+ $this->surveyData['favorite_color'] = $this->getInput(
+ '๐จ What\'s your favorite color?',
+ 'Blue',
+ new InputValidator(function ($input) {
+ return preg_match('/^[A-Za-z\s]+$/', trim($input));
+ }, 'Please enter only letters and spaces')
+ );
+
+ // Rating with range validation
+ $this->surveyData['satisfaction'] = $this->getInput(
+ 'โญ Rate your satisfaction with CLI tools (1-10):',
+ '7',
+ new InputValidator(function ($input) {
+ $num = (int)$input;
+
+ return $num >= 1 && $num <= 10;
+ }, 'Please enter a number between 1 and 10')
+ );
+
+ // Optional feedback
+ $feedback = $this->getInput('๐ฌ Any additional feedback? (optional):', '');
+
+ if (!empty(trim($feedback))) {
+ $this->surveyData['feedback'] = trim($feedback);
+ }
+
+ // Newsletter subscription
+ $this->surveyData['newsletter'] = $this->confirm('๐ง Subscribe to our newsletter?', false);
+
+ $this->println();
+ }
+
+ /**
+ * Collect user preferences.
+ */
+ private function collectPreferences(): void {
+ $this->info("๐ฏ Preferences");
+ $this->println("-------------");
+
+ // Country selection
+ $countries = [
+ 'United States',
+ 'Canada',
+ 'United Kingdom',
+ 'Australia',
+ 'Germany',
+ 'France',
+ 'Japan',
+ 'Other'
+ ];
+
+ // Display countries and get selection
+ $this->println('๐ Select your country:');
+ foreach ($countries as $i => $country) {
+ $this->println("%d: %s", $i, $country);
+ }
+ $countryInput = $this->getInput('Enter number (0-7)', '0');
+ $countryIndex = is_numeric($countryInput) ? (int)$countryInput : 0;
+ $countryIndex = max(0, min($countryIndex, count($countries) - 1));
+ $this->surveyData['country'] = $countries[$countryIndex];
+
+ // Programming languages (multiple choice simulation)
+ $this->println();
+ $this->info('๐ป Programming experience:');
+
+ $languages = ['PHP', 'JavaScript', 'Python', 'Java', 'C++', 'Go', 'Rust'];
+ $knownLanguages = [];
+
+ foreach ($languages as $lang) {
+ $answer = $this->getInput("Do you know $lang? (y/N)", 'n');
+ if (strtolower($answer) === 'y' || strtolower($answer) === 'yes') {
+ $knownLanguages[] = $lang;
+ }
+ }
+
+ $this->surveyData['languages'] = $knownLanguages;
+
+ // Experience level
+ $this->println();
+ $experienceLevels = ['Beginner', 'Intermediate', 'Advanced', 'Expert'];
+ $this->println('๐ Your programming experience level:');
+ foreach ($experienceLevels as $i => $level) {
+ $this->println("%d: %s", $i, $level);
+ }
+ $expInput = $this->getInput('Enter number (0-3)', '1');
+ $expIndex = is_numeric($expInput) ? (int)$expInput : 1;
+ $expIndex = max(0, min($expIndex, count($experienceLevels) - 1));
+ $this->surveyData['experience'] = $experienceLevels[$expIndex];
+
+ $this->println();
+ }
+
+ /**
+ * Show survey summary.
+ */
+ private function showSummary(): void {
+ $this->success("๐ Survey Summary");
+ $this->println("================");
+
+ $this->println("๐ค Name: ".$this->surveyData['name']);
+ $this->println("๐ง Email: ".$this->surveyData['email']);
+ $this->println("๐ Age: ".$this->surveyData['age']);
+ $this->println("๐ Country: ".$this->surveyData['country']);
+ $this->println("๐ Experience: ".$this->surveyData['experience']);
+
+ if (!empty($this->surveyData['languages'])) {
+ $this->println("๐ป Languages: ".implode(', ', $this->surveyData['languages']));
+ } else {
+ $this->println("๐ป Languages: None specified");
+ }
+
+ if (isset($this->surveyData['favorite_color'])) {
+ $this->println("๐จ Favorite Color: ".$this->surveyData['favorite_color']);
+ }
+
+ if (isset($this->surveyData['satisfaction'])) {
+ $rating = (int)$this->surveyData['satisfaction'];
+ $stars = str_repeat('โญ', $rating).str_repeat('โ', 10 - $rating);
+ $this->println("โญ Satisfaction: $rating/10 $stars");
+ }
+
+ if (isset($this->surveyData['feedback'])) {
+ $this->println("๐ฌ Feedback: ".$this->surveyData['feedback']);
+ }
+
+ if (isset($this->surveyData['newsletter'])) {
+ $newsletter = $this->surveyData['newsletter'] ? 'Yes' : 'No';
+ $this->println("๐ง Newsletter: $newsletter");
+ }
+
+ $this->println();
+ }
+
+ /**
+ * Submit the survey (simulated).
+ */
+ private function submitSurvey(): void {
+ $this->info("๐ค Submitting survey...");
+
+ // Simulate processing time
+ for ($i = 0; $i < 3; $i++) {
+ $this->prints('.');
+ usleep(500000); // 0.5 seconds
+ }
+ $this->println();
+ }
+
+ /**
+ * Run simplified survey for non-interactive input streams.
+ */
+ private function runSimplifiedSurvey(): int {
+ $this->println();
+
+ // Use pre-filled name or default
+ $name = $this->getArgValue('--name') ?? 'Anonymous User';
+
+ // Simulate survey data collection
+ $this->surveyData = [
+ 'name' => $name,
+ 'email' => 'user@example.com',
+ 'age' => 25,
+ 'country' => 'United States',
+ 'languages' => ['PHP'],
+ 'experience' => 'Intermediate',
+ 'color' => 'Blue',
+ 'satisfaction' => 8,
+ 'feedback' => '',
+ 'newsletter' => false
+ ];
+
+ $this->success("๐ Survey completed in simplified mode!");
+ $this->println();
+
+ // Show summary
+ $this->showSummary();
+
+ // Auto-submit in simplified mode
+ $this->info("๐ค Auto-submitting survey...");
+ $surveyId = 'SRV-' . date('Ymd') . '-' . rand(1000, 9999);
+ $this->success("โ Survey submitted! ID: $surveyId");
+
+ return 0;
+
+ $this->success("โ Thank you for completing the survey!");
+
+ // Generate survey ID
+ $surveyId = 'SRV-'.date('Ymd').'-'.rand(1000, 9999);
+ $this->info("๐ Survey ID: $surveyId");
+
+ // Show some statistics
+ $this->println();
+ $this->info("๐ Quick Stats:");
+ $this->println(" โข Questions answered: ".count($this->surveyData));
+ $this->println(" โข Languages known: ".count($this->surveyData['languages'] ?? []));
+ $this->println(" โข Completion time: ~".rand(2, 5)." minutes");
+
+ if (isset($this->surveyData['satisfaction'])) {
+ $satisfaction = (int)$this->surveyData['satisfaction'];
+
+ if ($satisfaction >= 8) {
+ $this->success("๐ Great to hear you're satisfied with CLI tools!");
+ } elseif ($satisfaction >= 6) {
+ $this->info("๐ Thanks for the feedback, we'll keep improving!");
+ } else {
+ $this->warning("๐ Sorry to hear that. We'll work on making things better!");
+ }
+ }
+ }
+}
diff --git a/examples/03-user-input/main.php b/examples/03-user-input/main.php
index 422d74d..fd5de62 100644
--- a/examples/03-user-input/main.php
+++ b/examples/03-user-input/main.php
@@ -1,31 +1,31 @@
-register(new SurveyCommand());
-$runner->register(new SimpleCommand());
-
-// Set default command
-
-// Start the application
-exit($runner->start());
+register(new SurveyCommand());
+$runner->register(new SimpleCommand());
+
+// Set default command
+
+// Start the application
+exit($runner->start());
diff --git a/examples/04-output-formatting/FormattingDemoCommand.php b/examples/04-output-formatting/FormattingDemoCommand.php
index ec24911..169040d 100644
--- a/examples/04-output-formatting/FormattingDemoCommand.php
+++ b/examples/04-output-formatting/FormattingDemoCommand.php
@@ -1,733 +1,733 @@
- [
- ArgumentOption::DESCRIPTION => 'Show specific section only',
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::VALUES => ['colors', 'styles', 'tables', 'progress', 'layouts', 'animations']
- ],
- '--no-colors' => [
- ArgumentOption::DESCRIPTION => 'Disable color output',
- ArgumentOption::OPTIONAL => true
- ]
- ], 'Demonstrates various output formatting techniques and ANSI styling');
- }
-
- public function exec(): int {
- $section = $this->getArgValue('--section');
- $noColors = $this->isArgProvided('--no-colors');
-
- if ($noColors) {
- $this->warning('โ ๏ธ Color output disabled');
- $this->println();
- }
-
- $this->showHeader();
-
- if ($section) {
- $this->runSection($section, $noColors);
- } else {
- $this->runAllSections($noColors);
- }
-
- $this->showFooter();
-
- return 0;
- }
-
- /**
- * Create a bordered box.
- */
- private function createBox(string $content): void {
- $lines = explode("\n", $content);
- $maxLength = max(array_map('strlen', $lines));
- $width = $maxLength + 4;
-
- // Top border
- $this->prints('โ'.str_repeat('โ', $width - 2).'โ', ['color' => 'cyan']);
- $this->println();
-
- // Content
- foreach ($lines as $line) {
- $this->prints('โ ', ['color' => 'cyan']);
- $this->prints(str_pad($line, $maxLength));
- $this->prints(' โ', ['color' => 'cyan']);
- $this->println();
- }
-
- // Bottom border
- $this->prints('โ'.str_repeat('โ', $width - 2).'โ', ['color' => 'cyan']);
- $this->println();
- }
-
- /**
- * Create a data table with alignment.
- */
- private function createDataTable(): void {
- $data = [
- ['Product', 'Price', 'Stock', 'Status'],
- ['Laptop', '$1,299.99', '15', 'In Stock'],
- ['Mouse', '$29.99', '150', 'In Stock'],
- ['Keyboard', '$89.99', '0', 'Out of Stock'],
- ['Monitor', '$399.99', '8', 'Low Stock']
- ];
-
- $widths = [15, 12, 8, 12];
-
- // Header
- $this->prints('โ');
-
- for ($i = 0; $i < count($widths); $i++) {
- $this->prints(str_repeat('โ', $widths[$i] + 2));
-
- if ($i < count($widths) - 1) {
- $this->prints('โฌ');
- }
- }
- $this->prints('โ');
- $this->println();
-
- // Header row
- $this->prints('โ');
-
- for ($i = 0; $i < count($data[0]); $i++) {
- $this->prints(' ', ['bold' => true]);
- $this->prints(str_pad($data[0][$i], $widths[$i]), ['bold' => true]);
- $this->prints(' โ');
- }
- $this->println();
-
- // Separator
- $this->prints('โ');
-
- for ($i = 0; $i < count($widths); $i++) {
- $this->prints(str_repeat('โ', $widths[$i] + 2));
-
- if ($i < count($widths) - 1) {
- $this->prints('โผ');
- }
- }
- $this->prints('โค');
- $this->println();
-
- // Data rows
- for ($row = 1; $row < count($data); $row++) {
- $this->prints('โ');
-
- for ($col = 0; $col < count($data[$row]); $col++) {
- $this->prints(' ');
-
- $cellData = $data[$row][$col];
- $style = [];
-
- // Color coding for status
- if ($col === 3) {
- if ($cellData === 'In Stock') {
- $style = ['color' => 'green'];
- } elseif ($cellData === 'Out of Stock') {
- $style = ['color' => 'red'];
- } elseif ($cellData === 'Low Stock') {
- $style = ['color' => 'yellow'];
- }
- }
-
- $this->prints(str_pad($cellData, $widths[$col]), $style);
- $this->prints(' โ');
- }
- $this->println();
- }
-
- // Bottom border
- $this->prints('โ');
-
- for ($i = 0; $i < count($widths); $i++) {
- $this->prints(str_repeat('โ', $widths[$i] + 2));
-
- if ($i < count($widths) - 1) {
- $this->prints('โด');
- }
- }
- $this->prints('โ');
- $this->println();
- }
-
- /**
- * Create formatted lists.
- */
- private function createLists(): void {
- // Bulleted list
- $this->println("Bulleted List:");
- $items = ['First item', 'Second item', 'Third item with longer text', 'Fourth item'];
-
- foreach ($items as $item) {
- $this->prints(' โข ', ['color' => 'yellow']);
- $this->println($item);
- }
-
- $this->println();
-
- // Numbered list
- $this->println("Numbered List:");
-
- foreach ($items as $index => $item) {
- $num = $index + 1;
- $this->prints(" $num. ", ['color' => 'cyan', 'bold' => true]);
- $this->println($item);
- }
-
- $this->println();
-
- // Checklist
- $this->println("Checklist:");
- $tasks = [
- ['task' => 'Setup environment', 'done' => true],
- ['task' => 'Write code', 'done' => true],
- ['task' => 'Test application', 'done' => false],
- ['task' => 'Deploy to production', 'done' => false]
- ];
-
- foreach ($tasks as $task) {
- $icon = $task['done'] ? 'โ ' : 'โฌ';
- $style = $task['done'] ? ['color' => 'green'] : ['color' => 'gray'];
-
- $this->prints(" $icon ", $style);
- $this->println($task['task'], $style);
- }
- }
-
- /**
- * Create a simple table.
- */
- private function createSimpleTable(): void {
- $headers = ['Name', 'Age', 'City'];
- $rows = [
- ['Ahmed Hassan', '30', 'Cairo'],
- ['Sarah Johnson', '25', 'Los Angeles'],
- ['Omar Al-Rashid', '35', 'Dubai']
- ];
-
- // Header
- $this->prints('| ');
-
- foreach ($headers as $header) {
- $this->prints(str_pad($header, 12).' | ');
- }
- $this->println();
-
- // Separator
- $this->println('|'.str_repeat('-', 14).'|'.str_repeat('-', 14).'|'.str_repeat('-', 14).'|');
-
- // Rows
- foreach ($rows as $row) {
- $this->prints('| ');
-
- foreach ($row as $cell) {
- $this->prints(str_pad($cell, 12).' | ');
- }
- $this->println();
- }
- }
-
- /**
- * Create a styled table.
- */
- private function createStyledTable(): void {
- $this->prints('โโโโโโโโโโโโโโโฌโโโโโโโโโโฌโโโโโโโโโโโโโ', ['color' => 'blue']);
- $this->println();
-
- $this->prints('โ', ['color' => 'blue']);
- $this->prints(' Name ', ['bold' => true]);
- $this->prints('โ', ['color' => 'blue']);
- $this->prints(' Age ', ['bold' => true]);
- $this->prints('โ', ['color' => 'blue']);
- $this->prints(' Department ', ['bold' => true]);
- $this->prints('โ', ['color' => 'blue']);
- $this->println();
-
- $this->prints('โโโโโโโโโโโโโโโผโโโโโโโโโโผโโโโโโโโโโโโโค', ['color' => 'blue']);
- $this->println();
-
- $data = [
- ['Fatima Al-Zahra', '28', 'Engineering'],
- ['Charlie Davis', '32', 'Marketing'],
- ['Diana Wilson', '29', 'Design']
- ];
-
- foreach ($data as $row) {
- $this->prints('โ', ['color' => 'blue']);
- $this->prints(' '.str_pad($row[0], 11).' ');
- $this->prints('โ', ['color' => 'blue']);
- $this->prints(' '.str_pad($row[1], 7).' ');
- $this->prints('โ', ['color' => 'blue']);
- $this->prints(' '.str_pad($row[2], 10).' ');
- $this->prints('โ', ['color' => 'blue']);
- $this->println();
- }
-
- $this->prints('โโโโโโโโโโโโโโโดโโโโโโโโโโดโโโโโโโโโโโโโ', ['color' => 'blue']);
- $this->println();
- }
-
- /**
- * Create two-column layout.
- */
- private function createTwoColumns(): void {
- $leftColumn = [
- 'Left Column',
- 'โข Item 1',
- 'โข Item 2',
- 'โข Item 3',
- 'โข Item 4'
- ];
-
- $rightColumn = [
- 'Right Column',
- 'โ Feature A',
- 'โ Feature B',
- 'โ Feature C',
- 'โ Feature D'
- ];
-
- $maxRows = max(count($leftColumn), count($rightColumn));
-
- for ($i = 0; $i < $maxRows; $i++) {
- $left = $leftColumn[$i] ?? '';
- $right = $rightColumn[$i] ?? '';
-
- if ($i === 0) {
- $this->prints(str_pad($left, 25), ['bold' => true, 'color' => 'blue']);
- $this->prints(' โ ');
- $this->prints($right, ['bold' => true, 'color' => 'green']);
- } else {
- $this->prints(str_pad($left, 25));
- $this->prints(' โ ');
- $this->prints($right);
- }
- $this->println();
- }
- }
-
- /**
- * Demonstrate animations.
- */
- private function demonstrateAnimations(): void {
- $this->info("๐ฌ Animation Demonstration");
- $this->println();
-
- // Spinner
- $this->println("Spinner Animation:");
- $this->showSpinner(3);
-
- $this->println();
- $this->println();
-
- // Bouncing ball
- $this->println("Bouncing Animation:");
- $this->showBouncingBall();
-
- $this->println();
- $this->println();
-
- // Loading dots
- $this->println("Loading Dots:");
- $this->showLoadingDots();
- }
-
- /**
- * Demonstrate color capabilities.
- */
- private function demonstrateColors(bool $noColors): void {
- $this->info("๐ Color Demonstration");
- $this->println();
-
- if ($noColors) {
- $this->println("Colors disabled - showing plain text versions");
- $this->println();
- }
-
- // Basic colors
- $this->println("Basic Foreground Colors:");
- $colors = ['black', 'red', 'green', 'yellow', 'blue', 'magenta', 'cyan', 'white'];
-
- foreach ($colors as $color) {
- if ($noColors) {
- $this->println(" $color text");
- } else {
- $this->prints(" $color text", ['color' => $color]);
- $this->println();
- }
- }
-
- $this->println();
-
- // Light colors
- $this->println("Light Foreground Colors:");
- $lightColors = ['light-red', 'light-green', 'light-yellow', 'light-blue', 'light-magenta', 'light-cyan'];
-
- foreach ($lightColors as $color) {
- if ($noColors) {
- $this->println(" $color text");
- } else {
- $this->prints(" $color text", ['color' => $color]);
- $this->println();
- }
- }
-
- $this->println();
-
- // Background colors
- $this->println("Background Colors:");
- $bgColors = ['red', 'green', 'yellow', 'blue', 'magenta', 'cyan'];
-
- foreach ($bgColors as $color) {
- if ($noColors) {
- $this->println(" Text with $color background");
- } else {
- $this->prints(" Text with $color background", ['bg-color' => $color, 'color' => 'white']);
- $this->println();
- }
- }
-
- $this->println();
-
- // Color combinations
- $this->println("Color Combinations:");
- $combinations = [
- ['color' => 'white', 'bg-color' => 'red', 'text' => 'Error style'],
- ['color' => 'black', 'bg-color' => 'green', 'text' => 'Success style'],
- ['color' => 'black', 'bg-color' => 'yellow', 'text' => 'Warning style'],
- ['color' => 'white', 'bg-color' => 'blue', 'text' => 'Info style']
- ];
-
- foreach ($combinations as $combo) {
- if ($noColors) {
- $this->println(" ".$combo['text']);
- } else {
- $this->prints(" ".$combo['text'], [
- 'color' => $combo['color'],
- 'bg-color' => $combo['bg-color']
- ]);
- $this->println();
- }
- }
- }
-
- /**
- * Demonstrate layout techniques.
- */
- private function demonstrateLayouts(): void {
- $this->info("๐ Layout Demonstration");
- $this->println();
-
- // Boxes
- $this->println("Bordered Box:");
- $this->createBox("This is content inside a bordered box!\nIt can contain multiple lines\nand various formatting.");
-
- $this->println();
-
- // Columns
- $this->println("Two-Column Layout:");
- $this->createTwoColumns();
-
- $this->println();
-
- // Lists
- $this->println("Formatted Lists:");
- $this->createLists();
- }
-
- /**
- * Demonstrate progress indicators.
- */
- private function demonstrateProgress(): void {
- $this->info("๐ Progress Indicators");
- $this->println();
-
- // Simple progress bar
- $this->println("Simple Progress Bar:");
- $this->showSimpleProgress();
-
- $this->println();
- $this->println();
-
- // Percentage progress
- $this->println("Percentage Progress:");
- $this->showPercentageProgress();
-
- $this->println();
- $this->println();
-
- // Multi-step progress
- $this->println("Multi-step Progress:");
- $this->showMultiStepProgress();
- }
-
- /**
- * Demonstrate text styling.
- */
- private function demonstrateStyles(bool $noColors): void {
- $this->info("โจ Text Styling Demonstration");
- $this->println();
-
- $styles = [
- ['style' => ['bold' => true], 'name' => 'Bold text'],
- ['style' => ['underline' => true], 'name' => 'Underlined text'],
- ['style' => ['bold' => true, 'color' => 'red'], 'name' => 'Bold red text'],
- ['style' => ['underline' => true, 'color' => 'blue'], 'name' => 'Underlined blue text'],
- ['style' => ['bold' => true, 'bg-color' => 'yellow', 'color' => 'black'], 'name' => 'Bold text with background']
- ];
-
- foreach ($styles as $styleDemo) {
- if ($noColors) {
- $this->println(" ".$styleDemo['name']);
- } else {
- $this->prints(" ".$styleDemo['name'], $styleDemo['style']);
- $this->println();
- }
- }
-
- $this->println();
-
- // Message types
- $this->println("Message Types:");
- $this->success("โ Success message");
- $this->error("โ Error message");
- $this->warning("โ ๏ธ Warning message");
- $this->info("โน๏ธ Info message");
- }
-
- /**
- * Demonstrate table formatting.
- */
- private function demonstrateTables(): void {
- $this->info("๐ Table Demonstration");
- $this->println();
-
- // Simple table
- $this->println("Simple Table:");
- $this->createSimpleTable();
-
- $this->println();
-
- // Styled table
- $this->println("Styled Table:");
- $this->createStyledTable();
-
- $this->println();
-
- // Data table
- $this->println("Data Table with Alignment:");
- $this->createDataTable();
- }
-
- /**
- * Run all demonstration sections.
- */
- private function runAllSections(bool $noColors): void {
- $sections = ['colors', 'styles', 'tables', 'progress', 'layouts', 'animations'];
-
- foreach ($sections as $index => $section) {
- $this->runSection($section, $noColors);
-
- if ($index < count($sections) - 1) {
- $this->println();
- $this->println(str_repeat('โ', 60));
- $this->println();
- }
- }
- }
-
- /**
- * Run a specific demonstration section.
- */
- private function runSection(string $section, bool $noColors): void {
- switch ($section) {
- case 'colors':
- $this->demonstrateColors($noColors);
- break;
- case 'styles':
- $this->demonstrateStyles($noColors);
- break;
- case 'tables':
- $this->demonstrateTables();
- break;
- case 'progress':
- $this->demonstrateProgress();
- break;
- case 'layouts':
- $this->demonstrateLayouts();
- break;
- case 'animations':
- $this->demonstrateAnimations();
- break;
- default:
- $this->error("Unknown section: $section");
- }
- }
-
- /**
- * Show bouncing ball animation.
- */
- private function showBouncingBall(): void {
- $width = 30;
- $ball = 'โ';
-
- // Move right
- for ($pos = 0; $pos < $width; $pos++) {
- $spaces = str_repeat(' ', $pos);
- $this->prints("\r$spaces$ball", ['color' => 'red']);
- usleep(100000);
- }
-
- // Move left
- for ($pos = $width; $pos >= 0; $pos--) {
- $spaces = str_repeat(' ', $pos);
- $this->prints("\r$spaces$ball", ['color' => 'blue']);
- usleep(100000);
- }
-
- $this->println();
- }
-
- /**
- * Show the demo footer.
- */
- private function showFooter(): void {
- $this->println();
- $this->success("โจ Formatting demonstration completed!");
- $this->info("๐ก Tip: Use --section= to view specific sections");
- }
-
- /**
- * Show the demo header.
- */
- private function showHeader(): void {
- $this->println("๐จ WebFiori CLI Formatting Demonstration");
- $this->println("========================================");
- $this->println();
- }
-
- /**
- * Show loading dots animation.
- */
- private function showLoadingDots(): void {
- $message = "Loading";
-
- for ($cycle = 0; $cycle < 3; $cycle++) {
- for ($dots = 0; $dots <= 3; $dots++) {
- $dotStr = str_repeat('.', $dots);
- $this->prints("\r$message$dotStr ");
- usleep(500000); // 0.5 seconds
- }
- }
-
- $this->prints("\rLoading complete! โจ", ['color' => 'green']);
- $this->println();
- }
-
- /**
- * Show multi-step progress.
- */
- private function showMultiStepProgress(): void {
- $steps = [
- 'Initializing...',
- 'Loading data...',
- 'Processing...',
- 'Validating...',
- 'Finalizing...'
- ];
-
- foreach ($steps as $index => $step) {
- $stepNum = $index + 1;
- $totalSteps = count($steps);
-
- $this->prints("Step $stepNum/$totalSteps: $step", ['color' => 'blue']);
-
- // Simulate work
- for ($i = 0; $i < 10; $i++) {
- $this->prints('.');
- usleep(200000); // 0.2 seconds
- }
-
- $this->prints(' โ ', ['color' => 'green']);
- $this->println();
- }
-
- $this->success('All steps completed!');
- }
-
- /**
- * Show percentage progress.
- */
- private function showPercentageProgress(): void {
- $total = 100;
-
- for ($i = 0; $i <= $total; $i += 5) {
- $percent = $i;
- $barLength = 30;
- $filled = (int)(($percent / 100) * $barLength);
- $empty = $barLength - $filled;
-
- $bar = str_repeat('โ', $filled).str_repeat('โ', $empty);
-
- echo "\rProgress: [$bar] $percent%";
- flush();
- usleep(150000); // 0.15 seconds
- }
-
- $this->prints(' Done!', ['color' => 'green', 'bold' => true]);
- $this->println();
- }
-
- /**
- * Show simple progress bar.
- */
- private function showSimpleProgress(): void {
- $total = 20;
-
- for ($i = 0; $i <= $total; $i++) {
- $filled = str_repeat('โ', $i);
- $empty = str_repeat('โ', $total - $i);
-
- $this->prints("\r[$filled$empty]");
- usleep(100000); // 0.1 seconds
- }
-
- $this->prints(' Complete!', ['color' => 'green']);
- $this->println();
- }
-
- /**
- * Show spinner animation.
- */
- private function showSpinner(int $duration): void {
- $chars = ['โ ', 'โ ', 'โ น', 'โ ธ', 'โ ผ', 'โ ด', 'โ ฆ', 'โ ง', 'โ ', 'โ '];
- $start = time();
- $i = 0;
-
- while (time() - $start < $duration) {
- $char = $chars[$i % count($chars)];
- $this->prints("\r$char Processing...", ['color' => 'blue']);
- usleep(100000); // 0.1 seconds
- $i++;
- }
-
- $this->prints("\rโ Processing complete!", ['color' => 'green']);
- $this->println();
- }
-}
+ [
+ ArgumentOption::DESCRIPTION => 'Show specific section only',
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::VALUES => ['colors', 'styles', 'tables', 'progress', 'layouts', 'animations']
+ ],
+ '--no-colors' => [
+ ArgumentOption::DESCRIPTION => 'Disable color output',
+ ArgumentOption::OPTIONAL => true
+ ]
+ ], 'Demonstrates various output formatting techniques and ANSI styling');
+ }
+
+ public function exec(): int {
+ $section = $this->getArgValue('--section');
+ $noColors = $this->isArgProvided('--no-colors');
+
+ if ($noColors) {
+ $this->warning('โ ๏ธ Color output disabled');
+ $this->println();
+ }
+
+ $this->showHeader();
+
+ if ($section) {
+ $this->runSection($section, $noColors);
+ } else {
+ $this->runAllSections($noColors);
+ }
+
+ $this->showFooter();
+
+ return 0;
+ }
+
+ /**
+ * Create a bordered box.
+ */
+ private function createBox(string $content): void {
+ $lines = explode("\n", $content);
+ $maxLength = max(array_map('strlen', $lines));
+ $width = $maxLength + 4;
+
+ // Top border
+ $this->prints('โ'.str_repeat('โ', $width - 2).'โ', ['color' => 'cyan']);
+ $this->println();
+
+ // Content
+ foreach ($lines as $line) {
+ $this->prints('โ ', ['color' => 'cyan']);
+ $this->prints(str_pad($line, $maxLength));
+ $this->prints(' โ', ['color' => 'cyan']);
+ $this->println();
+ }
+
+ // Bottom border
+ $this->prints('โ'.str_repeat('โ', $width - 2).'โ', ['color' => 'cyan']);
+ $this->println();
+ }
+
+ /**
+ * Create a data table with alignment.
+ */
+ private function createDataTable(): void {
+ $data = [
+ ['Product', 'Price', 'Stock', 'Status'],
+ ['Laptop', '$1,299.99', '15', 'In Stock'],
+ ['Mouse', '$29.99', '150', 'In Stock'],
+ ['Keyboard', '$89.99', '0', 'Out of Stock'],
+ ['Monitor', '$399.99', '8', 'Low Stock']
+ ];
+
+ $widths = [15, 12, 8, 12];
+
+ // Header
+ $this->prints('โ');
+
+ for ($i = 0; $i < count($widths); $i++) {
+ $this->prints(str_repeat('โ', $widths[$i] + 2));
+
+ if ($i < count($widths) - 1) {
+ $this->prints('โฌ');
+ }
+ }
+ $this->prints('โ');
+ $this->println();
+
+ // Header row
+ $this->prints('โ');
+
+ for ($i = 0; $i < count($data[0]); $i++) {
+ $this->prints(' ', ['bold' => true]);
+ $this->prints(str_pad($data[0][$i], $widths[$i]), ['bold' => true]);
+ $this->prints(' โ');
+ }
+ $this->println();
+
+ // Separator
+ $this->prints('โ');
+
+ for ($i = 0; $i < count($widths); $i++) {
+ $this->prints(str_repeat('โ', $widths[$i] + 2));
+
+ if ($i < count($widths) - 1) {
+ $this->prints('โผ');
+ }
+ }
+ $this->prints('โค');
+ $this->println();
+
+ // Data rows
+ for ($row = 1; $row < count($data); $row++) {
+ $this->prints('โ');
+
+ for ($col = 0; $col < count($data[$row]); $col++) {
+ $this->prints(' ');
+
+ $cellData = $data[$row][$col];
+ $style = [];
+
+ // Color coding for status
+ if ($col === 3) {
+ if ($cellData === 'In Stock') {
+ $style = ['color' => 'green'];
+ } elseif ($cellData === 'Out of Stock') {
+ $style = ['color' => 'red'];
+ } elseif ($cellData === 'Low Stock') {
+ $style = ['color' => 'yellow'];
+ }
+ }
+
+ $this->prints(str_pad($cellData, $widths[$col]), $style);
+ $this->prints(' โ');
+ }
+ $this->println();
+ }
+
+ // Bottom border
+ $this->prints('โ');
+
+ for ($i = 0; $i < count($widths); $i++) {
+ $this->prints(str_repeat('โ', $widths[$i] + 2));
+
+ if ($i < count($widths) - 1) {
+ $this->prints('โด');
+ }
+ }
+ $this->prints('โ');
+ $this->println();
+ }
+
+ /**
+ * Create formatted lists.
+ */
+ private function createLists(): void {
+ // Bulleted list
+ $this->println("Bulleted List:");
+ $items = ['First item', 'Second item', 'Third item with longer text', 'Fourth item'];
+
+ foreach ($items as $item) {
+ $this->prints(' โข ', ['color' => 'yellow']);
+ $this->println($item);
+ }
+
+ $this->println();
+
+ // Numbered list
+ $this->println("Numbered List:");
+
+ foreach ($items as $index => $item) {
+ $num = $index + 1;
+ $this->prints(" $num. ", ['color' => 'cyan', 'bold' => true]);
+ $this->println($item);
+ }
+
+ $this->println();
+
+ // Checklist
+ $this->println("Checklist:");
+ $tasks = [
+ ['task' => 'Setup environment', 'done' => true],
+ ['task' => 'Write code', 'done' => true],
+ ['task' => 'Test application', 'done' => false],
+ ['task' => 'Deploy to production', 'done' => false]
+ ];
+
+ foreach ($tasks as $task) {
+ $icon = $task['done'] ? 'โ ' : 'โฌ';
+ $style = $task['done'] ? ['color' => 'green'] : ['color' => 'gray'];
+
+ $this->prints(" $icon ", $style);
+ $this->println($task['task'], $style);
+ }
+ }
+
+ /**
+ * Create a simple table.
+ */
+ private function createSimpleTable(): void {
+ $headers = ['Name', 'Age', 'City'];
+ $rows = [
+ ['Ahmed Hassan', '30', 'Cairo'],
+ ['Sarah Johnson', '25', 'Los Angeles'],
+ ['Omar Al-Rashid', '35', 'Dubai']
+ ];
+
+ // Header
+ $this->prints('| ');
+
+ foreach ($headers as $header) {
+ $this->prints(str_pad($header, 12).' | ');
+ }
+ $this->println();
+
+ // Separator
+ $this->println('|'.str_repeat('-', 14).'|'.str_repeat('-', 14).'|'.str_repeat('-', 14).'|');
+
+ // Rows
+ foreach ($rows as $row) {
+ $this->prints('| ');
+
+ foreach ($row as $cell) {
+ $this->prints(str_pad($cell, 12).' | ');
+ }
+ $this->println();
+ }
+ }
+
+ /**
+ * Create a styled table.
+ */
+ private function createStyledTable(): void {
+ $this->prints('โโโโโโโโโโโโโโโฌโโโโโโโโโโฌโโโโโโโโโโโโโ', ['color' => 'blue']);
+ $this->println();
+
+ $this->prints('โ', ['color' => 'blue']);
+ $this->prints(' Name ', ['bold' => true]);
+ $this->prints('โ', ['color' => 'blue']);
+ $this->prints(' Age ', ['bold' => true]);
+ $this->prints('โ', ['color' => 'blue']);
+ $this->prints(' Department ', ['bold' => true]);
+ $this->prints('โ', ['color' => 'blue']);
+ $this->println();
+
+ $this->prints('โโโโโโโโโโโโโโโผโโโโโโโโโโผโโโโโโโโโโโโโค', ['color' => 'blue']);
+ $this->println();
+
+ $data = [
+ ['Fatima Al-Zahra', '28', 'Engineering'],
+ ['Charlie Davis', '32', 'Marketing'],
+ ['Diana Wilson', '29', 'Design']
+ ];
+
+ foreach ($data as $row) {
+ $this->prints('โ', ['color' => 'blue']);
+ $this->prints(' '.str_pad($row[0], 11).' ');
+ $this->prints('โ', ['color' => 'blue']);
+ $this->prints(' '.str_pad($row[1], 7).' ');
+ $this->prints('โ', ['color' => 'blue']);
+ $this->prints(' '.str_pad($row[2], 10).' ');
+ $this->prints('โ', ['color' => 'blue']);
+ $this->println();
+ }
+
+ $this->prints('โโโโโโโโโโโโโโโดโโโโโโโโโโดโโโโโโโโโโโโโ', ['color' => 'blue']);
+ $this->println();
+ }
+
+ /**
+ * Create two-column layout.
+ */
+ private function createTwoColumns(): void {
+ $leftColumn = [
+ 'Left Column',
+ 'โข Item 1',
+ 'โข Item 2',
+ 'โข Item 3',
+ 'โข Item 4'
+ ];
+
+ $rightColumn = [
+ 'Right Column',
+ 'โ Feature A',
+ 'โ Feature B',
+ 'โ Feature C',
+ 'โ Feature D'
+ ];
+
+ $maxRows = max(count($leftColumn), count($rightColumn));
+
+ for ($i = 0; $i < $maxRows; $i++) {
+ $left = $leftColumn[$i] ?? '';
+ $right = $rightColumn[$i] ?? '';
+
+ if ($i === 0) {
+ $this->prints(str_pad($left, 25), ['bold' => true, 'color' => 'blue']);
+ $this->prints(' โ ');
+ $this->prints($right, ['bold' => true, 'color' => 'green']);
+ } else {
+ $this->prints(str_pad($left, 25));
+ $this->prints(' โ ');
+ $this->prints($right);
+ }
+ $this->println();
+ }
+ }
+
+ /**
+ * Demonstrate animations.
+ */
+ private function demonstrateAnimations(): void {
+ $this->info("๐ฌ Animation Demonstration");
+ $this->println();
+
+ // Spinner
+ $this->println("Spinner Animation:");
+ $this->showSpinner(3);
+
+ $this->println();
+ $this->println();
+
+ // Bouncing ball
+ $this->println("Bouncing Animation:");
+ $this->showBouncingBall();
+
+ $this->println();
+ $this->println();
+
+ // Loading dots
+ $this->println("Loading Dots:");
+ $this->showLoadingDots();
+ }
+
+ /**
+ * Demonstrate color capabilities.
+ */
+ private function demonstrateColors(bool $noColors): void {
+ $this->info("๐ Color Demonstration");
+ $this->println();
+
+ if ($noColors) {
+ $this->println("Colors disabled - showing plain text versions");
+ $this->println();
+ }
+
+ // Basic colors
+ $this->println("Basic Foreground Colors:");
+ $colors = ['black', 'red', 'green', 'yellow', 'blue', 'magenta', 'cyan', 'white'];
+
+ foreach ($colors as $color) {
+ if ($noColors) {
+ $this->println(" $color text");
+ } else {
+ $this->prints(" $color text", ['color' => $color]);
+ $this->println();
+ }
+ }
+
+ $this->println();
+
+ // Light colors
+ $this->println("Light Foreground Colors:");
+ $lightColors = ['light-red', 'light-green', 'light-yellow', 'light-blue', 'light-magenta', 'light-cyan'];
+
+ foreach ($lightColors as $color) {
+ if ($noColors) {
+ $this->println(" $color text");
+ } else {
+ $this->prints(" $color text", ['color' => $color]);
+ $this->println();
+ }
+ }
+
+ $this->println();
+
+ // Background colors
+ $this->println("Background Colors:");
+ $bgColors = ['red', 'green', 'yellow', 'blue', 'magenta', 'cyan'];
+
+ foreach ($bgColors as $color) {
+ if ($noColors) {
+ $this->println(" Text with $color background");
+ } else {
+ $this->prints(" Text with $color background", ['bg-color' => $color, 'color' => 'white']);
+ $this->println();
+ }
+ }
+
+ $this->println();
+
+ // Color combinations
+ $this->println("Color Combinations:");
+ $combinations = [
+ ['color' => 'white', 'bg-color' => 'red', 'text' => 'Error style'],
+ ['color' => 'black', 'bg-color' => 'green', 'text' => 'Success style'],
+ ['color' => 'black', 'bg-color' => 'yellow', 'text' => 'Warning style'],
+ ['color' => 'white', 'bg-color' => 'blue', 'text' => 'Info style']
+ ];
+
+ foreach ($combinations as $combo) {
+ if ($noColors) {
+ $this->println(" ".$combo['text']);
+ } else {
+ $this->prints(" ".$combo['text'], [
+ 'color' => $combo['color'],
+ 'bg-color' => $combo['bg-color']
+ ]);
+ $this->println();
+ }
+ }
+ }
+
+ /**
+ * Demonstrate layout techniques.
+ */
+ private function demonstrateLayouts(): void {
+ $this->info("๐ Layout Demonstration");
+ $this->println();
+
+ // Boxes
+ $this->println("Bordered Box:");
+ $this->createBox("This is content inside a bordered box!\nIt can contain multiple lines\nand various formatting.");
+
+ $this->println();
+
+ // Columns
+ $this->println("Two-Column Layout:");
+ $this->createTwoColumns();
+
+ $this->println();
+
+ // Lists
+ $this->println("Formatted Lists:");
+ $this->createLists();
+ }
+
+ /**
+ * Demonstrate progress indicators.
+ */
+ private function demonstrateProgress(): void {
+ $this->info("๐ Progress Indicators");
+ $this->println();
+
+ // Simple progress bar
+ $this->println("Simple Progress Bar:");
+ $this->showSimpleProgress();
+
+ $this->println();
+ $this->println();
+
+ // Percentage progress
+ $this->println("Percentage Progress:");
+ $this->showPercentageProgress();
+
+ $this->println();
+ $this->println();
+
+ // Multi-step progress
+ $this->println("Multi-step Progress:");
+ $this->showMultiStepProgress();
+ }
+
+ /**
+ * Demonstrate text styling.
+ */
+ private function demonstrateStyles(bool $noColors): void {
+ $this->info("โจ Text Styling Demonstration");
+ $this->println();
+
+ $styles = [
+ ['style' => ['bold' => true], 'name' => 'Bold text'],
+ ['style' => ['underline' => true], 'name' => 'Underlined text'],
+ ['style' => ['bold' => true, 'color' => 'red'], 'name' => 'Bold red text'],
+ ['style' => ['underline' => true, 'color' => 'blue'], 'name' => 'Underlined blue text'],
+ ['style' => ['bold' => true, 'bg-color' => 'yellow', 'color' => 'black'], 'name' => 'Bold text with background']
+ ];
+
+ foreach ($styles as $styleDemo) {
+ if ($noColors) {
+ $this->println(" ".$styleDemo['name']);
+ } else {
+ $this->prints(" ".$styleDemo['name'], $styleDemo['style']);
+ $this->println();
+ }
+ }
+
+ $this->println();
+
+ // Message types
+ $this->println("Message Types:");
+ $this->success("โ Success message");
+ $this->error("โ Error message");
+ $this->warning("โ ๏ธ Warning message");
+ $this->info("โน๏ธ Info message");
+ }
+
+ /**
+ * Demonstrate table formatting.
+ */
+ private function demonstrateTables(): void {
+ $this->info("๐ Table Demonstration");
+ $this->println();
+
+ // Simple table
+ $this->println("Simple Table:");
+ $this->createSimpleTable();
+
+ $this->println();
+
+ // Styled table
+ $this->println("Styled Table:");
+ $this->createStyledTable();
+
+ $this->println();
+
+ // Data table
+ $this->println("Data Table with Alignment:");
+ $this->createDataTable();
+ }
+
+ /**
+ * Run all demonstration sections.
+ */
+ private function runAllSections(bool $noColors): void {
+ $sections = ['colors', 'styles', 'tables', 'progress', 'layouts', 'animations'];
+
+ foreach ($sections as $index => $section) {
+ $this->runSection($section, $noColors);
+
+ if ($index < count($sections) - 1) {
+ $this->println();
+ $this->println(str_repeat('โ', 60));
+ $this->println();
+ }
+ }
+ }
+
+ /**
+ * Run a specific demonstration section.
+ */
+ private function runSection(string $section, bool $noColors): void {
+ switch ($section) {
+ case 'colors':
+ $this->demonstrateColors($noColors);
+ break;
+ case 'styles':
+ $this->demonstrateStyles($noColors);
+ break;
+ case 'tables':
+ $this->demonstrateTables();
+ break;
+ case 'progress':
+ $this->demonstrateProgress();
+ break;
+ case 'layouts':
+ $this->demonstrateLayouts();
+ break;
+ case 'animations':
+ $this->demonstrateAnimations();
+ break;
+ default:
+ $this->error("Unknown section: $section");
+ }
+ }
+
+ /**
+ * Show bouncing ball animation.
+ */
+ private function showBouncingBall(): void {
+ $width = 30;
+ $ball = 'โ';
+
+ // Move right
+ for ($pos = 0; $pos < $width; $pos++) {
+ $spaces = str_repeat(' ', $pos);
+ $this->prints("\r$spaces$ball", ['color' => 'red']);
+ usleep(100000);
+ }
+
+ // Move left
+ for ($pos = $width; $pos >= 0; $pos--) {
+ $spaces = str_repeat(' ', $pos);
+ $this->prints("\r$spaces$ball", ['color' => 'blue']);
+ usleep(100000);
+ }
+
+ $this->println();
+ }
+
+ /**
+ * Show the demo footer.
+ */
+ private function showFooter(): void {
+ $this->println();
+ $this->success("โจ Formatting demonstration completed!");
+ $this->info("๐ก Tip: Use --section= to view specific sections");
+ }
+
+ /**
+ * Show the demo header.
+ */
+ private function showHeader(): void {
+ $this->println("๐จ WebFiori CLI Formatting Demonstration");
+ $this->println("========================================");
+ $this->println();
+ }
+
+ /**
+ * Show loading dots animation.
+ */
+ private function showLoadingDots(): void {
+ $message = "Loading";
+
+ for ($cycle = 0; $cycle < 3; $cycle++) {
+ for ($dots = 0; $dots <= 3; $dots++) {
+ $dotStr = str_repeat('.', $dots);
+ $this->prints("\r$message$dotStr ");
+ usleep(500000); // 0.5 seconds
+ }
+ }
+
+ $this->prints("\rLoading complete! โจ", ['color' => 'green']);
+ $this->println();
+ }
+
+ /**
+ * Show multi-step progress.
+ */
+ private function showMultiStepProgress(): void {
+ $steps = [
+ 'Initializing...',
+ 'Loading data...',
+ 'Processing...',
+ 'Validating...',
+ 'Finalizing...'
+ ];
+
+ foreach ($steps as $index => $step) {
+ $stepNum = $index + 1;
+ $totalSteps = count($steps);
+
+ $this->prints("Step $stepNum/$totalSteps: $step", ['color' => 'blue']);
+
+ // Simulate work
+ for ($i = 0; $i < 10; $i++) {
+ $this->prints('.');
+ usleep(200000); // 0.2 seconds
+ }
+
+ $this->prints(' โ ', ['color' => 'green']);
+ $this->println();
+ }
+
+ $this->success('All steps completed!');
+ }
+
+ /**
+ * Show percentage progress.
+ */
+ private function showPercentageProgress(): void {
+ $total = 100;
+
+ for ($i = 0; $i <= $total; $i += 5) {
+ $percent = $i;
+ $barLength = 30;
+ $filled = (int)(($percent / 100) * $barLength);
+ $empty = $barLength - $filled;
+
+ $bar = str_repeat('โ', $filled).str_repeat('โ', $empty);
+
+ echo "\rProgress: [$bar] $percent%";
+ flush();
+ usleep(150000); // 0.15 seconds
+ }
+
+ $this->prints(' Done!', ['color' => 'green', 'bold' => true]);
+ $this->println();
+ }
+
+ /**
+ * Show simple progress bar.
+ */
+ private function showSimpleProgress(): void {
+ $total = 20;
+
+ for ($i = 0; $i <= $total; $i++) {
+ $filled = str_repeat('โ', $i);
+ $empty = str_repeat('โ', $total - $i);
+
+ $this->prints("\r[$filled$empty]");
+ usleep(100000); // 0.1 seconds
+ }
+
+ $this->prints(' Complete!', ['color' => 'green']);
+ $this->println();
+ }
+
+ /**
+ * Show spinner animation.
+ */
+ private function showSpinner(int $duration): void {
+ $chars = ['โ ', 'โ ', 'โ น', 'โ ธ', 'โ ผ', 'โ ด', 'โ ฆ', 'โ ง', 'โ ', 'โ '];
+ $start = time();
+ $i = 0;
+
+ while (time() - $start < $duration) {
+ $char = $chars[$i % count($chars)];
+ $this->prints("\r$char Processing...", ['color' => 'blue']);
+ usleep(100000); // 0.1 seconds
+ $i++;
+ }
+
+ $this->prints("\rโ Processing complete!", ['color' => 'green']);
+ $this->println();
+ }
+}
diff --git a/examples/04-output-formatting/README.md b/examples/04-output-formatting/README.md
index a9038e1..d5298bb 100644
--- a/examples/04-output-formatting/README.md
+++ b/examples/04-output-formatting/README.md
@@ -1,586 +1,586 @@
-# Output Formatting Example
-
-This example demonstrates comprehensive output formatting and ANSI styling techniques using WebFiori CLI library.
-
-## Features Demonstrated
-
-- ANSI color support (basic, light, background colors)
-- Text styling (bold, underlined, combinations)
-- Message types with icons (success, error, warning, info)
-- Table formatting (simple, styled, aligned)
-- Progress indicators (bars, percentages, multi-step)
-- Layout techniques (boxes, columns, lists)
-- Animations (spinners, bouncing, loading dots)
-- Color control and section filtering
-
-## Files
-
-- `main.php` - Application entry point and runner setup
-- `FormattingDemoCommand.php` - Comprehensive formatting demonstration
-
-## Usage Examples
-
-### General Help
-```bash
-php main.php
-# or
-php main.php help
-```
-**Output:**
-```
-Usage:
- command [arg1 arg2="val" arg3...]
-
-Global Arguments:
- --ansi:[Optional] Force the use of ANSI output.
-Available Commands:
- help: Display CLI Help. To display help for specific command, use the argument "--command" with this command.
- format-demo: Demonstrates various output formatting techniques and ANSI styling
-```
-
-### Show Format Demo Help
-```bash
-php main.php help --command=format-demo
-```
-**Output:**
-```
- format-demo: Demonstrates various output formatting techniques and ANSI styling
- Supported Arguments:
- --section:[Optional] Show specific section only
- --no-colors:[Optional] Disable color output
-```
-
-## Full Formatting Demonstration
-
-### Complete Demo
-```bash
-php main.php format-demo
-```
-**Output:**
-```
-๐จ WebFiori CLI Formatting Demonstration
-========================================
-
-๐ Color Demonstration
-
-Basic Foreground Colors:
- black text
- red text
- green text
- yellow text
- blue text
- magenta text
- cyan text
- white text
-
-Light Foreground Colors:
- light-red text
- light-green text
- light-yellow text
- light-blue text
- light-magenta text
- light-cyan text
-
-Background Colors:
- Text with red background
- Text with green background
- Text with yellow background
- Text with blue background
- Text with magenta background
- Text with cyan background
-
-Color Combinations:
- Error style
- Success style
- Warning style
- Info style
-
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-
-โจ Text Styling Demonstration
-
- Bold text
- Underlined text
- Bold red text
- Underlined blue text
- Bold text with background
-
-Message Types:
-โ Success message
-โ Error message
-โ ๏ธ Warning message
-โน๏ธ Info message
-
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-
-๐ Table Demonstration
-
-Simple Table:
-| Name | Age | City |
-|--------------|--------------|--------------|
-| Ahmed Hassan | 30 | Cairo |
-| Fatima Ali | 25 | Dubai |
-| Mohammed Omar| 35 | Riyadh |
-
-Styled Table:
-โโโโโโโโโโโโโโโฌโโโโโโโโโโฌโโโโโโโโโโโโโ
-โ Name โ Age โ Department โ
-โโโโโโโโโโโโโโโผโโโโโโโโโโผโโโโโโโโโโโโโค
-โ Sara Ahmed โ 28 โ Engineering โ
-โ Omar Khalil โ 32 โ Marketing โ
-โ Layla Hassanโ 29 โ Design โ
-โโโโโโโโโโโโโโโดโโโโโโโโโโดโโโโโโโโโโโโโ
-
-Data Table with Alignment:
-โโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโฌโโโโโโโโโโโฌโโโโโโโโโโโโโโโ
-โ Product โ Price โ Stock โ Status โ
-โโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโผโโโโโโโโโโโผโโโโโโโโโโโโโโโค
-โ Laptop โ $1,299.99 โ 15 โ In Stock โ
-โ Mouse โ $29.99 โ 150 โ In Stock โ
-โ Keyboard โ $89.99 โ 0 โ Out of Stock โ
-โ Monitor โ $399.99 โ 8 โ Low Stock โ
-โโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโดโโโโโโโโโโโดโโโโโโโโโโโโโโโ
-
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-
-๐ Progress Indicators
-
-Simple Progress Bar:
-[โโโโโโโโโโโโโโโโโโโโ] Complete!
-
-Percentage Progress:
-Progress: [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 100% Done!
-
-Multi-step Progress:
-Step 1/5: Initializing............. โ
-Step 2/5: Loading data............. โ
-Step 3/5: Processing............. โ
-Step 4/5: Validating............. โ
-Step 5/5: Finalizing............. โ
-โ All steps completed!
-
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-
-๐ Layout Demonstration
-
-Bordered Box:
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-โ This is content inside a bordered box! โ
-โ It can contain multiple lines โ
-โ and various formatting. โ
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-
-Two-Column Layout:
-Left Column โ Right Column
-โข Item 1 โ โ Feature A
-โข Item 2 โ โ Feature B
-โข Item 3 โ โ Feature C
-โข Item 4 โ โ Feature D
-
-Formatted Lists:
-Bulleted List:
- โข First item
- โข Second item
- โข Third item with longer text
- โข Fourth item
-
-Numbered List:
- 1. First item
- 2. Second item
- 3. Third item with longer text
- 4. Fourth item
-
-Checklist:
- โ Setup environment
- โ Write code
- โฌ Test application
- โฌ Deploy to production
-
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-
-๐ฌ Animation Demonstration
-
-Spinner Animation:
-โ Processing... โ โ Processing complete!
-
-Bouncing Animation:
-โ (bounces left to right and back)
-
-Loading Dots:
-Loading... โ Loading complete! โจ
-
-โจ Formatting demonstration completed!
-๐ก Tip: Use --section= to view specific sections
-```
-
-## Section-Specific Demonstrations
-
-### Colors Section
-```bash
-php main.php format-demo --section=colors
-```
-**Output:**
-```
-๐จ WebFiori CLI Formatting Demonstration
-========================================
-
-๐ Color Demonstration
-
-Basic Foreground Colors:
- black text
- red text
- green text
- yellow text
- blue text
- magenta text
- cyan text
- white text
-
-Light Foreground Colors:
- light-red text
- light-green text
- light-yellow text
- light-blue text
- light-magenta text
- light-cyan text
-
-Background Colors:
- Text with red background
- Text with green background
- Text with yellow background
- Text with blue background
- Text with magenta background
- Text with cyan background
-
-Color Combinations:
- Error style
- Success style
- Warning style
- Info style
-
-โจ Formatting demonstration completed!
-๐ก Tip: Use --section= to view specific sections
-```
-
-### Styles Section
-```bash
-php main.php format-demo --section=styles
-```
-**Output:**
-```
-๐จ WebFiori CLI Formatting Demonstration
-========================================
-
-โจ Text Styling Demonstration
-
- Bold text
- Underlined text
- Bold red text
- Underlined blue text
- Bold text with background
-
-Message Types:
-โ Success message
-โ Error message
-โ ๏ธ Warning message
-โน๏ธ Info message
-
-โจ Formatting demonstration completed!
-๐ก Tip: Use --section= to view specific sections
-```
-
-### Tables Section
-```bash
-php main.php format-demo --section=tables
-```
-**Output:**
-```
-๐จ WebFiori CLI Formatting Demonstration
-========================================
-
-๐ Table Demonstration
-
-Simple Table:
-| Name | Age | City |
-|--------------|--------------|--------------|
-| Ahmed Hassan | 30 | Cairo |
-| Fatima Ali | 25 | Dubai |
-| Mohammed Omar| 35 | Riyadh |
-
-Styled Table:
-โโโโโโโโโโโโโโโฌโโโโโโโโโโฌโโโโโโโโโโโโโ
-โ Name โ Age โ Department โ
-โโโโโโโโโโโโโโโผโโโโโโโโโโผโโโโโโโโโโโโโค
-โ Sara Ahmed โ 28 โ Engineering โ
-โ Omar Khalil โ 32 โ Marketing โ
-โ Layla Hassanโ 29 โ Design โ
-โโโโโโโโโโโโโโโดโโโโโโโโโโดโโโโโโโโโโโโโ
-
-Data Table with Alignment:
-โโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโฌโโโโโโโโโโโฌโโโโโโโโโโโโโโโ
-โ Product โ Price โ Stock โ Status โ
-โโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโผโโโโโโโโโโโผโโโโโโโโโโโโโโโค
-โ Laptop โ $1,299.99 โ 15 โ In Stock โ
-โ Mouse โ $29.99 โ 150 โ In Stock โ
-โ Keyboard โ $89.99 โ 0 โ Out of Stock โ
-โ Monitor โ $399.99 โ 8 โ Low Stock โ
-โโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโดโโโโโโโโโโโดโโโโโโโโโโโโโโโ
-
-โจ Formatting demonstration completed!
-๐ก Tip: Use --section= to view specific sections
-```
-
-### Progress Section
-```bash
-php main.php format-demo --section=progress
-```
-**Output:**
-```
-๐จ WebFiori CLI Formatting Demonstration
-========================================
-
-๐ Progress Indicators
-
-Simple Progress Bar:
-[โโโโโโโโโโโโโโโโโโโโ] Complete!
-
-Percentage Progress:
-Progress: [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 100% Done!
-
-Multi-step Progress:
-Step 1/5: Initializing............. โ
-Step 2/5: Loading data............. โ
-Step 3/5: Processing............. โ
-Step 4/5: Validating............. โ
-Step 5/5: Finalizing............. โ
-โ All steps completed!
-
-โจ Formatting demonstration completed!
-๐ก Tip: Use --section= to view specific sections
-```
-
-### Layouts Section
-```bash
-php main.php format-demo --section=layouts
-```
-**Output:**
-```
-๐จ WebFiori CLI Formatting Demonstration
-========================================
-
-๐ Layout Demonstration
-
-Bordered Box:
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-โ This is content inside a bordered box! โ
-โ It can contain multiple lines โ
-โ and various formatting. โ
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-
-Two-Column Layout:
-Left Column โ Right Column
-โข Item 1 โ โ Feature A
-โข Item 2 โ โ Feature B
-โข Item 3 โ โ Feature C
-โข Item 4 โ โ Feature D
-
-Formatted Lists:
-Bulleted List:
- โข First item
- โข Second item
- โข Third item with longer text
- โข Fourth item
-
-Numbered List:
- 1. First item
- 2. Second item
- 3. Third item with longer text
- 4. Fourth item
-
-Checklist:
- โ Setup environment
- โ Write code
- โฌ Test application
- โฌ Deploy to production
-
-โจ Formatting demonstration completed!
-๐ก Tip: Use --section= to view specific sections
-```
-
-### Animations Section
-```bash
-php main.php format-demo --section=animations
-```
-**Output:**
-```
-๐จ WebFiori CLI Formatting Demonstration
-========================================
-
-๐ฌ Animation Demonstration
-
-Spinner Animation:
-โ Processing... โ โ Processing complete!
-
-Bouncing Animation:
-โ (bounces left to right and back)
-
-Loading Dots:
-Loading... โ Loading complete! โจ
-
-โจ Formatting demonstration completed!
-๐ก Tip: Use --section= to view specific sections
-```
-
-## Advanced Options
-
-### Disable Colors
-```bash
-php main.php format-demo --section=colors --no-colors
-```
-**Output:**
-```
-โ ๏ธ Color output disabled
-
-๐จ WebFiori CLI Formatting Demonstration
-========================================
-
-๐ Color Demonstration
-
-Colors disabled - showing plain text versions
-
-Basic Foreground Colors:
- black text
- red text
- green text
- yellow text
- blue text
- magenta text
- cyan text
- white text
-
-[... continues with plain text versions ...]
-
-โจ Formatting demonstration completed!
-๐ก Tip: Use --section= to view specific sections
-```
-
-## Error Handling Examples
-
-### Invalid Section
-```bash
-php main.php format-demo --section=invalid
-```
-**Output:**
-```
-Error: The following argument(s) have invalid values: '--section'
-Info: Allowed values for the argument '--section':
-colors
-styles
-tables
-progress
-layouts
-animations
-```
-
-### Invalid Command
-```bash
-php main.php invalid
-```
-**Output:**
-```
-Error: The command 'invalid' is not supported.
-```
-
-## Key Learning Points
-
-1. **ANSI Colors**: 8 basic + 6 light foreground colors, 6 background colors
-2. **Text Styling**: Bold, underlined, and combination formatting
-3. **Message Types**: Consistent styling for success, error, warning, info
-4. **Table Formatting**: Simple markdown, Unicode box-drawing, data alignment
-5. **Progress Indicators**: Visual feedback for long-running operations
-6. **Layout Techniques**: Boxes, columns, lists for structured output
-7. **Animations**: Dynamic visual elements for better user experience
-8. **Color Control**: Ability to disable colors for plain text environments
-9. **Section Filtering**: View specific formatting categories
-10. **Unicode Support**: Emojis, box-drawing characters, special symbols
-
-## Code Structure Examples
-
-### Format Demo Command Structure
-```php
-class FormattingDemoCommand extends Command {
- public function __construct() {
- parent::__construct('format-demo', [
- '--section' => [
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::VALUES => ['colors', 'styles', 'tables', 'progress', 'layouts', 'animations'],
- ArgumentOption::DESCRIPTION => 'Show specific section only'
- ],
- '--no-colors' => [
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DESCRIPTION => 'Disable color output'
- ]
- ], 'Demonstrates various output formatting techniques and ANSI styling');
- }
-
- public function exec(): int {
- $section = $this->getArgValue('--section');
- $noColors = $this->isArgProvided('--no-colors');
-
- if ($noColors) {
- $this->warning('โ ๏ธ Color output disabled');
- $this->println();
- }
-
- $this->showHeader();
-
- if ($section) {
- $this->showSection($section, $noColors);
- } else {
- $this->showAllSections($noColors);
- }
-
- $this->showFooter();
- return 0;
- }
-}
-```
-
-### Animation Implementation
-```php
-private function showSpinnerAnimation(): void {
- $frames = ['โ ', 'โ ', 'โ น', 'โ ธ', 'โ ผ', 'โ ด', 'โ ฆ', 'โ ง', 'โ ', 'โ '];
-
- for ($i = 0; $i < 30; $i++) {
- $frame = $frames[$i % count($frames)];
- $this->prints("\r$frame Processing...");
- usleep(100000); // 0.1 seconds
- }
-
- $this->println("\rโ Processing complete!");
-}
-```
-
-This example demonstrates professional CLI output formatting suitable for creating visually appealing and user-friendly command-line applications.
-
-## Related Examples
-
-### Prerequisites
-- **[01-basic-hello-world](../01-basic-hello-world/)** - Basic command and output concepts
-
-### Enhanced Output Features
-- **[06-table-display](../06-table-display/)** - Structured data in formatted tables
-- **[07-progress-bars](../07-progress-bars/)** - Professional progress indicators
-- **[05-interactive-commands](../05-interactive-commands/)** - Interactive menus with formatting
-
-### Input with Formatting
-- **[03-user-input](../03-user-input/)** - User input with formatted prompts
-- **[11-masked-input](../11-masked-input/)** - Secure input with visual feedback
-
-### Complete Applications
-- **[10-multi-command-app](../10-multi-command-app/)** - Full applications with consistent formatting
-- **[09-database-ops](../09-database-ops/)** - Database operations with formatted output
-- **[08-file-processing](../08-file-processing/)** - File operations with status formatting
-
-### Development Tools
-- **[12-command-scaffolding](../12-command-scaffolding/)** - Generate commands with formatting templates
+# Output Formatting Example
+
+This example demonstrates comprehensive output formatting and ANSI styling techniques using WebFiori CLI library.
+
+## Features Demonstrated
+
+- ANSI color support (basic, light, background colors)
+- Text styling (bold, underlined, combinations)
+- Message types with icons (success, error, warning, info)
+- Table formatting (simple, styled, aligned)
+- Progress indicators (bars, percentages, multi-step)
+- Layout techniques (boxes, columns, lists)
+- Animations (spinners, bouncing, loading dots)
+- Color control and section filtering
+
+## Files
+
+- `main.php` - Application entry point and runner setup
+- `FormattingDemoCommand.php` - Comprehensive formatting demonstration
+
+## Usage Examples
+
+### General Help
+```bash
+php main.php
+# or
+php main.php help
+```
+**Output:**
+```
+Usage:
+ command [arg1 arg2="val" arg3...]
+
+Global Arguments:
+ --ansi:[Optional] Force the use of ANSI output.
+Available Commands:
+ help: Display CLI Help. To display help for specific command, use the argument "--command" with this command.
+ format-demo: Demonstrates various output formatting techniques and ANSI styling
+```
+
+### Show Format Demo Help
+```bash
+php main.php help --command=format-demo
+```
+**Output:**
+```
+ format-demo: Demonstrates various output formatting techniques and ANSI styling
+ Supported Arguments:
+ --section:[Optional] Show specific section only
+ --no-colors:[Optional] Disable color output
+```
+
+## Full Formatting Demonstration
+
+### Complete Demo
+```bash
+php main.php format-demo
+```
+**Output:**
+```
+๐จ WebFiori CLI Formatting Demonstration
+========================================
+
+๐ Color Demonstration
+
+Basic Foreground Colors:
+ black text
+ red text
+ green text
+ yellow text
+ blue text
+ magenta text
+ cyan text
+ white text
+
+Light Foreground Colors:
+ light-red text
+ light-green text
+ light-yellow text
+ light-blue text
+ light-magenta text
+ light-cyan text
+
+Background Colors:
+ Text with red background
+ Text with green background
+ Text with yellow background
+ Text with blue background
+ Text with magenta background
+ Text with cyan background
+
+Color Combinations:
+ Error style
+ Success style
+ Warning style
+ Info style
+
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+
+โจ Text Styling Demonstration
+
+ Bold text
+ Underlined text
+ Bold red text
+ Underlined blue text
+ Bold text with background
+
+Message Types:
+โ Success message
+โ Error message
+โ ๏ธ Warning message
+โน๏ธ Info message
+
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+
+๐ Table Demonstration
+
+Simple Table:
+| Name | Age | City |
+|--------------|--------------|--------------|
+| Ahmed Hassan | 30 | Cairo |
+| Fatima Ali | 25 | Dubai |
+| Mohammed Omar| 35 | Riyadh |
+
+Styled Table:
+โโโโโโโโโโโโโโโฌโโโโโโโโโโฌโโโโโโโโโโโโโ
+โ Name โ Age โ Department โ
+โโโโโโโโโโโโโโโผโโโโโโโโโโผโโโโโโโโโโโโโค
+โ Sara Ahmed โ 28 โ Engineering โ
+โ Omar Khalil โ 32 โ Marketing โ
+โ Layla Hassanโ 29 โ Design โ
+โโโโโโโโโโโโโโโดโโโโโโโโโโดโโโโโโโโโโโโโ
+
+Data Table with Alignment:
+โโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโฌโโโโโโโโโโโฌโโโโโโโโโโโโโโโ
+โ Product โ Price โ Stock โ Status โ
+โโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโผโโโโโโโโโโโผโโโโโโโโโโโโโโโค
+โ Laptop โ $1,299.99 โ 15 โ In Stock โ
+โ Mouse โ $29.99 โ 150 โ In Stock โ
+โ Keyboard โ $89.99 โ 0 โ Out of Stock โ
+โ Monitor โ $399.99 โ 8 โ Low Stock โ
+โโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโดโโโโโโโโโโโดโโโโโโโโโโโโโโโ
+
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+
+๐ Progress Indicators
+
+Simple Progress Bar:
+[โโโโโโโโโโโโโโโโโโโโ] Complete!
+
+Percentage Progress:
+Progress: [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 100% Done!
+
+Multi-step Progress:
+Step 1/5: Initializing............. โ
+Step 2/5: Loading data............. โ
+Step 3/5: Processing............. โ
+Step 4/5: Validating............. โ
+Step 5/5: Finalizing............. โ
+โ All steps completed!
+
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+
+๐ Layout Demonstration
+
+Bordered Box:
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+โ This is content inside a bordered box! โ
+โ It can contain multiple lines โ
+โ and various formatting. โ
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+
+Two-Column Layout:
+Left Column โ Right Column
+โข Item 1 โ โ Feature A
+โข Item 2 โ โ Feature B
+โข Item 3 โ โ Feature C
+โข Item 4 โ โ Feature D
+
+Formatted Lists:
+Bulleted List:
+ โข First item
+ โข Second item
+ โข Third item with longer text
+ โข Fourth item
+
+Numbered List:
+ 1. First item
+ 2. Second item
+ 3. Third item with longer text
+ 4. Fourth item
+
+Checklist:
+ โ Setup environment
+ โ Write code
+ โฌ Test application
+ โฌ Deploy to production
+
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+
+๐ฌ Animation Demonstration
+
+Spinner Animation:
+โ Processing... โ โ Processing complete!
+
+Bouncing Animation:
+โ (bounces left to right and back)
+
+Loading Dots:
+Loading... โ Loading complete! โจ
+
+โจ Formatting demonstration completed!
+๐ก Tip: Use --section= to view specific sections
+```
+
+## Section-Specific Demonstrations
+
+### Colors Section
+```bash
+php main.php format-demo --section=colors
+```
+**Output:**
+```
+๐จ WebFiori CLI Formatting Demonstration
+========================================
+
+๐ Color Demonstration
+
+Basic Foreground Colors:
+ black text
+ red text
+ green text
+ yellow text
+ blue text
+ magenta text
+ cyan text
+ white text
+
+Light Foreground Colors:
+ light-red text
+ light-green text
+ light-yellow text
+ light-blue text
+ light-magenta text
+ light-cyan text
+
+Background Colors:
+ Text with red background
+ Text with green background
+ Text with yellow background
+ Text with blue background
+ Text with magenta background
+ Text with cyan background
+
+Color Combinations:
+ Error style
+ Success style
+ Warning style
+ Info style
+
+โจ Formatting demonstration completed!
+๐ก Tip: Use --section= to view specific sections
+```
+
+### Styles Section
+```bash
+php main.php format-demo --section=styles
+```
+**Output:**
+```
+๐จ WebFiori CLI Formatting Demonstration
+========================================
+
+โจ Text Styling Demonstration
+
+ Bold text
+ Underlined text
+ Bold red text
+ Underlined blue text
+ Bold text with background
+
+Message Types:
+โ Success message
+โ Error message
+โ ๏ธ Warning message
+โน๏ธ Info message
+
+โจ Formatting demonstration completed!
+๐ก Tip: Use --section= to view specific sections
+```
+
+### Tables Section
+```bash
+php main.php format-demo --section=tables
+```
+**Output:**
+```
+๐จ WebFiori CLI Formatting Demonstration
+========================================
+
+๐ Table Demonstration
+
+Simple Table:
+| Name | Age | City |
+|--------------|--------------|--------------|
+| Ahmed Hassan | 30 | Cairo |
+| Fatima Ali | 25 | Dubai |
+| Mohammed Omar| 35 | Riyadh |
+
+Styled Table:
+โโโโโโโโโโโโโโโฌโโโโโโโโโโฌโโโโโโโโโโโโโ
+โ Name โ Age โ Department โ
+โโโโโโโโโโโโโโโผโโโโโโโโโโผโโโโโโโโโโโโโค
+โ Sara Ahmed โ 28 โ Engineering โ
+โ Omar Khalil โ 32 โ Marketing โ
+โ Layla Hassanโ 29 โ Design โ
+โโโโโโโโโโโโโโโดโโโโโโโโโโดโโโโโโโโโโโโโ
+
+Data Table with Alignment:
+โโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโฌโโโโโโโโโโโฌโโโโโโโโโโโโโโโ
+โ Product โ Price โ Stock โ Status โ
+โโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโผโโโโโโโโโโโผโโโโโโโโโโโโโโโค
+โ Laptop โ $1,299.99 โ 15 โ In Stock โ
+โ Mouse โ $29.99 โ 150 โ In Stock โ
+โ Keyboard โ $89.99 โ 0 โ Out of Stock โ
+โ Monitor โ $399.99 โ 8 โ Low Stock โ
+โโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโดโโโโโโโโโโโดโโโโโโโโโโโโโโโ
+
+โจ Formatting demonstration completed!
+๐ก Tip: Use --section= to view specific sections
+```
+
+### Progress Section
+```bash
+php main.php format-demo --section=progress
+```
+**Output:**
+```
+๐จ WebFiori CLI Formatting Demonstration
+========================================
+
+๐ Progress Indicators
+
+Simple Progress Bar:
+[โโโโโโโโโโโโโโโโโโโโ] Complete!
+
+Percentage Progress:
+Progress: [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 100% Done!
+
+Multi-step Progress:
+Step 1/5: Initializing............. โ
+Step 2/5: Loading data............. โ
+Step 3/5: Processing............. โ
+Step 4/5: Validating............. โ
+Step 5/5: Finalizing............. โ
+โ All steps completed!
+
+โจ Formatting demonstration completed!
+๐ก Tip: Use --section= to view specific sections
+```
+
+### Layouts Section
+```bash
+php main.php format-demo --section=layouts
+```
+**Output:**
+```
+๐จ WebFiori CLI Formatting Demonstration
+========================================
+
+๐ Layout Demonstration
+
+Bordered Box:
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+โ This is content inside a bordered box! โ
+โ It can contain multiple lines โ
+โ and various formatting. โ
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+
+Two-Column Layout:
+Left Column โ Right Column
+โข Item 1 โ โ Feature A
+โข Item 2 โ โ Feature B
+โข Item 3 โ โ Feature C
+โข Item 4 โ โ Feature D
+
+Formatted Lists:
+Bulleted List:
+ โข First item
+ โข Second item
+ โข Third item with longer text
+ โข Fourth item
+
+Numbered List:
+ 1. First item
+ 2. Second item
+ 3. Third item with longer text
+ 4. Fourth item
+
+Checklist:
+ โ Setup environment
+ โ Write code
+ โฌ Test application
+ โฌ Deploy to production
+
+โจ Formatting demonstration completed!
+๐ก Tip: Use --section= to view specific sections
+```
+
+### Animations Section
+```bash
+php main.php format-demo --section=animations
+```
+**Output:**
+```
+๐จ WebFiori CLI Formatting Demonstration
+========================================
+
+๐ฌ Animation Demonstration
+
+Spinner Animation:
+โ Processing... โ โ Processing complete!
+
+Bouncing Animation:
+โ (bounces left to right and back)
+
+Loading Dots:
+Loading... โ Loading complete! โจ
+
+โจ Formatting demonstration completed!
+๐ก Tip: Use --section= to view specific sections
+```
+
+## Advanced Options
+
+### Disable Colors
+```bash
+php main.php format-demo --section=colors --no-colors
+```
+**Output:**
+```
+โ ๏ธ Color output disabled
+
+๐จ WebFiori CLI Formatting Demonstration
+========================================
+
+๐ Color Demonstration
+
+Colors disabled - showing plain text versions
+
+Basic Foreground Colors:
+ black text
+ red text
+ green text
+ yellow text
+ blue text
+ magenta text
+ cyan text
+ white text
+
+[... continues with plain text versions ...]
+
+โจ Formatting demonstration completed!
+๐ก Tip: Use --section= to view specific sections
+```
+
+## Error Handling Examples
+
+### Invalid Section
+```bash
+php main.php format-demo --section=invalid
+```
+**Output:**
+```
+Error: The following argument(s) have invalid values: '--section'
+Info: Allowed values for the argument '--section':
+colors
+styles
+tables
+progress
+layouts
+animations
+```
+
+### Invalid Command
+```bash
+php main.php invalid
+```
+**Output:**
+```
+Error: The command 'invalid' is not supported.
+```
+
+## Key Learning Points
+
+1. **ANSI Colors**: 8 basic + 6 light foreground colors, 6 background colors
+2. **Text Styling**: Bold, underlined, and combination formatting
+3. **Message Types**: Consistent styling for success, error, warning, info
+4. **Table Formatting**: Simple markdown, Unicode box-drawing, data alignment
+5. **Progress Indicators**: Visual feedback for long-running operations
+6. **Layout Techniques**: Boxes, columns, lists for structured output
+7. **Animations**: Dynamic visual elements for better user experience
+8. **Color Control**: Ability to disable colors for plain text environments
+9. **Section Filtering**: View specific formatting categories
+10. **Unicode Support**: Emojis, box-drawing characters, special symbols
+
+## Code Structure Examples
+
+### Format Demo Command Structure
+```php
+class FormattingDemoCommand extends Command {
+ public function __construct() {
+ parent::__construct('format-demo', [
+ '--section' => [
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::VALUES => ['colors', 'styles', 'tables', 'progress', 'layouts', 'animations'],
+ ArgumentOption::DESCRIPTION => 'Show specific section only'
+ ],
+ '--no-colors' => [
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DESCRIPTION => 'Disable color output'
+ ]
+ ], 'Demonstrates various output formatting techniques and ANSI styling');
+ }
+
+ public function exec(): int {
+ $section = $this->getArgValue('--section');
+ $noColors = $this->isArgProvided('--no-colors');
+
+ if ($noColors) {
+ $this->warning('โ ๏ธ Color output disabled');
+ $this->println();
+ }
+
+ $this->showHeader();
+
+ if ($section) {
+ $this->showSection($section, $noColors);
+ } else {
+ $this->showAllSections($noColors);
+ }
+
+ $this->showFooter();
+ return 0;
+ }
+}
+```
+
+### Animation Implementation
+```php
+private function showSpinnerAnimation(): void {
+ $frames = ['โ ', 'โ ', 'โ น', 'โ ธ', 'โ ผ', 'โ ด', 'โ ฆ', 'โ ง', 'โ ', 'โ '];
+
+ for ($i = 0; $i < 30; $i++) {
+ $frame = $frames[$i % count($frames)];
+ $this->prints("\r$frame Processing...");
+ usleep(100000); // 0.1 seconds
+ }
+
+ $this->println("\rโ Processing complete!");
+}
+```
+
+This example demonstrates professional CLI output formatting suitable for creating visually appealing and user-friendly command-line applications.
+
+## Related Examples
+
+### Prerequisites
+- **[01-basic-hello-world](../01-basic-hello-world/)** - Basic command and output concepts
+
+### Enhanced Output Features
+- **[06-table-display](../06-table-display/)** - Structured data in formatted tables
+- **[07-progress-bars](../07-progress-bars/)** - Professional progress indicators
+- **[05-interactive-commands](../05-interactive-commands/)** - Interactive menus with formatting
+
+### Input with Formatting
+- **[03-user-input](../03-user-input/)** - User input with formatted prompts
+- **[11-masked-input](../11-masked-input/)** - Secure input with visual feedback
+
+### Complete Applications
+- **[10-multi-command-app](../10-multi-command-app/)** - Full applications with consistent formatting
+- **[09-database-ops](../09-database-ops/)** - Database operations with formatted output
+- **[08-file-processing](../08-file-processing/)** - File operations with status formatting
+
+### Development Tools
+- **[12-command-scaffolding](../12-command-scaffolding/)** - Generate commands with formatting templates
diff --git a/examples/04-output-formatting/main.php b/examples/04-output-formatting/main.php
index 4aa059d..897ca62 100644
--- a/examples/04-output-formatting/main.php
+++ b/examples/04-output-formatting/main.php
@@ -1,29 +1,29 @@
-register(new FormattingDemoCommand());
-
-// Set default command
-
-// Start the application
-exit($runner->start());
+register(new FormattingDemoCommand());
+
+// Set default command
+
+// Start the application
+exit($runner->start());
diff --git a/examples/05-interactive-commands/InteractiveMenuCommand.php b/examples/05-interactive-commands/InteractiveMenuCommand.php
index 68f056c..502b3c2 100644
--- a/examples/05-interactive-commands/InteractiveMenuCommand.php
+++ b/examples/05-interactive-commands/InteractiveMenuCommand.php
@@ -1,747 +1,747 @@
- [
- ArgumentOption::DESCRIPTION => 'Start in specific menu section',
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::VALUES => ['users', 'settings', 'reports', 'tools']
- ]
- ], 'Interactive multi-level menu system with navigation');
- }
-
- public function exec(): int {
- $startSection = $this->getArgValue('--section');
-
- $this->showWelcome();
-
- // Initialize menu stack
- $this->menuStack = ['main'];
- $this->breadcrumbs = ['Main Menu'];
-
- // Jump to specific section if requested
- if ($startSection) {
- $this->navigateToSection($startSection);
- }
-
- // Main menu loop
- while ($this->running) {
- $this->displayCurrentMenu();
- $choice = $this->getUserChoice();
- $this->handleMenuChoice($choice);
- }
-
- $this->showGoodbye();
-
- return 0;
- }
-
- /**
- * Display the current menu.
- */
- private function displayCurrentMenu(): void {
- $this->clearConsole();
-
- // Show breadcrumbs
- $this->info("๐ Current: ".implode(' > ', $this->breadcrumbs));
- $this->println();
-
- $currentMenu = end($this->menuStack);
-
- switch ($currentMenu) {
- case 'main':
- $this->displayMainMenu();
- break;
- case 'users':
- $this->displayUsersMenu();
- break;
- case 'settings':
- $this->displaySettingsMenu();
- break;
- case 'reports':
- $this->displayReportsMenu();
- break;
- case 'tools':
- $this->displayToolsMenu();
- break;
- case 'user-create':
- $this->displayUserCreateForm();
- break;
- case 'system-config':
- $this->displaySystemConfig();
- break;
- default:
- $this->displayMainMenu();
- }
- }
-
- /**
- * Display main menu.
- */
- private function displayMainMenu(): void {
- $this->success("๐ Main Menu:");
- $this->println();
-
- $options = [
- 1 => '๐ฅ User Management',
- 2 => 'โ๏ธ System Settings',
- 3 => '๐ Reports & Analytics',
- 4 => '๐ง Tools & Utilities',
- 5 => 'โ Help & Documentation'
- ];
-
- foreach ($options as $num => $option) {
- $this->println(" $num. $option");
- }
-
- $this->println();
- $this->println(" 0. ๐ช Exit");
- $this->println();
- }
-
- /**
- * Display reports menu.
- */
- private function displayReportsMenu(): void {
- $this->success("๐ Reports & Analytics:");
- $this->println();
-
- $options = [
- 1 => '๐ Usage Statistics',
- 2 => '๐ฅ User Activity Report',
- 3 => '๐จ Error Log Analysis',
- 4 => 'โก Performance Metrics',
- 5 => '๐พ Storage Usage Report',
- 6 => '๐ Custom Date Range Report'
- ];
-
- foreach ($options as $num => $option) {
- $this->println(" $num. $option");
- }
-
- $this->println();
- $this->println(" 9. โฌ ๏ธ Back to Main Menu");
- $this->println();
- }
-
- /**
- * Display settings menu.
- */
- private function displaySettingsMenu(): void {
- $this->success("โ๏ธ System Settings:");
- $this->println();
-
- $options = [
- 1 => '๐ฅ๏ธ System Configuration',
- 2 => '๐จ Appearance Settings',
- 3 => '๐ Security Settings',
- 4 => '๐ง Email Configuration',
- 5 => '๐๏ธ Database Settings',
- 6 => '๐ Logging Configuration'
- ];
-
- foreach ($options as $num => $option) {
- $this->println(" $num. $option");
- }
-
- $this->println();
- $this->println(" 9. โฌ ๏ธ Back to Main Menu");
- $this->println();
- }
-
- /**
- * Display system configuration.
- */
- private function displaySystemConfig(): void {
- $this->success("๐ฅ๏ธ System Configuration");
- $this->println("======================");
- $this->println();
-
- $this->info("Current Settings:");
- $this->println(" โข Application Name: MyApp");
- $this->println(" โข Version: 1.0.0");
- $this->println(" โข Environment: Development");
- $this->println(" โข Debug Mode: Enabled");
- $this->println(" โข Timezone: UTC");
- $this->println();
-
- $options = [
- 1 => 'Change Application Name',
- 2 => 'Update Environment',
- 3 => 'Toggle Debug Mode',
- 4 => 'Set Timezone',
- 5 => 'Reset to Defaults'
- ];
-
- foreach ($options as $num => $option) {
- $this->println(" $num. $option");
- }
-
- $this->println();
- $this->println(" 9. โฌ ๏ธ Back to Settings");
- $this->println();
-
- $choice = $this->getUserChoice();
-
- if ($choice >= 1 && $choice <= 5) {
- $this->handleSystemConfigAction($choice);
- } elseif ($choice == 9) {
- $this->goBack();
- }
- }
-
- /**
- * Display tools menu.
- */
- private function displayToolsMenu(): void {
- $this->success("๐ง Tools & Utilities:");
- $this->println();
-
- $options = [
- 1 => '๐งน System Cleanup',
- 2 => '๐พ Database Backup',
- 3 => '๐ Data Import/Export',
- 4 => '๐ System Diagnostics',
- 5 => '๐ ๏ธ Maintenance Mode',
- 6 => '๐ฆ Update Manager'
- ];
-
- foreach ($options as $num => $option) {
- $this->println(" $num. $option");
- }
-
- $this->println();
- $this->println(" 9. โฌ ๏ธ Back to Main Menu");
- $this->println();
- }
-
- /**
- * Display user creation form.
- */
- private function displayUserCreateForm(): void {
- $this->success("โ Create New User");
- $this->println("================");
- $this->println();
-
- $this->info("Please enter user details:");
- $this->println();
-
- // Simulate form
- $name = $this->getInput('๐ค Full Name: ');
- $email = $this->getInput('๐ง Email Address: ');
- $role = $this->select('๐ Role:', ['User', 'Admin', 'Moderator'], 0);
-
- $this->println();
- $this->info("๐ User Summary:");
- $this->println(" โข Name: $name");
- $this->println(" โข Email: $email");
- $this->println(" โข Role: ".['User', 'Admin', 'Moderator'][$role]);
- $this->println();
-
- if ($this->confirm('Create this user?', true)) {
- $this->success("โ User '$name' created successfully!");
- } else {
- $this->warning("โ User creation cancelled.");
- }
-
- $this->println();
- $this->println("Press Enter to continue...");
- $this->readln();
-
- // Go back to users menu
- $this->goBack();
- }
-
- /**
- * Display users menu.
- */
- private function displayUsersMenu(): void {
- $this->success("๐ฅ User Management:");
- $this->println();
-
- $options = [
- 1 => '๐ List All Users',
- 2 => 'โ Create New User',
- 3 => 'โ๏ธ Edit User',
- 4 => '๐๏ธ Delete User',
- 5 => '๐ Search Users',
- 6 => '๐ User Statistics'
- ];
-
- foreach ($options as $num => $option) {
- $this->println(" $num. $option");
- }
-
- $this->println();
- $this->println(" 9. โฌ ๏ธ Back to Main Menu");
- $this->println();
- }
-
- /**
- * Get user choice.
- */
- private function getUserChoice(): string {
- $this->prints("Your choice: ", ['color' => 'yellow', 'bold' => true]);
-
- return trim($this->readln());
- }
-
- /**
- * Go back to previous menu.
- */
- private function goBack(): void {
- if (count($this->menuStack) > 1) {
- array_pop($this->menuStack);
- array_pop($this->breadcrumbs);
- }
- }
-
- /**
- * Go to main menu.
- */
- private function goHome(): void {
- $this->menuStack = ['main'];
- $this->breadcrumbs = ['Main Menu'];
- }
-
- /**
- * Handle main menu choices.
- */
- private function handleMainMenuChoice(int $choice): void {
- $this->failedTries = 0; // Reset on valid choice
-
- switch ($choice) {
- case 0:
- $this->running = false;
- break;
- case 1:
- $this->navigateTo('users', 'User Management');
- break;
- case 2:
- $this->navigateTo('settings', 'System Settings');
- break;
- case 3:
- $this->navigateTo('reports', 'Reports & Analytics');
- break;
- case 4:
- $this->navigateTo('tools', 'Tools & Utilities');
- break;
- case 5:
- $this->showHelp();
- break;
- default:
- $this->invalidChoice();
- }
- }
-
- /**
- * Handle menu choice.
- */
- private function handleMenuChoice(string $choice): void {
- // Handle special commands
- $lowerChoice = strtolower($choice);
-
- if (in_array($lowerChoice, ['exit', 'quit', 'q'])) {
- $this->running = false;
-
- return;
- }
-
- if (in_array($lowerChoice, ['back', 'b'])) {
- $this->goBack();
-
- return;
- }
-
- if (in_array($lowerChoice, ['home', 'h'])) {
- $this->goHome();
-
- return;
- }
-
- // Handle numeric choices
- if (!is_numeric($choice)) {
- $this->failedTries++;
- $this->error("Invalid choice. Please enter a number or command. ({$this->failedTries}/" . self::MAX_FAILED_TRIES . ")");
-
- if ($this->failedTries >= self::MAX_FAILED_TRIES) {
- $this->error("Too many invalid attempts. Exiting...");
- $this->running = false;
- return;
- }
-
- $this->println("Press Enter to continue...");
- $this->readln();
-
- return;
- }
-
- // Reset counter on valid input
- $this->failedTries = 0;
-
- $choice = (int)$choice;
- $currentMenu = end($this->menuStack);
-
- switch ($currentMenu) {
- case 'main':
- $this->handleMainMenuChoice($choice);
- break;
- case 'users':
- $this->handleUsersMenuChoice($choice);
- break;
- case 'settings':
- $this->handleSettingsMenuChoice($choice);
- break;
- case 'reports':
- $this->handleReportsMenuChoice($choice);
- break;
- case 'tools':
- $this->handleToolsMenuChoice($choice);
- break;
- }
- }
-
- /**
- * Handle reports menu choices.
- */
- private function handleReportsMenuChoice(int $choice): void {
- $this->failedTries = 0; // Reset on valid choice
-
- switch ($choice) {
- case 1:
- $this->showUsageStats();
- break;
- case 2:
- $this->showUserActivity();
- break;
- case 3:
- $this->showErrorAnalysis();
- break;
- case 4:
- $this->showPerformanceMetrics();
- break;
- case 5:
- $this->showStorageReport();
- break;
- case 6:
- $this->showCustomReport();
- break;
- case 9:
- $this->goBack();
- break;
- default:
- $this->invalidChoice();
- }
- }
-
- /**
- * Handle settings menu choices.
- */
- private function handleSettingsMenuChoice(int $choice): void {
- $this->failedTries = 0; // Reset on valid choice
-
- switch ($choice) {
- case 1:
- $this->navigateTo('system-config', 'System Configuration');
- break;
- case 2:
- $this->showAppearanceSettings();
- break;
- case 3:
- $this->showSecuritySettings();
- break;
- case 4:
- $this->showEmailConfig();
- break;
- case 5:
- $this->showDatabaseSettings();
- break;
- case 6:
- $this->showLoggingConfig();
- break;
- case 9:
- $this->goBack();
- break;
- default:
- $this->invalidChoice();
- }
- }
-
- private function handleSystemConfigAction(int $action): void {
- $actions = [
- 1 => "Change Application Name",
- 2 => "Update Environment",
- 3 => "Toggle Debug Mode",
- 4 => "Set Timezone",
- 5 => "Reset to Defaults"
- ];
-
- $this->showPlaceholder($actions[$action] ?? "Unknown Action");
- }
-
- /**
- * Handle tools menu choices.
- */
- private function handleToolsMenuChoice(int $choice): void {
- $this->failedTries = 0; // Reset on valid choice
-
- switch ($choice) {
- case 1:
- $this->runSystemCleanup();
- break;
- case 2:
- $this->runDatabaseBackup();
- break;
- case 3:
- $this->showDataImportExport();
- break;
- case 4:
- $this->runSystemDiagnostics();
- break;
- case 5:
- $this->toggleMaintenanceMode();
- break;
- case 6:
- $this->showUpdateManager();
- break;
- case 9:
- $this->goBack();
- break;
- default:
- $this->invalidChoice();
- }
- }
-
- /**
- * Handle users menu choices.
- */
- private function handleUsersMenuChoice(int $choice): void {
- $this->failedTries = 0; // Reset on valid choice
-
- switch ($choice) {
- case 1:
- $this->showUsersList();
- break;
- case 2:
- $this->navigateTo('user-create', 'Create User');
- break;
- case 3:
- $this->showEditUser();
- break;
- case 4:
- $this->showDeleteUser();
- break;
- case 5:
- $this->showSearchUsers();
- break;
- case 6:
- $this->showUserStats();
- break;
- case 9:
- $this->goBack();
- break;
- default:
- $this->invalidChoice();
- }
- }
-
- /**
- * Show invalid choice message.
- */
- private function invalidChoice(): void {
- $this->failedTries++;
- $this->error("Invalid choice. Please try again. ({$this->failedTries}/" . self::MAX_FAILED_TRIES . ")");
-
- if ($this->failedTries >= self::MAX_FAILED_TRIES) {
- $this->error("Too many invalid attempts. Exiting...");
- $this->running = false;
- return;
- }
-
- $this->println("Press Enter to continue...");
- $this->readln();
- }
-
- /**
- * Navigate to a menu section.
- */
- private function navigateTo(string $menu, string $title): void {
- $this->menuStack[] = $menu;
- $this->breadcrumbs[] = $title;
- }
-
- /**
- * Navigate to specific section.
- */
- private function navigateToSection(string $section): void {
- $sectionMap = [
- 'users' => ['users', 'User Management'],
- 'settings' => ['settings', 'System Settings'],
- 'reports' => ['reports', 'Reports & Analytics'],
- 'tools' => ['tools', 'Tools & Utilities']
- ];
-
- if (isset($sectionMap[$section])) {
- [$menu, $title] = $sectionMap[$section];
- $this->navigateTo($menu, $title);
- }
- }
- private function runDatabaseBackup(): void {
- $this->showPlaceholder("Database Backup");
- }
- private function runSystemCleanup(): void {
- $this->showPlaceholder("System Cleanup");
- }
- private function runSystemDiagnostics(): void {
- $this->showPlaceholder("System Diagnostics");
- }
- private function showAppearanceSettings(): void {
- $this->showPlaceholder("Appearance Settings");
- }
- private function showCustomReport(): void {
- $this->showPlaceholder("Custom Date Range Report");
- }
- private function showDatabaseSettings(): void {
- $this->showPlaceholder("Database Settings");
- }
- private function showDataImportExport(): void {
- $this->showPlaceholder("Data Import/Export");
- }
- private function showDeleteUser(): void {
- $this->showPlaceholder("Delete User");
- }
- private function showEditUser(): void {
- $this->showPlaceholder("Edit User");
- }
- private function showEmailConfig(): void {
- $this->showPlaceholder("Email Configuration");
- }
- private function showErrorAnalysis(): void {
- $this->showPlaceholder("Error Log Analysis");
- }
-
- /**
- * Show goodbye message.
- */
- private function showGoodbye(): void {
- $this->clearConsole();
- $this->success("๐ Thank you for using the Interactive Menu System!");
- $this->info("Have a great day!");
- }
-
- /**
- * Show help information.
- */
- private function showHelp(): void {
- $this->clearConsole();
- $this->success("โ Help & Documentation");
- $this->println("======================");
- $this->println();
-
- $this->info("๐ Available Commands:");
- $this->println(" โข Numbers (1-9): Select menu options");
- $this->println(" โข 'back' or 'b': Go to previous menu");
- $this->println(" โข 'home' or 'h': Go to main menu");
- $this->println(" โข 'exit' or 'q': Quit application");
- $this->println();
-
- $this->info("๐ฏ Quick Navigation:");
- $this->println(" โข Use --section=users to start in User Management");
- $this->println(" โข Use --section=settings for System Settings");
- $this->println(" โข Use --section=reports for Reports & Analytics");
- $this->println(" โข Use --section=tools for Tools & Utilities");
- $this->println();
-
- $this->println("Press Enter to continue...");
- $this->readln();
- }
- private function showLoggingConfig(): void {
- $this->showPlaceholder("Logging Configuration");
- }
- private function showPerformanceMetrics(): void {
- $this->showPlaceholder("Performance Metrics");
- }
-
- /**
- * Show placeholder for unimplemented features.
- */
- private function showPlaceholder(string $feature): void {
- $this->clearConsole();
- $this->info("๐ง $feature");
- $this->println(str_repeat('=', strlen($feature) + 4));
- $this->println();
- $this->warning("This feature is not yet implemented in this demo.");
- $this->info("In a real application, this would show the $feature interface.");
- $this->println();
- $this->println("Press Enter to go back...");
- $this->readln();
- }
- private function showSearchUsers(): void {
- $this->showPlaceholder("Search Users");
- }
- private function showSecuritySettings(): void {
- $this->showPlaceholder("Security Settings");
- }
- private function showStorageReport(): void {
- $this->showPlaceholder("Storage Usage Report");
- }
- private function showUpdateManager(): void {
- $this->showPlaceholder("Update Manager");
- }
- private function showUsageStats(): void {
- $this->showPlaceholder("Usage Statistics");
- }
- private function showUserActivity(): void {
- $this->showPlaceholder("User Activity Report");
- }
-
- // Placeholder methods for menu actions
- private function showUsersList(): void {
- $this->showPlaceholder("Users List");
- }
- private function showUserStats(): void {
- $this->showPlaceholder("User Statistics");
- }
-
- /**
- * Show welcome message.
- */
- private function showWelcome(): void {
- $this->clearConsole();
- $this->println("๐๏ธ Interactive Menu System");
- $this->println("========================");
- $this->println();
- $this->info("๐ก Navigation Tips:");
- $this->println(" โข Enter number to select option");
- $this->println(" โข Type 'back' or 'b' to go back");
- $this->println(" โข Type 'home' or 'h' to go to main menu");
- $this->println(" โข Type 'exit' or 'q' to quit");
- $this->println();
- $this->println("Press Enter to continue...");
- $this->readln();
- }
- private function toggleMaintenanceMode(): void {
- $this->showPlaceholder("Maintenance Mode");
- }
-}
+ [
+ ArgumentOption::DESCRIPTION => 'Start in specific menu section',
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::VALUES => ['users', 'settings', 'reports', 'tools']
+ ]
+ ], 'Interactive multi-level menu system with navigation');
+ }
+
+ public function exec(): int {
+ $startSection = $this->getArgValue('--section');
+
+ $this->showWelcome();
+
+ // Initialize menu stack
+ $this->menuStack = ['main'];
+ $this->breadcrumbs = ['Main Menu'];
+
+ // Jump to specific section if requested
+ if ($startSection) {
+ $this->navigateToSection($startSection);
+ }
+
+ // Main menu loop
+ while ($this->running) {
+ $this->displayCurrentMenu();
+ $choice = $this->getUserChoice();
+ $this->handleMenuChoice($choice);
+ }
+
+ $this->showGoodbye();
+
+ return 0;
+ }
+
+ /**
+ * Display the current menu.
+ */
+ private function displayCurrentMenu(): void {
+ $this->clearConsole();
+
+ // Show breadcrumbs
+ $this->info("๐ Current: ".implode(' > ', $this->breadcrumbs));
+ $this->println();
+
+ $currentMenu = end($this->menuStack);
+
+ switch ($currentMenu) {
+ case 'main':
+ $this->displayMainMenu();
+ break;
+ case 'users':
+ $this->displayUsersMenu();
+ break;
+ case 'settings':
+ $this->displaySettingsMenu();
+ break;
+ case 'reports':
+ $this->displayReportsMenu();
+ break;
+ case 'tools':
+ $this->displayToolsMenu();
+ break;
+ case 'user-create':
+ $this->displayUserCreateForm();
+ break;
+ case 'system-config':
+ $this->displaySystemConfig();
+ break;
+ default:
+ $this->displayMainMenu();
+ }
+ }
+
+ /**
+ * Display main menu.
+ */
+ private function displayMainMenu(): void {
+ $this->success("๐ Main Menu:");
+ $this->println();
+
+ $options = [
+ 1 => '๐ฅ User Management',
+ 2 => 'โ๏ธ System Settings',
+ 3 => '๐ Reports & Analytics',
+ 4 => '๐ง Tools & Utilities',
+ 5 => 'โ Help & Documentation'
+ ];
+
+ foreach ($options as $num => $option) {
+ $this->println(" $num. $option");
+ }
+
+ $this->println();
+ $this->println(" 0. ๐ช Exit");
+ $this->println();
+ }
+
+ /**
+ * Display reports menu.
+ */
+ private function displayReportsMenu(): void {
+ $this->success("๐ Reports & Analytics:");
+ $this->println();
+
+ $options = [
+ 1 => '๐ Usage Statistics',
+ 2 => '๐ฅ User Activity Report',
+ 3 => '๐จ Error Log Analysis',
+ 4 => 'โก Performance Metrics',
+ 5 => '๐พ Storage Usage Report',
+ 6 => '๐ Custom Date Range Report'
+ ];
+
+ foreach ($options as $num => $option) {
+ $this->println(" $num. $option");
+ }
+
+ $this->println();
+ $this->println(" 9. โฌ ๏ธ Back to Main Menu");
+ $this->println();
+ }
+
+ /**
+ * Display settings menu.
+ */
+ private function displaySettingsMenu(): void {
+ $this->success("โ๏ธ System Settings:");
+ $this->println();
+
+ $options = [
+ 1 => '๐ฅ๏ธ System Configuration',
+ 2 => '๐จ Appearance Settings',
+ 3 => '๐ Security Settings',
+ 4 => '๐ง Email Configuration',
+ 5 => '๐๏ธ Database Settings',
+ 6 => '๐ Logging Configuration'
+ ];
+
+ foreach ($options as $num => $option) {
+ $this->println(" $num. $option");
+ }
+
+ $this->println();
+ $this->println(" 9. โฌ ๏ธ Back to Main Menu");
+ $this->println();
+ }
+
+ /**
+ * Display system configuration.
+ */
+ private function displaySystemConfig(): void {
+ $this->success("๐ฅ๏ธ System Configuration");
+ $this->println("======================");
+ $this->println();
+
+ $this->info("Current Settings:");
+ $this->println(" โข Application Name: MyApp");
+ $this->println(" โข Version: 1.0.0");
+ $this->println(" โข Environment: Development");
+ $this->println(" โข Debug Mode: Enabled");
+ $this->println(" โข Timezone: UTC");
+ $this->println();
+
+ $options = [
+ 1 => 'Change Application Name',
+ 2 => 'Update Environment',
+ 3 => 'Toggle Debug Mode',
+ 4 => 'Set Timezone',
+ 5 => 'Reset to Defaults'
+ ];
+
+ foreach ($options as $num => $option) {
+ $this->println(" $num. $option");
+ }
+
+ $this->println();
+ $this->println(" 9. โฌ ๏ธ Back to Settings");
+ $this->println();
+
+ $choice = $this->getUserChoice();
+
+ if ($choice >= 1 && $choice <= 5) {
+ $this->handleSystemConfigAction($choice);
+ } elseif ($choice == 9) {
+ $this->goBack();
+ }
+ }
+
+ /**
+ * Display tools menu.
+ */
+ private function displayToolsMenu(): void {
+ $this->success("๐ง Tools & Utilities:");
+ $this->println();
+
+ $options = [
+ 1 => '๐งน System Cleanup',
+ 2 => '๐พ Database Backup',
+ 3 => '๐ Data Import/Export',
+ 4 => '๐ System Diagnostics',
+ 5 => '๐ ๏ธ Maintenance Mode',
+ 6 => '๐ฆ Update Manager'
+ ];
+
+ foreach ($options as $num => $option) {
+ $this->println(" $num. $option");
+ }
+
+ $this->println();
+ $this->println(" 9. โฌ ๏ธ Back to Main Menu");
+ $this->println();
+ }
+
+ /**
+ * Display user creation form.
+ */
+ private function displayUserCreateForm(): void {
+ $this->success("โ Create New User");
+ $this->println("================");
+ $this->println();
+
+ $this->info("Please enter user details:");
+ $this->println();
+
+ // Simulate form
+ $name = $this->getInput('๐ค Full Name: ');
+ $email = $this->getInput('๐ง Email Address: ');
+ $role = $this->select('๐ Role:', ['User', 'Admin', 'Moderator'], 0);
+
+ $this->println();
+ $this->info("๐ User Summary:");
+ $this->println(" โข Name: $name");
+ $this->println(" โข Email: $email");
+ $this->println(" โข Role: ".['User', 'Admin', 'Moderator'][$role]);
+ $this->println();
+
+ if ($this->confirm('Create this user?', true)) {
+ $this->success("โ User '$name' created successfully!");
+ } else {
+ $this->warning("โ User creation cancelled.");
+ }
+
+ $this->println();
+ $this->println("Press Enter to continue...");
+ $this->readln();
+
+ // Go back to users menu
+ $this->goBack();
+ }
+
+ /**
+ * Display users menu.
+ */
+ private function displayUsersMenu(): void {
+ $this->success("๐ฅ User Management:");
+ $this->println();
+
+ $options = [
+ 1 => '๐ List All Users',
+ 2 => 'โ Create New User',
+ 3 => 'โ๏ธ Edit User',
+ 4 => '๐๏ธ Delete User',
+ 5 => '๐ Search Users',
+ 6 => '๐ User Statistics'
+ ];
+
+ foreach ($options as $num => $option) {
+ $this->println(" $num. $option");
+ }
+
+ $this->println();
+ $this->println(" 9. โฌ ๏ธ Back to Main Menu");
+ $this->println();
+ }
+
+ /**
+ * Get user choice.
+ */
+ private function getUserChoice(): string {
+ $this->prints("Your choice: ", ['color' => 'yellow', 'bold' => true]);
+
+ return trim($this->readln());
+ }
+
+ /**
+ * Go back to previous menu.
+ */
+ private function goBack(): void {
+ if (count($this->menuStack) > 1) {
+ array_pop($this->menuStack);
+ array_pop($this->breadcrumbs);
+ }
+ }
+
+ /**
+ * Go to main menu.
+ */
+ private function goHome(): void {
+ $this->menuStack = ['main'];
+ $this->breadcrumbs = ['Main Menu'];
+ }
+
+ /**
+ * Handle main menu choices.
+ */
+ private function handleMainMenuChoice(int $choice): void {
+ $this->failedTries = 0; // Reset on valid choice
+
+ switch ($choice) {
+ case 0:
+ $this->running = false;
+ break;
+ case 1:
+ $this->navigateTo('users', 'User Management');
+ break;
+ case 2:
+ $this->navigateTo('settings', 'System Settings');
+ break;
+ case 3:
+ $this->navigateTo('reports', 'Reports & Analytics');
+ break;
+ case 4:
+ $this->navigateTo('tools', 'Tools & Utilities');
+ break;
+ case 5:
+ $this->showHelp();
+ break;
+ default:
+ $this->invalidChoice();
+ }
+ }
+
+ /**
+ * Handle menu choice.
+ */
+ private function handleMenuChoice(string $choice): void {
+ // Handle special commands
+ $lowerChoice = strtolower($choice);
+
+ if (in_array($lowerChoice, ['exit', 'quit', 'q'])) {
+ $this->running = false;
+
+ return;
+ }
+
+ if (in_array($lowerChoice, ['back', 'b'])) {
+ $this->goBack();
+
+ return;
+ }
+
+ if (in_array($lowerChoice, ['home', 'h'])) {
+ $this->goHome();
+
+ return;
+ }
+
+ // Handle numeric choices
+ if (!is_numeric($choice)) {
+ $this->failedTries++;
+ $this->error("Invalid choice. Please enter a number or command. ({$this->failedTries}/" . self::MAX_FAILED_TRIES . ")");
+
+ if ($this->failedTries >= self::MAX_FAILED_TRIES) {
+ $this->error("Too many invalid attempts. Exiting...");
+ $this->running = false;
+ return;
+ }
+
+ $this->println("Press Enter to continue...");
+ $this->readln();
+
+ return;
+ }
+
+ // Reset counter on valid input
+ $this->failedTries = 0;
+
+ $choice = (int)$choice;
+ $currentMenu = end($this->menuStack);
+
+ switch ($currentMenu) {
+ case 'main':
+ $this->handleMainMenuChoice($choice);
+ break;
+ case 'users':
+ $this->handleUsersMenuChoice($choice);
+ break;
+ case 'settings':
+ $this->handleSettingsMenuChoice($choice);
+ break;
+ case 'reports':
+ $this->handleReportsMenuChoice($choice);
+ break;
+ case 'tools':
+ $this->handleToolsMenuChoice($choice);
+ break;
+ }
+ }
+
+ /**
+ * Handle reports menu choices.
+ */
+ private function handleReportsMenuChoice(int $choice): void {
+ $this->failedTries = 0; // Reset on valid choice
+
+ switch ($choice) {
+ case 1:
+ $this->showUsageStats();
+ break;
+ case 2:
+ $this->showUserActivity();
+ break;
+ case 3:
+ $this->showErrorAnalysis();
+ break;
+ case 4:
+ $this->showPerformanceMetrics();
+ break;
+ case 5:
+ $this->showStorageReport();
+ break;
+ case 6:
+ $this->showCustomReport();
+ break;
+ case 9:
+ $this->goBack();
+ break;
+ default:
+ $this->invalidChoice();
+ }
+ }
+
+ /**
+ * Handle settings menu choices.
+ */
+ private function handleSettingsMenuChoice(int $choice): void {
+ $this->failedTries = 0; // Reset on valid choice
+
+ switch ($choice) {
+ case 1:
+ $this->navigateTo('system-config', 'System Configuration');
+ break;
+ case 2:
+ $this->showAppearanceSettings();
+ break;
+ case 3:
+ $this->showSecuritySettings();
+ break;
+ case 4:
+ $this->showEmailConfig();
+ break;
+ case 5:
+ $this->showDatabaseSettings();
+ break;
+ case 6:
+ $this->showLoggingConfig();
+ break;
+ case 9:
+ $this->goBack();
+ break;
+ default:
+ $this->invalidChoice();
+ }
+ }
+
+ private function handleSystemConfigAction(int $action): void {
+ $actions = [
+ 1 => "Change Application Name",
+ 2 => "Update Environment",
+ 3 => "Toggle Debug Mode",
+ 4 => "Set Timezone",
+ 5 => "Reset to Defaults"
+ ];
+
+ $this->showPlaceholder($actions[$action] ?? "Unknown Action");
+ }
+
+ /**
+ * Handle tools menu choices.
+ */
+ private function handleToolsMenuChoice(int $choice): void {
+ $this->failedTries = 0; // Reset on valid choice
+
+ switch ($choice) {
+ case 1:
+ $this->runSystemCleanup();
+ break;
+ case 2:
+ $this->runDatabaseBackup();
+ break;
+ case 3:
+ $this->showDataImportExport();
+ break;
+ case 4:
+ $this->runSystemDiagnostics();
+ break;
+ case 5:
+ $this->toggleMaintenanceMode();
+ break;
+ case 6:
+ $this->showUpdateManager();
+ break;
+ case 9:
+ $this->goBack();
+ break;
+ default:
+ $this->invalidChoice();
+ }
+ }
+
+ /**
+ * Handle users menu choices.
+ */
+ private function handleUsersMenuChoice(int $choice): void {
+ $this->failedTries = 0; // Reset on valid choice
+
+ switch ($choice) {
+ case 1:
+ $this->showUsersList();
+ break;
+ case 2:
+ $this->navigateTo('user-create', 'Create User');
+ break;
+ case 3:
+ $this->showEditUser();
+ break;
+ case 4:
+ $this->showDeleteUser();
+ break;
+ case 5:
+ $this->showSearchUsers();
+ break;
+ case 6:
+ $this->showUserStats();
+ break;
+ case 9:
+ $this->goBack();
+ break;
+ default:
+ $this->invalidChoice();
+ }
+ }
+
+ /**
+ * Show invalid choice message.
+ */
+ private function invalidChoice(): void {
+ $this->failedTries++;
+ $this->error("Invalid choice. Please try again. ({$this->failedTries}/" . self::MAX_FAILED_TRIES . ")");
+
+ if ($this->failedTries >= self::MAX_FAILED_TRIES) {
+ $this->error("Too many invalid attempts. Exiting...");
+ $this->running = false;
+ return;
+ }
+
+ $this->println("Press Enter to continue...");
+ $this->readln();
+ }
+
+ /**
+ * Navigate to a menu section.
+ */
+ private function navigateTo(string $menu, string $title): void {
+ $this->menuStack[] = $menu;
+ $this->breadcrumbs[] = $title;
+ }
+
+ /**
+ * Navigate to specific section.
+ */
+ private function navigateToSection(string $section): void {
+ $sectionMap = [
+ 'users' => ['users', 'User Management'],
+ 'settings' => ['settings', 'System Settings'],
+ 'reports' => ['reports', 'Reports & Analytics'],
+ 'tools' => ['tools', 'Tools & Utilities']
+ ];
+
+ if (isset($sectionMap[$section])) {
+ [$menu, $title] = $sectionMap[$section];
+ $this->navigateTo($menu, $title);
+ }
+ }
+ private function runDatabaseBackup(): void {
+ $this->showPlaceholder("Database Backup");
+ }
+ private function runSystemCleanup(): void {
+ $this->showPlaceholder("System Cleanup");
+ }
+ private function runSystemDiagnostics(): void {
+ $this->showPlaceholder("System Diagnostics");
+ }
+ private function showAppearanceSettings(): void {
+ $this->showPlaceholder("Appearance Settings");
+ }
+ private function showCustomReport(): void {
+ $this->showPlaceholder("Custom Date Range Report");
+ }
+ private function showDatabaseSettings(): void {
+ $this->showPlaceholder("Database Settings");
+ }
+ private function showDataImportExport(): void {
+ $this->showPlaceholder("Data Import/Export");
+ }
+ private function showDeleteUser(): void {
+ $this->showPlaceholder("Delete User");
+ }
+ private function showEditUser(): void {
+ $this->showPlaceholder("Edit User");
+ }
+ private function showEmailConfig(): void {
+ $this->showPlaceholder("Email Configuration");
+ }
+ private function showErrorAnalysis(): void {
+ $this->showPlaceholder("Error Log Analysis");
+ }
+
+ /**
+ * Show goodbye message.
+ */
+ private function showGoodbye(): void {
+ $this->clearConsole();
+ $this->success("๐ Thank you for using the Interactive Menu System!");
+ $this->info("Have a great day!");
+ }
+
+ /**
+ * Show help information.
+ */
+ private function showHelp(): void {
+ $this->clearConsole();
+ $this->success("โ Help & Documentation");
+ $this->println("======================");
+ $this->println();
+
+ $this->info("๐ Available Commands:");
+ $this->println(" โข Numbers (1-9): Select menu options");
+ $this->println(" โข 'back' or 'b': Go to previous menu");
+ $this->println(" โข 'home' or 'h': Go to main menu");
+ $this->println(" โข 'exit' or 'q': Quit application");
+ $this->println();
+
+ $this->info("๐ฏ Quick Navigation:");
+ $this->println(" โข Use --section=users to start in User Management");
+ $this->println(" โข Use --section=settings for System Settings");
+ $this->println(" โข Use --section=reports for Reports & Analytics");
+ $this->println(" โข Use --section=tools for Tools & Utilities");
+ $this->println();
+
+ $this->println("Press Enter to continue...");
+ $this->readln();
+ }
+ private function showLoggingConfig(): void {
+ $this->showPlaceholder("Logging Configuration");
+ }
+ private function showPerformanceMetrics(): void {
+ $this->showPlaceholder("Performance Metrics");
+ }
+
+ /**
+ * Show placeholder for unimplemented features.
+ */
+ private function showPlaceholder(string $feature): void {
+ $this->clearConsole();
+ $this->info("๐ง $feature");
+ $this->println(str_repeat('=', strlen($feature) + 4));
+ $this->println();
+ $this->warning("This feature is not yet implemented in this demo.");
+ $this->info("In a real application, this would show the $feature interface.");
+ $this->println();
+ $this->println("Press Enter to go back...");
+ $this->readln();
+ }
+ private function showSearchUsers(): void {
+ $this->showPlaceholder("Search Users");
+ }
+ private function showSecuritySettings(): void {
+ $this->showPlaceholder("Security Settings");
+ }
+ private function showStorageReport(): void {
+ $this->showPlaceholder("Storage Usage Report");
+ }
+ private function showUpdateManager(): void {
+ $this->showPlaceholder("Update Manager");
+ }
+ private function showUsageStats(): void {
+ $this->showPlaceholder("Usage Statistics");
+ }
+ private function showUserActivity(): void {
+ $this->showPlaceholder("User Activity Report");
+ }
+
+ // Placeholder methods for menu actions
+ private function showUsersList(): void {
+ $this->showPlaceholder("Users List");
+ }
+ private function showUserStats(): void {
+ $this->showPlaceholder("User Statistics");
+ }
+
+ /**
+ * Show welcome message.
+ */
+ private function showWelcome(): void {
+ $this->clearConsole();
+ $this->println("๐๏ธ Interactive Menu System");
+ $this->println("========================");
+ $this->println();
+ $this->info("๐ก Navigation Tips:");
+ $this->println(" โข Enter number to select option");
+ $this->println(" โข Type 'back' or 'b' to go back");
+ $this->println(" โข Type 'home' or 'h' to go to main menu");
+ $this->println(" โข Type 'exit' or 'q' to quit");
+ $this->println();
+ $this->println("Press Enter to continue...");
+ $this->readln();
+ }
+ private function toggleMaintenanceMode(): void {
+ $this->showPlaceholder("Maintenance Mode");
+ }
+}
diff --git a/examples/05-interactive-commands/README.md b/examples/05-interactive-commands/README.md
index bce5db7..90b24ea 100644
--- a/examples/05-interactive-commands/README.md
+++ b/examples/05-interactive-commands/README.md
@@ -1,341 +1,341 @@
-# Interactive Commands Example
-
-This example demonstrates building complex interactive CLI workflows with multi-level menu navigation, breadcrumb tracking, and robust error handling.
-
-## ๐ฏ What You'll Learn
-
-- Creating hierarchical menu systems with navigation
-- Building multi-level interactive interfaces
-- State management and breadcrumb tracking
-- Error handling with retry limits
-- User experience best practices
-- Navigation commands and keyboard shortcuts
-
-## ๐ Files
-
-- `InteractiveMenuCommand.php` - Complete multi-level menu system with navigation
-- `main.php` - Application entry point
-- `README.md` - This documentation
-
-
-
-## ๐ Running the Example
-
-### Basic Usage
-```bash
-# Start the interactive menu system
-php main.php menu
-
-# Start in a specific section
-php main.php menu --section=users # User Management
-php main.php menu --section=settings # System Settings
-php main.php menu --section=reports # Reports & Analytics
-php main.php menu --section=tools # Tools & Utilities
-```
-
-### Navigation Commands
-- **Numbers (1-9)**: Select menu options
-- **`back` or `b`**: Go to previous menu
-- **`home` or `h`**: Go to main menu
-- **`exit` or `q`**: Quit application
-- **`0`**: Exit from main menu
-
-## ๐ Key Features
-
-### 1. Multi-Level Navigation
-- **Hierarchical menus**: 3+ levels deep (Main โ Settings โ System Config)
-- **Breadcrumb tracking**: Shows current location path
-- **Menu stack management**: Maintains navigation history
-- **Quick section access**: Jump directly to sections via arguments
-
-### 2. Robust Error Handling
-- **Failed attempts counter**: Max 5 invalid inputs before exit
-- **Graceful degradation**: Clear error messages with attempt count
-- **Counter reset**: Resets on valid input to allow recovery
-- **Infinite loop prevention**: Automatic exit after too many failures
-
-### 3. User Experience
-- **ANSI colors and icons**: Rich visual interface
-- **Clear navigation hints**: Instructions shown on startup
-- **Consistent layout**: Standardized menu formatting
-- **Responsive feedback**: Immediate validation and error messages
-
-### 4. State Management
-- **Menu stack**: Tracks navigation path for back/home functionality
-- **Breadcrumbs**: Visual indication of current location
-- **Session persistence**: Maintains state throughout navigation
-- **Context awareness**: Different options based on current menu
-
-## ๐จ Expected Output
-
-### Startup Screen
-```
-๐๏ธ Interactive Menu System
-========================
-
-๐ก Navigation Tips:
- โข Enter number to select option
- โข Type 'back' or 'b' to go back
- โข Type 'home' or 'h' to go to main menu
- โข Type 'exit' or 'q' to quit
-
-Press Enter to continue...
-```
-
-### Main Menu
-```
-๐ Current: Main Menu
-
-๐ Main Menu:
-
- 1. ๐ฅ User Management
- 2. โ๏ธ System Settings
- 3. ๐ Reports & Analytics
- 4. ๐ง Tools & Utilities
- 5. โ Help & Documentation
-
- 0. ๐ช Exit
-
-Your choice: 2
-```
-
-### Sub-Menu Navigation
-```
-๐ Current: Main Menu > System Settings
-
-โ๏ธ System Settings:
-
- 1. ๐ฅ๏ธ System Configuration
- 2. ๐จ Appearance Settings
- 3. ๐ Security Settings
- 4. ๐ง Email Configuration
- 5. ๐๏ธ Database Settings
- 6. ๐ Logging Configuration
-
- 9. โฌ ๏ธ Back to Main Menu
-
-Your choice: 1
-```
-
-### Deep Navigation
-```
-๐ Current: Main Menu > System Settings > System Configuration
-
-๐ฅ๏ธ System Configuration
-======================
-
-Current Settings:
- โข Application Name: MyApp
- โข Version: 1.0.0
- โข Environment: Development
- โข Debug Mode: Enabled
- โข Timezone: UTC
-
- 1. Change Application Name
- 2. Update Environment
- 3. Toggle Debug Mode
- 4. Set Timezone
- 5. Reset to Defaults
-
- 9. โฌ ๏ธ Back to Settings
-
-Your choice: back
-```
-
-### Error Handling
-```
-Your choice: 99
-Error: Invalid choice. Please try again. (1/5)
-Press Enter to continue...
-
-Your choice: abc
-Error: Invalid choice. Please enter a number or command. (2/5)
-Press Enter to continue...
-
-Your choice: 999
-Error: Invalid choice. Please try again. (3/5)
-Press Enter to continue...
-
-Your choice: invalid
-Error: Invalid choice. Please enter a number or command. (4/5)
-Press Enter to continue...
-
-Your choice: wrong
-Error: Invalid choice. Please enter a number or command. (5/5)
-Error: Too many invalid attempts. Exiting...
-
-๐ Thank you for using the Interactive Menu System!
-Have a great day!
-```
-
-### Navigation Commands
-```
-Your choice: back
-# Goes to previous menu
-
-Your choice: home
-# Goes to main menu
-
-Your choice: q
-# Exits application
-
-Your choice: exit
-# Also exits application
-```
-
-## ๐งช Test Scenarios
-
-### 1. Basic Navigation
-```bash
-echo -e "\n1\n2\n9\n0" | php main.php menu
-# Navigate: Main โ Users โ Create User โ Back โ Exit
-```
-
-### 2. Deep Navigation
-```bash
-echo -e "\n2\n1\nback\nhome\nq" | php main.php menu
-# Navigate: Main โ Settings โ Config โ Back โ Home โ Quit
-```
-
-### 3. Error Handling
-```bash
-echo -e "\n2\n99\n99\n99\n99\n99" | php main.php menu
-# Test: Settings โ 5 invalid inputs โ Auto-exit
-```
-
-### 4. Section Arguments
-```bash
-php main.php menu --section=settings
-# Start directly in System Settings
-```
-
-### 5. Keyboard Shortcuts
-```bash
-echo -e "\n2\nb\nh\nexit" | php main.php menu
-# Test: Settings โ back โ home โ exit
-```
-
-## โ ๏ธ Known Issues
-
-1. **PHP Warning**: Minor undefined array key warning in user creation form (line 259)
-2. **Input Handling**: Some forms may not handle all edge cases perfectly
-3. **Display**: ANSI colors may not work in all terminal environments
-
-## ๐ง Technical Implementation
-
-### Core Classes
-- `InteractiveMenuCommand`: Main command class with navigation logic
-- Menu stack management with `$menuStack` and `$breadcrumbs` arrays
-- Failed attempts tracking with `$failedTries` counter (max 5)
-- State management for multi-level navigation
-
-### Key Methods
-- `handleMenuChoice()`: Processes user input and navigation
-- `navigateTo()`: Manages menu transitions and breadcrumbs
-- `goBack()` / `goHome()`: Navigation utilities
-- `invalidChoice()`: Error handling with retry counter
-- `displayCurrentMenu()`: Renders current menu state
-
-### Error Prevention
-- Input validation with retry limits
-- Graceful exit after 5 failed attempts
-- Counter reset on valid input for recovery
-- Clear error messages with attempt tracking
-
-## ๐ก Learning Opportunities
-
-### Extend the Example
-
-1. **Add Search Functionality**
-```php
-private function searchMenus(string $query): array {
- // Search across all menu items
- return $this->findMatchingItems($query);
-}
-```
-
-2. **Implement Bookmarks**
-```php
-private function bookmarkCurrentLocation(): void {
- $this->bookmarks[] = [
- 'path' => $this->breadcrumbs,
- 'menu' => end($this->menuStack)
- ];
-}
-```
-
-3. **Add Themes Support**
-```php
-private function setTheme(string $theme): void {
- $this->colors = match($theme) {
- 'dark' => ['bg' => 'black', 'text' => 'white'],
- 'light' => ['bg' => 'white', 'text' => 'black'],
- default => $this->defaultColors
- };
-}
-```
-
-4. **Implement Menu History**
-```php
-private function showHistory(): void {
- foreach ($this->navigationHistory as $item) {
- $this->println("โข {$item['timestamp']}: {$item['path']}");
- }
-}
-```
-
-5. **Add Context-Sensitive Help**
-```php
-private function showContextHelp(): void {
- $currentMenu = end($this->menuStack);
- $help = $this->getHelpForMenu($currentMenu);
- $this->displayHelp($help);
-}
-```
-
-### Best Practices Demonstrated
-
-1. **State Management**: Proper tracking of navigation state and user context
-2. **Error Recovery**: Graceful handling of invalid input with retry limits
-3. **User Experience**: Clear feedback, consistent interface, helpful navigation
-4. **Code Organization**: Separation of concerns, modular menu handlers
-5. **Extensibility**: Easy to add new menus and navigation features
-
-### Integration Ideas
-
-- **Database Integration**: Store user preferences and navigation history
-- **Configuration System**: Customizable menu layouts and themes
-- **Plugin Architecture**: Dynamically loaded menu modules
-- **API Integration**: Menus that interact with external services
-- **Logging System**: Track user interactions and menu usage analytics
-
-## ๐ Related Examples
-
-- **[01-basic-hello-world](../01-basic-hello-world/)**: Simple command structure
-- **[02-arguments-and-options](../02-arguments-and-options/)**: Command arguments
-- **[03-user-input](../03-user-input/)**: Input validation and handling
-- **[04-output-formatting](../04-output-formatting/)**: ANSI colors and formatting
-
-## Related Examples
-
-### Prerequisites
-- **[01-basic-hello-world](../01-basic-hello-world/)** - Basic command structure
-- **[03-user-input](../03-user-input/)** - User input and validation fundamentals
-- **[04-output-formatting](../04-output-formatting/)** - ANSI colors and formatting
-
-### Enhanced Interactive Features
-- **[11-masked-input](../11-masked-input/)** - Secure input for sensitive operations
-- **[02-arguments-and-options](../02-arguments-and-options/)** - Command arguments and options
-
-### Visual Enhancements
-- **[06-table-display](../06-table-display/)** - Display data in formatted tables
-- **[07-progress-bars](../07-progress-bars/)** - Visual progress indicators
-
-### Complete Applications
-- **[10-multi-command-app](../10-multi-command-app/)** - Full CLI applications with menus
-- **[09-database-ops](../09-database-ops/)** - Database management with interactive menus
-- **[08-file-processing](../08-file-processing/)** - File operations with user interaction
-
-### Development Tools
-- **[12-command-scaffolding](../12-command-scaffolding/)** - Generate interactive commands automatically
-
+# Interactive Commands Example
+
+This example demonstrates building complex interactive CLI workflows with multi-level menu navigation, breadcrumb tracking, and robust error handling.
+
+## ๐ฏ What You'll Learn
+
+- Creating hierarchical menu systems with navigation
+- Building multi-level interactive interfaces
+- State management and breadcrumb tracking
+- Error handling with retry limits
+- User experience best practices
+- Navigation commands and keyboard shortcuts
+
+## ๐ Files
+
+- `InteractiveMenuCommand.php` - Complete multi-level menu system with navigation
+- `main.php` - Application entry point
+- `README.md` - This documentation
+
+
+
+## ๐ Running the Example
+
+### Basic Usage
+```bash
+# Start the interactive menu system
+php main.php menu
+
+# Start in a specific section
+php main.php menu --section=users # User Management
+php main.php menu --section=settings # System Settings
+php main.php menu --section=reports # Reports & Analytics
+php main.php menu --section=tools # Tools & Utilities
+```
+
+### Navigation Commands
+- **Numbers (1-9)**: Select menu options
+- **`back` or `b`**: Go to previous menu
+- **`home` or `h`**: Go to main menu
+- **`exit` or `q`**: Quit application
+- **`0`**: Exit from main menu
+
+## ๐ Key Features
+
+### 1. Multi-Level Navigation
+- **Hierarchical menus**: 3+ levels deep (Main โ Settings โ System Config)
+- **Breadcrumb tracking**: Shows current location path
+- **Menu stack management**: Maintains navigation history
+- **Quick section access**: Jump directly to sections via arguments
+
+### 2. Robust Error Handling
+- **Failed attempts counter**: Max 5 invalid inputs before exit
+- **Graceful degradation**: Clear error messages with attempt count
+- **Counter reset**: Resets on valid input to allow recovery
+- **Infinite loop prevention**: Automatic exit after too many failures
+
+### 3. User Experience
+- **ANSI colors and icons**: Rich visual interface
+- **Clear navigation hints**: Instructions shown on startup
+- **Consistent layout**: Standardized menu formatting
+- **Responsive feedback**: Immediate validation and error messages
+
+### 4. State Management
+- **Menu stack**: Tracks navigation path for back/home functionality
+- **Breadcrumbs**: Visual indication of current location
+- **Session persistence**: Maintains state throughout navigation
+- **Context awareness**: Different options based on current menu
+
+## ๐จ Expected Output
+
+### Startup Screen
+```
+๐๏ธ Interactive Menu System
+========================
+
+๐ก Navigation Tips:
+ โข Enter number to select option
+ โข Type 'back' or 'b' to go back
+ โข Type 'home' or 'h' to go to main menu
+ โข Type 'exit' or 'q' to quit
+
+Press Enter to continue...
+```
+
+### Main Menu
+```
+๐ Current: Main Menu
+
+๐ Main Menu:
+
+ 1. ๐ฅ User Management
+ 2. โ๏ธ System Settings
+ 3. ๐ Reports & Analytics
+ 4. ๐ง Tools & Utilities
+ 5. โ Help & Documentation
+
+ 0. ๐ช Exit
+
+Your choice: 2
+```
+
+### Sub-Menu Navigation
+```
+๐ Current: Main Menu > System Settings
+
+โ๏ธ System Settings:
+
+ 1. ๐ฅ๏ธ System Configuration
+ 2. ๐จ Appearance Settings
+ 3. ๐ Security Settings
+ 4. ๐ง Email Configuration
+ 5. ๐๏ธ Database Settings
+ 6. ๐ Logging Configuration
+
+ 9. โฌ ๏ธ Back to Main Menu
+
+Your choice: 1
+```
+
+### Deep Navigation
+```
+๐ Current: Main Menu > System Settings > System Configuration
+
+๐ฅ๏ธ System Configuration
+======================
+
+Current Settings:
+ โข Application Name: MyApp
+ โข Version: 1.0.0
+ โข Environment: Development
+ โข Debug Mode: Enabled
+ โข Timezone: UTC
+
+ 1. Change Application Name
+ 2. Update Environment
+ 3. Toggle Debug Mode
+ 4. Set Timezone
+ 5. Reset to Defaults
+
+ 9. โฌ ๏ธ Back to Settings
+
+Your choice: back
+```
+
+### Error Handling
+```
+Your choice: 99
+Error: Invalid choice. Please try again. (1/5)
+Press Enter to continue...
+
+Your choice: abc
+Error: Invalid choice. Please enter a number or command. (2/5)
+Press Enter to continue...
+
+Your choice: 999
+Error: Invalid choice. Please try again. (3/5)
+Press Enter to continue...
+
+Your choice: invalid
+Error: Invalid choice. Please enter a number or command. (4/5)
+Press Enter to continue...
+
+Your choice: wrong
+Error: Invalid choice. Please enter a number or command. (5/5)
+Error: Too many invalid attempts. Exiting...
+
+๐ Thank you for using the Interactive Menu System!
+Have a great day!
+```
+
+### Navigation Commands
+```
+Your choice: back
+# Goes to previous menu
+
+Your choice: home
+# Goes to main menu
+
+Your choice: q
+# Exits application
+
+Your choice: exit
+# Also exits application
+```
+
+## ๐งช Test Scenarios
+
+### 1. Basic Navigation
+```bash
+echo -e "\n1\n2\n9\n0" | php main.php menu
+# Navigate: Main โ Users โ Create User โ Back โ Exit
+```
+
+### 2. Deep Navigation
+```bash
+echo -e "\n2\n1\nback\nhome\nq" | php main.php menu
+# Navigate: Main โ Settings โ Config โ Back โ Home โ Quit
+```
+
+### 3. Error Handling
+```bash
+echo -e "\n2\n99\n99\n99\n99\n99" | php main.php menu
+# Test: Settings โ 5 invalid inputs โ Auto-exit
+```
+
+### 4. Section Arguments
+```bash
+php main.php menu --section=settings
+# Start directly in System Settings
+```
+
+### 5. Keyboard Shortcuts
+```bash
+echo -e "\n2\nb\nh\nexit" | php main.php menu
+# Test: Settings โ back โ home โ exit
+```
+
+## โ ๏ธ Known Issues
+
+1. **PHP Warning**: Minor undefined array key warning in user creation form (line 259)
+2. **Input Handling**: Some forms may not handle all edge cases perfectly
+3. **Display**: ANSI colors may not work in all terminal environments
+
+## ๐ง Technical Implementation
+
+### Core Classes
+- `InteractiveMenuCommand`: Main command class with navigation logic
+- Menu stack management with `$menuStack` and `$breadcrumbs` arrays
+- Failed attempts tracking with `$failedTries` counter (max 5)
+- State management for multi-level navigation
+
+### Key Methods
+- `handleMenuChoice()`: Processes user input and navigation
+- `navigateTo()`: Manages menu transitions and breadcrumbs
+- `goBack()` / `goHome()`: Navigation utilities
+- `invalidChoice()`: Error handling with retry counter
+- `displayCurrentMenu()`: Renders current menu state
+
+### Error Prevention
+- Input validation with retry limits
+- Graceful exit after 5 failed attempts
+- Counter reset on valid input for recovery
+- Clear error messages with attempt tracking
+
+## ๐ก Learning Opportunities
+
+### Extend the Example
+
+1. **Add Search Functionality**
+```php
+private function searchMenus(string $query): array {
+ // Search across all menu items
+ return $this->findMatchingItems($query);
+}
+```
+
+2. **Implement Bookmarks**
+```php
+private function bookmarkCurrentLocation(): void {
+ $this->bookmarks[] = [
+ 'path' => $this->breadcrumbs,
+ 'menu' => end($this->menuStack)
+ ];
+}
+```
+
+3. **Add Themes Support**
+```php
+private function setTheme(string $theme): void {
+ $this->colors = match($theme) {
+ 'dark' => ['bg' => 'black', 'text' => 'white'],
+ 'light' => ['bg' => 'white', 'text' => 'black'],
+ default => $this->defaultColors
+ };
+}
+```
+
+4. **Implement Menu History**
+```php
+private function showHistory(): void {
+ foreach ($this->navigationHistory as $item) {
+ $this->println("โข {$item['timestamp']}: {$item['path']}");
+ }
+}
+```
+
+5. **Add Context-Sensitive Help**
+```php
+private function showContextHelp(): void {
+ $currentMenu = end($this->menuStack);
+ $help = $this->getHelpForMenu($currentMenu);
+ $this->displayHelp($help);
+}
+```
+
+### Best Practices Demonstrated
+
+1. **State Management**: Proper tracking of navigation state and user context
+2. **Error Recovery**: Graceful handling of invalid input with retry limits
+3. **User Experience**: Clear feedback, consistent interface, helpful navigation
+4. **Code Organization**: Separation of concerns, modular menu handlers
+5. **Extensibility**: Easy to add new menus and navigation features
+
+### Integration Ideas
+
+- **Database Integration**: Store user preferences and navigation history
+- **Configuration System**: Customizable menu layouts and themes
+- **Plugin Architecture**: Dynamically loaded menu modules
+- **API Integration**: Menus that interact with external services
+- **Logging System**: Track user interactions and menu usage analytics
+
+## ๐ Related Examples
+
+- **[01-basic-hello-world](../01-basic-hello-world/)**: Simple command structure
+- **[02-arguments-and-options](../02-arguments-and-options/)**: Command arguments
+- **[03-user-input](../03-user-input/)**: Input validation and handling
+- **[04-output-formatting](../04-output-formatting/)**: ANSI colors and formatting
+
+## Related Examples
+
+### Prerequisites
+- **[01-basic-hello-world](../01-basic-hello-world/)** - Basic command structure
+- **[03-user-input](../03-user-input/)** - User input and validation fundamentals
+- **[04-output-formatting](../04-output-formatting/)** - ANSI colors and formatting
+
+### Enhanced Interactive Features
+- **[11-masked-input](../11-masked-input/)** - Secure input for sensitive operations
+- **[02-arguments-and-options](../02-arguments-and-options/)** - Command arguments and options
+
+### Visual Enhancements
+- **[06-table-display](../06-table-display/)** - Display data in formatted tables
+- **[07-progress-bars](../07-progress-bars/)** - Visual progress indicators
+
+### Complete Applications
+- **[10-multi-command-app](../10-multi-command-app/)** - Full CLI applications with menus
+- **[09-database-ops](../09-database-ops/)** - Database management with interactive menus
+- **[08-file-processing](../08-file-processing/)** - File operations with user interaction
+
+### Development Tools
+- **[12-command-scaffolding](../12-command-scaffolding/)** - Generate interactive commands automatically
+
diff --git a/examples/05-interactive-commands/main.php b/examples/05-interactive-commands/main.php
index b0d6349..2ca1208 100644
--- a/examples/05-interactive-commands/main.php
+++ b/examples/05-interactive-commands/main.php
@@ -1,29 +1,29 @@
-register(new InteractiveMenuCommand());
-
-// Set default command
-
-// Start the application
-exit($runner->start());
+register(new InteractiveMenuCommand());
+
+// Set default command
+
+// Start the application
+exit($runner->start());
diff --git a/examples/06-table-display/README.md b/examples/06-table-display/README.md
index b7d2cce..1d83606 100644
--- a/examples/06-table-display/README.md
+++ b/examples/06-table-display/README.md
@@ -1,322 +1,322 @@
-# ๐ Table Display Example
-
-A comprehensive demonstration of the WebFiori CLI Table feature, showcasing professional tabular data display capabilities with various styling options, data formatting, and responsive design.
-
-## ๐ฏ What This Example Demonstrates
-
-### Core Table Features
-- **Multiple table styles** (bordered, simple, minimal, compact, markdown)
-- **Column configuration** (width, alignment, formatting)
-- **Data type handling** (currency, dates, percentages, booleans)
-- **Color themes** (default, dark, light, colorful, professional, minimal)
-- **Status-based colorization** (active=green, error=red, warning=yellow)
-- **Responsive design** that adapts to terminal width
-- **Data export capabilities** (JSON, CSV, arrays)
-
-### Real-World Use Cases
-- **User Management** - Display user accounts with status indicators
-- **Product Catalogs** - Show inventory with pricing and stock levels
-- **Service Monitoring** - System health dashboards with metrics
-- **Data Export** - Various output formats for integration
-- **Report Generation** - Professional data presentation
-
-## ๐ Running the Example
-
-### Basic Usage
-```bash
-# Run all demonstrations
-php main.php table-demo
-
-# Show help
-php main.php help --command=table-demo
-```
-
-### Specific Demonstrations
-```bash
-# User management table
-php main.php table-demo --demo=users
-
-# Product catalog
-php main.php table-demo --demo=products
-
-# Service status monitoring
-php main.php table-demo --demo=services
-
-# Table style variations
-php main.php table-demo --demo=styles
-
-# Color theme showcase
-php main.php table-demo --demo=themes
-
-# Data export capabilities
-php main.php table-demo --demo=export
-
-# Run all demos
-php main.php table-demo --demo=all
-```
-
-### Customization Options
-```bash
-# Use different table style
-php main.php table-demo --demo=users --style=simple
-
-# Apply color theme
-php main.php table-demo --demo=products --theme=colorful
-
-# Set custom width
-php main.php table-demo --demo=services --width=100
-
-# Combine options
-php main.php table-demo --demo=users --style=bordered --theme=professional --width=120
-```
-
-## ๐ Available Options
-
-### Demo Types (`--demo`)
-- `users` - User management system with status indicators
-- `products` - Product catalog with pricing and inventory
-- `services` - Service monitoring dashboard
-- `styles` - Showcase of different table styles
-- `themes` - Color theme demonstrations
-- `export` - Data export format examples
-- `all` - Run all demonstrations (default)
-
-### Table Styles (`--style`)
-- `bordered` - Unicode box-drawing characters (default)
-- `simple` - ASCII characters for maximum compatibility
-- `minimal` - Clean look with reduced borders
-- `compact` - Space-efficient layout
-- `markdown` - Markdown-compatible format
-
-### Color Themes (`--theme`)
-- `default` - Standard theme with basic colors
-- `dark` - Optimized for dark terminals
-- `light` - Optimized for light terminals
-- `colorful` - Vibrant colors and styling
-- `professional` - Business-appropriate styling
-- `minimal` - No colors, just formatting
-
-### Width Control (`--width`)
-- `0` - Auto-detect terminal width (default)
-- `80` - Fixed 80 character width
-- `120` - Fixed 120 character width
-- Any positive integer for custom width
-
-## ๐จ Example Output
-
-### User Management Table (Bordered Style)
-```
-๐ฅ User Management System
- User Management Dashboard
-โโโโโโโโฌโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโฌโโโโโโโโโโโฌโโโโโโโโโโโโโโโ
-โ ID โ Name โ Email โ Status โ Created โ Role โ Balance โ
-โโโโโโโโผโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโผโโโโโโโโโโโโโโโผโโโโโโโโโโโผโโโโโโโโโโโโโโโค
-โ 1 โ John Doe โ john.doe@example.com โ Active โ Jan 15, 2024 โ Admin โ 1,250.75 โ
-โ 2 โ Jane Smith โ jane.smith@example.com โ Inactive โ Jan 16, 2024 โ User โ 890.50 โ
-โ 3 โ Bob Johnson โ bob.johnson@example.com โ Active โ Jan 17, 2024 โ Manager โ 2,100.00 โ
-โ 4 โ Alice Brown โ alice.brown@example.com โ Pending โ Jan 18, 2024 โ User โ 750.25 โ
-โ 5 โ Charlie Davis โ charlie.davis@example.com โ Active โ Jan 19, 2024 โ Admin โ 1,800.80 โ
-โโโโโโโโดโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโดโโโโโโโโโโโโโโโดโโโโโโโโโโโดโโโโโโโโโโโโโโโ
-```
-
-### Product Catalog (Compact Style)
-```
-๐๏ธ Product Catalog
- Product Inventory
- SKU โProduct Name โ Price โ Stock โ Category โFeatured โRating
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
- LAP001 โMacBook Pro 16" โ $2,499.99 โ 15 โElectronics โ โญ Yes โโ 4.8
- MOU002 โWireless Mouse โ $29.99 โ Out โAccessories โ โญ Yes โโ 4.2
- KEY003 โMechanical Keyboard โ $149.99 โ 25 โAccessories โ โญ Yes โโ 4.6
- MON004 โ4K Monitor 27" โ $399.99 โ 8 โElectronics โ No โโ 4.4
- HDD005 โExternal SSD 1TB โ $199.99 โ 50 โ Storage โ โญ Yes โโ 4.7
-```
-
-### Service Status Monitor (Markdown Style)
-```
-๐ง Service Status Monitor
- System Health Dashboard
-------------------------------------------------------------------------------------
-| Service | Version | Status | Uptime | Response | Memory | Health |
-|----------------|--------------|------------|----------|------------|----------|----------|
-| Web Server | nginx/1.20 | Running | 99.9% | 45ms | 2.1GB | โ |
-| Database | MySQL 8.0 | Running | 99.8% | 12ms | 4.5GB | โ |
-| Cache Server | Redis 6.2 | Stopped | 0% | N/A | 0MB | โ |
-| API Gateway | Kong 3.0 | Running | 99.7% | 78ms | 512MB | โ |
-| Message Queue | RabbitMQ | Warning | 95.2% | 156ms | 1.2GB | โ ๏ธ |
-| Load Balancer | HAProxy | Running | 100% | 5ms | 128MB | โ |
-------------------------------------------------------------------------------------
-```
-
-### Style Variations Showcase
-```
-๐จ Table Style Variations
-
-Style: Bordered (Unicode box-drawing characters)
-โโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโ
-โ Item โ Price โ Temperature โ
-โโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโค
-โ Coffee โ $3.50 โ Hot โ
-โ Tea โ $2.75 โ Hot โ
-โ Juice โ $4.25 โ Cold โ
-โโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโ
-
-Style: Simple (ASCII characters for compatibility)
-+--------------------+----------------+--------------------+
-| Item | Price | Temperature |
-+--------------------+----------------+--------------------+
-| Coffee | $3.50 | Hot |
-| Tea | $2.75 | Hot |
-| Juice | $4.25 | Cold |
-+--------------------+----------------+--------------------+
-
-Style: Minimal (Clean look with minimal borders)
- Item Price Temperature
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
- Coffee $3.50 Hot
- Tea $2.75 Hot
- Juice $4.25 Cold
-```
-
-## ๐งช Test Scenarios
-
-### 1. All Demos
-```bash
-php main.php table-demo --demo=all
-# Shows: users, products, services, styles, themes, export
-```
-
-### 2. Style Combinations
-```bash
-php main.php table-demo --demo=users --style=minimal --theme=dark
-php main.php table-demo --demo=products --style=compact --theme=colorful
-php main.php table-demo --demo=services --style=markdown --theme=professional
-```
-
-### 3. Width Testing
-```bash
-php main.php table-demo --demo=users --width=80
-php main.php table-demo --demo=products --width=120
-php main.php table-demo --demo=services --width=100
-```
-
-### 4. Individual Demos
-```bash
-php main.php table-demo --demo=users
-php main.php table-demo --demo=products
-php main.php table-demo --demo=services
-php main.php table-demo --demo=styles
-php main.php table-demo --demo=themes
-php main.php table-demo --demo=export
-```
-
-### 5. Help and Documentation
-```bash
-php main.php help --command=table-demo
-php main.php table-demo --help
-```
-
-## ๐ก Key Features Demonstrated
-
-### 1. Data Formatting
-- **Currency**: `$2,499.99` with proper formatting
-- **Dates**: `Jan 15, 2024` human-readable format
-- **Percentages**: `99.9%` with decimal precision
-- **Status Indicators**: Color-coded status values
-- **Boolean Values**: `โญ Yes` / `No` with icons
-
-### 2. Visual Enhancements
-- **Color Coding**: Green=Active, Red=Inactive, Yellow=Warning
-- **Icons and Emojis**: โ โโ ๏ธโญโ for visual clarity
-- **Column Alignment**: Left, right, center alignment
-- **Text Truncation**: Long emails and names handled gracefully
-
-### 3. Responsive Design
-- **Auto-width Detection**: Adapts to terminal size
-- **Column Prioritization**: Important columns stay visible
-- **Overflow Handling**: Graceful text truncation
-- **Mobile-friendly**: Works on narrow terminals
-
-### 4. Export Capabilities
-- **JSON Format**: Structured data export
-- **CSV Format**: Spreadsheet compatibility
-- **Array Format**: PHP data structures
-- **Associative Arrays**: Key-value pair export
-
-## ๐ง Technical Implementation
-
-### Core Classes Used
-- `TableDemoCommand`: Main command class
-- `TableBuilder`: Table construction and configuration
-- `TableTheme`: Color theme management
-- `Column`: Individual column configuration
-- `TableData`: Data handling and export
-
-### Key Methods
-- `createUsersTable()`: User management demo
-- `createProductsTable()`: Product catalog demo
-- `createServicesTable()`: Service monitoring demo
-- `demonstrateStyles()`: Style variations showcase
-- `demonstrateThemes()`: Color theme examples
-
-### Configuration Options
-- Column width and alignment control
-- Status-based colorization rules
-- Data formatting functions
-- Theme and style selection
-- Responsive width management
-
-## ๐ฏ Best Practices Demonstrated
-
-### 1. User Experience
-- Clear visual hierarchy with headers and colors
-- Consistent data formatting across columns
-- Meaningful status indicators and icons
-- Responsive design for different screen sizes
-
-### 2. Data Presentation
-- Appropriate column widths for content
-- Status-based color coding for quick scanning
-- Currency and date formatting for readability
-- Truncation handling for long text
-
-### 3. Performance
-- Efficient rendering for large datasets
-- Memory-conscious data handling
-- Fast column width calculations
-- Optimized ANSI color usage
-
-### 4. Accessibility
-- High contrast color options
-- ASCII fallbacks for compatibility
-- Clear visual separation between elements
-- Support for different terminal capabilities
-
-## ๐ Related Examples
-
-- **[04-output-formatting](../04-output-formatting/)** - ANSI colors and formatting
-- **[05-interactive-commands](../05-interactive-commands/)** - Interactive menu systems
-- **[08-file-processing](../08-file-processing/)** - File data processing
-- **[10-multi-command-app](../10-multi-command-app/)** - Complete CLI applications
-
-## Related Examples
-
-### Prerequisites
-- **[01-basic-hello-world](../01-basic-hello-world/)** - Basic command structure
-- **[04-output-formatting](../04-output-formatting/)** - Colors and formatting basics
-
-### Enhanced Display Features
-- **[07-progress-bars](../07-progress-bars/)** - Visual progress indicators
-- **[05-interactive-commands](../05-interactive-commands/)** - Interactive menus with tables
-
-### Data Sources
-- **[08-file-processing](../08-file-processing/)** - Process files and display results in tables
-- **[09-database-ops](../09-database-ops/)** - Database queries with table output
-- **[03-user-input](../03-user-input/)** - Collect data and display in tables
-
-### Complete Applications
-- **[10-multi-command-app](../10-multi-command-app/)** - Full applications with data display
-- **[02-arguments-and-options](../02-arguments-and-options/)** - Commands with formatted output
-
-### Development Tools
-- **[12-command-scaffolding](../12-command-scaffolding/)** - Generate commands with table display
+# ๐ Table Display Example
+
+A comprehensive demonstration of the WebFiori CLI Table feature, showcasing professional tabular data display capabilities with various styling options, data formatting, and responsive design.
+
+## ๐ฏ What This Example Demonstrates
+
+### Core Table Features
+- **Multiple table styles** (bordered, simple, minimal, compact, markdown)
+- **Column configuration** (width, alignment, formatting)
+- **Data type handling** (currency, dates, percentages, booleans)
+- **Color themes** (default, dark, light, colorful, professional, minimal)
+- **Status-based colorization** (active=green, error=red, warning=yellow)
+- **Responsive design** that adapts to terminal width
+- **Data export capabilities** (JSON, CSV, arrays)
+
+### Real-World Use Cases
+- **User Management** - Display user accounts with status indicators
+- **Product Catalogs** - Show inventory with pricing and stock levels
+- **Service Monitoring** - System health dashboards with metrics
+- **Data Export** - Various output formats for integration
+- **Report Generation** - Professional data presentation
+
+## ๐ Running the Example
+
+### Basic Usage
+```bash
+# Run all demonstrations
+php main.php table-demo
+
+# Show help
+php main.php help --command=table-demo
+```
+
+### Specific Demonstrations
+```bash
+# User management table
+php main.php table-demo --demo=users
+
+# Product catalog
+php main.php table-demo --demo=products
+
+# Service status monitoring
+php main.php table-demo --demo=services
+
+# Table style variations
+php main.php table-demo --demo=styles
+
+# Color theme showcase
+php main.php table-demo --demo=themes
+
+# Data export capabilities
+php main.php table-demo --demo=export
+
+# Run all demos
+php main.php table-demo --demo=all
+```
+
+### Customization Options
+```bash
+# Use different table style
+php main.php table-demo --demo=users --style=simple
+
+# Apply color theme
+php main.php table-demo --demo=products --theme=colorful
+
+# Set custom width
+php main.php table-demo --demo=services --width=100
+
+# Combine options
+php main.php table-demo --demo=users --style=bordered --theme=professional --width=120
+```
+
+## ๐ Available Options
+
+### Demo Types (`--demo`)
+- `users` - User management system with status indicators
+- `products` - Product catalog with pricing and inventory
+- `services` - Service monitoring dashboard
+- `styles` - Showcase of different table styles
+- `themes` - Color theme demonstrations
+- `export` - Data export format examples
+- `all` - Run all demonstrations (default)
+
+### Table Styles (`--style`)
+- `bordered` - Unicode box-drawing characters (default)
+- `simple` - ASCII characters for maximum compatibility
+- `minimal` - Clean look with reduced borders
+- `compact` - Space-efficient layout
+- `markdown` - Markdown-compatible format
+
+### Color Themes (`--theme`)
+- `default` - Standard theme with basic colors
+- `dark` - Optimized for dark terminals
+- `light` - Optimized for light terminals
+- `colorful` - Vibrant colors and styling
+- `professional` - Business-appropriate styling
+- `minimal` - No colors, just formatting
+
+### Width Control (`--width`)
+- `0` - Auto-detect terminal width (default)
+- `80` - Fixed 80 character width
+- `120` - Fixed 120 character width
+- Any positive integer for custom width
+
+## ๐จ Example Output
+
+### User Management Table (Bordered Style)
+```
+๐ฅ User Management System
+ User Management Dashboard
+โโโโโโโโฌโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโฌโโโโโโโโโโโฌโโโโโโโโโโโโโโโ
+โ ID โ Name โ Email โ Status โ Created โ Role โ Balance โ
+โโโโโโโโผโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโผโโโโโโโโโโโโโโโผโโโโโโโโโโโผโโโโโโโโโโโโโโโค
+โ 1 โ John Doe โ john.doe@example.com โ Active โ Jan 15, 2024 โ Admin โ 1,250.75 โ
+โ 2 โ Jane Smith โ jane.smith@example.com โ Inactive โ Jan 16, 2024 โ User โ 890.50 โ
+โ 3 โ Bob Johnson โ bob.johnson@example.com โ Active โ Jan 17, 2024 โ Manager โ 2,100.00 โ
+โ 4 โ Alice Brown โ alice.brown@example.com โ Pending โ Jan 18, 2024 โ User โ 750.25 โ
+โ 5 โ Charlie Davis โ charlie.davis@example.com โ Active โ Jan 19, 2024 โ Admin โ 1,800.80 โ
+โโโโโโโโดโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโดโโโโโโโโโโโโโโโดโโโโโโโโโโโดโโโโโโโโโโโโโโโ
+```
+
+### Product Catalog (Compact Style)
+```
+๐๏ธ Product Catalog
+ Product Inventory
+ SKU โProduct Name โ Price โ Stock โ Category โFeatured โRating
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+ LAP001 โMacBook Pro 16" โ $2,499.99 โ 15 โElectronics โ โญ Yes โโ 4.8
+ MOU002 โWireless Mouse โ $29.99 โ Out โAccessories โ โญ Yes โโ 4.2
+ KEY003 โMechanical Keyboard โ $149.99 โ 25 โAccessories โ โญ Yes โโ 4.6
+ MON004 โ4K Monitor 27" โ $399.99 โ 8 โElectronics โ No โโ 4.4
+ HDD005 โExternal SSD 1TB โ $199.99 โ 50 โ Storage โ โญ Yes โโ 4.7
+```
+
+### Service Status Monitor (Markdown Style)
+```
+๐ง Service Status Monitor
+ System Health Dashboard
+------------------------------------------------------------------------------------
+| Service | Version | Status | Uptime | Response | Memory | Health |
+|----------------|--------------|------------|----------|------------|----------|----------|
+| Web Server | nginx/1.20 | Running | 99.9% | 45ms | 2.1GB | โ |
+| Database | MySQL 8.0 | Running | 99.8% | 12ms | 4.5GB | โ |
+| Cache Server | Redis 6.2 | Stopped | 0% | N/A | 0MB | โ |
+| API Gateway | Kong 3.0 | Running | 99.7% | 78ms | 512MB | โ |
+| Message Queue | RabbitMQ | Warning | 95.2% | 156ms | 1.2GB | โ ๏ธ |
+| Load Balancer | HAProxy | Running | 100% | 5ms | 128MB | โ |
+------------------------------------------------------------------------------------
+```
+
+### Style Variations Showcase
+```
+๐จ Table Style Variations
+
+Style: Bordered (Unicode box-drawing characters)
+โโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโ
+โ Item โ Price โ Temperature โ
+โโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโค
+โ Coffee โ $3.50 โ Hot โ
+โ Tea โ $2.75 โ Hot โ
+โ Juice โ $4.25 โ Cold โ
+โโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโ
+
+Style: Simple (ASCII characters for compatibility)
++--------------------+----------------+--------------------+
+| Item | Price | Temperature |
++--------------------+----------------+--------------------+
+| Coffee | $3.50 | Hot |
+| Tea | $2.75 | Hot |
+| Juice | $4.25 | Cold |
++--------------------+----------------+--------------------+
+
+Style: Minimal (Clean look with minimal borders)
+ Item Price Temperature
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+ Coffee $3.50 Hot
+ Tea $2.75 Hot
+ Juice $4.25 Cold
+```
+
+## ๐งช Test Scenarios
+
+### 1. All Demos
+```bash
+php main.php table-demo --demo=all
+# Shows: users, products, services, styles, themes, export
+```
+
+### 2. Style Combinations
+```bash
+php main.php table-demo --demo=users --style=minimal --theme=dark
+php main.php table-demo --demo=products --style=compact --theme=colorful
+php main.php table-demo --demo=services --style=markdown --theme=professional
+```
+
+### 3. Width Testing
+```bash
+php main.php table-demo --demo=users --width=80
+php main.php table-demo --demo=products --width=120
+php main.php table-demo --demo=services --width=100
+```
+
+### 4. Individual Demos
+```bash
+php main.php table-demo --demo=users
+php main.php table-demo --demo=products
+php main.php table-demo --demo=services
+php main.php table-demo --demo=styles
+php main.php table-demo --demo=themes
+php main.php table-demo --demo=export
+```
+
+### 5. Help and Documentation
+```bash
+php main.php help --command=table-demo
+php main.php table-demo --help
+```
+
+## ๐ก Key Features Demonstrated
+
+### 1. Data Formatting
+- **Currency**: `$2,499.99` with proper formatting
+- **Dates**: `Jan 15, 2024` human-readable format
+- **Percentages**: `99.9%` with decimal precision
+- **Status Indicators**: Color-coded status values
+- **Boolean Values**: `โญ Yes` / `No` with icons
+
+### 2. Visual Enhancements
+- **Color Coding**: Green=Active, Red=Inactive, Yellow=Warning
+- **Icons and Emojis**: โ โโ ๏ธโญโ for visual clarity
+- **Column Alignment**: Left, right, center alignment
+- **Text Truncation**: Long emails and names handled gracefully
+
+### 3. Responsive Design
+- **Auto-width Detection**: Adapts to terminal size
+- **Column Prioritization**: Important columns stay visible
+- **Overflow Handling**: Graceful text truncation
+- **Mobile-friendly**: Works on narrow terminals
+
+### 4. Export Capabilities
+- **JSON Format**: Structured data export
+- **CSV Format**: Spreadsheet compatibility
+- **Array Format**: PHP data structures
+- **Associative Arrays**: Key-value pair export
+
+## ๐ง Technical Implementation
+
+### Core Classes Used
+- `TableDemoCommand`: Main command class
+- `TableBuilder`: Table construction and configuration
+- `TableTheme`: Color theme management
+- `Column`: Individual column configuration
+- `TableData`: Data handling and export
+
+### Key Methods
+- `createUsersTable()`: User management demo
+- `createProductsTable()`: Product catalog demo
+- `createServicesTable()`: Service monitoring demo
+- `demonstrateStyles()`: Style variations showcase
+- `demonstrateThemes()`: Color theme examples
+
+### Configuration Options
+- Column width and alignment control
+- Status-based colorization rules
+- Data formatting functions
+- Theme and style selection
+- Responsive width management
+
+## ๐ฏ Best Practices Demonstrated
+
+### 1. User Experience
+- Clear visual hierarchy with headers and colors
+- Consistent data formatting across columns
+- Meaningful status indicators and icons
+- Responsive design for different screen sizes
+
+### 2. Data Presentation
+- Appropriate column widths for content
+- Status-based color coding for quick scanning
+- Currency and date formatting for readability
+- Truncation handling for long text
+
+### 3. Performance
+- Efficient rendering for large datasets
+- Memory-conscious data handling
+- Fast column width calculations
+- Optimized ANSI color usage
+
+### 4. Accessibility
+- High contrast color options
+- ASCII fallbacks for compatibility
+- Clear visual separation between elements
+- Support for different terminal capabilities
+
+## ๐ Related Examples
+
+- **[04-output-formatting](../04-output-formatting/)** - ANSI colors and formatting
+- **[05-interactive-commands](../05-interactive-commands/)** - Interactive menu systems
+- **[08-file-processing](../08-file-processing/)** - File data processing
+- **[10-multi-command-app](../10-multi-command-app/)** - Complete CLI applications
+
+## Related Examples
+
+### Prerequisites
+- **[01-basic-hello-world](../01-basic-hello-world/)** - Basic command structure
+- **[04-output-formatting](../04-output-formatting/)** - Colors and formatting basics
+
+### Enhanced Display Features
+- **[07-progress-bars](../07-progress-bars/)** - Visual progress indicators
+- **[05-interactive-commands](../05-interactive-commands/)** - Interactive menus with tables
+
+### Data Sources
+- **[08-file-processing](../08-file-processing/)** - Process files and display results in tables
+- **[09-database-ops](../09-database-ops/)** - Database queries with table output
+- **[03-user-input](../03-user-input/)** - Collect data and display in tables
+
+### Complete Applications
+- **[10-multi-command-app](../10-multi-command-app/)** - Full applications with data display
+- **[02-arguments-and-options](../02-arguments-and-options/)** - Commands with formatted output
+
+### Development Tools
+- **[12-command-scaffolding](../12-command-scaffolding/)** - Generate commands with table display
diff --git a/examples/06-table-display/TableDemoCommand.php b/examples/06-table-display/TableDemoCommand.php
index 8c6a4d6..46edce0 100644
--- a/examples/06-table-display/TableDemoCommand.php
+++ b/examples/06-table-display/TableDemoCommand.php
@@ -1,460 +1,460 @@
- [
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DESCRIPTION => 'Specific demo to run (users, products, services, styles, themes, export)',
- ArgumentOption::VALUES => ['users', 'products', 'services', 'styles', 'themes', 'export', 'all']
- ],
- '--style' => [
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DESCRIPTION => 'Table style to use',
- ArgumentOption::VALUES => ['bordered', 'simple', 'minimal', 'compact', 'markdown'],
- ArgumentOption::DEFAULT => 'bordered'
- ],
- '--theme' => [
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DESCRIPTION => 'Color theme to use',
- ArgumentOption::VALUES => ['default', 'dark', 'light', 'colorful', 'professional', 'minimal'],
- ArgumentOption::DEFAULT => 'default'
- ],
- '--width' => [
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DESCRIPTION => 'Maximum table width (default: auto-detect)',
- ArgumentOption::DEFAULT => '0'
- ]
- ], 'Demonstrates WebFiori CLI Table display capabilities with various examples');
- }
-
- public function exec(): int {
- $this->println('๐ฏ WebFiori CLI Table Feature Demonstration', ['bold' => true, 'color' => 'light-cyan']);
- $this->println('============================================');
- $this->println('');
-
- $demo = $this->getArgValue('--demo') ?? 'all';
- $style = $this->getArgValue('--style') ?? 'bordered';
- $theme = $this->getArgValue('--theme') ?? 'default';
- $width = (int)($this->getArgValue('--width') ?? '0');
-
- if ($width === 0) {
- $width = $this->getTerminalWidth();
- }
-
- $this->println("Configuration:", ['color' => 'yellow']);
- $this->println(" โข Demo: $demo");
- $this->println(" โข Style: $style");
- $this->println(" โข Theme: $theme");
- $this->println(" โข Width: {$width} characters");
- $this->println('');
-
- try {
- switch ($demo) {
- case 'users':
- $this->demoUserManagement($style, $theme, $width);
- break;
- case 'products':
- $this->demoProductCatalog($style, $theme, $width);
- break;
- case 'services':
- $this->demoServiceStatus($style, $theme, $width);
- break;
- case 'styles':
- $this->demoTableStyles($width);
- break;
- case 'themes':
- $this->demoColorThemes($width);
- break;
- case 'export':
- $this->demoDataExport($style, $theme, $width);
- break;
- case 'all':
- default:
- $this->runAllDemos($style, $theme, $width);
- break;
- }
-
- $this->println('');
- $this->success('โจ Table demonstration completed successfully!');
- $this->println('');
- $this->info('๐ก Tips:');
- $this->println(' โข Use --demo= to run specific demonstrations');
- $this->println(' โข Try different --style and --theme combinations');
- $this->println(' โข Adjust --width for different terminal sizes');
-
- return 0;
- } catch (Exception $e) {
- $this->error('Demo failed: '.$e->getMessage());
-
- return 1;
- }
- }
-
- /**
- * Demonstrate color themes.
- */
- private function demoColorThemes(int $width): void {
- $this->println('๐ Color Theme Showcase', ['bold' => true, 'color' => 'light-magenta']);
- $this->println('-----------------------');
-
- $data = [
- ['Active', 25, '83.3%'],
- ['Inactive', 3, '10.0%'],
- ['Pending', 2, '6.7%']
- ];
-
- $themes = [
- 'default' => 'Standard theme with basic colors',
- 'dark' => 'Dark theme for dark terminals',
- 'colorful' => 'Vibrant colors and styling',
- 'professional' => 'Business-appropriate styling'
- ];
-
- foreach ($themes as $themeName => $description) {
- $this->println("Theme: ".ucfirst($themeName)." ($description)", ['color' => 'yellow']);
-
- $table = TableBuilder::create()
- ->setHeaders(['Status', 'Count', 'Percentage'])
- ->addRows($data)
- ->setTheme(TableTheme::create($themeName))
- ->setMaxWidth(min($width, 50))
- ->configureColumn('Count', ['align' => 'right'])
- ->configureColumn('Percentage', [
- 'align' => 'right',
- 'formatter' => fn($value) => str_replace('%', '', $value).'%'
- ])
- ->colorizeColumn('Status', function ($value) {
- return match (strtolower($value)) {
- 'active' => ['color' => 'green', 'bold' => true],
- 'inactive' => ['color' => 'red'],
- 'pending' => ['color' => 'yellow'],
- default => []
- };
- });
-
- echo $table->render();
- $this->println('');
- }
-
- $this->info('Themes automatically adapt to terminal capabilities.');
- }
-
- /**
- * Demonstrate data export capabilities.
- */
- private function demoDataExport(string $style, string $theme, int $width): void {
- $this->println('๐พ Data Export Capabilities', ['bold' => true, 'color' => 'light-green']);
- $this->println('---------------------------');
-
- $exportData = [
- ['1', 'Ahmed Hassan', 'ahmed.hassan@example.com', 'Active'],
- ['2', 'Sarah Johnson', 'sarah.johnson@example.com', 'Inactive'],
- ['3', 'Omar Al-Rashid', 'omar.alrashid@example.com', 'Active']
- ];
-
- $table = TableBuilder::create()
- ->setHeaders(['ID', 'Name', 'Email', 'Status'])
- ->addRows($exportData)
- ->setTitle('Sample Export Data')
- ->useStyle($style)
- ->setTheme(TableTheme::create($theme))
- ->setMaxWidth($width);
-
- echo $table->render();
-
- $this->println('');
- $this->info('Export formats available:');
- $this->println(' โข JSON format (structured data)');
- $this->println(' โข CSV format (spreadsheet compatible)');
- $this->println(' โข Array format (PHP arrays)');
- $this->println(' โข Associative arrays (key-value pairs)');
- $this->println('');
- $this->println('Note: In a real application, you would access the TableData');
- $this->println('object to export data in various formats.');
- }
-
- /**
- * Demonstrate product catalog table.
- */
- private function demoProductCatalog(string $style, string $theme, int $width): void {
- $this->println('๐๏ธ Product Catalog', ['bold' => true, 'color' => 'blue']);
- $this->println('------------------');
-
- $products = [
- ['LAP001', 'MacBook Pro 16"', 2499.99, 15, 'Electronics', true, 4.8],
- ['MOU002', 'Wireless Mouse', 29.99, 0, 'Accessories', true, 4.2],
- ['KEY003', 'Mechanical Keyboard', 149.99, 25, 'Accessories', true, 4.6],
- ['MON004', '4K Monitor 27"', 399.99, 8, 'Electronics', false, 4.4],
- ['HDD005', 'External SSD 1TB', 199.99, 50, 'Storage', true, 4.7]
- ];
-
- $table = TableBuilder::create()
- ->setHeaders(['SKU', 'Product Name', 'Price', 'Stock', 'Category', 'Featured', 'Rating'])
- ->addRows($products)
- ->setTitle('Product Inventory')
- ->useStyle($style)
- ->setTheme(TableTheme::create($theme))
- ->setMaxWidth($width)
- ->configureColumn('SKU', ['width' => 8, 'align' => 'center'])
- ->configureColumn('Product Name', ['width' => 20, 'truncate' => true])
- ->configureColumn('Price', [
- 'width' => 10,
- 'align' => 'right',
- 'formatter' => fn($value) => '$'.number_format($value, 2)
- ])
- ->configureColumn('Stock', [
- 'width' => 6,
- 'align' => 'right',
- 'formatter' => fn($value) => $value > 0 ? (string)$value : 'Out'
- ])
- ->configureColumn('Category', ['width' => 12, 'align' => 'center'])
- ->configureColumn('Featured', [
- 'width' => 9,
- 'align' => 'center',
- 'formatter' => fn($value) => $value ? 'โญ Yes' : ' No'
- ])
- ->configureColumn('Rating', [
- 'width' => 7,
- 'align' => 'center',
- 'formatter' => fn($value) => 'โ '.number_format($value, 1)
- ])
- ->colorizeColumn('Stock', function ($value) {
- if ($value === 'Out' || $value === 0) {
- return ['color' => 'red', 'bold' => true];
- } elseif (is_numeric($value) && $value < 10) {
- return ['color' => 'yellow'];
- }
-
- return ['color' => 'green'];
- });
-
- echo $table->render();
-
- $this->println('');
- $this->info('Features demonstrated:');
- $this->println(' โข Currency formatting');
- $this->println(' โข Stock level indicators with colors');
- $this->println(' โข Boolean formatting with icons');
- $this->println(' โข Rating display with stars');
- $this->println(' โข Product name truncation');
- }
-
- /**
- * Demonstrate service status monitoring.
- */
- private function demoServiceStatus(string $style, string $theme, int $width): void {
- $this->println('๐ง Service Status Monitor', ['bold' => true, 'color' => 'magenta']);
- $this->println('-------------------------');
-
- $services = [
- ['Web Server', 'nginx/1.20', 'Running', '99.9%', '45ms', '2.1GB', 'โ '],
- ['Database', 'MySQL 8.0', 'Running', '99.8%', '12ms', '4.5GB', 'โ '],
- ['Cache Server', 'Redis 6.2', 'Stopped', '0%', 'N/A', '0MB', 'โ'],
- ['API Gateway', 'Kong 3.0', 'Running', '99.7%', '78ms', '512MB', 'โ '],
- ['Message Queue', 'RabbitMQ', 'Warning', '95.2%', '156ms', '1.2GB', 'โ ๏ธ'],
- ['Load Balancer', 'HAProxy', 'Running', '100%', '5ms', '128MB', 'โ ']
- ];
-
- $table = TableBuilder::create()
- ->setHeaders(['Service', 'Version', 'Status', 'Uptime', 'Response', 'Memory', 'Health'])
- ->addRows($services)
- ->setTitle('System Health Dashboard')
- ->useStyle($style)
- ->setTheme(TableTheme::create($theme))
- ->setMaxWidth($width)
- ->configureColumn('Service', ['width' => 14, 'align' => 'left'])
- ->configureColumn('Version', ['width' => 12, 'align' => 'center'])
- ->configureColumn('Status', ['width' => 10, 'align' => 'center'])
- ->configureColumn('Uptime', ['width' => 8, 'align' => 'right'])
- ->configureColumn('Response', ['width' => 10, 'align' => 'right'])
- ->configureColumn('Memory', ['width' => 8, 'align' => 'right'])
- ->configureColumn('Health', ['width' => 8, 'align' => 'center'])
- ->colorizeColumn('Status', function ($value) {
- return match (strtolower($value)) {
- 'running' => ['color' => 'green', 'bold' => true],
- 'stopped' => ['color' => 'red', 'bold' => true],
- 'warning' => ['color' => 'yellow', 'bold' => true],
- default => []
- };
- })
- ->colorizeColumn('Health', function ($value) {
- return match ($value) {
- 'โ ' => ['color' => 'green'],
- 'โ' => ['color' => 'red'],
- 'โ ๏ธ' => ['color' => 'yellow'],
- default => []
- };
- });
-
- echo $table->render();
-
- $this->println('');
- $this->info('Features demonstrated:');
- $this->println(' โข System monitoring data display');
- $this->println(' โข Multiple status indicators');
- $this->println(' โข Performance metrics formatting');
- $this->println(' โข Health status with emoji indicators');
- $this->println(' โข Memory usage display');
- }
-
- /**
- * Demonstrate different table styles.
- */
- private function demoTableStyles(int $width): void {
- $this->println('๐จ Table Style Variations', ['bold' => true, 'color' => 'cyan']);
- $this->println('-------------------------');
-
- $data = [
- ['Coffee', '$3.50', 'Hot'],
- ['Tea', '$2.75', 'Hot'],
- ['Juice', '$4.25', 'Cold']
- ];
-
- $styles = [
- 'bordered' => 'Unicode box-drawing characters',
- 'simple' => 'ASCII characters for compatibility',
- 'minimal' => 'Clean look with minimal borders',
- 'compact' => 'Space-efficient layout',
- 'markdown' => 'Markdown-compatible format'
- ];
-
- foreach ($styles as $styleName => $description) {
- $this->println("Style: ".ucfirst($styleName)." ($description)", ['color' => 'yellow']);
-
- $table = TableBuilder::create()
- ->setHeaders(['Item', 'Price', 'Temperature'])
- ->addRows($data)
- ->useStyle($styleName)
- ->setMaxWidth(min($width, 60)); // Limit width for style demo
-
- echo $table->render();
- $this->println('');
- }
-
- $this->info('All table styles are responsive and adapt to terminal width.');
- }
-
- /**
- * Demonstrate user management table.
- */
- private function demoUserManagement(string $style, string $theme, int $width): void {
- $this->println('๐ฅ User Management System', ['bold' => true, 'color' => 'green']);
- $this->println('-------------------------');
-
- $users = [
- ['1', 'Ahmed Hassan', 'ahmed.hassan@example.com', 'Active', '2024-01-15', 'Admin', '$1,250.75'],
- ['2', 'Sarah Johnson', 'sarah.johnson@example.com', 'Inactive', '2024-01-16', 'User', '$890.50'],
- ['3', 'Omar Al-Rashid', 'omar.alrashid@example.com', 'Active', '2024-01-17', 'Manager', '$2,100.00'],
- ['4', 'Fatima Al-Zahra', 'fatima.alzahra@example.com', 'Pending', '2024-01-18', 'User', '$750.25'],
- ['5', 'Michael Davis', 'michael.davis@example.com', 'Active', '2024-01-19', 'Admin', '$1,800.80']
- ];
-
- $table = TableBuilder::create()
- ->setHeaders(['ID', 'Name', 'Email', 'Status', 'Created', 'Role', 'Balance'])
- ->addRows($users)
- ->setTitle('User Management Dashboard')
- ->useStyle($style)
- ->setTheme(TableTheme::create($theme))
- ->setMaxWidth($width)
- ->configureColumn('ID', ['width' => 4, 'align' => 'center'])
- ->configureColumn('Name', ['width' => 15, 'align' => 'left'])
- ->configureColumn('Email', ['width' => 25, 'truncate' => true])
- ->configureColumn('Status', ['width' => 10, 'align' => 'center'])
- ->configureColumn('Created', [
- 'width' => 12,
- 'align' => 'center',
- 'formatter' => fn($date) => date('M j, Y', strtotime($date))
- ])
- ->configureColumn('Role', ['width' => 8, 'align' => 'center'])
- ->configureColumn('Balance', [
- 'width' => 12,
- 'align' => 'right',
- 'formatter' => fn($value) => str_replace('$', '', $value) // Remove existing $ for proper formatting
- ])
- ->colorizeColumn('Status', function ($value) {
- return match (strtolower($value)) {
- 'active' => ['color' => 'green', 'bold' => true],
- 'inactive' => ['color' => 'red', 'bold' => true],
- 'pending' => ['color' => 'yellow', 'bold' => true],
- default => []
- };
- });
-
- echo $table->render();
-
- $this->println('');
- $this->info('Features demonstrated:');
- $this->println(' โข Column width control and alignment');
- $this->println(' โข Date formatting');
- $this->println(' โข Status-based colorization');
- $this->println(' โข Email truncation for long addresses');
- $this->println(' โข Responsive design within terminal width');
- }
-
- /**
- * Get terminal width with fallback.
- */
- private function getTerminalWidth(): int {
- // Try to get terminal width
- $width = exec('tput cols 2>/dev/null');
-
- if (is_numeric($width)) {
- return (int)$width;
- }
-
- // Fallback to environment variable
- $width = getenv('COLUMNS');
-
- if ($width !== false && is_numeric($width)) {
- return (int)$width;
- }
-
- // Default fallback
- return 80;
- }
-
- /**
- * Run all demonstrations.
- */
- private function runAllDemos(string $style, string $theme, int $width): void {
- $this->demoUserManagement($style, $theme, $width);
- $this->println('');
- $this->demoProductCatalog($style, $theme, $width);
- $this->println('');
- $this->demoServiceStatus($style, $theme, $width);
- $this->println('');
- $this->demoTableStyles($width);
- $this->println('');
- $this->demoColorThemes($width);
- }
-}
+ [
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DESCRIPTION => 'Specific demo to run (users, products, services, styles, themes, export)',
+ ArgumentOption::VALUES => ['users', 'products', 'services', 'styles', 'themes', 'export', 'all']
+ ],
+ '--style' => [
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DESCRIPTION => 'Table style to use',
+ ArgumentOption::VALUES => ['bordered', 'simple', 'minimal', 'compact', 'markdown'],
+ ArgumentOption::DEFAULT => 'bordered'
+ ],
+ '--theme' => [
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DESCRIPTION => 'Color theme to use',
+ ArgumentOption::VALUES => ['default', 'dark', 'light', 'colorful', 'professional', 'minimal'],
+ ArgumentOption::DEFAULT => 'default'
+ ],
+ '--width' => [
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DESCRIPTION => 'Maximum table width (default: auto-detect)',
+ ArgumentOption::DEFAULT => '0'
+ ]
+ ], 'Demonstrates WebFiori CLI Table display capabilities with various examples');
+ }
+
+ public function exec(): int {
+ $this->println('๐ฏ WebFiori CLI Table Feature Demonstration', ['bold' => true, 'color' => 'light-cyan']);
+ $this->println('============================================');
+ $this->println('');
+
+ $demo = $this->getArgValue('--demo') ?? 'all';
+ $style = $this->getArgValue('--style') ?? 'bordered';
+ $theme = $this->getArgValue('--theme') ?? 'default';
+ $width = (int)($this->getArgValue('--width') ?? '0');
+
+ if ($width === 0) {
+ $width = $this->getTerminalWidth();
+ }
+
+ $this->println("Configuration:", ['color' => 'yellow']);
+ $this->println(" โข Demo: $demo");
+ $this->println(" โข Style: $style");
+ $this->println(" โข Theme: $theme");
+ $this->println(" โข Width: {$width} characters");
+ $this->println('');
+
+ try {
+ switch ($demo) {
+ case 'users':
+ $this->demoUserManagement($style, $theme, $width);
+ break;
+ case 'products':
+ $this->demoProductCatalog($style, $theme, $width);
+ break;
+ case 'services':
+ $this->demoServiceStatus($style, $theme, $width);
+ break;
+ case 'styles':
+ $this->demoTableStyles($width);
+ break;
+ case 'themes':
+ $this->demoColorThemes($width);
+ break;
+ case 'export':
+ $this->demoDataExport($style, $theme, $width);
+ break;
+ case 'all':
+ default:
+ $this->runAllDemos($style, $theme, $width);
+ break;
+ }
+
+ $this->println('');
+ $this->success('โจ Table demonstration completed successfully!');
+ $this->println('');
+ $this->info('๐ก Tips:');
+ $this->println(' โข Use --demo= to run specific demonstrations');
+ $this->println(' โข Try different --style and --theme combinations');
+ $this->println(' โข Adjust --width for different terminal sizes');
+
+ return 0;
+ } catch (Exception $e) {
+ $this->error('Demo failed: '.$e->getMessage());
+
+ return 1;
+ }
+ }
+
+ /**
+ * Demonstrate color themes.
+ */
+ private function demoColorThemes(int $width): void {
+ $this->println('๐ Color Theme Showcase', ['bold' => true, 'color' => 'light-magenta']);
+ $this->println('-----------------------');
+
+ $data = [
+ ['Active', 25, '83.3%'],
+ ['Inactive', 3, '10.0%'],
+ ['Pending', 2, '6.7%']
+ ];
+
+ $themes = [
+ 'default' => 'Standard theme with basic colors',
+ 'dark' => 'Dark theme for dark terminals',
+ 'colorful' => 'Vibrant colors and styling',
+ 'professional' => 'Business-appropriate styling'
+ ];
+
+ foreach ($themes as $themeName => $description) {
+ $this->println("Theme: ".ucfirst($themeName)." ($description)", ['color' => 'yellow']);
+
+ $table = TableBuilder::create()
+ ->setHeaders(['Status', 'Count', 'Percentage'])
+ ->addRows($data)
+ ->setTheme(TableTheme::create($themeName))
+ ->setMaxWidth(min($width, 50))
+ ->configureColumn('Count', ['align' => 'right'])
+ ->configureColumn('Percentage', [
+ 'align' => 'right',
+ 'formatter' => fn($value) => str_replace('%', '', $value).'%'
+ ])
+ ->colorizeColumn('Status', function ($value) {
+ return match (strtolower($value)) {
+ 'active' => ['color' => 'green', 'bold' => true],
+ 'inactive' => ['color' => 'red'],
+ 'pending' => ['color' => 'yellow'],
+ default => []
+ };
+ });
+
+ echo $table->render();
+ $this->println('');
+ }
+
+ $this->info('Themes automatically adapt to terminal capabilities.');
+ }
+
+ /**
+ * Demonstrate data export capabilities.
+ */
+ private function demoDataExport(string $style, string $theme, int $width): void {
+ $this->println('๐พ Data Export Capabilities', ['bold' => true, 'color' => 'light-green']);
+ $this->println('---------------------------');
+
+ $exportData = [
+ ['1', 'Ahmed Hassan', 'ahmed.hassan@example.com', 'Active'],
+ ['2', 'Sarah Johnson', 'sarah.johnson@example.com', 'Inactive'],
+ ['3', 'Omar Al-Rashid', 'omar.alrashid@example.com', 'Active']
+ ];
+
+ $table = TableBuilder::create()
+ ->setHeaders(['ID', 'Name', 'Email', 'Status'])
+ ->addRows($exportData)
+ ->setTitle('Sample Export Data')
+ ->useStyle($style)
+ ->setTheme(TableTheme::create($theme))
+ ->setMaxWidth($width);
+
+ echo $table->render();
+
+ $this->println('');
+ $this->info('Export formats available:');
+ $this->println(' โข JSON format (structured data)');
+ $this->println(' โข CSV format (spreadsheet compatible)');
+ $this->println(' โข Array format (PHP arrays)');
+ $this->println(' โข Associative arrays (key-value pairs)');
+ $this->println('');
+ $this->println('Note: In a real application, you would access the TableData');
+ $this->println('object to export data in various formats.');
+ }
+
+ /**
+ * Demonstrate product catalog table.
+ */
+ private function demoProductCatalog(string $style, string $theme, int $width): void {
+ $this->println('๐๏ธ Product Catalog', ['bold' => true, 'color' => 'blue']);
+ $this->println('------------------');
+
+ $products = [
+ ['LAP001', 'MacBook Pro 16"', 2499.99, 15, 'Electronics', true, 4.8],
+ ['MOU002', 'Wireless Mouse', 29.99, 0, 'Accessories', true, 4.2],
+ ['KEY003', 'Mechanical Keyboard', 149.99, 25, 'Accessories', true, 4.6],
+ ['MON004', '4K Monitor 27"', 399.99, 8, 'Electronics', false, 4.4],
+ ['HDD005', 'External SSD 1TB', 199.99, 50, 'Storage', true, 4.7]
+ ];
+
+ $table = TableBuilder::create()
+ ->setHeaders(['SKU', 'Product Name', 'Price', 'Stock', 'Category', 'Featured', 'Rating'])
+ ->addRows($products)
+ ->setTitle('Product Inventory')
+ ->useStyle($style)
+ ->setTheme(TableTheme::create($theme))
+ ->setMaxWidth($width)
+ ->configureColumn('SKU', ['width' => 8, 'align' => 'center'])
+ ->configureColumn('Product Name', ['width' => 20, 'truncate' => true])
+ ->configureColumn('Price', [
+ 'width' => 10,
+ 'align' => 'right',
+ 'formatter' => fn($value) => '$'.number_format($value, 2)
+ ])
+ ->configureColumn('Stock', [
+ 'width' => 6,
+ 'align' => 'right',
+ 'formatter' => fn($value) => $value > 0 ? (string)$value : 'Out'
+ ])
+ ->configureColumn('Category', ['width' => 12, 'align' => 'center'])
+ ->configureColumn('Featured', [
+ 'width' => 9,
+ 'align' => 'center',
+ 'formatter' => fn($value) => $value ? 'โญ Yes' : ' No'
+ ])
+ ->configureColumn('Rating', [
+ 'width' => 7,
+ 'align' => 'center',
+ 'formatter' => fn($value) => 'โ '.number_format($value, 1)
+ ])
+ ->colorizeColumn('Stock', function ($value) {
+ if ($value === 'Out' || $value === 0) {
+ return ['color' => 'red', 'bold' => true];
+ } elseif (is_numeric($value) && $value < 10) {
+ return ['color' => 'yellow'];
+ }
+
+ return ['color' => 'green'];
+ });
+
+ echo $table->render();
+
+ $this->println('');
+ $this->info('Features demonstrated:');
+ $this->println(' โข Currency formatting');
+ $this->println(' โข Stock level indicators with colors');
+ $this->println(' โข Boolean formatting with icons');
+ $this->println(' โข Rating display with stars');
+ $this->println(' โข Product name truncation');
+ }
+
+ /**
+ * Demonstrate service status monitoring.
+ */
+ private function demoServiceStatus(string $style, string $theme, int $width): void {
+ $this->println('๐ง Service Status Monitor', ['bold' => true, 'color' => 'magenta']);
+ $this->println('-------------------------');
+
+ $services = [
+ ['Web Server', 'nginx/1.20', 'Running', '99.9%', '45ms', '2.1GB', 'โ '],
+ ['Database', 'MySQL 8.0', 'Running', '99.8%', '12ms', '4.5GB', 'โ '],
+ ['Cache Server', 'Redis 6.2', 'Stopped', '0%', 'N/A', '0MB', 'โ'],
+ ['API Gateway', 'Kong 3.0', 'Running', '99.7%', '78ms', '512MB', 'โ '],
+ ['Message Queue', 'RabbitMQ', 'Warning', '95.2%', '156ms', '1.2GB', 'โ ๏ธ'],
+ ['Load Balancer', 'HAProxy', 'Running', '100%', '5ms', '128MB', 'โ ']
+ ];
+
+ $table = TableBuilder::create()
+ ->setHeaders(['Service', 'Version', 'Status', 'Uptime', 'Response', 'Memory', 'Health'])
+ ->addRows($services)
+ ->setTitle('System Health Dashboard')
+ ->useStyle($style)
+ ->setTheme(TableTheme::create($theme))
+ ->setMaxWidth($width)
+ ->configureColumn('Service', ['width' => 14, 'align' => 'left'])
+ ->configureColumn('Version', ['width' => 12, 'align' => 'center'])
+ ->configureColumn('Status', ['width' => 10, 'align' => 'center'])
+ ->configureColumn('Uptime', ['width' => 8, 'align' => 'right'])
+ ->configureColumn('Response', ['width' => 10, 'align' => 'right'])
+ ->configureColumn('Memory', ['width' => 8, 'align' => 'right'])
+ ->configureColumn('Health', ['width' => 8, 'align' => 'center'])
+ ->colorizeColumn('Status', function ($value) {
+ return match (strtolower($value)) {
+ 'running' => ['color' => 'green', 'bold' => true],
+ 'stopped' => ['color' => 'red', 'bold' => true],
+ 'warning' => ['color' => 'yellow', 'bold' => true],
+ default => []
+ };
+ })
+ ->colorizeColumn('Health', function ($value) {
+ return match ($value) {
+ 'โ ' => ['color' => 'green'],
+ 'โ' => ['color' => 'red'],
+ 'โ ๏ธ' => ['color' => 'yellow'],
+ default => []
+ };
+ });
+
+ echo $table->render();
+
+ $this->println('');
+ $this->info('Features demonstrated:');
+ $this->println(' โข System monitoring data display');
+ $this->println(' โข Multiple status indicators');
+ $this->println(' โข Performance metrics formatting');
+ $this->println(' โข Health status with emoji indicators');
+ $this->println(' โข Memory usage display');
+ }
+
+ /**
+ * Demonstrate different table styles.
+ */
+ private function demoTableStyles(int $width): void {
+ $this->println('๐จ Table Style Variations', ['bold' => true, 'color' => 'cyan']);
+ $this->println('-------------------------');
+
+ $data = [
+ ['Coffee', '$3.50', 'Hot'],
+ ['Tea', '$2.75', 'Hot'],
+ ['Juice', '$4.25', 'Cold']
+ ];
+
+ $styles = [
+ 'bordered' => 'Unicode box-drawing characters',
+ 'simple' => 'ASCII characters for compatibility',
+ 'minimal' => 'Clean look with minimal borders',
+ 'compact' => 'Space-efficient layout',
+ 'markdown' => 'Markdown-compatible format'
+ ];
+
+ foreach ($styles as $styleName => $description) {
+ $this->println("Style: ".ucfirst($styleName)." ($description)", ['color' => 'yellow']);
+
+ $table = TableBuilder::create()
+ ->setHeaders(['Item', 'Price', 'Temperature'])
+ ->addRows($data)
+ ->useStyle($styleName)
+ ->setMaxWidth(min($width, 60)); // Limit width for style demo
+
+ echo $table->render();
+ $this->println('');
+ }
+
+ $this->info('All table styles are responsive and adapt to terminal width.');
+ }
+
+ /**
+ * Demonstrate user management table.
+ */
+ private function demoUserManagement(string $style, string $theme, int $width): void {
+ $this->println('๐ฅ User Management System', ['bold' => true, 'color' => 'green']);
+ $this->println('-------------------------');
+
+ $users = [
+ ['1', 'Ahmed Hassan', 'ahmed.hassan@example.com', 'Active', '2024-01-15', 'Admin', '$1,250.75'],
+ ['2', 'Sarah Johnson', 'sarah.johnson@example.com', 'Inactive', '2024-01-16', 'User', '$890.50'],
+ ['3', 'Omar Al-Rashid', 'omar.alrashid@example.com', 'Active', '2024-01-17', 'Manager', '$2,100.00'],
+ ['4', 'Fatima Al-Zahra', 'fatima.alzahra@example.com', 'Pending', '2024-01-18', 'User', '$750.25'],
+ ['5', 'Michael Davis', 'michael.davis@example.com', 'Active', '2024-01-19', 'Admin', '$1,800.80']
+ ];
+
+ $table = TableBuilder::create()
+ ->setHeaders(['ID', 'Name', 'Email', 'Status', 'Created', 'Role', 'Balance'])
+ ->addRows($users)
+ ->setTitle('User Management Dashboard')
+ ->useStyle($style)
+ ->setTheme(TableTheme::create($theme))
+ ->setMaxWidth($width)
+ ->configureColumn('ID', ['width' => 4, 'align' => 'center'])
+ ->configureColumn('Name', ['width' => 15, 'align' => 'left'])
+ ->configureColumn('Email', ['width' => 25, 'truncate' => true])
+ ->configureColumn('Status', ['width' => 10, 'align' => 'center'])
+ ->configureColumn('Created', [
+ 'width' => 12,
+ 'align' => 'center',
+ 'formatter' => fn($date) => date('M j, Y', strtotime($date))
+ ])
+ ->configureColumn('Role', ['width' => 8, 'align' => 'center'])
+ ->configureColumn('Balance', [
+ 'width' => 12,
+ 'align' => 'right',
+ 'formatter' => fn($value) => str_replace('$', '', $value) // Remove existing $ for proper formatting
+ ])
+ ->colorizeColumn('Status', function ($value) {
+ return match (strtolower($value)) {
+ 'active' => ['color' => 'green', 'bold' => true],
+ 'inactive' => ['color' => 'red', 'bold' => true],
+ 'pending' => ['color' => 'yellow', 'bold' => true],
+ default => []
+ };
+ });
+
+ echo $table->render();
+
+ $this->println('');
+ $this->info('Features demonstrated:');
+ $this->println(' โข Column width control and alignment');
+ $this->println(' โข Date formatting');
+ $this->println(' โข Status-based colorization');
+ $this->println(' โข Email truncation for long addresses');
+ $this->println(' โข Responsive design within terminal width');
+ }
+
+ /**
+ * Get terminal width with fallback.
+ */
+ private function getTerminalWidth(): int {
+ // Try to get terminal width
+ $width = exec('tput cols 2>/dev/null');
+
+ if (is_numeric($width)) {
+ return (int)$width;
+ }
+
+ // Fallback to environment variable
+ $width = getenv('COLUMNS');
+
+ if ($width !== false && is_numeric($width)) {
+ return (int)$width;
+ }
+
+ // Default fallback
+ return 80;
+ }
+
+ /**
+ * Run all demonstrations.
+ */
+ private function runAllDemos(string $style, string $theme, int $width): void {
+ $this->demoUserManagement($style, $theme, $width);
+ $this->println('');
+ $this->demoProductCatalog($style, $theme, $width);
+ $this->println('');
+ $this->demoServiceStatus($style, $theme, $width);
+ $this->println('');
+ $this->demoTableStyles($width);
+ $this->println('');
+ $this->demoColorThemes($width);
+ }
+}
diff --git a/examples/06-table-display/main.php b/examples/06-table-display/main.php
index 65d798f..f64c3e4 100644
--- a/examples/06-table-display/main.php
+++ b/examples/06-table-display/main.php
@@ -1,14 +1,14 @@
-register(new TableDemoCommand());
-// Start the application
-exit($runner->start());
+register(new TableDemoCommand());
+// Start the application
+exit($runner->start());
diff --git a/examples/06-table-display/simple-example.php b/examples/06-table-display/simple-example.php
index 4a0316b..e9b7706 100644
--- a/examples/06-table-display/simple-example.php
+++ b/examples/06-table-display/simple-example.php
@@ -1,59 +1,59 @@
-setHeaders(['Name', 'Age', 'City'])
- ->addRow(['Ahmed Hassan', 30, 'Cairo'])
- ->addRow(['Sarah Johnson', 25, 'Los Angeles'])
- ->addRow(['Omar Al-Rashid', 35, 'Dubai']);
-
-echo $basicTable->render()."\n\n";
-
-// Example 2: Formatted table with colors
-echo "Example 2: Formatted Table with Colors\n";
-echo "--------------------------------------\n";
-
-$formattedTable = TableBuilder::create()
- ->setHeaders(['Product', 'Price', 'Status'])
- ->addRow(['Laptop', 1299.99, 'Available'])
- ->addRow(['Mouse', 29.99, 'Out of Stock'])
- ->addRow(['Keyboard', 89.99, 'Available'])
- ->configureColumn('Price', [
- 'align' => 'right',
- 'formatter' => fn($value) => '$'.number_format($value, 2)
- ])
- ->colorizeColumn('Status', function ($value) {
- return match ($value) {
- 'Available' => ['color' => 'green', 'bold' => true],
- 'Out of Stock' => ['color' => 'red', 'bold' => true],
- default => []
- };
- });
-
-echo $formattedTable->render()."\n\n";
-
-echo "โจ Simple examples completed successfully!\n";
+setHeaders(['Name', 'Age', 'City'])
+ ->addRow(['Ahmed Hassan', 30, 'Cairo'])
+ ->addRow(['Sarah Johnson', 25, 'Los Angeles'])
+ ->addRow(['Omar Al-Rashid', 35, 'Dubai']);
+
+echo $basicTable->render()."\n\n";
+
+// Example 2: Formatted table with colors
+echo "Example 2: Formatted Table with Colors\n";
+echo "--------------------------------------\n";
+
+$formattedTable = TableBuilder::create()
+ ->setHeaders(['Product', 'Price', 'Status'])
+ ->addRow(['Laptop', 1299.99, 'Available'])
+ ->addRow(['Mouse', 29.99, 'Out of Stock'])
+ ->addRow(['Keyboard', 89.99, 'Available'])
+ ->configureColumn('Price', [
+ 'align' => 'right',
+ 'formatter' => fn($value) => '$'.number_format($value, 2)
+ ])
+ ->colorizeColumn('Status', function ($value) {
+ return match ($value) {
+ 'Available' => ['color' => 'green', 'bold' => true],
+ 'Out of Stock' => ['color' => 'red', 'bold' => true],
+ default => []
+ };
+ });
+
+echo $formattedTable->render()."\n\n";
+
+echo "โจ Simple examples completed successfully!\n";
diff --git a/examples/07-progress-bars/ProgressDemoCommand.php b/examples/07-progress-bars/ProgressDemoCommand.php
index 97d748e..4f96d3f 100644
--- a/examples/07-progress-bars/ProgressDemoCommand.php
+++ b/examples/07-progress-bars/ProgressDemoCommand.php
@@ -1,210 +1,210 @@
- [
- ArgumentOption::DESCRIPTION => 'Progress bar style (default, ascii, dots, arrow)',
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DEFAULT => 'all',
- ArgumentOption::VALUES => ['all', 'default', 'ascii', 'dots', 'arrow', 'custom']
- ],
- '--items' => [
- ArgumentOption::DESCRIPTION => 'Number of items to process (10-1000)',
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DEFAULT => '50'
- ],
- '--delay' => [
- ArgumentOption::DESCRIPTION => 'Delay between items in milliseconds',
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DEFAULT => '100'
- ],
- '--format' => [
- ArgumentOption::DESCRIPTION => 'Progress bar format template',
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::VALUES => ['basic', 'eta', 'rate', 'verbose', 'custom']
- ]
- ], 'Demonstrates progress bar functionality with different styles and formats');
- }
-
- public function exec(): int {
- $style = $this->getArgValue('--style') ?? 'all';
- $items = (int)($this->getArgValue('--items') ?? 50);
- $delay = (int)($this->getArgValue('--delay') ?? 100);
- $format = $this->getArgValue('--format');
-
- // Validate inputs
- if ($items < 10 || $items > 1000) {
- $this->error('Number of items must be between 10 and 1000');
-
- return 1;
- }
-
- if ($delay < 10 || $delay > 2000) {
- $this->error('Delay must be between 10 and 2000 milliseconds');
-
- return 1;
- }
-
- $this->showHeader($style, $items, $delay);
-
- if ($style === 'all') {
- $this->demonstrateAllStyles($items, $delay, $format);
- } else {
- $this->demonstrateStyle($style, $items, $delay, $format);
- }
-
- $this->showFooter();
-
- return 0;
- }
-
- /**
- * Demonstrate all available styles.
- */
- private function demonstrateAllStyles(int $items, int $delay, ?string $format): void {
- $styles = [
- 'default' => 'Default Style (Unicode)',
- 'ascii' => 'ASCII Style (Compatible)',
- 'dots' => 'Dots Style (Circular)',
- 'arrow' => 'Arrow Style (Directional)'
- ];
-
- foreach ($styles as $styleKey => $styleTitle) {
- $this->info("๐จ $styleTitle");
- $this->demonstrateStyle($styleKey, $items, $delay, $format);
- $this->println();
-
- // Brief pause between styles
- if ($styleKey !== 'arrow') {
- usleep(500000); // 0.5 seconds
- }
- }
-
- // Custom style demonstration
- $this->info("๐จ Custom Style (Emoji)");
- $this->demonstrateCustomStyle($items, $delay);
- }
-
- /**
- * Demonstrate custom style with emojis.
- */
- private function demonstrateCustomStyle(int $items, int $delay): void {
- $customStyle = new ProgressBarStyle('๐ฉ', 'โฌ', '๐จ');
-
- $progressBar = $this->createProgressBar($items)
- ->setStyle($customStyle)
- ->setFormat('๐ {message} [{bar}] {percent}% | โก {rate}/s | โฑ๏ธ {eta}')
- ->setWidth(30);
-
- $progressBar->start('Processing with emoji style...');
-
- for ($i = 0; $i < $items; $i++) {
- usleep($delay * 1000);
- $progressBar->advance();
- }
-
- $progressBar->finish('๐ Emoji processing complete!');
- }
-
- /**
- * Demonstrate a specific style.
- */
- private function demonstrateStyle(string $style, int $items, int $delay, ?string $format): void {
- $progressBar = $this->createProgressBar($items);
-
- // Apply style
- switch ($style) {
- case 'default':
- $progressBar->setStyle(ProgressBarStyle::DEFAULT);
- break;
- case 'ascii':
- $progressBar->setStyle(ProgressBarStyle::ASCII);
- break;
- case 'dots':
- $progressBar->setStyle(ProgressBarStyle::DOTS);
- break;
- case 'arrow':
- $progressBar->setStyle(ProgressBarStyle::ARROW);
- break;
- case 'custom':
- $this->demonstrateCustomStyle($items, $delay);
-
- return;
- }
-
- // Apply format
- if ($format) {
- $progressBar->setFormat($this->getFormatTemplate($format));
- }
-
- // Configure progress bar
- $progressBar->setWidth(40)
- ->setUpdateThrottle(0.05); // Update every 50ms
-
- // Start processing
- $progressBar->start("Processing with $style style...");
-
- for ($i = 0; $i < $items; $i++) {
- // Simulate work
- usleep($delay * 1000);
- $progressBar->advance();
- }
-
- $progressBar->finish('Complete!');
- }
-
- /**
- * Get format template by name.
- */
- private function getFormatTemplate(string $format): string {
- return match ($format) {
- 'basic' => ProgressBarFormat::DEFAULT_FORMAT,
- 'eta' => ProgressBarFormat::ETA_FORMAT,
- 'rate' => ProgressBarFormat::RATE_FORMAT,
- 'verbose' => ProgressBarFormat::VERBOSE_FORMAT,
- 'custom' => '๐ [{bar}] {percent}% | ๐ {current}/{total} | ๐ {elapsed} | ๐พ {memory}',
- default => ProgressBarFormat::DEFAULT_FORMAT
- };
- }
-
- /**
- * Show demonstration footer.
- */
- private function showFooter(): void {
- $this->println();
- $this->success("โจ Progress bar demonstration completed!");
- $this->info("๐ก Try different combinations of --style, --items, and --delay");
- }
-
- /**
- * Show demonstration header.
- */
- private function showHeader(string $style, int $items, int $delay): void {
- $this->println("๐ฏ Progress Bar Demonstration");
- $this->println("=============================");
- $this->println();
-
- $this->info("๐ Demo Configuration:");
- $this->println(" โข Style: ".($style === 'all' ? 'All styles' : ucfirst($style)));
- $this->println(" โข Items: $items");
- $this->println(" โข Delay: {$delay}ms per item");
- $this->println(" โข Estimated time: ".round(($items * $delay) / 1000, 1)." seconds");
- $this->println();
- }
-}
+ [
+ ArgumentOption::DESCRIPTION => 'Progress bar style (default, ascii, dots, arrow)',
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DEFAULT => 'all',
+ ArgumentOption::VALUES => ['all', 'default', 'ascii', 'dots', 'arrow', 'custom']
+ ],
+ '--items' => [
+ ArgumentOption::DESCRIPTION => 'Number of items to process (10-1000)',
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DEFAULT => '50'
+ ],
+ '--delay' => [
+ ArgumentOption::DESCRIPTION => 'Delay between items in milliseconds',
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DEFAULT => '100'
+ ],
+ '--format' => [
+ ArgumentOption::DESCRIPTION => 'Progress bar format template',
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::VALUES => ['basic', 'eta', 'rate', 'verbose', 'custom']
+ ]
+ ], 'Demonstrates progress bar functionality with different styles and formats');
+ }
+
+ public function exec(): int {
+ $style = $this->getArgValue('--style') ?? 'all';
+ $items = (int)($this->getArgValue('--items') ?? 50);
+ $delay = (int)($this->getArgValue('--delay') ?? 100);
+ $format = $this->getArgValue('--format');
+
+ // Validate inputs
+ if ($items < 10 || $items > 1000) {
+ $this->error('Number of items must be between 10 and 1000');
+
+ return 1;
+ }
+
+ if ($delay < 10 || $delay > 2000) {
+ $this->error('Delay must be between 10 and 2000 milliseconds');
+
+ return 1;
+ }
+
+ $this->showHeader($style, $items, $delay);
+
+ if ($style === 'all') {
+ $this->demonstrateAllStyles($items, $delay, $format);
+ } else {
+ $this->demonstrateStyle($style, $items, $delay, $format);
+ }
+
+ $this->showFooter();
+
+ return 0;
+ }
+
+ /**
+ * Demonstrate all available styles.
+ */
+ private function demonstrateAllStyles(int $items, int $delay, ?string $format): void {
+ $styles = [
+ 'default' => 'Default Style (Unicode)',
+ 'ascii' => 'ASCII Style (Compatible)',
+ 'dots' => 'Dots Style (Circular)',
+ 'arrow' => 'Arrow Style (Directional)'
+ ];
+
+ foreach ($styles as $styleKey => $styleTitle) {
+ $this->info("๐จ $styleTitle");
+ $this->demonstrateStyle($styleKey, $items, $delay, $format);
+ $this->println();
+
+ // Brief pause between styles
+ if ($styleKey !== 'arrow') {
+ usleep(500000); // 0.5 seconds
+ }
+ }
+
+ // Custom style demonstration
+ $this->info("๐จ Custom Style (Emoji)");
+ $this->demonstrateCustomStyle($items, $delay);
+ }
+
+ /**
+ * Demonstrate custom style with emojis.
+ */
+ private function demonstrateCustomStyle(int $items, int $delay): void {
+ $customStyle = new ProgressBarStyle('๐ฉ', 'โฌ', '๐จ');
+
+ $progressBar = $this->createProgressBar($items)
+ ->setStyle($customStyle)
+ ->setFormat('๐ {message} [{bar}] {percent}% | โก {rate}/s | โฑ๏ธ {eta}')
+ ->setWidth(30);
+
+ $progressBar->start('Processing with emoji style...');
+
+ for ($i = 0; $i < $items; $i++) {
+ usleep($delay * 1000);
+ $progressBar->advance();
+ }
+
+ $progressBar->finish('๐ Emoji processing complete!');
+ }
+
+ /**
+ * Demonstrate a specific style.
+ */
+ private function demonstrateStyle(string $style, int $items, int $delay, ?string $format): void {
+ $progressBar = $this->createProgressBar($items);
+
+ // Apply style
+ switch ($style) {
+ case 'default':
+ $progressBar->setStyle(ProgressBarStyle::DEFAULT);
+ break;
+ case 'ascii':
+ $progressBar->setStyle(ProgressBarStyle::ASCII);
+ break;
+ case 'dots':
+ $progressBar->setStyle(ProgressBarStyle::DOTS);
+ break;
+ case 'arrow':
+ $progressBar->setStyle(ProgressBarStyle::ARROW);
+ break;
+ case 'custom':
+ $this->demonstrateCustomStyle($items, $delay);
+
+ return;
+ }
+
+ // Apply format
+ if ($format) {
+ $progressBar->setFormat($this->getFormatTemplate($format));
+ }
+
+ // Configure progress bar
+ $progressBar->setWidth(40)
+ ->setUpdateThrottle(0.05); // Update every 50ms
+
+ // Start processing
+ $progressBar->start("Processing with $style style...");
+
+ for ($i = 0; $i < $items; $i++) {
+ // Simulate work
+ usleep($delay * 1000);
+ $progressBar->advance();
+ }
+
+ $progressBar->finish('Complete!');
+ }
+
+ /**
+ * Get format template by name.
+ */
+ private function getFormatTemplate(string $format): string {
+ return match ($format) {
+ 'basic' => ProgressBarFormat::DEFAULT_FORMAT,
+ 'eta' => ProgressBarFormat::ETA_FORMAT,
+ 'rate' => ProgressBarFormat::RATE_FORMAT,
+ 'verbose' => ProgressBarFormat::VERBOSE_FORMAT,
+ 'custom' => '๐ [{bar}] {percent}% | ๐ {current}/{total} | ๐ {elapsed} | ๐พ {memory}',
+ default => ProgressBarFormat::DEFAULT_FORMAT
+ };
+ }
+
+ /**
+ * Show demonstration footer.
+ */
+ private function showFooter(): void {
+ $this->println();
+ $this->success("โจ Progress bar demonstration completed!");
+ $this->info("๐ก Try different combinations of --style, --items, and --delay");
+ }
+
+ /**
+ * Show demonstration header.
+ */
+ private function showHeader(string $style, int $items, int $delay): void {
+ $this->println("๐ฏ Progress Bar Demonstration");
+ $this->println("=============================");
+ $this->println();
+
+ $this->info("๐ Demo Configuration:");
+ $this->println(" โข Style: ".($style === 'all' ? 'All styles' : ucfirst($style)));
+ $this->println(" โข Items: $items");
+ $this->println(" โข Delay: {$delay}ms per item");
+ $this->println(" โข Estimated time: ".round(($items * $delay) / 1000, 1)." seconds");
+ $this->println();
+ }
+}
diff --git a/examples/07-progress-bars/README.md b/examples/07-progress-bars/README.md
index 1b3b6a4..7afe912 100644
--- a/examples/07-progress-bars/README.md
+++ b/examples/07-progress-bars/README.md
@@ -1,325 +1,325 @@
-# Progress Bars Example
-
-This example demonstrates the comprehensive progress bar system in WebFiori CLI, showcasing various styles, formats, and real-time progress tracking capabilities.
-
-## ๐ฏ What You'll Learn
-
-- Creating and customizing progress bars with different styles
-- Real-time progress tracking and updates
-- Progress bar formats and display options
-- Performance monitoring with rate calculations
-- Integration with long-running operations
-- Error handling and validation
-
-## ๐ Files
-
-- `ProgressDemoCommand.php` - Comprehensive progress bar demonstrations
-- `main.php` - Application entry point
-- `README.md` - This documentation
-
-## ๐ Running the Example
-
-### Basic Usage
-```bash
-# Show all progress bar styles
-php main.php progress-demo
-
-# Show help
-php main.php help --command=progress-demo
-```
-
-### Style Demonstrations
-```bash
-# All styles demonstration
-php main.php progress-demo --style=all --items=20 --delay=50
-
-# Individual styles
-php main.php progress-demo --style=default --items=10 --delay=100
-php main.php progress-demo --style=ascii --items=50 --delay=20
-php main.php progress-demo --style=dots --items=15 --delay=80
-php main.php progress-demo --style=arrow --items=25 --delay=40
-php main.php progress-demo --style=custom --items=12 --delay=150
-```
-
-### Format Options
-```bash
-# Different format templates
-php main.php progress-demo --style=dots --format=eta --items=15
-php main.php progress-demo --style=arrow --format=rate --items=25
-php main.php progress-demo --style=custom --format=verbose --items=12
-```
-
-### Performance Testing
-```bash
-# Quick demo (minimum items)
-php main.php progress-demo --style=default --items=10 --delay=50
-
-# Longer demo (more items)
-php main.php progress-demo --style=ascii --items=100 --delay=10
-
-# Slow demo (longer delays)
-php main.php progress-demo --style=dots --items=20 --delay=200
-```
-
-## ๐ Available Options
-
-### Styles (`--style`)
-- `default` - Unicode block characters (โโ) - Modern terminals
-- `ascii` - ASCII characters (=->) - Maximum compatibility
-- `dots` - Circular dots (โโ) - Clean appearance
-- `arrow` - Directional arrows (โถโท) - Visual flow indication
-- `custom` - Emoji style (๐ฉโฌ) - Modern and colorful
-- `all` - Demonstrate all styles sequentially
-
-### Parameters
-- `--items` - Number of items to process (10-1000, default: 50)
-- `--delay` - Delay between items in milliseconds (default: 100)
-- `--format` - Progress bar format template (eta, rate, verbose)
-
-### Validation Rules
-- Items must be between 10 and 1000
-- Delay can be any positive integer
-- Invalid values show helpful error messages
-
-## ๐จ Example Output
-
-### All Styles Demonstration
-```
-๐ฏ Progress Bar Demonstration
-=============================
-
-๐ Demo Configuration:
- โข Style: All styles
- โข Items: 20
- โข Delay: 50ms per item
- โข Estimated time: 1 seconds
-
-๐จ Default Style (Unicode)
-Processing with default style... [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 100.0% (20/20)
-Complete! [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 100.0% (20/20)
-
-๐จ ASCII Style (Compatible)
-Processing with ascii style... [========================================] 100.0% (20/20)
-Complete! [========================================] 100.0% (20/20)
-
-๐จ Dots Style (Circular)
-Processing with dots style... [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 100.0% (20/20)
-Complete! [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 100.0% (20/20)
-
-๐จ Arrow Style (Directional)
-Processing with arrow style... [โถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถ] 100.0% (20/20)
-Complete! [โถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถ] 100.0% (20/20)
-
-๐จ Custom Style (Emoji)
-Processing with emoji style... ๐ {message} [๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ] 100.0% | โก 20/s | โฑ๏ธ 00:00
-๐ Emoji processing complete! ๐ {message} [๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ] 100.0% | โก 20/s | โฑ๏ธ 00:00
-
-โจ Progress bar demonstration completed!
-```
-
-### Individual Style Examples
-
-#### Default Style (Unicode)
-```
-Processing with default style... [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 50.0% (5/10)
-Processing with default style... [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 100.0% (10/10)
-Complete! [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 100.0% (10/10)
-```
-
-#### ASCII Style (Compatible)
-```
-Processing with ascii style... [====================--------------------] 50.0% (25/50)
-Processing with ascii style... [========================================] 100.0% (50/50)
-Complete! [========================================] 100.0% (50/50)
-```
-
-#### Dots Style (Circular)
-```
-Processing with dots style... [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 40.0% (6/15) ETA: 00:00
-Processing with dots style... [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 100.0% (15/15) ETA: 00:00
-Complete! [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 100.0% (15/15) ETA: 00:00
-```
-
-#### Arrow Style (Directional)
-```
-Processing with arrow style... [โถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโทโทโทโทโทโทโทโทโทโทโทโทโทโทโทโทโทโทโทโทโทโทโทโท] 40.0% (10/25) 25/s
-Processing with arrow style... [โถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถ] 100.0% (25/25) 25/s
-Complete! [โถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถ] 100.0% (25/25) 25/s
-```
-
-#### Custom Style (Emoji with Verbose Format)
-```
-Processing with emoji style... ๐ {message} [๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉโฌโฌโฌโฌโฌโฌโฌโฌโฌโฌโฌโฌโฌโฌโฌ] 50.0% | โก 6.6/s | โฑ๏ธ 00:00
-Processing with emoji style... ๐ {message} [๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ] 100.0% | โก 6.6/s | โฑ๏ธ 00:00
-๐ Emoji processing complete! ๐ {message} [๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ] 100.0% | โก 6.6/s | โฑ๏ธ 00:00
-```
-
-### Error Handling
-```
-# Invalid item count (too low)
-php main.php progress-demo --items=5
-Error: Number of items must be between 10 and 1000
-
-# Invalid item count (too high)
-php main.php progress-demo --items=1001
-Error: Number of items must be between 10 and 1000
-```
-
-## ๐งช Test Scenarios
-
-### 1. All Styles Demo
-```bash
-php main.php progress-demo --style=all --items=20 --delay=50
-# Shows all 5 styles in sequence with consistent parameters
-```
-
-### 2. Performance Comparison
-```bash
-# Fast processing
-php main.php progress-demo --style=ascii --items=50 --delay=20
-
-# Medium processing
-php main.php progress-demo --style=default --items=25 --delay=100
-
-# Slow processing
-php main.php progress-demo --style=custom --items=12 --delay=150
-```
-
-### 3. Format Testing
-```bash
-# ETA format
-php main.php progress-demo --style=dots --format=eta --items=15
-
-# Rate format
-php main.php progress-demo --style=arrow --format=rate --items=25
-
-# Verbose format
-php main.php progress-demo --style=custom --format=verbose --items=12
-```
-
-### 4. Edge Cases
-```bash
-# Minimum items
-php main.php progress-demo --style=default --items=10 --delay=50
-
-# Maximum items (test with caution - takes time)
-php main.php progress-demo --style=ascii --items=1000 --delay=1
-
-# Boundary validation
-php main.php progress-demo --items=9 # Error: too low
-php main.php progress-demo --items=1001 # Error: too high
-```
-
-### 5. Style Comparison
-```bash
-# Unicode vs ASCII compatibility
-php main.php progress-demo --style=default --items=20 --delay=50
-php main.php progress-demo --style=ascii --items=20 --delay=50
-
-# Visual styles comparison
-php main.php progress-demo --style=dots --items=20 --delay=50
-php main.php progress-demo --style=arrow --items=20 --delay=50
-php main.php progress-demo --style=custom --items=20 --delay=50
-```
-
-## ๐ก Key Features Demonstrated
-
-### 1. Real-Time Updates
-- **Live Progress**: Updates show in real-time as work progresses
-- **Percentage Display**: Current completion percentage
-- **Item Counters**: Current/total item counts
-- **Rate Calculation**: Items processed per second
-- **ETA Estimation**: Estimated time to completion
-
-### 2. Visual Styles
-- **Unicode Blocks**: Modern terminals with full block characters
-- **ASCII Compatible**: Works on all terminal types
-- **Dot Indicators**: Clean circular progress indicators
-- **Arrow Flow**: Directional progress indication
-- **Emoji Style**: Modern colorful progress with emojis
-
-### 3. Format Templates
-- **Basic Format**: `[bar] percentage (current/total)`
-- **ETA Format**: Includes estimated time remaining
-- **Rate Format**: Shows processing speed
-- **Verbose Format**: All metrics with emojis and timing
-
-### 4. Performance Metrics
-- **Processing Rate**: Items per second calculation
-- **Time Tracking**: Elapsed and estimated time
-- **Progress Percentage**: Accurate completion percentage
-- **Item Counting**: Current and total item tracking
-
-## ๐ง Technical Implementation
-
-### Core Classes Used
-- `ProgressDemoCommand`: Main demonstration command
-- `ProgressBarFormat`: Format template definitions
-- `ProgressBar`: Core progress bar functionality
-- `ArgumentOption`: Command argument configuration
-
-### Key Methods
-- `demonstrateStyle()`: Individual style demonstrations
-- `createProgressBar()`: Progress bar creation and setup
-- `simulateWork()`: Work simulation with delays
-- `validateParameters()`: Input validation and error handling
-
-### Configuration Options
-- Style selection and character definitions
-- Format template customization
-- Timing and delay controls
-- Item count validation and limits
-
-## ๐ฏ Best Practices Demonstrated
-
-### 1. User Experience
-- Clear visual progress indication
-- Consistent formatting across styles
-- Helpful error messages for invalid input
-- Estimated completion times
-
-### 2. Performance
-- Efficient real-time updates
-- Minimal CPU overhead during updates
-- Accurate rate calculations
-- Responsive progress tracking
-
-### 3. Compatibility
-- ASCII fallback for older terminals
-- Unicode support for modern terminals
-- Cross-platform character support
-- Terminal width adaptation
-
-### 4. Validation
-- Input parameter validation
-- Helpful error messages
-- Boundary checking (10-1000 items)
-- Type validation for arguments
-
-## ๐ Related Examples
-
-- **[04-output-formatting](../04-output-formatting/)** - ANSI colors and formatting
-- **[06-table-display](../06-table-display/)** - Data presentation techniques
-- **[08-file-processing](../08-file-processing/)** - File operations with progress
-- **[10-multi-command-app](../10-multi-command-app/)** - Complete CLI applications
-## Related Examples
-
-### Prerequisites
-- **[01-basic-hello-world](../01-basic-hello-world/)** - Basic command structure
-- **[04-output-formatting](../04-output-formatting/)** - Colors and formatting
-
-### Visual Enhancement
-- **[06-table-display](../06-table-display/)** - Structured data display
-- **[05-interactive-commands](../05-interactive-commands/)** - Interactive workflows with progress
-
-### Long-Running Operations
-- **[08-file-processing](../08-file-processing/)** - File operations with progress tracking
-- **[09-database-ops](../09-database-ops/)** - Database operations with progress indicators
-- **[03-user-input](../03-user-input/)** - Multi-step processes with progress
-
-### Complete Applications
-- **[10-multi-command-app](../10-multi-command-app/)** - Full applications with progress feedback
-- **[02-arguments-and-options](../02-arguments-and-options/)** - Commands with progress reporting
-
-### Development Tools
-- **[12-command-scaffolding](../12-command-scaffolding/)** - Generate commands with progress bars
+# Progress Bars Example
+
+This example demonstrates the comprehensive progress bar system in WebFiori CLI, showcasing various styles, formats, and real-time progress tracking capabilities.
+
+## ๐ฏ What You'll Learn
+
+- Creating and customizing progress bars with different styles
+- Real-time progress tracking and updates
+- Progress bar formats and display options
+- Performance monitoring with rate calculations
+- Integration with long-running operations
+- Error handling and validation
+
+## ๐ Files
+
+- `ProgressDemoCommand.php` - Comprehensive progress bar demonstrations
+- `main.php` - Application entry point
+- `README.md` - This documentation
+
+## ๐ Running the Example
+
+### Basic Usage
+```bash
+# Show all progress bar styles
+php main.php progress-demo
+
+# Show help
+php main.php help --command=progress-demo
+```
+
+### Style Demonstrations
+```bash
+# All styles demonstration
+php main.php progress-demo --style=all --items=20 --delay=50
+
+# Individual styles
+php main.php progress-demo --style=default --items=10 --delay=100
+php main.php progress-demo --style=ascii --items=50 --delay=20
+php main.php progress-demo --style=dots --items=15 --delay=80
+php main.php progress-demo --style=arrow --items=25 --delay=40
+php main.php progress-demo --style=custom --items=12 --delay=150
+```
+
+### Format Options
+```bash
+# Different format templates
+php main.php progress-demo --style=dots --format=eta --items=15
+php main.php progress-demo --style=arrow --format=rate --items=25
+php main.php progress-demo --style=custom --format=verbose --items=12
+```
+
+### Performance Testing
+```bash
+# Quick demo (minimum items)
+php main.php progress-demo --style=default --items=10 --delay=50
+
+# Longer demo (more items)
+php main.php progress-demo --style=ascii --items=100 --delay=10
+
+# Slow demo (longer delays)
+php main.php progress-demo --style=dots --items=20 --delay=200
+```
+
+## ๐ Available Options
+
+### Styles (`--style`)
+- `default` - Unicode block characters (โโ) - Modern terminals
+- `ascii` - ASCII characters (=->) - Maximum compatibility
+- `dots` - Circular dots (โโ) - Clean appearance
+- `arrow` - Directional arrows (โถโท) - Visual flow indication
+- `custom` - Emoji style (๐ฉโฌ) - Modern and colorful
+- `all` - Demonstrate all styles sequentially
+
+### Parameters
+- `--items` - Number of items to process (10-1000, default: 50)
+- `--delay` - Delay between items in milliseconds (default: 100)
+- `--format` - Progress bar format template (eta, rate, verbose)
+
+### Validation Rules
+- Items must be between 10 and 1000
+- Delay can be any positive integer
+- Invalid values show helpful error messages
+
+## ๐จ Example Output
+
+### All Styles Demonstration
+```
+๐ฏ Progress Bar Demonstration
+=============================
+
+๐ Demo Configuration:
+ โข Style: All styles
+ โข Items: 20
+ โข Delay: 50ms per item
+ โข Estimated time: 1 seconds
+
+๐จ Default Style (Unicode)
+Processing with default style... [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 100.0% (20/20)
+Complete! [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 100.0% (20/20)
+
+๐จ ASCII Style (Compatible)
+Processing with ascii style... [========================================] 100.0% (20/20)
+Complete! [========================================] 100.0% (20/20)
+
+๐จ Dots Style (Circular)
+Processing with dots style... [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 100.0% (20/20)
+Complete! [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 100.0% (20/20)
+
+๐จ Arrow Style (Directional)
+Processing with arrow style... [โถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถ] 100.0% (20/20)
+Complete! [โถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถ] 100.0% (20/20)
+
+๐จ Custom Style (Emoji)
+Processing with emoji style... ๐ {message} [๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ] 100.0% | โก 20/s | โฑ๏ธ 00:00
+๐ Emoji processing complete! ๐ {message} [๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ] 100.0% | โก 20/s | โฑ๏ธ 00:00
+
+โจ Progress bar demonstration completed!
+```
+
+### Individual Style Examples
+
+#### Default Style (Unicode)
+```
+Processing with default style... [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 50.0% (5/10)
+Processing with default style... [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 100.0% (10/10)
+Complete! [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 100.0% (10/10)
+```
+
+#### ASCII Style (Compatible)
+```
+Processing with ascii style... [====================--------------------] 50.0% (25/50)
+Processing with ascii style... [========================================] 100.0% (50/50)
+Complete! [========================================] 100.0% (50/50)
+```
+
+#### Dots Style (Circular)
+```
+Processing with dots style... [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 40.0% (6/15) ETA: 00:00
+Processing with dots style... [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 100.0% (15/15) ETA: 00:00
+Complete! [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 100.0% (15/15) ETA: 00:00
+```
+
+#### Arrow Style (Directional)
+```
+Processing with arrow style... [โถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโทโทโทโทโทโทโทโทโทโทโทโทโทโทโทโทโทโทโทโทโทโทโทโท] 40.0% (10/25) 25/s
+Processing with arrow style... [โถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถ] 100.0% (25/25) 25/s
+Complete! [โถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถโถ] 100.0% (25/25) 25/s
+```
+
+#### Custom Style (Emoji with Verbose Format)
+```
+Processing with emoji style... ๐ {message} [๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉโฌโฌโฌโฌโฌโฌโฌโฌโฌโฌโฌโฌโฌโฌโฌ] 50.0% | โก 6.6/s | โฑ๏ธ 00:00
+Processing with emoji style... ๐ {message} [๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ] 100.0% | โก 6.6/s | โฑ๏ธ 00:00
+๐ Emoji processing complete! ๐ {message} [๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ๐ฉ] 100.0% | โก 6.6/s | โฑ๏ธ 00:00
+```
+
+### Error Handling
+```
+# Invalid item count (too low)
+php main.php progress-demo --items=5
+Error: Number of items must be between 10 and 1000
+
+# Invalid item count (too high)
+php main.php progress-demo --items=1001
+Error: Number of items must be between 10 and 1000
+```
+
+## ๐งช Test Scenarios
+
+### 1. All Styles Demo
+```bash
+php main.php progress-demo --style=all --items=20 --delay=50
+# Shows all 5 styles in sequence with consistent parameters
+```
+
+### 2. Performance Comparison
+```bash
+# Fast processing
+php main.php progress-demo --style=ascii --items=50 --delay=20
+
+# Medium processing
+php main.php progress-demo --style=default --items=25 --delay=100
+
+# Slow processing
+php main.php progress-demo --style=custom --items=12 --delay=150
+```
+
+### 3. Format Testing
+```bash
+# ETA format
+php main.php progress-demo --style=dots --format=eta --items=15
+
+# Rate format
+php main.php progress-demo --style=arrow --format=rate --items=25
+
+# Verbose format
+php main.php progress-demo --style=custom --format=verbose --items=12
+```
+
+### 4. Edge Cases
+```bash
+# Minimum items
+php main.php progress-demo --style=default --items=10 --delay=50
+
+# Maximum items (test with caution - takes time)
+php main.php progress-demo --style=ascii --items=1000 --delay=1
+
+# Boundary validation
+php main.php progress-demo --items=9 # Error: too low
+php main.php progress-demo --items=1001 # Error: too high
+```
+
+### 5. Style Comparison
+```bash
+# Unicode vs ASCII compatibility
+php main.php progress-demo --style=default --items=20 --delay=50
+php main.php progress-demo --style=ascii --items=20 --delay=50
+
+# Visual styles comparison
+php main.php progress-demo --style=dots --items=20 --delay=50
+php main.php progress-demo --style=arrow --items=20 --delay=50
+php main.php progress-demo --style=custom --items=20 --delay=50
+```
+
+## ๐ก Key Features Demonstrated
+
+### 1. Real-Time Updates
+- **Live Progress**: Updates show in real-time as work progresses
+- **Percentage Display**: Current completion percentage
+- **Item Counters**: Current/total item counts
+- **Rate Calculation**: Items processed per second
+- **ETA Estimation**: Estimated time to completion
+
+### 2. Visual Styles
+- **Unicode Blocks**: Modern terminals with full block characters
+- **ASCII Compatible**: Works on all terminal types
+- **Dot Indicators**: Clean circular progress indicators
+- **Arrow Flow**: Directional progress indication
+- **Emoji Style**: Modern colorful progress with emojis
+
+### 3. Format Templates
+- **Basic Format**: `[bar] percentage (current/total)`
+- **ETA Format**: Includes estimated time remaining
+- **Rate Format**: Shows processing speed
+- **Verbose Format**: All metrics with emojis and timing
+
+### 4. Performance Metrics
+- **Processing Rate**: Items per second calculation
+- **Time Tracking**: Elapsed and estimated time
+- **Progress Percentage**: Accurate completion percentage
+- **Item Counting**: Current and total item tracking
+
+## ๐ง Technical Implementation
+
+### Core Classes Used
+- `ProgressDemoCommand`: Main demonstration command
+- `ProgressBarFormat`: Format template definitions
+- `ProgressBar`: Core progress bar functionality
+- `ArgumentOption`: Command argument configuration
+
+### Key Methods
+- `demonstrateStyle()`: Individual style demonstrations
+- `createProgressBar()`: Progress bar creation and setup
+- `simulateWork()`: Work simulation with delays
+- `validateParameters()`: Input validation and error handling
+
+### Configuration Options
+- Style selection and character definitions
+- Format template customization
+- Timing and delay controls
+- Item count validation and limits
+
+## ๐ฏ Best Practices Demonstrated
+
+### 1. User Experience
+- Clear visual progress indication
+- Consistent formatting across styles
+- Helpful error messages for invalid input
+- Estimated completion times
+
+### 2. Performance
+- Efficient real-time updates
+- Minimal CPU overhead during updates
+- Accurate rate calculations
+- Responsive progress tracking
+
+### 3. Compatibility
+- ASCII fallback for older terminals
+- Unicode support for modern terminals
+- Cross-platform character support
+- Terminal width adaptation
+
+### 4. Validation
+- Input parameter validation
+- Helpful error messages
+- Boundary checking (10-1000 items)
+- Type validation for arguments
+
+## ๐ Related Examples
+
+- **[04-output-formatting](../04-output-formatting/)** - ANSI colors and formatting
+- **[06-table-display](../06-table-display/)** - Data presentation techniques
+- **[08-file-processing](../08-file-processing/)** - File operations with progress
+- **[10-multi-command-app](../10-multi-command-app/)** - Complete CLI applications
+## Related Examples
+
+### Prerequisites
+- **[01-basic-hello-world](../01-basic-hello-world/)** - Basic command structure
+- **[04-output-formatting](../04-output-formatting/)** - Colors and formatting
+
+### Visual Enhancement
+- **[06-table-display](../06-table-display/)** - Structured data display
+- **[05-interactive-commands](../05-interactive-commands/)** - Interactive workflows with progress
+
+### Long-Running Operations
+- **[08-file-processing](../08-file-processing/)** - File operations with progress tracking
+- **[09-database-ops](../09-database-ops/)** - Database operations with progress indicators
+- **[03-user-input](../03-user-input/)** - Multi-step processes with progress
+
+### Complete Applications
+- **[10-multi-command-app](../10-multi-command-app/)** - Full applications with progress feedback
+- **[02-arguments-and-options](../02-arguments-and-options/)** - Commands with progress reporting
+
+### Development Tools
+- **[12-command-scaffolding](../12-command-scaffolding/)** - Generate commands with progress bars
diff --git a/examples/07-progress-bars/main.php b/examples/07-progress-bars/main.php
index 1d7cc6a..6077733 100644
--- a/examples/07-progress-bars/main.php
+++ b/examples/07-progress-bars/main.php
@@ -1,29 +1,29 @@
-register(new ProgressDemoCommand());
-
-// Set default command
-
-// Start the application
-exit($runner->start());
+register(new ProgressDemoCommand());
+
+// Set default command
+
+// Start the application
+exit($runner->start());
diff --git a/examples/08-file-processing/README.md b/examples/08-file-processing/README.md
index d3b0f60..db93b2f 100644
--- a/examples/08-file-processing/README.md
+++ b/examples/08-file-processing/README.md
@@ -1,298 +1,298 @@
-# File Processing Example
-
-This example demonstrates file processing capabilities in WebFiori CLI, showcasing text file operations, statistics calculation, and content manipulation.
-
-## ๐ฏ What You'll Learn
-
-- Reading and processing text files
-- File content analysis and statistics
-- Text transformation operations
-- Error handling for file operations
-- Command argument validation
-- File existence and accessibility checks
-
-## ๐ Files
-
-- `app.php` - Main file processing command implementation
-- `sample.txt` - Sample text file for testing
-- `README.md` - This documentation
-
-## ๐ Running the Example
-
-### Basic Usage
-```bash
-# Process sample file with default action (count)
-php app.php process-file --file=sample.txt
-
-# Show help
-php app.php help --command=process-file
-```
-
-### File Statistics (Count Action)
-```bash
-# Count lines, words, and characters
-php app.php process-file --file=sample.txt --action=count
-
-# Default action is count (can be omitted)
-php app.php process-file --file=sample.txt
-```
-
-### Text Transformation
-```bash
-# Convert to uppercase
-php app.php process-file --file=sample.txt --action=uppercase
-
-# Reverse line order
-php app.php process-file --file=sample.txt --action=reverse
-```
-
-## ๐ Available Options
-
-### Actions (`--action`)
-- `count` - Display file statistics (lines, words, characters) - **Default**
-- `uppercase` - Convert all text to uppercase
-- `reverse` - Reverse the order of lines in the file
-
-### Parameters
-- `--file` - Path to the file to process (**Required**)
-- `--action` - Action to perform (optional, defaults to `count`)
-
-### Validation Rules
-- File path is required
-- File must exist and be readable
-- Action must be one of: count, uppercase, reverse
-- Invalid actions show available options
-
-## ๐จ Example Output
-
-### File Statistics (Count Action)
-```bash
-php app.php process-file --file=sample.txt --action=count
-```
-```
-File Statistics for: sample.txt
-Lines: 5
-Words: 14
-Characters: 82
-```
-
-### Uppercase Transformation
-```bash
-php app.php process-file --file=sample.txt --action=uppercase
-```
-```
-Uppercase content:
-HELLO WORLD
-THIS IS A SAMPLE FILE
-FOR TESTING FILE PROCESSING
-WITH MULTIPLE LINES
-```
-
-### Line Reversal
-```bash
-php app.php process-file --file=sample.txt --action=reverse
-```
-```
-Reversed content:
-
-With multiple lines
-For testing file processing
-This is a sample file
-Hello World
-```
-
-### Error Handling Examples
-
-#### File Not Found
-```bash
-php app.php process-file --file=nonexistent.txt --action=count
-```
-```
-Error: File not found: nonexistent.txt
-```
-
-#### Missing Required Argument
-```bash
-php app.php process-file --action=count
-```
-```
-Error: The following required argument(s) are missing: '--file'
-```
-
-#### Invalid Action
-```bash
-php app.php process-file --file=sample.txt --action=invalid
-```
-```
-Error: The following argument(s) have invalid values: '--action'
-Info: Allowed values for the argument '--action':
-count
-uppercase
-reverse
-```
-
-## ๐งช Test Scenarios
-
-### 1. Basic File Operations
-```bash
-# Test all actions on sample file
-php app.php process-file --file=sample.txt --action=count
-php app.php process-file --file=sample.txt --action=uppercase
-php app.php process-file --file=sample.txt --action=reverse
-```
-
-### 2. Different File Types
-```bash
-# Create test files
-echo -e "Line 1\nLine 2\nLine 3" > test1.txt
-echo "Single line file" > test2.txt
-touch empty.txt
-
-# Test with different content
-php app.php process-file --file=test1.txt --action=count
-php app.php process-file --file=test2.txt --action=count
-php app.php process-file --file=empty.txt --action=count
-```
-
-### 3. Large File Processing
-```bash
-# Create large file
-for i in {1..100}; do echo "Line $i with some content"; done > large.txt
-
-# Process large file
-php app.php process-file --file=large.txt --action=count
-```
-
-### 4. Error Cases
-```bash
-# Test error handling
-php app.php process-file --file=nonexistent.txt --action=count
-php app.php process-file --action=count
-php app.php process-file --file=sample.txt --action=invalid
-```
-
-### 5. Edge Cases
-```bash
-# Test with special files
-echo " " > spaces.txt # Only spaces
-echo -e "\x00\x01\x02" > binary.txt # Binary content
-mkdir testdir # Directory instead of file
-
-php app.php process-file --file=spaces.txt --action=count
-php app.php process-file --file=binary.txt --action=count
-php app.php process-file --file=testdir --action=count # Shows warning
-```
-
-## ๐ก Key Features Demonstrated
-
-### 1. File Operations
-- **File Reading**: Safe file content reading with error handling
-- **File Validation**: Check file existence and accessibility
-- **Content Processing**: Line-by-line and full content processing
-- **Statistics Calculation**: Lines, words, and character counting
-
-### 2. Text Processing
-- **Case Conversion**: Transform text to uppercase
-- **Line Manipulation**: Reverse line order in files
-- **Content Analysis**: Word and character counting
-- **Encoding Handling**: Process various text encodings
-
-### 3. Error Handling
-- **File Not Found**: Clear error messages for missing files
-- **Invalid Arguments**: Validation with helpful suggestions
-- **Required Parameters**: Check for mandatory arguments
-- **File Access Issues**: Handle permission and directory errors
-
-### 4. User Experience
-- **Clear Output**: Well-formatted results with labels
-- **Help Integration**: Built-in help command support
-- **Validation Messages**: Helpful error messages with suggestions
-- **Default Values**: Sensible defaults for optional parameters
-
-## ๐ง Technical Implementation
-
-### Core Functionality
-```php
-class FileProcessCommand extends Command {
- public function __construct() {
- parent::__construct('process-file', [
- '--file' => [
- ArgumentOption::OPTIONAL => false,
- ArgumentOption::DESCRIPTION => 'Path to the file to process'
- ],
- '--action' => [
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DEFAULT => 'count',
- ArgumentOption::VALUES => ['count', 'uppercase', 'reverse'],
- ArgumentOption::DESCRIPTION => 'Action to perform'
- ]
- ], 'Process text files in various ways');
- }
-}
-```
-
-### File Processing Methods
-- `validateFile()`: Check file existence and readability
-- `countStatistics()`: Calculate lines, words, characters
-- `transformContent()`: Apply text transformations
-- `handleErrors()`: Provide meaningful error messages
-
-### Statistics Calculation
-- **Lines**: Count newline characters + 1
-- **Words**: Split by whitespace and count non-empty elements
-- **Characters**: Total byte count including whitespace and newlines
-
-## ๐ฏ Best Practices Demonstrated
-
-### 1. Input Validation
-- Required parameter checking
-- File existence validation
-- Action value validation with allowed options
-- Clear error messages for invalid input
-
-### 2. File Handling
-- Safe file reading with error checking
-- Proper handling of empty files
-- Binary file detection and handling
-- Directory vs file differentiation
-
-### 3. User Experience
-- Consistent output formatting
-- Helpful error messages
-- Default parameter values
-- Comprehensive help documentation
-
-### 4. Error Recovery
-- Graceful handling of missing files
-- Clear validation error messages
-- Suggestions for valid parameter values
-- Non-zero exit codes for errors
-
-## ๐ Related Examples
-
-- **[03-user-input](../03-user-input/)** - Input validation and handling
-- **[04-output-formatting](../04-output-formatting/)** - Text formatting and colors
-- **[07-progress-bars](../07-progress-bars/)** - Progress tracking for file operations
-- **[10-multi-command-app](../10-multi-command-app/)** - Complete CLI applications
-## Related Examples
-
-### Prerequisites
-- **[01-basic-hello-world](../01-basic-hello-world/)** - Basic command structure
-- **[02-arguments-and-options](../02-arguments-and-options/)** - File path arguments and validation
-
-### Enhanced Processing
-- **[07-progress-bars](../07-progress-bars/)** - Visual progress for file operations
-- **[06-table-display](../06-table-display/)** - Display file data in formatted tables
-- **[04-output-formatting](../04-output-formatting/)** - Formatted status messages
-
-### User Interaction
-- **[03-user-input](../03-user-input/)** - Interactive file selection
-- **[05-interactive-commands](../05-interactive-commands/)** - File operation menus
-- **[11-masked-input](../11-masked-input/)** - Secure file path input
-
-### Complete Applications
-- **[10-multi-command-app](../10-multi-command-app/)** - Full applications with file management
-- **[09-database-ops](../09-database-ops/)** - Database import/export from files
-
-### Development Tools
-- **[12-command-scaffolding](../12-command-scaffolding/)** - Generate file processing commands
+# File Processing Example
+
+This example demonstrates file processing capabilities in WebFiori CLI, showcasing text file operations, statistics calculation, and content manipulation.
+
+## ๐ฏ What You'll Learn
+
+- Reading and processing text files
+- File content analysis and statistics
+- Text transformation operations
+- Error handling for file operations
+- Command argument validation
+- File existence and accessibility checks
+
+## ๐ Files
+
+- `app.php` - Main file processing command implementation
+- `sample.txt` - Sample text file for testing
+- `README.md` - This documentation
+
+## ๐ Running the Example
+
+### Basic Usage
+```bash
+# Process sample file with default action (count)
+php app.php process-file --file=sample.txt
+
+# Show help
+php app.php help --command=process-file
+```
+
+### File Statistics (Count Action)
+```bash
+# Count lines, words, and characters
+php app.php process-file --file=sample.txt --action=count
+
+# Default action is count (can be omitted)
+php app.php process-file --file=sample.txt
+```
+
+### Text Transformation
+```bash
+# Convert to uppercase
+php app.php process-file --file=sample.txt --action=uppercase
+
+# Reverse line order
+php app.php process-file --file=sample.txt --action=reverse
+```
+
+## ๐ Available Options
+
+### Actions (`--action`)
+- `count` - Display file statistics (lines, words, characters) - **Default**
+- `uppercase` - Convert all text to uppercase
+- `reverse` - Reverse the order of lines in the file
+
+### Parameters
+- `--file` - Path to the file to process (**Required**)
+- `--action` - Action to perform (optional, defaults to `count`)
+
+### Validation Rules
+- File path is required
+- File must exist and be readable
+- Action must be one of: count, uppercase, reverse
+- Invalid actions show available options
+
+## ๐จ Example Output
+
+### File Statistics (Count Action)
+```bash
+php app.php process-file --file=sample.txt --action=count
+```
+```
+File Statistics for: sample.txt
+Lines: 5
+Words: 14
+Characters: 82
+```
+
+### Uppercase Transformation
+```bash
+php app.php process-file --file=sample.txt --action=uppercase
+```
+```
+Uppercase content:
+HELLO WORLD
+THIS IS A SAMPLE FILE
+FOR TESTING FILE PROCESSING
+WITH MULTIPLE LINES
+```
+
+### Line Reversal
+```bash
+php app.php process-file --file=sample.txt --action=reverse
+```
+```
+Reversed content:
+
+With multiple lines
+For testing file processing
+This is a sample file
+Hello World
+```
+
+### Error Handling Examples
+
+#### File Not Found
+```bash
+php app.php process-file --file=nonexistent.txt --action=count
+```
+```
+Error: File not found: nonexistent.txt
+```
+
+#### Missing Required Argument
+```bash
+php app.php process-file --action=count
+```
+```
+Error: The following required argument(s) are missing: '--file'
+```
+
+#### Invalid Action
+```bash
+php app.php process-file --file=sample.txt --action=invalid
+```
+```
+Error: The following argument(s) have invalid values: '--action'
+Info: Allowed values for the argument '--action':
+count
+uppercase
+reverse
+```
+
+## ๐งช Test Scenarios
+
+### 1. Basic File Operations
+```bash
+# Test all actions on sample file
+php app.php process-file --file=sample.txt --action=count
+php app.php process-file --file=sample.txt --action=uppercase
+php app.php process-file --file=sample.txt --action=reverse
+```
+
+### 2. Different File Types
+```bash
+# Create test files
+echo -e "Line 1\nLine 2\nLine 3" > test1.txt
+echo "Single line file" > test2.txt
+touch empty.txt
+
+# Test with different content
+php app.php process-file --file=test1.txt --action=count
+php app.php process-file --file=test2.txt --action=count
+php app.php process-file --file=empty.txt --action=count
+```
+
+### 3. Large File Processing
+```bash
+# Create large file
+for i in {1..100}; do echo "Line $i with some content"; done > large.txt
+
+# Process large file
+php app.php process-file --file=large.txt --action=count
+```
+
+### 4. Error Cases
+```bash
+# Test error handling
+php app.php process-file --file=nonexistent.txt --action=count
+php app.php process-file --action=count
+php app.php process-file --file=sample.txt --action=invalid
+```
+
+### 5. Edge Cases
+```bash
+# Test with special files
+echo " " > spaces.txt # Only spaces
+echo -e "\x00\x01\x02" > binary.txt # Binary content
+mkdir testdir # Directory instead of file
+
+php app.php process-file --file=spaces.txt --action=count
+php app.php process-file --file=binary.txt --action=count
+php app.php process-file --file=testdir --action=count # Shows warning
+```
+
+## ๐ก Key Features Demonstrated
+
+### 1. File Operations
+- **File Reading**: Safe file content reading with error handling
+- **File Validation**: Check file existence and accessibility
+- **Content Processing**: Line-by-line and full content processing
+- **Statistics Calculation**: Lines, words, and character counting
+
+### 2. Text Processing
+- **Case Conversion**: Transform text to uppercase
+- **Line Manipulation**: Reverse line order in files
+- **Content Analysis**: Word and character counting
+- **Encoding Handling**: Process various text encodings
+
+### 3. Error Handling
+- **File Not Found**: Clear error messages for missing files
+- **Invalid Arguments**: Validation with helpful suggestions
+- **Required Parameters**: Check for mandatory arguments
+- **File Access Issues**: Handle permission and directory errors
+
+### 4. User Experience
+- **Clear Output**: Well-formatted results with labels
+- **Help Integration**: Built-in help command support
+- **Validation Messages**: Helpful error messages with suggestions
+- **Default Values**: Sensible defaults for optional parameters
+
+## ๐ง Technical Implementation
+
+### Core Functionality
+```php
+class FileProcessCommand extends Command {
+ public function __construct() {
+ parent::__construct('process-file', [
+ '--file' => [
+ ArgumentOption::OPTIONAL => false,
+ ArgumentOption::DESCRIPTION => 'Path to the file to process'
+ ],
+ '--action' => [
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DEFAULT => 'count',
+ ArgumentOption::VALUES => ['count', 'uppercase', 'reverse'],
+ ArgumentOption::DESCRIPTION => 'Action to perform'
+ ]
+ ], 'Process text files in various ways');
+ }
+}
+```
+
+### File Processing Methods
+- `validateFile()`: Check file existence and readability
+- `countStatistics()`: Calculate lines, words, characters
+- `transformContent()`: Apply text transformations
+- `handleErrors()`: Provide meaningful error messages
+
+### Statistics Calculation
+- **Lines**: Count newline characters + 1
+- **Words**: Split by whitespace and count non-empty elements
+- **Characters**: Total byte count including whitespace and newlines
+
+## ๐ฏ Best Practices Demonstrated
+
+### 1. Input Validation
+- Required parameter checking
+- File existence validation
+- Action value validation with allowed options
+- Clear error messages for invalid input
+
+### 2. File Handling
+- Safe file reading with error checking
+- Proper handling of empty files
+- Binary file detection and handling
+- Directory vs file differentiation
+
+### 3. User Experience
+- Consistent output formatting
+- Helpful error messages
+- Default parameter values
+- Comprehensive help documentation
+
+### 4. Error Recovery
+- Graceful handling of missing files
+- Clear validation error messages
+- Suggestions for valid parameter values
+- Non-zero exit codes for errors
+
+## ๐ Related Examples
+
+- **[03-user-input](../03-user-input/)** - Input validation and handling
+- **[04-output-formatting](../04-output-formatting/)** - Text formatting and colors
+- **[07-progress-bars](../07-progress-bars/)** - Progress tracking for file operations
+- **[10-multi-command-app](../10-multi-command-app/)** - Complete CLI applications
+## Related Examples
+
+### Prerequisites
+- **[01-basic-hello-world](../01-basic-hello-world/)** - Basic command structure
+- **[02-arguments-and-options](../02-arguments-and-options/)** - File path arguments and validation
+
+### Enhanced Processing
+- **[07-progress-bars](../07-progress-bars/)** - Visual progress for file operations
+- **[06-table-display](../06-table-display/)** - Display file data in formatted tables
+- **[04-output-formatting](../04-output-formatting/)** - Formatted status messages
+
+### User Interaction
+- **[03-user-input](../03-user-input/)** - Interactive file selection
+- **[05-interactive-commands](../05-interactive-commands/)** - File operation menus
+- **[11-masked-input](../11-masked-input/)** - Secure file path input
+
+### Complete Applications
+- **[10-multi-command-app](../10-multi-command-app/)** - Full applications with file management
+- **[09-database-ops](../09-database-ops/)** - Database import/export from files
+
+### Development Tools
+- **[12-command-scaffolding](../12-command-scaffolding/)** - Generate file processing commands
diff --git a/examples/08-file-processing/app.php b/examples/08-file-processing/app.php
index 6880e0c..f312060 100644
--- a/examples/08-file-processing/app.php
+++ b/examples/08-file-processing/app.php
@@ -1,72 +1,72 @@
- [
- ArgumentOption::OPTIONAL => false,
- ArgumentOption::DESCRIPTION => 'Path to the file to process'
- ],
- '--action' => [
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DEFAULT => 'count',
- ArgumentOption::VALUES => ['count', 'uppercase', 'reverse'],
- ArgumentOption::DESCRIPTION => 'Action to perform (count, uppercase, reverse)'
- ]
- ], 'Process text files in various ways');
- }
-
- public function exec(): int {
- $filePath = $this->getArgValue('--file');
- $action = $this->getArgValue('--action');
-
- if (!file_exists($filePath)) {
- $this->error("File not found: $filePath");
- return 1;
- }
-
- if (!is_readable($filePath)) {
- $this->error("File is not readable: $filePath");
- return 1;
- }
-
- $content = file_get_contents($filePath);
-
- switch ($action) {
- case 'count':
- $lines = substr_count($content, "\n") + 1;
- $words = str_word_count($content);
- $chars = strlen($content);
-
- $this->println("File Statistics for: %s", $filePath);
- $this->println("Lines: %d", $lines);
- $this->println("Words: %d", $words);
- $this->println("Characters: %d", $chars);
- break;
-
- case 'uppercase':
- $result = strtoupper($content);
- $this->println("Uppercase content:");
- $this->println($result);
- break;
-
- case 'reverse':
- $lines = explode("\n", $content);
- $reversed = array_reverse($lines);
- $this->println("Reversed content:");
- $this->println(implode("\n", $reversed));
- break;
- }
-
- return 0;
- }
-}
-
-$runner = new Runner();
-$runner->register(new FileProcessCommand());
-exit($runner->start());
+ [
+ ArgumentOption::OPTIONAL => false,
+ ArgumentOption::DESCRIPTION => 'Path to the file to process'
+ ],
+ '--action' => [
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DEFAULT => 'count',
+ ArgumentOption::VALUES => ['count', 'uppercase', 'reverse'],
+ ArgumentOption::DESCRIPTION => 'Action to perform (count, uppercase, reverse)'
+ ]
+ ], 'Process text files in various ways');
+ }
+
+ public function exec(): int {
+ $filePath = $this->getArgValue('--file');
+ $action = $this->getArgValue('--action');
+
+ if (!file_exists($filePath)) {
+ $this->error("File not found: $filePath");
+ return 1;
+ }
+
+ if (!is_readable($filePath)) {
+ $this->error("File is not readable: $filePath");
+ return 1;
+ }
+
+ $content = file_get_contents($filePath);
+
+ switch ($action) {
+ case 'count':
+ $lines = substr_count($content, "\n") + 1;
+ $words = str_word_count($content);
+ $chars = strlen($content);
+
+ $this->println("File Statistics for: %s", $filePath);
+ $this->println("Lines: %d", $lines);
+ $this->println("Words: %d", $words);
+ $this->println("Characters: %d", $chars);
+ break;
+
+ case 'uppercase':
+ $result = strtoupper($content);
+ $this->println("Uppercase content:");
+ $this->println($result);
+ break;
+
+ case 'reverse':
+ $lines = explode("\n", $content);
+ $reversed = array_reverse($lines);
+ $this->println("Reversed content:");
+ $this->println(implode("\n", $reversed));
+ break;
+ }
+
+ return 0;
+ }
+}
+
+$runner = new Runner();
+$runner->register(new FileProcessCommand());
+exit($runner->start());
diff --git a/examples/08-file-processing/sample.txt b/examples/08-file-processing/sample.txt
index 27e3454..550729c 100644
--- a/examples/08-file-processing/sample.txt
+++ b/examples/08-file-processing/sample.txt
@@ -1,4 +1,4 @@
-Hello World
-This is a sample file
-For testing file processing
-With multiple lines
+Hello World
+This is a sample file
+For testing file processing
+With multiple lines
diff --git a/examples/09-database-ops/DatabaseManager.php b/examples/09-database-ops/DatabaseManager.php
index df94064..c1bf439 100644
--- a/examples/09-database-ops/DatabaseManager.php
+++ b/examples/09-database-ops/DatabaseManager.php
@@ -1,578 +1,578 @@
-migrationsPath = $basePath.'/migrations';
- $this->seedsPath = $basePath.'/seeds';
- $this->loadConfig();
- }
-
- /**
- * Connect to database.
- */
- public function connect(array $config = null): bool {
- if ($config) {
- $this->config = array_merge($this->config, $config);
- }
-
- try {
- $dsn = $this->buildDsn();
- $this->connection = new PDO(
- $dsn,
- $this->config['username'] ?? '',
- $this->config['password'] ?? '',
- [
- PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
- PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
- PDO::ATTR_EMULATE_PREPARES => false
- ]
- );
-
- return true;
- } catch (PDOException $e) {
- throw new Exception("Database connection failed: ".$e->getMessage());
- }
- }
-
- /**
- * Create database backup.
- */
- public function createBackup(string $outputPath = null): array {
- $this->ensureConnected();
-
- if (!$outputPath) {
- $timestamp = date('Y-m-d_H-i-s');
- $outputPath = "backup_{$timestamp}.sql";
- }
-
- $tables = $this->getTables();
- $backup = [];
-
- // Add header
- $backup[] = "-- Database Backup";
- $backup[] = "-- Generated: ".date('Y-m-d H:i:s');
- $backup[] = "-- Database: ".($this->config['database'] ?? 'unknown');
- $backup[] = "";
-
- foreach ($tables as $table) {
- $tableName = $table['name'];
-
- // Skip migrations table
- if ($tableName === 'migrations') {
- continue;
- }
-
- $backup[] = "-- Table: $tableName";
- $backup[] = "DROP TABLE IF EXISTS `$tableName`;";
-
- // Get CREATE TABLE statement
- $createResult = $this->query("SHOW CREATE TABLE `$tableName`");
-
- if ($createResult['success'] && !empty($createResult['data'])) {
- $createStatement = $createResult['data'][0]['Create Table'] ?? '';
- $backup[] = $createStatement.";";
- }
-
- // Get table data
- $dataResult = $this->query("SELECT * FROM `$tableName`");
-
- if ($dataResult['success'] && !empty($dataResult['data'])) {
- $backup[] = "";
-
- foreach ($dataResult['data'] as $row) {
- $values = array_map(function ($value) {
- return $value === null ? 'NULL' : "'".addslashes($value)."'";
- }, array_values($row));
-
- $columns = '`'.implode('`, `', array_keys($row)).'`';
- $backup[] = "INSERT INTO `$tableName` ($columns) VALUES (".implode(', ', $values).");";
- }
- }
-
- $backup[] = "";
- }
-
- $backupContent = implode("\n", $backup);
-
- if (file_put_contents($outputPath, $backupContent) !== false) {
- return [
- 'success' => true,
- 'file' => $outputPath,
- 'size' => strlen($backupContent),
- 'tables' => count($tables)
- ];
- } else {
- return [
- 'success' => false,
- 'error' => "Failed to write backup file: $outputPath"
- ];
- }
- }
-
- /**
- * Get list of available migrations.
- */
- public function getAvailableMigrations(): array {
- if (!is_dir($this->migrationsPath)) {
- return [];
- }
-
- $files = glob($this->migrationsPath.'/*.sql');
- $migrations = [];
-
- foreach ($files as $file) {
- $filename = basename($file);
- $migrations[] = [
- 'filename' => $filename,
- 'path' => $file,
- 'name' => pathinfo($filename, PATHINFO_FILENAME),
- 'size' => filesize($file),
- 'modified' => filemtime($file)
- ];
- }
-
- // Sort by filename (which should include version numbers)
- usort($migrations, fn($a, $b) => strcmp($a['filename'], $b['filename']));
-
- return $migrations;
- }
-
- /**
- * Get connection status information.
- */
- public function getConnectionStatus(): array {
- if (!$this->isConnected()) {
- return [
- 'connected' => false,
- 'error' => 'Not connected to database'
- ];
- }
-
- try {
- $stmt = $this->connection->query('SELECT VERSION() as version');
- $result = $stmt->fetch();
-
- return [
- 'connected' => true,
- 'host' => $this->config['host'] ?? 'unknown',
- 'database' => $this->config['database'] ?? 'unknown',
- 'version' => $result['version'] ?? 'unknown',
- 'driver' => $this->connection->getAttribute(PDO::ATTR_DRIVER_NAME)
- ];
- } catch (PDOException $e) {
- return [
- 'connected' => false,
- 'error' => $e->getMessage()
- ];
- }
- }
-
- /**
- * Get executed migrations.
- */
- public function getExecutedMigrations(): array {
- $this->ensureConnected();
- $this->ensureMigrationsTable();
-
- $result = $this->query('SELECT * FROM migrations ORDER BY executed_at ASC');
-
- return $result['success'] ? $result['data'] : [];
- }
-
- /**
- * Get database schema information.
- */
- public function getSchema(): array {
- $this->ensureConnected();
-
- $tables = $this->getTables();
- $schema = [
- 'database' => $this->config['database'] ?? 'unknown',
- 'tables' => [],
- 'total_tables' => count($tables),
- 'total_size' => 0
- ];
-
- foreach ($tables as $table) {
- $tableInfo = $this->getTableInfo($table['name']);
- $schema['tables'][] = $tableInfo;
- $schema['total_size'] += $tableInfo['size_bytes'] ?? 0;
- }
-
- return $schema;
- }
-
- /**
- * Get table columns.
- */
- public function getTableColumns(string $tableName): array {
- $this->ensureConnected();
-
- $driver = $this->connection->getAttribute(PDO::ATTR_DRIVER_NAME);
-
- switch ($driver) {
- case 'mysql':
- $sql = "DESCRIBE `$tableName`";
- break;
- case 'pgsql':
- $sql = "SELECT column_name, data_type, is_nullable
- FROM information_schema.columns
- WHERE table_name = '$tableName'";
- break;
- case 'sqlite':
- $sql = "PRAGMA table_info($tableName)";
- break;
- default:
- return [];
- }
-
- $result = $this->query($sql);
-
- return $result['success'] ? $result['data'] : [];
- }
-
- /**
- * Get detailed table information.
- */
- public function getTableInfo(string $tableName): array {
- $this->ensureConnected();
-
- $driver = $this->connection->getAttribute(PDO::ATTR_DRIVER_NAME);
-
- // Get column information
- $columns = $this->getTableColumns($tableName);
-
- // Get row count
- $countResult = $this->query("SELECT COUNT(*) as count FROM `$tableName`");
- $rowCount = $countResult['success'] ? $countResult['data'][0]['count'] : 0;
-
- // Get table size (MySQL specific)
- $sizeBytes = 0;
-
- if ($driver === 'mysql') {
- $sizeResult = $this->query(
- "SELECT (data_length + index_length) as size_bytes
- FROM information_schema.tables
- WHERE table_schema = ? AND table_name = ?",
- [$this->config['database'], $tableName]
- );
-
- if ($sizeResult['success'] && !empty($sizeResult['data'])) {
- $sizeBytes = $sizeResult['data'][0]['size_bytes'] ?? 0;
- }
- }
-
- return [
- 'name' => $tableName,
- 'columns' => $columns,
- 'column_count' => count($columns),
- 'row_count' => $rowCount,
- 'size_bytes' => $sizeBytes,
- 'size_human' => $this->formatBytes($sizeBytes)
- ];
- }
-
- /**
- * Get list of tables.
- */
- public function getTables(): array {
- $this->ensureConnected();
-
- $driver = $this->connection->getAttribute(PDO::ATTR_DRIVER_NAME);
-
- switch ($driver) {
- case 'mysql':
- $sql = 'SHOW TABLES';
- break;
- case 'pgsql':
- $sql = "SELECT tablename as table_name FROM pg_tables WHERE schemaname = 'public'";
- break;
- case 'sqlite':
- $sql = "SELECT name as table_name FROM sqlite_master WHERE type='table'";
- break;
- default:
- throw new Exception("Unsupported database driver: $driver");
- }
-
- $result = $this->query($sql);
-
- if (!$result['success']) {
- return [];
- }
-
- $tables = [];
-
- foreach ($result['data'] as $row) {
- $tableName = array_values($row)[0]; // Get first column value
- $tables[] = ['name' => $tableName];
- }
-
- return $tables;
- }
-
- /**
- * Check if connected to database.
- */
- public function isConnected(): bool {
- return $this->connection !== null;
- }
-
- /**
- * Execute SQL query.
- */
- public function query(string $sql, array $params = []): array {
- $this->ensureConnected();
-
- $startTime = microtime(true);
-
- try {
- if (empty($params)) {
- $stmt = $this->connection->query($sql);
- } else {
- $stmt = $this->connection->prepare($sql);
- $stmt->execute($params);
- }
-
- $executionTime = microtime(true) - $startTime;
-
- // Record query for history
- $this->executedQueries[] = [
- 'sql' => $sql,
- 'params' => $params,
- 'execution_time' => $executionTime,
- 'timestamp' => date('Y-m-d H:i:s')
- ];
-
- $results = $stmt->fetchAll();
-
- return [
- 'success' => true,
- 'data' => $results,
- 'row_count' => $stmt->rowCount(),
- 'execution_time' => $executionTime,
- 'affected_rows' => $stmt->rowCount()
- ];
- } catch (PDOException $e) {
- return [
- 'success' => false,
- 'error' => $e->getMessage(),
- 'sql' => $sql,
- 'execution_time' => microtime(true) - $startTime
- ];
- }
- }
-
- /**
- * Run migration.
- */
- public function runMigration(string $filename): array {
- $this->ensureConnected();
- $this->ensureMigrationsTable();
-
- $migrationPath = $this->migrationsPath.'/'.$filename;
-
- if (!file_exists($migrationPath)) {
- return [
- 'success' => false,
- 'error' => "Migration file not found: $filename"
- ];
- }
-
- // Check if already executed
- $result = $this->query('SELECT COUNT(*) as count FROM migrations WHERE filename = ?', [$filename]);
-
- if ($result['success'] && $result['data'][0]['count'] > 0) {
- return [
- 'success' => false,
- 'error' => "Migration already executed: $filename"
- ];
- }
-
- // Read and execute migration
- $sql = file_get_contents($migrationPath);
- $statements = $this->splitSqlStatements($sql);
-
- $this->connection->beginTransaction();
-
- try {
- foreach ($statements as $statement) {
- if (trim($statement)) {
- $this->connection->exec($statement);
- }
- }
-
- // Record migration
- $this->query(
- 'INSERT INTO migrations (filename, executed_at) VALUES (?, ?)',
- [$filename, date('Y-m-d H:i:s')]
- );
-
- $this->connection->commit();
-
- return [
- 'success' => true,
- 'message' => "Migration executed successfully: $filename"
- ];
- } catch (PDOException $e) {
- $this->connection->rollBack();
-
- return [
- 'success' => false,
- 'error' => "Migration failed: ".$e->getMessage()
- ];
- }
- }
-
- /**
- * Seed database with test data.
- */
- public function seedTable(string $tableName, string $seedFile = null): array {
- $this->ensureConnected();
-
- if (!$seedFile) {
- $seedFile = $this->seedsPath."/{$tableName}.json";
- }
-
- if (!file_exists($seedFile)) {
- return [
- 'success' => false,
- 'error' => "Seed file not found: $seedFile"
- ];
- }
-
- $seedData = json_decode(file_get_contents($seedFile), true);
-
- if (json_last_error() !== JSON_ERROR_NONE) {
- return [
- 'success' => false,
- 'error' => "Invalid JSON in seed file: ".json_last_error_msg()
- ];
- }
-
- if (empty($seedData)) {
- return [
- 'success' => false,
- 'error' => "No data found in seed file"
- ];
- }
-
- $inserted = 0;
- $errors = [];
-
- foreach ($seedData as $record) {
- $columns = array_keys($record);
- $placeholders = array_fill(0, count($columns), '?');
-
- $sql = "INSERT INTO `$tableName` (`".implode('`, `', $columns)."`) VALUES (".implode(', ', $placeholders).")";
-
- $result = $this->query($sql, array_values($record));
-
- if ($result['success']) {
- $inserted++;
- } else {
- $errors[] = $result['error'];
- }
- }
-
- return [
- 'success' => empty($errors),
- 'inserted' => $inserted,
- 'total' => count($seedData),
- 'errors' => $errors
- ];
- }
-
- /**
- * Build DSN string from config.
- */
- private function buildDsn(): string {
- $driver = $this->config['driver'] ?? 'mysql';
- $host = $this->config['host'] ?? 'localhost';
- $port = $this->config['port'] ?? 3306;
- $database = $this->config['database'] ?? '';
-
- return "$driver:host=$host;port=$port;dbname=$database;charset=utf8mb4";
- }
-
- /**
- * Ensure database connection exists.
- */
- private function ensureConnected(): void {
- if (!$this->isConnected()) {
- throw new Exception('Not connected to database. Call connect() first.');
- }
- }
-
- /**
- * Ensure migrations table exists.
- */
- private function ensureMigrationsTable(): void {
- $sql = "CREATE TABLE IF NOT EXISTS migrations (
- id INT AUTO_INCREMENT PRIMARY KEY,
- filename VARCHAR(255) NOT NULL UNIQUE,
- executed_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
- )";
-
- $this->connection->exec($sql);
- }
-
- /**
- * Format bytes to human readable format.
- */
- private function formatBytes(int $bytes): string {
- if ($bytes === 0) {
- return '0 B';
- }
-
- $units = ['B', 'KB', 'MB', 'GB', 'TB'];
- $unitIndex = 0;
-
- while ($bytes >= 1024 && $unitIndex < count($units) - 1) {
- $bytes /= 1024;
- $unitIndex++;
- }
-
- return sprintf('%.1f %s', $bytes, $units[$unitIndex]);
- }
-
- /**
- * Load database configuration.
- */
- private function loadConfig(): void {
- $this->config = [
- 'driver' => 'mysql',
- 'host' => 'localhost',
- 'port' => 3306,
- 'database' => 'testing_db',
- 'username' => 'root',
- 'password' => '123456'
- ];
- }
-
- /**
- * Split SQL into individual statements.
- */
- private function splitSqlStatements(string $sql): array {
- // Simple split by semicolon (could be improved for complex cases)
- $statements = explode(';', $sql);
-
- return array_filter(array_map('trim', $statements));
- }
-}
+migrationsPath = $basePath.'/migrations';
+ $this->seedsPath = $basePath.'/seeds';
+ $this->loadConfig();
+ }
+
+ /**
+ * Connect to database.
+ */
+ public function connect(array $config = null): bool {
+ if ($config) {
+ $this->config = array_merge($this->config, $config);
+ }
+
+ try {
+ $dsn = $this->buildDsn();
+ $this->connection = new PDO(
+ $dsn,
+ $this->config['username'] ?? '',
+ $this->config['password'] ?? '',
+ [
+ PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
+ PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
+ PDO::ATTR_EMULATE_PREPARES => false
+ ]
+ );
+
+ return true;
+ } catch (PDOException $e) {
+ throw new Exception("Database connection failed: ".$e->getMessage());
+ }
+ }
+
+ /**
+ * Create database backup.
+ */
+ public function createBackup(string $outputPath = null): array {
+ $this->ensureConnected();
+
+ if (!$outputPath) {
+ $timestamp = date('Y-m-d_H-i-s');
+ $outputPath = "backup_{$timestamp}.sql";
+ }
+
+ $tables = $this->getTables();
+ $backup = [];
+
+ // Add header
+ $backup[] = "-- Database Backup";
+ $backup[] = "-- Generated: ".date('Y-m-d H:i:s');
+ $backup[] = "-- Database: ".($this->config['database'] ?? 'unknown');
+ $backup[] = "";
+
+ foreach ($tables as $table) {
+ $tableName = $table['name'];
+
+ // Skip migrations table
+ if ($tableName === 'migrations') {
+ continue;
+ }
+
+ $backup[] = "-- Table: $tableName";
+ $backup[] = "DROP TABLE IF EXISTS `$tableName`;";
+
+ // Get CREATE TABLE statement
+ $createResult = $this->query("SHOW CREATE TABLE `$tableName`");
+
+ if ($createResult['success'] && !empty($createResult['data'])) {
+ $createStatement = $createResult['data'][0]['Create Table'] ?? '';
+ $backup[] = $createStatement.";";
+ }
+
+ // Get table data
+ $dataResult = $this->query("SELECT * FROM `$tableName`");
+
+ if ($dataResult['success'] && !empty($dataResult['data'])) {
+ $backup[] = "";
+
+ foreach ($dataResult['data'] as $row) {
+ $values = array_map(function ($value) {
+ return $value === null ? 'NULL' : "'".addslashes($value)."'";
+ }, array_values($row));
+
+ $columns = '`'.implode('`, `', array_keys($row)).'`';
+ $backup[] = "INSERT INTO `$tableName` ($columns) VALUES (".implode(', ', $values).");";
+ }
+ }
+
+ $backup[] = "";
+ }
+
+ $backupContent = implode("\n", $backup);
+
+ if (file_put_contents($outputPath, $backupContent) !== false) {
+ return [
+ 'success' => true,
+ 'file' => $outputPath,
+ 'size' => strlen($backupContent),
+ 'tables' => count($tables)
+ ];
+ } else {
+ return [
+ 'success' => false,
+ 'error' => "Failed to write backup file: $outputPath"
+ ];
+ }
+ }
+
+ /**
+ * Get list of available migrations.
+ */
+ public function getAvailableMigrations(): array {
+ if (!is_dir($this->migrationsPath)) {
+ return [];
+ }
+
+ $files = glob($this->migrationsPath.'/*.sql');
+ $migrations = [];
+
+ foreach ($files as $file) {
+ $filename = basename($file);
+ $migrations[] = [
+ 'filename' => $filename,
+ 'path' => $file,
+ 'name' => pathinfo($filename, PATHINFO_FILENAME),
+ 'size' => filesize($file),
+ 'modified' => filemtime($file)
+ ];
+ }
+
+ // Sort by filename (which should include version numbers)
+ usort($migrations, fn($a, $b) => strcmp($a['filename'], $b['filename']));
+
+ return $migrations;
+ }
+
+ /**
+ * Get connection status information.
+ */
+ public function getConnectionStatus(): array {
+ if (!$this->isConnected()) {
+ return [
+ 'connected' => false,
+ 'error' => 'Not connected to database'
+ ];
+ }
+
+ try {
+ $stmt = $this->connection->query('SELECT VERSION() as version');
+ $result = $stmt->fetch();
+
+ return [
+ 'connected' => true,
+ 'host' => $this->config['host'] ?? 'unknown',
+ 'database' => $this->config['database'] ?? 'unknown',
+ 'version' => $result['version'] ?? 'unknown',
+ 'driver' => $this->connection->getAttribute(PDO::ATTR_DRIVER_NAME)
+ ];
+ } catch (PDOException $e) {
+ return [
+ 'connected' => false,
+ 'error' => $e->getMessage()
+ ];
+ }
+ }
+
+ /**
+ * Get executed migrations.
+ */
+ public function getExecutedMigrations(): array {
+ $this->ensureConnected();
+ $this->ensureMigrationsTable();
+
+ $result = $this->query('SELECT * FROM migrations ORDER BY executed_at ASC');
+
+ return $result['success'] ? $result['data'] : [];
+ }
+
+ /**
+ * Get database schema information.
+ */
+ public function getSchema(): array {
+ $this->ensureConnected();
+
+ $tables = $this->getTables();
+ $schema = [
+ 'database' => $this->config['database'] ?? 'unknown',
+ 'tables' => [],
+ 'total_tables' => count($tables),
+ 'total_size' => 0
+ ];
+
+ foreach ($tables as $table) {
+ $tableInfo = $this->getTableInfo($table['name']);
+ $schema['tables'][] = $tableInfo;
+ $schema['total_size'] += $tableInfo['size_bytes'] ?? 0;
+ }
+
+ return $schema;
+ }
+
+ /**
+ * Get table columns.
+ */
+ public function getTableColumns(string $tableName): array {
+ $this->ensureConnected();
+
+ $driver = $this->connection->getAttribute(PDO::ATTR_DRIVER_NAME);
+
+ switch ($driver) {
+ case 'mysql':
+ $sql = "DESCRIBE `$tableName`";
+ break;
+ case 'pgsql':
+ $sql = "SELECT column_name, data_type, is_nullable
+ FROM information_schema.columns
+ WHERE table_name = '$tableName'";
+ break;
+ case 'sqlite':
+ $sql = "PRAGMA table_info($tableName)";
+ break;
+ default:
+ return [];
+ }
+
+ $result = $this->query($sql);
+
+ return $result['success'] ? $result['data'] : [];
+ }
+
+ /**
+ * Get detailed table information.
+ */
+ public function getTableInfo(string $tableName): array {
+ $this->ensureConnected();
+
+ $driver = $this->connection->getAttribute(PDO::ATTR_DRIVER_NAME);
+
+ // Get column information
+ $columns = $this->getTableColumns($tableName);
+
+ // Get row count
+ $countResult = $this->query("SELECT COUNT(*) as count FROM `$tableName`");
+ $rowCount = $countResult['success'] ? $countResult['data'][0]['count'] : 0;
+
+ // Get table size (MySQL specific)
+ $sizeBytes = 0;
+
+ if ($driver === 'mysql') {
+ $sizeResult = $this->query(
+ "SELECT (data_length + index_length) as size_bytes
+ FROM information_schema.tables
+ WHERE table_schema = ? AND table_name = ?",
+ [$this->config['database'], $tableName]
+ );
+
+ if ($sizeResult['success'] && !empty($sizeResult['data'])) {
+ $sizeBytes = $sizeResult['data'][0]['size_bytes'] ?? 0;
+ }
+ }
+
+ return [
+ 'name' => $tableName,
+ 'columns' => $columns,
+ 'column_count' => count($columns),
+ 'row_count' => $rowCount,
+ 'size_bytes' => $sizeBytes,
+ 'size_human' => $this->formatBytes($sizeBytes)
+ ];
+ }
+
+ /**
+ * Get list of tables.
+ */
+ public function getTables(): array {
+ $this->ensureConnected();
+
+ $driver = $this->connection->getAttribute(PDO::ATTR_DRIVER_NAME);
+
+ switch ($driver) {
+ case 'mysql':
+ $sql = 'SHOW TABLES';
+ break;
+ case 'pgsql':
+ $sql = "SELECT tablename as table_name FROM pg_tables WHERE schemaname = 'public'";
+ break;
+ case 'sqlite':
+ $sql = "SELECT name as table_name FROM sqlite_master WHERE type='table'";
+ break;
+ default:
+ throw new Exception("Unsupported database driver: $driver");
+ }
+
+ $result = $this->query($sql);
+
+ if (!$result['success']) {
+ return [];
+ }
+
+ $tables = [];
+
+ foreach ($result['data'] as $row) {
+ $tableName = array_values($row)[0]; // Get first column value
+ $tables[] = ['name' => $tableName];
+ }
+
+ return $tables;
+ }
+
+ /**
+ * Check if connected to database.
+ */
+ public function isConnected(): bool {
+ return $this->connection !== null;
+ }
+
+ /**
+ * Execute SQL query.
+ */
+ public function query(string $sql, array $params = []): array {
+ $this->ensureConnected();
+
+ $startTime = microtime(true);
+
+ try {
+ if (empty($params)) {
+ $stmt = $this->connection->query($sql);
+ } else {
+ $stmt = $this->connection->prepare($sql);
+ $stmt->execute($params);
+ }
+
+ $executionTime = microtime(true) - $startTime;
+
+ // Record query for history
+ $this->executedQueries[] = [
+ 'sql' => $sql,
+ 'params' => $params,
+ 'execution_time' => $executionTime,
+ 'timestamp' => date('Y-m-d H:i:s')
+ ];
+
+ $results = $stmt->fetchAll();
+
+ return [
+ 'success' => true,
+ 'data' => $results,
+ 'row_count' => $stmt->rowCount(),
+ 'execution_time' => $executionTime,
+ 'affected_rows' => $stmt->rowCount()
+ ];
+ } catch (PDOException $e) {
+ return [
+ 'success' => false,
+ 'error' => $e->getMessage(),
+ 'sql' => $sql,
+ 'execution_time' => microtime(true) - $startTime
+ ];
+ }
+ }
+
+ /**
+ * Run migration.
+ */
+ public function runMigration(string $filename): array {
+ $this->ensureConnected();
+ $this->ensureMigrationsTable();
+
+ $migrationPath = $this->migrationsPath.'/'.$filename;
+
+ if (!file_exists($migrationPath)) {
+ return [
+ 'success' => false,
+ 'error' => "Migration file not found: $filename"
+ ];
+ }
+
+ // Check if already executed
+ $result = $this->query('SELECT COUNT(*) as count FROM migrations WHERE filename = ?', [$filename]);
+
+ if ($result['success'] && $result['data'][0]['count'] > 0) {
+ return [
+ 'success' => false,
+ 'error' => "Migration already executed: $filename"
+ ];
+ }
+
+ // Read and execute migration
+ $sql = file_get_contents($migrationPath);
+ $statements = $this->splitSqlStatements($sql);
+
+ $this->connection->beginTransaction();
+
+ try {
+ foreach ($statements as $statement) {
+ if (trim($statement)) {
+ $this->connection->exec($statement);
+ }
+ }
+
+ // Record migration
+ $this->query(
+ 'INSERT INTO migrations (filename, executed_at) VALUES (?, ?)',
+ [$filename, date('Y-m-d H:i:s')]
+ );
+
+ $this->connection->commit();
+
+ return [
+ 'success' => true,
+ 'message' => "Migration executed successfully: $filename"
+ ];
+ } catch (PDOException $e) {
+ $this->connection->rollBack();
+
+ return [
+ 'success' => false,
+ 'error' => "Migration failed: ".$e->getMessage()
+ ];
+ }
+ }
+
+ /**
+ * Seed database with test data.
+ */
+ public function seedTable(string $tableName, string $seedFile = null): array {
+ $this->ensureConnected();
+
+ if (!$seedFile) {
+ $seedFile = $this->seedsPath."/{$tableName}.json";
+ }
+
+ if (!file_exists($seedFile)) {
+ return [
+ 'success' => false,
+ 'error' => "Seed file not found: $seedFile"
+ ];
+ }
+
+ $seedData = json_decode(file_get_contents($seedFile), true);
+
+ if (json_last_error() !== JSON_ERROR_NONE) {
+ return [
+ 'success' => false,
+ 'error' => "Invalid JSON in seed file: ".json_last_error_msg()
+ ];
+ }
+
+ if (empty($seedData)) {
+ return [
+ 'success' => false,
+ 'error' => "No data found in seed file"
+ ];
+ }
+
+ $inserted = 0;
+ $errors = [];
+
+ foreach ($seedData as $record) {
+ $columns = array_keys($record);
+ $placeholders = array_fill(0, count($columns), '?');
+
+ $sql = "INSERT INTO `$tableName` (`".implode('`, `', $columns)."`) VALUES (".implode(', ', $placeholders).")";
+
+ $result = $this->query($sql, array_values($record));
+
+ if ($result['success']) {
+ $inserted++;
+ } else {
+ $errors[] = $result['error'];
+ }
+ }
+
+ return [
+ 'success' => empty($errors),
+ 'inserted' => $inserted,
+ 'total' => count($seedData),
+ 'errors' => $errors
+ ];
+ }
+
+ /**
+ * Build DSN string from config.
+ */
+ private function buildDsn(): string {
+ $driver = $this->config['driver'] ?? 'mysql';
+ $host = $this->config['host'] ?? 'localhost';
+ $port = $this->config['port'] ?? 3306;
+ $database = $this->config['database'] ?? '';
+
+ return "$driver:host=$host;port=$port;dbname=$database;charset=utf8mb4";
+ }
+
+ /**
+ * Ensure database connection exists.
+ */
+ private function ensureConnected(): void {
+ if (!$this->isConnected()) {
+ throw new Exception('Not connected to database. Call connect() first.');
+ }
+ }
+
+ /**
+ * Ensure migrations table exists.
+ */
+ private function ensureMigrationsTable(): void {
+ $sql = "CREATE TABLE IF NOT EXISTS migrations (
+ id INT AUTO_INCREMENT PRIMARY KEY,
+ filename VARCHAR(255) NOT NULL UNIQUE,
+ executed_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+ )";
+
+ $this->connection->exec($sql);
+ }
+
+ /**
+ * Format bytes to human readable format.
+ */
+ private function formatBytes(int $bytes): string {
+ if ($bytes === 0) {
+ return '0 B';
+ }
+
+ $units = ['B', 'KB', 'MB', 'GB', 'TB'];
+ $unitIndex = 0;
+
+ while ($bytes >= 1024 && $unitIndex < count($units) - 1) {
+ $bytes /= 1024;
+ $unitIndex++;
+ }
+
+ return sprintf('%.1f %s', $bytes, $units[$unitIndex]);
+ }
+
+ /**
+ * Load database configuration.
+ */
+ private function loadConfig(): void {
+ $this->config = [
+ 'driver' => 'mysql',
+ 'host' => 'localhost',
+ 'port' => 3306,
+ 'database' => 'testing_db',
+ 'username' => 'root',
+ 'password' => '123456'
+ ];
+ }
+
+ /**
+ * Split SQL into individual statements.
+ */
+ private function splitSqlStatements(string $sql): array {
+ // Simple split by semicolon (could be improved for complex cases)
+ $statements = explode(';', $sql);
+
+ return array_filter(array_map('trim', $statements));
+ }
+}
diff --git a/examples/09-database-ops/README.md b/examples/09-database-ops/README.md
index a33f8b5..4ef0116 100644
--- a/examples/09-database-ops/README.md
+++ b/examples/09-database-ops/README.md
@@ -1,623 +1,623 @@
-# Database Operations Example
-
-This example demonstrates comprehensive database management capabilities in WebFiori CLI, showcasing connection management, migrations, data seeding, query execution, and backup operations using MySQL.
-
-## ๐ฏ What You'll Learn
-
-- Database connection management with MySQL
-- Migration system for schema management
-- Data seeding with sample records
-- Interactive query execution with formatted results
-- Database backup and restore operations
-- Schema inspection and status monitoring
-- Error handling for database operations
-- Table display for query results
-
-## ๐ Files
-
-- `main.php` - Main CLI application with database commands
-- `DatabaseManager.php` - Core database functionality and connection management
-- `README.md` - This documentation
-
-## ๐ง Database Configuration
-
-The example uses MySQL with the following configuration:
-- **Host**: localhost:3306
-- **Database**: testing_db
-- **Username**: root
-- **Password**: 123456
-- **Driver**: MySQL with PDO
-
-## ๐ Running the Example
-
-### Basic Usage
-```bash
-# Show help
-php main.php help --command=db
-
-# Test database connection
-php main.php db --action=connect
-```
-
-### Database Operations
-```bash
-# Run migrations (create tables)
-php main.php db --action=migrate
-
-# Seed database with sample data
-php main.php db --action=seed
-
-# Check database status
-php main.php db --action=status
-
-# Execute custom queries
-php main.php db --action=query --sql="SELECT * FROM users"
-
-# Create backup
-php main.php db --action=backup --file=my_backup.sql
-
-# Restore from backup
-php main.php db --action=restore --file=my_backup.sql
-
-# Clean up database (drop tables)
-php main.php db --action=cleanup
-```
-
-## ๐ Available Actions
-
-### Database Actions (`--action`)
-- `connect` - Test database connection and show details
-- `migrate` - Run database migrations (create tables)
-- `seed` - Populate database with sample data
-- `query` - Execute custom SQL queries
-- `backup` - Create database backup to file
-- `restore` - Restore database from backup file
-- `status` - Show database status and table information
-- `cleanup` - Clean up database (drop all tables)
-
-### Parameters
-- `--action` - Database action to perform (**Required**)
-- `--sql` - SQL query to execute (required for `query` action)
-- `--file` - File path for backup/restore operations (optional)
-
-### Validation Rules
-- Action is required and must be valid
-- SQL parameter required for query action
-- File parameter required for restore action
-- Backup creates timestamped files if no filename provided
-
-## ๐จ Example Output
-
-### Database Connection Test
-```bash
-php main.php db --action=connect
-```
-```
-๐ Testing database connection...
-โ Database connection successful!
-๐ Connection details:
- โข Host: localhost:3306
- โข Database: testing_db
- โข Username: root
-```
-
-### Running Migrations
-```bash
-php main.php db --action=migrate
-```
-```
-๐ Running database migrations...
- โข Running migration 1...
- โข Running migration 2...
-โ Migrations completed successfully!
-```
-
-### Seeding Database
-```bash
-php main.php db --action=seed
-```
-```
-๐ฑ Seeding database with sample data...
-โ Database seeded successfully!
- โข Added 3 users
- โข Added 4 posts
-```
-
-### Database Status
-```bash
-php main.php db --action=status
-```
-```
-๐ Database Status
-==================
-๐ Tables: 3
- โข posts: 4 records
- โข user_profiles: 0 records
- โข users: 3 records
-```
-
-### Query Execution with Results
-```bash
-php main.php db --action=query --sql="SELECT * FROM users LIMIT 2"
-```
-```
-๐ Executing query...
-SQL: SELECT * FROM users LIMIT 2
-๐ Query results:
-โโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-โ Id โ Name โ Email โ Created At โ
-โโโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
-โ 1 โ John Doe โ john@example.com โ 2025-09-27 19:17:26 โ
-โ 2 โ Jane Smith โ jane@example.com โ 2025-09-27 19:17:26 โ
-โโโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-โฑ๏ธ Execution time: 3.79ms
-```
-
-### Complex Query Results
-```bash
-php main.php db --action=query --sql="SELECT * FROM posts"
-```
-```
-๐ Executing query...
-SQL: SELECT * FROM posts
-๐ Query results:
-โโโโโโโโโโโโโฌโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโ
-โ Id โ User Id โ Title โ Content โ Created At โ
-โโโโโโโโโโโโโผโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโค
-โ 1 โ 1 โ First Post โ This is the content of the first post. โ 2025-09-27 19:17:26 โ
-โ 2 โ 1 โ Second Post โ This is another post by John. โ 2025-09-27 19:17:26 โ
-โ 3 โ 2 โ Jane's Post โ Hello from Jane! โ 2025-09-27 19:17:26 โ
-โ 4 โ 3 โ Bob's Thoughts โ Some thoughts from Bob. โ 2025-09-27 19:17:26 โ
-โโโโโโโโโโโโโดโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโ
-โฑ๏ธ Execution time: 3.26ms
-```
-
-### Database Backup
-```bash
-php main.php db --action=backup --file=test_backup.sql
-```
-```
-๐พ Creating database backup...
-File: test_backup.sql
-โ Backup created successfully!
- โข File: test_backup.sql
- โข Size: 2,299 bytes
- โข Tables: 3
-```
-
-### Database Cleanup
-```bash
-php main.php db --action=cleanup
-```
-```
-๐งน Cleaning up database...
- โข Dropping table: posts
- โข Dropping table: users
-โ Database cleanup completed!
-```
-
-### Error Handling Examples
-
-#### Missing Required Action
-```bash
-php main.php db
-```
-```
-Error: The following required argument(s) are missing: '--action'
-```
-
-#### Invalid Action
-```bash
-php main.php db --action=invalid
-```
-```
-Error: The following argument(s) have invalid values: '--action'
-Info: Allowed values for the argument '--action':
-connect
-migrate
-seed
-query
-backup
-restore
-status
-cleanup
-```
-
-#### Missing SQL for Query
-```bash
-php main.php db --action=query
-```
-```
-โ SQL query is required for query action
-Usage: php main.php db --action=query --sql="SELECT * FROM users"
-```
-
-## ๐งช Test Scenarios
-
-### 1. Complete Database Workflow
-```bash
-# Full workflow from setup to cleanup
-php main.php db --action=connect
-php main.php db --action=migrate
-php main.php db --action=seed
-php main.php db --action=status
-php main.php db --action=backup --file=full_backup.sql
-php main.php db --action=cleanup
-```
-
-### 2. Query Testing
-```bash
-# Test different types of queries
-php main.php db --action=query --sql="SELECT COUNT(*) as total FROM users"
-php main.php db --action=query --sql="SELECT name, email FROM users WHERE id = 1"
-php main.php db --action=query --sql="SHOW TABLES"
-php main.php db --action=query --sql="DESCRIBE users"
-```
-
-### 3. Backup and Restore Cycle
-```bash
-# Create backup, cleanup, then restore
-php main.php db --action=backup --file=cycle_backup.sql
-php main.php db --action=cleanup
-php main.php db --action=status # Should show empty/minimal tables
-php main.php db --action=restore --file=cycle_backup.sql
-php main.php db --action=status # Should show restored data
-```
-
-### 4. Error Handling
-```bash
-# Test various error conditions
-php main.php db --action=query --sql="SELECT * FROM nonexistent_table"
-php main.php db --action=restore --file=nonexistent.sql
-php main.php db --action=query # Missing SQL parameter
-```
-
-### 5. Performance Testing
-```bash
-# Test with larger datasets and measure execution time
-php main.php db --action=query --sql="SELECT * FROM users ORDER BY created_at DESC"
-php main.php db --action=query --sql="SELECT COUNT(*) FROM posts GROUP BY user_id"
-```
-
-## ๐ก Key Features Demonstrated
-
-### 1. Database Connection Management
-- **PDO Integration**: Secure database connections with prepared statements
-- **Configuration Management**: Centralized database configuration
-- **Connection Testing**: Verify database connectivity and credentials
-- **Error Handling**: Graceful handling of connection failures
-
-### 2. Schema Management
-- **Migration System**: Automated table creation and schema updates
-- **Foreign Key Constraints**: Proper relational database design
-- **Index Management**: Performance optimization with database indexes
-- **Schema Inspection**: View table structure and relationships
-
-### 3. Data Operations
-- **Data Seeding**: Populate tables with sample data for testing
-- **Query Execution**: Execute arbitrary SQL queries safely
-- **Result Formatting**: Display query results in formatted tables
-- **Performance Monitoring**: Track query execution times
-
-### 4. Backup and Recovery
-- **Full Database Backup**: Export complete database structure and data
-- **Restore Operations**: Rebuild database from backup files
-- **File Management**: Timestamped backup files with size information
-- **Data Integrity**: Maintain referential integrity during operations
-
-### 5. User Experience
-- **Formatted Output**: Uses WebFiori CLI's built-in `table()` method for consistent formatting
-- **Progress Indicators**: Visual feedback for long-running operations
-- **Error Messages**: Clear, actionable error messages
-- **Help Integration**: Built-in help system with command documentation
-
-## ๐ง Technical Implementation
-
-### Core Classes
-- `DatabaseCommand`: Main CLI command handling all database operations
-- `DatabaseManager`: Core database functionality and connection management
-- `ArgumentOption`: Command argument configuration and validation
-- **Built-in `table()` method**: Uses WebFiori CLI's native table formatting for consistent display
-
-### Database Schema
-```sql
--- Users table
-CREATE TABLE users (
- id INT AUTO_INCREMENT PRIMARY KEY,
- name VARCHAR(100) NOT NULL,
- email VARCHAR(100) UNIQUE NOT NULL,
- created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
-);
-
--- Posts table with foreign key
-CREATE TABLE posts (
- id INT AUTO_INCREMENT PRIMARY KEY,
- user_id INT,
- title VARCHAR(200) NOT NULL,
- content TEXT,
- created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
- FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE
-);
-```
-
-### Sample Data
-- **Users**: John Doe, Jane Smith, Bob Johnson
-- **Posts**: Multiple posts per user with realistic content
-- **Relationships**: Posts linked to users via foreign keys
-
-## ๐ฏ Best Practices Demonstrated
-
-### 1. Database Security
-- Prepared statements to prevent SQL injection
-- Secure connection configuration
-- Parameter validation and sanitization
-- Error message sanitization
-
-### 2. Data Integrity
-- Foreign key constraints for referential integrity
-- Transaction support for complex operations
-- Proper error handling and rollback
-- Data validation before insertion
-
-### 3. Performance
-- Efficient query execution with timing
-- Proper indexing for performance
-- Connection pooling and management
-- Query optimization techniques
-
-### 4. User Experience
-- Clear visual feedback for all operations
-- Formatted table output for readability
-- Comprehensive error messages
-- Progress indicators for long operations
-
-### 5. Maintainability
-- Modular command structure
-- Centralized configuration management
-- Comprehensive logging and debugging
-- Clean separation of concerns
-
-## ๐ Related Examples
-
-- **[06-table-display](../06-table-display/)** - Advanced table formatting techniques
-- **[07-progress-bars](../07-progress-bars/)** - Progress indicators for long operations
-- **[08-file-processing](../08-file-processing/)** - File handling for backup operations
-- **[10-multi-command-app](../10-multi-command-app/)** - Complete CLI application architecture
-
-## ๐ Further Reading
-
-- [WebFiori CLI Documentation](https://webfiori.com/docs/cli)
-- [PHP PDO Documentation](https://www.php.net/manual/en/book.pdo.php)
-- [MySQL Documentation](https://dev.mysql.com/doc/)
-- [Database Design Best Practices](https://www.mysqltutorial.org/mysql-database-design/)
-- [SQL Security Guidelines](https://owasp.org/www-project-cheat-sheets/cheatsheets/SQL_Injection_Prevention_Cheat_Sheet.html)
-
-# Run specific migration
-php main.php migrate --file=001_create_users_table.sql
-
-# Rollback last migration
-php main.php migrate:rollback
-
-# Show migration status
-php main.php migrate:status
-```
-
-### Data Seeding
-```bash
-# Seed all tables
-php main.php seed
-
-# Seed specific table
-php main.php seed --table=users
-
-# Seed with custom data
-php main.php seed --file=custom_data.json
-```
-
-### Query Operations
-```bash
-# Execute SQL query
-php main.php query --sql="SELECT * FROM users LIMIT 10"
-
-# Execute query from file
-php main.php query --file=reports/monthly_stats.sql
-
-# Interactive query mode
-php main.php query --interactive
-```
-
-### Schema Operations
-```bash
-# Show database schema
-php main.php schema
-
-# Describe specific table
-php main.php schema:table --name=users
-
-# Generate schema documentation
-php main.php schema:docs --output=schema.md
-```
-
-### Backup & Restore
-```bash
-# Create database backup
-php main.php backup --output=backup_2024-01-20.sql
-
-# Restore from backup
-php main.php restore --file=backup_2024-01-20.sql
-
-# List available backups
-php main.php backup:list
-```
-
-## ๐ Key Features
-
-### 1. Migration System
-- **Version control**: Track database schema changes
-- **Rollback support**: Undo migrations safely
-- **Dependency management**: Handle migration dependencies
-- **Batch operations**: Run multiple migrations
-- **Status tracking**: Monitor migration state
-
-### 2. Data Management
-- **Seeding**: Populate tables with test data
-- **Fixtures**: Reusable data sets
-- **Import/Export**: Data transfer utilities
-- **Validation**: Data integrity checks
-- **Relationships**: Handle foreign key constraints
-
-### 3. Query Interface
-- **Interactive mode**: Real-time query execution
-- **Result formatting**: Multiple output formats
-- **Query history**: Track executed queries
-- **Performance metrics**: Query execution stats
-- **Syntax highlighting**: Enhanced readability
-
-### 4. Schema Management
-- **Inspection**: Analyze database structure
-- **Documentation**: Generate schema docs
-- **Comparison**: Compare schema versions
-- **Optimization**: Index and performance suggestions
-- **Visualization**: Schema relationship diagrams
-
-## ๐จ Expected Output
-
-### Migration Status
-```
-๐ Migration Status
-==================
-
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโ
-โ Migration โ Status โ Executed At โ
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโค
-โ 001_create_users_table.sql โ โ Done โ 2024-01-15 10:30:00 โ
-โ 002_create_posts_table.sql โ โ Done โ 2024-01-15 10:30:15 โ
-โ 003_add_indexes.sql โ โณ Pending โ - โ
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโ
-
-๐ Summary: 2 completed, 1 pending
-```
-
-### Query Results
-```
-๐ Query Results
-===============
-
-Query: SELECT id, name, email, created_at FROM users LIMIT 5
-Execution time: 0.023s
-Rows returned: 5
-
-โโโโโโฌโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโ
-โ ID โ Name โ Email โ Created At โ
-โโโโโโผโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโค
-โ 1 โ John Doe โ john@example.com โ 2024-01-15 10:30:00 โ
-โ 2 โ Jane Smith โ jane@example.com โ 2024-01-15 11:15:30 โ
-โ 3 โ Bob Johnson โ bob@example.com โ 2024-01-15 12:45:15 โ
-โ 4 โ Alice Brown โ alice@example.com โ 2024-01-15 14:20:45 โ
-โ 5 โ Charlie Lee โ charlie@example.com โ 2024-01-15 15:10:20 โ
-โโโโโโดโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโ
-
-๐ก Query completed successfully
-```
-
-### Schema Information
-```
-๐๏ธ Database Schema: myapp
-==========================
-
-๐ Tables Overview:
-โโโโโโโโโโโโโโโฌโโโโโโโโโโโฌโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโ
-โ Table โ Columns โ Rows โ Size โ
-โโโโโโโโโโโโโโโผโโโโโโโโโโโผโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโค
-โ users โ 8 โ 1,234 โ 2.3 MB โ
-โ posts โ 12 โ 5,678 โ 15.7 MB โ
-โ comments โ 6 โ 12,345 โ 8.9 MB โ
-โ categories โ 4 โ 25 โ 4.2 KB โ
-โโโโโโโโโโโโโโโดโโโโโโโโโโโดโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโ
-
-๐ Relationships:
- โข users โ posts (1:many)
- โข posts โ comments (1:many)
- โข categories โ posts (1:many)
-
-๐ Total: 4 tables, 19,282 rows, 26.9 MB
-```
-
-### Backup Progress
-```
-๐พ Creating Database Backup
-===========================
-
-Analyzing database structure...
-[โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 100.0%
-
-Exporting table data:
- โข users: [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 1,234 rows
- โข posts: [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 5,678 rows
- โข comments: [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 12,345 rows
- โข categories: [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 25 rows
-
-โ Backup completed successfully!
-
-๐ Backup Summary:
- โข File: backup_2024-01-20_14-30-15.sql
- โข Size: 45.2 MB
- โข Tables: 4
- โข Total Rows: 19,282
- โข Duration: 00:02:15
- โข Compression: gzip (87% reduction)
-```
-
-## ๐ Next Steps
-
-After mastering this example, explore:
-- **Real database integration**: Connect to MySQL, PostgreSQL, SQLite
-- **ORM integration**: Use with Eloquent, Doctrine, etc.
-- **Cloud database support**: AWS RDS, Google Cloud SQL
-- **Advanced features**: Replication, clustering, performance tuning
-
-## ๐ก Try This
-
-Extend the database CLI:
-
-1. **Add more database types**: Support MongoDB, Redis, etc.
-2. **Implement connection pooling**: Manage multiple connections
-3. **Add query optimization**: Analyze and suggest improvements
-4. **Create data visualization**: Generate charts from query results
-5. **Add replication support**: Master-slave configuration
-
-```php
-// Example: Add query optimization
-class QueryOptimizer {
- public function analyze(string $query): array {
- // Analyze query performance
- return [
- 'execution_time' => 0.045,
- 'rows_examined' => 1000,
- 'suggestions' => ['Add index on user_id column']
- ];
- }
-}
-```
-## Related Examples
-
-### Prerequisites
-- **[01-basic-hello-world](../01-basic-hello-world/)** - Basic command structure
-- **[02-arguments-and-options](../02-arguments-and-options/)** - Database connection arguments
-
-### Enhanced Features
-- **[06-table-display](../06-table-display/)** - Display query results in tables
-- **[07-progress-bars](../07-progress-bars/)** - Progress for long database operations
-- **[05-interactive-commands](../05-interactive-commands/)** - Database management menus
-
-### User Interaction
-- **[03-user-input](../03-user-input/)** - Interactive database configuration
-- **[11-masked-input](../11-masked-input/)** - Secure database password input
-- **[04-output-formatting](../04-output-formatting/)** - Formatted database status
-
-### Data Processing
-- **[08-file-processing](../08-file-processing/)** - Import/export database data
-- **[10-multi-command-app](../10-multi-command-app/)** - Complete database CLI applications
-
-### Development Tools
-- **[12-command-scaffolding](../12-command-scaffolding/)** - Generate database operation commands
+# Database Operations Example
+
+This example demonstrates comprehensive database management capabilities in WebFiori CLI, showcasing connection management, migrations, data seeding, query execution, and backup operations using MySQL.
+
+## ๐ฏ What You'll Learn
+
+- Database connection management with MySQL
+- Migration system for schema management
+- Data seeding with sample records
+- Interactive query execution with formatted results
+- Database backup and restore operations
+- Schema inspection and status monitoring
+- Error handling for database operations
+- Table display for query results
+
+## ๐ Files
+
+- `main.php` - Main CLI application with database commands
+- `DatabaseManager.php` - Core database functionality and connection management
+- `README.md` - This documentation
+
+## ๐ง Database Configuration
+
+The example uses MySQL with the following configuration:
+- **Host**: localhost:3306
+- **Database**: testing_db
+- **Username**: root
+- **Password**: 123456
+- **Driver**: MySQL with PDO
+
+## ๐ Running the Example
+
+### Basic Usage
+```bash
+# Show help
+php main.php help --command=db
+
+# Test database connection
+php main.php db --action=connect
+```
+
+### Database Operations
+```bash
+# Run migrations (create tables)
+php main.php db --action=migrate
+
+# Seed database with sample data
+php main.php db --action=seed
+
+# Check database status
+php main.php db --action=status
+
+# Execute custom queries
+php main.php db --action=query --sql="SELECT * FROM users"
+
+# Create backup
+php main.php db --action=backup --file=my_backup.sql
+
+# Restore from backup
+php main.php db --action=restore --file=my_backup.sql
+
+# Clean up database (drop tables)
+php main.php db --action=cleanup
+```
+
+## ๐ Available Actions
+
+### Database Actions (`--action`)
+- `connect` - Test database connection and show details
+- `migrate` - Run database migrations (create tables)
+- `seed` - Populate database with sample data
+- `query` - Execute custom SQL queries
+- `backup` - Create database backup to file
+- `restore` - Restore database from backup file
+- `status` - Show database status and table information
+- `cleanup` - Clean up database (drop all tables)
+
+### Parameters
+- `--action` - Database action to perform (**Required**)
+- `--sql` - SQL query to execute (required for `query` action)
+- `--file` - File path for backup/restore operations (optional)
+
+### Validation Rules
+- Action is required and must be valid
+- SQL parameter required for query action
+- File parameter required for restore action
+- Backup creates timestamped files if no filename provided
+
+## ๐จ Example Output
+
+### Database Connection Test
+```bash
+php main.php db --action=connect
+```
+```
+๐ Testing database connection...
+โ Database connection successful!
+๐ Connection details:
+ โข Host: localhost:3306
+ โข Database: testing_db
+ โข Username: root
+```
+
+### Running Migrations
+```bash
+php main.php db --action=migrate
+```
+```
+๐ Running database migrations...
+ โข Running migration 1...
+ โข Running migration 2...
+โ Migrations completed successfully!
+```
+
+### Seeding Database
+```bash
+php main.php db --action=seed
+```
+```
+๐ฑ Seeding database with sample data...
+โ Database seeded successfully!
+ โข Added 3 users
+ โข Added 4 posts
+```
+
+### Database Status
+```bash
+php main.php db --action=status
+```
+```
+๐ Database Status
+==================
+๐ Tables: 3
+ โข posts: 4 records
+ โข user_profiles: 0 records
+ โข users: 3 records
+```
+
+### Query Execution with Results
+```bash
+php main.php db --action=query --sql="SELECT * FROM users LIMIT 2"
+```
+```
+๐ Executing query...
+SQL: SELECT * FROM users LIMIT 2
+๐ Query results:
+โโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+โ Id โ Name โ Email โ Created At โ
+โโโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
+โ 1 โ John Doe โ john@example.com โ 2025-09-27 19:17:26 โ
+โ 2 โ Jane Smith โ jane@example.com โ 2025-09-27 19:17:26 โ
+โโโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+โฑ๏ธ Execution time: 3.79ms
+```
+
+### Complex Query Results
+```bash
+php main.php db --action=query --sql="SELECT * FROM posts"
+```
+```
+๐ Executing query...
+SQL: SELECT * FROM posts
+๐ Query results:
+โโโโโโโโโโโโโฌโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโ
+โ Id โ User Id โ Title โ Content โ Created At โ
+โโโโโโโโโโโโโผโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโค
+โ 1 โ 1 โ First Post โ This is the content of the first post. โ 2025-09-27 19:17:26 โ
+โ 2 โ 1 โ Second Post โ This is another post by John. โ 2025-09-27 19:17:26 โ
+โ 3 โ 2 โ Jane's Post โ Hello from Jane! โ 2025-09-27 19:17:26 โ
+โ 4 โ 3 โ Bob's Thoughts โ Some thoughts from Bob. โ 2025-09-27 19:17:26 โ
+โโโโโโโโโโโโโดโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโ
+โฑ๏ธ Execution time: 3.26ms
+```
+
+### Database Backup
+```bash
+php main.php db --action=backup --file=test_backup.sql
+```
+```
+๐พ Creating database backup...
+File: test_backup.sql
+โ Backup created successfully!
+ โข File: test_backup.sql
+ โข Size: 2,299 bytes
+ โข Tables: 3
+```
+
+### Database Cleanup
+```bash
+php main.php db --action=cleanup
+```
+```
+๐งน Cleaning up database...
+ โข Dropping table: posts
+ โข Dropping table: users
+โ Database cleanup completed!
+```
+
+### Error Handling Examples
+
+#### Missing Required Action
+```bash
+php main.php db
+```
+```
+Error: The following required argument(s) are missing: '--action'
+```
+
+#### Invalid Action
+```bash
+php main.php db --action=invalid
+```
+```
+Error: The following argument(s) have invalid values: '--action'
+Info: Allowed values for the argument '--action':
+connect
+migrate
+seed
+query
+backup
+restore
+status
+cleanup
+```
+
+#### Missing SQL for Query
+```bash
+php main.php db --action=query
+```
+```
+โ SQL query is required for query action
+Usage: php main.php db --action=query --sql="SELECT * FROM users"
+```
+
+## ๐งช Test Scenarios
+
+### 1. Complete Database Workflow
+```bash
+# Full workflow from setup to cleanup
+php main.php db --action=connect
+php main.php db --action=migrate
+php main.php db --action=seed
+php main.php db --action=status
+php main.php db --action=backup --file=full_backup.sql
+php main.php db --action=cleanup
+```
+
+### 2. Query Testing
+```bash
+# Test different types of queries
+php main.php db --action=query --sql="SELECT COUNT(*) as total FROM users"
+php main.php db --action=query --sql="SELECT name, email FROM users WHERE id = 1"
+php main.php db --action=query --sql="SHOW TABLES"
+php main.php db --action=query --sql="DESCRIBE users"
+```
+
+### 3. Backup and Restore Cycle
+```bash
+# Create backup, cleanup, then restore
+php main.php db --action=backup --file=cycle_backup.sql
+php main.php db --action=cleanup
+php main.php db --action=status # Should show empty/minimal tables
+php main.php db --action=restore --file=cycle_backup.sql
+php main.php db --action=status # Should show restored data
+```
+
+### 4. Error Handling
+```bash
+# Test various error conditions
+php main.php db --action=query --sql="SELECT * FROM nonexistent_table"
+php main.php db --action=restore --file=nonexistent.sql
+php main.php db --action=query # Missing SQL parameter
+```
+
+### 5. Performance Testing
+```bash
+# Test with larger datasets and measure execution time
+php main.php db --action=query --sql="SELECT * FROM users ORDER BY created_at DESC"
+php main.php db --action=query --sql="SELECT COUNT(*) FROM posts GROUP BY user_id"
+```
+
+## ๐ก Key Features Demonstrated
+
+### 1. Database Connection Management
+- **PDO Integration**: Secure database connections with prepared statements
+- **Configuration Management**: Centralized database configuration
+- **Connection Testing**: Verify database connectivity and credentials
+- **Error Handling**: Graceful handling of connection failures
+
+### 2. Schema Management
+- **Migration System**: Automated table creation and schema updates
+- **Foreign Key Constraints**: Proper relational database design
+- **Index Management**: Performance optimization with database indexes
+- **Schema Inspection**: View table structure and relationships
+
+### 3. Data Operations
+- **Data Seeding**: Populate tables with sample data for testing
+- **Query Execution**: Execute arbitrary SQL queries safely
+- **Result Formatting**: Display query results in formatted tables
+- **Performance Monitoring**: Track query execution times
+
+### 4. Backup and Recovery
+- **Full Database Backup**: Export complete database structure and data
+- **Restore Operations**: Rebuild database from backup files
+- **File Management**: Timestamped backup files with size information
+- **Data Integrity**: Maintain referential integrity during operations
+
+### 5. User Experience
+- **Formatted Output**: Uses WebFiori CLI's built-in `table()` method for consistent formatting
+- **Progress Indicators**: Visual feedback for long-running operations
+- **Error Messages**: Clear, actionable error messages
+- **Help Integration**: Built-in help system with command documentation
+
+## ๐ง Technical Implementation
+
+### Core Classes
+- `DatabaseCommand`: Main CLI command handling all database operations
+- `DatabaseManager`: Core database functionality and connection management
+- `ArgumentOption`: Command argument configuration and validation
+- **Built-in `table()` method**: Uses WebFiori CLI's native table formatting for consistent display
+
+### Database Schema
+```sql
+-- Users table
+CREATE TABLE users (
+ id INT AUTO_INCREMENT PRIMARY KEY,
+ name VARCHAR(100) NOT NULL,
+ email VARCHAR(100) UNIQUE NOT NULL,
+ created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+
+-- Posts table with foreign key
+CREATE TABLE posts (
+ id INT AUTO_INCREMENT PRIMARY KEY,
+ user_id INT,
+ title VARCHAR(200) NOT NULL,
+ content TEXT,
+ created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+ FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE
+);
+```
+
+### Sample Data
+- **Users**: John Doe, Jane Smith, Bob Johnson
+- **Posts**: Multiple posts per user with realistic content
+- **Relationships**: Posts linked to users via foreign keys
+
+## ๐ฏ Best Practices Demonstrated
+
+### 1. Database Security
+- Prepared statements to prevent SQL injection
+- Secure connection configuration
+- Parameter validation and sanitization
+- Error message sanitization
+
+### 2. Data Integrity
+- Foreign key constraints for referential integrity
+- Transaction support for complex operations
+- Proper error handling and rollback
+- Data validation before insertion
+
+### 3. Performance
+- Efficient query execution with timing
+- Proper indexing for performance
+- Connection pooling and management
+- Query optimization techniques
+
+### 4. User Experience
+- Clear visual feedback for all operations
+- Formatted table output for readability
+- Comprehensive error messages
+- Progress indicators for long operations
+
+### 5. Maintainability
+- Modular command structure
+- Centralized configuration management
+- Comprehensive logging and debugging
+- Clean separation of concerns
+
+## ๐ Related Examples
+
+- **[06-table-display](../06-table-display/)** - Advanced table formatting techniques
+- **[07-progress-bars](../07-progress-bars/)** - Progress indicators for long operations
+- **[08-file-processing](../08-file-processing/)** - File handling for backup operations
+- **[10-multi-command-app](../10-multi-command-app/)** - Complete CLI application architecture
+
+## ๐ Further Reading
+
+- [WebFiori CLI Documentation](https://webfiori.com/docs/cli)
+- [PHP PDO Documentation](https://www.php.net/manual/en/book.pdo.php)
+- [MySQL Documentation](https://dev.mysql.com/doc/)
+- [Database Design Best Practices](https://www.mysqltutorial.org/mysql-database-design/)
+- [SQL Security Guidelines](https://owasp.org/www-project-cheat-sheets/cheatsheets/SQL_Injection_Prevention_Cheat_Sheet.html)
+
+# Run specific migration
+php main.php migrate --file=001_create_users_table.sql
+
+# Rollback last migration
+php main.php migrate:rollback
+
+# Show migration status
+php main.php migrate:status
+```
+
+### Data Seeding
+```bash
+# Seed all tables
+php main.php seed
+
+# Seed specific table
+php main.php seed --table=users
+
+# Seed with custom data
+php main.php seed --file=custom_data.json
+```
+
+### Query Operations
+```bash
+# Execute SQL query
+php main.php query --sql="SELECT * FROM users LIMIT 10"
+
+# Execute query from file
+php main.php query --file=reports/monthly_stats.sql
+
+# Interactive query mode
+php main.php query --interactive
+```
+
+### Schema Operations
+```bash
+# Show database schema
+php main.php schema
+
+# Describe specific table
+php main.php schema:table --name=users
+
+# Generate schema documentation
+php main.php schema:docs --output=schema.md
+```
+
+### Backup & Restore
+```bash
+# Create database backup
+php main.php backup --output=backup_2024-01-20.sql
+
+# Restore from backup
+php main.php restore --file=backup_2024-01-20.sql
+
+# List available backups
+php main.php backup:list
+```
+
+## ๐ Key Features
+
+### 1. Migration System
+- **Version control**: Track database schema changes
+- **Rollback support**: Undo migrations safely
+- **Dependency management**: Handle migration dependencies
+- **Batch operations**: Run multiple migrations
+- **Status tracking**: Monitor migration state
+
+### 2. Data Management
+- **Seeding**: Populate tables with test data
+- **Fixtures**: Reusable data sets
+- **Import/Export**: Data transfer utilities
+- **Validation**: Data integrity checks
+- **Relationships**: Handle foreign key constraints
+
+### 3. Query Interface
+- **Interactive mode**: Real-time query execution
+- **Result formatting**: Multiple output formats
+- **Query history**: Track executed queries
+- **Performance metrics**: Query execution stats
+- **Syntax highlighting**: Enhanced readability
+
+### 4. Schema Management
+- **Inspection**: Analyze database structure
+- **Documentation**: Generate schema docs
+- **Comparison**: Compare schema versions
+- **Optimization**: Index and performance suggestions
+- **Visualization**: Schema relationship diagrams
+
+## ๐จ Expected Output
+
+### Migration Status
+```
+๐ Migration Status
+==================
+
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโ
+โ Migration โ Status โ Executed At โ
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโค
+โ 001_create_users_table.sql โ โ Done โ 2024-01-15 10:30:00 โ
+โ 002_create_posts_table.sql โ โ Done โ 2024-01-15 10:30:15 โ
+โ 003_add_indexes.sql โ โณ Pending โ - โ
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโ
+
+๐ Summary: 2 completed, 1 pending
+```
+
+### Query Results
+```
+๐ Query Results
+===============
+
+Query: SELECT id, name, email, created_at FROM users LIMIT 5
+Execution time: 0.023s
+Rows returned: 5
+
+โโโโโโฌโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโ
+โ ID โ Name โ Email โ Created At โ
+โโโโโโผโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโค
+โ 1 โ John Doe โ john@example.com โ 2024-01-15 10:30:00 โ
+โ 2 โ Jane Smith โ jane@example.com โ 2024-01-15 11:15:30 โ
+โ 3 โ Bob Johnson โ bob@example.com โ 2024-01-15 12:45:15 โ
+โ 4 โ Alice Brown โ alice@example.com โ 2024-01-15 14:20:45 โ
+โ 5 โ Charlie Lee โ charlie@example.com โ 2024-01-15 15:10:20 โ
+โโโโโโดโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโ
+
+๐ก Query completed successfully
+```
+
+### Schema Information
+```
+๐๏ธ Database Schema: myapp
+==========================
+
+๐ Tables Overview:
+โโโโโโโโโโโโโโโฌโโโโโโโโโโโฌโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโ
+โ Table โ Columns โ Rows โ Size โ
+โโโโโโโโโโโโโโโผโโโโโโโโโโโผโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโค
+โ users โ 8 โ 1,234 โ 2.3 MB โ
+โ posts โ 12 โ 5,678 โ 15.7 MB โ
+โ comments โ 6 โ 12,345 โ 8.9 MB โ
+โ categories โ 4 โ 25 โ 4.2 KB โ
+โโโโโโโโโโโโโโโดโโโโโโโโโโโดโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโ
+
+๐ Relationships:
+ โข users โ posts (1:many)
+ โข posts โ comments (1:many)
+ โข categories โ posts (1:many)
+
+๐ Total: 4 tables, 19,282 rows, 26.9 MB
+```
+
+### Backup Progress
+```
+๐พ Creating Database Backup
+===========================
+
+Analyzing database structure...
+[โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 100.0%
+
+Exporting table data:
+ โข users: [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 1,234 rows
+ โข posts: [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 5,678 rows
+ โข comments: [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 12,345 rows
+ โข categories: [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 25 rows
+
+โ Backup completed successfully!
+
+๐ Backup Summary:
+ โข File: backup_2024-01-20_14-30-15.sql
+ โข Size: 45.2 MB
+ โข Tables: 4
+ โข Total Rows: 19,282
+ โข Duration: 00:02:15
+ โข Compression: gzip (87% reduction)
+```
+
+## ๐ Next Steps
+
+After mastering this example, explore:
+- **Real database integration**: Connect to MySQL, PostgreSQL, SQLite
+- **ORM integration**: Use with Eloquent, Doctrine, etc.
+- **Cloud database support**: AWS RDS, Google Cloud SQL
+- **Advanced features**: Replication, clustering, performance tuning
+
+## ๐ก Try This
+
+Extend the database CLI:
+
+1. **Add more database types**: Support MongoDB, Redis, etc.
+2. **Implement connection pooling**: Manage multiple connections
+3. **Add query optimization**: Analyze and suggest improvements
+4. **Create data visualization**: Generate charts from query results
+5. **Add replication support**: Master-slave configuration
+
+```php
+// Example: Add query optimization
+class QueryOptimizer {
+ public function analyze(string $query): array {
+ // Analyze query performance
+ return [
+ 'execution_time' => 0.045,
+ 'rows_examined' => 1000,
+ 'suggestions' => ['Add index on user_id column']
+ ];
+ }
+}
+```
+## Related Examples
+
+### Prerequisites
+- **[01-basic-hello-world](../01-basic-hello-world/)** - Basic command structure
+- **[02-arguments-and-options](../02-arguments-and-options/)** - Database connection arguments
+
+### Enhanced Features
+- **[06-table-display](../06-table-display/)** - Display query results in tables
+- **[07-progress-bars](../07-progress-bars/)** - Progress for long database operations
+- **[05-interactive-commands](../05-interactive-commands/)** - Database management menus
+
+### User Interaction
+- **[03-user-input](../03-user-input/)** - Interactive database configuration
+- **[11-masked-input](../11-masked-input/)** - Secure database password input
+- **[04-output-formatting](../04-output-formatting/)** - Formatted database status
+
+### Data Processing
+- **[08-file-processing](../08-file-processing/)** - Import/export database data
+- **[10-multi-command-app](../10-multi-command-app/)** - Complete database CLI applications
+
+### Development Tools
+- **[12-command-scaffolding](../12-command-scaffolding/)** - Generate database operation commands
diff --git a/examples/09-database-ops/main.php b/examples/09-database-ops/main.php
index 0432552..e78b5d2 100644
--- a/examples/09-database-ops/main.php
+++ b/examples/09-database-ops/main.php
@@ -1,320 +1,320 @@
- [
- ArgumentOption::OPTIONAL => false,
- ArgumentOption::DESCRIPTION => 'Database action to perform',
- ArgumentOption::VALUES => ['connect', 'migrate', 'seed', 'query', 'backup', 'restore', 'status', 'cleanup']
- ],
- '--sql' => [
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DESCRIPTION => 'SQL query to execute (for query action)'
- ],
- '--file' => [
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DESCRIPTION => 'File path for backup/restore operations'
- ]
- ], 'Database management operations');
-
- $this->dbManager = new DatabaseManager();
- }
-
- public function exec(): int {
- $action = $this->getArgValue('--action');
-
- try {
- switch ($action) {
- case 'connect':
- return $this->testConnection();
- case 'migrate':
- return $this->runMigrations();
- case 'seed':
- return $this->seedDatabase();
- case 'query':
- return $this->executeQuery();
- case 'backup':
- return $this->backupDatabase();
- case 'restore':
- return $this->restoreDatabase();
- case 'status':
- return $this->showStatus();
- case 'cleanup':
- return $this->cleanupDatabase();
- default:
- $this->println("Unknown action: $action");
- return 1;
- }
- } catch (Exception $e) {
- $this->println("Error: " . $e->getMessage());
- return 1;
- }
- }
-
- private function testConnection(): int {
- $this->println("๐ Testing database connection...");
-
- if ($this->dbManager->connect()) {
- $this->println("โ Database connection successful!");
- $this->println("๐ Connection details:");
- $this->println(" โข Host: localhost:3306");
- $this->println(" โข Database: testing_db");
- $this->println(" โข Username: root");
- return 0;
- } else {
- $this->println("โ Database connection failed!");
- return 1;
- }
- }
-
- private function runMigrations(): int {
- $this->println("๐ Running database migrations...");
-
- if (!$this->dbManager->connect()) {
- $this->println("โ Cannot connect to database");
- return 1;
- }
-
- // Create sample tables
- $migrations = [
- "CREATE TABLE IF NOT EXISTS users (
- id INT AUTO_INCREMENT PRIMARY KEY,
- name VARCHAR(100) NOT NULL,
- email VARCHAR(100) UNIQUE NOT NULL,
- created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
- )",
- "CREATE TABLE IF NOT EXISTS posts (
- id INT AUTO_INCREMENT PRIMARY KEY,
- user_id INT,
- title VARCHAR(200) NOT NULL,
- content TEXT,
- created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
- FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE
- )"
- ];
-
- foreach ($migrations as $index => $sql) {
- $this->println(" โข Running migration " . ($index + 1) . "...");
- $this->dbManager->query($sql);
- }
-
- $this->println("โ Migrations completed successfully!");
- return 0;
- }
-
- private function seedDatabase(): int {
- $this->println("๐ฑ Seeding database with sample data...");
-
- if (!$this->dbManager->connect()) {
- $this->println("โ Cannot connect to database");
- return 1;
- }
-
- // Insert sample users
- $users = [
- ['Ahmed Hassan', 'ahmed.hassan@example.com'],
- ['Sarah Johnson', 'sarah.johnson@example.com'],
- ['Omar Al-Rashid', 'omar.alrashid@example.com']
- ];
-
- foreach ($users as $user) {
- $this->dbManager->query(
- "INSERT IGNORE INTO users (name, email) VALUES (?, ?)",
- $user
- );
- }
-
- // Insert sample posts
- $posts = [
- [1, 'First Post', 'This is the content of the first post.'],
- [1, 'Second Post', 'This is another post by Ahmed.'],
- [2, 'Sarah\'s Post', 'Hello from Sarah!'],
- [3, 'Omar\'s Thoughts', 'Some thoughts from Omar.']
- ];
-
- foreach ($posts as $post) {
- $this->dbManager->query(
- "INSERT IGNORE INTO posts (user_id, title, content) VALUES (?, ?, ?)",
- $post
- );
- }
-
- $this->println("โ Database seeded successfully!");
- $this->println(" โข Added 3 users");
- $this->println(" โข Added 4 posts");
- return 0;
- }
-
- private function executeQuery(): int {
- $sql = $this->getArgValue('--sql');
-
- if (!$sql) {
- $this->println("โ SQL query is required for query action");
- $this->println("Usage: php main.php db --action=query --sql=\"SELECT * FROM users\"");
- return 1;
- }
-
- $this->println("๐ Executing query...");
- $this->println("SQL: $sql");
-
- if (!$this->dbManager->connect()) {
- $this->println("โ Cannot connect to database");
- return 1;
- }
-
- $result = $this->dbManager->query($sql);
-
- if ($result['success']) {
- $data = $result['data'];
- if (!empty($data)) {
- $this->println("๐ Query results:");
- $this->table($data);
- $this->println("โฑ๏ธ Execution time: " . number_format($result['execution_time'] * 1000, 2) . "ms");
- } else {
- $this->println("๐ Query executed successfully (no results)");
- }
- } else {
- $this->println("โ Query failed: " . $result['error']);
- return 1;
- }
-
- return 0;
- }
-
- private function backupDatabase(): int {
- $file = $this->getArgValue('--file') ?? 'backup_' . date('Y-m-d_H-i-s') . '.sql';
-
- $this->println("๐พ Creating database backup...");
- $this->println("File: $file");
-
- if (!$this->dbManager->connect()) {
- $this->println("โ Cannot connect to database");
- return 1;
- }
-
- $result = $this->dbManager->createBackup($file);
-
- if ($result['success']) {
- $this->println("โ Backup created successfully!");
- $this->println(" โข File: " . $result['file']);
- $this->println(" โข Size: " . number_format($result['size']) . " bytes");
- $this->println(" โข Tables: " . $result['tables']);
- } else {
- $this->println("โ Backup failed: " . $result['error']);
- return 1;
- }
-
- return 0;
- }
-
- private function restoreDatabase(): int {
- $file = $this->getArgValue('--file');
-
- if (!$file || !file_exists($file)) {
- $this->println("โ Backup file is required and must exist");
- return 1;
- }
-
- $this->println("๐ Restoring database from backup...");
- $this->println("File: $file");
-
- if (!$this->dbManager->connect()) {
- $this->println("โ Cannot connect to database");
- return 1;
- }
-
- $result = $this->dbManager->restoreFromFile($file);
-
- if ($result['success']) {
- $this->println("โ Database restored successfully!");
- $this->println(" โข Statements executed: " . $result['statements']);
- } else {
- $this->println("โ Restore failed: " . $result['error']);
- return 1;
- }
-
- return 0;
- }
-
- private function showStatus(): int {
- $this->println("๐ Database Status");
- $this->println("==================");
-
- if (!$this->dbManager->connect()) {
- $this->println("โ Cannot connect to database");
- return 1;
- }
-
- // Show tables
- $tablesResult = $this->dbManager->query("SHOW TABLES");
- if (!$tablesResult['success']) {
- $this->println("โ Failed to get table list");
- return 1;
- }
-
- $tables = $tablesResult['data'];
- $this->println("๐ Tables: " . count($tables));
-
- foreach ($tables as $table) {
- $tableName = array_values($table)[0];
- $countResult = $this->dbManager->query("SELECT COUNT(*) as count FROM `$tableName`");
- if ($countResult['success'] && !empty($countResult['data'])) {
- $count = $countResult['data'][0]['count'] ?? 0;
- $this->println(" โข $tableName: $count records");
- }
- }
-
- return 0;
- }
-
- private function cleanupDatabase(): int {
- $this->println("๐งน Cleaning up database...");
-
- if (!$this->dbManager->connect()) {
- $this->println("โ Cannot connect to database");
- return 1;
- }
-
- // Drop tables in correct order (foreign key constraints)
- $tables = ['posts', 'users'];
-
- foreach ($tables as $table) {
- $this->println(" โข Dropping table: $table");
- $this->dbManager->query("DROP TABLE IF EXISTS `$table`");
- }
-
- $this->println("โ Database cleanup completed!");
- return 0;
- }
-}
-
-// Create and configure the CLI runner
-$runner = new Runner();
-$runner->register(new DatabaseCommand());
-$runner->setDefaultCommand('help');
-
-// Start the application
-exit($runner->start());
+ [
+ ArgumentOption::OPTIONAL => false,
+ ArgumentOption::DESCRIPTION => 'Database action to perform',
+ ArgumentOption::VALUES => ['connect', 'migrate', 'seed', 'query', 'backup', 'restore', 'status', 'cleanup']
+ ],
+ '--sql' => [
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DESCRIPTION => 'SQL query to execute (for query action)'
+ ],
+ '--file' => [
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DESCRIPTION => 'File path for backup/restore operations'
+ ]
+ ], 'Database management operations');
+
+ $this->dbManager = new DatabaseManager();
+ }
+
+ public function exec(): int {
+ $action = $this->getArgValue('--action');
+
+ try {
+ switch ($action) {
+ case 'connect':
+ return $this->testConnection();
+ case 'migrate':
+ return $this->runMigrations();
+ case 'seed':
+ return $this->seedDatabase();
+ case 'query':
+ return $this->executeQuery();
+ case 'backup':
+ return $this->backupDatabase();
+ case 'restore':
+ return $this->restoreDatabase();
+ case 'status':
+ return $this->showStatus();
+ case 'cleanup':
+ return $this->cleanupDatabase();
+ default:
+ $this->println("Unknown action: $action");
+ return 1;
+ }
+ } catch (Exception $e) {
+ $this->println("Error: " . $e->getMessage());
+ return 1;
+ }
+ }
+
+ private function testConnection(): int {
+ $this->println("๐ Testing database connection...");
+
+ if ($this->dbManager->connect()) {
+ $this->println("โ Database connection successful!");
+ $this->println("๐ Connection details:");
+ $this->println(" โข Host: localhost:3306");
+ $this->println(" โข Database: testing_db");
+ $this->println(" โข Username: root");
+ return 0;
+ } else {
+ $this->println("โ Database connection failed!");
+ return 1;
+ }
+ }
+
+ private function runMigrations(): int {
+ $this->println("๐ Running database migrations...");
+
+ if (!$this->dbManager->connect()) {
+ $this->println("โ Cannot connect to database");
+ return 1;
+ }
+
+ // Create sample tables
+ $migrations = [
+ "CREATE TABLE IF NOT EXISTS users (
+ id INT AUTO_INCREMENT PRIMARY KEY,
+ name VARCHAR(100) NOT NULL,
+ email VARCHAR(100) UNIQUE NOT NULL,
+ created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+ )",
+ "CREATE TABLE IF NOT EXISTS posts (
+ id INT AUTO_INCREMENT PRIMARY KEY,
+ user_id INT,
+ title VARCHAR(200) NOT NULL,
+ content TEXT,
+ created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+ FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE
+ )"
+ ];
+
+ foreach ($migrations as $index => $sql) {
+ $this->println(" โข Running migration " . ($index + 1) . "...");
+ $this->dbManager->query($sql);
+ }
+
+ $this->println("โ Migrations completed successfully!");
+ return 0;
+ }
+
+ private function seedDatabase(): int {
+ $this->println("๐ฑ Seeding database with sample data...");
+
+ if (!$this->dbManager->connect()) {
+ $this->println("โ Cannot connect to database");
+ return 1;
+ }
+
+ // Insert sample users
+ $users = [
+ ['Ahmed Hassan', 'ahmed.hassan@example.com'],
+ ['Sarah Johnson', 'sarah.johnson@example.com'],
+ ['Omar Al-Rashid', 'omar.alrashid@example.com']
+ ];
+
+ foreach ($users as $user) {
+ $this->dbManager->query(
+ "INSERT IGNORE INTO users (name, email) VALUES (?, ?)",
+ $user
+ );
+ }
+
+ // Insert sample posts
+ $posts = [
+ [1, 'First Post', 'This is the content of the first post.'],
+ [1, 'Second Post', 'This is another post by Ahmed.'],
+ [2, 'Sarah\'s Post', 'Hello from Sarah!'],
+ [3, 'Omar\'s Thoughts', 'Some thoughts from Omar.']
+ ];
+
+ foreach ($posts as $post) {
+ $this->dbManager->query(
+ "INSERT IGNORE INTO posts (user_id, title, content) VALUES (?, ?, ?)",
+ $post
+ );
+ }
+
+ $this->println("โ Database seeded successfully!");
+ $this->println(" โข Added 3 users");
+ $this->println(" โข Added 4 posts");
+ return 0;
+ }
+
+ private function executeQuery(): int {
+ $sql = $this->getArgValue('--sql');
+
+ if (!$sql) {
+ $this->println("โ SQL query is required for query action");
+ $this->println("Usage: php main.php db --action=query --sql=\"SELECT * FROM users\"");
+ return 1;
+ }
+
+ $this->println("๐ Executing query...");
+ $this->println("SQL: $sql");
+
+ if (!$this->dbManager->connect()) {
+ $this->println("โ Cannot connect to database");
+ return 1;
+ }
+
+ $result = $this->dbManager->query($sql);
+
+ if ($result['success']) {
+ $data = $result['data'];
+ if (!empty($data)) {
+ $this->println("๐ Query results:");
+ $this->table($data);
+ $this->println("โฑ๏ธ Execution time: " . number_format($result['execution_time'] * 1000, 2) . "ms");
+ } else {
+ $this->println("๐ Query executed successfully (no results)");
+ }
+ } else {
+ $this->println("โ Query failed: " . $result['error']);
+ return 1;
+ }
+
+ return 0;
+ }
+
+ private function backupDatabase(): int {
+ $file = $this->getArgValue('--file') ?? 'backup_' . date('Y-m-d_H-i-s') . '.sql';
+
+ $this->println("๐พ Creating database backup...");
+ $this->println("File: $file");
+
+ if (!$this->dbManager->connect()) {
+ $this->println("โ Cannot connect to database");
+ return 1;
+ }
+
+ $result = $this->dbManager->createBackup($file);
+
+ if ($result['success']) {
+ $this->println("โ Backup created successfully!");
+ $this->println(" โข File: " . $result['file']);
+ $this->println(" โข Size: " . number_format($result['size']) . " bytes");
+ $this->println(" โข Tables: " . $result['tables']);
+ } else {
+ $this->println("โ Backup failed: " . $result['error']);
+ return 1;
+ }
+
+ return 0;
+ }
+
+ private function restoreDatabase(): int {
+ $file = $this->getArgValue('--file');
+
+ if (!$file || !file_exists($file)) {
+ $this->println("โ Backup file is required and must exist");
+ return 1;
+ }
+
+ $this->println("๐ Restoring database from backup...");
+ $this->println("File: $file");
+
+ if (!$this->dbManager->connect()) {
+ $this->println("โ Cannot connect to database");
+ return 1;
+ }
+
+ $result = $this->dbManager->restoreFromFile($file);
+
+ if ($result['success']) {
+ $this->println("โ Database restored successfully!");
+ $this->println(" โข Statements executed: " . $result['statements']);
+ } else {
+ $this->println("โ Restore failed: " . $result['error']);
+ return 1;
+ }
+
+ return 0;
+ }
+
+ private function showStatus(): int {
+ $this->println("๐ Database Status");
+ $this->println("==================");
+
+ if (!$this->dbManager->connect()) {
+ $this->println("โ Cannot connect to database");
+ return 1;
+ }
+
+ // Show tables
+ $tablesResult = $this->dbManager->query("SHOW TABLES");
+ if (!$tablesResult['success']) {
+ $this->println("โ Failed to get table list");
+ return 1;
+ }
+
+ $tables = $tablesResult['data'];
+ $this->println("๐ Tables: " . count($tables));
+
+ foreach ($tables as $table) {
+ $tableName = array_values($table)[0];
+ $countResult = $this->dbManager->query("SELECT COUNT(*) as count FROM `$tableName`");
+ if ($countResult['success'] && !empty($countResult['data'])) {
+ $count = $countResult['data'][0]['count'] ?? 0;
+ $this->println(" โข $tableName: $count records");
+ }
+ }
+
+ return 0;
+ }
+
+ private function cleanupDatabase(): int {
+ $this->println("๐งน Cleaning up database...");
+
+ if (!$this->dbManager->connect()) {
+ $this->println("โ Cannot connect to database");
+ return 1;
+ }
+
+ // Drop tables in correct order (foreign key constraints)
+ $tables = ['posts', 'users'];
+
+ foreach ($tables as $table) {
+ $this->println(" โข Dropping table: $table");
+ $this->dbManager->query("DROP TABLE IF EXISTS `$table`");
+ }
+
+ $this->println("โ Database cleanup completed!");
+ return 0;
+ }
+}
+
+// Create and configure the CLI runner
+$runner = new Runner();
+$runner->register(new DatabaseCommand());
+$runner->setDefaultCommand('help');
+
+// Start the application
+exit($runner->start());
diff --git a/examples/09-database-ops/migrations/001_create_users_table.sql b/examples/09-database-ops/migrations/001_create_users_table.sql
index 7628d54..48eb536 100644
--- a/examples/09-database-ops/migrations/001_create_users_table.sql
+++ b/examples/09-database-ops/migrations/001_create_users_table.sql
@@ -1,14 +1,14 @@
--- Create users table
-CREATE TABLE users (
- id INT AUTO_INCREMENT PRIMARY KEY,
- name VARCHAR(100) NOT NULL,
- email VARCHAR(255) NOT NULL UNIQUE,
- password VARCHAR(255) NOT NULL,
- status ENUM('active', 'inactive') DEFAULT 'active',
- created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
- updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-
- INDEX idx_email (email),
- INDEX idx_status (status),
- INDEX idx_created_at (created_at)
-);
+-- Create users table
+CREATE TABLE users (
+ id INT AUTO_INCREMENT PRIMARY KEY,
+ name VARCHAR(100) NOT NULL,
+ email VARCHAR(255) NOT NULL UNIQUE,
+ password VARCHAR(255) NOT NULL,
+ status ENUM('active', 'inactive') DEFAULT 'active',
+ created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+ updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+
+ INDEX idx_email (email),
+ INDEX idx_status (status),
+ INDEX idx_created_at (created_at)
+);
diff --git a/examples/09-database-ops/seeds/users.json b/examples/09-database-ops/seeds/users.json
index 441bcef..41ed620 100644
--- a/examples/09-database-ops/seeds/users.json
+++ b/examples/09-database-ops/seeds/users.json
@@ -1,32 +1,32 @@
-[
- {
- "name": "Ahmed Hassan",
- "email": "ahmed.hassan@example.com",
- "password": "$2y$10$92IXUNpkjO0rOQ5byMi.Ye4oKoEa3Ro9llC/.og/at2.uheWG/igi",
- "status": "active"
- },
- {
- "name": "Sarah Johnson",
- "email": "sarah.johnson@example.com",
- "password": "$2y$10$92IXUNpkjO0rOQ5byMi.Ye4oKoEa3Ro9llC/.og/at2.uheWG/igi",
- "status": "active"
- },
- {
- "name": "Omar Al-Rashid",
- "email": "omar.alrashid@example.com",
- "password": "$2y$10$92IXUNpkjO0rOQ5byMi.Ye4oKoEa3Ro9llC/.og/at2.uheWG/igi",
- "status": "inactive"
- },
- {
- "name": "Fatima Al-Zahra",
- "email": "fatima.alzahra@example.com",
- "password": "$2y$10$92IXUNpkjO0rOQ5byMi.Ye4oKoEa3Ro9llC/.og/at2.uheWG/igi",
- "status": "active"
- },
- {
- "name": "Michael Davis",
- "email": "michael.davis@example.com",
- "password": "$2y$10$92IXUNpkjO0rOQ5byMi.Ye4oKoEa3Ro9llC/.og/at2.uheWG/igi",
- "status": "active"
- }
-]
+[
+ {
+ "name": "Ahmed Hassan",
+ "email": "ahmed.hassan@example.com",
+ "password": "$2y$10$92IXUNpkjO0rOQ5byMi.Ye4oKoEa3Ro9llC/.og/at2.uheWG/igi",
+ "status": "active"
+ },
+ {
+ "name": "Sarah Johnson",
+ "email": "sarah.johnson@example.com",
+ "password": "$2y$10$92IXUNpkjO0rOQ5byMi.Ye4oKoEa3Ro9llC/.og/at2.uheWG/igi",
+ "status": "active"
+ },
+ {
+ "name": "Omar Al-Rashid",
+ "email": "omar.alrashid@example.com",
+ "password": "$2y$10$92IXUNpkjO0rOQ5byMi.Ye4oKoEa3Ro9llC/.og/at2.uheWG/igi",
+ "status": "inactive"
+ },
+ {
+ "name": "Fatima Al-Zahra",
+ "email": "fatima.alzahra@example.com",
+ "password": "$2y$10$92IXUNpkjO0rOQ5byMi.Ye4oKoEa3Ro9llC/.og/at2.uheWG/igi",
+ "status": "active"
+ },
+ {
+ "name": "Michael Davis",
+ "email": "michael.davis@example.com",
+ "password": "$2y$10$92IXUNpkjO0rOQ5byMi.Ye4oKoEa3Ro9llC/.og/at2.uheWG/igi",
+ "status": "active"
+ }
+]
diff --git a/examples/10-multi-command-app/AppManager.php b/examples/10-multi-command-app/AppManager.php
index a0fcac6..1cf237d 100644
--- a/examples/10-multi-command-app/AppManager.php
+++ b/examples/10-multi-command-app/AppManager.php
@@ -1,466 +1,466 @@
-basePath = $basePath;
- $this->configPath = $basePath.'/config';
- $this->dataPath = $basePath.'/data';
-
- $this->ensureDirectories();
- $this->loadConfiguration();
- }
-
- /**
- * Create a backup of data.
- */
- public function createBackup(string $destination = null): string {
- $destination = $destination ?? $this->basePath.'/backups';
-
- if (!is_dir($destination)) {
- mkdir($destination, 0755, true);
- }
-
- $timestamp = date('Y-m-d_H-i-s');
- $backupFile = $destination."/backup_{$timestamp}.json";
-
- $backupData = [
- 'timestamp' => date('c'),
- 'version' => $this->getConfig('app.version'),
- 'data' => [
- 'users' => $this->loadData('users'),
- 'config' => $this->config
- ]
- ];
-
- $content = json_encode($backupData, JSON_PRETTY_PRINT);
- file_put_contents($backupFile, $content);
-
- $this->log('info', "Backup created: {$backupFile}");
-
- return $backupFile;
- }
-
- /**
- * Format data for output.
- */
- public function formatData(array $data, string $format): string {
- switch (strtolower($format)) {
- case 'json':
- return json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
-
- case 'csv':
- if (empty($data)) {
- return '';
- }
-
- $output = '';
- $headers = array_keys($data[0]);
- $output .= implode(',', $headers)."\n";
-
- foreach ($data as $row) {
- $values = array_map(function ($value) {
- return '"'.str_replace('"', '""', $value).'"';
- }, array_values($row));
- $output .= implode(',', $values)."\n";
- }
-
- return $output;
-
- case 'xml':
- $xml = new SimpleXMLElement('');
-
- foreach ($data as $item) {
- $record = $xml->addChild('record');
-
- foreach ($item as $key => $value) {
- $record->addChild($key, htmlspecialchars($value));
- }
- }
-
- return $xml->asXML();
-
- default:
- return print_r($data, true);
- }
- }
-
- /**
- * Get configuration value(s).
- */
- public function getConfig(string $key = null) {
- if ($key === null) {
- return $this->config;
- }
-
- $keys = explode('.', $key);
- $value = $this->config;
-
- foreach ($keys as $k) {
- if (!isset($value[$k])) {
- return null;
- }
- $value = $value[$k];
- }
-
- return $value;
- }
-
- /**
- * Get recent logs.
- */
- public function getLogs(int $limit = 100): array {
- return array_slice($this->logs, -$limit);
- }
-
- /**
- * Get application statistics.
- */
- public function getStats(): array {
- $users = $this->loadData('users');
-
- return [
- 'users' => [
- 'total' => count($users),
- 'active' => count(array_filter($users, fn($u) => $u['status'] === 'active')),
- 'inactive' => count(array_filter($users, fn($u) => $u['status'] === 'inactive'))
- ],
- 'storage' => [
- 'data_size' => $this->getDirectorySize($this->dataPath),
- 'config_size' => $this->getDirectorySize($this->configPath),
- 'free_space' => disk_free_space($this->basePath)
- ],
- 'logs' => [
- 'total_entries' => count($this->logs),
- 'errors' => count(array_filter($this->logs, fn($l) => $l['level'] === 'ERROR')),
- 'warnings' => count(array_filter($this->logs, fn($l) => $l['level'] === 'WARNING'))
- ]
- ];
- }
-
- /**
- * Load data from storage.
- */
- public function loadData(string $type): array {
- $filePath = $this->dataPath."/{$type}.json";
-
- if (!file_exists($filePath)) {
- return [];
- }
-
- $content = file_get_contents($filePath);
- $data = json_decode($content, true);
-
- if (json_last_error() !== JSON_ERROR_NONE) {
- $this->log('error', "Failed to load {$type} data: ".json_last_error_msg());
-
- return [];
- }
-
- return $data ?? [];
- }
-
- /**
- * Log a message.
- */
- public function log(string $level, string $message): void {
- $timestamp = date('Y-m-d H:i:s');
- $logEntry = [
- 'timestamp' => $timestamp,
- 'level' => strtoupper($level),
- 'message' => $message
- ];
-
- $this->logs[] = $logEntry;
-
- // Also write to file if configured
- if ($this->getConfig('logging.file_enabled')) {
- $this->writeLogToFile($logEntry);
- }
- }
-
- /**
- * Restore from backup.
- */
- public function restoreBackup(string $backupFile): bool {
- if (!file_exists($backupFile)) {
- $this->log('error', "Backup file not found: {$backupFile}");
-
- return false;
- }
-
- $content = file_get_contents($backupFile);
- $backupData = json_decode($content, true);
-
- if (json_last_error() !== JSON_ERROR_NONE) {
- $this->log('error', "Invalid backup file format");
-
- return false;
- }
-
- // Restore data
- foreach ($backupData['data'] as $type => $data) {
- if ($type === 'config') {
- $this->config = $data;
- $this->saveConfiguration();
- } else {
- $this->saveData($type, $data);
- }
- }
-
- $this->log('info', "Restored from backup: {$backupFile}");
-
- return true;
- }
-
- /**
- * Save data to storage.
- */
- public function saveData(string $type, array $data): bool {
- $filePath = $this->dataPath."/{$type}.json";
-
- $content = json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
-
- if (json_last_error() !== JSON_ERROR_NONE) {
- $this->log('error', "Failed to encode {$type} data: ".json_last_error_msg());
-
- return false;
- }
-
- $result = file_put_contents($filePath, $content);
-
- if ($result === false) {
- $this->log('error', "Failed to save {$type} data to {$filePath}");
-
- return false;
- }
-
- $this->log('info', "Saved {$type} data (".count($data)." records)");
-
- return true;
- }
-
- /**
- * Set configuration value.
- */
- public function setConfig(string $key, $value): void {
- $keys = explode('.', $key);
- $config = &$this->config;
-
- foreach ($keys as $k) {
- if (!isset($config[$k])) {
- $config[$k] = [];
- }
- $config = &$config[$k];
- }
-
- $config = $value;
- $this->saveConfiguration();
- }
-
- /**
- * Validate data against rules.
- */
- public function validateData(array $data, array $rules): array {
- $errors = [];
-
- foreach ($rules as $field => $rule) {
- $value = $data[$field] ?? null;
-
- // Required check
- if (isset($rule['required']) && $rule['required'] && empty($value)) {
- $errors[$field] = "Field {$field} is required";
- continue;
- }
-
- if (empty($value)) {
- continue; // Skip validation for empty optional fields
- }
-
- // Type check
- if (isset($rule['type'])) {
- if (!$this->validateType($value, $rule['type'])) {
- $errors[$field] = "Field {$field} must be of type {$rule['type']}";
- continue;
- }
- }
-
- // Length check
- if (isset($rule['min_length']) && strlen($value) < $rule['min_length']) {
- $errors[$field] = "Field {$field} must be at least {$rule['min_length']} characters";
- }
-
- if (isset($rule['max_length']) && strlen($value) > $rule['max_length']) {
- $errors[$field] = "Field {$field} must not exceed {$rule['max_length']} characters";
- }
-
- // Email validation
- if (isset($rule['email']) && $rule['email'] && !filter_var($value, FILTER_VALIDATE_EMAIL)) {
- $errors[$field] = "Field {$field} must be a valid email address";
- }
-
- // Custom validation
- if (isset($rule['validator']) && is_callable($rule['validator'])) {
- $result = $rule['validator']($value);
-
- if ($result !== true) {
- $errors[$field] = $result;
- }
- }
- }
-
- return $errors;
- }
-
- /**
- * Ensure required directories exist.
- */
- private function ensureDirectories(): void {
- $directories = [$this->configPath, $this->dataPath, $this->dataPath.'/logs'];
-
- foreach ($directories as $dir) {
- if (!is_dir($dir)) {
- mkdir($dir, 0755, true);
- }
- }
- }
-
- /**
- * Get directory size in bytes.
- */
- private function getDirectorySize(string $directory): int {
- $size = 0;
-
- if (is_dir($directory)) {
- $files = new RecursiveIteratorIterator(
- new RecursiveDirectoryIterator($directory, RecursiveDirectoryIterator::SKIP_DOTS)
- );
-
- foreach ($files as $file) {
- $size += $file->getSize();
- }
- }
-
- return $size;
- }
-
- /**
- * Load configuration from files.
- */
- private function loadConfiguration(): void {
- $configFiles = ['app.json', 'database.json'];
-
- foreach ($configFiles as $file) {
- $filePath = $this->configPath.'/'.$file;
-
- if (file_exists($filePath)) {
- $content = file_get_contents($filePath);
- $config = json_decode($content, true);
-
- if (json_last_error() === JSON_ERROR_NONE) {
- $this->config = array_merge($this->config, $config);
- }
- }
- }
-
- // Set defaults if not configured
- $this->setDefaults();
- }
-
- /**
- * Save configuration to file.
- */
- private function saveConfiguration(): void {
- $appConfig = [
- 'app' => $this->config['app'] ?? [],
- 'logging' => $this->config['logging'] ?? []
- ];
-
- $dbConfig = [
- 'database' => $this->config['database'] ?? []
- ];
-
- file_put_contents(
- $this->configPath.'/app.json',
- json_encode($appConfig, JSON_PRETTY_PRINT)
- );
-
- file_put_contents(
- $this->configPath.'/database.json',
- json_encode($dbConfig, JSON_PRETTY_PRINT)
- );
- }
-
- /**
- * Set default configuration values.
- */
- private function setDefaults(): void {
- $defaults = [
- 'app' => [
- 'name' => 'MyApp',
- 'version' => '1.0.0',
- 'environment' => 'development',
- 'debug' => true
- ],
- 'database' => [
- 'type' => 'json',
- 'path' => $this->dataPath
- ],
- 'logging' => [
- 'level' => 'info',
- 'file_enabled' => true
- ]
- ];
-
- foreach ($defaults as $section => $values) {
- if (!isset($this->config[$section])) {
- $this->config[$section] = [];
- }
-
- foreach ($values as $key => $value) {
- if (!isset($this->config[$section][$key])) {
- $this->config[$section][$key] = $value;
- }
- }
- }
- }
-
- /**
- * Validate data type.
- */
- private function validateType($value, string $type): bool {
- return match ($type) {
- 'string' => is_string($value),
- 'int', 'integer' => is_int($value) || (is_string($value) && ctype_digit($value)),
- 'float', 'double' => is_float($value) || is_numeric($value),
- 'bool', 'boolean' => is_bool($value) || in_array(strtolower($value), ['true', 'false', '1', '0']),
- 'array' => is_array($value),
- default => true
- };
- }
-
- /**
- * Write log entry to file.
- */
- private function writeLogToFile(array $logEntry): void {
- $logFile = $this->dataPath.'/logs/app.log';
- $line = "[{$logEntry['timestamp']}] {$logEntry['level']}: {$logEntry['message']}\n";
- file_put_contents($logFile, $line, FILE_APPEND | LOCK_EX);
- }
-}
+basePath = $basePath;
+ $this->configPath = $basePath.'/config';
+ $this->dataPath = $basePath.'/data';
+
+ $this->ensureDirectories();
+ $this->loadConfiguration();
+ }
+
+ /**
+ * Create a backup of data.
+ */
+ public function createBackup(string $destination = null): string {
+ $destination = $destination ?? $this->basePath.'/backups';
+
+ if (!is_dir($destination)) {
+ mkdir($destination, 0755, true);
+ }
+
+ $timestamp = date('Y-m-d_H-i-s');
+ $backupFile = $destination."/backup_{$timestamp}.json";
+
+ $backupData = [
+ 'timestamp' => date('c'),
+ 'version' => $this->getConfig('app.version'),
+ 'data' => [
+ 'users' => $this->loadData('users'),
+ 'config' => $this->config
+ ]
+ ];
+
+ $content = json_encode($backupData, JSON_PRETTY_PRINT);
+ file_put_contents($backupFile, $content);
+
+ $this->log('info', "Backup created: {$backupFile}");
+
+ return $backupFile;
+ }
+
+ /**
+ * Format data for output.
+ */
+ public function formatData(array $data, string $format): string {
+ switch (strtolower($format)) {
+ case 'json':
+ return json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
+
+ case 'csv':
+ if (empty($data)) {
+ return '';
+ }
+
+ $output = '';
+ $headers = array_keys($data[0]);
+ $output .= implode(',', $headers)."\n";
+
+ foreach ($data as $row) {
+ $values = array_map(function ($value) {
+ return '"'.str_replace('"', '""', $value).'"';
+ }, array_values($row));
+ $output .= implode(',', $values)."\n";
+ }
+
+ return $output;
+
+ case 'xml':
+ $xml = new SimpleXMLElement('');
+
+ foreach ($data as $item) {
+ $record = $xml->addChild('record');
+
+ foreach ($item as $key => $value) {
+ $record->addChild($key, htmlspecialchars($value));
+ }
+ }
+
+ return $xml->asXML();
+
+ default:
+ return print_r($data, true);
+ }
+ }
+
+ /**
+ * Get configuration value(s).
+ */
+ public function getConfig(string $key = null) {
+ if ($key === null) {
+ return $this->config;
+ }
+
+ $keys = explode('.', $key);
+ $value = $this->config;
+
+ foreach ($keys as $k) {
+ if (!isset($value[$k])) {
+ return null;
+ }
+ $value = $value[$k];
+ }
+
+ return $value;
+ }
+
+ /**
+ * Get recent logs.
+ */
+ public function getLogs(int $limit = 100): array {
+ return array_slice($this->logs, -$limit);
+ }
+
+ /**
+ * Get application statistics.
+ */
+ public function getStats(): array {
+ $users = $this->loadData('users');
+
+ return [
+ 'users' => [
+ 'total' => count($users),
+ 'active' => count(array_filter($users, fn($u) => $u['status'] === 'active')),
+ 'inactive' => count(array_filter($users, fn($u) => $u['status'] === 'inactive'))
+ ],
+ 'storage' => [
+ 'data_size' => $this->getDirectorySize($this->dataPath),
+ 'config_size' => $this->getDirectorySize($this->configPath),
+ 'free_space' => disk_free_space($this->basePath)
+ ],
+ 'logs' => [
+ 'total_entries' => count($this->logs),
+ 'errors' => count(array_filter($this->logs, fn($l) => $l['level'] === 'ERROR')),
+ 'warnings' => count(array_filter($this->logs, fn($l) => $l['level'] === 'WARNING'))
+ ]
+ ];
+ }
+
+ /**
+ * Load data from storage.
+ */
+ public function loadData(string $type): array {
+ $filePath = $this->dataPath."/{$type}.json";
+
+ if (!file_exists($filePath)) {
+ return [];
+ }
+
+ $content = file_get_contents($filePath);
+ $data = json_decode($content, true);
+
+ if (json_last_error() !== JSON_ERROR_NONE) {
+ $this->log('error', "Failed to load {$type} data: ".json_last_error_msg());
+
+ return [];
+ }
+
+ return $data ?? [];
+ }
+
+ /**
+ * Log a message.
+ */
+ public function log(string $level, string $message): void {
+ $timestamp = date('Y-m-d H:i:s');
+ $logEntry = [
+ 'timestamp' => $timestamp,
+ 'level' => strtoupper($level),
+ 'message' => $message
+ ];
+
+ $this->logs[] = $logEntry;
+
+ // Also write to file if configured
+ if ($this->getConfig('logging.file_enabled')) {
+ $this->writeLogToFile($logEntry);
+ }
+ }
+
+ /**
+ * Restore from backup.
+ */
+ public function restoreBackup(string $backupFile): bool {
+ if (!file_exists($backupFile)) {
+ $this->log('error', "Backup file not found: {$backupFile}");
+
+ return false;
+ }
+
+ $content = file_get_contents($backupFile);
+ $backupData = json_decode($content, true);
+
+ if (json_last_error() !== JSON_ERROR_NONE) {
+ $this->log('error', "Invalid backup file format");
+
+ return false;
+ }
+
+ // Restore data
+ foreach ($backupData['data'] as $type => $data) {
+ if ($type === 'config') {
+ $this->config = $data;
+ $this->saveConfiguration();
+ } else {
+ $this->saveData($type, $data);
+ }
+ }
+
+ $this->log('info', "Restored from backup: {$backupFile}");
+
+ return true;
+ }
+
+ /**
+ * Save data to storage.
+ */
+ public function saveData(string $type, array $data): bool {
+ $filePath = $this->dataPath."/{$type}.json";
+
+ $content = json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
+
+ if (json_last_error() !== JSON_ERROR_NONE) {
+ $this->log('error', "Failed to encode {$type} data: ".json_last_error_msg());
+
+ return false;
+ }
+
+ $result = file_put_contents($filePath, $content);
+
+ if ($result === false) {
+ $this->log('error', "Failed to save {$type} data to {$filePath}");
+
+ return false;
+ }
+
+ $this->log('info', "Saved {$type} data (".count($data)." records)");
+
+ return true;
+ }
+
+ /**
+ * Set configuration value.
+ */
+ public function setConfig(string $key, $value): void {
+ $keys = explode('.', $key);
+ $config = &$this->config;
+
+ foreach ($keys as $k) {
+ if (!isset($config[$k])) {
+ $config[$k] = [];
+ }
+ $config = &$config[$k];
+ }
+
+ $config = $value;
+ $this->saveConfiguration();
+ }
+
+ /**
+ * Validate data against rules.
+ */
+ public function validateData(array $data, array $rules): array {
+ $errors = [];
+
+ foreach ($rules as $field => $rule) {
+ $value = $data[$field] ?? null;
+
+ // Required check
+ if (isset($rule['required']) && $rule['required'] && empty($value)) {
+ $errors[$field] = "Field {$field} is required";
+ continue;
+ }
+
+ if (empty($value)) {
+ continue; // Skip validation for empty optional fields
+ }
+
+ // Type check
+ if (isset($rule['type'])) {
+ if (!$this->validateType($value, $rule['type'])) {
+ $errors[$field] = "Field {$field} must be of type {$rule['type']}";
+ continue;
+ }
+ }
+
+ // Length check
+ if (isset($rule['min_length']) && strlen($value) < $rule['min_length']) {
+ $errors[$field] = "Field {$field} must be at least {$rule['min_length']} characters";
+ }
+
+ if (isset($rule['max_length']) && strlen($value) > $rule['max_length']) {
+ $errors[$field] = "Field {$field} must not exceed {$rule['max_length']} characters";
+ }
+
+ // Email validation
+ if (isset($rule['email']) && $rule['email'] && !filter_var($value, FILTER_VALIDATE_EMAIL)) {
+ $errors[$field] = "Field {$field} must be a valid email address";
+ }
+
+ // Custom validation
+ if (isset($rule['validator']) && is_callable($rule['validator'])) {
+ $result = $rule['validator']($value);
+
+ if ($result !== true) {
+ $errors[$field] = $result;
+ }
+ }
+ }
+
+ return $errors;
+ }
+
+ /**
+ * Ensure required directories exist.
+ */
+ private function ensureDirectories(): void {
+ $directories = [$this->configPath, $this->dataPath, $this->dataPath.'/logs'];
+
+ foreach ($directories as $dir) {
+ if (!is_dir($dir)) {
+ mkdir($dir, 0755, true);
+ }
+ }
+ }
+
+ /**
+ * Get directory size in bytes.
+ */
+ private function getDirectorySize(string $directory): int {
+ $size = 0;
+
+ if (is_dir($directory)) {
+ $files = new RecursiveIteratorIterator(
+ new RecursiveDirectoryIterator($directory, RecursiveDirectoryIterator::SKIP_DOTS)
+ );
+
+ foreach ($files as $file) {
+ $size += $file->getSize();
+ }
+ }
+
+ return $size;
+ }
+
+ /**
+ * Load configuration from files.
+ */
+ private function loadConfiguration(): void {
+ $configFiles = ['app.json', 'database.json'];
+
+ foreach ($configFiles as $file) {
+ $filePath = $this->configPath.'/'.$file;
+
+ if (file_exists($filePath)) {
+ $content = file_get_contents($filePath);
+ $config = json_decode($content, true);
+
+ if (json_last_error() === JSON_ERROR_NONE) {
+ $this->config = array_merge($this->config, $config);
+ }
+ }
+ }
+
+ // Set defaults if not configured
+ $this->setDefaults();
+ }
+
+ /**
+ * Save configuration to file.
+ */
+ private function saveConfiguration(): void {
+ $appConfig = [
+ 'app' => $this->config['app'] ?? [],
+ 'logging' => $this->config['logging'] ?? []
+ ];
+
+ $dbConfig = [
+ 'database' => $this->config['database'] ?? []
+ ];
+
+ file_put_contents(
+ $this->configPath.'/app.json',
+ json_encode($appConfig, JSON_PRETTY_PRINT)
+ );
+
+ file_put_contents(
+ $this->configPath.'/database.json',
+ json_encode($dbConfig, JSON_PRETTY_PRINT)
+ );
+ }
+
+ /**
+ * Set default configuration values.
+ */
+ private function setDefaults(): void {
+ $defaults = [
+ 'app' => [
+ 'name' => 'MyApp',
+ 'version' => '1.0.0',
+ 'environment' => 'development',
+ 'debug' => true
+ ],
+ 'database' => [
+ 'type' => 'json',
+ 'path' => $this->dataPath
+ ],
+ 'logging' => [
+ 'level' => 'info',
+ 'file_enabled' => true
+ ]
+ ];
+
+ foreach ($defaults as $section => $values) {
+ if (!isset($this->config[$section])) {
+ $this->config[$section] = [];
+ }
+
+ foreach ($values as $key => $value) {
+ if (!isset($this->config[$section][$key])) {
+ $this->config[$section][$key] = $value;
+ }
+ }
+ }
+ }
+
+ /**
+ * Validate data type.
+ */
+ private function validateType($value, string $type): bool {
+ return match ($type) {
+ 'string' => is_string($value),
+ 'int', 'integer' => is_int($value) || (is_string($value) && ctype_digit($value)),
+ 'float', 'double' => is_float($value) || is_numeric($value),
+ 'bool', 'boolean' => is_bool($value) || in_array(strtolower($value), ['true', 'false', '1', '0']),
+ 'array' => is_array($value),
+ default => true
+ };
+ }
+
+ /**
+ * Write log entry to file.
+ */
+ private function writeLogToFile(array $logEntry): void {
+ $logFile = $this->dataPath.'/logs/app.log';
+ $line = "[{$logEntry['timestamp']}] {$logEntry['level']}: {$logEntry['message']}\n";
+ file_put_contents($logFile, $line, FILE_APPEND | LOCK_EX);
+ }
+}
diff --git a/examples/10-multi-command-app/README.md b/examples/10-multi-command-app/README.md
index afb40ad..3c87860 100644
--- a/examples/10-multi-command-app/README.md
+++ b/examples/10-multi-command-app/README.md
@@ -1,735 +1,735 @@
-# Multi-Command Application Example
-
-This example demonstrates building a complete, production-ready CLI application with comprehensive user management, data persistence, export functionality, and advanced CLI features using WebFiori CLI.
-
-## ๐ฏ What You'll Learn
-
-- Building complex multi-command CLI applications
-- User management system with CRUD operations
-- Data persistence with JSON file storage
-- Export functionality (JSON, CSV formats)
-- Interactive user input and validation
-- Search and filtering capabilities
-- Batch operations and file processing
-- Error handling and logging systems
-- Configuration management
-- Interactive mode for continuous operations
-
-## ๐ Project Structure
-
-```
-10-multi-command-app/
-โโโ commands/ # Command classes
-โ โโโ UserCommand.php # Complete user management system
-โโโ config/ # Configuration files
-โ โโโ app.json # Application configuration
-โโโ data/ # Data storage and logs
-โ โโโ users.json # User data persistence
-โ โโโ logs/ # Application logs
-โ โโโ app.log # Main application log
-โโโ AppManager.php # Core application manager
-โโโ main.php # Application entry point
-โโโ README.md # This documentation
-```
-
-## ๐ Running the Application
-
-### Basic Usage
-```bash
-# Show all available commands
-php main.php help
-
-# Show specific command help
-php main.php help --command=user
-
-# Start interactive mode
-php main.php -i
-```
-
-### User Management Operations
-```bash
-# List all users
-php main.php user --action=list
-
-# Create new user
-php main.php user --action=create --name="John Doe" --email="john@example.com" --status=active
-
-# Update existing user
-php main.php user --action=update --id=1 --name="Jane Doe" --status=inactive
-
-# Delete user (with confirmation)
-php main.php user --action=delete --id=1
-
-# Search users
-php main.php user --action=search --search="john"
-
-# Export users
-php main.php user --action=export --format=json --file=users.json
-php main.php user --action=export --format=csv --file=users.csv
-```
-
-## ๐ Available Commands
-
-### User Command (`user`)
-Complete user management system with the following actions:
-
-#### Actions (`--action`)
-- `list` - Display all users in formatted table
-- `create` - Create new user with validation
-- `update` - Update existing user by ID
-- `delete` - Delete user with confirmation prompt
-- `search` - Search users by name or email
-- `export` - Export users to file (JSON/CSV)
-
-#### Parameters
-- `--action` - Action to perform (**Required**)
-- `--id` - User ID for update/delete operations
-- `--name` - User full name
-- `--email` - User email address (validated)
-- `--status` - User status (active/inactive)
-- `--format` - Output format (table/json/csv) - Default: table
-- `--search` - Search term for filtering
-- `--limit` - Maximum number of results - Default: 50
-- `--batch` - Enable batch mode for bulk operations
-- `--file` - File path for batch operations or export
-
-#### Validation Rules
-- Email must be valid email format
-- Status must be 'active' or 'inactive'
-- ID must exist for update/delete operations
-- Name and email required for create operations
-
-## ๐จ Example Output
-
-### User List (Table Format)
-```bash
-php main.php user --action=list
-```
-```
-Info: ๐ฅ User Management - List Users
-
-โโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโ
-โ Id โ Name โ Email โ Status โ Created At โ Updated At โ
-โโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโค
-โ 1 โ John Doe โ john.doe@example.com โ active โ 2024-01-15 10:30:00 โ 2024-01-15 10:30:00 โ
-โ 2 โ Jane Smith โ jane.smith@example.com โ active โ 2024-01-16 14:20:00 โ 2024-01-16 14:20:00 โ
-โ 3 โ Bob Johnson โ bob.johnson@example.com โ inactive โ 2024-01-17 09:15:00 โ 2024-01-17 09:15:00 โ
-โโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโ
-
-Info: ๐ Total: 3 users | Active: 2 | Inactive: 1
-```
-
-### User Creation
-```bash
-php main.php user --action=create --name="Alice Brown" --email="alice@example.com" --status=active
-```
-```
-Success: โ User created successfully!
-
-Info: ๐ค User Information:
- โข ID: 4
- โข Name: Alice Brown
- โข Email: alice@example.com
- โข Status: Active
- โข Created: 2025-09-27 19:19:41
- โข Updated: 2025-09-27 19:19:41
-```
-
-### User Update
-```bash
-php main.php user --action=update --id=4 --name="Alice Cooper" --status=inactive
-```
-```
-Info: Updating user: Alice Brown (alice@example.com)
-Success: โ User updated successfully!
-
-Info: ๐ค User Information:
- โข ID: 4
- โข Name: Alice Cooper
- โข Email: alice@example.com
- โข Status: Inactive
- โข Created: 2025-09-27 19:19:41
- โข Updated: 2025-09-27 19:19:51
-```
-
-### User Search
-```bash
-php main.php user --action=search --search="john"
-```
-```
-Info: ๐ Search Results for: 'john'
-
-โโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโ
-โ Id โ Name โ Email โ Status โ Created At โ Updated At โ
-โโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโค
-โ 1 โ John Doe โ john.doe@example.com โ active โ 2024-01-15 10:30:00 โ 2024-01-15 10:30:00 โ
-โ 3 โ Bob Johnson โ bob.johnson@example.com โ inactive โ 2024-01-17 09:15:00 โ 2024-01-17 09:15:00 โ
-โโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโ
-Info: Found 2 user(s) matching 'john'
-```
-
-### User Export (JSON)
-```bash
-php main.php user --action=export --format=json --file=users_export.json
-```
-```
-Info: ๐ค Exporting 4 users to users_export.json
-Success: โ Export completed successfully!
-Info: ๐ Export Summary:
- โข Format: JSON
- โข Records: 4
- โข File Size: 881.0 B
- โข Location: users_export.json
-```
-
-### User Export (CSV)
-```bash
-php main.php user --action=export --format=csv --file=users_export.csv
-```
-```
-Info: ๐ค Exporting 4 users to users_export.csv
-Success: โ Export completed successfully!
-Info: ๐ Export Summary:
- โข Format: CSV
- โข Records: 4
- โข File Size: 422.0 B
- โข Location: users_export.csv
-```
-
-### User Deletion (with Confirmation)
-```bash
-php main.php user --action=delete --id=4
-```
-```
-Warning: โ ๏ธ You are about to delete user: Alice Cooper (alice@example.com)
-Are you sure you want to delete this user?(y/N)
-Success: โ User deleted successfully!
-```
-
-### JSON Output Format
-```bash
-php main.php user --action=list --format=json
-```
-```
-Info: ๐ฅ User Management - List Users
-
-[
- {
- "id": 1,
- "name": "John Doe",
- "email": "john.doe@example.com",
- "status": "active",
- "created_at": "2024-01-15 10:30:00",
- "updated_at": "2024-01-15 10:30:00"
- },
- {
- "id": 2,
- "name": "Jane Smith",
- "email": "jane.smith@example.com",
- "status": "active",
- "created_at": "2024-01-16 14:20:00",
- "updated_at": "2024-01-16 14:20:00"
- }
-]
-
-Info: ๐ Total: 2 users | Active: 2 | Inactive: 0
-```
-
-### Interactive Mode
-```bash
-php main.php -i
-```
-```
->> Running in interactive mode.
->> Type command name or 'exit' to close.
->> user --action=list
-Info: ๐ฅ User Management - List Users
-[Table output...]
->> exit
-```
-
-### Error Handling Examples
-
-#### Missing Required Action
-```bash
-php main.php user
-```
-```
-Error: The following required argument(s) are missing: '--action'
-```
-
-#### Invalid Action
-```bash
-php main.php user --action=invalid
-```
-```
-Error: The following argument(s) have invalid values: '--action'
-Info: Allowed values for the argument '--action':
-list
-create
-update
-delete
-search
-export
-```
-
-#### User Not Found
-```bash
-php main.php user --action=update --id=999 --name="Test"
-```
-```
-Error: User with ID 999 not found.
-```
-
-#### Validation Error
-```bash
-php main.php user --action=create --name="Test User"
-```
-```
-Enter user email:
-Error: Validation failed:
- โข Field email must be a valid email address
-```
-
-## ๐งช Test Scenarios
-
-### 1. Complete User Lifecycle
-```bash
-# Create, update, search, and delete user
-php main.php user --action=create --name="Test User" --email="test@example.com" --status=active
-php main.php user --action=update --id=4 --name="Updated User" --status=inactive
-php main.php user --action=search --search="updated"
-php main.php user --action=delete --id=4
-```
-
-### 2. Export and Format Testing
-```bash
-# Test different export formats
-php main.php user --action=export --format=json --file=test.json
-php main.php user --action=export --format=csv --file=test.csv
-php main.php user --action=list --format=json
-php main.php user --action=list --format=table
-```
-
-### 3. Search and Filter Testing
-```bash
-# Test search functionality
-php main.php user --action=search --search="john"
-php main.php user --action=search --search="@example.com"
-php main.php user --action=search --search="active"
-```
-
-### 4. Interactive Mode Testing
-```bash
-# Test interactive mode
-echo -e "user --action=list\nuser --action=create --name='Interactive User' --email='interactive@example.com'\nexit" | php main.php -i
-```
-
-### 5. Error Handling Testing
-```bash
-# Test various error conditions
-php main.php user --action=update --id=999
-php main.php user --action=create --name="Test"
-php main.php user --action=delete --id=999
-php main.php user --action=invalid
-```
-
-### 6. Batch Operations Testing
-```bash
-# Test batch file processing
-echo '[{"name":"Batch User 1","email":"batch1@example.com","status":"active"}]' > batch.json
-php main.php user --action=create --batch --file=batch.json
-```
-
-## ๐ก Key Features Demonstrated
-
-### 1. Application Architecture
-- **Multi-Command Structure**: Organized command classes with clear separation
-- **Configuration Management**: Centralized app configuration and settings
-- **Data Persistence**: JSON-based data storage with automatic backup
-- **Logging System**: Comprehensive application logging with timestamps
-
-### 2. User Management System
-- **CRUD Operations**: Complete Create, Read, Update, Delete functionality
-- **Data Validation**: Email validation, status validation, required field checks
-- **Search Functionality**: Search by name, email, or status
-- **Confirmation Prompts**: Safety confirmations for destructive operations
-
-### 3. Export and Import
-- **Multiple Formats**: JSON and CSV export capabilities
-- **File Management**: Automatic file naming and size reporting
-- **Batch Operations**: Bulk user creation from JSON files
-- **Data Integrity**: Validation during import/export operations
-
-### 4. User Experience
-- **Formatted Output**: Uses WebFiori CLI's built-in `table()` method for consistent, professional table formatting
-- **Interactive Input**: Prompts for missing required information
-- **Progress Feedback**: Clear success/error messages with emojis
-- **Help System**: Comprehensive help documentation for all commands
-
-### 5. Advanced CLI Features
-- **Interactive Mode**: Continuous command execution without restart
-- **Format Options**: Multiple output formats (table, JSON, CSV)
-- **Search and Filter**: Advanced filtering capabilities
-- **Logging**: Application activity logging for debugging and monitoring
-
-## ๐ง Technical Implementation
-
-### Core Classes
-- `UserCommand`: Complete user management command with all CRUD operations
-- `AppManager`: Application lifecycle management, logging, and configuration
-- `Runner`: WebFiori CLI runner with command registration and execution
-- **Built-in `table()` method**: Uses WebFiori CLI's native table formatting for consistent, professional display
-
-### Data Storage
-- **JSON Files**: User data stored in `data/users.json`
-- **Automatic Backup**: Data persistence with atomic writes
-- **Schema Validation**: Consistent data structure enforcement
-- **Migration Support**: Data format versioning and upgrades
-
-### User Data Structure
-```json
-{
- "id": 1,
- "name": "John Doe",
- "email": "john.doe@example.com",
- "status": "active",
- "created_at": "2024-01-15 10:30:00",
- "updated_at": "2024-01-15 10:30:00"
-}
-```
-
-### Export Formats
-- **JSON**: Structured data with full field information
-- **CSV**: Comma-separated values with headers
-- **Table**: Formatted console output with borders and alignment
-
-## ๐ฏ Best Practices Demonstrated
-
-### 1. Command Organization
-- Single responsibility principle for commands
-- Clear command naming and structure
-- Comprehensive argument validation
-- Consistent error handling patterns
-
-### 2. Data Management
-- Atomic file operations for data integrity
-- Backup and recovery mechanisms
-- Data validation and sanitization
-- Consistent data format and structure
-
-### 3. User Experience
-- Clear and informative output messages
-- Confirmation prompts for destructive actions
-- Multiple output format options
-- Comprehensive help and documentation
-
-### 4. Error Handling
-- Graceful error recovery
-- Informative error messages
-- Input validation and sanitization
-- Logging for debugging and monitoring
-
-### 5. Code Quality
-- Modular and maintainable code structure
-- Comprehensive documentation
-- Consistent coding standards
-- Testable command implementations
-
-## ๐ Related Examples
-
-- **[01-basic-command](../01-basic-command/)** - Simple command creation
-- **[02-command-with-args](../02-command-with-args/)** - Argument handling
-- **[06-table-display](../06-table-display/)** - Advanced table formatting
-- **[08-file-processing](../08-file-processing/)** - File operations and processing
-
-## ๐ Further Reading
-
-- [WebFiori CLI Documentation](https://webfiori.com/docs/cli)
-- [Command Design Patterns](https://refactoring.guru/design-patterns/command)
-- [CLI Application Best Practices](https://clig.dev/)
-- [JSON Data Management](https://www.json.org/json-en.html)
-- [CSV File Format Specification](https://tools.ietf.org/html/rfc4180)
-php main.php config:set --key="app.debug" --value="true"
-php main.php config:get --key="app.name"
-
-# Data operations
-php main.php data:export --format=json
-php main.php data:import --file="backup.json"
-php main.php data:backup --destination="./backups/"
-
-# System operations
-php main.php system:status
-php main.php system:cleanup
-php main.php system:info
-```
-
-### Advanced Usage
-```bash
-# Batch operations
-php main.php user:create --batch --file="users.csv"
-
-# Interactive mode
-php main.php -i
-
-# Verbose output
-php main.php user:list --verbose
-
-# Different output formats
-php main.php user:list --format=table
-php main.php user:list --format=json
-php main.php user:list --format=csv
-```
-
-## ๐ Application Architecture
-
-### Command Organization
-
-#### User Management Commands
-- `user:list` - List all users with filtering
-- `user:create` - Create new users
-- `user:update` - Update existing users
-- `user:delete` - Delete users
-- `user:search` - Search users by criteria
-
-#### Configuration Commands
-- `config:show` - Display current configuration
-- `config:set` - Set configuration values
-- `config:get` - Get specific configuration values
-- `config:reset` - Reset to default configuration
-
-#### Data Management Commands
-- `data:export` - Export data in various formats
-- `data:import` - Import data from files
-- `data:backup` - Create data backups
-- `data:restore` - Restore from backups
-- `data:validate` - Validate data integrity
-
-#### System Commands
-- `system:status` - Show system status
-- `system:info` - Display system information
-- `system:cleanup` - Clean temporary files
-- `system:logs` - View application logs
-
-### Core Components
-
-#### AppManager Class
-```php
-class AppManager {
- private array $config;
- private string $dataPath;
- private Logger $logger;
-
- public function getConfig(string $key = null);
- public function setConfig(string $key, $value);
- public function loadData(string $type): array;
- public function saveData(string $type, array $data);
- public function log(string $level, string $message);
-}
-```
-
-#### Base Command Class
-```php
-abstract class BaseCommand extends Command {
- protected AppManager $app;
-
- protected function getApp(): AppManager;
- protected function formatOutput(array $data, string $format);
- protected function validateInput(array $rules, array $data);
- protected function showProgress(callable $task, string $message);
-}
-```
-
-## ๐ Key Features
-
-### 1. Configuration Management
-- **JSON-based config**: Structured configuration files
-- **Environment support**: Different configs per environment
-- **Runtime modification**: Change config via CLI
-- **Validation**: Config value validation
-- **Defaults**: Fallback to default values
-
-### 2. Data Persistence
-- **JSON storage**: Simple file-based storage
-- **CRUD operations**: Create, Read, Update, Delete
-- **Data validation**: Input validation and sanitization
-- **Backup/Restore**: Data backup and recovery
-- **Migration**: Data structure migrations
-
-### 3. User Management
-- **User CRUD**: Complete user lifecycle management
-- **Search/Filter**: Advanced user searching
-- **Batch operations**: Bulk user operations
-- **Data export**: Export users in multiple formats
-- **Validation**: Email, phone, and data validation
-
-### 4. Output Formatting
-- **Multiple formats**: JSON, CSV, Table, XML
-- **Colored output**: ANSI color support
-- **Progress bars**: Long operation progress
-- **Pagination**: Large dataset handling
-- **Sorting**: Configurable data sorting
-
-### 5. Error Handling
-- **Graceful errors**: User-friendly error messages
-- **Logging**: Comprehensive error logging
-- **Recovery**: Automatic error recovery
-- **Validation**: Input validation with helpful messages
-- **Exit codes**: Proper exit code handling
-
-## ๐จ Expected Output
-
-### User List (Table Format)
-```
-๐ฅ User Management - List Users
-
-โโโโโโฌโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโ
-โ ID โ Name โ Email โ Status โ Created โ
-โโโโโโผโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโผโโโโโโโโโโโโโโค
-โ 1 โ John Doe โ john@example.com โ Active โ 2024-01-15 โ
-โ 2 โ Jane Smith โ jane@example.com โ Active โ 2024-01-16 โ
-โ 3 โ Bob Johnson โ bob@example.com โ Inactive โ 2024-01-17 โ
-โโโโโโดโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโดโโโโโโโโโโโโโโ
-
-๐ Total: 3 users | Active: 2 | Inactive: 1
-```
-
-### Configuration Display
-```
-โ๏ธ Application Configuration
-
-๐ฑ Application Settings:
- โข Name: MyApp
- โข Version: 1.0.0
- โข Environment: development
- โข Debug: enabled
-
-๐๏ธ Database Settings:
- โข Type: json
- โข Path: ./data/
- โข Backup: enabled
-
-๐ง System Settings:
- โข Log Level: info
- โข Max Users: 1000
- โข Auto Backup: daily
-```
-
-### System Status
-```
-๐ฅ๏ธ System Status Dashboard
-
-๐ Application Health:
- โ Configuration: OK
- โ Data Storage: OK
- โ Permissions: OK
- โ ๏ธ Disk Space: 85% used
-
-๐ Statistics:
- โข Total Users: 156
- โข Active Sessions: 12
- โข Uptime: 2d 14h 32m
- โข Memory Usage: 45.2 MB
-
-๐๏ธ Storage Information:
- โข Data Size: 2.3 MB
- โข Backup Size: 1.8 MB
- โข Log Size: 512 KB
- โข Free Space: 1.2 GB
-```
-
-### Data Export Progress
-```
-๐ค Exporting Data
-
-Preparing export...
-[โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 100.0% (156/156)
-
-โ Export completed successfully!
-
-๐ Export Summary:
- โข Format: JSON
- โข Records: 156 users
- โข File Size: 45.2 KB
- โข Location: ./exports/users_2024-01-20_14-30-15.json
- โข Duration: 00:02
-```
-
-## ๐งช Testing
-
-The application includes comprehensive unit tests:
-
-```bash
-# Run all tests
-php vendor/bin/phpunit tests/
-
-# Run specific test suite
-php vendor/bin/phpunit tests/UserCommandTest.php
-
-# Run with coverage
-php vendor/bin/phpunit --coverage-html coverage/
-```
-
-### Test Structure
-```
-tests/
-โโโ UserCommandTest.php
-โโโ ConfigCommandTest.php
-โโโ DataCommandTest.php
-โโโ SystemCommandTest.php
-โโโ AppManagerTest.php
-```
-
-## ๐ Next Steps
-
-After mastering this example, explore:
-- **[13-database-cli](../13-database-cli/)** - Database management tools
-- **Real database integration**: Connect to MySQL, PostgreSQL, SQLite
-- **API integration**: Connect to external APIs
-- **Web interface**: Add web-based management
-
-## ๐ก Try This
-
-Extend the application:
-
-1. **Add authentication**: User login and permissions
-2. **Database integration**: Replace JSON with SQL database
-3. **API integration**: Connect to external APIs
-4. **Plugin system**: Add plugin support
-5. **Web interface**: Add web-based management
-
-```php
-// Example: Add role-based permissions
-class User {
- public function hasPermission(string $permission): bool {
- return in_array($permission, $this->permissions);
- }
-}
-
-// Example: Add API integration
-class ApiClient {
- public function syncUsers(): array {
- // Sync with external API
- }
-}
-```
-## Related Examples
-
-### Building Blocks (Start Here)
-- **[01-basic-hello-world](../01-basic-hello-world/)** - Basic command structure
-- **[02-arguments-and-options](../02-arguments-and-options/)** - Command arguments and validation
-- **[03-user-input](../03-user-input/)** - User input and interaction
-
-### Feature Integration
-- **[04-output-formatting](../04-output-formatting/)** - Professional output styling
-- **[05-interactive-commands](../05-interactive-commands/)** - Menu-driven interfaces
-- **[06-table-display](../06-table-display/)** - Data presentation in tables
-- **[07-progress-bars](../07-progress-bars/)** - Visual progress feedback
-- **[11-masked-input](../11-masked-input/)** - Secure input handling
-
-### Specialized Operations
-- **[08-file-processing](../08-file-processing/)** - File management commands
-- **[09-database-ops](../09-database-ops/)** - Database operation commands
-
-### Development Tools
-- **[12-command-scaffolding](../12-command-scaffolding/)** - Generate commands for your application
+# Multi-Command Application Example
+
+This example demonstrates building a complete, production-ready CLI application with comprehensive user management, data persistence, export functionality, and advanced CLI features using WebFiori CLI.
+
+## ๐ฏ What You'll Learn
+
+- Building complex multi-command CLI applications
+- User management system with CRUD operations
+- Data persistence with JSON file storage
+- Export functionality (JSON, CSV formats)
+- Interactive user input and validation
+- Search and filtering capabilities
+- Batch operations and file processing
+- Error handling and logging systems
+- Configuration management
+- Interactive mode for continuous operations
+
+## ๐ Project Structure
+
+```
+10-multi-command-app/
+โโโ commands/ # Command classes
+โ โโโ UserCommand.php # Complete user management system
+โโโ config/ # Configuration files
+โ โโโ app.json # Application configuration
+โโโ data/ # Data storage and logs
+โ โโโ users.json # User data persistence
+โ โโโ logs/ # Application logs
+โ โโโ app.log # Main application log
+โโโ AppManager.php # Core application manager
+โโโ main.php # Application entry point
+โโโ README.md # This documentation
+```
+
+## ๐ Running the Application
+
+### Basic Usage
+```bash
+# Show all available commands
+php main.php help
+
+# Show specific command help
+php main.php help --command=user
+
+# Start interactive mode
+php main.php -i
+```
+
+### User Management Operations
+```bash
+# List all users
+php main.php user --action=list
+
+# Create new user
+php main.php user --action=create --name="John Doe" --email="john@example.com" --status=active
+
+# Update existing user
+php main.php user --action=update --id=1 --name="Jane Doe" --status=inactive
+
+# Delete user (with confirmation)
+php main.php user --action=delete --id=1
+
+# Search users
+php main.php user --action=search --search="john"
+
+# Export users
+php main.php user --action=export --format=json --file=users.json
+php main.php user --action=export --format=csv --file=users.csv
+```
+
+## ๐ Available Commands
+
+### User Command (`user`)
+Complete user management system with the following actions:
+
+#### Actions (`--action`)
+- `list` - Display all users in formatted table
+- `create` - Create new user with validation
+- `update` - Update existing user by ID
+- `delete` - Delete user with confirmation prompt
+- `search` - Search users by name or email
+- `export` - Export users to file (JSON/CSV)
+
+#### Parameters
+- `--action` - Action to perform (**Required**)
+- `--id` - User ID for update/delete operations
+- `--name` - User full name
+- `--email` - User email address (validated)
+- `--status` - User status (active/inactive)
+- `--format` - Output format (table/json/csv) - Default: table
+- `--search` - Search term for filtering
+- `--limit` - Maximum number of results - Default: 50
+- `--batch` - Enable batch mode for bulk operations
+- `--file` - File path for batch operations or export
+
+#### Validation Rules
+- Email must be valid email format
+- Status must be 'active' or 'inactive'
+- ID must exist for update/delete operations
+- Name and email required for create operations
+
+## ๐จ Example Output
+
+### User List (Table Format)
+```bash
+php main.php user --action=list
+```
+```
+Info: ๐ฅ User Management - List Users
+
+โโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโ
+โ Id โ Name โ Email โ Status โ Created At โ Updated At โ
+โโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโค
+โ 1 โ John Doe โ john.doe@example.com โ active โ 2024-01-15 10:30:00 โ 2024-01-15 10:30:00 โ
+โ 2 โ Jane Smith โ jane.smith@example.com โ active โ 2024-01-16 14:20:00 โ 2024-01-16 14:20:00 โ
+โ 3 โ Bob Johnson โ bob.johnson@example.com โ inactive โ 2024-01-17 09:15:00 โ 2024-01-17 09:15:00 โ
+โโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโ
+
+Info: ๐ Total: 3 users | Active: 2 | Inactive: 1
+```
+
+### User Creation
+```bash
+php main.php user --action=create --name="Alice Brown" --email="alice@example.com" --status=active
+```
+```
+Success: โ User created successfully!
+
+Info: ๐ค User Information:
+ โข ID: 4
+ โข Name: Alice Brown
+ โข Email: alice@example.com
+ โข Status: Active
+ โข Created: 2025-09-27 19:19:41
+ โข Updated: 2025-09-27 19:19:41
+```
+
+### User Update
+```bash
+php main.php user --action=update --id=4 --name="Alice Cooper" --status=inactive
+```
+```
+Info: Updating user: Alice Brown (alice@example.com)
+Success: โ User updated successfully!
+
+Info: ๐ค User Information:
+ โข ID: 4
+ โข Name: Alice Cooper
+ โข Email: alice@example.com
+ โข Status: Inactive
+ โข Created: 2025-09-27 19:19:41
+ โข Updated: 2025-09-27 19:19:51
+```
+
+### User Search
+```bash
+php main.php user --action=search --search="john"
+```
+```
+Info: ๐ Search Results for: 'john'
+
+โโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโ
+โ Id โ Name โ Email โ Status โ Created At โ Updated At โ
+โโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโค
+โ 1 โ John Doe โ john.doe@example.com โ active โ 2024-01-15 10:30:00 โ 2024-01-15 10:30:00 โ
+โ 3 โ Bob Johnson โ bob.johnson@example.com โ inactive โ 2024-01-17 09:15:00 โ 2024-01-17 09:15:00 โ
+โโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโ
+Info: Found 2 user(s) matching 'john'
+```
+
+### User Export (JSON)
+```bash
+php main.php user --action=export --format=json --file=users_export.json
+```
+```
+Info: ๐ค Exporting 4 users to users_export.json
+Success: โ Export completed successfully!
+Info: ๐ Export Summary:
+ โข Format: JSON
+ โข Records: 4
+ โข File Size: 881.0 B
+ โข Location: users_export.json
+```
+
+### User Export (CSV)
+```bash
+php main.php user --action=export --format=csv --file=users_export.csv
+```
+```
+Info: ๐ค Exporting 4 users to users_export.csv
+Success: โ Export completed successfully!
+Info: ๐ Export Summary:
+ โข Format: CSV
+ โข Records: 4
+ โข File Size: 422.0 B
+ โข Location: users_export.csv
+```
+
+### User Deletion (with Confirmation)
+```bash
+php main.php user --action=delete --id=4
+```
+```
+Warning: โ ๏ธ You are about to delete user: Alice Cooper (alice@example.com)
+Are you sure you want to delete this user?(y/N)
+Success: โ User deleted successfully!
+```
+
+### JSON Output Format
+```bash
+php main.php user --action=list --format=json
+```
+```
+Info: ๐ฅ User Management - List Users
+
+[
+ {
+ "id": 1,
+ "name": "John Doe",
+ "email": "john.doe@example.com",
+ "status": "active",
+ "created_at": "2024-01-15 10:30:00",
+ "updated_at": "2024-01-15 10:30:00"
+ },
+ {
+ "id": 2,
+ "name": "Jane Smith",
+ "email": "jane.smith@example.com",
+ "status": "active",
+ "created_at": "2024-01-16 14:20:00",
+ "updated_at": "2024-01-16 14:20:00"
+ }
+]
+
+Info: ๐ Total: 2 users | Active: 2 | Inactive: 0
+```
+
+### Interactive Mode
+```bash
+php main.php -i
+```
+```
+>> Running in interactive mode.
+>> Type command name or 'exit' to close.
+>> user --action=list
+Info: ๐ฅ User Management - List Users
+[Table output...]
+>> exit
+```
+
+### Error Handling Examples
+
+#### Missing Required Action
+```bash
+php main.php user
+```
+```
+Error: The following required argument(s) are missing: '--action'
+```
+
+#### Invalid Action
+```bash
+php main.php user --action=invalid
+```
+```
+Error: The following argument(s) have invalid values: '--action'
+Info: Allowed values for the argument '--action':
+list
+create
+update
+delete
+search
+export
+```
+
+#### User Not Found
+```bash
+php main.php user --action=update --id=999 --name="Test"
+```
+```
+Error: User with ID 999 not found.
+```
+
+#### Validation Error
+```bash
+php main.php user --action=create --name="Test User"
+```
+```
+Enter user email:
+Error: Validation failed:
+ โข Field email must be a valid email address
+```
+
+## ๐งช Test Scenarios
+
+### 1. Complete User Lifecycle
+```bash
+# Create, update, search, and delete user
+php main.php user --action=create --name="Test User" --email="test@example.com" --status=active
+php main.php user --action=update --id=4 --name="Updated User" --status=inactive
+php main.php user --action=search --search="updated"
+php main.php user --action=delete --id=4
+```
+
+### 2. Export and Format Testing
+```bash
+# Test different export formats
+php main.php user --action=export --format=json --file=test.json
+php main.php user --action=export --format=csv --file=test.csv
+php main.php user --action=list --format=json
+php main.php user --action=list --format=table
+```
+
+### 3. Search and Filter Testing
+```bash
+# Test search functionality
+php main.php user --action=search --search="john"
+php main.php user --action=search --search="@example.com"
+php main.php user --action=search --search="active"
+```
+
+### 4. Interactive Mode Testing
+```bash
+# Test interactive mode
+echo -e "user --action=list\nuser --action=create --name='Interactive User' --email='interactive@example.com'\nexit" | php main.php -i
+```
+
+### 5. Error Handling Testing
+```bash
+# Test various error conditions
+php main.php user --action=update --id=999
+php main.php user --action=create --name="Test"
+php main.php user --action=delete --id=999
+php main.php user --action=invalid
+```
+
+### 6. Batch Operations Testing
+```bash
+# Test batch file processing
+echo '[{"name":"Batch User 1","email":"batch1@example.com","status":"active"}]' > batch.json
+php main.php user --action=create --batch --file=batch.json
+```
+
+## ๐ก Key Features Demonstrated
+
+### 1. Application Architecture
+- **Multi-Command Structure**: Organized command classes with clear separation
+- **Configuration Management**: Centralized app configuration and settings
+- **Data Persistence**: JSON-based data storage with automatic backup
+- **Logging System**: Comprehensive application logging with timestamps
+
+### 2. User Management System
+- **CRUD Operations**: Complete Create, Read, Update, Delete functionality
+- **Data Validation**: Email validation, status validation, required field checks
+- **Search Functionality**: Search by name, email, or status
+- **Confirmation Prompts**: Safety confirmations for destructive operations
+
+### 3. Export and Import
+- **Multiple Formats**: JSON and CSV export capabilities
+- **File Management**: Automatic file naming and size reporting
+- **Batch Operations**: Bulk user creation from JSON files
+- **Data Integrity**: Validation during import/export operations
+
+### 4. User Experience
+- **Formatted Output**: Uses WebFiori CLI's built-in `table()` method for consistent, professional table formatting
+- **Interactive Input**: Prompts for missing required information
+- **Progress Feedback**: Clear success/error messages with emojis
+- **Help System**: Comprehensive help documentation for all commands
+
+### 5. Advanced CLI Features
+- **Interactive Mode**: Continuous command execution without restart
+- **Format Options**: Multiple output formats (table, JSON, CSV)
+- **Search and Filter**: Advanced filtering capabilities
+- **Logging**: Application activity logging for debugging and monitoring
+
+## ๐ง Technical Implementation
+
+### Core Classes
+- `UserCommand`: Complete user management command with all CRUD operations
+- `AppManager`: Application lifecycle management, logging, and configuration
+- `Runner`: WebFiori CLI runner with command registration and execution
+- **Built-in `table()` method**: Uses WebFiori CLI's native table formatting for consistent, professional display
+
+### Data Storage
+- **JSON Files**: User data stored in `data/users.json`
+- **Automatic Backup**: Data persistence with atomic writes
+- **Schema Validation**: Consistent data structure enforcement
+- **Migration Support**: Data format versioning and upgrades
+
+### User Data Structure
+```json
+{
+ "id": 1,
+ "name": "John Doe",
+ "email": "john.doe@example.com",
+ "status": "active",
+ "created_at": "2024-01-15 10:30:00",
+ "updated_at": "2024-01-15 10:30:00"
+}
+```
+
+### Export Formats
+- **JSON**: Structured data with full field information
+- **CSV**: Comma-separated values with headers
+- **Table**: Formatted console output with borders and alignment
+
+## ๐ฏ Best Practices Demonstrated
+
+### 1. Command Organization
+- Single responsibility principle for commands
+- Clear command naming and structure
+- Comprehensive argument validation
+- Consistent error handling patterns
+
+### 2. Data Management
+- Atomic file operations for data integrity
+- Backup and recovery mechanisms
+- Data validation and sanitization
+- Consistent data format and structure
+
+### 3. User Experience
+- Clear and informative output messages
+- Confirmation prompts for destructive actions
+- Multiple output format options
+- Comprehensive help and documentation
+
+### 4. Error Handling
+- Graceful error recovery
+- Informative error messages
+- Input validation and sanitization
+- Logging for debugging and monitoring
+
+### 5. Code Quality
+- Modular and maintainable code structure
+- Comprehensive documentation
+- Consistent coding standards
+- Testable command implementations
+
+## ๐ Related Examples
+
+- **[01-basic-command](../01-basic-command/)** - Simple command creation
+- **[02-command-with-args](../02-command-with-args/)** - Argument handling
+- **[06-table-display](../06-table-display/)** - Advanced table formatting
+- **[08-file-processing](../08-file-processing/)** - File operations and processing
+
+## ๐ Further Reading
+
+- [WebFiori CLI Documentation](https://webfiori.com/docs/cli)
+- [Command Design Patterns](https://refactoring.guru/design-patterns/command)
+- [CLI Application Best Practices](https://clig.dev/)
+- [JSON Data Management](https://www.json.org/json-en.html)
+- [CSV File Format Specification](https://tools.ietf.org/html/rfc4180)
+php main.php config:set --key="app.debug" --value="true"
+php main.php config:get --key="app.name"
+
+# Data operations
+php main.php data:export --format=json
+php main.php data:import --file="backup.json"
+php main.php data:backup --destination="./backups/"
+
+# System operations
+php main.php system:status
+php main.php system:cleanup
+php main.php system:info
+```
+
+### Advanced Usage
+```bash
+# Batch operations
+php main.php user:create --batch --file="users.csv"
+
+# Interactive mode
+php main.php -i
+
+# Verbose output
+php main.php user:list --verbose
+
+# Different output formats
+php main.php user:list --format=table
+php main.php user:list --format=json
+php main.php user:list --format=csv
+```
+
+## ๐ Application Architecture
+
+### Command Organization
+
+#### User Management Commands
+- `user:list` - List all users with filtering
+- `user:create` - Create new users
+- `user:update` - Update existing users
+- `user:delete` - Delete users
+- `user:search` - Search users by criteria
+
+#### Configuration Commands
+- `config:show` - Display current configuration
+- `config:set` - Set configuration values
+- `config:get` - Get specific configuration values
+- `config:reset` - Reset to default configuration
+
+#### Data Management Commands
+- `data:export` - Export data in various formats
+- `data:import` - Import data from files
+- `data:backup` - Create data backups
+- `data:restore` - Restore from backups
+- `data:validate` - Validate data integrity
+
+#### System Commands
+- `system:status` - Show system status
+- `system:info` - Display system information
+- `system:cleanup` - Clean temporary files
+- `system:logs` - View application logs
+
+### Core Components
+
+#### AppManager Class
+```php
+class AppManager {
+ private array $config;
+ private string $dataPath;
+ private Logger $logger;
+
+ public function getConfig(string $key = null);
+ public function setConfig(string $key, $value);
+ public function loadData(string $type): array;
+ public function saveData(string $type, array $data);
+ public function log(string $level, string $message);
+}
+```
+
+#### Base Command Class
+```php
+abstract class BaseCommand extends Command {
+ protected AppManager $app;
+
+ protected function getApp(): AppManager;
+ protected function formatOutput(array $data, string $format);
+ protected function validateInput(array $rules, array $data);
+ protected function showProgress(callable $task, string $message);
+}
+```
+
+## ๐ Key Features
+
+### 1. Configuration Management
+- **JSON-based config**: Structured configuration files
+- **Environment support**: Different configs per environment
+- **Runtime modification**: Change config via CLI
+- **Validation**: Config value validation
+- **Defaults**: Fallback to default values
+
+### 2. Data Persistence
+- **JSON storage**: Simple file-based storage
+- **CRUD operations**: Create, Read, Update, Delete
+- **Data validation**: Input validation and sanitization
+- **Backup/Restore**: Data backup and recovery
+- **Migration**: Data structure migrations
+
+### 3. User Management
+- **User CRUD**: Complete user lifecycle management
+- **Search/Filter**: Advanced user searching
+- **Batch operations**: Bulk user operations
+- **Data export**: Export users in multiple formats
+- **Validation**: Email, phone, and data validation
+
+### 4. Output Formatting
+- **Multiple formats**: JSON, CSV, Table, XML
+- **Colored output**: ANSI color support
+- **Progress bars**: Long operation progress
+- **Pagination**: Large dataset handling
+- **Sorting**: Configurable data sorting
+
+### 5. Error Handling
+- **Graceful errors**: User-friendly error messages
+- **Logging**: Comprehensive error logging
+- **Recovery**: Automatic error recovery
+- **Validation**: Input validation with helpful messages
+- **Exit codes**: Proper exit code handling
+
+## ๐จ Expected Output
+
+### User List (Table Format)
+```
+๐ฅ User Management - List Users
+
+โโโโโโฌโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโ
+โ ID โ Name โ Email โ Status โ Created โ
+โโโโโโผโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโผโโโโโโโโโโโโโโค
+โ 1 โ John Doe โ john@example.com โ Active โ 2024-01-15 โ
+โ 2 โ Jane Smith โ jane@example.com โ Active โ 2024-01-16 โ
+โ 3 โ Bob Johnson โ bob@example.com โ Inactive โ 2024-01-17 โ
+โโโโโโดโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโดโโโโโโโโโโโโโโ
+
+๐ Total: 3 users | Active: 2 | Inactive: 1
+```
+
+### Configuration Display
+```
+โ๏ธ Application Configuration
+
+๐ฑ Application Settings:
+ โข Name: MyApp
+ โข Version: 1.0.0
+ โข Environment: development
+ โข Debug: enabled
+
+๐๏ธ Database Settings:
+ โข Type: json
+ โข Path: ./data/
+ โข Backup: enabled
+
+๐ง System Settings:
+ โข Log Level: info
+ โข Max Users: 1000
+ โข Auto Backup: daily
+```
+
+### System Status
+```
+๐ฅ๏ธ System Status Dashboard
+
+๐ Application Health:
+ โ Configuration: OK
+ โ Data Storage: OK
+ โ Permissions: OK
+ โ ๏ธ Disk Space: 85% used
+
+๐ Statistics:
+ โข Total Users: 156
+ โข Active Sessions: 12
+ โข Uptime: 2d 14h 32m
+ โข Memory Usage: 45.2 MB
+
+๐๏ธ Storage Information:
+ โข Data Size: 2.3 MB
+ โข Backup Size: 1.8 MB
+ โข Log Size: 512 KB
+ โข Free Space: 1.2 GB
+```
+
+### Data Export Progress
+```
+๐ค Exporting Data
+
+Preparing export...
+[โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ] 100.0% (156/156)
+
+โ Export completed successfully!
+
+๐ Export Summary:
+ โข Format: JSON
+ โข Records: 156 users
+ โข File Size: 45.2 KB
+ โข Location: ./exports/users_2024-01-20_14-30-15.json
+ โข Duration: 00:02
+```
+
+## ๐งช Testing
+
+The application includes comprehensive unit tests:
+
+```bash
+# Run all tests
+php vendor/bin/phpunit tests/
+
+# Run specific test suite
+php vendor/bin/phpunit tests/UserCommandTest.php
+
+# Run with coverage
+php vendor/bin/phpunit --coverage-html coverage/
+```
+
+### Test Structure
+```
+tests/
+โโโ UserCommandTest.php
+โโโ ConfigCommandTest.php
+โโโ DataCommandTest.php
+โโโ SystemCommandTest.php
+โโโ AppManagerTest.php
+```
+
+## ๐ Next Steps
+
+After mastering this example, explore:
+- **[13-database-cli](../13-database-cli/)** - Database management tools
+- **Real database integration**: Connect to MySQL, PostgreSQL, SQLite
+- **API integration**: Connect to external APIs
+- **Web interface**: Add web-based management
+
+## ๐ก Try This
+
+Extend the application:
+
+1. **Add authentication**: User login and permissions
+2. **Database integration**: Replace JSON with SQL database
+3. **API integration**: Connect to external APIs
+4. **Plugin system**: Add plugin support
+5. **Web interface**: Add web-based management
+
+```php
+// Example: Add role-based permissions
+class User {
+ public function hasPermission(string $permission): bool {
+ return in_array($permission, $this->permissions);
+ }
+}
+
+// Example: Add API integration
+class ApiClient {
+ public function syncUsers(): array {
+ // Sync with external API
+ }
+}
+```
+## Related Examples
+
+### Building Blocks (Start Here)
+- **[01-basic-hello-world](../01-basic-hello-world/)** - Basic command structure
+- **[02-arguments-and-options](../02-arguments-and-options/)** - Command arguments and validation
+- **[03-user-input](../03-user-input/)** - User input and interaction
+
+### Feature Integration
+- **[04-output-formatting](../04-output-formatting/)** - Professional output styling
+- **[05-interactive-commands](../05-interactive-commands/)** - Menu-driven interfaces
+- **[06-table-display](../06-table-display/)** - Data presentation in tables
+- **[07-progress-bars](../07-progress-bars/)** - Visual progress feedback
+- **[11-masked-input](../11-masked-input/)** - Secure input handling
+
+### Specialized Operations
+- **[08-file-processing](../08-file-processing/)** - File management commands
+- **[09-database-ops](../09-database-ops/)** - Database operation commands
+
+### Development Tools
+- **[12-command-scaffolding](../12-command-scaffolding/)** - Generate commands for your application
diff --git a/examples/10-multi-command-app/commands/UserCommand.php b/examples/10-multi-command-app/commands/UserCommand.php
index 1a3ec37..63b0060 100644
--- a/examples/10-multi-command-app/commands/UserCommand.php
+++ b/examples/10-multi-command-app/commands/UserCommand.php
@@ -1,603 +1,603 @@
- [
- ArgumentOption::DESCRIPTION => 'Action to perform',
- ArgumentOption::OPTIONAL => false,
- ArgumentOption::VALUES => ['list', 'create', 'update', 'delete', 'search', 'export']
- ],
- '--id' => [
- ArgumentOption::DESCRIPTION => 'User ID for update/delete operations',
- ArgumentOption::OPTIONAL => true
- ],
- '--name' => [
- ArgumentOption::DESCRIPTION => 'User full name',
- ArgumentOption::OPTIONAL => true
- ],
- '--email' => [
- ArgumentOption::DESCRIPTION => 'User email address',
- ArgumentOption::OPTIONAL => true
- ],
- '--status' => [
- ArgumentOption::DESCRIPTION => 'User status',
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::VALUES => ['active', 'inactive']
- ],
- '--format' => [
- ArgumentOption::DESCRIPTION => 'Output format',
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DEFAULT => 'table',
- ArgumentOption::VALUES => ['table', 'json', 'csv', 'xml']
- ],
- '--search' => [
- ArgumentOption::DESCRIPTION => 'Search term for filtering users',
- ArgumentOption::OPTIONAL => true
- ],
- '--limit' => [
- ArgumentOption::DESCRIPTION => 'Maximum number of results',
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DEFAULT => '50'
- ],
- '--batch' => [
- ArgumentOption::DESCRIPTION => 'Enable batch mode for bulk operations',
- ArgumentOption::OPTIONAL => true
- ],
- '--file' => [
- ArgumentOption::DESCRIPTION => 'File path for batch operations or export',
- ArgumentOption::OPTIONAL => true
- ]
- ], 'User management operations (list, create, update, delete, search, export)');
-
- $this->app = new AppManager();
- }
-
- public function exec(): int {
- $action = $this->getArgValue('--action');
-
- try {
- return match ($action) {
- 'list' => $this->listUsers(),
- 'create' => $this->createUser(),
- 'update' => $this->updateUser(),
- 'delete' => $this->deleteUser(),
- 'search' => $this->searchUsers(),
- 'export' => $this->exportUsers(),
- default => $this->showUsage()
- };
- } catch (Exception $e) {
- $this->error("Operation failed: ".$e->getMessage());
- $this->app->log('error', "User command failed: ".$e->getMessage());
-
- return 1;
- }
- }
-
- /**
- * Create a new user.
- */
- private function createUser(): int {
- if ($this->isArgProvided('--batch')) {
- return $this->createUsersBatch();
- }
-
- $name = $this->getArgValue('--name');
- $email = $this->getArgValue('--email');
- $status = $this->getArgValue('--status') ?? 'active';
-
- // Interactive input if not provided
- if (!$name) {
- $name = $this->getInput('Enter user name: ');
- }
-
- if (!$email) {
- $email = $this->getInput('Enter user email: ');
- }
-
- // Validate input
- $errors = $this->app->validateData([
- 'name' => $name,
- 'email' => $email,
- 'status' => $status
- ], [
- 'name' => ['required' => true, 'min_length' => 2, 'max_length' => 100],
- 'email' => ['required' => true, 'email' => true],
- 'status' => ['required' => true]
- ]);
-
- if (!empty($errors)) {
- $this->error('Validation failed:');
-
- foreach ($errors as $field => $error) {
- $this->println(" โข $error");
- }
-
- return 1;
- }
-
- // Check for duplicate email
- $users = $this->app->loadData('users');
-
- foreach ($users as $user) {
- if ($user['email'] === $email) {
- $this->error("User with email '$email' already exists.");
-
- return 1;
- }
- }
-
- // Create user
- $newUser = [
- 'id' => $this->generateUserId($users),
- 'name' => $name,
- 'email' => $email,
- 'status' => $status,
- 'created_at' => date('Y-m-d H:i:s'),
- 'updated_at' => date('Y-m-d H:i:s')
- ];
-
- $users[] = $newUser;
-
- if ($this->app->saveData('users', $users)) {
- $this->success("โ User created successfully!");
- $this->displayUserInfo($newUser);
-
- return 0;
- } else {
- $this->error("Failed to save user data.");
-
- return 1;
- }
- }
-
- /**
- * Create users in batch mode.
- */
- private function createUsersBatch(): int {
- $file = $this->getArgValue('--file');
-
- if (!$file) {
- $this->error('File path is required for batch operations.');
-
- return 1;
- }
-
- if (!file_exists($file)) {
- $this->error("File not found: $file");
-
- return 1;
- }
-
- $this->info("๐ฅ Processing batch file: $file");
-
- // Read and parse file (assuming CSV format)
- $content = file_get_contents($file);
- $lines = array_filter(array_map('trim', explode("\n", $content)));
-
- if (empty($lines)) {
- $this->error('File is empty or invalid.');
-
- return 1;
- }
-
- // Parse CSV
- $header = str_getcsv(array_shift($lines));
- $batchUsers = [];
-
- foreach ($lines as $line) {
- $data = str_getcsv($line);
-
- if (count($data) === count($header)) {
- $batchUsers[] = array_combine($header, $data);
- }
- }
-
- if (empty($batchUsers)) {
- $this->error('No valid user data found in file.');
-
- return 1;
- }
-
- $this->info("Found ".count($batchUsers)." users to create");
-
- $users = $this->app->loadData('users');
- $created = 0;
- $errors = 0;
-
- $this->withProgressBar($batchUsers, function ($userData) use (&$users, &$created, &$errors) {
- // Validate user data
- $validationErrors = $this->app->validateData($userData, [
- 'name' => ['required' => true, 'min_length' => 2],
- 'email' => ['required' => true, 'email' => true]
- ]);
-
- if (!empty($validationErrors)) {
- $errors++;
-
- return;
- }
-
- // Check for duplicate email
- foreach ($users as $user) {
- if ($user['email'] === $userData['email']) {
- $errors++;
-
- return;
- }
- }
-
- // Create user
- $newUser = [
- 'id' => $this->generateUserId($users),
- 'name' => $userData['name'],
- 'email' => $userData['email'],
- 'status' => $userData['status'] ?? 'active',
- 'created_at' => date('Y-m-d H:i:s'),
- 'updated_at' => date('Y-m-d H:i:s')
- ];
-
- $users[] = $newUser;
- $created++;
- }, 'Creating users...');
-
- if ($this->app->saveData('users', $users)) {
- $this->success("โ Batch operation completed!");
- $this->info("๐ Summary:");
- $this->println(" โข Created: $created users");
-
- if ($errors > 0) {
- $this->println(" โข Errors: $errors users");
- }
-
- return 0;
- } else {
- $this->error("Failed to save user data.");
-
- return 1;
- }
- }
-
- /**
- * Delete a user.
- */
- private function deleteUser(): int {
- $id = (int)$this->getArgValue('--id');
-
- if (!$id) {
- $this->error('User ID is required for delete operation.');
-
- return 1;
- }
-
- $users = $this->app->loadData('users');
- $userIndex = $this->findUserIndex($users, $id);
-
- if ($userIndex === -1) {
- $this->error("User with ID $id not found.");
-
- return 1;
- }
-
- $user = $users[$userIndex];
- $this->warning("โ ๏ธ You are about to delete user: {$user['name']} ({$user['email']})");
-
- if (!$this->confirm('Are you sure you want to delete this user?', false)) {
- $this->info('Delete operation cancelled.');
-
- return 0;
- }
-
- array_splice($users, $userIndex, 1);
-
- if ($this->app->saveData('users', $users)) {
- $this->success("โ User deleted successfully!");
-
- return 0;
- } else {
- $this->error("Failed to save user data.");
-
- return 1;
- }
- }
-
- /**
- * Display individual user information.
- */
- private function displayUserInfo(array $user): void {
- $this->println();
- $this->info("๐ค User Information:");
- $this->println(" โข ID: {$user['id']}");
- $this->println(" โข Name: {$user['name']}");
- $this->println(" โข Email: {$user['email']}");
- $this->println(" โข Status: ".ucfirst($user['status']));
- $this->println(" โข Created: {$user['created_at']}");
- $this->println(" โข Updated: {$user['updated_at']}");
- }
-
- /**
- * Export users to file.
- */
- private function exportUsers(): int {
- $format = $this->getArgValue('--format') ?? 'json';
- $file = $this->getArgValue('--file');
-
- $users = $this->app->loadData('users');
-
- if (empty($users)) {
- $this->warning('No users to export.');
-
- return 0;
- }
-
- if (!$file) {
- $timestamp = date('Y-m-d_H-i-s');
- $file = "users_export_{$timestamp}.{$format}";
- }
-
- $this->info("๐ค Exporting ".count($users)." users to $file");
-
- // Show progress for large exports
- if (count($users) > 10) {
- $this->withProgressBar($users, function ($user) {
- usleep(10000); // Simulate processing time
- }, 'Preparing export...');
- }
-
- $content = $this->app->formatData($users, $format);
-
- if (file_put_contents($file, $content) !== false) {
- $this->success("โ Export completed successfully!");
- $this->info("๐ Export Summary:");
- $this->println(" โข Format: ".strtoupper($format));
- $this->println(" โข Records: ".count($users));
- $this->println(" โข File Size: ".$this->formatBytes(strlen($content)));
- $this->println(" โข Location: $file");
-
- return 0;
- } else {
- $this->error("Failed to write export file: $file");
-
- return 1;
- }
- }
-
- /**
- * Find user index by ID.
- */
- private function findUserIndex(array $users, int $id): int {
- foreach ($users as $index => $user) {
- if ($user['id'] == $id) {
- return $index;
- }
- }
-
- return -1;
- }
-
- /**
- * Format bytes to human readable format.
- */
- private function formatBytes(int $bytes): string {
- $units = ['B', 'KB', 'MB', 'GB'];
- $unitIndex = 0;
-
- while ($bytes >= 1024 && $unitIndex < count($units) - 1) {
- $bytes /= 1024;
- $unitIndex++;
- }
-
- return sprintf('%.1f %s', $bytes, $units[$unitIndex]);
- }
-
- /**
- * Generate unique user ID.
- */
- private function generateUserId(array $users): int {
- if (empty($users)) {
- return 1;
- }
-
- $maxId = max(array_column($users, 'id'));
-
- return $maxId + 1;
- }
-
- /**
- * List all users.
- */
- private function listUsers(): int {
- $users = $this->app->loadData('users');
- $format = $this->getArgValue('--format') ?? 'table';
- $limit = (int)($this->getArgValue('--limit') ?? 50);
-
- if (empty($users)) {
- $this->warning('No users found.');
-
- return 0;
- }
-
- // Apply limit
- $users = array_slice($users, 0, $limit);
-
- $this->info("๐ฅ User Management - List Users");
- $this->println();
-
- if ($format === 'table') {
- $this->table($users);
- } else {
- $output = $this->app->formatData($users, $format);
- $this->println($output);
- }
-
- $this->showUserStats($users);
-
- return 0;
- }
-
- /**
- * Search users.
- */
- private function searchUsers(): int {
- $searchTerm = $this->getArgValue('--search');
- $format = $this->getArgValue('--format') ?? 'table';
-
- if (!$searchTerm) {
- $searchTerm = $this->getInput('Enter search term: ');
- }
-
- $users = $this->app->loadData('users');
- $filteredUsers = array_filter($users, function ($user) use ($searchTerm) {
- return stripos($user['name'], $searchTerm) !== false ||
- stripos($user['email'], $searchTerm) !== false ||
- stripos($user['status'], $searchTerm) !== false;
- });
-
- $this->info("๐ Search Results for: '$searchTerm'");
- $this->println();
-
- if (empty($filteredUsers)) {
- $this->warning('No users found matching the search criteria.');
-
- return 0;
- }
-
- if ($format === 'table') {
- $this->table($filteredUsers);
- } else {
- $output = $this->app->formatData(array_values($filteredUsers), $format);
- $this->println($output);
- }
-
- $this->info("Found ".count($filteredUsers)." user(s) matching '$searchTerm'");
-
- return 0;
- }
-
- /**
- * Show command usage.
- */
- private function showUsage(): int {
- $this->info('User Management Command Usage:');
- $this->println();
- $this->println('Examples:');
- $this->println(' php main.php user --action=list');
- $this->println(' php main.php user --action=create --name="Ahmed Hassan" --email="ahmed.hassan@example.com"');
- $this->println(' php main.php user --action=update --id=1 --name="Sarah Johnson"');
- $this->println(' php main.php user --action=delete --id=1');
- $this->println(' php main.php user --action=search --search="ahmed"');
- $this->println(' php main.php user --action=export --format=json');
-
- return 0;
- }
-
- /**
- * Display user statistics.
- */
- private function showUserStats(array $users): void {
- $total = count($users);
- $active = count(array_filter($users, fn($u) => $u['status'] === 'active'));
- $inactive = $total - $active;
-
- $this->println();
- $this->info("๐ Total: $total users | Active: $active | Inactive: $inactive");
- }
-
- /**
- * Update an existing user.
- */
- private function updateUser(): int {
- $id = (int)$this->getArgValue('--id');
-
- if (!$id) {
- $this->error('User ID is required for update operation.');
-
- return 1;
- }
-
- $users = $this->app->loadData('users');
- $userIndex = $this->findUserIndex($users, $id);
-
- if ($userIndex === -1) {
- $this->error("User with ID $id not found.");
-
- return 1;
- }
-
- $user = $users[$userIndex];
- $this->info("Updating user: {$user['name']} ({$user['email']})");
-
- // Update fields if provided
- $name = $this->getArgValue('--name');
- $email = $this->getArgValue('--email');
- $status = $this->getArgValue('--status');
-
- if ($name) {
- $user['name'] = $name;
- }
-
- if ($email) {
- $user['email'] = $email;
- }
-
- if ($status) {
- $user['status'] = $status;
- }
-
- $user['updated_at'] = date('Y-m-d H:i:s');
-
- // Validate updated data
- $errors = $this->app->validateData($user, [
- 'name' => ['required' => true, 'min_length' => 2, 'max_length' => 100],
- 'email' => ['required' => true, 'email' => true],
- 'status' => ['required' => true]
- ]);
-
- if (!empty($errors)) {
- $this->error('Validation failed:');
-
- foreach ($errors as $field => $error) {
- $this->println(" โข $error");
- }
-
- return 1;
- }
-
- // Check for duplicate email (excluding current user)
- foreach ($users as $index => $existingUser) {
- if ($index !== $userIndex && $existingUser['email'] === $user['email']) {
- $this->error("Another user with email '{$user['email']}' already exists.");
-
- return 1;
- }
- }
-
- $users[$userIndex] = $user;
-
- if ($this->app->saveData('users', $users)) {
- $this->success("โ User updated successfully!");
- $this->displayUserInfo($user);
-
- return 0;
- } else {
- $this->error("Failed to save user data.");
-
- return 1;
- }
- }
-}
+ [
+ ArgumentOption::DESCRIPTION => 'Action to perform',
+ ArgumentOption::OPTIONAL => false,
+ ArgumentOption::VALUES => ['list', 'create', 'update', 'delete', 'search', 'export']
+ ],
+ '--id' => [
+ ArgumentOption::DESCRIPTION => 'User ID for update/delete operations',
+ ArgumentOption::OPTIONAL => true
+ ],
+ '--name' => [
+ ArgumentOption::DESCRIPTION => 'User full name',
+ ArgumentOption::OPTIONAL => true
+ ],
+ '--email' => [
+ ArgumentOption::DESCRIPTION => 'User email address',
+ ArgumentOption::OPTIONAL => true
+ ],
+ '--status' => [
+ ArgumentOption::DESCRIPTION => 'User status',
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::VALUES => ['active', 'inactive']
+ ],
+ '--format' => [
+ ArgumentOption::DESCRIPTION => 'Output format',
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DEFAULT => 'table',
+ ArgumentOption::VALUES => ['table', 'json', 'csv', 'xml']
+ ],
+ '--search' => [
+ ArgumentOption::DESCRIPTION => 'Search term for filtering users',
+ ArgumentOption::OPTIONAL => true
+ ],
+ '--limit' => [
+ ArgumentOption::DESCRIPTION => 'Maximum number of results',
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DEFAULT => '50'
+ ],
+ '--batch' => [
+ ArgumentOption::DESCRIPTION => 'Enable batch mode for bulk operations',
+ ArgumentOption::OPTIONAL => true
+ ],
+ '--file' => [
+ ArgumentOption::DESCRIPTION => 'File path for batch operations or export',
+ ArgumentOption::OPTIONAL => true
+ ]
+ ], 'User management operations (list, create, update, delete, search, export)');
+
+ $this->app = new AppManager();
+ }
+
+ public function exec(): int {
+ $action = $this->getArgValue('--action');
+
+ try {
+ return match ($action) {
+ 'list' => $this->listUsers(),
+ 'create' => $this->createUser(),
+ 'update' => $this->updateUser(),
+ 'delete' => $this->deleteUser(),
+ 'search' => $this->searchUsers(),
+ 'export' => $this->exportUsers(),
+ default => $this->showUsage()
+ };
+ } catch (Exception $e) {
+ $this->error("Operation failed: ".$e->getMessage());
+ $this->app->log('error', "User command failed: ".$e->getMessage());
+
+ return 1;
+ }
+ }
+
+ /**
+ * Create a new user.
+ */
+ private function createUser(): int {
+ if ($this->isArgProvided('--batch')) {
+ return $this->createUsersBatch();
+ }
+
+ $name = $this->getArgValue('--name');
+ $email = $this->getArgValue('--email');
+ $status = $this->getArgValue('--status') ?? 'active';
+
+ // Interactive input if not provided
+ if (!$name) {
+ $name = $this->getInput('Enter user name: ');
+ }
+
+ if (!$email) {
+ $email = $this->getInput('Enter user email: ');
+ }
+
+ // Validate input
+ $errors = $this->app->validateData([
+ 'name' => $name,
+ 'email' => $email,
+ 'status' => $status
+ ], [
+ 'name' => ['required' => true, 'min_length' => 2, 'max_length' => 100],
+ 'email' => ['required' => true, 'email' => true],
+ 'status' => ['required' => true]
+ ]);
+
+ if (!empty($errors)) {
+ $this->error('Validation failed:');
+
+ foreach ($errors as $field => $error) {
+ $this->println(" โข $error");
+ }
+
+ return 1;
+ }
+
+ // Check for duplicate email
+ $users = $this->app->loadData('users');
+
+ foreach ($users as $user) {
+ if ($user['email'] === $email) {
+ $this->error("User with email '$email' already exists.");
+
+ return 1;
+ }
+ }
+
+ // Create user
+ $newUser = [
+ 'id' => $this->generateUserId($users),
+ 'name' => $name,
+ 'email' => $email,
+ 'status' => $status,
+ 'created_at' => date('Y-m-d H:i:s'),
+ 'updated_at' => date('Y-m-d H:i:s')
+ ];
+
+ $users[] = $newUser;
+
+ if ($this->app->saveData('users', $users)) {
+ $this->success("โ User created successfully!");
+ $this->displayUserInfo($newUser);
+
+ return 0;
+ } else {
+ $this->error("Failed to save user data.");
+
+ return 1;
+ }
+ }
+
+ /**
+ * Create users in batch mode.
+ */
+ private function createUsersBatch(): int {
+ $file = $this->getArgValue('--file');
+
+ if (!$file) {
+ $this->error('File path is required for batch operations.');
+
+ return 1;
+ }
+
+ if (!file_exists($file)) {
+ $this->error("File not found: $file");
+
+ return 1;
+ }
+
+ $this->info("๐ฅ Processing batch file: $file");
+
+ // Read and parse file (assuming CSV format)
+ $content = file_get_contents($file);
+ $lines = array_filter(array_map('trim', explode("\n", $content)));
+
+ if (empty($lines)) {
+ $this->error('File is empty or invalid.');
+
+ return 1;
+ }
+
+ // Parse CSV
+ $header = str_getcsv(array_shift($lines));
+ $batchUsers = [];
+
+ foreach ($lines as $line) {
+ $data = str_getcsv($line);
+
+ if (count($data) === count($header)) {
+ $batchUsers[] = array_combine($header, $data);
+ }
+ }
+
+ if (empty($batchUsers)) {
+ $this->error('No valid user data found in file.');
+
+ return 1;
+ }
+
+ $this->info("Found ".count($batchUsers)." users to create");
+
+ $users = $this->app->loadData('users');
+ $created = 0;
+ $errors = 0;
+
+ $this->withProgressBar($batchUsers, function ($userData) use (&$users, &$created, &$errors) {
+ // Validate user data
+ $validationErrors = $this->app->validateData($userData, [
+ 'name' => ['required' => true, 'min_length' => 2],
+ 'email' => ['required' => true, 'email' => true]
+ ]);
+
+ if (!empty($validationErrors)) {
+ $errors++;
+
+ return;
+ }
+
+ // Check for duplicate email
+ foreach ($users as $user) {
+ if ($user['email'] === $userData['email']) {
+ $errors++;
+
+ return;
+ }
+ }
+
+ // Create user
+ $newUser = [
+ 'id' => $this->generateUserId($users),
+ 'name' => $userData['name'],
+ 'email' => $userData['email'],
+ 'status' => $userData['status'] ?? 'active',
+ 'created_at' => date('Y-m-d H:i:s'),
+ 'updated_at' => date('Y-m-d H:i:s')
+ ];
+
+ $users[] = $newUser;
+ $created++;
+ }, 'Creating users...');
+
+ if ($this->app->saveData('users', $users)) {
+ $this->success("โ Batch operation completed!");
+ $this->info("๐ Summary:");
+ $this->println(" โข Created: $created users");
+
+ if ($errors > 0) {
+ $this->println(" โข Errors: $errors users");
+ }
+
+ return 0;
+ } else {
+ $this->error("Failed to save user data.");
+
+ return 1;
+ }
+ }
+
+ /**
+ * Delete a user.
+ */
+ private function deleteUser(): int {
+ $id = (int)$this->getArgValue('--id');
+
+ if (!$id) {
+ $this->error('User ID is required for delete operation.');
+
+ return 1;
+ }
+
+ $users = $this->app->loadData('users');
+ $userIndex = $this->findUserIndex($users, $id);
+
+ if ($userIndex === -1) {
+ $this->error("User with ID $id not found.");
+
+ return 1;
+ }
+
+ $user = $users[$userIndex];
+ $this->warning("โ ๏ธ You are about to delete user: {$user['name']} ({$user['email']})");
+
+ if (!$this->confirm('Are you sure you want to delete this user?', false)) {
+ $this->info('Delete operation cancelled.');
+
+ return 0;
+ }
+
+ array_splice($users, $userIndex, 1);
+
+ if ($this->app->saveData('users', $users)) {
+ $this->success("โ User deleted successfully!");
+
+ return 0;
+ } else {
+ $this->error("Failed to save user data.");
+
+ return 1;
+ }
+ }
+
+ /**
+ * Display individual user information.
+ */
+ private function displayUserInfo(array $user): void {
+ $this->println();
+ $this->info("๐ค User Information:");
+ $this->println(" โข ID: {$user['id']}");
+ $this->println(" โข Name: {$user['name']}");
+ $this->println(" โข Email: {$user['email']}");
+ $this->println(" โข Status: ".ucfirst($user['status']));
+ $this->println(" โข Created: {$user['created_at']}");
+ $this->println(" โข Updated: {$user['updated_at']}");
+ }
+
+ /**
+ * Export users to file.
+ */
+ private function exportUsers(): int {
+ $format = $this->getArgValue('--format') ?? 'json';
+ $file = $this->getArgValue('--file');
+
+ $users = $this->app->loadData('users');
+
+ if (empty($users)) {
+ $this->warning('No users to export.');
+
+ return 0;
+ }
+
+ if (!$file) {
+ $timestamp = date('Y-m-d_H-i-s');
+ $file = "users_export_{$timestamp}.{$format}";
+ }
+
+ $this->info("๐ค Exporting ".count($users)." users to $file");
+
+ // Show progress for large exports
+ if (count($users) > 10) {
+ $this->withProgressBar($users, function ($user) {
+ usleep(10000); // Simulate processing time
+ }, 'Preparing export...');
+ }
+
+ $content = $this->app->formatData($users, $format);
+
+ if (file_put_contents($file, $content) !== false) {
+ $this->success("โ Export completed successfully!");
+ $this->info("๐ Export Summary:");
+ $this->println(" โข Format: ".strtoupper($format));
+ $this->println(" โข Records: ".count($users));
+ $this->println(" โข File Size: ".$this->formatBytes(strlen($content)));
+ $this->println(" โข Location: $file");
+
+ return 0;
+ } else {
+ $this->error("Failed to write export file: $file");
+
+ return 1;
+ }
+ }
+
+ /**
+ * Find user index by ID.
+ */
+ private function findUserIndex(array $users, int $id): int {
+ foreach ($users as $index => $user) {
+ if ($user['id'] == $id) {
+ return $index;
+ }
+ }
+
+ return -1;
+ }
+
+ /**
+ * Format bytes to human readable format.
+ */
+ private function formatBytes(int $bytes): string {
+ $units = ['B', 'KB', 'MB', 'GB'];
+ $unitIndex = 0;
+
+ while ($bytes >= 1024 && $unitIndex < count($units) - 1) {
+ $bytes /= 1024;
+ $unitIndex++;
+ }
+
+ return sprintf('%.1f %s', $bytes, $units[$unitIndex]);
+ }
+
+ /**
+ * Generate unique user ID.
+ */
+ private function generateUserId(array $users): int {
+ if (empty($users)) {
+ return 1;
+ }
+
+ $maxId = max(array_column($users, 'id'));
+
+ return $maxId + 1;
+ }
+
+ /**
+ * List all users.
+ */
+ private function listUsers(): int {
+ $users = $this->app->loadData('users');
+ $format = $this->getArgValue('--format') ?? 'table';
+ $limit = (int)($this->getArgValue('--limit') ?? 50);
+
+ if (empty($users)) {
+ $this->warning('No users found.');
+
+ return 0;
+ }
+
+ // Apply limit
+ $users = array_slice($users, 0, $limit);
+
+ $this->info("๐ฅ User Management - List Users");
+ $this->println();
+
+ if ($format === 'table') {
+ $this->table($users);
+ } else {
+ $output = $this->app->formatData($users, $format);
+ $this->println($output);
+ }
+
+ $this->showUserStats($users);
+
+ return 0;
+ }
+
+ /**
+ * Search users.
+ */
+ private function searchUsers(): int {
+ $searchTerm = $this->getArgValue('--search');
+ $format = $this->getArgValue('--format') ?? 'table';
+
+ if (!$searchTerm) {
+ $searchTerm = $this->getInput('Enter search term: ');
+ }
+
+ $users = $this->app->loadData('users');
+ $filteredUsers = array_filter($users, function ($user) use ($searchTerm) {
+ return stripos($user['name'], $searchTerm) !== false ||
+ stripos($user['email'], $searchTerm) !== false ||
+ stripos($user['status'], $searchTerm) !== false;
+ });
+
+ $this->info("๐ Search Results for: '$searchTerm'");
+ $this->println();
+
+ if (empty($filteredUsers)) {
+ $this->warning('No users found matching the search criteria.');
+
+ return 0;
+ }
+
+ if ($format === 'table') {
+ $this->table($filteredUsers);
+ } else {
+ $output = $this->app->formatData(array_values($filteredUsers), $format);
+ $this->println($output);
+ }
+
+ $this->info("Found ".count($filteredUsers)." user(s) matching '$searchTerm'");
+
+ return 0;
+ }
+
+ /**
+ * Show command usage.
+ */
+ private function showUsage(): int {
+ $this->info('User Management Command Usage:');
+ $this->println();
+ $this->println('Examples:');
+ $this->println(' php main.php user --action=list');
+ $this->println(' php main.php user --action=create --name="Ahmed Hassan" --email="ahmed.hassan@example.com"');
+ $this->println(' php main.php user --action=update --id=1 --name="Sarah Johnson"');
+ $this->println(' php main.php user --action=delete --id=1');
+ $this->println(' php main.php user --action=search --search="ahmed"');
+ $this->println(' php main.php user --action=export --format=json');
+
+ return 0;
+ }
+
+ /**
+ * Display user statistics.
+ */
+ private function showUserStats(array $users): void {
+ $total = count($users);
+ $active = count(array_filter($users, fn($u) => $u['status'] === 'active'));
+ $inactive = $total - $active;
+
+ $this->println();
+ $this->info("๐ Total: $total users | Active: $active | Inactive: $inactive");
+ }
+
+ /**
+ * Update an existing user.
+ */
+ private function updateUser(): int {
+ $id = (int)$this->getArgValue('--id');
+
+ if (!$id) {
+ $this->error('User ID is required for update operation.');
+
+ return 1;
+ }
+
+ $users = $this->app->loadData('users');
+ $userIndex = $this->findUserIndex($users, $id);
+
+ if ($userIndex === -1) {
+ $this->error("User with ID $id not found.");
+
+ return 1;
+ }
+
+ $user = $users[$userIndex];
+ $this->info("Updating user: {$user['name']} ({$user['email']})");
+
+ // Update fields if provided
+ $name = $this->getArgValue('--name');
+ $email = $this->getArgValue('--email');
+ $status = $this->getArgValue('--status');
+
+ if ($name) {
+ $user['name'] = $name;
+ }
+
+ if ($email) {
+ $user['email'] = $email;
+ }
+
+ if ($status) {
+ $user['status'] = $status;
+ }
+
+ $user['updated_at'] = date('Y-m-d H:i:s');
+
+ // Validate updated data
+ $errors = $this->app->validateData($user, [
+ 'name' => ['required' => true, 'min_length' => 2, 'max_length' => 100],
+ 'email' => ['required' => true, 'email' => true],
+ 'status' => ['required' => true]
+ ]);
+
+ if (!empty($errors)) {
+ $this->error('Validation failed:');
+
+ foreach ($errors as $field => $error) {
+ $this->println(" โข $error");
+ }
+
+ return 1;
+ }
+
+ // Check for duplicate email (excluding current user)
+ foreach ($users as $index => $existingUser) {
+ if ($index !== $userIndex && $existingUser['email'] === $user['email']) {
+ $this->error("Another user with email '{$user['email']}' already exists.");
+
+ return 1;
+ }
+ }
+
+ $users[$userIndex] = $user;
+
+ if ($this->app->saveData('users', $users)) {
+ $this->success("โ User updated successfully!");
+ $this->displayUserInfo($user);
+
+ return 0;
+ } else {
+ $this->error("Failed to save user data.");
+
+ return 1;
+ }
+ }
+}
diff --git a/examples/10-multi-command-app/config/app.json b/examples/10-multi-command-app/config/app.json
index 39f7af3..6e30176 100644
--- a/examples/10-multi-command-app/config/app.json
+++ b/examples/10-multi-command-app/config/app.json
@@ -1,21 +1,21 @@
-{
- "app": {
- "name": "Multi-Command CLI App",
- "version": "1.0.0",
- "environment": "development",
- "debug": true,
- "timezone": "UTC"
- },
- "logging": {
- "level": "info",
- "file_enabled": true,
- "max_file_size": "10MB",
- "retention_days": 30
- },
- "features": {
- "auto_backup": true,
- "backup_interval": "daily",
- "max_backups": 7,
- "compression": true
- }
-}
+{
+ "app": {
+ "name": "Multi-Command CLI App",
+ "version": "1.0.0",
+ "environment": "development",
+ "debug": true,
+ "timezone": "UTC"
+ },
+ "logging": {
+ "level": "info",
+ "file_enabled": true,
+ "max_file_size": "10MB",
+ "retention_days": 30
+ },
+ "features": {
+ "auto_backup": true,
+ "backup_interval": "daily",
+ "max_backups": 7,
+ "compression": true
+ }
+}
diff --git a/examples/10-multi-command-app/config/database.json b/examples/10-multi-command-app/config/database.json
index 1b6677b..fb26a7b 100644
--- a/examples/10-multi-command-app/config/database.json
+++ b/examples/10-multi-command-app/config/database.json
@@ -1,12 +1,12 @@
-{
- "database": {
- "type": "json",
- "path": "./data",
- "backup_enabled": true,
- "auto_migrate": true,
- "validation": {
- "strict_mode": true,
- "required_fields": ["id", "created_at", "updated_at"]
- }
- }
-}
+{
+ "database": {
+ "type": "json",
+ "path": "./data",
+ "backup_enabled": true,
+ "auto_migrate": true,
+ "validation": {
+ "strict_mode": true,
+ "required_fields": ["id", "created_at", "updated_at"]
+ }
+ }
+}
diff --git a/examples/10-multi-command-app/data/users.json b/examples/10-multi-command-app/data/users.json
index 12ec73c..7c32d67 100644
--- a/examples/10-multi-command-app/data/users.json
+++ b/examples/10-multi-command-app/data/users.json
@@ -1,26 +1,26 @@
-[
- {
- "id": 1,
- "name": "Ahmed Hassan",
- "email": "ahmed.hassan@example.com",
- "status": "active",
- "created_at": "2024-01-15 10:30:00",
- "updated_at": "2024-01-15 10:30:00"
- },
- {
- "id": 2,
- "name": "Sarah Johnson",
- "email": "sarah.johnson@example.com",
- "status": "active",
- "created_at": "2024-01-16 14:20:00",
- "updated_at": "2024-01-16 14:20:00"
- },
- {
- "id": 3,
- "name": "Omar Al-Rashid",
- "email": "omar.alrashid@example.com",
- "status": "inactive",
- "created_at": "2024-01-17 09:15:00",
- "updated_at": "2024-01-17 09:15:00"
- }
+[
+ {
+ "id": 1,
+ "name": "Ahmed Hassan",
+ "email": "ahmed.hassan@example.com",
+ "status": "active",
+ "created_at": "2024-01-15 10:30:00",
+ "updated_at": "2024-01-15 10:30:00"
+ },
+ {
+ "id": 2,
+ "name": "Sarah Johnson",
+ "email": "sarah.johnson@example.com",
+ "status": "active",
+ "created_at": "2024-01-16 14:20:00",
+ "updated_at": "2024-01-16 14:20:00"
+ },
+ {
+ "id": 3,
+ "name": "Omar Al-Rashid",
+ "email": "omar.alrashid@example.com",
+ "status": "inactive",
+ "created_at": "2024-01-17 09:15:00",
+ "updated_at": "2024-01-17 09:15:00"
+ }
]
\ No newline at end of file
diff --git a/examples/10-multi-command-app/main.php b/examples/10-multi-command-app/main.php
index 5568db9..52285c7 100644
--- a/examples/10-multi-command-app/main.php
+++ b/examples/10-multi-command-app/main.php
@@ -1,43 +1,43 @@
-register(new UserCommand());
-
-// Set default command
-
-// Initialize application
-$app = new AppManager();
-$app->log('info', 'Application started');
-
-// Start the application
-$exitCode = $runner->start();
-
-// Log application shutdown
-$app->log('info', "Application finished with exit code: $exitCode");
-
-exit($exitCode);
+register(new UserCommand());
+
+// Set default command
+
+// Initialize application
+$app = new AppManager();
+$app->log('info', 'Application started');
+
+// Start the application
+$exitCode = $runner->start();
+
+// Log application shutdown
+$app->log('info', "Application finished with exit code: $exitCode");
+
+exit($exitCode);
diff --git a/examples/11-masked-input/README.md b/examples/11-masked-input/README.md
index 92bf0cb..ef30b1c 100644
--- a/examples/11-masked-input/README.md
+++ b/examples/11-masked-input/README.md
@@ -1,187 +1,187 @@
-# Masked Input Example
-
-This example demonstrates the **masked input functionality** in WebFiori CLI, which allows secure entry of sensitive data like passwords, PINs, and tokens.
-
-## Features Demonstrated
-
-- **Basic Password Input**: Default asterisk (*) masking with validation
-- **Custom Mask Characters**: Use different characters (โข, #, X, -) for masking
-- **Input Validation**: Enforce security requirements and format validation
-- **Default Values**: Optional default values for sensitive fields
-- **Confirmation Prompts**: Verify critical inputs by asking twice
-
-## Running the Example
-
-### Basic Usage
-```bash
-php main.php secure-input
-```
-
-### Run Specific Demos
-```bash
-# Password demo only
-php main.php secure-input --demo=password
-
-# PIN demo with custom mask
-php main.php secure-input --demo=pin
-
-# Token demo with default value
-php main.php secure-input --demo=token
-
-# All demos (default)
-php main.php secure-input --demo=all
-```
-
-## Code Examples
-
-### Basic Masked Input
-```php
-// Simple password input with default * masking
-$password = $this->getMaskedInput('Enter password: ');
-```
-
-### Custom Mask Character
-```php
-// Use # characters for PIN masking
-$pin = $this->getMaskedInput('Enter PIN: ', null, null, '#');
-```
-
-### With Validation
-```php
-$validator = new InputValidator(function($password) {
- return strlen($password) >= 8 &&
- preg_match('/[A-Z]/', $password) &&
- preg_match('/[0-9]/', $password);
-}, 'Password must be 8+ chars with uppercase and number!');
-
-$password = $this->getMaskedInput('Password: ', null, $validator);
-```
-
-### With Default Value
-```php
-// Provide a default token value
-$token = $this->getMaskedInput('API Token: ', 'default-token', null, 'โข');
-```
-
-## Method Signature
-
-```php
-public function getMaskedInput(
- string $prompt, // The prompt to display
- ?string $default = null, // Optional default value
- ?InputValidator $validator = null, // Optional input validator
- string $mask = '*' // Mask character (default: *)
-): ?string
-```
-
-## Security Features
-
-### Input Masking
-- Characters are masked as you type
-- Only mask characters are displayed in terminal
-- Actual input is captured securely
-- Supports backspace for corrections
-
-### Validation Support
-- Enforce minimum length requirements
-- Validate character patterns (uppercase, numbers, symbols)
-- Custom validation logic
-- Automatic retry on validation failure
-
-### Safe Handling
-- Input is trimmed automatically
-- Empty prompts return null safely
-- Works with existing stream abstraction
-- Compatible with testing framework
-
-## Use Cases
-
-### 1. User Authentication
-```php
-$password = $this->getMaskedInput('Login Password: ');
-$confirmPassword = $this->getMaskedInput('Confirm Password: ');
-
-if ($password !== $confirmPassword) {
- $this->error('Passwords do not match!');
- return 1;
-}
-```
-
-### 2. API Configuration
-```php
-$apiKey = $this->getMaskedInput('API Key: ', null, null, 'โข');
-$secret = $this->getMaskedInput('API Secret: ', null, null, '-');
-```
-
-### 3. Database Setup
-```php
-$dbPassword = $this->getMaskedInput('Database Password: ');
-
-$validator = new InputValidator(function($host) {
- return filter_var($host, FILTER_VALIDATE_IP) ||
- filter_var($host, FILTER_VALIDATE_DOMAIN);
-}, 'Invalid host format!');
-
-$dbHost = $this->getInput('Database Host: ', 'localhost', $validator);
-```
-
-### 4. Secure Token Entry
-```php
-$jwtSecret = $this->getMaskedInput('JWT Secret: ', null,
- new InputValidator(function($secret) {
- return strlen($secret) >= 32;
- }, 'JWT secret must be at least 32 characters!')
-);
-```
-
-## Interactive Demo Features
-
-The example includes several interactive demonstrations:
-
-1. **Password Demo**: Shows validation with security requirements
-2. **PIN Demo**: Demonstrates custom mask characters (#)
-3. **Token Demo**: Shows default values with bullet (โข) masking
-4. **Advanced Demo**: Multiple scenarios including confirmation prompts
-
-## Testing
-
-The masked input functionality is fully testable using the existing `CommandTestCase` framework:
-
-```php
-$output = $this->executeSingleCommand($command, [], ['secret123']);
-$this->assertContains('Password received: secret123', $output);
-```
-
-## Best Practices
-
-1. **Always validate sensitive input** for security requirements
-2. **Use appropriate mask characters** for different data types
-3. **Implement confirmation prompts** for critical operations
-4. **Never log or display** the actual sensitive values
-5. **Provide clear error messages** for validation failures
-
----
-
-**Ready to secure your CLI applications?** Try the different demo modes to see masked input in action!
-## Related Examples
-
-### Prerequisites
-- **[01-basic-hello-world](../01-basic-hello-world/)** - Basic command structure
-- **[03-user-input](../03-user-input/)** - User input fundamentals
-
-### Enhanced Input Methods
-- **[02-arguments-and-options](../02-arguments-and-options/)** - Command arguments with validation
-- **[05-interactive-commands](../05-interactive-commands/)** - Interactive menus and workflows
-
-### Visual Enhancement
-- **[04-output-formatting](../04-output-formatting/)** - Colors and formatting for prompts
-- **[06-table-display](../06-table-display/)** - Display collected data in tables
-- **[07-progress-bars](../07-progress-bars/)** - Progress indicators for data processing
-
-### Complete Applications
-- **[10-multi-command-app](../10-multi-command-app/)** - Full applications with secure authentication
-- **[09-database-ops](../09-database-ops/)** - Database operations with secure credentials
-- **[08-file-processing](../08-file-processing/)** - File operations with secure paths
-
-### Development Tools
-- **[12-command-scaffolding](../12-command-scaffolding/)** - Generate commands with masked input
+# Masked Input Example
+
+This example demonstrates the **masked input functionality** in WebFiori CLI, which allows secure entry of sensitive data like passwords, PINs, and tokens.
+
+## Features Demonstrated
+
+- **Basic Password Input**: Default asterisk (*) masking with validation
+- **Custom Mask Characters**: Use different characters (โข, #, X, -) for masking
+- **Input Validation**: Enforce security requirements and format validation
+- **Default Values**: Optional default values for sensitive fields
+- **Confirmation Prompts**: Verify critical inputs by asking twice
+
+## Running the Example
+
+### Basic Usage
+```bash
+php main.php secure-input
+```
+
+### Run Specific Demos
+```bash
+# Password demo only
+php main.php secure-input --demo=password
+
+# PIN demo with custom mask
+php main.php secure-input --demo=pin
+
+# Token demo with default value
+php main.php secure-input --demo=token
+
+# All demos (default)
+php main.php secure-input --demo=all
+```
+
+## Code Examples
+
+### Basic Masked Input
+```php
+// Simple password input with default * masking
+$password = $this->getMaskedInput('Enter password: ');
+```
+
+### Custom Mask Character
+```php
+// Use # characters for PIN masking
+$pin = $this->getMaskedInput('Enter PIN: ', null, null, '#');
+```
+
+### With Validation
+```php
+$validator = new InputValidator(function($password) {
+ return strlen($password) >= 8 &&
+ preg_match('/[A-Z]/', $password) &&
+ preg_match('/[0-9]/', $password);
+}, 'Password must be 8+ chars with uppercase and number!');
+
+$password = $this->getMaskedInput('Password: ', null, $validator);
+```
+
+### With Default Value
+```php
+// Provide a default token value
+$token = $this->getMaskedInput('API Token: ', 'default-token', null, 'โข');
+```
+
+## Method Signature
+
+```php
+public function getMaskedInput(
+ string $prompt, // The prompt to display
+ ?string $default = null, // Optional default value
+ ?InputValidator $validator = null, // Optional input validator
+ string $mask = '*' // Mask character (default: *)
+): ?string
+```
+
+## Security Features
+
+### Input Masking
+- Characters are masked as you type
+- Only mask characters are displayed in terminal
+- Actual input is captured securely
+- Supports backspace for corrections
+
+### Validation Support
+- Enforce minimum length requirements
+- Validate character patterns (uppercase, numbers, symbols)
+- Custom validation logic
+- Automatic retry on validation failure
+
+### Safe Handling
+- Input is trimmed automatically
+- Empty prompts return null safely
+- Works with existing stream abstraction
+- Compatible with testing framework
+
+## Use Cases
+
+### 1. User Authentication
+```php
+$password = $this->getMaskedInput('Login Password: ');
+$confirmPassword = $this->getMaskedInput('Confirm Password: ');
+
+if ($password !== $confirmPassword) {
+ $this->error('Passwords do not match!');
+ return 1;
+}
+```
+
+### 2. API Configuration
+```php
+$apiKey = $this->getMaskedInput('API Key: ', null, null, 'โข');
+$secret = $this->getMaskedInput('API Secret: ', null, null, '-');
+```
+
+### 3. Database Setup
+```php
+$dbPassword = $this->getMaskedInput('Database Password: ');
+
+$validator = new InputValidator(function($host) {
+ return filter_var($host, FILTER_VALIDATE_IP) ||
+ filter_var($host, FILTER_VALIDATE_DOMAIN);
+}, 'Invalid host format!');
+
+$dbHost = $this->getInput('Database Host: ', 'localhost', $validator);
+```
+
+### 4. Secure Token Entry
+```php
+$jwtSecret = $this->getMaskedInput('JWT Secret: ', null,
+ new InputValidator(function($secret) {
+ return strlen($secret) >= 32;
+ }, 'JWT secret must be at least 32 characters!')
+);
+```
+
+## Interactive Demo Features
+
+The example includes several interactive demonstrations:
+
+1. **Password Demo**: Shows validation with security requirements
+2. **PIN Demo**: Demonstrates custom mask characters (#)
+3. **Token Demo**: Shows default values with bullet (โข) masking
+4. **Advanced Demo**: Multiple scenarios including confirmation prompts
+
+## Testing
+
+The masked input functionality is fully testable using the existing `CommandTestCase` framework:
+
+```php
+$output = $this->executeSingleCommand($command, [], ['secret123']);
+$this->assertContains('Password received: secret123', $output);
+```
+
+## Best Practices
+
+1. **Always validate sensitive input** for security requirements
+2. **Use appropriate mask characters** for different data types
+3. **Implement confirmation prompts** for critical operations
+4. **Never log or display** the actual sensitive values
+5. **Provide clear error messages** for validation failures
+
+---
+
+**Ready to secure your CLI applications?** Try the different demo modes to see masked input in action!
+## Related Examples
+
+### Prerequisites
+- **[01-basic-hello-world](../01-basic-hello-world/)** - Basic command structure
+- **[03-user-input](../03-user-input/)** - User input fundamentals
+
+### Enhanced Input Methods
+- **[02-arguments-and-options](../02-arguments-and-options/)** - Command arguments with validation
+- **[05-interactive-commands](../05-interactive-commands/)** - Interactive menus and workflows
+
+### Visual Enhancement
+- **[04-output-formatting](../04-output-formatting/)** - Colors and formatting for prompts
+- **[06-table-display](../06-table-display/)** - Display collected data in tables
+- **[07-progress-bars](../07-progress-bars/)** - Progress indicators for data processing
+
+### Complete Applications
+- **[10-multi-command-app](../10-multi-command-app/)** - Full applications with secure authentication
+- **[09-database-ops](../09-database-ops/)** - Database operations with secure credentials
+- **[08-file-processing](../08-file-processing/)** - File operations with secure paths
+
+### Development Tools
+- **[12-command-scaffolding](../12-command-scaffolding/)** - Generate commands with masked input
diff --git a/examples/11-masked-input/SecureInputCommand.php b/examples/11-masked-input/SecureInputCommand.php
index b6b6fdb..2be1ef7 100644
--- a/examples/11-masked-input/SecureInputCommand.php
+++ b/examples/11-masked-input/SecureInputCommand.php
@@ -1,143 +1,143 @@
- [
- ArgumentOption::DESCRIPTION => 'Type of demo to run',
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::VALUES => ['password', 'pin', 'token', 'all'],
- ArgumentOption::DEFAULT => 'all'
- ]
- ], 'Demonstrates secure masked input functionality');
- }
-
- public function exec(): int {
- $demo = $this->getArgValue('--demo') ?? 'all';
-
- $this->println('๐ WebFiori CLI - Masked Input Demo');
- $this->println('===================================');
- $this->println();
-
- switch ($demo) {
- case 'password':
- $this->passwordDemo();
- break;
- case 'pin':
- $this->pinDemo();
- break;
- case 'token':
- $this->tokenDemo();
- break;
- case 'all':
- default:
- $this->passwordDemo();
- $this->println();
- $this->pinDemo();
- $this->println();
- $this->tokenDemo();
- $this->println();
- $this->advancedDemo();
- break;
- }
-
- $this->println();
- $this->success('โ Demo completed successfully!');
-
- return 0;
- }
-
- /**
- * Demonstrates basic password input with validation.
- */
- private function passwordDemo(): void {
- $this->info('๐ Password Demo - Basic masked input with validation');
- $this->println('Enter a password (minimum 8 characters):');
-
- $validator = new InputValidator(function($password) {
- if (strlen($password) < 8) {
- return false;
- }
- if (!preg_match('/[A-Z]/', $password)) {
- return false;
- }
- if (!preg_match('/[0-9]/', $password)) {
- return false;
- }
- return true;
- }, 'Password must be at least 8 characters with uppercase letter and number!');
-
- $password = $this->getMaskedInput('Password: ', '*', null, $validator);
-
- $this->success("โ Password accepted! Length: " . strlen($password));
- $this->println(" Captured value: $password");
- }
-
- /**
- * Demonstrates PIN input with custom mask character.
- */
- private function pinDemo(): void {
- $this->info('๐ข PIN Demo - Custom mask character');
- $this->println('Enter a 4-digit PIN (will be masked with # characters):');
-
- $validator = new InputValidator(function($pin) {
- return strlen($pin) === 4 && ctype_digit($pin);
- }, 'PIN must be exactly 4 digits!');
-
- $pin = $this->getMaskedInput('PIN: ', '#', null, $validator);
-
- $this->success("โ PIN accepted!");
- $this->println(" Captured value: $pin");
- }
-
- /**
- * Demonstrates token input with default value.
- */
- private function tokenDemo(): void {
- $this->info('๐ซ Token Demo - With default value');
- $this->println('Enter API token (or press Enter for demo token):');
-
- $token = $this->getMaskedInput('API Token: ', 'โข', 'demo-token-12345');
-
- $this->success("โ Token set!");
- $this->println(" Captured value: $token");
- }
-
- /**
- * Demonstrates advanced scenarios.
- */
- private function advancedDemo(): void {
- $this->info('๐ Advanced Demo - Multiple scenarios');
-
- // Database password with confirmation
- $this->println('Setting up database connection:');
-
- $dbPassword = $this->getMaskedInput('Database Password: ');
- $confirmPassword = $this->getMaskedInput('Confirm Password: ');
-
- if ($dbPassword !== $confirmPassword) {
- $this->error('โ Passwords do not match!');
- $this->println(" First: $dbPassword");
- $this->println(" Second: $confirmPassword");
- return;
- }
-
- $this->success('โ Database password confirmed');
- $this->println(" Captured value: $dbPassword");
- }
-}
+ [
+ ArgumentOption::DESCRIPTION => 'Type of demo to run',
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::VALUES => ['password', 'pin', 'token', 'all'],
+ ArgumentOption::DEFAULT => 'all'
+ ]
+ ], 'Demonstrates secure masked input functionality');
+ }
+
+ public function exec(): int {
+ $demo = $this->getArgValue('--demo') ?? 'all';
+
+ $this->println('๐ WebFiori CLI - Masked Input Demo');
+ $this->println('===================================');
+ $this->println();
+
+ switch ($demo) {
+ case 'password':
+ $this->passwordDemo();
+ break;
+ case 'pin':
+ $this->pinDemo();
+ break;
+ case 'token':
+ $this->tokenDemo();
+ break;
+ case 'all':
+ default:
+ $this->passwordDemo();
+ $this->println();
+ $this->pinDemo();
+ $this->println();
+ $this->tokenDemo();
+ $this->println();
+ $this->advancedDemo();
+ break;
+ }
+
+ $this->println();
+ $this->success('โ Demo completed successfully!');
+
+ return 0;
+ }
+
+ /**
+ * Demonstrates basic password input with validation.
+ */
+ private function passwordDemo(): void {
+ $this->info('๐ Password Demo - Basic masked input with validation');
+ $this->println('Enter a password (minimum 8 characters):');
+
+ $validator = new InputValidator(function($password) {
+ if (strlen($password) < 8) {
+ return false;
+ }
+ if (!preg_match('/[A-Z]/', $password)) {
+ return false;
+ }
+ if (!preg_match('/[0-9]/', $password)) {
+ return false;
+ }
+ return true;
+ }, 'Password must be at least 8 characters with uppercase letter and number!');
+
+ $password = $this->getMaskedInput('Password: ', '*', null, $validator);
+
+ $this->success("โ Password accepted! Length: " . strlen($password));
+ $this->println(" Captured value: $password");
+ }
+
+ /**
+ * Demonstrates PIN input with custom mask character.
+ */
+ private function pinDemo(): void {
+ $this->info('๐ข PIN Demo - Custom mask character');
+ $this->println('Enter a 4-digit PIN (will be masked with # characters):');
+
+ $validator = new InputValidator(function($pin) {
+ return strlen($pin) === 4 && ctype_digit($pin);
+ }, 'PIN must be exactly 4 digits!');
+
+ $pin = $this->getMaskedInput('PIN: ', '#', null, $validator);
+
+ $this->success("โ PIN accepted!");
+ $this->println(" Captured value: $pin");
+ }
+
+ /**
+ * Demonstrates token input with default value.
+ */
+ private function tokenDemo(): void {
+ $this->info('๐ซ Token Demo - With default value');
+ $this->println('Enter API token (or press Enter for demo token):');
+
+ $token = $this->getMaskedInput('API Token: ', 'โข', 'demo-token-12345');
+
+ $this->success("โ Token set!");
+ $this->println(" Captured value: $token");
+ }
+
+ /**
+ * Demonstrates advanced scenarios.
+ */
+ private function advancedDemo(): void {
+ $this->info('๐ Advanced Demo - Multiple scenarios');
+
+ // Database password with confirmation
+ $this->println('Setting up database connection:');
+
+ $dbPassword = $this->getMaskedInput('Database Password: ');
+ $confirmPassword = $this->getMaskedInput('Confirm Password: ');
+
+ if ($dbPassword !== $confirmPassword) {
+ $this->error('โ Passwords do not match!');
+ $this->println(" First: $dbPassword");
+ $this->println(" Second: $confirmPassword");
+ return;
+ }
+
+ $this->success('โ Database password confirmed');
+ $this->println(" Captured value: $dbPassword");
+ }
+}
diff --git a/examples/11-masked-input/main.php b/examples/11-masked-input/main.php
index 969d23c..729cad0 100644
--- a/examples/11-masked-input/main.php
+++ b/examples/11-masked-input/main.php
@@ -1,22 +1,22 @@
-register(new SecureInputCommand());
-
-// Start the application
-exit($runner->start());
+register(new SecureInputCommand());
+
+// Start the application
+exit($runner->start());
diff --git a/examples/12-command-scaffolding/README.md b/examples/12-command-scaffolding/README.md
index 09d94ca..966f934 100644
--- a/examples/12-command-scaffolding/README.md
+++ b/examples/12-command-scaffolding/README.md
@@ -1,302 +1,302 @@
-# Command Scaffolding Tools
-
-This example demonstrates the **command scaffolding functionality** in WebFiori CLI, which allows developers to quickly generate new command classes with proper structure, documentation, and templates.
-
-## Features
-
-- **Multiple Templates**: Basic, Interactive, CRUD, and File Processor templates
-- **Smart Naming**: Automatic class name generation from command names
-- **Namespace Support**: Generate commands with custom namespaces
-- **Argument Generation**: Automatically create command arguments
-- **Validation**: Input validation for command and class names
-- **Overwrite Protection**: Confirmation prompts for existing files
-
-## Running the Example
-
-### Basic Command Generation
-```bash
-# Generate a basic command
-php main.php make:command --name=hello-world
-
-# Generate with custom class name
-php main.php make:command --name=user:create --class=CreateUserCommand
-
-# Generate with namespace
-php main.php make:command --name=process-data --namespace="App\\Commands"
-```
-
-### Template-Based Generation
-```bash
-# Interactive command template
-php main.php make:command --name=setup-wizard --template=interactive
-
-# CRUD operations template
-php main.php make:command --name=user-manager --template=crud
-
-# File processor template
-php main.php make:command --name=file-converter --template=file-processor
-```
-
-### Advanced Options
-```bash
-# Generate with arguments
-php main.php make:command --name=backup-db --args="database,output-path,compress"
-
-# Custom output directory
-php main.php make:command --name=deploy --path=src/Commands
-
-# All options combined
-php main.php make:command \
- --name=api:sync \
- --class=ApiSyncCommand \
- --namespace="MyApp\\Commands" \
- --template=interactive \
- --args="endpoint,token,timeout" \
- --path=app/Commands
-```
-
-## Available Templates
-
-### 1. Basic Template
-Simple command structure with minimal boilerplate:
-```php
-class HelloWorldCommand extends Command {
- public function __construct() {
- parent::__construct('hello-world', [], 'Description');
- }
-
- public function exec(): int {
- $this->println('๐ Executing hello-world command...');
- // TODO: Implement your command logic here
- $this->success('โ Command completed successfully!');
- return 0;
- }
-}
-```
-
-### 2. Interactive Template
-Command with user input and validation:
-```php
-public function exec(): int {
- $name = $this->getInput('Enter name: ');
- $email = $this->getInput('Enter email: ', null, new InputValidator(function($email) {
- return filter_var($email, FILTER_VALIDATE_EMAIL) !== false;
- }, 'Please enter a valid email address!'));
-
- if ($this->confirm('Proceed with the operation?')) {
- $this->processData($name, $email);
- $this->success('โ Operation completed successfully!');
- }
-
- return 0;
-}
-```
-
-### 3. CRUD Template
-Full CRUD operations structure:
-```php
-public function exec(): int {
- $action = $this->getArgValue('--action') ?? 'list';
-
- switch ($action) {
- case 'create': return $this->createRecord();
- case 'read': return $this->showRecord();
- case 'update': return $this->updateRecord();
- case 'delete': return $this->deleteRecord();
- case 'list':
- default: return $this->listRecords();
- }
-}
-```
-
-### 4. File Processor Template
-File processing with error handling:
-```php
-public function exec(): int {
- $inputFile = $this->getArgValue('--input');
-
- if (!$inputFile || !file_exists($inputFile)) {
- $this->error('Input file is required and must exist!');
- return 1;
- }
-
- try {
- $this->processFile($inputFile, $this->getArgValue('--output'));
- $this->success('โ File processed successfully!');
- return 0;
- } catch (\Exception $e) {
- $this->error('โ Error: ' . $e->getMessage());
- return 1;
- }
-}
-```
-
-## Generated Command Structure
-
-All generated commands include:
-
-### Proper Documentation
-```php
-/**
- * CommandName - Generated CLI command.
- *
- * Description for command-name command
- */
-class CommandNameCommand extends Command {
-```
-
-### Constructor with Arguments
-```php
-public function __construct() {
- parent::__construct('command-name', [
- '--input-file' => [
- ArgumentOption::DESCRIPTION => 'Description for input file',
- ArgumentOption::OPTIONAL => true
- ]
- ], 'Command description');
-}
-```
-
-### Structured Exec Method
-```php
-public function exec(): int {
- // Template-specific implementation
- return 0;
-}
-```
-
-### Additional Helper Methods
-Template-specific helper methods for common operations.
-
-## Smart Naming Conventions
-
-The scaffolding tool automatically converts command names to proper class names:
-
-| Command Name | Generated Class Name |
-|--------------|---------------------|
-| `hello-world` | `HelloWorldCommand` |
-| `user:create` | `UserCreateCommand` |
-| `api_sync` | `ApiSyncCommand` |
-| `process-data-file` | `ProcessDataFileCommand` |
-
-## Validation Features
-
-### Command Name Validation
-- Must start with a letter
-- Can contain lowercase letters, numbers, hyphens, colons, underscores
-- Examples: `hello`, `user:create`, `process-data`
-
-### Class Name Validation
-- Must be valid PHP class name (PascalCase)
-- Automatically generated if not provided
-- Examples: `HelloCommand`, `UserCreateCommand`
-
-### File Overwrite Protection
-```bash
-$ php main.php make:command --name=existing-command
-File /path/to/ExistingCommand.php already exists. Overwrite? (y/n): n
-โ Failed to generate command: File already exists and overwrite was declined.
-```
-
-## Integration with Your Application
-
-After generating commands, integrate them into your application:
-
-### 1. Register the Command
-```php
-use App\Commands\GeneratedCommand;
-
-$runner = new Runner();
-$runner->register(new GeneratedCommand());
-```
-
-### 2. Implement Logic
-Edit the generated `exec()` method to add your specific functionality.
-
-### 3. Add Tests
-Create unit tests for your generated commands using `CommandTestCase`.
-
-## Best Practices
-
-### Naming Conventions
-- Use kebab-case for command names: `user-create`, `data-export`
-- Use namespaces for organization: `user:create`, `db:migrate`
-- Keep names descriptive but concise
-
-### Template Selection
-- **Basic**: Simple commands with minimal logic
-- **Interactive**: Commands requiring user input
-- **CRUD**: Data management commands
-- **File Processor**: File manipulation commands
-
-### Organization
-```
-app/
-โโโ Commands/
-โ โโโ User/
-โ โ โโโ CreateUserCommand.php
-โ โ โโโ DeleteUserCommand.php
-โ โโโ Database/
-โ โ โโโ MigrateCommand.php
-โ โ โโโ SeedCommand.php
-โ โโโ File/
-โ โโโ ProcessCommand.php
-โ โโโ ConvertCommand.php
-```
-
-## Example Workflow
-
-### 1. Generate User Management Commands
-```bash
-# Create user command
-php main.php make:command --name=user:create --template=interactive --namespace="App\\Commands\\User"
-
-# List users command
-php main.php make:command --name=user:list --template=crud --namespace="App\\Commands\\User"
-
-# Delete user command
-php main.php make:command --name=user:delete --namespace="App\\Commands\\User"
-```
-
-### 2. Generate File Processing Commands
-```bash
-# CSV processor
-php main.php make:command --name=csv:process --template=file-processor --args="input,output,delimiter"
-
-# Image converter
-php main.php make:command --name=image:convert --template=file-processor --args="input,format,quality"
-```
-
-### 3. Generate API Commands
-```bash
-# API sync command
-php main.php make:command --name=api:sync --template=interactive --args="endpoint,token"
-
-# Data export command
-php main.php make:command --name=data:export --args="format,output,filter"
-```
-
----
-
-**Ready to boost your development speed?** Use the scaffolding tools to generate well-structured commands in seconds!
-## Related Examples
-
-### Generated Command Examples
-- **[01-basic-hello-world](../01-basic-hello-world/)** - Basic template structure
-- **[02-arguments-and-options](../02-arguments-and-options/)** - Commands with arguments (CRUD template)
-- **[03-user-input](../03-user-input/)** - Interactive commands (Interactive template)
-- **[08-file-processing](../08-file-processing/)** - File operations (File Processor template)
-
-### Enhanced Features for Generated Commands
-- **[04-output-formatting](../04-output-formatting/)** - Add formatting to generated commands
-- **[05-interactive-commands](../05-interactive-commands/)** - Interactive workflows
-- **[06-table-display](../06-table-display/)** - Data display in generated commands
-- **[07-progress-bars](../07-progress-bars/)** - Progress indicators
-- **[11-masked-input](../11-masked-input/)** - Secure input in generated commands
-
-### Complete Applications
-- **[10-multi-command-app](../10-multi-command-app/)** - Applications built with scaffolded commands
-- **[09-database-ops](../09-database-ops/)** - Database commands (perfect for CRUD template)
-
-### Development Workflow
-Use this scaffolding tool to quickly generate commands for any of the above examples!
+# Command Scaffolding Tools
+
+This example demonstrates the **command scaffolding functionality** in WebFiori CLI, which allows developers to quickly generate new command classes with proper structure, documentation, and templates.
+
+## Features
+
+- **Multiple Templates**: Basic, Interactive, CRUD, and File Processor templates
+- **Smart Naming**: Automatic class name generation from command names
+- **Namespace Support**: Generate commands with custom namespaces
+- **Argument Generation**: Automatically create command arguments
+- **Validation**: Input validation for command and class names
+- **Overwrite Protection**: Confirmation prompts for existing files
+
+## Running the Example
+
+### Basic Command Generation
+```bash
+# Generate a basic command
+php main.php make:command --name=hello-world
+
+# Generate with custom class name
+php main.php make:command --name=user:create --class=CreateUserCommand
+
+# Generate with namespace
+php main.php make:command --name=process-data --namespace="App\\Commands"
+```
+
+### Template-Based Generation
+```bash
+# Interactive command template
+php main.php make:command --name=setup-wizard --template=interactive
+
+# CRUD operations template
+php main.php make:command --name=user-manager --template=crud
+
+# File processor template
+php main.php make:command --name=file-converter --template=file-processor
+```
+
+### Advanced Options
+```bash
+# Generate with arguments
+php main.php make:command --name=backup-db --args="database,output-path,compress"
+
+# Custom output directory
+php main.php make:command --name=deploy --path=src/Commands
+
+# All options combined
+php main.php make:command \
+ --name=api:sync \
+ --class=ApiSyncCommand \
+ --namespace="MyApp\\Commands" \
+ --template=interactive \
+ --args="endpoint,token,timeout" \
+ --path=app/Commands
+```
+
+## Available Templates
+
+### 1. Basic Template
+Simple command structure with minimal boilerplate:
+```php
+class HelloWorldCommand extends Command {
+ public function __construct() {
+ parent::__construct('hello-world', [], 'Description');
+ }
+
+ public function exec(): int {
+ $this->println('๐ Executing hello-world command...');
+ // TODO: Implement your command logic here
+ $this->success('โ Command completed successfully!');
+ return 0;
+ }
+}
+```
+
+### 2. Interactive Template
+Command with user input and validation:
+```php
+public function exec(): int {
+ $name = $this->getInput('Enter name: ');
+ $email = $this->getInput('Enter email: ', null, new InputValidator(function($email) {
+ return filter_var($email, FILTER_VALIDATE_EMAIL) !== false;
+ }, 'Please enter a valid email address!'));
+
+ if ($this->confirm('Proceed with the operation?')) {
+ $this->processData($name, $email);
+ $this->success('โ Operation completed successfully!');
+ }
+
+ return 0;
+}
+```
+
+### 3. CRUD Template
+Full CRUD operations structure:
+```php
+public function exec(): int {
+ $action = $this->getArgValue('--action') ?? 'list';
+
+ switch ($action) {
+ case 'create': return $this->createRecord();
+ case 'read': return $this->showRecord();
+ case 'update': return $this->updateRecord();
+ case 'delete': return $this->deleteRecord();
+ case 'list':
+ default: return $this->listRecords();
+ }
+}
+```
+
+### 4. File Processor Template
+File processing with error handling:
+```php
+public function exec(): int {
+ $inputFile = $this->getArgValue('--input');
+
+ if (!$inputFile || !file_exists($inputFile)) {
+ $this->error('Input file is required and must exist!');
+ return 1;
+ }
+
+ try {
+ $this->processFile($inputFile, $this->getArgValue('--output'));
+ $this->success('โ File processed successfully!');
+ return 0;
+ } catch (\Exception $e) {
+ $this->error('โ Error: ' . $e->getMessage());
+ return 1;
+ }
+}
+```
+
+## Generated Command Structure
+
+All generated commands include:
+
+### Proper Documentation
+```php
+/**
+ * CommandName - Generated CLI command.
+ *
+ * Description for command-name command
+ */
+class CommandNameCommand extends Command {
+```
+
+### Constructor with Arguments
+```php
+public function __construct() {
+ parent::__construct('command-name', [
+ '--input-file' => [
+ ArgumentOption::DESCRIPTION => 'Description for input file',
+ ArgumentOption::OPTIONAL => true
+ ]
+ ], 'Command description');
+}
+```
+
+### Structured Exec Method
+```php
+public function exec(): int {
+ // Template-specific implementation
+ return 0;
+}
+```
+
+### Additional Helper Methods
+Template-specific helper methods for common operations.
+
+## Smart Naming Conventions
+
+The scaffolding tool automatically converts command names to proper class names:
+
+| Command Name | Generated Class Name |
+|--------------|---------------------|
+| `hello-world` | `HelloWorldCommand` |
+| `user:create` | `UserCreateCommand` |
+| `api_sync` | `ApiSyncCommand` |
+| `process-data-file` | `ProcessDataFileCommand` |
+
+## Validation Features
+
+### Command Name Validation
+- Must start with a letter
+- Can contain lowercase letters, numbers, hyphens, colons, underscores
+- Examples: `hello`, `user:create`, `process-data`
+
+### Class Name Validation
+- Must be valid PHP class name (PascalCase)
+- Automatically generated if not provided
+- Examples: `HelloCommand`, `UserCreateCommand`
+
+### File Overwrite Protection
+```bash
+$ php main.php make:command --name=existing-command
+File /path/to/ExistingCommand.php already exists. Overwrite? (y/n): n
+โ Failed to generate command: File already exists and overwrite was declined.
+```
+
+## Integration with Your Application
+
+After generating commands, integrate them into your application:
+
+### 1. Register the Command
+```php
+use App\Commands\GeneratedCommand;
+
+$runner = new Runner();
+$runner->register(new GeneratedCommand());
+```
+
+### 2. Implement Logic
+Edit the generated `exec()` method to add your specific functionality.
+
+### 3. Add Tests
+Create unit tests for your generated commands using `CommandTestCase`.
+
+## Best Practices
+
+### Naming Conventions
+- Use kebab-case for command names: `user-create`, `data-export`
+- Use namespaces for organization: `user:create`, `db:migrate`
+- Keep names descriptive but concise
+
+### Template Selection
+- **Basic**: Simple commands with minimal logic
+- **Interactive**: Commands requiring user input
+- **CRUD**: Data management commands
+- **File Processor**: File manipulation commands
+
+### Organization
+```
+app/
+โโโ Commands/
+โ โโโ User/
+โ โ โโโ CreateUserCommand.php
+โ โ โโโ DeleteUserCommand.php
+โ โโโ Database/
+โ โ โโโ MigrateCommand.php
+โ โ โโโ SeedCommand.php
+โ โโโ File/
+โ โโโ ProcessCommand.php
+โ โโโ ConvertCommand.php
+```
+
+## Example Workflow
+
+### 1. Generate User Management Commands
+```bash
+# Create user command
+php main.php make:command --name=user:create --template=interactive --namespace="App\\Commands\\User"
+
+# List users command
+php main.php make:command --name=user:list --template=crud --namespace="App\\Commands\\User"
+
+# Delete user command
+php main.php make:command --name=user:delete --namespace="App\\Commands\\User"
+```
+
+### 2. Generate File Processing Commands
+```bash
+# CSV processor
+php main.php make:command --name=csv:process --template=file-processor --args="input,output,delimiter"
+
+# Image converter
+php main.php make:command --name=image:convert --template=file-processor --args="input,format,quality"
+```
+
+### 3. Generate API Commands
+```bash
+# API sync command
+php main.php make:command --name=api:sync --template=interactive --args="endpoint,token"
+
+# Data export command
+php main.php make:command --name=data:export --args="format,output,filter"
+```
+
+---
+
+**Ready to boost your development speed?** Use the scaffolding tools to generate well-structured commands in seconds!
+## Related Examples
+
+### Generated Command Examples
+- **[01-basic-hello-world](../01-basic-hello-world/)** - Basic template structure
+- **[02-arguments-and-options](../02-arguments-and-options/)** - Commands with arguments (CRUD template)
+- **[03-user-input](../03-user-input/)** - Interactive commands (Interactive template)
+- **[08-file-processing](../08-file-processing/)** - File operations (File Processor template)
+
+### Enhanced Features for Generated Commands
+- **[04-output-formatting](../04-output-formatting/)** - Add formatting to generated commands
+- **[05-interactive-commands](../05-interactive-commands/)** - Interactive workflows
+- **[06-table-display](../06-table-display/)** - Data display in generated commands
+- **[07-progress-bars](../07-progress-bars/)** - Progress indicators
+- **[11-masked-input](../11-masked-input/)** - Secure input in generated commands
+
+### Complete Applications
+- **[10-multi-command-app](../10-multi-command-app/)** - Applications built with scaffolded commands
+- **[09-database-ops](../09-database-ops/)** - Database commands (perfect for CRUD template)
+
+### Development Workflow
+Use this scaffolding tool to quickly generate commands for any of the above examples!
diff --git a/examples/12-command-scaffolding/main.php b/examples/12-command-scaffolding/main.php
index f568443..9fff866 100644
--- a/examples/12-command-scaffolding/main.php
+++ b/examples/12-command-scaffolding/main.php
@@ -1,23 +1,23 @@
-register(new MakeCommand());
-
-// Start the application
-exit($runner->start());
+register(new MakeCommand());
+
+// Start the application
+exit($runner->start());
diff --git a/examples/README.md b/examples/README.md
index 62526f6..1c8bc01 100644
--- a/examples/README.md
+++ b/examples/README.md
@@ -1,256 +1,256 @@
-# WebFiori CLI Examples
-
-This directory contains comprehensive examples demonstrating the features and capabilities of the WebFiori CLI library. The examples are organized from basic to advanced use cases, each with its own README and runnable code.
-
-## ๐ Example Categories
-
-### ๐ข **Basic Examples**
-Perfect for getting started with the library.
-
-- **[01-basic-hello-world](01-basic-hello-world/)** - Simple command creation and execution
-- **[02-arguments-and-options](02-arguments-and-options/)** - Working with command arguments and options
-- **[03-user-input](03-user-input/)** - Reading and validating user input
-- **[04-output-formatting](04-output-formatting/)** - ANSI colors, formatting, and styling
-
-### ๐ก **Intermediate Examples**
-Building more sophisticated CLI applications.
-
-- **[05-interactive-commands](05-interactive-commands/)** - Creating interactive command experiences
-- **[07-progress-bars](07-progress-bars/)** - Visual progress indicators for long operations
-- **[11-masked-input](11-masked-input/)** - Secure input with character masking
-### ๐ด **Advanced Examples**
-Complex scenarios and advanced features.
-
-- **[10-multi-command-app](10-multi-command-app/)** - Building a complete CLI application
-- **[13-database-cli](13-database-cli/)** - Database management CLI tool
-
-## ๐ Quick Start
-
-Each example is self-contained and can be run independently:
-
-```bash
-# Navigate to any example directory
-cd examples/01-basic-hello-world
-
-# Run the example
-php main.php [command] [options]
-
-# Get help for any example
-php main.php help
-```
-
-## ๐ Prerequisites
-
-- PHP 8.0 or higher
-- Composer (for dependency management)
-- Terminal with ANSI support (recommended)
-
-## ๐ ๏ธ Installation
-
-1. Clone the repository:
-```bash
-git clone https://github.com/WebFiori/cli.git
-cd cli
-```
-
-2. Install dependencies:
-```bash
-composer install
-```
-
-3. Navigate to any example and start exploring:
-```bash
-cd examples/01-basic-hello-world
-php main.php hello --name="World"
-```
-
-## ๐ Learning Path
-
-### For Beginners
-Start with examples 01-04 to understand the fundamentals:
-1. **Basic Hello World** - Command structure and basic output
-2. **Arguments & Options** - Parameter handling and validation
-3. **User Input** - Interactive input and validation
-4. **Output Formatting** - Colors, styles, and visual elements
-
-### For Intermediate Users
-Continue with examples 05-07 to build more complex applications:
-1. **Interactive Commands** - Menu systems and wizards
-2. **Progress Bars** - Visual feedback for long operations
-
-### For Advanced Users
-Explore examples 10-13 for real-world applications:
-1. **Multi-Command App** - Complete application architecture
-2. **Database CLI** - Database management tools
-
-## ๐ฏ Key Features Demonstrated
-
-| Feature | Examples | Description |
-|---------|----------|-------------|
-| **Command Creation** | 01, 02, 10 | Basic to advanced command structures |
-| **Arguments & Options** | 02, 13 | Parameter handling and validation |
-| **User Input** | 03, 05, 11 | Interactive input, validation, and secure entry |
-| **Output Formatting** | 04, 07 | Colors, styles, and progress bars |
-| **Interactive Workflows** | 05, 10 | Menu systems and wizards |
-| **Progress Indicators** | 07, 10, 13 | Visual feedback for operations |
-| **Data Management** | 10, 13 | CRUD operations and persistence |
-| **Real-world Apps** | 10, 13 | Production-ready CLI tools |
-
-## ๐ง Common Patterns
-
-### Command Structure
-```php
-class MyCommand extends Command {
- public function __construct() {
- parent::__construct('my-command', [
- '--option' => [
- Option::DESCRIPTION => 'Command option',
- Option::OPTIONAL => true
- ]
- ], 'Command description');
- }
-
- public function exec(): int {
- // Command logic here
- return 0; // Success
- }
-}
-```
-
-### Runner Setup
-```php
-$runner = new Runner();
-$runner->register(new MyCommand());
-$runner->register(new HelpCommand());
-exit($runner->start());
-```
-
-### Progress Bar Usage
-```php
-$progressBar = $this->createProgressBar(100);
-$progressBar->start('Processing...');
-
-for ($i = 0; $i < 100; $i++) {
- // Do work
- $progressBar->advance();
-}
-
-$progressBar->finish('Complete!');
-```
-
-### Testing Commands
-```php
-class MyCommandTest extends CommandTestCase {
- public function testCommand() {
- $output = $this->executeSingleCommand(new MyCommand(), ['my-command']);
- $this->assertEquals(0, $this->getExitCode());
- }
-}
-```
-
-## ๐จ Example Outputs
-
-### Basic Hello World
-```bash
-$ php main.php hello --name="WebFiori"
-๐ Hello, WebFiori! Welcome to the CLI world!
-You're using the WebFiori CLI library - great choice!
-Have a wonderful day!
-```
-
-### Arguments & Options
-```bash
-$ php main.php calc --operation=add --numbers="5,10,15,20"
-โ Performing add on: 5, 10, 15, 20
-๐ Result: 50.00
-```
-
-### Progress Bars
-```bash
-$ php main.php progress-demo --style=ascii --items=10
-Processing with ascii style... [========================================] 100.0% (10/10)
-Complete! โจ Progress bar demonstration completed!
-```
-
-### Multi-Command App
-```bash
-$ php main.php user --action=list --format=table
-๐ฅ User Management - List Users
-
-โโโโโโฌโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโฌโโโโโโโโโโโโโโ
-โ ID โ Name โ Email โ Status โ Created โ
-โโโโโโผโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโผโโโโโโโโโโโโโโค
-โ 1 โ John Doe โ john@example.com โ Active โ 2024-01-15 โ
-โ 2 โ Jane Smith โ jane@example.com โ Active โ 2024-01-16 โ
-โโโโโโดโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโดโโโโโโโโโโโโโโ
-
-๐ Total: 2 users | Active: 2 | Inactive: 0
-```
-
-## ๐งช Testing Examples
-
-Most examples include unit tests that can be run with PHPUnit:
-
-```bash
-# Run tests for a specific example
-cd examples/10-multi-command-app
-php ../../vendor/bin/phpunit tests/
-
-# Run with coverage
-php ../../vendor/bin/phpunit --coverage-html coverage/ tests/
-```
-
-## ๐ค Contributing
-
-Found an issue or want to add a new example? Contributions are welcome!
-
-1. Fork the repository
-2. Create a new example following the existing structure
-3. Add comprehensive README documentation
-4. Include unit tests where applicable
-5. Submit a pull request
-
-### Example Structure Guidelines
-
-Each example should follow this structure:
-```
-example-name/
-โโโ README.md # Comprehensive documentation
-โโโ main.php # Application entry point
-โโโ SomeCommand.php # Command classes
-โโโ tests/ # Unit tests (optional)
-โ โโโ SomeCommandTest.php
-โโโ data/ # Sample data files (if needed)
-```
-
-### Documentation Requirements
-
-Each example README should include:
-- **What You'll Learn** - Key concepts covered
-- **Running the Examples** - Command examples
-- **Code Explanation** - Key code snippets
-- **Expected Output** - Sample outputs
-- **Try This** - Extension ideas
-
-## ๐ License
-
-This project is licensed under the MIT License. See the main repository LICENSE file for details.
-
-## ๐ Support
-
-- **Documentation**: Check individual example READMEs
-- **Issues**: Report bugs or request features on GitHub
-- **Community**: Join discussions in the WebFiori community
-
-## ๐ Additional Resources
-
-- **[WebFiori CLI Documentation](https://webfiori.com/docs/cli)**
-- **[PHP CLI Best Practices](https://www.php.net/manual/en/features.commandline.php)**
-- **[ANSI Escape Codes Reference](https://en.wikipedia.org/wiki/ANSI_escape_code)**
-- **[Command Line Interface Guidelines](https://clig.dev/)**
-
----
-
-**Happy coding with WebFiori CLI!** ๐
-
-*Start with the basic examples and work your way up to building production-ready CLI applications!*
+# WebFiori CLI Examples
+
+This directory contains comprehensive examples demonstrating the features and capabilities of the WebFiori CLI library. The examples are organized from basic to advanced use cases, each with its own README and runnable code.
+
+## ๐ Example Categories
+
+### ๐ข **Basic Examples**
+Perfect for getting started with the library.
+
+- **[01-basic-hello-world](01-basic-hello-world/)** - Simple command creation and execution
+- **[02-arguments-and-options](02-arguments-and-options/)** - Working with command arguments and options
+- **[03-user-input](03-user-input/)** - Reading and validating user input
+- **[04-output-formatting](04-output-formatting/)** - ANSI colors, formatting, and styling
+
+### ๐ก **Intermediate Examples**
+Building more sophisticated CLI applications.
+
+- **[05-interactive-commands](05-interactive-commands/)** - Creating interactive command experiences
+- **[07-progress-bars](07-progress-bars/)** - Visual progress indicators for long operations
+- **[11-masked-input](11-masked-input/)** - Secure input with character masking
+### ๐ด **Advanced Examples**
+Complex scenarios and advanced features.
+
+- **[10-multi-command-app](10-multi-command-app/)** - Building a complete CLI application
+- **[13-database-cli](13-database-cli/)** - Database management CLI tool
+
+## ๐ Quick Start
+
+Each example is self-contained and can be run independently:
+
+```bash
+# Navigate to any example directory
+cd examples/01-basic-hello-world
+
+# Run the example
+php main.php [command] [options]
+
+# Get help for any example
+php main.php help
+```
+
+## ๐ Prerequisites
+
+- PHP 8.0 or higher
+- Composer (for dependency management)
+- Terminal with ANSI support (recommended)
+
+## ๐ ๏ธ Installation
+
+1. Clone the repository:
+```bash
+git clone https://github.com/WebFiori/cli.git
+cd cli
+```
+
+2. Install dependencies:
+```bash
+composer install
+```
+
+3. Navigate to any example and start exploring:
+```bash
+cd examples/01-basic-hello-world
+php main.php hello --name="World"
+```
+
+## ๐ Learning Path
+
+### For Beginners
+Start with examples 01-04 to understand the fundamentals:
+1. **Basic Hello World** - Command structure and basic output
+2. **Arguments & Options** - Parameter handling and validation
+3. **User Input** - Interactive input and validation
+4. **Output Formatting** - Colors, styles, and visual elements
+
+### For Intermediate Users
+Continue with examples 05-07 to build more complex applications:
+1. **Interactive Commands** - Menu systems and wizards
+2. **Progress Bars** - Visual feedback for long operations
+
+### For Advanced Users
+Explore examples 10-13 for real-world applications:
+1. **Multi-Command App** - Complete application architecture
+2. **Database CLI** - Database management tools
+
+## ๐ฏ Key Features Demonstrated
+
+| Feature | Examples | Description |
+|---------|----------|-------------|
+| **Command Creation** | 01, 02, 10 | Basic to advanced command structures |
+| **Arguments & Options** | 02, 13 | Parameter handling and validation |
+| **User Input** | 03, 05, 11 | Interactive input, validation, and secure entry |
+| **Output Formatting** | 04, 07 | Colors, styles, and progress bars |
+| **Interactive Workflows** | 05, 10 | Menu systems and wizards |
+| **Progress Indicators** | 07, 10, 13 | Visual feedback for operations |
+| **Data Management** | 10, 13 | CRUD operations and persistence |
+| **Real-world Apps** | 10, 13 | Production-ready CLI tools |
+
+## ๐ง Common Patterns
+
+### Command Structure
+```php
+class MyCommand extends Command {
+ public function __construct() {
+ parent::__construct('my-command', [
+ '--option' => [
+ Option::DESCRIPTION => 'Command option',
+ Option::OPTIONAL => true
+ ]
+ ], 'Command description');
+ }
+
+ public function exec(): int {
+ // Command logic here
+ return 0; // Success
+ }
+}
+```
+
+### Runner Setup
+```php
+$runner = new Runner();
+$runner->register(new MyCommand());
+$runner->register(new HelpCommand());
+exit($runner->start());
+```
+
+### Progress Bar Usage
+```php
+$progressBar = $this->createProgressBar(100);
+$progressBar->start('Processing...');
+
+for ($i = 0; $i < 100; $i++) {
+ // Do work
+ $progressBar->advance();
+}
+
+$progressBar->finish('Complete!');
+```
+
+### Testing Commands
+```php
+class MyCommandTest extends CommandTestCase {
+ public function testCommand() {
+ $output = $this->executeSingleCommand(new MyCommand(), ['my-command']);
+ $this->assertEquals(0, $this->getExitCode());
+ }
+}
+```
+
+## ๐จ Example Outputs
+
+### Basic Hello World
+```bash
+$ php main.php hello --name="WebFiori"
+๐ Hello, WebFiori! Welcome to the CLI world!
+You're using the WebFiori CLI library - great choice!
+Have a wonderful day!
+```
+
+### Arguments & Options
+```bash
+$ php main.php calc --operation=add --numbers="5,10,15,20"
+โ Performing add on: 5, 10, 15, 20
+๐ Result: 50.00
+```
+
+### Progress Bars
+```bash
+$ php main.php progress-demo --style=ascii --items=10
+Processing with ascii style... [========================================] 100.0% (10/10)
+Complete! โจ Progress bar demonstration completed!
+```
+
+### Multi-Command App
+```bash
+$ php main.php user --action=list --format=table
+๐ฅ User Management - List Users
+
+โโโโโโฌโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโฌโโโโโโโโโโโโโโ
+โ ID โ Name โ Email โ Status โ Created โ
+โโโโโโผโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโผโโโโโโโโโโโโโโค
+โ 1 โ John Doe โ john@example.com โ Active โ 2024-01-15 โ
+โ 2 โ Jane Smith โ jane@example.com โ Active โ 2024-01-16 โ
+โโโโโโดโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโดโโโโโโโโโโโโโโ
+
+๐ Total: 2 users | Active: 2 | Inactive: 0
+```
+
+## ๐งช Testing Examples
+
+Most examples include unit tests that can be run with PHPUnit:
+
+```bash
+# Run tests for a specific example
+cd examples/10-multi-command-app
+php ../../vendor/bin/phpunit tests/
+
+# Run with coverage
+php ../../vendor/bin/phpunit --coverage-html coverage/ tests/
+```
+
+## ๐ค Contributing
+
+Found an issue or want to add a new example? Contributions are welcome!
+
+1. Fork the repository
+2. Create a new example following the existing structure
+3. Add comprehensive README documentation
+4. Include unit tests where applicable
+5. Submit a pull request
+
+### Example Structure Guidelines
+
+Each example should follow this structure:
+```
+example-name/
+โโโ README.md # Comprehensive documentation
+โโโ main.php # Application entry point
+โโโ SomeCommand.php # Command classes
+โโโ tests/ # Unit tests (optional)
+โ โโโ SomeCommandTest.php
+โโโ data/ # Sample data files (if needed)
+```
+
+### Documentation Requirements
+
+Each example README should include:
+- **What You'll Learn** - Key concepts covered
+- **Running the Examples** - Command examples
+- **Code Explanation** - Key code snippets
+- **Expected Output** - Sample outputs
+- **Try This** - Extension ideas
+
+## ๐ License
+
+This project is licensed under the MIT License. See the main repository LICENSE file for details.
+
+## ๐ Support
+
+- **Documentation**: Check individual example READMEs
+- **Issues**: Report bugs or request features on GitHub
+- **Community**: Join discussions in the WebFiori community
+
+## ๐ Additional Resources
+
+- **[WebFiori CLI Documentation](https://webfiori.com/docs/cli)**
+- **[PHP CLI Best Practices](https://www.php.net/manual/en/features.commandline.php)**
+- **[ANSI Escape Codes Reference](https://en.wikipedia.org/wiki/ANSI_escape_code)**
+- **[Command Line Interface Guidelines](https://clig.dev/)**
+
+---
+
+**Happy coding with WebFiori CLI!** ๐
+
+*Start with the basic examples and work your way up to building production-ready CLI applications!*
diff --git a/php_cs.php.dist b/php_cs.php.dist
index 99e95b5..83a4ad4 100644
--- a/php_cs.php.dist
+++ b/php_cs.php.dist
@@ -1,105 +1,105 @@
-exclude('vendor')
- ->exclude('tests')
- ->in(__DIR__)
-;
-
-$config = new PhpCsFixer\Config();
-return $config->setRules([
- 'align_multiline_comment' => [
- 'comment_type' => 'phpdocs_only'
- ],
- 'array_indentation' => true,
- 'array_syntax' => [
- 'syntax' => 'short'
- ],
- 'binary_operator_spaces' => [
- 'default' => 'single_space'
- ],
- 'blank_line_before_statement' => [
- 'statements' => [
- 'if','return','while','for','foreach','do'
- ]
- ],
- 'blank_line_after_opening_tag' => true,
- 'blank_line_after_namespace' => true,
- 'elseif' => false,
- 'explicit_string_variable' => false,
- 'full_opening_tag' => true,
- 'fully_qualified_strict_types' => true,
- 'line_ending' => true,
- 'linebreak_after_opening_tag' => true,
- 'lowercase_cast' => true,
- 'lowercase_keywords' => true,
- 'lowercase_static_reference' => true,
- 'no_alternative_syntax' => true,
- 'no_blank_lines_after_class_opening' => true,
- 'no_blank_lines_after_phpdoc' => true,
- 'no_blank_lines_before_namespace' => true,
- 'no_closing_tag' => true,
- 'no_empty_comment' => true,
- 'no_empty_phpdoc' => true,
- 'no_empty_statement' => true,
- 'no_multiline_whitespace_around_double_arrow' => true,
- 'no_spaces_after_function_name' => true,
- 'no_spaces_inside_parenthesis' => true,
- 'no_unused_imports' => true,
- 'single_import_per_statement' => true,
- 'single_blank_line_at_eof' => true,
- 'no_whitespace_in_blank_line' => true,
- 'not_operator_with_space' => false,
- 'ordered_imports' => [
- 'sort_algorithm' => 'alpha'
- ],
- 'ordered_class_elements' => [
- 'sort_algorithm' => 'alpha',
- 'order' => [
- 'constant_public',
- 'constant_protected',
- 'constant_private',
- 'property_public',
- 'property_protected',
- 'property_private',
- 'construct',
- 'method_public',
- 'method_private'
- ]
- ],
- 'no_mixed_echo_print' => [
- 'use' => 'echo'
- ],
- 'constant_case' => [
- 'case' => 'lower'
- ],
- 'increment_style' => [
- 'style' => 'post'
- ],
- 'concat_space' => [
- 'spacing' => 'none'
- ],
- 'single_space_around_construct' => true,
- 'control_structure_braces' => true,
- 'control_structure_continuation_position' => [
- 'position' => 'same_line'
- ],
- 'declare_parentheses' => true,
- 'no_multiple_statements_per_line' => true,
- 'braces_position' => [
- 'functions_opening_brace' => 'same_line',
- 'classes_opening_brace' => 'same_line',
- 'anonymous_classes_opening_brace' => 'same_line',
- 'allow_single_line_empty_anonymous_classes' => false,
- 'allow_single_line_anonymous_functions' => false
- ],
- 'statement_indentation' => true,
- 'no_extra_blank_lines' => [
- 'tokens' => ['extra']
- ],
- 'class_definition' => [
- 'single_line' => true
- ]
- ])
- ->setFinder($finder)
-;
+exclude('vendor')
+ ->exclude('tests')
+ ->in(__DIR__)
+;
+
+$config = new PhpCsFixer\Config();
+return $config->setRules([
+ 'align_multiline_comment' => [
+ 'comment_type' => 'phpdocs_only'
+ ],
+ 'array_indentation' => true,
+ 'array_syntax' => [
+ 'syntax' => 'short'
+ ],
+ 'binary_operator_spaces' => [
+ 'default' => 'single_space'
+ ],
+ 'blank_line_before_statement' => [
+ 'statements' => [
+ 'if','return','while','for','foreach','do'
+ ]
+ ],
+ 'blank_line_after_opening_tag' => true,
+ 'blank_line_after_namespace' => true,
+ 'elseif' => false,
+ 'explicit_string_variable' => false,
+ 'full_opening_tag' => true,
+ 'fully_qualified_strict_types' => true,
+ 'line_ending' => true,
+ 'linebreak_after_opening_tag' => true,
+ 'lowercase_cast' => true,
+ 'lowercase_keywords' => true,
+ 'lowercase_static_reference' => true,
+ 'no_alternative_syntax' => true,
+ 'no_blank_lines_after_class_opening' => true,
+ 'no_blank_lines_after_phpdoc' => true,
+ 'no_blank_lines_before_namespace' => true,
+ 'no_closing_tag' => true,
+ 'no_empty_comment' => true,
+ 'no_empty_phpdoc' => true,
+ 'no_empty_statement' => true,
+ 'no_multiline_whitespace_around_double_arrow' => true,
+ 'no_spaces_after_function_name' => true,
+ 'no_spaces_inside_parenthesis' => true,
+ 'no_unused_imports' => true,
+ 'single_import_per_statement' => true,
+ 'single_blank_line_at_eof' => true,
+ 'no_whitespace_in_blank_line' => true,
+ 'not_operator_with_space' => false,
+ 'ordered_imports' => [
+ 'sort_algorithm' => 'alpha'
+ ],
+ 'ordered_class_elements' => [
+ 'sort_algorithm' => 'alpha',
+ 'order' => [
+ 'constant_public',
+ 'constant_protected',
+ 'constant_private',
+ 'property_public',
+ 'property_protected',
+ 'property_private',
+ 'construct',
+ 'method_public',
+ 'method_private'
+ ]
+ ],
+ 'no_mixed_echo_print' => [
+ 'use' => 'echo'
+ ],
+ 'constant_case' => [
+ 'case' => 'lower'
+ ],
+ 'increment_style' => [
+ 'style' => 'post'
+ ],
+ 'concat_space' => [
+ 'spacing' => 'none'
+ ],
+ 'single_space_around_construct' => true,
+ 'control_structure_braces' => true,
+ 'control_structure_continuation_position' => [
+ 'position' => 'same_line'
+ ],
+ 'declare_parentheses' => true,
+ 'no_multiple_statements_per_line' => true,
+ 'braces_position' => [
+ 'functions_opening_brace' => 'same_line',
+ 'classes_opening_brace' => 'same_line',
+ 'anonymous_classes_opening_brace' => 'same_line',
+ 'allow_single_line_empty_anonymous_classes' => false,
+ 'allow_single_line_anonymous_functions' => false
+ ],
+ 'statement_indentation' => true,
+ 'no_extra_blank_lines' => [
+ 'tokens' => ['extra']
+ ],
+ 'class_definition' => [
+ 'single_line' => true
+ ]
+ ])
+ ->setFinder($finder)
+;
diff --git a/release-please-config.json b/release-please-config.json
index 180f5de..4ae27d7 100644
--- a/release-please-config.json
+++ b/release-please-config.json
@@ -1,23 +1,23 @@
-{
- "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json",
- "include-v-in-tag":true,
- "tag-separator": "-",
- "changelog-path": "CHANGELOG.md",
- "changelog-sections": [
- { "type": "feat", "section": "Features" },
- { "type": "feature", "section": "Features" },
- { "type": "fix", "section": "Bug Fixes" },
- { "type": "perf", "section": "Performance Improvements" },
- { "type": "revert", "section": "Reverts" },
- { "type": "docs", "section": "Documentation" },
- { "type": "style", "section": "Styles" },
- { "type": "chore", "section": "Miscellaneous Chores" },
- { "type": "refactor", "section": "Code Refactoring" },
- { "type": "test", "section": "Testing" },
- { "type": "build", "section": "Build System" },
- { "type": "ci", "section": "Continuous Integration" },
- { "type": "ui", "section": "User Interface" },
- { "type": "database", "section": "Database Changes" },
- { "type": "email", "section": "Email Notifications Changes" }
- ]
+{
+ "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json",
+ "include-v-in-tag":true,
+ "tag-separator": "-",
+ "changelog-path": "CHANGELOG.md",
+ "changelog-sections": [
+ { "type": "feat", "section": "Features" },
+ { "type": "feature", "section": "Features" },
+ { "type": "fix", "section": "Bug Fixes" },
+ { "type": "perf", "section": "Performance Improvements" },
+ { "type": "revert", "section": "Reverts" },
+ { "type": "docs", "section": "Documentation" },
+ { "type": "style", "section": "Styles" },
+ { "type": "chore", "section": "Miscellaneous Chores" },
+ { "type": "refactor", "section": "Code Refactoring" },
+ { "type": "test", "section": "Testing" },
+ { "type": "build", "section": "Build System" },
+ { "type": "ci", "section": "Continuous Integration" },
+ { "type": "ui", "section": "User Interface" },
+ { "type": "database", "section": "Database Changes" },
+ { "type": "email", "section": "Email Notifications Changes" }
+ ]
}
\ No newline at end of file
diff --git a/sonar-project.properties b/sonar-project.properties
index 0b95e12..7ab6b4f 100644
--- a/sonar-project.properties
+++ b/sonar-project.properties
@@ -1,12 +1,12 @@
-sonar.projectKey=WebFiori_cli
-sonar.organization=webfiori
-
-# This is the name and version displayed in the SonarCloud UI.
-sonar.projectName=cli
-#sonar.projectVersion=1.0
-sonar.exclusions=tests/**,examples/**
-# Path is relative to the sonar-project.properties file. Replace "\" by "/" on Windows.
-#sonar.sources=.
-sonar.php.coverage.reportPaths=clover.xml
-# Encoding of the source code. Default is default system encoding
-sonar.sourceEncoding=UTF-8
+sonar.projectKey=WebFiori_cli
+sonar.organization=webfiori
+
+# This is the name and version displayed in the SonarCloud UI.
+sonar.projectName=cli
+#sonar.projectVersion=1.0
+sonar.exclusions=tests/**,examples/**
+# Path is relative to the sonar-project.properties file. Replace "\" by "/" on Windows.
+#sonar.sources=.
+sonar.php.coverage.reportPaths=clover.xml
+# Encoding of the source code. Default is default system encoding
+sonar.sourceEncoding=UTF-8
diff --git a/tests/WebFiori/Tests/Cli/AliasingIntegrationTest.php b/tests/WebFiori/Tests/Cli/AliasingIntegrationTest.php
index d38a02f..60e5993 100644
--- a/tests/WebFiori/Tests/Cli/AliasingIntegrationTest.php
+++ b/tests/WebFiori/Tests/Cli/AliasingIntegrationTest.php
@@ -1,241 +1,241 @@
-setInputStream(new ArrayInputStream([]));
- $runner->setOutputStream(new ArrayOutputStream());
-
- $aliasCommand = new AliasTestCommand();
- // Don't register HelpCommand - it's automatically registered by Runner constructor
-
- $runner->register($aliasCommand);
-
- // Test help for command via direct name (not alias, as help might not resolve aliases)
- $runner->setArgsVector(['script.php', 'help', '--command=alias-test']);
- $exitCode = $runner->start();
-
- $output = $runner->getOutputStream()->getOutputArray();
- $this->assertEquals(0, $exitCode);
-
- // Should show help for the actual command
- $helpOutput = implode('', $output);
- $this->assertStringContainsString('alias-test:', $helpOutput);
- }
-
- /**
- * Test multiple aliases pointing to same command in help.
- * @test
- */
- public function testMultipleAliasesInHelp() {
- $runner = new Runner();
- $runner->setInputStream(new ArrayInputStream([]));
- $runner->setOutputStream(new ArrayOutputStream());
-
- $command = new AliasTestCommand(); // Has aliases: 'test', 'at'
- // Don't register HelpCommand - it's automatically registered by Runner constructor
-
- $runner->register($command, ['extra-alias']); // Add runtime alias
-
- // Get general help
- $runner->setArgsVector(['script.php', 'help']);
- $exitCode = $runner->start();
-
- $output = $runner->getOutputStream()->getOutputArray();
- $this->assertEquals(0, $exitCode);
-
- $helpOutput = implode('', $output);
- // Should show the main command name
- $this->assertStringContainsString('alias-test:', $helpOutput);
- }
-
- /**
- * Test alias resolution performance with many aliases.
- * @test
- */
- public function testAliasResolutionPerformance() {
- $runner = new Runner();
-
- // Create one command with many aliases to avoid conflicts
- $command = new NoAliasCommand();
- $aliases = [];
- for ($i = 1; $i <= 50; $i++) {
- $aliases[] = "perf_alias$i";
- $aliases[] = "perf_a$i";
- $aliases[] = "perf_cmd$i";
- }
- $runner->register($command, $aliases);
-
- // Test resolution performance
- $start = microtime(true);
- for ($i = 1; $i <= 50; $i++) {
- $this->assertEquals('no-alias', $runner->resolveAlias("perf_alias$i"));
- $this->assertEquals('no-alias', $runner->resolveAlias("perf_a$i"));
- $this->assertEquals('no-alias', $runner->resolveAlias("perf_cmd$i"));
- }
- $end = microtime(true);
-
- // Should resolve quickly (less than 0.1 seconds for 150 lookups)
- $this->assertLessThan(0.1, $end - $start);
- }
-
- /**
- * Test alias with special argument patterns.
- * @test
- */
- public function testAliasWithArguments() {
- $runner = new Runner();
- $runner->setInputStream(new ArrayInputStream([]));
- $runner->setOutputStream(new ArrayOutputStream());
-
- $command = new AliasTestCommand();
- $runner->register($command);
-
- // Test alias with arguments
- $runner->setArgsVector(['script.php', 'test', '--some-arg=value']);
- $exitCode = $runner->start();
-
- $output = $runner->getOutputStream()->getOutputArray();
- $this->assertEquals(0, $exitCode);
- $this->assertEquals(["Alias test command executed\n"], $output);
- }
-
- /**
- * Test alias registration order doesn't affect functionality.
- * @test
- */
- public function testAliasRegistrationOrder() {
- $runner1 = new Runner();
- $runner2 = new Runner();
-
- $command1 = new AliasTestCommand();
- $command2 = new NoAliasCommand();
-
- // Register in different orders
- $runner1->register($command1);
- $runner1->register($command2, ['test2']);
-
- $runner2->register($command2, ['test2']);
- $runner2->register($command1);
-
- // Both should have same aliases
- $aliases1 = $runner1->getAliases();
- $aliases2 = $runner2->getAliases();
-
- $this->assertEquals($aliases1['test'], $aliases2['test']);
- $this->assertEquals($aliases1['at'], $aliases2['at']);
- $this->assertEquals($aliases1['test2'], $aliases2['test2']);
- }
-
- /**
- * Test alias with empty string handling.
- * @test
- */
- public function testAliasEdgeCases() {
- $runner = new Runner();
- $command = new NoAliasCommand();
-
- // Test with empty strings in aliases array
- $aliases = ['valid-alias', '', 'another-valid'];
-
- $runner->register($command, $aliases);
-
- $registeredAliases = $runner->getAliases();
-
- // Should register all non-empty aliases (empty string might still be registered)
- $this->assertArrayHasKey('valid-alias', $registeredAliases);
- $this->assertArrayHasKey('another-valid', $registeredAliases);
-
- // Check that valid aliases point to correct command
- $this->assertEquals('no-alias', $registeredAliases['valid-alias']);
- $this->assertEquals('no-alias', $registeredAliases['another-valid']);
- }
-
- /**
- * Test alias resolution with case variations.
- * @test
- */
- public function testAliasResolutionCaseVariations() {
- $runner = new Runner();
- $command = new NoAliasCommand();
-
- $runner->register($command, ['Test', 'TEST', 'test']);
-
- // Each case variation should be treated separately
- $this->assertEquals('no-alias', $runner->resolveAlias('Test'));
- $this->assertEquals('no-alias', $runner->resolveAlias('TEST'));
- $this->assertEquals('no-alias', $runner->resolveAlias('test'));
-
- // Non-matching cases should return null
- $this->assertNull($runner->resolveAlias('tEsT'));
- $this->assertNull($runner->resolveAlias('TeSt'));
- }
-
- /**
- * Test command registration with duplicate aliases in same call.
- * @test
- */
- public function testDuplicateAliasesInSameRegistration() {
- $runner = new Runner();
- $runner->setOutputStream(new ArrayOutputStream());
- $command = new NoAliasCommand();
-
- // Register with duplicate aliases
- $runner->register($command, ['dup', 'unique', 'dup', 'another']);
-
- $aliases = $runner->getAliases();
-
- // Should handle duplicates gracefully
- $this->assertArrayHasKey('dup', $aliases);
- $this->assertArrayHasKey('unique', $aliases);
- $this->assertArrayHasKey('another', $aliases);
- $this->assertEquals('no-alias', $aliases['dup']);
-
- // Check output contains expected warning
- $output = $runner->getOutputStream()->getOutputArray();
- $expectedOutput = ["Warning: Alias 'dup' already exists for command 'no-alias'. Ignoring new alias for 'no-alias'.\n"];
- $this->assertEquals($expectedOutput, $output);
- }
-
- /**
- * Test alias functionality after runner reset and re-registration.
- * @test
- */
- public function testAliasAfterResetAndReregistration() {
- $runner = new Runner();
- $command = new AliasTestCommand();
-
- // Initial registration
- $runner->register($command, ['extra']);
- $this->assertTrue($runner->hasAlias('test'));
- $this->assertTrue($runner->hasAlias('extra'));
-
- // Reset
- $runner->reset();
- $this->assertFalse($runner->hasAlias('test'));
- $this->assertFalse($runner->hasAlias('extra'));
-
- // Re-register with different aliases using a fresh command instance
- $freshCommand = new AliasTestCommand();
- $runner->register($freshCommand, ['new-alias']);
- $this->assertTrue($runner->hasAlias('test')); // Built-in alias
- $this->assertTrue($runner->hasAlias('new-alias')); // New runtime alias
- $this->assertFalse($runner->hasAlias('extra')); // Old runtime alias should be gone
- }
-}
+setInputStream(new ArrayInputStream([]));
+ $runner->setOutputStream(new ArrayOutputStream());
+
+ $aliasCommand = new AliasTestCommand();
+ // Don't register HelpCommand - it's automatically registered by Runner constructor
+
+ $runner->register($aliasCommand);
+
+ // Test help for command via direct name (not alias, as help might not resolve aliases)
+ $runner->setArgsVector(['script.php', 'help', '--command=alias-test']);
+ $exitCode = $runner->start();
+
+ $output = $runner->getOutputStream()->getOutputArray();
+ $this->assertEquals(0, $exitCode);
+
+ // Should show help for the actual command
+ $helpOutput = implode('', $output);
+ $this->assertStringContainsString('alias-test:', $helpOutput);
+ }
+
+ /**
+ * Test multiple aliases pointing to same command in help.
+ * @test
+ */
+ public function testMultipleAliasesInHelp() {
+ $runner = new Runner();
+ $runner->setInputStream(new ArrayInputStream([]));
+ $runner->setOutputStream(new ArrayOutputStream());
+
+ $command = new AliasTestCommand(); // Has aliases: 'test', 'at'
+ // Don't register HelpCommand - it's automatically registered by Runner constructor
+
+ $runner->register($command, ['extra-alias']); // Add runtime alias
+
+ // Get general help
+ $runner->setArgsVector(['script.php', 'help']);
+ $exitCode = $runner->start();
+
+ $output = $runner->getOutputStream()->getOutputArray();
+ $this->assertEquals(0, $exitCode);
+
+ $helpOutput = implode('', $output);
+ // Should show the main command name
+ $this->assertStringContainsString('alias-test:', $helpOutput);
+ }
+
+ /**
+ * Test alias resolution performance with many aliases.
+ * @test
+ */
+ public function testAliasResolutionPerformance() {
+ $runner = new Runner();
+
+ // Create one command with many aliases to avoid conflicts
+ $command = new NoAliasCommand();
+ $aliases = [];
+ for ($i = 1; $i <= 50; $i++) {
+ $aliases[] = "perf_alias$i";
+ $aliases[] = "perf_a$i";
+ $aliases[] = "perf_cmd$i";
+ }
+ $runner->register($command, $aliases);
+
+ // Test resolution performance
+ $start = microtime(true);
+ for ($i = 1; $i <= 50; $i++) {
+ $this->assertEquals('no-alias', $runner->resolveAlias("perf_alias$i"));
+ $this->assertEquals('no-alias', $runner->resolveAlias("perf_a$i"));
+ $this->assertEquals('no-alias', $runner->resolveAlias("perf_cmd$i"));
+ }
+ $end = microtime(true);
+
+ // Should resolve quickly (less than 0.1 seconds for 150 lookups)
+ $this->assertLessThan(0.1, $end - $start);
+ }
+
+ /**
+ * Test alias with special argument patterns.
+ * @test
+ */
+ public function testAliasWithArguments() {
+ $runner = new Runner();
+ $runner->setInputStream(new ArrayInputStream([]));
+ $runner->setOutputStream(new ArrayOutputStream());
+
+ $command = new AliasTestCommand();
+ $runner->register($command);
+
+ // Test alias with arguments
+ $runner->setArgsVector(['script.php', 'test', '--some-arg=value']);
+ $exitCode = $runner->start();
+
+ $output = $runner->getOutputStream()->getOutputArray();
+ $this->assertEquals(0, $exitCode);
+ $this->assertEquals(["Alias test command executed\n"], $output);
+ }
+
+ /**
+ * Test alias registration order doesn't affect functionality.
+ * @test
+ */
+ public function testAliasRegistrationOrder() {
+ $runner1 = new Runner();
+ $runner2 = new Runner();
+
+ $command1 = new AliasTestCommand();
+ $command2 = new NoAliasCommand();
+
+ // Register in different orders
+ $runner1->register($command1);
+ $runner1->register($command2, ['test2']);
+
+ $runner2->register($command2, ['test2']);
+ $runner2->register($command1);
+
+ // Both should have same aliases
+ $aliases1 = $runner1->getAliases();
+ $aliases2 = $runner2->getAliases();
+
+ $this->assertEquals($aliases1['test'], $aliases2['test']);
+ $this->assertEquals($aliases1['at'], $aliases2['at']);
+ $this->assertEquals($aliases1['test2'], $aliases2['test2']);
+ }
+
+ /**
+ * Test alias with empty string handling.
+ * @test
+ */
+ public function testAliasEdgeCases() {
+ $runner = new Runner();
+ $command = new NoAliasCommand();
+
+ // Test with empty strings in aliases array
+ $aliases = ['valid-alias', '', 'another-valid'];
+
+ $runner->register($command, $aliases);
+
+ $registeredAliases = $runner->getAliases();
+
+ // Should register all non-empty aliases (empty string might still be registered)
+ $this->assertArrayHasKey('valid-alias', $registeredAliases);
+ $this->assertArrayHasKey('another-valid', $registeredAliases);
+
+ // Check that valid aliases point to correct command
+ $this->assertEquals('no-alias', $registeredAliases['valid-alias']);
+ $this->assertEquals('no-alias', $registeredAliases['another-valid']);
+ }
+
+ /**
+ * Test alias resolution with case variations.
+ * @test
+ */
+ public function testAliasResolutionCaseVariations() {
+ $runner = new Runner();
+ $command = new NoAliasCommand();
+
+ $runner->register($command, ['Test', 'TEST', 'test']);
+
+ // Each case variation should be treated separately
+ $this->assertEquals('no-alias', $runner->resolveAlias('Test'));
+ $this->assertEquals('no-alias', $runner->resolveAlias('TEST'));
+ $this->assertEquals('no-alias', $runner->resolveAlias('test'));
+
+ // Non-matching cases should return null
+ $this->assertNull($runner->resolveAlias('tEsT'));
+ $this->assertNull($runner->resolveAlias('TeSt'));
+ }
+
+ /**
+ * Test command registration with duplicate aliases in same call.
+ * @test
+ */
+ public function testDuplicateAliasesInSameRegistration() {
+ $runner = new Runner();
+ $runner->setOutputStream(new ArrayOutputStream());
+ $command = new NoAliasCommand();
+
+ // Register with duplicate aliases
+ $runner->register($command, ['dup', 'unique', 'dup', 'another']);
+
+ $aliases = $runner->getAliases();
+
+ // Should handle duplicates gracefully
+ $this->assertArrayHasKey('dup', $aliases);
+ $this->assertArrayHasKey('unique', $aliases);
+ $this->assertArrayHasKey('another', $aliases);
+ $this->assertEquals('no-alias', $aliases['dup']);
+
+ // Check output contains expected warning
+ $output = $runner->getOutputStream()->getOutputArray();
+ $expectedOutput = ["Warning: Alias 'dup' already exists for command 'no-alias'. Ignoring new alias for 'no-alias'.\n"];
+ $this->assertEquals($expectedOutput, $output);
+ }
+
+ /**
+ * Test alias functionality after runner reset and re-registration.
+ * @test
+ */
+ public function testAliasAfterResetAndReregistration() {
+ $runner = new Runner();
+ $command = new AliasTestCommand();
+
+ // Initial registration
+ $runner->register($command, ['extra']);
+ $this->assertTrue($runner->hasAlias('test'));
+ $this->assertTrue($runner->hasAlias('extra'));
+
+ // Reset
+ $runner->reset();
+ $this->assertFalse($runner->hasAlias('test'));
+ $this->assertFalse($runner->hasAlias('extra'));
+
+ // Re-register with different aliases using a fresh command instance
+ $freshCommand = new AliasTestCommand();
+ $runner->register($freshCommand, ['new-alias']);
+ $this->assertTrue($runner->hasAlias('test')); // Built-in alias
+ $this->assertTrue($runner->hasAlias('new-alias')); // New runtime alias
+ $this->assertFalse($runner->hasAlias('extra')); // Old runtime alias should be gone
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/AliasingTest.php b/tests/WebFiori/Tests/Cli/AliasingTest.php
index f341ea5..053ddd8 100644
--- a/tests/WebFiori/Tests/Cli/AliasingTest.php
+++ b/tests/WebFiori/Tests/Cli/AliasingTest.php
@@ -1,417 +1,417 @@
-register($command);
-
- // Test that aliases are registered
- $aliases = $runner->getAliases();
- $this->assertArrayHasKey('test', $aliases);
- $this->assertArrayHasKey('at', $aliases);
- $this->assertEquals('alias-test', $aliases['test']);
- $this->assertEquals('alias-test', $aliases['at']);
-
- // Test alias resolution
- $this->assertEquals('alias-test', $runner->resolveAlias('test'));
- $this->assertEquals('alias-test', $runner->resolveAlias('at'));
- $this->assertNull($runner->resolveAlias('nonexistent'));
-
- // Test hasAlias method
- $this->assertTrue($runner->hasAlias('test'));
- $this->assertTrue($runner->hasAlias('at'));
- $this->assertFalse($runner->hasAlias('nonexistent'));
- }
-
- /**
- * Test runtime alias registration.
- * @test
- */
- public function testRuntimeAliasRegistration() {
- $runner = new Runner();
- $command = new NoAliasCommand();
-
- // Register command with runtime aliases
- $runner->register($command, ['na', 'noalias']);
-
- $aliases = $runner->getAliases();
- $this->assertArrayHasKey('na', $aliases);
- $this->assertArrayHasKey('noalias', $aliases);
- $this->assertEquals('no-alias', $aliases['na']);
- $this->assertEquals('no-alias', $aliases['noalias']);
- }
-
- /**
- * Test combined built-in and runtime aliases.
- * @test
- */
- public function testCombinedAliases() {
- $runner = new Runner();
- $command = new AliasTestCommand(); // Has built-in aliases: 'test', 'at'
-
- // Register with additional runtime aliases
- $runner->register($command, ['alias', 'testing']);
-
- $aliases = $runner->getAliases();
-
- // Check built-in aliases
- $this->assertArrayHasKey('test', $aliases);
- $this->assertArrayHasKey('at', $aliases);
-
- // Check runtime aliases
- $this->assertArrayHasKey('alias', $aliases);
- $this->assertArrayHasKey('testing', $aliases);
-
- // All should point to the same command
- $this->assertEquals('alias-test', $aliases['test']);
- $this->assertEquals('alias-test', $aliases['at']);
- $this->assertEquals('alias-test', $aliases['alias']);
- $this->assertEquals('alias-test', $aliases['testing']);
- }
-
- /**
- * Test command execution via aliases.
- * @test
- */
- public function testCommandExecutionViaAlias() {
- $command = new AliasTestCommand();
-
- // Test execution via built-in alias
- $output = $this->executeSingleCommand($command, ['test']);
- $this->assertEquals(["Alias test command executed\n"], $output);
- $this->assertEquals(0, $this->getExitCode());
-
- // Test execution via another built-in alias
- $output = $this->executeSingleCommand($command, ['at']);
- $this->assertEquals(["Alias test command executed\n"], $output);
- $this->assertEquals(0, $this->getExitCode());
- }
-
- /**
- * Test command execution via runtime aliases.
- * @test
- */
- public function testCommandExecutionViaRuntimeAlias() {
- $runner = new Runner();
- $runner->setInputStream(new ArrayInputStream([]));
- $runner->setOutputStream(new ArrayOutputStream());
-
- $command = new NoAliasCommand();
- $runner->register($command, ['na']);
-
- // Set arguments vector to execute the alias (first element is script name)
- $runner->setArgsVector(['script.php', 'na']);
- $exitCode = $runner->start();
-
- $output = $runner->getOutputStream()->getOutputArray();
- // The output may include a warning about duplicate alias, followed by the command output
- $expectedOutput = ["No alias command executed\n"];
- if (count($output) > 1 && strpos($output[0], 'Warning: Alias') === 0) {
- // If there's a warning about duplicate alias, check the second element
- $this->assertEquals($expectedOutput[0], $output[1]);
- } else {
- // If no warning, check the first element
- $this->assertEquals($expectedOutput, $output);
- }
- $this->assertEquals(0, $exitCode);
- }
-
- /**
- * Test alias conflict resolution in non-interactive mode.
- * @test
- */
- public function testAliasConflictNonInteractive() {
- $runner = new Runner();
- $runner->setOutputStream(new ArrayOutputStream());
-
- $command1 = new AliasTestCommand(); // Has alias 'test'
- $command2 = new ConflictTestCommand(); // Also has alias 'test'
-
- $runner->register($command1);
- $runner->register($command2); // This should trigger conflict warning
-
- $aliases = $runner->getAliases();
-
- // First command should keep the alias
- $this->assertEquals('alias-test', $aliases['test']);
-
- // Check that warning was issued
- $output = $runner->getOutputStream()->getOutputArray();
- $warningFound = false;
- foreach ($output as $line) {
- if (strpos($line, "Warning: Alias 'test' already exists") !== false) {
- $warningFound = true;
- break;
- }
- }
- $this->assertTrue($warningFound, 'Expected warning message about alias conflict');
- }
-
- /**
- * Test alias conflict resolution in interactive mode.
- * @test
- */
- public function testAliasConflictInteractive() {
- $runner = new Runner();
- $runner->setInputStream(new ArrayInputStream(['2'])); // Choose second option
- $runner->setOutputStream(new ArrayOutputStream());
-
- $command1 = new AliasTestCommand(); // Has alias 'test'
- $command2 = new ConflictTestCommand(); // Also has alias 'test'
-
- $runner->register($command1);
- $runner->register($command2); // This should trigger interactive conflict resolution
-
- $aliases = $runner->getAliases();
-
- // In non-interactive mode, first command should keep the alias
- // (Interactive conflict resolution might not be fully implemented yet)
- $this->assertEquals('alias-test', $aliases['test']);
- }
-
- /**
- * Test getCommandByName with aliases.
- * @test
- */
- public function testGetCommandByNameWithAliases() {
- $runner = new Runner();
- $command = new AliasTestCommand();
-
- $runner->register($command);
-
- // Test direct command name
- $retrievedCommand = $runner->getCommandByName('alias-test');
- $this->assertSame($command, $retrievedCommand);
-
- // Test via aliases
- $retrievedCommand = $runner->getCommandByName('test');
- $this->assertSame($command, $retrievedCommand);
-
- $retrievedCommand = $runner->getCommandByName('at');
- $this->assertSame($command, $retrievedCommand);
-
- // Test non-existent
- $retrievedCommand = $runner->getCommandByName('nonexistent');
- $this->assertNull($retrievedCommand);
- }
-
- /**
- * Test reset functionality clears aliases.
- * @test
- */
- public function testResetClearsAliases() {
- $runner = new Runner();
- $command = new AliasTestCommand();
-
- $runner->register($command);
-
- // Verify aliases exist
- $this->assertNotEmpty($runner->getAliases());
- $this->assertTrue($runner->hasAlias('test'));
-
- // Reset and verify aliases are cleared
- $runner->reset();
- // Should only contain help command aliases, not the custom 'test' alias
- $this->assertFalse($runner->hasAlias('test'));
- // Help command should have its -h alias
- $this->assertTrue($runner->hasAlias('-h'));
- }
-
- /**
- * Test command getAliases method.
- * @test
- */
- public function testCommandGetAliases() {
- $command = new AliasTestCommand();
- $aliases = $command->getAliases();
-
- $this->assertIsArray($aliases);
- $this->assertContains('test', $aliases);
- $this->assertContains('at', $aliases);
- $this->assertCount(2, $aliases);
-
- // Test command without aliases
- $noAliasCommand = new NoAliasCommand();
- $noAliases = $noAliasCommand->getAliases();
- $this->assertIsArray($noAliases);
- $this->assertEmpty($noAliases);
- }
-
- /**
- * Test multiple commands with different aliases.
- * @test
- */
- public function testMultipleCommandsWithDifferentAliases() {
- $runner = new Runner();
-
- $command1 = new AliasTestCommand(); // aliases: 'test', 'at'
- $command2 = new NoAliasCommand();
-
- $runner->register($command1);
- $runner->register($command2, ['na', 'no']);
-
- $aliases = $runner->getAliases();
-
- // Check all aliases are registered correctly
- $this->assertEquals('alias-test', $aliases['test']);
- $this->assertEquals('alias-test', $aliases['at']);
- $this->assertEquals('no-alias', $aliases['na']);
- $this->assertEquals('no-alias', $aliases['no']);
-
- // Test command retrieval via different aliases
- $this->assertSame($command1, $runner->getCommandByName('test'));
- $this->assertSame($command1, $runner->getCommandByName('at'));
- $this->assertSame($command2, $runner->getCommandByName('na'));
- $this->assertSame($command2, $runner->getCommandByName('no'));
- }
-
- /**
- * Test alias priority (direct command name vs alias).
- * @test
- */
- public function testAliasPriority() {
- $runner = new Runner();
- $command1 = new AliasTestCommand(); // name: 'alias-test'
- $command2 = new NoAliasCommand(); // name: 'no-alias'
-
- $runner->register($command1);
- // Register command2 with alias that matches command1's name
- $runner->register($command2, ['alias-test']);
-
- // Direct command name should take priority over alias
- $retrievedCommand = $runner->getCommandByName('alias-test');
- $this->assertSame($command1, $retrievedCommand, 'Direct command name should take priority over alias');
- }
-
- /**
- * Test empty aliases array.
- * @test
- */
- public function testEmptyAliasesArray() {
- $runner = new Runner();
- $command = new NoAliasCommand();
-
- // Register with empty aliases array
- $runner->register($command, []);
-
- $aliases = $runner->getAliases();
- // Account for default help alias that's automatically registered
- $expectedAliases = ['-h' => 'help'];
- $this->assertEquals($expectedAliases, $aliases);
- }
-
- /**
- * Test alias with special characters.
- * @test
- */
- public function testAliasWithSpecialCharacters() {
- $runner = new Runner();
- $command = new NoAliasCommand();
-
- // Register with special character aliases
- $runner->register($command, ['?', 'h', 'help-me']);
-
- $aliases = $runner->getAliases();
- $this->assertArrayHasKey('?', $aliases);
- $this->assertArrayHasKey('h', $aliases);
- $this->assertArrayHasKey('help-me', $aliases);
-
- // Test command retrieval
- $this->assertSame($command, $runner->getCommandByName('?'));
- $this->assertSame($command, $runner->getCommandByName('h'));
- $this->assertSame($command, $runner->getCommandByName('help-me'));
- }
-
- /**
- * Test alias case sensitivity.
- * @test
- */
- public function testAliasCaseSensitivity() {
- $runner = new Runner();
- $command = new NoAliasCommand();
-
- $runner->register($command, ['Test', 'TEST']);
-
- $aliases = $runner->getAliases();
- $this->assertArrayHasKey('Test', $aliases);
- $this->assertArrayHasKey('TEST', $aliases);
-
- // Test that they are treated as different aliases
- $this->assertSame($command, $runner->getCommandByName('Test'));
- $this->assertSame($command, $runner->getCommandByName('TEST'));
- $this->assertNull($runner->getCommandByName('test')); // lowercase should not match
- }
-
- /**
- * Test large number of aliases.
- * @test
- */
- public function testLargeNumberOfAliases() {
- $runner = new Runner();
- $command = new NoAliasCommand();
-
- // Create many aliases
- $manyAliases = [];
- for ($i = 1; $i <= 100; $i++) {
- $manyAliases[] = "alias$i";
- }
-
- $runner->register($command, $manyAliases);
-
- $aliases = $runner->getAliases();
- // Account for default help alias (100 + 1 = 101)
- $this->assertCount(101, $aliases);
-
- // Test a few random aliases
- $this->assertEquals('no-alias', $aliases['alias1']);
- $this->assertEquals('no-alias', $aliases['alias50']);
- $this->assertEquals('no-alias', $aliases['alias100']);
-
- // Test command retrieval
- $this->assertSame($command, $runner->getCommandByName('alias1'));
- $this->assertSame($command, $runner->getCommandByName('alias50'));
- $this->assertSame($command, $runner->getCommandByName('alias100'));
- }
-
- /**
- * Test backward compatibility - existing code should work unchanged.
- * @test
- */
- public function testBackwardCompatibility() {
- $runner = new Runner();
- $command = new NoAliasCommand();
-
- // Old way of registering (without aliases parameter)
- $runner->register($command);
-
- // Should work exactly as before
- $this->assertSame($command, $runner->getCommandByName('no-alias'));
- // Account for default help alias
- $expectedAliases = ['-h' => 'help'];
- $this->assertEquals($expectedAliases, $runner->getAliases());
-
- // Command execution should work
- $output = $this->executeSingleCommand($command, ['no-alias']);
- $this->assertEquals(["No alias command executed\n"], $output);
- $this->assertEquals(0, $this->getExitCode());
- }
-}
+register($command);
+
+ // Test that aliases are registered
+ $aliases = $runner->getAliases();
+ $this->assertArrayHasKey('test', $aliases);
+ $this->assertArrayHasKey('at', $aliases);
+ $this->assertEquals('alias-test', $aliases['test']);
+ $this->assertEquals('alias-test', $aliases['at']);
+
+ // Test alias resolution
+ $this->assertEquals('alias-test', $runner->resolveAlias('test'));
+ $this->assertEquals('alias-test', $runner->resolveAlias('at'));
+ $this->assertNull($runner->resolveAlias('nonexistent'));
+
+ // Test hasAlias method
+ $this->assertTrue($runner->hasAlias('test'));
+ $this->assertTrue($runner->hasAlias('at'));
+ $this->assertFalse($runner->hasAlias('nonexistent'));
+ }
+
+ /**
+ * Test runtime alias registration.
+ * @test
+ */
+ public function testRuntimeAliasRegistration() {
+ $runner = new Runner();
+ $command = new NoAliasCommand();
+
+ // Register command with runtime aliases
+ $runner->register($command, ['na', 'noalias']);
+
+ $aliases = $runner->getAliases();
+ $this->assertArrayHasKey('na', $aliases);
+ $this->assertArrayHasKey('noalias', $aliases);
+ $this->assertEquals('no-alias', $aliases['na']);
+ $this->assertEquals('no-alias', $aliases['noalias']);
+ }
+
+ /**
+ * Test combined built-in and runtime aliases.
+ * @test
+ */
+ public function testCombinedAliases() {
+ $runner = new Runner();
+ $command = new AliasTestCommand(); // Has built-in aliases: 'test', 'at'
+
+ // Register with additional runtime aliases
+ $runner->register($command, ['alias', 'testing']);
+
+ $aliases = $runner->getAliases();
+
+ // Check built-in aliases
+ $this->assertArrayHasKey('test', $aliases);
+ $this->assertArrayHasKey('at', $aliases);
+
+ // Check runtime aliases
+ $this->assertArrayHasKey('alias', $aliases);
+ $this->assertArrayHasKey('testing', $aliases);
+
+ // All should point to the same command
+ $this->assertEquals('alias-test', $aliases['test']);
+ $this->assertEquals('alias-test', $aliases['at']);
+ $this->assertEquals('alias-test', $aliases['alias']);
+ $this->assertEquals('alias-test', $aliases['testing']);
+ }
+
+ /**
+ * Test command execution via aliases.
+ * @test
+ */
+ public function testCommandExecutionViaAlias() {
+ $command = new AliasTestCommand();
+
+ // Test execution via built-in alias
+ $output = $this->executeSingleCommand($command, ['test']);
+ $this->assertEquals(["Alias test command executed\n"], $output);
+ $this->assertEquals(0, $this->getExitCode());
+
+ // Test execution via another built-in alias
+ $output = $this->executeSingleCommand($command, ['at']);
+ $this->assertEquals(["Alias test command executed\n"], $output);
+ $this->assertEquals(0, $this->getExitCode());
+ }
+
+ /**
+ * Test command execution via runtime aliases.
+ * @test
+ */
+ public function testCommandExecutionViaRuntimeAlias() {
+ $runner = new Runner();
+ $runner->setInputStream(new ArrayInputStream([]));
+ $runner->setOutputStream(new ArrayOutputStream());
+
+ $command = new NoAliasCommand();
+ $runner->register($command, ['na']);
+
+ // Set arguments vector to execute the alias (first element is script name)
+ $runner->setArgsVector(['script.php', 'na']);
+ $exitCode = $runner->start();
+
+ $output = $runner->getOutputStream()->getOutputArray();
+ // The output may include a warning about duplicate alias, followed by the command output
+ $expectedOutput = ["No alias command executed\n"];
+ if (count($output) > 1 && strpos($output[0], 'Warning: Alias') === 0) {
+ // If there's a warning about duplicate alias, check the second element
+ $this->assertEquals($expectedOutput[0], $output[1]);
+ } else {
+ // If no warning, check the first element
+ $this->assertEquals($expectedOutput, $output);
+ }
+ $this->assertEquals(0, $exitCode);
+ }
+
+ /**
+ * Test alias conflict resolution in non-interactive mode.
+ * @test
+ */
+ public function testAliasConflictNonInteractive() {
+ $runner = new Runner();
+ $runner->setOutputStream(new ArrayOutputStream());
+
+ $command1 = new AliasTestCommand(); // Has alias 'test'
+ $command2 = new ConflictTestCommand(); // Also has alias 'test'
+
+ $runner->register($command1);
+ $runner->register($command2); // This should trigger conflict warning
+
+ $aliases = $runner->getAliases();
+
+ // First command should keep the alias
+ $this->assertEquals('alias-test', $aliases['test']);
+
+ // Check that warning was issued
+ $output = $runner->getOutputStream()->getOutputArray();
+ $warningFound = false;
+ foreach ($output as $line) {
+ if (strpos($line, "Warning: Alias 'test' already exists") !== false) {
+ $warningFound = true;
+ break;
+ }
+ }
+ $this->assertTrue($warningFound, 'Expected warning message about alias conflict');
+ }
+
+ /**
+ * Test alias conflict resolution in interactive mode.
+ * @test
+ */
+ public function testAliasConflictInteractive() {
+ $runner = new Runner();
+ $runner->setInputStream(new ArrayInputStream(['2'])); // Choose second option
+ $runner->setOutputStream(new ArrayOutputStream());
+
+ $command1 = new AliasTestCommand(); // Has alias 'test'
+ $command2 = new ConflictTestCommand(); // Also has alias 'test'
+
+ $runner->register($command1);
+ $runner->register($command2); // This should trigger interactive conflict resolution
+
+ $aliases = $runner->getAliases();
+
+ // In non-interactive mode, first command should keep the alias
+ // (Interactive conflict resolution might not be fully implemented yet)
+ $this->assertEquals('alias-test', $aliases['test']);
+ }
+
+ /**
+ * Test getCommandByName with aliases.
+ * @test
+ */
+ public function testGetCommandByNameWithAliases() {
+ $runner = new Runner();
+ $command = new AliasTestCommand();
+
+ $runner->register($command);
+
+ // Test direct command name
+ $retrievedCommand = $runner->getCommandByName('alias-test');
+ $this->assertSame($command, $retrievedCommand);
+
+ // Test via aliases
+ $retrievedCommand = $runner->getCommandByName('test');
+ $this->assertSame($command, $retrievedCommand);
+
+ $retrievedCommand = $runner->getCommandByName('at');
+ $this->assertSame($command, $retrievedCommand);
+
+ // Test non-existent
+ $retrievedCommand = $runner->getCommandByName('nonexistent');
+ $this->assertNull($retrievedCommand);
+ }
+
+ /**
+ * Test reset functionality clears aliases.
+ * @test
+ */
+ public function testResetClearsAliases() {
+ $runner = new Runner();
+ $command = new AliasTestCommand();
+
+ $runner->register($command);
+
+ // Verify aliases exist
+ $this->assertNotEmpty($runner->getAliases());
+ $this->assertTrue($runner->hasAlias('test'));
+
+ // Reset and verify aliases are cleared
+ $runner->reset();
+ // Should only contain help command aliases, not the custom 'test' alias
+ $this->assertFalse($runner->hasAlias('test'));
+ // Help command should have its -h alias
+ $this->assertTrue($runner->hasAlias('-h'));
+ }
+
+ /**
+ * Test command getAliases method.
+ * @test
+ */
+ public function testCommandGetAliases() {
+ $command = new AliasTestCommand();
+ $aliases = $command->getAliases();
+
+ $this->assertIsArray($aliases);
+ $this->assertContains('test', $aliases);
+ $this->assertContains('at', $aliases);
+ $this->assertCount(2, $aliases);
+
+ // Test command without aliases
+ $noAliasCommand = new NoAliasCommand();
+ $noAliases = $noAliasCommand->getAliases();
+ $this->assertIsArray($noAliases);
+ $this->assertEmpty($noAliases);
+ }
+
+ /**
+ * Test multiple commands with different aliases.
+ * @test
+ */
+ public function testMultipleCommandsWithDifferentAliases() {
+ $runner = new Runner();
+
+ $command1 = new AliasTestCommand(); // aliases: 'test', 'at'
+ $command2 = new NoAliasCommand();
+
+ $runner->register($command1);
+ $runner->register($command2, ['na', 'no']);
+
+ $aliases = $runner->getAliases();
+
+ // Check all aliases are registered correctly
+ $this->assertEquals('alias-test', $aliases['test']);
+ $this->assertEquals('alias-test', $aliases['at']);
+ $this->assertEquals('no-alias', $aliases['na']);
+ $this->assertEquals('no-alias', $aliases['no']);
+
+ // Test command retrieval via different aliases
+ $this->assertSame($command1, $runner->getCommandByName('test'));
+ $this->assertSame($command1, $runner->getCommandByName('at'));
+ $this->assertSame($command2, $runner->getCommandByName('na'));
+ $this->assertSame($command2, $runner->getCommandByName('no'));
+ }
+
+ /**
+ * Test alias priority (direct command name vs alias).
+ * @test
+ */
+ public function testAliasPriority() {
+ $runner = new Runner();
+ $command1 = new AliasTestCommand(); // name: 'alias-test'
+ $command2 = new NoAliasCommand(); // name: 'no-alias'
+
+ $runner->register($command1);
+ // Register command2 with alias that matches command1's name
+ $runner->register($command2, ['alias-test']);
+
+ // Direct command name should take priority over alias
+ $retrievedCommand = $runner->getCommandByName('alias-test');
+ $this->assertSame($command1, $retrievedCommand, 'Direct command name should take priority over alias');
+ }
+
+ /**
+ * Test empty aliases array.
+ * @test
+ */
+ public function testEmptyAliasesArray() {
+ $runner = new Runner();
+ $command = new NoAliasCommand();
+
+ // Register with empty aliases array
+ $runner->register($command, []);
+
+ $aliases = $runner->getAliases();
+ // Account for default help alias that's automatically registered
+ $expectedAliases = ['-h' => 'help'];
+ $this->assertEquals($expectedAliases, $aliases);
+ }
+
+ /**
+ * Test alias with special characters.
+ * @test
+ */
+ public function testAliasWithSpecialCharacters() {
+ $runner = new Runner();
+ $command = new NoAliasCommand();
+
+ // Register with special character aliases
+ $runner->register($command, ['?', 'h', 'help-me']);
+
+ $aliases = $runner->getAliases();
+ $this->assertArrayHasKey('?', $aliases);
+ $this->assertArrayHasKey('h', $aliases);
+ $this->assertArrayHasKey('help-me', $aliases);
+
+ // Test command retrieval
+ $this->assertSame($command, $runner->getCommandByName('?'));
+ $this->assertSame($command, $runner->getCommandByName('h'));
+ $this->assertSame($command, $runner->getCommandByName('help-me'));
+ }
+
+ /**
+ * Test alias case sensitivity.
+ * @test
+ */
+ public function testAliasCaseSensitivity() {
+ $runner = new Runner();
+ $command = new NoAliasCommand();
+
+ $runner->register($command, ['Test', 'TEST']);
+
+ $aliases = $runner->getAliases();
+ $this->assertArrayHasKey('Test', $aliases);
+ $this->assertArrayHasKey('TEST', $aliases);
+
+ // Test that they are treated as different aliases
+ $this->assertSame($command, $runner->getCommandByName('Test'));
+ $this->assertSame($command, $runner->getCommandByName('TEST'));
+ $this->assertNull($runner->getCommandByName('test')); // lowercase should not match
+ }
+
+ /**
+ * Test large number of aliases.
+ * @test
+ */
+ public function testLargeNumberOfAliases() {
+ $runner = new Runner();
+ $command = new NoAliasCommand();
+
+ // Create many aliases
+ $manyAliases = [];
+ for ($i = 1; $i <= 100; $i++) {
+ $manyAliases[] = "alias$i";
+ }
+
+ $runner->register($command, $manyAliases);
+
+ $aliases = $runner->getAliases();
+ // Account for default help alias (100 + 1 = 101)
+ $this->assertCount(101, $aliases);
+
+ // Test a few random aliases
+ $this->assertEquals('no-alias', $aliases['alias1']);
+ $this->assertEquals('no-alias', $aliases['alias50']);
+ $this->assertEquals('no-alias', $aliases['alias100']);
+
+ // Test command retrieval
+ $this->assertSame($command, $runner->getCommandByName('alias1'));
+ $this->assertSame($command, $runner->getCommandByName('alias50'));
+ $this->assertSame($command, $runner->getCommandByName('alias100'));
+ }
+
+ /**
+ * Test backward compatibility - existing code should work unchanged.
+ * @test
+ */
+ public function testBackwardCompatibility() {
+ $runner = new Runner();
+ $command = new NoAliasCommand();
+
+ // Old way of registering (without aliases parameter)
+ $runner->register($command);
+
+ // Should work exactly as before
+ $this->assertSame($command, $runner->getCommandByName('no-alias'));
+ // Account for default help alias
+ $expectedAliases = ['-h' => 'help'];
+ $this->assertEquals($expectedAliases, $runner->getAliases());
+
+ // Command execution should work
+ $output = $this->executeSingleCommand($command, ['no-alias']);
+ $this->assertEquals(["No alias command executed\n"], $output);
+ $this->assertEquals(0, $this->getExitCode());
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/ArrayInputStreamTest.php b/tests/WebFiori/Tests/Cli/ArrayInputStreamTest.php
index b3d0948..6488b7c 100644
--- a/tests/WebFiori/Tests/Cli/ArrayInputStreamTest.php
+++ b/tests/WebFiori/Tests/Cli/ArrayInputStreamTest.php
@@ -1,234 +1,234 @@
-assertEquals('o', $stream->read(1));
- $this->assertEquals('ne', $stream->readLine());
- $this->assertEquals('two', $stream->readLine());
- }
- /**
- * @test
- */
- public function test01() {
- $this->expectException(InvalidArgumentException::class);
- $this->expectExceptionMessage('Reached end of stream while trying to read line number 3');
- $stream = new ArrayInputStream([
- 'one',
- 'two'
- ]);
- $this->assertEquals('on', $stream->read(2));
- $this->assertEquals('e', $stream->readLine());
- $this->assertEquals('two', $stream->readLine());
- $stream->readLine();
- }
- /**
- * @test
- */
- public function test02() {
- $stream = new ArrayInputStream([
- 'one',
- 'two',
- 'Super cool',
- 'Multi line byte read',
- 'ok'
- ]);
- $this->assertEquals('on', $stream->read(2));
- $this->assertEquals('e', $stream->readLine());
- $this->assertEquals('two', $stream->readLine());
- $this->assertEquals('Super coolM', $stream->read(11));
- $this->assertEquals('ul', $stream->read(2));
- $this->assertEquals('t', $stream->read(1));
- $this->assertEquals('i line byte read', $stream->readLine());
- $this->assertEquals('ok', $stream->readLine());
- }
- /**
- * @test
- */
- public function test03() {
- $this->expectException(InvalidArgumentException::class);
- $this->expectExceptionMessage('Reached end of stream while trying to read 1 byte(s).');
- $stream = new ArrayInputStream([
- 'one',
- 'two'
- ]);
- $this->assertEquals('on', $stream->read(2));
- $this->assertEquals('e', $stream->readLine());
- $this->assertEquals('t', $stream->read());
- $this->assertEquals('w', $stream->read());
- $this->assertEquals('o', $stream->read());
-
- $stream->read();
- }
- /**
- * @test
- */
- public function test04() {
- $stream = new ArrayInputStream([
- 'on',
- 'tw',
- ]);
- $this->assertEquals('ontw', $stream->read(4));
- }
- /**
- * @test
- */
- public function test05() {
- $this->expectException(InvalidArgumentException::class);
- $this->expectExceptionMessage('Reached end of stream while trying to read 10 byte(s).');
-
- $stream = new ArrayInputStream([
- 'on',
- 'tw',
- 'three'
- ]);
- $this->assertEquals('ontwthree', $stream->read(10));
- }
- /**
- * @test
- */
- public function test06() {
- $this->expectException(InvalidArgumentException::class);
- $this->expectExceptionMessage('Bytes must be positive number.');
- $stream = new ArrayInputStream([
- 'on',
- ]);
- $this->assertEquals('', $stream->read(-1));
- }
- /**
- * @test
- */
- public function test07() {
- $stream = new ArrayInputStream([
- 'on',
- 'tw',
- ]);
- $this->assertEquals('ontw', $stream->read(4));
- $this->assertEquals('', $stream->readLine()); // This should read empty line after consuming all data
-
- // Now expect exception when trying to read beyond available data
- $this->expectException(InvalidArgumentException::class);
- $this->expectExceptionMessage('Reached end of stream while trying to read line number 3');
- $stream->readLine(); // This should throw exception
- }
- // ========== ENHANCED ARRAY INPUT STREAM TESTS ==========
-
- /**
- * Test ArrayInputStream comprehensive functionality
- * @test
- */
- public function testArrayInputStreamComprehensiveEnhanced() {
- $inputs = ['line1', 'line2', 'line3', ''];
- $stream = new ArrayInputStream($inputs);
-
- // Test reading lines
- $this->assertEquals('line1', $stream->readLine());
- $this->assertEquals('line2', $stream->readLine());
- $this->assertEquals('line3', $stream->readLine());
- $this->assertEquals('', $stream->readLine());
-
- // Test reading beyond available inputs (should throw exception)
- $this->expectException(\InvalidArgumentException::class);
- $stream->readLine(); // Should throw exception
- }
-
- /**
- * Test ArrayInputStream with byte reading
- * @test
- */
- public function testArrayInputStreamByteReading() {
- // Test reading with byte limit
- $stream2 = new ArrayInputStream(['hello world']);
- $this->assertEquals('hello', $stream2->read(5));
- $this->assertEquals(' worl', $stream2->read(5));
- $this->assertEquals('d', $stream2->read(1)); // Read only remaining character
-
- // Test reading beyond available data should throw exception
- $this->expectException(\InvalidArgumentException::class);
- $stream2->read(1); // Should throw exception
- }
-
- /**
- * Test ArrayInputStream edge cases
- * @test
- */
- public function testArrayInputStreamEdgeCasesEnhanced() {
- // Test empty stream
- $emptyStream = new ArrayInputStream([]);
-
- // Test reading from empty stream should throw exception
- $this->expectException(\InvalidArgumentException::class);
- $emptyStream->readLine(); // Should throw exception
- }
-
- /**
- * Test ArrayInputStream with special values
- * @test
- */
- public function testArrayInputStreamSpecialValues() {
- // Test with null values in array - handle null properly
- $nullStream = new ArrayInputStream(['', 'valid', '']); // Use empty strings instead of null
- $this->assertEquals('', $nullStream->readLine()); // empty string
- $this->assertEquals('valid', $nullStream->readLine());
- $this->assertEquals('', $nullStream->readLine()); // empty string
-
- // Test with numeric values
- $numericStream = new ArrayInputStream(['123', '45.67', '1', '']); // Convert to strings
- $this->assertEquals('123', $numericStream->readLine());
- $this->assertEquals('45.67', $numericStream->readLine());
- $this->assertEquals('1', $numericStream->readLine());
- $this->assertEquals('', $numericStream->readLine());
-
- // Test with very long strings
- $longString = str_repeat('a', 1000); // Reduced from 10000 for performance
- $longStream = new ArrayInputStream([$longString]);
- $this->assertEquals($longString, $longStream->readLine());
- }
-
- /**
- * Test ArrayInputStream performance with large data
- * @test
- */
- public function testArrayInputStreamPerformanceEnhanced() {
- // Test ArrayInputStream performance with reasonable size
- $largeInputArray = array_fill(0, 1000, 'Performance test line'); // Reduced from 10000
- $arrayStream = new ArrayInputStream($largeInputArray);
-
- $startTime = microtime(true);
- $lineCount = 0;
-
- // Fixed: Proper loop with exception handling
- try {
- while (true) {
- $line = $arrayStream->readLine();
- if ($line !== '') {
- $lineCount++;
- } else {
- $lineCount++; // Count empty lines too
- }
- }
- } catch (\InvalidArgumentException $e) {
- // Expected when reaching end of stream
- }
-
- $arrayTime = microtime(true) - $startTime;
-
- $this->assertEquals(1000, $lineCount);
- $this->assertLessThan(1.0, $arrayTime); // Should complete within 1 second
- }
-}
+assertEquals('o', $stream->read(1));
+ $this->assertEquals('ne', $stream->readLine());
+ $this->assertEquals('two', $stream->readLine());
+ }
+ /**
+ * @test
+ */
+ public function test01() {
+ $this->expectException(InvalidArgumentException::class);
+ $this->expectExceptionMessage('Reached end of stream while trying to read line number 3');
+ $stream = new ArrayInputStream([
+ 'one',
+ 'two'
+ ]);
+ $this->assertEquals('on', $stream->read(2));
+ $this->assertEquals('e', $stream->readLine());
+ $this->assertEquals('two', $stream->readLine());
+ $stream->readLine();
+ }
+ /**
+ * @test
+ */
+ public function test02() {
+ $stream = new ArrayInputStream([
+ 'one',
+ 'two',
+ 'Super cool',
+ 'Multi line byte read',
+ 'ok'
+ ]);
+ $this->assertEquals('on', $stream->read(2));
+ $this->assertEquals('e', $stream->readLine());
+ $this->assertEquals('two', $stream->readLine());
+ $this->assertEquals('Super coolM', $stream->read(11));
+ $this->assertEquals('ul', $stream->read(2));
+ $this->assertEquals('t', $stream->read(1));
+ $this->assertEquals('i line byte read', $stream->readLine());
+ $this->assertEquals('ok', $stream->readLine());
+ }
+ /**
+ * @test
+ */
+ public function test03() {
+ $this->expectException(InvalidArgumentException::class);
+ $this->expectExceptionMessage('Reached end of stream while trying to read 1 byte(s).');
+ $stream = new ArrayInputStream([
+ 'one',
+ 'two'
+ ]);
+ $this->assertEquals('on', $stream->read(2));
+ $this->assertEquals('e', $stream->readLine());
+ $this->assertEquals('t', $stream->read());
+ $this->assertEquals('w', $stream->read());
+ $this->assertEquals('o', $stream->read());
+
+ $stream->read();
+ }
+ /**
+ * @test
+ */
+ public function test04() {
+ $stream = new ArrayInputStream([
+ 'on',
+ 'tw',
+ ]);
+ $this->assertEquals('ontw', $stream->read(4));
+ }
+ /**
+ * @test
+ */
+ public function test05() {
+ $this->expectException(InvalidArgumentException::class);
+ $this->expectExceptionMessage('Reached end of stream while trying to read 10 byte(s).');
+
+ $stream = new ArrayInputStream([
+ 'on',
+ 'tw',
+ 'three'
+ ]);
+ $this->assertEquals('ontwthree', $stream->read(10));
+ }
+ /**
+ * @test
+ */
+ public function test06() {
+ $this->expectException(InvalidArgumentException::class);
+ $this->expectExceptionMessage('Bytes must be positive number.');
+ $stream = new ArrayInputStream([
+ 'on',
+ ]);
+ $this->assertEquals('', $stream->read(-1));
+ }
+ /**
+ * @test
+ */
+ public function test07() {
+ $stream = new ArrayInputStream([
+ 'on',
+ 'tw',
+ ]);
+ $this->assertEquals('ontw', $stream->read(4));
+ $this->assertEquals('', $stream->readLine()); // This should read empty line after consuming all data
+
+ // Now expect exception when trying to read beyond available data
+ $this->expectException(InvalidArgumentException::class);
+ $this->expectExceptionMessage('Reached end of stream while trying to read line number 3');
+ $stream->readLine(); // This should throw exception
+ }
+ // ========== ENHANCED ARRAY INPUT STREAM TESTS ==========
+
+ /**
+ * Test ArrayInputStream comprehensive functionality
+ * @test
+ */
+ public function testArrayInputStreamComprehensiveEnhanced() {
+ $inputs = ['line1', 'line2', 'line3', ''];
+ $stream = new ArrayInputStream($inputs);
+
+ // Test reading lines
+ $this->assertEquals('line1', $stream->readLine());
+ $this->assertEquals('line2', $stream->readLine());
+ $this->assertEquals('line3', $stream->readLine());
+ $this->assertEquals('', $stream->readLine());
+
+ // Test reading beyond available inputs (should throw exception)
+ $this->expectException(\InvalidArgumentException::class);
+ $stream->readLine(); // Should throw exception
+ }
+
+ /**
+ * Test ArrayInputStream with byte reading
+ * @test
+ */
+ public function testArrayInputStreamByteReading() {
+ // Test reading with byte limit
+ $stream2 = new ArrayInputStream(['hello world']);
+ $this->assertEquals('hello', $stream2->read(5));
+ $this->assertEquals(' worl', $stream2->read(5));
+ $this->assertEquals('d', $stream2->read(1)); // Read only remaining character
+
+ // Test reading beyond available data should throw exception
+ $this->expectException(\InvalidArgumentException::class);
+ $stream2->read(1); // Should throw exception
+ }
+
+ /**
+ * Test ArrayInputStream edge cases
+ * @test
+ */
+ public function testArrayInputStreamEdgeCasesEnhanced() {
+ // Test empty stream
+ $emptyStream = new ArrayInputStream([]);
+
+ // Test reading from empty stream should throw exception
+ $this->expectException(\InvalidArgumentException::class);
+ $emptyStream->readLine(); // Should throw exception
+ }
+
+ /**
+ * Test ArrayInputStream with special values
+ * @test
+ */
+ public function testArrayInputStreamSpecialValues() {
+ // Test with null values in array - handle null properly
+ $nullStream = new ArrayInputStream(['', 'valid', '']); // Use empty strings instead of null
+ $this->assertEquals('', $nullStream->readLine()); // empty string
+ $this->assertEquals('valid', $nullStream->readLine());
+ $this->assertEquals('', $nullStream->readLine()); // empty string
+
+ // Test with numeric values
+ $numericStream = new ArrayInputStream(['123', '45.67', '1', '']); // Convert to strings
+ $this->assertEquals('123', $numericStream->readLine());
+ $this->assertEquals('45.67', $numericStream->readLine());
+ $this->assertEquals('1', $numericStream->readLine());
+ $this->assertEquals('', $numericStream->readLine());
+
+ // Test with very long strings
+ $longString = str_repeat('a', 1000); // Reduced from 10000 for performance
+ $longStream = new ArrayInputStream([$longString]);
+ $this->assertEquals($longString, $longStream->readLine());
+ }
+
+ /**
+ * Test ArrayInputStream performance with large data
+ * @test
+ */
+ public function testArrayInputStreamPerformanceEnhanced() {
+ // Test ArrayInputStream performance with reasonable size
+ $largeInputArray = array_fill(0, 1000, 'Performance test line'); // Reduced from 10000
+ $arrayStream = new ArrayInputStream($largeInputArray);
+
+ $startTime = microtime(true);
+ $lineCount = 0;
+
+ // Fixed: Proper loop with exception handling
+ try {
+ while (true) {
+ $line = $arrayStream->readLine();
+ if ($line !== '') {
+ $lineCount++;
+ } else {
+ $lineCount++; // Count empty lines too
+ }
+ }
+ } catch (\InvalidArgumentException $e) {
+ // Expected when reaching end of stream
+ }
+
+ $arrayTime = microtime(true) - $startTime;
+
+ $this->assertEquals(1000, $lineCount);
+ $this->assertLessThan(1.0, $arrayTime); // Should complete within 1 second
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/ArrayOutputStreamTest.php b/tests/WebFiori/Tests/Cli/ArrayOutputStreamTest.php
index f4f59f0..8cd6116 100644
--- a/tests/WebFiori/Tests/Cli/ArrayOutputStreamTest.php
+++ b/tests/WebFiori/Tests/Cli/ArrayOutputStreamTest.php
@@ -1,126 +1,126 @@
-assertEquals([], $stream->getOutputArray());
- $stream->println('Hello');
- $this->assertEquals([
- "Hello\n"
- ], $stream->getOutputArray());
- $stream->prints(' World!');
- $this->assertEquals([
- "Hello\n",
- " World!",
- ], $stream->getOutputArray());
- $stream->println('Good');
- $this->assertEquals([
- "Hello\n",
- " World!Good\n",
- ], $stream->getOutputArray());
- $stream->reset();
- $this->assertEquals([], $stream->getOutputArray());
- }
- // ========== ENHANCED ARRAY OUTPUT STREAM TESTS ==========
-
- /**
- * Test ArrayOutputStream comprehensive functionality
- * @test
- */
- public function testArrayOutputStreamComprehensiveEnhanced() {
- $stream = new ArrayOutputStream();
-
- // Test initial state
- $this->assertEmpty($stream->getOutputArray());
-
- // Test writing strings
- $stream->prints('Hello');
- $stream->prints(' ');
- $stream->prints('World');
-
- $output = $stream->getOutputArray();
- $this->assertNotEmpty($output);
- $this->assertEquals(['Hello World'], $output);
-
- // Test writing with println to create separate entries
- $stream->println(''); // This creates a new line and separates entries
- $stream->prints('New line');
-
- $output2 = $stream->getOutputArray();
- $this->assertCount(2, $output2);
- $this->assertEquals(["Hello World\n", 'New line'], $output2);
-
- // Test clearing output
- $stream->reset();
- $this->assertEmpty($stream->getOutputArray());
- }
-
- /**
- * Test ArrayOutputStream edge cases
- * @test
- */
- public function testArrayOutputStreamEdgeCasesEnhanced() {
- $stream = new ArrayOutputStream();
-
- // Test writing null
- $stream->prints("");
- $output = $stream->getOutputArray();
- $this->assertEquals([''], $output); // null should become empty string
-
- // Test writing numbers
- $stream->reset();
- $stream->prints(123);
- $stream->prints(45.67);
- $stream->prints(true);
- $stream->prints(false);
-
- $output2 = $stream->getOutputArray();
- $this->assertEquals(['12345.671'], $output2);
-
- // Test writing empty strings - consecutive prints calls are concatenated
- $stream->reset();
- $stream->prints('');
- $stream->prints('');
- $stream->prints('content');
-
- $output3 = $stream->getOutputArray();
- $this->assertEquals(['content'], $output3);
-
- // Test writing very long strings
- $longString = str_repeat('x', 10000);
- $stream->reset();
- $stream->prints($longString);
-
- $output4 = $stream->getOutputArray();
- $this->assertEquals([$longString], $output4);
- }
-
- /**
- * Test ArrayOutputStream performance
- * @test
- */
- public function testArrayOutputStreamPerformanceEnhanced() {
- // Test ArrayOutputStream performance
- $arrayOutputStream = new ArrayOutputStream();
-
- $startTime = microtime(true);
- for ($i = 0; $i < 10000; $i++) {
- $arrayOutputStream->prints("Performance test line $i\n");
- }
- $outputTime = microtime(true) - $startTime;
-
- $this->assertNotEmpty($arrayOutputStream->getOutputArray());
- $this->assertLessThan(1.0, $outputTime); // Should complete within 1 second
- }
+assertEquals([], $stream->getOutputArray());
+ $stream->println('Hello');
+ $this->assertEquals([
+ "Hello\n"
+ ], $stream->getOutputArray());
+ $stream->prints(' World!');
+ $this->assertEquals([
+ "Hello\n",
+ " World!",
+ ], $stream->getOutputArray());
+ $stream->println('Good');
+ $this->assertEquals([
+ "Hello\n",
+ " World!Good\n",
+ ], $stream->getOutputArray());
+ $stream->reset();
+ $this->assertEquals([], $stream->getOutputArray());
+ }
+ // ========== ENHANCED ARRAY OUTPUT STREAM TESTS ==========
+
+ /**
+ * Test ArrayOutputStream comprehensive functionality
+ * @test
+ */
+ public function testArrayOutputStreamComprehensiveEnhanced() {
+ $stream = new ArrayOutputStream();
+
+ // Test initial state
+ $this->assertEmpty($stream->getOutputArray());
+
+ // Test writing strings
+ $stream->prints('Hello');
+ $stream->prints(' ');
+ $stream->prints('World');
+
+ $output = $stream->getOutputArray();
+ $this->assertNotEmpty($output);
+ $this->assertEquals(['Hello World'], $output);
+
+ // Test writing with println to create separate entries
+ $stream->println(''); // This creates a new line and separates entries
+ $stream->prints('New line');
+
+ $output2 = $stream->getOutputArray();
+ $this->assertCount(2, $output2);
+ $this->assertEquals(["Hello World\n", 'New line'], $output2);
+
+ // Test clearing output
+ $stream->reset();
+ $this->assertEmpty($stream->getOutputArray());
+ }
+
+ /**
+ * Test ArrayOutputStream edge cases
+ * @test
+ */
+ public function testArrayOutputStreamEdgeCasesEnhanced() {
+ $stream = new ArrayOutputStream();
+
+ // Test writing null
+ $stream->prints("");
+ $output = $stream->getOutputArray();
+ $this->assertEquals([''], $output); // null should become empty string
+
+ // Test writing numbers
+ $stream->reset();
+ $stream->prints(123);
+ $stream->prints(45.67);
+ $stream->prints(true);
+ $stream->prints(false);
+
+ $output2 = $stream->getOutputArray();
+ $this->assertEquals(['12345.671'], $output2);
+
+ // Test writing empty strings - consecutive prints calls are concatenated
+ $stream->reset();
+ $stream->prints('');
+ $stream->prints('');
+ $stream->prints('content');
+
+ $output3 = $stream->getOutputArray();
+ $this->assertEquals(['content'], $output3);
+
+ // Test writing very long strings
+ $longString = str_repeat('x', 10000);
+ $stream->reset();
+ $stream->prints($longString);
+
+ $output4 = $stream->getOutputArray();
+ $this->assertEquals([$longString], $output4);
+ }
+
+ /**
+ * Test ArrayOutputStream performance
+ * @test
+ */
+ public function testArrayOutputStreamPerformanceEnhanced() {
+ // Test ArrayOutputStream performance
+ $arrayOutputStream = new ArrayOutputStream();
+
+ $startTime = microtime(true);
+ for ($i = 0; $i < 10000; $i++) {
+ $arrayOutputStream->prints("Performance test line $i\n");
+ }
+ $outputTime = microtime(true) - $startTime;
+
+ $this->assertNotEmpty($arrayOutputStream->getOutputArray());
+ $this->assertLessThan(1.0, $outputTime); // Should complete within 1 second
+ }
}
\ No newline at end of file
diff --git a/tests/WebFiori/Tests/Cli/CLICommandTest.php b/tests/WebFiori/Tests/Cli/CLICommandTest.php
index 50013d9..25ac5fc 100644
--- a/tests/WebFiori/Tests/Cli/CLICommandTest.php
+++ b/tests/WebFiori/Tests/Cli/CLICommandTest.php
@@ -1,1758 +1,1758 @@
-setOutputStream(new ArrayOutputStream());
- $command->moveCursorUp();
- $command->moveCursorUp(-1);
- $command->moveCursorUp(35);
- $this->assertEquals([
- "\e[1A\e[35A"
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testSussess00() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->success('All is ok');
- $this->assertEquals([
- "Success: All is ok\n"
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testSussess01() {
- $command = new TestCommand('cool');
- $ansiArg = new Argument('--ansi');
- $ansiArg->setValue('');
- $command->addArgument($ansiArg);
- $command->setOutputStream(new ArrayOutputStream());
- $command->success('All is ok');
- $this->assertEquals([
- "\e[1;92mSuccess: \e[0mAll is ok\n"
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testInfo00() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->info('Note that all files where uploaded.');
- $this->assertEquals([
- "Info: Note that all files where uploaded.\n"
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testInfo01() {
- $command = new TestCommand('cool');
- $ansiArg = new Argument('--ansi');
- $ansiArg->setValue('');
- $command->addArgument($ansiArg);
- $command->setOutputStream(new ArrayOutputStream());
- $command->info('Note that all files where uploaded.');
- $this->assertEquals([
- "\e[1;34mInfo: \e[0mNote that all files where uploaded.\n"
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testWarning00() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->warning('Part of the info was not logged.');
- $this->assertEquals([
- "Warning: Part of the info was not logged.\n"
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testWarning01() {
- $command = new TestCommand('cool');
- $ansiArg = new Argument('--ansi');
- $ansiArg->setValue('');
- $command->addArgument($ansiArg);
- $command->setOutputStream(new ArrayOutputStream());
- $command->warning('Part of the info was not logged.');
- $this->assertEquals([
- "\e[1;93mWarning: \e[0mPart of the info was not logged.\n"
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testError00() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->error('An exception was thrown.');
- $this->assertEquals([
- "Error: An exception was thrown.\n"
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testError01() {
- $command = new TestCommand('cool');
- $ansiArg = new Argument('--ansi');
- $ansiArg->setValue('');
- $command->addArgument($ansiArg);
- $command->setOutputStream(new ArrayOutputStream());
- $command->error('An exception was thrown.');
- $this->assertEquals([
- "\e[1;91mError: \e[0mAn exception was thrown.\n"
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testSelect00() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- '1'
- ]));
- $answer = $command->select('Select a value:', [
- 'First',
- 'Second',
- 'Third'
- ]);
- $this->assertEquals('Second', $answer);
- $this->assertEquals([
- "Select a value:\n",
- "0: First\n",
- "1: Second\n",
- "2: Third\n"
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testSelect01() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- 'Third'
- ]));
- $answer = $command->select('Select a value:', [
- 'First',
- 'Second',
- 'Third'
- ]);
- $this->assertEquals('Third', $answer);
- $this->assertEquals([
- "Select a value:\n",
- "0: First\n",
- "1: Second\n",
- "2: Third\n"
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testSelect02() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- 'ok',
- '3',
- 'First'
- ]));
- $answer = $command->select('Select a value:', [
- 'First',
- 'Second',
- 'Third'
- ]);
- $this->assertEquals('First', $answer);
- $this->assertEquals([
- "Select a value:\n",
- "0: First\n",
- "1: Second\n",
- "2: Third\n",
- "Error: Invalid answer.\n",
- "Select a value:\n",
- "0: First\n",
- "1: Second\n",
- "2: Third\n",
- "Error: Invalid answer.\n",
- "Select a value:\n",
- "0: First\n",
- "1: Second\n",
- "2: Third\n"
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testSelect03() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- 'ok',
- 'First'
- ]));
- $answer = $command->select('Select a value:', [
- 'First',
- 'Second',
- 'Third'
- ], 3);
- $this->assertEquals('First', $answer);
- $this->assertEquals([
- "Select a value:\n",
- "0: First\n",
- "1: Second\n",
- "2: Third\n",
- "Error: Invalid answer.\n",
- "Select a value:\n",
- "0: First\n",
- "1: Second\n",
- "2: Third\n",
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testSelect04() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- 'ok',
- ''
- ]));
- $answer = $command->select('Select a value:', [
- 'First',
- 'Second',
- 'Third'
- ], 2);
- $this->assertEquals('Third', $answer);
- $this->assertEquals([
- "Select a value:\n",
- "0: First\n",
- "1: Second\n",
- "2: Third <--\n",
- "Error: Invalid answer.\n",
- "Select a value:\n",
- "0: First\n",
- "1: Second\n",
- "2: Third <--\n",
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testSelect05() {
- $command = new TestCommand('cool');
- $ansiArg = new Argument('--ansi');
- $ansiArg->setValue('');
- $command->addArgument($ansiArg);
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- 'ok',
- ''
- ]));
- $answer = $command->select('Select a value:', [
- 'First',
- 'Second',
- 'Third'
- ], 2);
- $this->assertEquals('Third', $answer);
- $this->assertEquals([
- "\e[1;37mSelect a value:\e[0m\n",
- "0: First\n",
- "1: Second\n",
- "\e[1;94m2: Third\e[0m <--\n",
- "\e[1;91mError: \e[0mInvalid answer.\n",
- "\e[1;37mSelect a value:\e[0m\n",
- "0: First\n",
- "1: Second\n",
- "\e[1;94m2: Third\e[0m <--\n",
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testSelect06() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- '1'
- ]));
- $answer = $command->select('Select a value:', [
- 'one' => 'First',
- 'Second',
- 'th' => 'Third'
- ], 2);
- $this->assertEquals('Second', $answer);
- $this->assertEquals([
- "Select a value:\n",
- "0: First\n",
- "1: Second\n",
- "2: Third <--\n"
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testSelect07() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- '1'
- ]));
- $answer = $command->select('Select a value:', [
-
- ], 2);
- $this->assertNull($answer);
- $this->assertEquals([
-
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testMoveCursorTo() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->moveCursorTo();
- $command->moveCursorTo(-1, 3);
- $command->moveCursorTo(3, -1);
- $command->moveCursorTo(44, 3);
- $this->assertEquals([
- "\e[0;0H\e[44;3H"
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testConfirm00() {
- $command = new TestCommand('cool');
- $this->assertNotNull($command->getInputStream());
- $this->assertNotNull($command->getOutputStream());
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- 'y'
- ]));
- $this->assertTrue($command->confirm('Are you sure?'));
- $this->assertEquals([
- "Are you sure?(y/n)\n"
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testConfirm01() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- 'n'
- ]));
- $this->assertFalse($command->confirm('Are you sure?'));
- $this->assertEquals([
- "Are you sure?(y/n)\n"
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testConfirm02() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- 'hell',
- 'y'
- ]));
- $this->assertTrue($command->confirm('Are you sure?'));
- $this->assertEquals([
- "Are you sure?(y/n)\n",
- "Error: Invalid answer. Choose 'y' or 'n'.\n",
- "Are you sure?(y/n)\n"
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testConfirm03() {
- $command = new TestCommand('cool');
- $ansiArg = new Argument('--ansi');
- $ansiArg->setValue('');
- $command->addArgument($ansiArg);
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- 'hell',
- 'y'
- ]));
- $this->assertTrue($command->confirm('Are you sure?'));
- $this->assertEquals([
- "\e[1;37mAre you sure?\e[0m\e[94m(y/n)\e[0m\n",
- "\e[1;91mError: \e[0mInvalid answer. Choose 'y' or 'n'.\n",
- "\e[1;37mAre you sure?\e[0m\e[94m(y/n)\e[0m\n",
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testConfirm04() {
- $command = new TestCommand('cool');
- $ansiArg = new Argument('--ansi');
- $ansiArg->setValue('');
- $command->addArgument($ansiArg);
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- " \n"
- ]));
- $this->assertTrue($command->confirm('Are you sure? ', true));
- $this->assertEquals([
- "\e[1;37mAre you sure?\e[0m\e[94m(Y/n)\e[0m\n",
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testConfirm05() {
- $command = new TestCommand('cool');
- $ansiArg = new Argument('--ansi');
- $ansiArg->setValue('');
- $command->addArgument($ansiArg);
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- "\n"
- ]));
- $this->assertFalse($command->confirm('Are you sure?', false));
- $this->assertEquals([
- "\e[1;37mAre you sure?\e[0m\e[94m(y/N)\e[0m\n",
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testGetInput00() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- "My Name Is Ibrahim\r\n",
- ]));
- $input = $command->getInput(' ');
- $this->assertNull($input);
- $input = $command->getInput('Give me Your Name: ');
- $this->assertEquals('My Name Is Ibrahim', $input);
- }
- /**
- * @test
- */
- public function testGetInput01() {
- $command = new TestCommand('cool');
- $ansiArg = new Argument('--ansi');
- $ansiArg->setValue('');
- $command->addArgument($ansiArg);
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- 'My Name Is Ibrahim',
- ]));
- $input = $command->getInput(' ');
- $this->assertNull($input);
- $input = $command->getInput('Give me Your Name: ');
- $this->assertEquals('My Name Is Ibrahim', $input);
- $this->AssertEquals([
- "\e[1;37mGive me Your Name:\e[0m\n"
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testGetInput02() {
- $command = new TestCommand('cool');
- $ansiArg = new Argument('--ansi');
- $ansiArg->setValue('');
- $command->addArgument($ansiArg);
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- "",
- ]));
- $input = $command->getInput('Give me Your Name: ', "Demon Lord");
- $this->assertEquals('Demon Lord', $input);
- $this->AssertEquals([
- "\e[1;37mGive me Your Name:\e[0m\e[94m Enter = 'Demon Lord'\e[0m\n"
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testGetInput03() {
- $command = new TestCommand('cool');
- $ansiArg = new Argument('--ansi');
- $ansiArg->setValue('');
- $command->addArgument($ansiArg);
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- "",
- ]));
- $input = $command->getInput('Give me Your Name: ');
- $this->assertEquals('', $input);
- $this->AssertEquals([
- "\e[1;37mGive me Your Name:\e[0m\n"
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testGetInput04() {
- $command = new TestCommand('cool');
- $ansiArg = new Argument('--ansi');
- $ansiArg->setValue('');
- $command->addArgument($ansiArg);
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- "",
- "SisPro"
- ]));
- $input = $command->getInput('Give me Your Name: ', null, new InputValidator(function ($val) {
- $trim = trim($val);
- if (strlen($val) == 0) {
- return false;
- }
- return true;
- }));
- $this->assertEquals('SisPro', $input);
- $this->AssertEquals([
- "\e[1;37mGive me Your Name:\e[0m\n",
- "\e[1;91mError: \e[0mInvalid input is given. Try again.\n",
- "\e[1;37mGive me Your Name:\e[0m\n",
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testGetInput05() {
- $command = new TestCommand('cool');
- $ansiArg = new Argument('--ansi');
- $ansiArg->setValue('');
- $command->addArgument($ansiArg);
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- "",
- "SisPro"
- ]));
- $input = $command->getInput('Give me Your Name: ', null, new InputValidator(function ($val) {
- $trim = trim($val);
- if (strlen($val) == 0) {
- return false;
- }
- return true;
- }, 'Wrong Input.'));
- $this->assertEquals('SisPro', $input);
- $this->AssertEquals([
- "\e[1;37mGive me Your Name:\e[0m\n",
- "\e[1;91mError: \e[0mWrong Input.\n",
- "\e[1;37mGive me Your Name:\e[0m\n",
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testGetInput06() {
- $command = new TestCommand('cool');
- $ansiArg = new Argument('--ansi');
- $ansiArg->setValue('');
- $command->addArgument($ansiArg);
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- "SisPro"
- ]));
- $input = $command->getInput('Give me Your Name: ', null, new InputValidator(function ($val, $hello) {
- if ($hello == 'Hello') {
- return true;
- }
- return true;
- }, 'Wrong Input.', [
- 'Hello'
- ]));
- $this->assertEquals('SisPro', $input);
- $this->AssertEquals([
- "\e[1;37mGive me Your Name:\e[0m\n",
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testRead00() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- '445',
- "Hello World!\r\n",
- "Super"
- ]));
- $this->assertEquals('445', $command->readln());
- $this->assertEquals('Hello', $command->read(5));
- $this->assertEquals(" World!\r\n", $command->readln());
- $this->assertEquals('Super', $command->readln());
- }
- /**
- * @test
- */
- public function testReadInteger00() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- '445',
- ]));
- $input = $command->readInteger('Give me an integer:');
- $this->assertSame(445, $input);
- }
- /**
- * @test
- */
- public function testReadInteger01() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- '',
- ]));
- $input = $command->readInteger('Give me an integer:', 88);
- $this->assertSame(88, $input);
- }
- /**
- * @test
- */
- public function testReadInteger02() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- 'uu8',
- '998&9',
- '100'
- ]));
- $input = $command->readInteger('Give me an integer:', 88);
- $this->assertSame(100, $input);
- $this->assertequals([
- "Give me an integer: Enter = '88'\n",
- "Error: Provided value is not an integer!\n",
- "Give me an integer: Enter = '88'\n",
- "Error: Provided value is not an integer!\n",
- "Give me an integer: Enter = '88'\n",
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testReadFloat00() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- '445.1',
- ]));
- $input = $command->readFloat('Give me a float:');
- $this->assertSame(445.1, $input);
- }
- /**
- * @test
- */
- public function testReadFloat01() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- '',
- ]));
- $input = $command->readFloat('Give me a float:', 88.98876);
- $this->assertSame(88.98876, $input);
- }
- /**
- * @test
- */
- public function testReadFloat02() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- 'u.u8',
- '998.9.9',
- '100.998'
- ]));
- $input = $command->readFloat('Give me a float:', 88);
- $this->assertSame(100.998, $input);
- $this->assertequals([
- "Give me a float: Enter = '88'\n",
- "Error: Provided value is not a floating number!\n",
- "Give me a float: Enter = '88'\n",
- "Error: Provided value is not a floating number!\n",
- "Give me a float: Enter = '88'\n",
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testReadInstance00() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- '\\WebFiori\\Tests\\TestStudentXO',
- '\WebFiori\Tests\TestStudent',
- ]));
- $input = $command->readInstance('Give me class:', 'Not a class!');
- $this->assertTrue($input instanceof TestStudent);
- $this->assertequals([
- "Give me class:\n",
- "Error: Not a class!\n",
- "Give me class:\n",
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testReadInstance01() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- '\WebFiori\Tests\TestStudent2',
- '\WebFiori\Tests\TestStudent',
- ]));
- $input = $command->readInstance('Give me class:', 'Not a class!');
- $this->assertTrue($input instanceof TestStudent);
- $this->assertequals([
- "Give me class:\n",
- "Error: Not a class!\n",
- "Give me class:\n",
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testReadClassName00() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- 'SuperClass',
- ]));
- $input = $command->readClassName('Give me class name:');
- $this->assertEquals('SuperClass', $input);
- $this->assertequals([
- "Give me class name:\n",
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testReadClassName01() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- 'Super Class',
- "ValidSuper"
- ]));
- $input = $command->readClassName('Give me class name:', null, 'Not valid Class Name!');
- $this->assertEquals('ValidSuper', $input);
- $this->assertequals([
- "Give me class name:\n",
- "Error: Not valid Class Name!\n",
- "Give me class name:\n",
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testReadClassName02() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- 'Super Class',
- "ValidSuper"
- ]));
- $input = $command->readClassName('Give me class name:', 'Suffix', 'Not valid Class Name!');
- $this->assertEquals('ValidSuperSuffix', $input);
- $this->assertequals([
- "Give me class name:\n",
- "Error: Not valid Class Name!\n",
- "Give me class name:\n",
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testReadClassName03() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- 'Super Class',
- "ValidSuperXUYYS"
- ]));
- $input = $command->readClassName('Give me class name:', 'XUYYS', 'Not valid Class Name!');
- $this->assertEquals('ValidSuperXUYYS', $input);
- $this->assertequals([
- "Give me class name:\n",
- "Error: Not valid Class Name!\n",
- "Give me class name:\n",
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testReadClassName04() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- 'Super Class',
- "ValidSuperXUYYS"
- ]));
- $input = $command->readClassName('Give me class name:', '12X', 'Not valid Class Name!');
- $this->assertEquals('ValidSuperXUYYS12X', $input);
- $this->assertequals([
- "Give me class name:\n",
- "Error: Not valid Class Name!\n",
- "Give me class name:\n",
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testReadNamespace00() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- '\\webfiori\\tests\\',
- ]));
- $input = $command->readNamespace('Give me class namespace:');
- $this->assertEquals('\\webfiori\\tests\\', $input);
- $this->assertequals([
- "Give me class namespace:\n",
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testReadNamespace01() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- '\\webfiori\\tests',
- ]));
- $input = $command->readNamespace('Give me class namespace:');
- $this->assertEquals('\\webfiori\\tests', $input);
- $this->assertequals([
- "Give me class namespace:\n",
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testReadNamespace02() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- 'webfiori\\tests',
- ]));
- $input = $command->readNamespace('Give me class namespace:');
- $this->assertEquals('webfiori\\tests', $input);
- $this->assertequals([
- "Give me class namespace:\n",
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testReadNamespace03() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- '/webfiori\\tests',
- "",
- 'webfiori\\tests',
- ]));
- $input = $command->readNamespace('Give me class namespace:', null, "Please provide a valid NS!");
- $this->assertEquals('webfiori\\tests', $input);
- $this->assertequals([
- "Give me class namespace:\n",
- "Error: Please provide a valid NS!\n",
- "Give me class namespace:\n",
- "Error: Please provide a valid NS!\n",
- "Give me class namespace:\n",
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testReadNamespace04() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- '\\',
- ]));
- $input = $command->readNamespace('Give me class namespace:', null, "Please provide a valid NS!");
- $this->assertEquals('\\', $input);
- $this->assertequals([
- "Give me class namespace:\n",
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testReadNamespace05() {
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- '',
- ]));
- $input = $command->readNamespace('Give me class namespace:', 'wfx\\xyz', "Please provide a valid NS!");
- $this->assertEquals('wfx\\xyz', $input);
- $this->assertequals([
- "Give me class namespace: Enter = 'wfx\xyz'\n",
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function testReadNamespace06() {
- $this->expectException(IOException::class);
- $this->expectExceptionMessage('Provided default namespace is not valid.');
-
- $command = new TestCommand('cool');
- $command->setOutputStream(new ArrayOutputStream());
- $command->setInputStream(new ArrayInputStream([
- '',
- ]));
- $input = $command->readNamespace('Give me class namespace:', 'wfx//xyz', "Please provide a valid NS!");
- $this->assertEquals('wfx\\xyz', $input);
- $this->assertequals([
- "Give me class namespace: Enter = 'wfx\xyz'\n",
- ], $command->getOutputStream()->getOutputArray());
- }
- /**
- * @test
- */
- public function test00() {
- $command = new TestCommand('new-command');
- $this->assertEquals($command->getName(), 'new-command');
- $this->assertEquals('', $command->getDescription());
- $this->assertEquals(0, count($command->getArgs()));
- }
- /**
- * @test
- */
- public function test01() {
- $command = new TestCommand('new-command');
- $command->println('%30s', 'ok');
- $this->assertTrue(true);
- }
- /**
- * @test
- */
- public function test03() {
- $command = new TestCommand('with space');
- $this->assertEquals('new-command', $command->getName());
- $this->assertEquals('', $command->getDescription());
- }
- /**
- * @test
- */
- public function testAddArg00() {
- $command = new TestCommand('new-command');
- $this->assertFalse($command->addArg(''));
- $this->assertFalse($command->addArg('with space'));
- $this->assertFalse($command->addArg(' '));
- $this->assertFalse($command->addArg('invalid name'));
- $this->assertTrue($command->addArg('valid'));
- $this->assertTrue($command->addArg('--valid-name'));
- $this->assertTrue($command->addArg('0invalid'));
- $this->assertTrue($command->addArg('valid-1'));
- $this->assertEquals([
- 'valid',
- '--valid-name',
- '0invalid',
- 'valid-1'
- ], $command->getArgsNames());
- }
- /**
- * @test
- */
- public function testAddArg01() {
- $command = new TestCommand('new-command');
- $this->assertTrue($command->addArg('default-options'));
- $argDetails = $command->getArg('default-options');
- $this->assertEquals('', $argDetails->getDescription());
- $this->assertFalse($argDetails->isOptional());
- $this->assertEquals([], $argDetails->getAllowedValues());
- }
- /**
- * @test
- */
- public function testAddArg02() {
- $command = new TestCommand('new-command');
- $this->assertTrue($command->addArg('default-options', [
- ArgumentOption::OPTIONAL => true
- ]));
- $argDetails = $command->getArg('default-options');
- $this->assertEquals('', $argDetails->getDescription());
- $this->assertTrue($argDetails->isOptional());
- $this->assertEquals([], $argDetails->getAllowedValues());
- }
- /**
- * @test
- */
- public function testAddArg03() {
- $command = new TestCommand('new');
- $this->assertTrue($command->addArg('default-options', [
- ArgumentOption::OPTIONAL => true
- ]));
- $argDetails = $command->getArg('default-options');
- $this->assertEquals('', $argDetails->getDescription());
- $this->assertTrue($argDetails->isOptional());
- $this->assertEquals([], $argDetails->getAllowedValues());
- }
- /**
- * @test
- */
- public function testAddArg04() {
- $command = new TestCommand('new');
- $this->assertTrue($command->addArg('default-options', [
- ArgumentOption::OPTIONAL => true
- ]));
- $this->assertFalse($command->addArg('default-options'));
- }
- /**
- * @test
- */
- public function testAddArg05() {
- $command = new TestCommand('new');
- $this->assertTrue($command->addArg('default-options', [
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DESCRIPTION => ' ',
- ArgumentOption::DEFAULT => 'ok , good '
- ]));
- $arg = $command->getArg('default-options');
- $this->assertEquals('', $arg->getDescription());
- $this->assertEquals('ok , good', $arg->getDefault());
- }
- /**
- * @test
- */
- public function testClear00() {
- $runner = new Runner();
- $runner->setOutputStream(new ArrayOutputStream());
- $runner->setInputs([]);
- $command = new TestCommand('hello', [
- 'name' => [
-
- ]
- ]);
- $runner->runCommand($command, [
- 'name' => 'Ibrahim'
- ]);
- $command->clearConsole();
- $this->assertEquals([
- "Hello Ibrahim!\n",
- "Ok\n",
- "\ec"
- ], $runner->getOutput());
- }
- /**
- * @test
- */
- public function testClear01() {
- $runner = new Runner();
- $runner->setOutputStream(new ArrayOutputStream());
- $runner->setInputs([]);
- $command = new TestCommand('hello', [
- 'name' => [
-
- ]
- ]);
- $runner->runCommand($command, [
- 'name' => 'Ibrahim'
- ]);
- $command->clearLine();
- $this->assertEquals([
- "Hello Ibrahim!\n",
- "Ok\n",
- "\e[2K\r"
- ], $runner->getOutput());
- }
- /**
- * @test
- */
- public function testClear02() {
- $runner = new Runner();
- $runner->setOutputStream(new ArrayOutputStream());
- $runner->setInputs([]);
- $command = new TestCommand('hello', [
- 'name' => [
-
- ]
- ]);
- $runner->runCommand($command, [
- 'name' => 'Ibrahim'
- ]);
- $command->clear(1);
- $this->assertEquals([
- "Hello Ibrahim!\n",
- "Ok\n",
- "\e[1D \e[1D\e[1C"
- ], $runner->getOutput());
- }
- /**
- * @test
- */
- public function testClear03() {
- $runner = new Runner();
- $runner->setOutputStream(new ArrayOutputStream());
- $runner->setInputs([]);
- $command = new TestCommand('hello', [
- 'name' => [
-
- ]
- ]);
- $runner->runCommand($command, [
- 'name' => 'Ibrahim'
- ]);
- $command->clear(2);
- $this->assertEquals([
- "Hello Ibrahim!\n",
- "Ok\n",
- "\e[1D \e[1D\e[1D \e[1D\e[2C"
- ], $runner->getOutput());
- }
- /**
- * @test
- */
- public function testClear05() {
- $runner = new Runner();
- $runner->setOutputStream(new ArrayOutputStream());
- $runner->setInputs([]);
- $command = new TestCommand('hello', [
- 'name' => [
-
- ]
- ]);
- $runner->runCommand($command, [
- 'name' => 'Ibrahim'
- ]);
- $command->clear(1, false);
- $this->assertEquals([
- "Hello Ibrahim!\n",
- "Ok\n",
- "\e[1C \e[2D"
- ], $runner->getOutput());
- }
- /**
- * @test
- */
- public function testClear06() {
- $runner = new Runner();
- $runner->setOutputStream(new ArrayOutputStream());
- $runner->setInputs([]);
- $command = new TestCommand('hello', [
- 'name' => [
-
- ]
- ]);
- $runner->runCommand($command, [
- 'name' => 'Ibrahim'
- ]);
- $command->clear(2, false);
- $this->assertEquals([
- "Hello Ibrahim!\n",
- "Ok\n",
- "\e[1C \e[3D"
- ], $runner->getOutput());
- }
- /**
- * @test
- */
- public function testMove00() {
- $runner = new Runner();
- $runner->setOutputStream(new ArrayOutputStream());
- $runner->setInputs([]);
- $command = new TestCommand('hello', [
- 'name' => [
-
- ]
- ]);
- $runner->runCommand($command, [
- 'name' => 'Ibrahim'
- ]);
- $command->moveCursorDown(3);
- $command->moveCursorDown(6);
- $command->moveCursorLeft(88);
- $command->moveCursorRight(4);
- $this->assertEquals([
- "Hello Ibrahim!\n",
- "Ok\n",
- "\e[3B\e[6B\e[88D\e[4C"
- ], $runner->getOutput());
- }
- /**
- * @test
- */
- public function testMove01() {
- $runner = new Runner();
- $runner->setOutputStream(new ArrayOutputStream());
- $runner->setInputs([]);
- $command = new TestCommand('hello', [
- 'name' => [
-
- ]
- ]);
- $runner->runCommand($command, [
- 'name' => 'Ibrahim'
- ]);
- $command->moveCursorDown(3);
- $command->moveCursorDown(6);
- $command->moveCursorLeft(88);
- $command->moveCursorRight(4);
- $this->assertEquals([
- "Hello Ibrahim!\n",
- "Ok\n",
- "\e[3B\e[6B\e[88D\e[4C"
- ], $runner->getOutput());
- }
- /**
- * @test
- */
- public function testPrintList00() {
- $runner = new Runner();
- $runner->setOutputStream(new ArrayOutputStream());
- $runner->setOutputStream(new ArrayOutputStream());
- $runner->setInputs([]);
- $command = new TestCommand('hello');
- $runner->runCommand($command);
- $command->printList([
- 'one',
- 'two',
- 'three'
- ]);
- $this->assertEquals([
- "Hello !\n",
- "Ok\n",
- "- one\n",
- "- two\n",
- "- three\n"
- ], $runner->getOutput());
- }
- /**
- * @test
- */
- public function testPrintList01() {
- $runner = new Runner();
- $runner->setOutputStream(new ArrayOutputStream());
- $runner->setOutputStream(new ArrayOutputStream());
- $runner->setInputs([]);
- $command = new TestCommand('hello');
- $runner->runCommand($command, [
- '--ansi'
- ]);
- $command->printList([
- 'one',
- 'two',
- 'three'
- ]);
- $this->assertEquals([
- "\e[31mHello !\e[0m\n",
- "Ok\n",
- "- one\n",
- "- two\n",
- "- three\n"
- ], $runner->getOutput());
- }
- /**
- * @test
- */
- public function testSetArgVal00() {
- $command = new TestCommand('ok', [
- 'one' => [
-
- ],
- 'two' => [
-
- ]
- ]);
- $this->assertFalse($command->isArgProvided('one'));
- $this->assertTrue($command->setArgValue('one', 1));
- $this->assertTrue($command->isArgProvided('one'));
- $arg = $command->getArg('one');
- $this->assertEquals(1, $arg->getValue());
- $this->assertFalse($command->isArgProvided('two'));
- $this->assertTrue($command->setArgValue('two'));
- $this->assertTrue($command->isArgProvided('two'));
- $this->assertEquals('', $command->getArgValue('two'));
- $this->assertFalse($command->setArgValue('not-exist'));
- }
-
- // ========== ENHANCED COMMAND TESTS ==========
-
- /**
- * Test command aliases functionality
- * @test
- */
- public function testCommandAliasesEnhanced() {
- $command = new TestCommand('test-cmd', [], 'Test command', ['tc', 'test']);
-
- // Note: The actual implementation might not store aliases in the command itself
- // but rather in the runner. Let's test what we can verify.
- $this->assertEquals('test-cmd', $command->getName());
-
- // Test that aliases are passed to constructor (even if not stored in command)
- $this->assertIsArray($command->getAliases());
- }
-
- /**
- * Test command description edge cases
- * @test
- */
- public function testCommandDescriptionEdgeCasesEnhanced() {
- // Test with empty description
- $command = new TestCommand('test-cmd', [], '');
- $this->assertEquals('', $command->getDescription());
-
- // Test setting description after construction
- $this->assertTrue($command->setDescription('New description'));
- $this->assertEquals('New description', $command->getDescription());
-
- // Test setting empty description
- $this->assertFalse($command->setDescription(''));
- $this->assertEquals('New description', $command->getDescription()); // Should remain unchanged
- }
-
- /**
- * Test command name validation
- * @test
- */
- public function testCommandNameValidationEnhanced() {
- // Test invalid names
- $command = new TestCommand('');
- $this->assertEquals('new-command', $command->getName()); // Should fallback to default
-
- $command2 = new TestCommand('invalid name with spaces');
- $this->assertEquals('new-command', $command2->getName()); // Should fallback to default
-
- // Test valid name setting
- $command3 = new TestCommand('valid-name');
- $this->assertTrue($command3->setName('another-valid-name'));
- $this->assertEquals('another-valid-name', $command3->getName());
-
- // Test invalid name setting
- $this->assertFalse($command3->setName(''));
- $this->assertEquals('another-valid-name', $command3->getName()); // Should remain unchanged
- }
-
- /**
- * Test argument handling edge cases
- * @test
- */
- public function testArgumentHandlingEdgeCasesEnhanced() {
- $command = new TestCommand('test-cmd');
-
- // Test adding argument with all options
- $this->assertTrue($command->addArg('--test-arg', [
- ArgumentOption::OPTIONAL => false,
- ArgumentOption::DESCRIPTION => 'Test argument',
- ArgumentOption::DEFAULT => 'default-value',
- ArgumentOption::VALUES => ['val1', 'val2', 'val3']
- ]));
-
- // Test duplicate argument
- $this->assertFalse($command->addArg('--test-arg', [])); // Should fail for duplicate
-
- // Test getting non-existent argument
- $this->assertNull($command->getArg('--non-existent'));
-
- // Test checking if argument exists
- $this->assertTrue($command->hasArg('--test-arg'));
- $this->assertFalse($command->hasArg('--non-existent'));
-
- // Test getting argument names
- $argNames = $command->getArgsNames();
- $this->assertContains('--test-arg', $argNames);
- }
-
- /**
- * Test cursor movement methods
- * @test
- */
- public function testCursorMovementMethodsEnhanced() {
- $command = new TestCommand('test-cmd');
- $output = new ArrayOutputStream();
- $command->setOutputStream($output);
-
- // Test cursor movements
- $command->moveCursorUp(5);
- $command->moveCursorDown(3);
- $command->moveCursorLeft(2);
- $command->moveCursorRight(4);
- $command->moveCursorTo(10, 20);
-
- $outputArray = $output->getOutputArray();
- $this->assertNotEmpty($outputArray);
-
- // Test with invalid values (should be handled gracefully)
- $command->moveCursorUp(-1); // Should be ignored or handled
- $command->moveCursorDown(0);
- $command->moveCursorLeft(-5);
- $command->moveCursorRight(0);
- }
-
- /**
- * Test screen clearing methods
- * @test
- */
- public function testScreenClearingMethodsEnhanced() {
- $command = new TestCommand('test-cmd');
- $output = new ArrayOutputStream();
- $command->setOutputStream($output);
-
- // Test clear methods
- $result1 = $command->clear(5, true);
- $this->assertInstanceOf(TestCommand::class, $result1); // Should return self
-
- $result2 = $command->clear(3, false);
- $this->assertInstanceOf(TestCommand::class, $result2);
-
- $result3 = $command->clearConsole();
- $this->assertInstanceOf(TestCommand::class, $result3);
-
- $command->clearLine();
-
- $outputArray = $output->getOutputArray();
- $this->assertNotEmpty($outputArray);
- }
-
- /**
- * Test input reading methods
- * @test
- */
- public function testInputReadingMethodsEnhanced() {
- $command = new TestCommand('test-cmd');
- $input = new ArrayInputStream(['test input', '42', '3.14']);
- $command->setInputStream($input);
-
- // Test basic input reading
- $result = $command->readln();
- $this->assertEquals('test input', $result);
-
- // Test reading integer
- $intResult = $command->readInteger('Enter number: ');
- $this->assertEquals(42, $intResult);
-
- // Test reading float
- $floatResult = $command->readFloat('Enter float: ');
- $this->assertEquals(3.14, $floatResult);
- }
-
- /**
- * Test confirmation dialog
- * @test
- */
- public function testConfirmationDialogEnhanced() {
- $command = new TestCommand('test-cmd');
-
- // Test with 'y' input
- $input1 = new ArrayInputStream(['y']);
- $command->setInputStream($input1);
- $result1 = $command->confirm('Continue?');
- $this->assertTrue($result1);
-
- // Test with 'n' input
- $input2 = new ArrayInputStream(['n']);
- $command->setInputStream($input2);
- $result2 = $command->confirm('Continue?');
- $this->assertFalse($result2);
-
- // Test with default value
- $input3 = new ArrayInputStream(['']); // Empty input
- $command->setInputStream($input3);
- $result3 = $command->confirm('Continue?', true);
- $this->assertTrue($result3); // Should use default
- }
-
- /**
- * Test selection method
- * @test
- */
- public function testSelectionMethodEnhanced() {
- $command = new TestCommand('test-cmd');
- $output = new ArrayOutputStream();
- $command->setOutputStream($output);
-
- $choices = ['Option 1', 'Option 2', 'Option 3'];
-
- // Test valid selection
- $input = new ArrayInputStream(['2']);
- $command->setInputStream($input);
- $result = $command->select('Choose option:', $choices);
- $this->assertEquals('Option 3', $result); // Index 2 = Option 3 (0-based indexing)
-
- // Test with default
- $input2 = new ArrayInputStream(['']); // Empty input
- $command->setInputStream($input2);
- $result2 = $command->select('Choose option:', $choices, 0);
- $this->assertEquals('Option 1', $result2); // Should use default index
- }
-
- /**
- * Test list printing
- * @test
- */
- public function testListPrintingMethodEnhanced() {
- $command = new TestCommand('test-cmd');
- $output = new ArrayOutputStream();
- $command->setOutputStream($output);
-
- $items = ['Item 1', 'Item 2', 'Item 3'];
- $command->printList($items);
-
- $outputArray = $output->getOutputArray();
- $this->assertNotEmpty($outputArray);
-
- // Test with string values only
- $output->reset();
- $stringItems = ['value1', 'value2'];
- $command->printList($stringItems);
- }
-
- /**
- * Test message formatting methods
- * @test
- */
- public function testMessageFormattingMethodsEnhanced() {
- $command = new TestCommand('test-cmd');
- $output = new ArrayOutputStream();
- $command->setOutputStream($output);
-
- // Test different message types
- $command->error('Error message');
- $command->warning('Warning message');
- $command->info('Info message');
- $command->success('Success message');
-
- $outputArray = $output->getOutputArray();
- $this->assertCount(4, $outputArray);
-
- // Test with ANSI enabled
- $ansiArg = new Argument('--ansi');
- $ansiArg->setValue('');
- $command->addArgument($ansiArg);
-
- $output2 = new ArrayOutputStream();
- $command->setOutputStream($output2);
-
- $command->error('ANSI Error');
- $command->warning('ANSI Warning');
- $command->info('ANSI Info');
- $command->success('ANSI Success');
-
- $ansiOutputArray = $output2->getOutputArray();
- $this->assertCount(4, $ansiOutputArray);
-
- // ANSI output should contain escape sequences
- $this->assertStringContainsString("\e[", $ansiOutputArray[0]);
- }
-
- /**
- * Test argument removal
- * @test
- */
- public function testArgumentRemovalMethodEnhanced() {
- $command = new TestCommand('test-cmd');
-
- // Add some arguments
- $command->addArg('--arg1', []);
- $command->addArg('--arg2', []);
- $command->addArg('--arg3', []);
-
- $this->assertTrue($command->hasArg('--arg1'));
- $this->assertTrue($command->hasArg('--arg2'));
- $this->assertTrue($command->hasArg('--arg3'));
-
- // Remove an argument
- $this->assertTrue($command->removeArgument('--arg2'));
- $this->assertFalse($command->hasArg('--arg2'));
- $this->assertTrue($command->hasArg('--arg1')); // Others should remain
- $this->assertTrue($command->hasArg('--arg3'));
-
- // Try to remove non-existent argument
- $this->assertFalse($command->removeArgument('--non-existent'));
- }
-
- /**
- * Test input validation with InputValidator
- * @test
- */
- public function testInputValidationMethodEnhanced() {
- $command = new TestCommand('test-cmd');
-
- // Test with a simple validation function
- $validator = new InputValidator(
- function(string &$input): bool {
- return strlen($input) >= 3;
- },
- 'Input must be at least 3 characters long'
- );
-
- // Test valid input
- $input1 = new ArrayInputStream(['valid']);
- $command->setInputStream($input1);
- $result1 = $command->getInput('Enter text: ', null, $validator);
- $this->assertEquals('valid', $result1);
-
- // Test with default value
- $input2 = new ArrayInputStream(['']);
- $command->setInputStream($input2);
- $result2 = $command->getInput('Enter text: ', 'default', $validator);
- $this->assertEquals('default', $result2);
- }
-
- /**
- * Test owner (Runner) relationship
- * @test
- */
- public function testOwnerRelationshipMethodEnhanced() {
- $command = new TestCommand('test-cmd');
- $runner = new Runner();
- $runner->setOutputStream(new ArrayOutputStream());
-
- // Initially no owner
- $this->assertNull($command->getOwner());
-
- // Set owner
- $command->setOwner($runner);
- $this->assertSame($runner, $command->getOwner());
-
- // Clear owner
- $command->setOwner(null);
- $this->assertNull($command->getOwner());
- }
-
- /**
- * Test sub-command execution
- * @test
- */
- public function testSubCommandExecutionMethodEnhanced() {
- $command = new TestCommand('main-cmd');
- $runner = new Runner();
- $runner->setOutputStream(new ArrayOutputStream());
- $subCommand = new TestCommand('sub-cmd');
-
- $runner->register($command);
- $runner->register($subCommand);
- $command->setOwner($runner);
-
- // Test executing sub-command
- $result = $command->execSubCommand('sub-cmd');
- $this->assertEquals(0, $result); // Assuming TestCommand returns 0
-
- // Test executing non-existent sub-command
- $result2 = $command->execSubCommand('non-existent');
- $this->assertEquals(-1, $result2); // Should return error code
- }
-
- /**
- * Test argument provided checking
- * @test
- */
- public function testArgumentProvidedCheckingMethodEnhanced() {
- $command = new TestCommand('test-cmd');
- $command->addArg('--test-arg', [ArgumentOption::OPTIONAL => true]);
-
- // Initially not provided
- $this->assertFalse($command->isArgProvided('--test-arg'));
-
- // Set value
- $command->setArgValue('--test-arg', 'value');
- $this->assertTrue($command->isArgProvided('--test-arg'));
-
- // Test non-existent argument
- $this->assertFalse($command->isArgProvided('--non-existent'));
- }
-
- /**
- * Test stream getters and setters
- * @test
- */
- public function testStreamHandlingMethodEnhanced() {
- $command = new TestCommand('test-cmd');
-
- // Test default streams
- $this->assertNotNull($command->getInputStream());
- $this->assertNotNull($command->getOutputStream());
-
- // Test setting custom streams
- $customInput = new ArrayInputStream(['test']);
- $customOutput = new ArrayOutputStream();
-
- $command->setInputStream($customInput);
- $command->setOutputStream($customOutput);
-
- $this->assertSame($customInput, $command->getInputStream());
- $this->assertSame($customOutput, $command->getOutputStream());
- }
-
- /**
- * Test reading with byte limit
- * @test
- */
- public function testReadWithByteLimitMethodEnhanced() {
- $command = new TestCommand('test-cmd');
- $input = new ArrayInputStream(['hello world']);
- $command->setInputStream($input);
-
- // Test reading specific number of bytes
- $result = $command->read(5);
- $this->assertEquals('hello', $result);
- }
-
- /**
- * Test command execution wrapper
- * @test
- */
- public function testCommandExecutionWrapperMethodEnhanced() {
- $command = new TestCommand('test-cmd');
- $output = new ArrayOutputStream();
- $command->setOutputStream($output);
-
- // Test successful execution
- $result = $command->excCommand();
- $this->assertEquals(0, $result);
-
- // The excCommand method should call exec() and handle any exceptions
- $outputArray = $output->getOutputArray();
- $this->assertNotEmpty($outputArray); // TestCommand should produce some output
- }
-
- /**
- * Test select with multiple invalid inputs then empty input (framework scenario)
- * @test
- */
- public function testSelectFrameworkScenario() {
- $command = new TestCommand('test-cmd');
- $output = new ArrayOutputStream();
- $command->setOutputStream($output);
-
- // Mimic framework test: empty input, invalid input 'XC', then valid input '0'
- $input = new ArrayInputStream(['', 'XC', '0']);
- $command->setInputStream($input);
-
- $choices = ['AR', 'EN'];
- $result = $command->select('In which language you would like to update?', $choices);
-
- $this->assertEquals('AR', $result);
- }
-}
+setOutputStream(new ArrayOutputStream());
+ $command->moveCursorUp();
+ $command->moveCursorUp(-1);
+ $command->moveCursorUp(35);
+ $this->assertEquals([
+ "\e[1A\e[35A"
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testSussess00() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->success('All is ok');
+ $this->assertEquals([
+ "Success: All is ok\n"
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testSussess01() {
+ $command = new TestCommand('cool');
+ $ansiArg = new Argument('--ansi');
+ $ansiArg->setValue('');
+ $command->addArgument($ansiArg);
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->success('All is ok');
+ $this->assertEquals([
+ "\e[1;92mSuccess: \e[0mAll is ok\n"
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testInfo00() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->info('Note that all files where uploaded.');
+ $this->assertEquals([
+ "Info: Note that all files where uploaded.\n"
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testInfo01() {
+ $command = new TestCommand('cool');
+ $ansiArg = new Argument('--ansi');
+ $ansiArg->setValue('');
+ $command->addArgument($ansiArg);
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->info('Note that all files where uploaded.');
+ $this->assertEquals([
+ "\e[1;34mInfo: \e[0mNote that all files where uploaded.\n"
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testWarning00() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->warning('Part of the info was not logged.');
+ $this->assertEquals([
+ "Warning: Part of the info was not logged.\n"
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testWarning01() {
+ $command = new TestCommand('cool');
+ $ansiArg = new Argument('--ansi');
+ $ansiArg->setValue('');
+ $command->addArgument($ansiArg);
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->warning('Part of the info was not logged.');
+ $this->assertEquals([
+ "\e[1;93mWarning: \e[0mPart of the info was not logged.\n"
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testError00() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->error('An exception was thrown.');
+ $this->assertEquals([
+ "Error: An exception was thrown.\n"
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testError01() {
+ $command = new TestCommand('cool');
+ $ansiArg = new Argument('--ansi');
+ $ansiArg->setValue('');
+ $command->addArgument($ansiArg);
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->error('An exception was thrown.');
+ $this->assertEquals([
+ "\e[1;91mError: \e[0mAn exception was thrown.\n"
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testSelect00() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ '1'
+ ]));
+ $answer = $command->select('Select a value:', [
+ 'First',
+ 'Second',
+ 'Third'
+ ]);
+ $this->assertEquals('Second', $answer);
+ $this->assertEquals([
+ "Select a value:\n",
+ "0: First\n",
+ "1: Second\n",
+ "2: Third\n"
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testSelect01() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ 'Third'
+ ]));
+ $answer = $command->select('Select a value:', [
+ 'First',
+ 'Second',
+ 'Third'
+ ]);
+ $this->assertEquals('Third', $answer);
+ $this->assertEquals([
+ "Select a value:\n",
+ "0: First\n",
+ "1: Second\n",
+ "2: Third\n"
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testSelect02() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ 'ok',
+ '3',
+ 'First'
+ ]));
+ $answer = $command->select('Select a value:', [
+ 'First',
+ 'Second',
+ 'Third'
+ ]);
+ $this->assertEquals('First', $answer);
+ $this->assertEquals([
+ "Select a value:\n",
+ "0: First\n",
+ "1: Second\n",
+ "2: Third\n",
+ "Error: Invalid answer.\n",
+ "Select a value:\n",
+ "0: First\n",
+ "1: Second\n",
+ "2: Third\n",
+ "Error: Invalid answer.\n",
+ "Select a value:\n",
+ "0: First\n",
+ "1: Second\n",
+ "2: Third\n"
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testSelect03() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ 'ok',
+ 'First'
+ ]));
+ $answer = $command->select('Select a value:', [
+ 'First',
+ 'Second',
+ 'Third'
+ ], 3);
+ $this->assertEquals('First', $answer);
+ $this->assertEquals([
+ "Select a value:\n",
+ "0: First\n",
+ "1: Second\n",
+ "2: Third\n",
+ "Error: Invalid answer.\n",
+ "Select a value:\n",
+ "0: First\n",
+ "1: Second\n",
+ "2: Third\n",
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testSelect04() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ 'ok',
+ ''
+ ]));
+ $answer = $command->select('Select a value:', [
+ 'First',
+ 'Second',
+ 'Third'
+ ], 2);
+ $this->assertEquals('Third', $answer);
+ $this->assertEquals([
+ "Select a value:\n",
+ "0: First\n",
+ "1: Second\n",
+ "2: Third <--\n",
+ "Error: Invalid answer.\n",
+ "Select a value:\n",
+ "0: First\n",
+ "1: Second\n",
+ "2: Third <--\n",
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testSelect05() {
+ $command = new TestCommand('cool');
+ $ansiArg = new Argument('--ansi');
+ $ansiArg->setValue('');
+ $command->addArgument($ansiArg);
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ 'ok',
+ ''
+ ]));
+ $answer = $command->select('Select a value:', [
+ 'First',
+ 'Second',
+ 'Third'
+ ], 2);
+ $this->assertEquals('Third', $answer);
+ $this->assertEquals([
+ "\e[1;37mSelect a value:\e[0m\n",
+ "0: First\n",
+ "1: Second\n",
+ "\e[1;94m2: Third\e[0m <--\n",
+ "\e[1;91mError: \e[0mInvalid answer.\n",
+ "\e[1;37mSelect a value:\e[0m\n",
+ "0: First\n",
+ "1: Second\n",
+ "\e[1;94m2: Third\e[0m <--\n",
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testSelect06() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ '1'
+ ]));
+ $answer = $command->select('Select a value:', [
+ 'one' => 'First',
+ 'Second',
+ 'th' => 'Third'
+ ], 2);
+ $this->assertEquals('Second', $answer);
+ $this->assertEquals([
+ "Select a value:\n",
+ "0: First\n",
+ "1: Second\n",
+ "2: Third <--\n"
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testSelect07() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ '1'
+ ]));
+ $answer = $command->select('Select a value:', [
+
+ ], 2);
+ $this->assertNull($answer);
+ $this->assertEquals([
+
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testMoveCursorTo() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->moveCursorTo();
+ $command->moveCursorTo(-1, 3);
+ $command->moveCursorTo(3, -1);
+ $command->moveCursorTo(44, 3);
+ $this->assertEquals([
+ "\e[0;0H\e[44;3H"
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testConfirm00() {
+ $command = new TestCommand('cool');
+ $this->assertNotNull($command->getInputStream());
+ $this->assertNotNull($command->getOutputStream());
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ 'y'
+ ]));
+ $this->assertTrue($command->confirm('Are you sure?'));
+ $this->assertEquals([
+ "Are you sure?(y/n)\n"
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testConfirm01() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ 'n'
+ ]));
+ $this->assertFalse($command->confirm('Are you sure?'));
+ $this->assertEquals([
+ "Are you sure?(y/n)\n"
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testConfirm02() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ 'hell',
+ 'y'
+ ]));
+ $this->assertTrue($command->confirm('Are you sure?'));
+ $this->assertEquals([
+ "Are you sure?(y/n)\n",
+ "Error: Invalid answer. Choose 'y' or 'n'.\n",
+ "Are you sure?(y/n)\n"
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testConfirm03() {
+ $command = new TestCommand('cool');
+ $ansiArg = new Argument('--ansi');
+ $ansiArg->setValue('');
+ $command->addArgument($ansiArg);
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ 'hell',
+ 'y'
+ ]));
+ $this->assertTrue($command->confirm('Are you sure?'));
+ $this->assertEquals([
+ "\e[1;37mAre you sure?\e[0m\e[94m(y/n)\e[0m\n",
+ "\e[1;91mError: \e[0mInvalid answer. Choose 'y' or 'n'.\n",
+ "\e[1;37mAre you sure?\e[0m\e[94m(y/n)\e[0m\n",
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testConfirm04() {
+ $command = new TestCommand('cool');
+ $ansiArg = new Argument('--ansi');
+ $ansiArg->setValue('');
+ $command->addArgument($ansiArg);
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ " \n"
+ ]));
+ $this->assertTrue($command->confirm('Are you sure? ', true));
+ $this->assertEquals([
+ "\e[1;37mAre you sure?\e[0m\e[94m(Y/n)\e[0m\n",
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testConfirm05() {
+ $command = new TestCommand('cool');
+ $ansiArg = new Argument('--ansi');
+ $ansiArg->setValue('');
+ $command->addArgument($ansiArg);
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ "\n"
+ ]));
+ $this->assertFalse($command->confirm('Are you sure?', false));
+ $this->assertEquals([
+ "\e[1;37mAre you sure?\e[0m\e[94m(y/N)\e[0m\n",
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testGetInput00() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ "My Name Is Ibrahim\r\n",
+ ]));
+ $input = $command->getInput(' ');
+ $this->assertNull($input);
+ $input = $command->getInput('Give me Your Name: ');
+ $this->assertEquals('My Name Is Ibrahim', $input);
+ }
+ /**
+ * @test
+ */
+ public function testGetInput01() {
+ $command = new TestCommand('cool');
+ $ansiArg = new Argument('--ansi');
+ $ansiArg->setValue('');
+ $command->addArgument($ansiArg);
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ 'My Name Is Ibrahim',
+ ]));
+ $input = $command->getInput(' ');
+ $this->assertNull($input);
+ $input = $command->getInput('Give me Your Name: ');
+ $this->assertEquals('My Name Is Ibrahim', $input);
+ $this->AssertEquals([
+ "\e[1;37mGive me Your Name:\e[0m\n"
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testGetInput02() {
+ $command = new TestCommand('cool');
+ $ansiArg = new Argument('--ansi');
+ $ansiArg->setValue('');
+ $command->addArgument($ansiArg);
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ "",
+ ]));
+ $input = $command->getInput('Give me Your Name: ', "Demon Lord");
+ $this->assertEquals('Demon Lord', $input);
+ $this->AssertEquals([
+ "\e[1;37mGive me Your Name:\e[0m\e[94m Enter = 'Demon Lord'\e[0m\n"
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testGetInput03() {
+ $command = new TestCommand('cool');
+ $ansiArg = new Argument('--ansi');
+ $ansiArg->setValue('');
+ $command->addArgument($ansiArg);
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ "",
+ ]));
+ $input = $command->getInput('Give me Your Name: ');
+ $this->assertEquals('', $input);
+ $this->AssertEquals([
+ "\e[1;37mGive me Your Name:\e[0m\n"
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testGetInput04() {
+ $command = new TestCommand('cool');
+ $ansiArg = new Argument('--ansi');
+ $ansiArg->setValue('');
+ $command->addArgument($ansiArg);
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ "",
+ "SisPro"
+ ]));
+ $input = $command->getInput('Give me Your Name: ', null, new InputValidator(function ($val) {
+ $trim = trim($val);
+ if (strlen($val) == 0) {
+ return false;
+ }
+ return true;
+ }));
+ $this->assertEquals('SisPro', $input);
+ $this->AssertEquals([
+ "\e[1;37mGive me Your Name:\e[0m\n",
+ "\e[1;91mError: \e[0mInvalid input is given. Try again.\n",
+ "\e[1;37mGive me Your Name:\e[0m\n",
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testGetInput05() {
+ $command = new TestCommand('cool');
+ $ansiArg = new Argument('--ansi');
+ $ansiArg->setValue('');
+ $command->addArgument($ansiArg);
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ "",
+ "SisPro"
+ ]));
+ $input = $command->getInput('Give me Your Name: ', null, new InputValidator(function ($val) {
+ $trim = trim($val);
+ if (strlen($val) == 0) {
+ return false;
+ }
+ return true;
+ }, 'Wrong Input.'));
+ $this->assertEquals('SisPro', $input);
+ $this->AssertEquals([
+ "\e[1;37mGive me Your Name:\e[0m\n",
+ "\e[1;91mError: \e[0mWrong Input.\n",
+ "\e[1;37mGive me Your Name:\e[0m\n",
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testGetInput06() {
+ $command = new TestCommand('cool');
+ $ansiArg = new Argument('--ansi');
+ $ansiArg->setValue('');
+ $command->addArgument($ansiArg);
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ "SisPro"
+ ]));
+ $input = $command->getInput('Give me Your Name: ', null, new InputValidator(function ($val, $hello) {
+ if ($hello == 'Hello') {
+ return true;
+ }
+ return true;
+ }, 'Wrong Input.', [
+ 'Hello'
+ ]));
+ $this->assertEquals('SisPro', $input);
+ $this->AssertEquals([
+ "\e[1;37mGive me Your Name:\e[0m\n",
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testRead00() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ '445',
+ "Hello World!\r\n",
+ "Super"
+ ]));
+ $this->assertEquals('445', $command->readln());
+ $this->assertEquals('Hello', $command->read(5));
+ $this->assertEquals(" World!\r\n", $command->readln());
+ $this->assertEquals('Super', $command->readln());
+ }
+ /**
+ * @test
+ */
+ public function testReadInteger00() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ '445',
+ ]));
+ $input = $command->readInteger('Give me an integer:');
+ $this->assertSame(445, $input);
+ }
+ /**
+ * @test
+ */
+ public function testReadInteger01() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ '',
+ ]));
+ $input = $command->readInteger('Give me an integer:', 88);
+ $this->assertSame(88, $input);
+ }
+ /**
+ * @test
+ */
+ public function testReadInteger02() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ 'uu8',
+ '998&9',
+ '100'
+ ]));
+ $input = $command->readInteger('Give me an integer:', 88);
+ $this->assertSame(100, $input);
+ $this->assertequals([
+ "Give me an integer: Enter = '88'\n",
+ "Error: Provided value is not an integer!\n",
+ "Give me an integer: Enter = '88'\n",
+ "Error: Provided value is not an integer!\n",
+ "Give me an integer: Enter = '88'\n",
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testReadFloat00() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ '445.1',
+ ]));
+ $input = $command->readFloat('Give me a float:');
+ $this->assertSame(445.1, $input);
+ }
+ /**
+ * @test
+ */
+ public function testReadFloat01() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ '',
+ ]));
+ $input = $command->readFloat('Give me a float:', 88.98876);
+ $this->assertSame(88.98876, $input);
+ }
+ /**
+ * @test
+ */
+ public function testReadFloat02() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ 'u.u8',
+ '998.9.9',
+ '100.998'
+ ]));
+ $input = $command->readFloat('Give me a float:', 88);
+ $this->assertSame(100.998, $input);
+ $this->assertequals([
+ "Give me a float: Enter = '88'\n",
+ "Error: Provided value is not a floating number!\n",
+ "Give me a float: Enter = '88'\n",
+ "Error: Provided value is not a floating number!\n",
+ "Give me a float: Enter = '88'\n",
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testReadInstance00() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ '\\WebFiori\\Tests\\TestStudentXO',
+ '\WebFiori\Tests\TestStudent',
+ ]));
+ $input = $command->readInstance('Give me class:', 'Not a class!');
+ $this->assertTrue($input instanceof TestStudent);
+ $this->assertequals([
+ "Give me class:\n",
+ "Error: Not a class!\n",
+ "Give me class:\n",
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testReadInstance01() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ '\WebFiori\Tests\TestStudent2',
+ '\WebFiori\Tests\TestStudent',
+ ]));
+ $input = $command->readInstance('Give me class:', 'Not a class!');
+ $this->assertTrue($input instanceof TestStudent);
+ $this->assertequals([
+ "Give me class:\n",
+ "Error: Not a class!\n",
+ "Give me class:\n",
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testReadClassName00() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ 'SuperClass',
+ ]));
+ $input = $command->readClassName('Give me class name:');
+ $this->assertEquals('SuperClass', $input);
+ $this->assertequals([
+ "Give me class name:\n",
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testReadClassName01() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ 'Super Class',
+ "ValidSuper"
+ ]));
+ $input = $command->readClassName('Give me class name:', null, 'Not valid Class Name!');
+ $this->assertEquals('ValidSuper', $input);
+ $this->assertequals([
+ "Give me class name:\n",
+ "Error: Not valid Class Name!\n",
+ "Give me class name:\n",
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testReadClassName02() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ 'Super Class',
+ "ValidSuper"
+ ]));
+ $input = $command->readClassName('Give me class name:', 'Suffix', 'Not valid Class Name!');
+ $this->assertEquals('ValidSuperSuffix', $input);
+ $this->assertequals([
+ "Give me class name:\n",
+ "Error: Not valid Class Name!\n",
+ "Give me class name:\n",
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testReadClassName03() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ 'Super Class',
+ "ValidSuperXUYYS"
+ ]));
+ $input = $command->readClassName('Give me class name:', 'XUYYS', 'Not valid Class Name!');
+ $this->assertEquals('ValidSuperXUYYS', $input);
+ $this->assertequals([
+ "Give me class name:\n",
+ "Error: Not valid Class Name!\n",
+ "Give me class name:\n",
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testReadClassName04() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ 'Super Class',
+ "ValidSuperXUYYS"
+ ]));
+ $input = $command->readClassName('Give me class name:', '12X', 'Not valid Class Name!');
+ $this->assertEquals('ValidSuperXUYYS12X', $input);
+ $this->assertequals([
+ "Give me class name:\n",
+ "Error: Not valid Class Name!\n",
+ "Give me class name:\n",
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testReadNamespace00() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ '\\webfiori\\tests\\',
+ ]));
+ $input = $command->readNamespace('Give me class namespace:');
+ $this->assertEquals('\\webfiori\\tests\\', $input);
+ $this->assertequals([
+ "Give me class namespace:\n",
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testReadNamespace01() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ '\\webfiori\\tests',
+ ]));
+ $input = $command->readNamespace('Give me class namespace:');
+ $this->assertEquals('\\webfiori\\tests', $input);
+ $this->assertequals([
+ "Give me class namespace:\n",
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testReadNamespace02() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ 'webfiori\\tests',
+ ]));
+ $input = $command->readNamespace('Give me class namespace:');
+ $this->assertEquals('webfiori\\tests', $input);
+ $this->assertequals([
+ "Give me class namespace:\n",
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testReadNamespace03() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ '/webfiori\\tests',
+ "",
+ 'webfiori\\tests',
+ ]));
+ $input = $command->readNamespace('Give me class namespace:', null, "Please provide a valid NS!");
+ $this->assertEquals('webfiori\\tests', $input);
+ $this->assertequals([
+ "Give me class namespace:\n",
+ "Error: Please provide a valid NS!\n",
+ "Give me class namespace:\n",
+ "Error: Please provide a valid NS!\n",
+ "Give me class namespace:\n",
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testReadNamespace04() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ '\\',
+ ]));
+ $input = $command->readNamespace('Give me class namespace:', null, "Please provide a valid NS!");
+ $this->assertEquals('\\', $input);
+ $this->assertequals([
+ "Give me class namespace:\n",
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testReadNamespace05() {
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ '',
+ ]));
+ $input = $command->readNamespace('Give me class namespace:', 'wfx\\xyz', "Please provide a valid NS!");
+ $this->assertEquals('wfx\\xyz', $input);
+ $this->assertequals([
+ "Give me class namespace: Enter = 'wfx\xyz'\n",
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function testReadNamespace06() {
+ $this->expectException(IOException::class);
+ $this->expectExceptionMessage('Provided default namespace is not valid.');
+
+ $command = new TestCommand('cool');
+ $command->setOutputStream(new ArrayOutputStream());
+ $command->setInputStream(new ArrayInputStream([
+ '',
+ ]));
+ $input = $command->readNamespace('Give me class namespace:', 'wfx//xyz', "Please provide a valid NS!");
+ $this->assertEquals('wfx\\xyz', $input);
+ $this->assertequals([
+ "Give me class namespace: Enter = 'wfx\xyz'\n",
+ ], $command->getOutputStream()->getOutputArray());
+ }
+ /**
+ * @test
+ */
+ public function test00() {
+ $command = new TestCommand('new-command');
+ $this->assertEquals($command->getName(), 'new-command');
+ $this->assertEquals('', $command->getDescription());
+ $this->assertEquals(0, count($command->getArgs()));
+ }
+ /**
+ * @test
+ */
+ public function test01() {
+ $command = new TestCommand('new-command');
+ $command->println('%30s', 'ok');
+ $this->assertTrue(true);
+ }
+ /**
+ * @test
+ */
+ public function test03() {
+ $command = new TestCommand('with space');
+ $this->assertEquals('new-command', $command->getName());
+ $this->assertEquals('', $command->getDescription());
+ }
+ /**
+ * @test
+ */
+ public function testAddArg00() {
+ $command = new TestCommand('new-command');
+ $this->assertFalse($command->addArg(''));
+ $this->assertFalse($command->addArg('with space'));
+ $this->assertFalse($command->addArg(' '));
+ $this->assertFalse($command->addArg('invalid name'));
+ $this->assertTrue($command->addArg('valid'));
+ $this->assertTrue($command->addArg('--valid-name'));
+ $this->assertTrue($command->addArg('0invalid'));
+ $this->assertTrue($command->addArg('valid-1'));
+ $this->assertEquals([
+ 'valid',
+ '--valid-name',
+ '0invalid',
+ 'valid-1'
+ ], $command->getArgsNames());
+ }
+ /**
+ * @test
+ */
+ public function testAddArg01() {
+ $command = new TestCommand('new-command');
+ $this->assertTrue($command->addArg('default-options'));
+ $argDetails = $command->getArg('default-options');
+ $this->assertEquals('', $argDetails->getDescription());
+ $this->assertFalse($argDetails->isOptional());
+ $this->assertEquals([], $argDetails->getAllowedValues());
+ }
+ /**
+ * @test
+ */
+ public function testAddArg02() {
+ $command = new TestCommand('new-command');
+ $this->assertTrue($command->addArg('default-options', [
+ ArgumentOption::OPTIONAL => true
+ ]));
+ $argDetails = $command->getArg('default-options');
+ $this->assertEquals('', $argDetails->getDescription());
+ $this->assertTrue($argDetails->isOptional());
+ $this->assertEquals([], $argDetails->getAllowedValues());
+ }
+ /**
+ * @test
+ */
+ public function testAddArg03() {
+ $command = new TestCommand('new');
+ $this->assertTrue($command->addArg('default-options', [
+ ArgumentOption::OPTIONAL => true
+ ]));
+ $argDetails = $command->getArg('default-options');
+ $this->assertEquals('', $argDetails->getDescription());
+ $this->assertTrue($argDetails->isOptional());
+ $this->assertEquals([], $argDetails->getAllowedValues());
+ }
+ /**
+ * @test
+ */
+ public function testAddArg04() {
+ $command = new TestCommand('new');
+ $this->assertTrue($command->addArg('default-options', [
+ ArgumentOption::OPTIONAL => true
+ ]));
+ $this->assertFalse($command->addArg('default-options'));
+ }
+ /**
+ * @test
+ */
+ public function testAddArg05() {
+ $command = new TestCommand('new');
+ $this->assertTrue($command->addArg('default-options', [
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DESCRIPTION => ' ',
+ ArgumentOption::DEFAULT => 'ok , good '
+ ]));
+ $arg = $command->getArg('default-options');
+ $this->assertEquals('', $arg->getDescription());
+ $this->assertEquals('ok , good', $arg->getDefault());
+ }
+ /**
+ * @test
+ */
+ public function testClear00() {
+ $runner = new Runner();
+ $runner->setOutputStream(new ArrayOutputStream());
+ $runner->setInputs([]);
+ $command = new TestCommand('hello', [
+ 'name' => [
+
+ ]
+ ]);
+ $runner->runCommand($command, [
+ 'name' => 'Ibrahim'
+ ]);
+ $command->clearConsole();
+ $this->assertEquals([
+ "Hello Ibrahim!\n",
+ "Ok\n",
+ "\ec"
+ ], $runner->getOutput());
+ }
+ /**
+ * @test
+ */
+ public function testClear01() {
+ $runner = new Runner();
+ $runner->setOutputStream(new ArrayOutputStream());
+ $runner->setInputs([]);
+ $command = new TestCommand('hello', [
+ 'name' => [
+
+ ]
+ ]);
+ $runner->runCommand($command, [
+ 'name' => 'Ibrahim'
+ ]);
+ $command->clearLine();
+ $this->assertEquals([
+ "Hello Ibrahim!\n",
+ "Ok\n",
+ "\e[2K\r"
+ ], $runner->getOutput());
+ }
+ /**
+ * @test
+ */
+ public function testClear02() {
+ $runner = new Runner();
+ $runner->setOutputStream(new ArrayOutputStream());
+ $runner->setInputs([]);
+ $command = new TestCommand('hello', [
+ 'name' => [
+
+ ]
+ ]);
+ $runner->runCommand($command, [
+ 'name' => 'Ibrahim'
+ ]);
+ $command->clear(1);
+ $this->assertEquals([
+ "Hello Ibrahim!\n",
+ "Ok\n",
+ "\e[1D \e[1D\e[1C"
+ ], $runner->getOutput());
+ }
+ /**
+ * @test
+ */
+ public function testClear03() {
+ $runner = new Runner();
+ $runner->setOutputStream(new ArrayOutputStream());
+ $runner->setInputs([]);
+ $command = new TestCommand('hello', [
+ 'name' => [
+
+ ]
+ ]);
+ $runner->runCommand($command, [
+ 'name' => 'Ibrahim'
+ ]);
+ $command->clear(2);
+ $this->assertEquals([
+ "Hello Ibrahim!\n",
+ "Ok\n",
+ "\e[1D \e[1D\e[1D \e[1D\e[2C"
+ ], $runner->getOutput());
+ }
+ /**
+ * @test
+ */
+ public function testClear05() {
+ $runner = new Runner();
+ $runner->setOutputStream(new ArrayOutputStream());
+ $runner->setInputs([]);
+ $command = new TestCommand('hello', [
+ 'name' => [
+
+ ]
+ ]);
+ $runner->runCommand($command, [
+ 'name' => 'Ibrahim'
+ ]);
+ $command->clear(1, false);
+ $this->assertEquals([
+ "Hello Ibrahim!\n",
+ "Ok\n",
+ "\e[1C \e[2D"
+ ], $runner->getOutput());
+ }
+ /**
+ * @test
+ */
+ public function testClear06() {
+ $runner = new Runner();
+ $runner->setOutputStream(new ArrayOutputStream());
+ $runner->setInputs([]);
+ $command = new TestCommand('hello', [
+ 'name' => [
+
+ ]
+ ]);
+ $runner->runCommand($command, [
+ 'name' => 'Ibrahim'
+ ]);
+ $command->clear(2, false);
+ $this->assertEquals([
+ "Hello Ibrahim!\n",
+ "Ok\n",
+ "\e[1C \e[3D"
+ ], $runner->getOutput());
+ }
+ /**
+ * @test
+ */
+ public function testMove00() {
+ $runner = new Runner();
+ $runner->setOutputStream(new ArrayOutputStream());
+ $runner->setInputs([]);
+ $command = new TestCommand('hello', [
+ 'name' => [
+
+ ]
+ ]);
+ $runner->runCommand($command, [
+ 'name' => 'Ibrahim'
+ ]);
+ $command->moveCursorDown(3);
+ $command->moveCursorDown(6);
+ $command->moveCursorLeft(88);
+ $command->moveCursorRight(4);
+ $this->assertEquals([
+ "Hello Ibrahim!\n",
+ "Ok\n",
+ "\e[3B\e[6B\e[88D\e[4C"
+ ], $runner->getOutput());
+ }
+ /**
+ * @test
+ */
+ public function testMove01() {
+ $runner = new Runner();
+ $runner->setOutputStream(new ArrayOutputStream());
+ $runner->setInputs([]);
+ $command = new TestCommand('hello', [
+ 'name' => [
+
+ ]
+ ]);
+ $runner->runCommand($command, [
+ 'name' => 'Ibrahim'
+ ]);
+ $command->moveCursorDown(3);
+ $command->moveCursorDown(6);
+ $command->moveCursorLeft(88);
+ $command->moveCursorRight(4);
+ $this->assertEquals([
+ "Hello Ibrahim!\n",
+ "Ok\n",
+ "\e[3B\e[6B\e[88D\e[4C"
+ ], $runner->getOutput());
+ }
+ /**
+ * @test
+ */
+ public function testPrintList00() {
+ $runner = new Runner();
+ $runner->setOutputStream(new ArrayOutputStream());
+ $runner->setOutputStream(new ArrayOutputStream());
+ $runner->setInputs([]);
+ $command = new TestCommand('hello');
+ $runner->runCommand($command);
+ $command->printList([
+ 'one',
+ 'two',
+ 'three'
+ ]);
+ $this->assertEquals([
+ "Hello !\n",
+ "Ok\n",
+ "- one\n",
+ "- two\n",
+ "- three\n"
+ ], $runner->getOutput());
+ }
+ /**
+ * @test
+ */
+ public function testPrintList01() {
+ $runner = new Runner();
+ $runner->setOutputStream(new ArrayOutputStream());
+ $runner->setOutputStream(new ArrayOutputStream());
+ $runner->setInputs([]);
+ $command = new TestCommand('hello');
+ $runner->runCommand($command, [
+ '--ansi'
+ ]);
+ $command->printList([
+ 'one',
+ 'two',
+ 'three'
+ ]);
+ $this->assertEquals([
+ "\e[31mHello !\e[0m\n",
+ "Ok\n",
+ "- one\n",
+ "- two\n",
+ "- three\n"
+ ], $runner->getOutput());
+ }
+ /**
+ * @test
+ */
+ public function testSetArgVal00() {
+ $command = new TestCommand('ok', [
+ 'one' => [
+
+ ],
+ 'two' => [
+
+ ]
+ ]);
+ $this->assertFalse($command->isArgProvided('one'));
+ $this->assertTrue($command->setArgValue('one', 1));
+ $this->assertTrue($command->isArgProvided('one'));
+ $arg = $command->getArg('one');
+ $this->assertEquals(1, $arg->getValue());
+ $this->assertFalse($command->isArgProvided('two'));
+ $this->assertTrue($command->setArgValue('two'));
+ $this->assertTrue($command->isArgProvided('two'));
+ $this->assertEquals('', $command->getArgValue('two'));
+ $this->assertFalse($command->setArgValue('not-exist'));
+ }
+
+ // ========== ENHANCED COMMAND TESTS ==========
+
+ /**
+ * Test command aliases functionality
+ * @test
+ */
+ public function testCommandAliasesEnhanced() {
+ $command = new TestCommand('test-cmd', [], 'Test command', ['tc', 'test']);
+
+ // Note: The actual implementation might not store aliases in the command itself
+ // but rather in the runner. Let's test what we can verify.
+ $this->assertEquals('test-cmd', $command->getName());
+
+ // Test that aliases are passed to constructor (even if not stored in command)
+ $this->assertIsArray($command->getAliases());
+ }
+
+ /**
+ * Test command description edge cases
+ * @test
+ */
+ public function testCommandDescriptionEdgeCasesEnhanced() {
+ // Test with empty description
+ $command = new TestCommand('test-cmd', [], '');
+ $this->assertEquals('', $command->getDescription());
+
+ // Test setting description after construction
+ $this->assertTrue($command->setDescription('New description'));
+ $this->assertEquals('New description', $command->getDescription());
+
+ // Test setting empty description
+ $this->assertFalse($command->setDescription(''));
+ $this->assertEquals('New description', $command->getDescription()); // Should remain unchanged
+ }
+
+ /**
+ * Test command name validation
+ * @test
+ */
+ public function testCommandNameValidationEnhanced() {
+ // Test invalid names
+ $command = new TestCommand('');
+ $this->assertEquals('new-command', $command->getName()); // Should fallback to default
+
+ $command2 = new TestCommand('invalid name with spaces');
+ $this->assertEquals('new-command', $command2->getName()); // Should fallback to default
+
+ // Test valid name setting
+ $command3 = new TestCommand('valid-name');
+ $this->assertTrue($command3->setName('another-valid-name'));
+ $this->assertEquals('another-valid-name', $command3->getName());
+
+ // Test invalid name setting
+ $this->assertFalse($command3->setName(''));
+ $this->assertEquals('another-valid-name', $command3->getName()); // Should remain unchanged
+ }
+
+ /**
+ * Test argument handling edge cases
+ * @test
+ */
+ public function testArgumentHandlingEdgeCasesEnhanced() {
+ $command = new TestCommand('test-cmd');
+
+ // Test adding argument with all options
+ $this->assertTrue($command->addArg('--test-arg', [
+ ArgumentOption::OPTIONAL => false,
+ ArgumentOption::DESCRIPTION => 'Test argument',
+ ArgumentOption::DEFAULT => 'default-value',
+ ArgumentOption::VALUES => ['val1', 'val2', 'val3']
+ ]));
+
+ // Test duplicate argument
+ $this->assertFalse($command->addArg('--test-arg', [])); // Should fail for duplicate
+
+ // Test getting non-existent argument
+ $this->assertNull($command->getArg('--non-existent'));
+
+ // Test checking if argument exists
+ $this->assertTrue($command->hasArg('--test-arg'));
+ $this->assertFalse($command->hasArg('--non-existent'));
+
+ // Test getting argument names
+ $argNames = $command->getArgsNames();
+ $this->assertContains('--test-arg', $argNames);
+ }
+
+ /**
+ * Test cursor movement methods
+ * @test
+ */
+ public function testCursorMovementMethodsEnhanced() {
+ $command = new TestCommand('test-cmd');
+ $output = new ArrayOutputStream();
+ $command->setOutputStream($output);
+
+ // Test cursor movements
+ $command->moveCursorUp(5);
+ $command->moveCursorDown(3);
+ $command->moveCursorLeft(2);
+ $command->moveCursorRight(4);
+ $command->moveCursorTo(10, 20);
+
+ $outputArray = $output->getOutputArray();
+ $this->assertNotEmpty($outputArray);
+
+ // Test with invalid values (should be handled gracefully)
+ $command->moveCursorUp(-1); // Should be ignored or handled
+ $command->moveCursorDown(0);
+ $command->moveCursorLeft(-5);
+ $command->moveCursorRight(0);
+ }
+
+ /**
+ * Test screen clearing methods
+ * @test
+ */
+ public function testScreenClearingMethodsEnhanced() {
+ $command = new TestCommand('test-cmd');
+ $output = new ArrayOutputStream();
+ $command->setOutputStream($output);
+
+ // Test clear methods
+ $result1 = $command->clear(5, true);
+ $this->assertInstanceOf(TestCommand::class, $result1); // Should return self
+
+ $result2 = $command->clear(3, false);
+ $this->assertInstanceOf(TestCommand::class, $result2);
+
+ $result3 = $command->clearConsole();
+ $this->assertInstanceOf(TestCommand::class, $result3);
+
+ $command->clearLine();
+
+ $outputArray = $output->getOutputArray();
+ $this->assertNotEmpty($outputArray);
+ }
+
+ /**
+ * Test input reading methods
+ * @test
+ */
+ public function testInputReadingMethodsEnhanced() {
+ $command = new TestCommand('test-cmd');
+ $input = new ArrayInputStream(['test input', '42', '3.14']);
+ $command->setInputStream($input);
+
+ // Test basic input reading
+ $result = $command->readln();
+ $this->assertEquals('test input', $result);
+
+ // Test reading integer
+ $intResult = $command->readInteger('Enter number: ');
+ $this->assertEquals(42, $intResult);
+
+ // Test reading float
+ $floatResult = $command->readFloat('Enter float: ');
+ $this->assertEquals(3.14, $floatResult);
+ }
+
+ /**
+ * Test confirmation dialog
+ * @test
+ */
+ public function testConfirmationDialogEnhanced() {
+ $command = new TestCommand('test-cmd');
+
+ // Test with 'y' input
+ $input1 = new ArrayInputStream(['y']);
+ $command->setInputStream($input1);
+ $result1 = $command->confirm('Continue?');
+ $this->assertTrue($result1);
+
+ // Test with 'n' input
+ $input2 = new ArrayInputStream(['n']);
+ $command->setInputStream($input2);
+ $result2 = $command->confirm('Continue?');
+ $this->assertFalse($result2);
+
+ // Test with default value
+ $input3 = new ArrayInputStream(['']); // Empty input
+ $command->setInputStream($input3);
+ $result3 = $command->confirm('Continue?', true);
+ $this->assertTrue($result3); // Should use default
+ }
+
+ /**
+ * Test selection method
+ * @test
+ */
+ public function testSelectionMethodEnhanced() {
+ $command = new TestCommand('test-cmd');
+ $output = new ArrayOutputStream();
+ $command->setOutputStream($output);
+
+ $choices = ['Option 1', 'Option 2', 'Option 3'];
+
+ // Test valid selection
+ $input = new ArrayInputStream(['2']);
+ $command->setInputStream($input);
+ $result = $command->select('Choose option:', $choices);
+ $this->assertEquals('Option 3', $result); // Index 2 = Option 3 (0-based indexing)
+
+ // Test with default
+ $input2 = new ArrayInputStream(['']); // Empty input
+ $command->setInputStream($input2);
+ $result2 = $command->select('Choose option:', $choices, 0);
+ $this->assertEquals('Option 1', $result2); // Should use default index
+ }
+
+ /**
+ * Test list printing
+ * @test
+ */
+ public function testListPrintingMethodEnhanced() {
+ $command = new TestCommand('test-cmd');
+ $output = new ArrayOutputStream();
+ $command->setOutputStream($output);
+
+ $items = ['Item 1', 'Item 2', 'Item 3'];
+ $command->printList($items);
+
+ $outputArray = $output->getOutputArray();
+ $this->assertNotEmpty($outputArray);
+
+ // Test with string values only
+ $output->reset();
+ $stringItems = ['value1', 'value2'];
+ $command->printList($stringItems);
+ }
+
+ /**
+ * Test message formatting methods
+ * @test
+ */
+ public function testMessageFormattingMethodsEnhanced() {
+ $command = new TestCommand('test-cmd');
+ $output = new ArrayOutputStream();
+ $command->setOutputStream($output);
+
+ // Test different message types
+ $command->error('Error message');
+ $command->warning('Warning message');
+ $command->info('Info message');
+ $command->success('Success message');
+
+ $outputArray = $output->getOutputArray();
+ $this->assertCount(4, $outputArray);
+
+ // Test with ANSI enabled
+ $ansiArg = new Argument('--ansi');
+ $ansiArg->setValue('');
+ $command->addArgument($ansiArg);
+
+ $output2 = new ArrayOutputStream();
+ $command->setOutputStream($output2);
+
+ $command->error('ANSI Error');
+ $command->warning('ANSI Warning');
+ $command->info('ANSI Info');
+ $command->success('ANSI Success');
+
+ $ansiOutputArray = $output2->getOutputArray();
+ $this->assertCount(4, $ansiOutputArray);
+
+ // ANSI output should contain escape sequences
+ $this->assertStringContainsString("\e[", $ansiOutputArray[0]);
+ }
+
+ /**
+ * Test argument removal
+ * @test
+ */
+ public function testArgumentRemovalMethodEnhanced() {
+ $command = new TestCommand('test-cmd');
+
+ // Add some arguments
+ $command->addArg('--arg1', []);
+ $command->addArg('--arg2', []);
+ $command->addArg('--arg3', []);
+
+ $this->assertTrue($command->hasArg('--arg1'));
+ $this->assertTrue($command->hasArg('--arg2'));
+ $this->assertTrue($command->hasArg('--arg3'));
+
+ // Remove an argument
+ $this->assertTrue($command->removeArgument('--arg2'));
+ $this->assertFalse($command->hasArg('--arg2'));
+ $this->assertTrue($command->hasArg('--arg1')); // Others should remain
+ $this->assertTrue($command->hasArg('--arg3'));
+
+ // Try to remove non-existent argument
+ $this->assertFalse($command->removeArgument('--non-existent'));
+ }
+
+ /**
+ * Test input validation with InputValidator
+ * @test
+ */
+ public function testInputValidationMethodEnhanced() {
+ $command = new TestCommand('test-cmd');
+
+ // Test with a simple validation function
+ $validator = new InputValidator(
+ function(string &$input): bool {
+ return strlen($input) >= 3;
+ },
+ 'Input must be at least 3 characters long'
+ );
+
+ // Test valid input
+ $input1 = new ArrayInputStream(['valid']);
+ $command->setInputStream($input1);
+ $result1 = $command->getInput('Enter text: ', null, $validator);
+ $this->assertEquals('valid', $result1);
+
+ // Test with default value
+ $input2 = new ArrayInputStream(['']);
+ $command->setInputStream($input2);
+ $result2 = $command->getInput('Enter text: ', 'default', $validator);
+ $this->assertEquals('default', $result2);
+ }
+
+ /**
+ * Test owner (Runner) relationship
+ * @test
+ */
+ public function testOwnerRelationshipMethodEnhanced() {
+ $command = new TestCommand('test-cmd');
+ $runner = new Runner();
+ $runner->setOutputStream(new ArrayOutputStream());
+
+ // Initially no owner
+ $this->assertNull($command->getOwner());
+
+ // Set owner
+ $command->setOwner($runner);
+ $this->assertSame($runner, $command->getOwner());
+
+ // Clear owner
+ $command->setOwner(null);
+ $this->assertNull($command->getOwner());
+ }
+
+ /**
+ * Test sub-command execution
+ * @test
+ */
+ public function testSubCommandExecutionMethodEnhanced() {
+ $command = new TestCommand('main-cmd');
+ $runner = new Runner();
+ $runner->setOutputStream(new ArrayOutputStream());
+ $subCommand = new TestCommand('sub-cmd');
+
+ $runner->register($command);
+ $runner->register($subCommand);
+ $command->setOwner($runner);
+
+ // Test executing sub-command
+ $result = $command->execSubCommand('sub-cmd');
+ $this->assertEquals(0, $result); // Assuming TestCommand returns 0
+
+ // Test executing non-existent sub-command
+ $result2 = $command->execSubCommand('non-existent');
+ $this->assertEquals(-1, $result2); // Should return error code
+ }
+
+ /**
+ * Test argument provided checking
+ * @test
+ */
+ public function testArgumentProvidedCheckingMethodEnhanced() {
+ $command = new TestCommand('test-cmd');
+ $command->addArg('--test-arg', [ArgumentOption::OPTIONAL => true]);
+
+ // Initially not provided
+ $this->assertFalse($command->isArgProvided('--test-arg'));
+
+ // Set value
+ $command->setArgValue('--test-arg', 'value');
+ $this->assertTrue($command->isArgProvided('--test-arg'));
+
+ // Test non-existent argument
+ $this->assertFalse($command->isArgProvided('--non-existent'));
+ }
+
+ /**
+ * Test stream getters and setters
+ * @test
+ */
+ public function testStreamHandlingMethodEnhanced() {
+ $command = new TestCommand('test-cmd');
+
+ // Test default streams
+ $this->assertNotNull($command->getInputStream());
+ $this->assertNotNull($command->getOutputStream());
+
+ // Test setting custom streams
+ $customInput = new ArrayInputStream(['test']);
+ $customOutput = new ArrayOutputStream();
+
+ $command->setInputStream($customInput);
+ $command->setOutputStream($customOutput);
+
+ $this->assertSame($customInput, $command->getInputStream());
+ $this->assertSame($customOutput, $command->getOutputStream());
+ }
+
+ /**
+ * Test reading with byte limit
+ * @test
+ */
+ public function testReadWithByteLimitMethodEnhanced() {
+ $command = new TestCommand('test-cmd');
+ $input = new ArrayInputStream(['hello world']);
+ $command->setInputStream($input);
+
+ // Test reading specific number of bytes
+ $result = $command->read(5);
+ $this->assertEquals('hello', $result);
+ }
+
+ /**
+ * Test command execution wrapper
+ * @test
+ */
+ public function testCommandExecutionWrapperMethodEnhanced() {
+ $command = new TestCommand('test-cmd');
+ $output = new ArrayOutputStream();
+ $command->setOutputStream($output);
+
+ // Test successful execution
+ $result = $command->excCommand();
+ $this->assertEquals(0, $result);
+
+ // The excCommand method should call exec() and handle any exceptions
+ $outputArray = $output->getOutputArray();
+ $this->assertNotEmpty($outputArray); // TestCommand should produce some output
+ }
+
+ /**
+ * Test select with multiple invalid inputs then empty input (framework scenario)
+ * @test
+ */
+ public function testSelectFrameworkScenario() {
+ $command = new TestCommand('test-cmd');
+ $output = new ArrayOutputStream();
+ $command->setOutputStream($output);
+
+ // Mimic framework test: empty input, invalid input 'XC', then valid input '0'
+ $input = new ArrayInputStream(['', 'XC', '0']);
+ $command->setInputStream($input);
+
+ $choices = ['AR', 'EN'];
+ $result = $command->select('In which language you would like to update?', $choices);
+
+ $this->assertEquals('AR', $result);
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/CommandArgumentTest.php b/tests/WebFiori/Tests/Cli/CommandArgumentTest.php
index 32c2183..283f6ee 100644
--- a/tests/WebFiori/Tests/Cli/CommandArgumentTest.php
+++ b/tests/WebFiori/Tests/Cli/CommandArgumentTest.php
@@ -1,125 +1,125 @@
-assertEquals('ibrahim', Argument::extractValue('name'));
- }
- /**
- * @test
- */
- public function extractValueTest01() {
- $_SERVER['argv'] = [
- 'name=ibrahim'
- ];
- $r = new Runner();
- $r->setArgsVector([
- 'name=ali'
- ]);
- $this->assertEquals('ali', Argument::extractValue('name', $r));
- }
- /**
- * @test
- */
- public function extractValueTest03() {
- $_SERVER['argv'] = [
- 'name="ibrahim Ali"',
- "last-name='bin'"
- ];
- $this->assertEquals('ibrahim Ali', Argument::extractValue('name'));
- $this->assertEquals('bin', Argument::extractValue('last-name'));
- }
- /**
- * @test
- */
- public function test00() {
- $arg = new Argument();
- $this->assertNull($arg->getValue());
- $this->assertEquals('', $arg->getDefault());
- $this->assertEquals('', $arg->getDescription());
- $arg->setDescription(' Cool Arg ');
- $this->assertEquals('Cool Arg', $arg->getDescription());
- $arg->setDescription(' ');
- $this->assertEquals('', $arg->getDescription());
- $this->assertEquals('arg', $arg->getName());
- $this->assertFalse($arg->isOptional());
- $arg->setIsOptional(true);
- $this->assertTrue($arg->isOptional());
- $arg->setIsOptional(false);
- $this->assertFalse($arg->isOptional());
- $this->assertEquals([], $arg->getAllowedValues());
- $this->assertNull($arg->getValue());
- }
- /**
- * @test
- */
- public function test01() {
- $arg = new Argument('');
- $this->assertEquals('arg', $arg->getName());
- }
- /**
- * @test
- */
- public function test02() {
- $arg = new Argument('--config');
- $this->assertNull($arg->getValue());
- $this->assertEquals('', $arg->getDefault());
- $this->assertEquals('', $arg->getDescription());
- $this->assertEquals('--config', $arg->getName());
- $this->assertFalse($arg->isOptional());
- $this->assertEquals([], $arg->getAllowedValues());
- $this->assertNull($arg->getValue());
- }
- /**
- * @test
- */
- public function testSetName() {
- $arg = new Argument(' ');
- $this->assertEquals('arg', $arg->getName());
- $this->assertTrue($arg->setName('my-val'));
- $this->assertEquals('my-val', $arg->getName());
- $this->assertFalse($arg->setName('with space'));
- $this->assertEquals('my-val', $arg->getName());
- $this->assertTrue($arg->setName(' --arg1 '));
- $this->assertEquals('--arg1', $arg->getName());
- }
- /**
- * @test
- */
- public function testSetValue00() {
- $arg = new Argument();
- $this->assertNull($arg->getValue());
- $arg->setValue('');
- $this->assertEquals('', $arg->getValue());
- $arg->setValue(' Super Lengthy String ');
- $this->assertEquals('Super Lengthy String', $arg->getValue());
- }
- /**
- * @test
- */
- public function testSetValue01() {
- $arg = new Argument();
- $this->assertNull($arg->getValue());
- $arg->addAllowedValue('Super');
- $this->assertFalse($arg->setValue(''));
- $this->assertNull($arg->getValue());
- $this->assertTrue($arg->setValue('Super'));
- $this->assertEquals('Super', $arg->getValue());
- }
-}
+assertEquals('ibrahim', Argument::extractValue('name'));
+ }
+ /**
+ * @test
+ */
+ public function extractValueTest01() {
+ $_SERVER['argv'] = [
+ 'name=ibrahim'
+ ];
+ $r = new Runner();
+ $r->setArgsVector([
+ 'name=ali'
+ ]);
+ $this->assertEquals('ali', Argument::extractValue('name', $r));
+ }
+ /**
+ * @test
+ */
+ public function extractValueTest03() {
+ $_SERVER['argv'] = [
+ 'name="ibrahim Ali"',
+ "last-name='bin'"
+ ];
+ $this->assertEquals('ibrahim Ali', Argument::extractValue('name'));
+ $this->assertEquals('bin', Argument::extractValue('last-name'));
+ }
+ /**
+ * @test
+ */
+ public function test00() {
+ $arg = new Argument();
+ $this->assertNull($arg->getValue());
+ $this->assertEquals('', $arg->getDefault());
+ $this->assertEquals('', $arg->getDescription());
+ $arg->setDescription(' Cool Arg ');
+ $this->assertEquals('Cool Arg', $arg->getDescription());
+ $arg->setDescription(' ');
+ $this->assertEquals('', $arg->getDescription());
+ $this->assertEquals('arg', $arg->getName());
+ $this->assertFalse($arg->isOptional());
+ $arg->setIsOptional(true);
+ $this->assertTrue($arg->isOptional());
+ $arg->setIsOptional(false);
+ $this->assertFalse($arg->isOptional());
+ $this->assertEquals([], $arg->getAllowedValues());
+ $this->assertNull($arg->getValue());
+ }
+ /**
+ * @test
+ */
+ public function test01() {
+ $arg = new Argument('');
+ $this->assertEquals('arg', $arg->getName());
+ }
+ /**
+ * @test
+ */
+ public function test02() {
+ $arg = new Argument('--config');
+ $this->assertNull($arg->getValue());
+ $this->assertEquals('', $arg->getDefault());
+ $this->assertEquals('', $arg->getDescription());
+ $this->assertEquals('--config', $arg->getName());
+ $this->assertFalse($arg->isOptional());
+ $this->assertEquals([], $arg->getAllowedValues());
+ $this->assertNull($arg->getValue());
+ }
+ /**
+ * @test
+ */
+ public function testSetName() {
+ $arg = new Argument(' ');
+ $this->assertEquals('arg', $arg->getName());
+ $this->assertTrue($arg->setName('my-val'));
+ $this->assertEquals('my-val', $arg->getName());
+ $this->assertFalse($arg->setName('with space'));
+ $this->assertEquals('my-val', $arg->getName());
+ $this->assertTrue($arg->setName(' --arg1 '));
+ $this->assertEquals('--arg1', $arg->getName());
+ }
+ /**
+ * @test
+ */
+ public function testSetValue00() {
+ $arg = new Argument();
+ $this->assertNull($arg->getValue());
+ $arg->setValue('');
+ $this->assertEquals('', $arg->getValue());
+ $arg->setValue(' Super Lengthy String ');
+ $this->assertEquals('Super Lengthy String', $arg->getValue());
+ }
+ /**
+ * @test
+ */
+ public function testSetValue01() {
+ $arg = new Argument();
+ $this->assertNull($arg->getValue());
+ $arg->addAllowedValue('Super');
+ $this->assertFalse($arg->setValue(''));
+ $this->assertNull($arg->getValue());
+ $this->assertTrue($arg->setValue('Super'));
+ $this->assertEquals('Super', $arg->getValue());
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/Discovery/CommandCacheTest.php b/tests/WebFiori/Tests/Cli/Discovery/CommandCacheTest.php
index 21b56a5..7abca5d 100644
--- a/tests/WebFiori/Tests/Cli/Discovery/CommandCacheTest.php
+++ b/tests/WebFiori/Tests/Cli/Discovery/CommandCacheTest.php
@@ -1,164 +1,164 @@
-tempCacheFile = sys_get_temp_dir() . '/test_commands_cache.json';
- $this->cache = new CommandCache($this->tempCacheFile, true);
- }
-
- protected function tearDown(): void {
- if (file_exists($this->tempCacheFile)) {
- unlink($this->tempCacheFile);
- }
- }
-
- /**
- * @test
- */
- public function testCacheEnabledByDefault() {
- $cache = new CommandCache();
- $this->assertTrue($cache->isEnabled());
- }
-
- /**
- * @test
- */
- public function testCacheCanBeDisabled() {
- $cache = new CommandCache('test.json', false);
- $this->assertFalse($cache->isEnabled());
- }
-
- /**
- * @test
- */
- public function testGetReturnsNullWhenCacheDisabled() {
- $this->cache->setEnabled(false);
- $result = $this->cache->get();
- $this->assertNull($result);
- }
-
- /**
- * @test
- */
- public function testGetReturnsNullWhenCacheFileDoesNotExist() {
- $result = $this->cache->get();
- $this->assertNull($result);
- }
-
- /**
- * @test
- */
- public function testStoreAndGet() {
- $commands = [
- ['className' => 'TestCommand', 'name' => 'test'],
- ['className' => 'AnotherCommand', 'name' => 'another']
- ];
- $files = [__FILE__];
-
- $this->cache->store($commands, $files);
-
- $this->assertTrue(file_exists($this->tempCacheFile));
-
- $retrieved = $this->cache->get();
- $this->assertEquals($commands, $retrieved);
- }
-
- /**
- * @test
- */
- public function testCacheInvalidatedWhenFileModified() {
- $tempFile = sys_get_temp_dir() . '/test_file.php';
- file_put_contents($tempFile, ' 'TestCommand', 'name' => 'test']];
- $files = [$tempFile];
-
- $this->cache->store($commands, $files);
-
- // Get the cached result first to ensure it works
- $result1 = $this->cache->get();
- $this->assertEquals($commands, $result1);
-
- // Modify the file with a significant time difference
- sleep(1); // Ensure different timestamp
- file_put_contents($tempFile, 'cache->get();
- $this->assertNull($result2, 'Cache should be invalidated after file modification');
-
- unlink($tempFile);
- }
-
- /**
- * @test
- */
- public function testCacheInvalidatedWhenFileDeleted() {
- $tempFile = sys_get_temp_dir() . '/test_file.php';
- file_put_contents($tempFile, ' 'TestCommand', 'name' => 'test']];
- $files = [$tempFile];
-
- $this->cache->store($commands, $files);
-
- // Delete the file
- unlink($tempFile);
-
- $result = $this->cache->get();
- $this->assertNull($result);
- }
-
- /**
- * @test
- */
- public function testClear() {
- $commands = [['className' => 'TestCommand', 'name' => 'test']];
- $files = [__FILE__];
-
- $this->cache->store($commands, $files);
- $this->assertTrue(file_exists($this->tempCacheFile));
-
- $this->cache->clear();
- $this->assertFalse(file_exists($this->tempCacheFile));
- }
-
- /**
- * @test
- */
- public function testSettersAndGetters() {
- $this->cache->setEnabled(false);
- $this->assertFalse($this->cache->isEnabled());
-
- $this->cache->setEnabled(true);
- $this->assertTrue($this->cache->isEnabled());
-
- $newCacheFile = '/tmp/new_cache.json';
- $this->cache->setCacheFile($newCacheFile);
- $this->assertEquals($newCacheFile, $this->cache->getCacheFile());
- }
-
- /**
- * @test
- */
- public function testStoreDoesNothingWhenDisabled() {
- $this->cache->setEnabled(false);
-
- $commands = [['className' => 'TestCommand', 'name' => 'test']];
- $files = [__FILE__];
-
- $this->cache->store($commands, $files);
-
- $this->assertFalse(file_exists($this->tempCacheFile));
- }
-}
+tempCacheFile = sys_get_temp_dir() . '/test_commands_cache.json';
+ $this->cache = new CommandCache($this->tempCacheFile, true);
+ }
+
+ protected function tearDown(): void {
+ if (file_exists($this->tempCacheFile)) {
+ unlink($this->tempCacheFile);
+ }
+ }
+
+ /**
+ * @test
+ */
+ public function testCacheEnabledByDefault() {
+ $cache = new CommandCache();
+ $this->assertTrue($cache->isEnabled());
+ }
+
+ /**
+ * @test
+ */
+ public function testCacheCanBeDisabled() {
+ $cache = new CommandCache('test.json', false);
+ $this->assertFalse($cache->isEnabled());
+ }
+
+ /**
+ * @test
+ */
+ public function testGetReturnsNullWhenCacheDisabled() {
+ $this->cache->setEnabled(false);
+ $result = $this->cache->get();
+ $this->assertNull($result);
+ }
+
+ /**
+ * @test
+ */
+ public function testGetReturnsNullWhenCacheFileDoesNotExist() {
+ $result = $this->cache->get();
+ $this->assertNull($result);
+ }
+
+ /**
+ * @test
+ */
+ public function testStoreAndGet() {
+ $commands = [
+ ['className' => 'TestCommand', 'name' => 'test'],
+ ['className' => 'AnotherCommand', 'name' => 'another']
+ ];
+ $files = [__FILE__];
+
+ $this->cache->store($commands, $files);
+
+ $this->assertTrue(file_exists($this->tempCacheFile));
+
+ $retrieved = $this->cache->get();
+ $this->assertEquals($commands, $retrieved);
+ }
+
+ /**
+ * @test
+ */
+ public function testCacheInvalidatedWhenFileModified() {
+ $tempFile = sys_get_temp_dir() . '/test_file.php';
+ file_put_contents($tempFile, ' 'TestCommand', 'name' => 'test']];
+ $files = [$tempFile];
+
+ $this->cache->store($commands, $files);
+
+ // Get the cached result first to ensure it works
+ $result1 = $this->cache->get();
+ $this->assertEquals($commands, $result1);
+
+ // Modify the file with a significant time difference
+ sleep(1); // Ensure different timestamp
+ file_put_contents($tempFile, 'cache->get();
+ $this->assertNull($result2, 'Cache should be invalidated after file modification');
+
+ unlink($tempFile);
+ }
+
+ /**
+ * @test
+ */
+ public function testCacheInvalidatedWhenFileDeleted() {
+ $tempFile = sys_get_temp_dir() . '/test_file.php';
+ file_put_contents($tempFile, ' 'TestCommand', 'name' => 'test']];
+ $files = [$tempFile];
+
+ $this->cache->store($commands, $files);
+
+ // Delete the file
+ unlink($tempFile);
+
+ $result = $this->cache->get();
+ $this->assertNull($result);
+ }
+
+ /**
+ * @test
+ */
+ public function testClear() {
+ $commands = [['className' => 'TestCommand', 'name' => 'test']];
+ $files = [__FILE__];
+
+ $this->cache->store($commands, $files);
+ $this->assertTrue(file_exists($this->tempCacheFile));
+
+ $this->cache->clear();
+ $this->assertFalse(file_exists($this->tempCacheFile));
+ }
+
+ /**
+ * @test
+ */
+ public function testSettersAndGetters() {
+ $this->cache->setEnabled(false);
+ $this->assertFalse($this->cache->isEnabled());
+
+ $this->cache->setEnabled(true);
+ $this->assertTrue($this->cache->isEnabled());
+
+ $newCacheFile = '/tmp/new_cache.json';
+ $this->cache->setCacheFile($newCacheFile);
+ $this->assertEquals($newCacheFile, $this->cache->getCacheFile());
+ }
+
+ /**
+ * @test
+ */
+ public function testStoreDoesNothingWhenDisabled() {
+ $this->cache->setEnabled(false);
+
+ $commands = [['className' => 'TestCommand', 'name' => 'test']];
+ $files = [__FILE__];
+
+ $this->cache->store($commands, $files);
+
+ $this->assertFalse(file_exists($this->tempCacheFile));
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/Discovery/CommandDiscoveryExceptionTest.php b/tests/WebFiori/Tests/Cli/Discovery/CommandDiscoveryExceptionTest.php
index 39e6bb8..3a62ea0 100644
--- a/tests/WebFiori/Tests/Cli/Discovery/CommandDiscoveryExceptionTest.php
+++ b/tests/WebFiori/Tests/Cli/Discovery/CommandDiscoveryExceptionTest.php
@@ -1,71 +1,71 @@
-assertEquals($message, $exception->getMessage());
- $this->assertEquals($code, $exception->getCode());
- }
-
- /**
- * @test
- */
- public function testFromErrors() {
- $errors = [
- 'Error 1: Something went wrong',
- 'Error 2: Another issue',
- 'Error 3: Yet another problem'
- ];
- $code = 456;
-
- $exception = CommandDiscoveryException::fromErrors($errors, $code);
-
- $this->assertInstanceOf(CommandDiscoveryException::class, $exception);
- $this->assertEquals($code, $exception->getCode());
-
- $message = $exception->getMessage();
- $this->assertStringContainsString('Command discovery failed with the following errors:', $message);
-
- foreach ($errors as $error) {
- $this->assertStringContainsString($error, $message);
- }
- }
-
- /**
- * @test
- */
- public function testFromErrorsWithDefaultCode() {
- $errors = ['Single error'];
-
- $exception = CommandDiscoveryException::fromErrors($errors);
-
- $this->assertEquals(0, $exception->getCode());
- $this->assertStringContainsString('Single error', $exception->getMessage());
- }
-
- /**
- * @test
- */
- public function testFromErrorsWithEmptyArray() {
- $errors = [];
-
- $exception = CommandDiscoveryException::fromErrors($errors);
-
- $this->assertStringContainsString('Command discovery failed with the following errors:', $exception->getMessage());
- }
-}
+assertEquals($message, $exception->getMessage());
+ $this->assertEquals($code, $exception->getCode());
+ }
+
+ /**
+ * @test
+ */
+ public function testFromErrors() {
+ $errors = [
+ 'Error 1: Something went wrong',
+ 'Error 2: Another issue',
+ 'Error 3: Yet another problem'
+ ];
+ $code = 456;
+
+ $exception = CommandDiscoveryException::fromErrors($errors, $code);
+
+ $this->assertInstanceOf(CommandDiscoveryException::class, $exception);
+ $this->assertEquals($code, $exception->getCode());
+
+ $message = $exception->getMessage();
+ $this->assertStringContainsString('Command discovery failed with the following errors:', $message);
+
+ foreach ($errors as $error) {
+ $this->assertStringContainsString($error, $message);
+ }
+ }
+
+ /**
+ * @test
+ */
+ public function testFromErrorsWithDefaultCode() {
+ $errors = ['Single error'];
+
+ $exception = CommandDiscoveryException::fromErrors($errors);
+
+ $this->assertEquals(0, $exception->getCode());
+ $this->assertStringContainsString('Single error', $exception->getMessage());
+ }
+
+ /**
+ * @test
+ */
+ public function testFromErrorsWithEmptyArray() {
+ $errors = [];
+
+ $exception = CommandDiscoveryException::fromErrors($errors);
+
+ $this->assertStringContainsString('Command discovery failed with the following errors:', $exception->getMessage());
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/Discovery/CommandDiscoveryTest.php b/tests/WebFiori/Tests/Cli/Discovery/CommandDiscoveryTest.php
index b670a9d..10841a2 100644
--- a/tests/WebFiori/Tests/Cli/Discovery/CommandDiscoveryTest.php
+++ b/tests/WebFiori/Tests/Cli/Discovery/CommandDiscoveryTest.php
@@ -1,206 +1,206 @@
-discovery = new CommandDiscovery();
- $this->testCommandsPath = __DIR__ . '/TestCommands';
- }
-
- /**
- * @test
- */
- public function testAddSearchPath() {
- $this->discovery->addSearchPath($this->testCommandsPath);
-
- // Should not throw exception for valid path
- $this->assertTrue(true);
- }
-
- /**
- * @test
- */
- public function testAddInvalidSearchPath() {
- $this->expectException(CommandDiscoveryException::class);
- $this->expectExceptionMessage('Search path does not exist');
-
- $this->discovery->addSearchPath('/non/existent/path');
- }
-
- /**
- * @test
- */
- public function testAddMultipleSearchPaths() {
- $paths = [$this->testCommandsPath, __DIR__];
-
- $this->discovery->addSearchPaths($paths);
-
- // Should not throw exception
- $this->assertTrue(true);
- }
-
- /**
- * @test
- */
- public function testExcludePattern() {
- $this->discovery->excludePattern('*Test*');
- $this->discovery->excludePatterns(['*Abstract*', '*Hidden*']);
-
- // Should not throw exception
- $this->assertTrue(true);
- }
-
- /**
- * @test
- */
- public function testStrictMode() {
- $this->discovery->setStrictMode(true);
- $this->discovery->setStrictMode(false);
-
- // Should not throw exception
- $this->assertTrue(true);
- }
-
- /**
- * @test
- */
- public function testDiscoverCommands() {
- $this->discovery->addSearchPath($this->testCommandsPath);
-
- $commands = $this->discovery->discover();
-
- $this->assertIsArray($commands);
- $this->assertNotEmpty($commands);
-
- // Should find TestCommand
- $testCommandFound = false;
- foreach ($commands as $command) {
- if ($command instanceof TestCommand) {
- $testCommandFound = true;
- break;
- }
- }
- $this->assertTrue($testCommandFound, 'TestCommand should be discovered');
- }
-
- /**
- * @test
- */
- public function testDiscoverWithExcludePatterns() {
- $this->discovery->addSearchPath($this->testCommandsPath)
- ->excludePattern('*Abstract*')
- ->excludePattern('*NotACommand*');
-
- $commands = $this->discovery->discover();
-
- // Should not include abstract commands or non-commands
- foreach ($commands as $command) {
- $this->assertInstanceOf(\WebFiori\Cli\Command::class, $command);
- }
- }
-
- /**
- * @test
- */
- public function testDiscoverWithCache() {
- $tempCacheFile = sys_get_temp_dir() . '/discovery_test_cache.json';
- $cache = new CommandCache($tempCacheFile, true);
- $discovery = new CommandDiscovery($cache);
-
- $discovery->addSearchPath($this->testCommandsPath);
-
- // First discovery should populate cache
- $commands1 = $discovery->discover();
- $this->assertTrue(file_exists($tempCacheFile));
-
- // Second discovery should use cache
- $commands2 = $discovery->discover();
-
- $this->assertEquals(count($commands1), count($commands2));
-
- // Cleanup
- if (file_exists($tempCacheFile)) {
- unlink($tempCacheFile);
- }
- }
-
- /**
- * @test
- */
- public function testGetErrors() {
- $this->discovery->addSearchPath($this->testCommandsPath);
-
- // Discover commands (some may have errors)
- $this->discovery->discover();
-
- $errors = $this->discovery->getErrors();
- $this->assertIsArray($errors);
- }
-
- /**
- * @test
- */
- public function testGetCache() {
- $cache = $this->discovery->getCache();
- $this->assertInstanceOf(CommandCache::class, $cache);
- }
-
- /**
- * @test
- */
- public function testDiscoverWithAutoDiscoverableCommand() {
- // Set AutoDiscoverableCommand to not register
- AutoDiscoverableCommand::setShouldRegister(false);
-
- $this->discovery->addSearchPath($this->testCommandsPath);
- $commands = $this->discovery->discover();
-
- // Should not include AutoDiscoverableCommand
- $autoDiscoverableFound = false;
- foreach ($commands as $command) {
- if ($command instanceof AutoDiscoverableCommand) {
- $autoDiscoverableFound = true;
- break;
- }
- }
- $this->assertFalse($autoDiscoverableFound);
-
- // Reset for other tests
- AutoDiscoverableCommand::setShouldRegister(true);
- }
-
- /**
- * @test
- */
- public function testStrictModeThrowsException() {
- // Create a discovery that will encounter errors
- $discovery = new CommandDiscovery();
- $discovery->setStrictMode(true);
-
- // Add a path that might have issues
- $discovery->addSearchPath($this->testCommandsPath);
-
- // In strict mode, if there are any errors, it should throw
- // Note: This test might not always throw depending on the test commands
- // but it tests the mechanism
- try {
- $discovery->discover();
- $this->assertTrue(true); // No exception thrown
- } catch (CommandDiscoveryException $e) {
- $this->assertInstanceOf(CommandDiscoveryException::class, $e);
- }
- }
-}
+discovery = new CommandDiscovery();
+ $this->testCommandsPath = __DIR__ . '/TestCommands';
+ }
+
+ /**
+ * @test
+ */
+ public function testAddSearchPath() {
+ $this->discovery->addSearchPath($this->testCommandsPath);
+
+ // Should not throw exception for valid path
+ $this->assertTrue(true);
+ }
+
+ /**
+ * @test
+ */
+ public function testAddInvalidSearchPath() {
+ $this->expectException(CommandDiscoveryException::class);
+ $this->expectExceptionMessage('Search path does not exist');
+
+ $this->discovery->addSearchPath('/non/existent/path');
+ }
+
+ /**
+ * @test
+ */
+ public function testAddMultipleSearchPaths() {
+ $paths = [$this->testCommandsPath, __DIR__];
+
+ $this->discovery->addSearchPaths($paths);
+
+ // Should not throw exception
+ $this->assertTrue(true);
+ }
+
+ /**
+ * @test
+ */
+ public function testExcludePattern() {
+ $this->discovery->excludePattern('*Test*');
+ $this->discovery->excludePatterns(['*Abstract*', '*Hidden*']);
+
+ // Should not throw exception
+ $this->assertTrue(true);
+ }
+
+ /**
+ * @test
+ */
+ public function testStrictMode() {
+ $this->discovery->setStrictMode(true);
+ $this->discovery->setStrictMode(false);
+
+ // Should not throw exception
+ $this->assertTrue(true);
+ }
+
+ /**
+ * @test
+ */
+ public function testDiscoverCommands() {
+ $this->discovery->addSearchPath($this->testCommandsPath);
+
+ $commands = $this->discovery->discover();
+
+ $this->assertIsArray($commands);
+ $this->assertNotEmpty($commands);
+
+ // Should find TestCommand
+ $testCommandFound = false;
+ foreach ($commands as $command) {
+ if ($command instanceof TestCommand) {
+ $testCommandFound = true;
+ break;
+ }
+ }
+ $this->assertTrue($testCommandFound, 'TestCommand should be discovered');
+ }
+
+ /**
+ * @test
+ */
+ public function testDiscoverWithExcludePatterns() {
+ $this->discovery->addSearchPath($this->testCommandsPath)
+ ->excludePattern('*Abstract*')
+ ->excludePattern('*NotACommand*');
+
+ $commands = $this->discovery->discover();
+
+ // Should not include abstract commands or non-commands
+ foreach ($commands as $command) {
+ $this->assertInstanceOf(\WebFiori\Cli\Command::class, $command);
+ }
+ }
+
+ /**
+ * @test
+ */
+ public function testDiscoverWithCache() {
+ $tempCacheFile = sys_get_temp_dir() . '/discovery_test_cache.json';
+ $cache = new CommandCache($tempCacheFile, true);
+ $discovery = new CommandDiscovery($cache);
+
+ $discovery->addSearchPath($this->testCommandsPath);
+
+ // First discovery should populate cache
+ $commands1 = $discovery->discover();
+ $this->assertTrue(file_exists($tempCacheFile));
+
+ // Second discovery should use cache
+ $commands2 = $discovery->discover();
+
+ $this->assertEquals(count($commands1), count($commands2));
+
+ // Cleanup
+ if (file_exists($tempCacheFile)) {
+ unlink($tempCacheFile);
+ }
+ }
+
+ /**
+ * @test
+ */
+ public function testGetErrors() {
+ $this->discovery->addSearchPath($this->testCommandsPath);
+
+ // Discover commands (some may have errors)
+ $this->discovery->discover();
+
+ $errors = $this->discovery->getErrors();
+ $this->assertIsArray($errors);
+ }
+
+ /**
+ * @test
+ */
+ public function testGetCache() {
+ $cache = $this->discovery->getCache();
+ $this->assertInstanceOf(CommandCache::class, $cache);
+ }
+
+ /**
+ * @test
+ */
+ public function testDiscoverWithAutoDiscoverableCommand() {
+ // Set AutoDiscoverableCommand to not register
+ AutoDiscoverableCommand::setShouldRegister(false);
+
+ $this->discovery->addSearchPath($this->testCommandsPath);
+ $commands = $this->discovery->discover();
+
+ // Should not include AutoDiscoverableCommand
+ $autoDiscoverableFound = false;
+ foreach ($commands as $command) {
+ if ($command instanceof AutoDiscoverableCommand) {
+ $autoDiscoverableFound = true;
+ break;
+ }
+ }
+ $this->assertFalse($autoDiscoverableFound);
+
+ // Reset for other tests
+ AutoDiscoverableCommand::setShouldRegister(true);
+ }
+
+ /**
+ * @test
+ */
+ public function testStrictModeThrowsException() {
+ // Create a discovery that will encounter errors
+ $discovery = new CommandDiscovery();
+ $discovery->setStrictMode(true);
+
+ // Add a path that might have issues
+ $discovery->addSearchPath($this->testCommandsPath);
+
+ // In strict mode, if there are any errors, it should throw
+ // Note: This test might not always throw depending on the test commands
+ // but it tests the mechanism
+ try {
+ $discovery->discover();
+ $this->assertTrue(true); // No exception thrown
+ } catch (CommandDiscoveryException $e) {
+ $this->assertInstanceOf(CommandDiscoveryException::class, $e);
+ }
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/Discovery/CommandMetadataTest.php b/tests/WebFiori/Tests/Cli/Discovery/CommandMetadataTest.php
index 4853d91..882d43b 100644
--- a/tests/WebFiori/Tests/Cli/Discovery/CommandMetadataTest.php
+++ b/tests/WebFiori/Tests/Cli/Discovery/CommandMetadataTest.php
@@ -1,112 +1,112 @@
-assertEquals(TestCommand::class, $metadata['className']);
- $this->assertEquals('test-cmd', $metadata['name']);
- $this->assertEquals('A test command', $metadata[ArgumentOption::DESCRIPTION]);
- $this->assertEquals('test', $metadata['group']);
- $this->assertFalse($metadata['hidden']);
- $this->assertIsString($metadata['file']);
- }
-
- /**
- * @test
- */
- public function testExtractHiddenCommand() {
- $metadata = CommandMetadata::extract(HiddenCommand::class);
-
- $this->assertEquals(HiddenCommand::class, $metadata['className']);
- $this->assertEquals('hidden', $metadata['name']);
- $this->assertTrue($metadata['hidden']);
- }
-
- /**
- * @test
- */
- public function testExtractNonExistentClass() {
- $this->expectException(CommandDiscoveryException::class);
- $this->expectExceptionMessage('Class NonExistentClass does not exist');
-
- CommandMetadata::extract('NonExistentClass');
- }
-
- /**
- * @test
- */
- public function testExtractNonCommandClass() {
- $this->expectException(CommandDiscoveryException::class);
- $this->expectExceptionMessage('is not a Command');
-
- CommandMetadata::extract(NotACommand::class);
- }
-
- /**
- * @test
- */
- public function testExtractAbstractCommand() {
- $this->expectException(CommandDiscoveryException::class);
- $this->expectExceptionMessage('is abstract');
-
- CommandMetadata::extract(AbstractTestCommand::class);
- }
-
- /**
- * @test
- */
- public function testExtractCommandNameFromClassName() {
- // Create a temporary command class without annotations
- $tempClass = new class extends \WebFiori\Cli\Command {
- public function __construct() {
- parent::__construct('temp', [], 'Temp command');
- }
- public function exec(): int { return 0; }
- };
-
- $className = get_class($tempClass);
- $metadata = CommandMetadata::extract($className);
-
- // Should convert class name to kebab-case
- $this->assertIsString($metadata['name']);
- $this->assertNotEmpty($metadata['name']);
- }
-
- /**
- * @test
- */
- public function testExtractDescriptionFromDocblock() {
- $metadata = CommandMetadata::extract(TestCommand::class);
-
- // Should extract description from @Command annotation
- $this->assertEquals('A test command', $metadata[ArgumentOption::DESCRIPTION]);
- }
-
- /**
- * @test
- */
- public function testExtractGroupFromNamespace() {
- $metadata = CommandMetadata::extract(TestCommand::class);
-
- // Should extract group from @Command annotation
- $this->assertEquals('test', $metadata['group']);
- }
-}
+assertEquals(TestCommand::class, $metadata['className']);
+ $this->assertEquals('test-cmd', $metadata['name']);
+ $this->assertEquals('A test command', $metadata[ArgumentOption::DESCRIPTION]);
+ $this->assertEquals('test', $metadata['group']);
+ $this->assertFalse($metadata['hidden']);
+ $this->assertIsString($metadata['file']);
+ }
+
+ /**
+ * @test
+ */
+ public function testExtractHiddenCommand() {
+ $metadata = CommandMetadata::extract(HiddenCommand::class);
+
+ $this->assertEquals(HiddenCommand::class, $metadata['className']);
+ $this->assertEquals('hidden', $metadata['name']);
+ $this->assertTrue($metadata['hidden']);
+ }
+
+ /**
+ * @test
+ */
+ public function testExtractNonExistentClass() {
+ $this->expectException(CommandDiscoveryException::class);
+ $this->expectExceptionMessage('Class NonExistentClass does not exist');
+
+ CommandMetadata::extract('NonExistentClass');
+ }
+
+ /**
+ * @test
+ */
+ public function testExtractNonCommandClass() {
+ $this->expectException(CommandDiscoveryException::class);
+ $this->expectExceptionMessage('is not a Command');
+
+ CommandMetadata::extract(NotACommand::class);
+ }
+
+ /**
+ * @test
+ */
+ public function testExtractAbstractCommand() {
+ $this->expectException(CommandDiscoveryException::class);
+ $this->expectExceptionMessage('is abstract');
+
+ CommandMetadata::extract(AbstractTestCommand::class);
+ }
+
+ /**
+ * @test
+ */
+ public function testExtractCommandNameFromClassName() {
+ // Create a temporary command class without annotations
+ $tempClass = new class extends \WebFiori\Cli\Command {
+ public function __construct() {
+ parent::__construct('temp', [], 'Temp command');
+ }
+ public function exec(): int { return 0; }
+ };
+
+ $className = get_class($tempClass);
+ $metadata = CommandMetadata::extract($className);
+
+ // Should convert class name to kebab-case
+ $this->assertIsString($metadata['name']);
+ $this->assertNotEmpty($metadata['name']);
+ }
+
+ /**
+ * @test
+ */
+ public function testExtractDescriptionFromDocblock() {
+ $metadata = CommandMetadata::extract(TestCommand::class);
+
+ // Should extract description from @Command annotation
+ $this->assertEquals('A test command', $metadata[ArgumentOption::DESCRIPTION]);
+ }
+
+ /**
+ * @test
+ */
+ public function testExtractGroupFromNamespace() {
+ $metadata = CommandMetadata::extract(TestCommand::class);
+
+ // Should extract group from @Command annotation
+ $this->assertEquals('test', $metadata['group']);
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/Discovery/RunnerDiscoveryTest.php b/tests/WebFiori/Tests/Cli/Discovery/RunnerDiscoveryTest.php
index cfecc1f..34558bc 100644
--- a/tests/WebFiori/Tests/Cli/Discovery/RunnerDiscoveryTest.php
+++ b/tests/WebFiori/Tests/Cli/Discovery/RunnerDiscoveryTest.php
@@ -1,224 +1,224 @@
-runner = new Runner();
- $this->testCommandsPath = __DIR__ . '/TestCommands';
- }
-
- /**
- * @test
- */
- public function testEnableAutoDiscovery() {
- $result = $this->runner->enableAutoDiscovery();
-
- $this->assertInstanceOf(Runner::class, $result);
- $this->assertTrue($this->runner->isAutoDiscoveryEnabled());
- $this->assertInstanceOf(CommandDiscovery::class, $this->runner->getCommandDiscovery());
- }
-
- /**
- * @test
- */
- public function testDisableAutoDiscovery() {
- $this->runner->enableAutoDiscovery();
- $result = $this->runner->disableAutoDiscovery();
-
- $this->assertInstanceOf(Runner::class, $result);
- $this->assertFalse($this->runner->isAutoDiscoveryEnabled());
- }
-
- /**
- * @test
- */
- public function testAddDiscoveryPath() {
- $result = $this->runner->addDiscoveryPath($this->testCommandsPath);
-
- $this->assertInstanceOf(Runner::class, $result);
- $this->assertTrue($this->runner->isAutoDiscoveryEnabled());
- }
-
- /**
- * @test
- */
- public function testAddDiscoveryPaths() {
- $paths = [$this->testCommandsPath, __DIR__];
- $result = $this->runner->addDiscoveryPaths($paths);
-
- $this->assertInstanceOf(Runner::class, $result);
- $this->assertTrue($this->runner->isAutoDiscoveryEnabled());
- }
-
- /**
- * @test
- */
- public function testExcludePattern() {
- $result = $this->runner->excludePattern('*Test*');
-
- $this->assertInstanceOf(Runner::class, $result);
- $this->assertTrue($this->runner->isAutoDiscoveryEnabled());
- }
-
- /**
- * @test
- */
- public function testExcludePatterns() {
- $patterns = ['*Test*', '*Abstract*'];
- $result = $this->runner->excludePatterns($patterns);
-
- $this->assertInstanceOf(Runner::class, $result);
- $this->assertTrue($this->runner->isAutoDiscoveryEnabled());
- }
-
- /**
- * @test
- */
- public function testSetDiscoveryStrictMode() {
- $result = $this->runner->setDiscoveryStrictMode(true);
-
- $this->assertInstanceOf(Runner::class, $result);
- $this->assertTrue($this->runner->isAutoDiscoveryEnabled());
- }
-
- /**
- * @test
- */
- public function testSetCommandDiscovery() {
- $discovery = new CommandDiscovery();
- $result = $this->runner->setCommandDiscovery($discovery);
-
- $this->assertInstanceOf(Runner::class, $result);
- $this->assertTrue($this->runner->isAutoDiscoveryEnabled());
- $this->assertSame($discovery, $this->runner->getCommandDiscovery());
- }
-
- /**
- * @test
- */
- public function testDiscoverCommands() {
- $this->runner->addDiscoveryPath($this->testCommandsPath);
- $result = $this->runner->discoverCommands();
-
- $this->assertInstanceOf(Runner::class, $result);
-
- // Check that commands were registered
- $commands = $this->runner->getCommands();
- $this->assertArrayHasKey('test-cmd', $commands);
- $this->assertInstanceOf(TestCommand::class, $commands['test-cmd']);
- }
-
- /**
- * @test
- */
- public function testAutoRegister() {
- $result = $this->runner->autoRegister($this->testCommandsPath, ['*Abstract*']);
-
- $this->assertInstanceOf(Runner::class, $result);
-
- // Check that commands were registered
- $commands = $this->runner->getCommands();
- $this->assertArrayHasKey('test-cmd', $commands);
- }
-
- /**
- * @test
- */
- public function testDiscoverCommandsOnlyOnce() {
- $this->runner->addDiscoveryPath($this->testCommandsPath);
-
- // First discovery
- $this->runner->discoverCommands();
- $commandsCount1 = count($this->runner->getCommands());
-
- // Second discovery should not add duplicates
- $this->runner->discoverCommands();
- $commandsCount2 = count($this->runner->getCommands());
-
- $this->assertEquals($commandsCount1, $commandsCount2);
- }
-
- /**
- * @test
- */
- public function testGetDiscoveryCache() {
- $this->runner->enableAutoDiscovery();
- $cache = $this->runner->getDiscoveryCache();
-
- $this->assertInstanceOf(CommandCache::class, $cache);
- }
-
- /**
- * @test
- */
- public function testEnableDiscoveryCache() {
- $cacheFile = sys_get_temp_dir() . '/runner_test_cache.json';
- $result = $this->runner->enableDiscoveryCache($cacheFile);
-
- $this->assertInstanceOf(Runner::class, $result);
- $this->assertTrue($this->runner->isAutoDiscoveryEnabled());
-
- $cache = $this->runner->getDiscoveryCache();
- $this->assertTrue($cache->isEnabled());
- $this->assertEquals($cacheFile, $cache->getCacheFile());
- }
-
- /**
- * @test
- */
- public function testDisableDiscoveryCache() {
- $this->runner->enableAutoDiscovery();
- $result = $this->runner->disableDiscoveryCache();
-
- $this->assertInstanceOf(Runner::class, $result);
-
- $cache = $this->runner->getDiscoveryCache();
- $this->assertFalse($cache->isEnabled());
- }
-
- /**
- * @test
- */
- public function testClearDiscoveryCache() {
- $cacheFile = sys_get_temp_dir() . '/runner_clear_test_cache.json';
- $this->runner->enableDiscoveryCache($cacheFile)
- ->addDiscoveryPath($this->testCommandsPath)
- ->discoverCommands();
-
- // Cache file should exist
- $this->assertTrue(file_exists($cacheFile));
-
- $result = $this->runner->clearDiscoveryCache();
- $this->assertInstanceOf(Runner::class, $result);
-
- // Cache file should be deleted
- $this->assertFalse(file_exists($cacheFile));
- }
-
- /**
- * @test
- */
- public function testDiscoveryWithoutEnabledDoesNothing() {
- // Don't enable auto-discovery
- $result = $this->runner->discoverCommands();
-
- $this->assertInstanceOf(Runner::class, $result);
-
- // Should not have discovered any commands (except default help command)
- $commands = $this->runner->getCommands();
- $expectedCommands = ['help' => $this->runner->getCommandByName('help')];
- $this->assertEquals($expectedCommands, $commands);
- }
-}
+runner = new Runner();
+ $this->testCommandsPath = __DIR__ . '/TestCommands';
+ }
+
+ /**
+ * @test
+ */
+ public function testEnableAutoDiscovery() {
+ $result = $this->runner->enableAutoDiscovery();
+
+ $this->assertInstanceOf(Runner::class, $result);
+ $this->assertTrue($this->runner->isAutoDiscoveryEnabled());
+ $this->assertInstanceOf(CommandDiscovery::class, $this->runner->getCommandDiscovery());
+ }
+
+ /**
+ * @test
+ */
+ public function testDisableAutoDiscovery() {
+ $this->runner->enableAutoDiscovery();
+ $result = $this->runner->disableAutoDiscovery();
+
+ $this->assertInstanceOf(Runner::class, $result);
+ $this->assertFalse($this->runner->isAutoDiscoveryEnabled());
+ }
+
+ /**
+ * @test
+ */
+ public function testAddDiscoveryPath() {
+ $result = $this->runner->addDiscoveryPath($this->testCommandsPath);
+
+ $this->assertInstanceOf(Runner::class, $result);
+ $this->assertTrue($this->runner->isAutoDiscoveryEnabled());
+ }
+
+ /**
+ * @test
+ */
+ public function testAddDiscoveryPaths() {
+ $paths = [$this->testCommandsPath, __DIR__];
+ $result = $this->runner->addDiscoveryPaths($paths);
+
+ $this->assertInstanceOf(Runner::class, $result);
+ $this->assertTrue($this->runner->isAutoDiscoveryEnabled());
+ }
+
+ /**
+ * @test
+ */
+ public function testExcludePattern() {
+ $result = $this->runner->excludePattern('*Test*');
+
+ $this->assertInstanceOf(Runner::class, $result);
+ $this->assertTrue($this->runner->isAutoDiscoveryEnabled());
+ }
+
+ /**
+ * @test
+ */
+ public function testExcludePatterns() {
+ $patterns = ['*Test*', '*Abstract*'];
+ $result = $this->runner->excludePatterns($patterns);
+
+ $this->assertInstanceOf(Runner::class, $result);
+ $this->assertTrue($this->runner->isAutoDiscoveryEnabled());
+ }
+
+ /**
+ * @test
+ */
+ public function testSetDiscoveryStrictMode() {
+ $result = $this->runner->setDiscoveryStrictMode(true);
+
+ $this->assertInstanceOf(Runner::class, $result);
+ $this->assertTrue($this->runner->isAutoDiscoveryEnabled());
+ }
+
+ /**
+ * @test
+ */
+ public function testSetCommandDiscovery() {
+ $discovery = new CommandDiscovery();
+ $result = $this->runner->setCommandDiscovery($discovery);
+
+ $this->assertInstanceOf(Runner::class, $result);
+ $this->assertTrue($this->runner->isAutoDiscoveryEnabled());
+ $this->assertSame($discovery, $this->runner->getCommandDiscovery());
+ }
+
+ /**
+ * @test
+ */
+ public function testDiscoverCommands() {
+ $this->runner->addDiscoveryPath($this->testCommandsPath);
+ $result = $this->runner->discoverCommands();
+
+ $this->assertInstanceOf(Runner::class, $result);
+
+ // Check that commands were registered
+ $commands = $this->runner->getCommands();
+ $this->assertArrayHasKey('test-cmd', $commands);
+ $this->assertInstanceOf(TestCommand::class, $commands['test-cmd']);
+ }
+
+ /**
+ * @test
+ */
+ public function testAutoRegister() {
+ $result = $this->runner->autoRegister($this->testCommandsPath, ['*Abstract*']);
+
+ $this->assertInstanceOf(Runner::class, $result);
+
+ // Check that commands were registered
+ $commands = $this->runner->getCommands();
+ $this->assertArrayHasKey('test-cmd', $commands);
+ }
+
+ /**
+ * @test
+ */
+ public function testDiscoverCommandsOnlyOnce() {
+ $this->runner->addDiscoveryPath($this->testCommandsPath);
+
+ // First discovery
+ $this->runner->discoverCommands();
+ $commandsCount1 = count($this->runner->getCommands());
+
+ // Second discovery should not add duplicates
+ $this->runner->discoverCommands();
+ $commandsCount2 = count($this->runner->getCommands());
+
+ $this->assertEquals($commandsCount1, $commandsCount2);
+ }
+
+ /**
+ * @test
+ */
+ public function testGetDiscoveryCache() {
+ $this->runner->enableAutoDiscovery();
+ $cache = $this->runner->getDiscoveryCache();
+
+ $this->assertInstanceOf(CommandCache::class, $cache);
+ }
+
+ /**
+ * @test
+ */
+ public function testEnableDiscoveryCache() {
+ $cacheFile = sys_get_temp_dir() . '/runner_test_cache.json';
+ $result = $this->runner->enableDiscoveryCache($cacheFile);
+
+ $this->assertInstanceOf(Runner::class, $result);
+ $this->assertTrue($this->runner->isAutoDiscoveryEnabled());
+
+ $cache = $this->runner->getDiscoveryCache();
+ $this->assertTrue($cache->isEnabled());
+ $this->assertEquals($cacheFile, $cache->getCacheFile());
+ }
+
+ /**
+ * @test
+ */
+ public function testDisableDiscoveryCache() {
+ $this->runner->enableAutoDiscovery();
+ $result = $this->runner->disableDiscoveryCache();
+
+ $this->assertInstanceOf(Runner::class, $result);
+
+ $cache = $this->runner->getDiscoveryCache();
+ $this->assertFalse($cache->isEnabled());
+ }
+
+ /**
+ * @test
+ */
+ public function testClearDiscoveryCache() {
+ $cacheFile = sys_get_temp_dir() . '/runner_clear_test_cache.json';
+ $this->runner->enableDiscoveryCache($cacheFile)
+ ->addDiscoveryPath($this->testCommandsPath)
+ ->discoverCommands();
+
+ // Cache file should exist
+ $this->assertTrue(file_exists($cacheFile));
+
+ $result = $this->runner->clearDiscoveryCache();
+ $this->assertInstanceOf(Runner::class, $result);
+
+ // Cache file should be deleted
+ $this->assertFalse(file_exists($cacheFile));
+ }
+
+ /**
+ * @test
+ */
+ public function testDiscoveryWithoutEnabledDoesNothing() {
+ // Don't enable auto-discovery
+ $result = $this->runner->discoverCommands();
+
+ $this->assertInstanceOf(Runner::class, $result);
+
+ // Should not have discovered any commands (except default help command)
+ $commands = $this->runner->getCommands();
+ $expectedCommands = ['help' => $this->runner->getCommandByName('help')];
+ $this->assertEquals($expectedCommands, $commands);
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/Discovery/TestCommands/AbstractTestCommand.php b/tests/WebFiori/Tests/Cli/Discovery/TestCommands/AbstractTestCommand.php
index 320a864..b6553fc 100644
--- a/tests/WebFiori/Tests/Cli/Discovery/TestCommands/AbstractTestCommand.php
+++ b/tests/WebFiori/Tests/Cli/Discovery/TestCommands/AbstractTestCommand.php
@@ -1,13 +1,13 @@
-println('Auto-discoverable command executed');
- return 0;
- }
-
- public static function shouldAutoRegister(): bool {
- return self::$shouldRegister;
- }
-
- public static function setShouldRegister(bool $should): void {
- self::$shouldRegister = $should;
- }
-}
+println('Auto-discoverable command executed');
+ return 0;
+ }
+
+ public static function shouldAutoRegister(): bool {
+ return self::$shouldRegister;
+ }
+
+ public static function setShouldRegister(bool $should): void {
+ self::$shouldRegister = $should;
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/Discovery/TestCommands/HiddenCommand.php b/tests/WebFiori/Tests/Cli/Discovery/TestCommands/HiddenCommand.php
index 1961a02..4a16646 100644
--- a/tests/WebFiori/Tests/Cli/Discovery/TestCommands/HiddenCommand.php
+++ b/tests/WebFiori/Tests/Cli/Discovery/TestCommands/HiddenCommand.php
@@ -1,20 +1,20 @@
-println('Hidden command executed');
- return 0;
- }
-}
+println('Hidden command executed');
+ return 0;
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/Discovery/TestCommands/NotACommand.php b/tests/WebFiori/Tests/Cli/Discovery/TestCommands/NotACommand.php
index 9d7eddc..972d1f6 100644
--- a/tests/WebFiori/Tests/Cli/Discovery/TestCommands/NotACommand.php
+++ b/tests/WebFiori/Tests/Cli/Discovery/TestCommands/NotACommand.php
@@ -1,11 +1,11 @@
-println('Test command executed');
- return 0;
- }
-}
+println('Test command executed');
+ return 0;
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/FileInputOutputStreamsTest.php b/tests/WebFiori/Tests/Cli/FileInputOutputStreamsTest.php
index 0c58f2d..9f7f416 100644
--- a/tests/WebFiori/Tests/Cli/FileInputOutputStreamsTest.php
+++ b/tests/WebFiori/Tests/Cli/FileInputOutputStreamsTest.php
@@ -1,316 +1,316 @@
-readLine();
- $this->assertEquals("Hello World!", $line);
- }
- /**
- * @test
- */
- public function testInputStream01() {
- $stream = new FileInputStream(self::STREAMS_PATH.'stream1.txt');
- $line = $stream->readLine();
- $this->assertEquals("Hello World!", $line);
- // Second readLine should return empty string when EOF is reached
- $this->assertEquals("", $stream->readLine());
- }
- /**
- * @test
- */
- public function testInputStream02() {
- $stream = new FileInputStream(self::STREAMS_PATH.'stream1.txt');
- $this->assertEquals('H', $stream->read());
- $this->assertEquals('el', $stream->read(2));
- $this->assertEquals('l', $stream->read());
- $this->assertEquals('o W', $stream->read(3));
- $this->assertEquals('orld!', $stream->read(5));
- $this->assertEquals("\n", $stream->read());
- }
- /**
- * @test
- */
- public function testInputStream03() {
- $stream = new FileInputStream(self::STREAMS_PATH.'stream1.txt');
- $this->assertEquals("Hello World!\n", $stream->read(13));
- }
- /**
- * @test
- */
- public function testInputStream04() {
- $stream = new FileInputStream(self::STREAMS_PATH.'stream1.txt');
- // Reading more bytes than available should return only available content
- $data = $stream->read(14);
- $this->assertEquals("Hello World!\n", $data);
- $this->assertEquals(13, strlen($data)); // Only 13 bytes available
- }
- /**
- * @test
- */
- public function testInputStream05() {
- $stream = new FileInputStream(self::STREAMS_PATH.'stream2.txt');
- $this->assertEquals("My", $stream->readLine());
- $this->assertEquals("", $stream->readLine());
- $this->assertEquals("Super", $stream->read(5));
- $this->assertEquals(" Hero Ibrahim", $stream->readLine());
- $this->assertEquals("Even Though I'm Not A Hero\nBut ", $stream->read(31));
- $this->assertEquals("I'm A", $stream->readLine());
- $this->assertEquals("Hero in Programming", $stream->readLine());
- }
- /**
- * @test
- */
- public function testOutputStream00() {
- $stream = new FileOutputStream(self::STREAMS_PATH.'output-stream1.txt');
- $stream->println('Hello World!');
- $stream2 = new FileInputStream(self::STREAMS_PATH.'output-stream1.txt');
- $this->assertEquals("Hello World!", $stream2->readLine());
- }
- /**
- * @test
- */
- public function testOutputStream01() {
- $stream = new FileOutputStream(self::STREAMS_PATH.'output-stream1.txt');
- $stream->prints('Hello Mr %s!', 'Ibrahim');
- $stream->println('');
- $stream2 = new FileInputStream(self::STREAMS_PATH.'output-stream1.txt');
- $this->assertEquals("Hello Mr Ibrahim!", $stream2->readLine());
- }
- /**
- * @test
- */
- public function testOutputStream02() {
- $stream = new FileOutputStream(self::STREAMS_PATH.'output-stream1.txt');
- $stream->prints('Im Cool');
- $stream->println('. You are cool.');
- $stream2 = new FileInputStream(self::STREAMS_PATH.'output-stream1.txt');
- $this->assertEquals("Im Cool. You are cool.", $stream2->readLine());
- }
- // ========== ENHANCED FILE STREAM TESTS ==========
-
- /**
- * Test FileInputStream functionality
- * @test
- */
- public function testFileInputStreamFunctionalityEnhanced() {
- // Create test file
- $testFile = sys_get_temp_dir() . '/webfiori_test_input.txt';
- $testContent = "Line 1\nLine 2\nLine 3\n";
- file_put_contents($testFile, $testContent);
-
- try {
- $stream = new FileInputStream($testFile);
-
- // Test reading lines
- $this->assertEquals('Line 1', $stream->readLine());
- $this->assertEquals('Line 2', $stream->readLine());
- $this->assertEquals('Line 3', $stream->readLine());
- $this->assertEquals('', $stream->readLine()); // EOF
-
- // Test reading with byte limit
- $stream2 = new FileInputStream($testFile);
- $this->assertEquals('Line ', $stream2->read(5));
- $this->assertEquals('1', $stream2->read(1));
-
- // Test reading entire file
- $stream3 = new FileInputStream($testFile);
- $entireContent = '';
- while (($chunk = $stream3->read(1024)) !== '') {
- $entireContent .= $chunk;
- }
- $this->assertEquals($testContent, $entireContent);
- } finally {
- // Cleanup
- if (file_exists($testFile)) {
- unlink($testFile);
- }
- }
- }
-
- /**
- * Test FileInputStream edge cases
- * @test
- */
- public function testFileInputStreamEdgeCasesEnhanced() {
- $tempDir = sys_get_temp_dir();
-
- // Test with empty file
- $emptyFile = $tempDir . '/webfiori_empty.txt';
- file_put_contents($emptyFile, '');
-
- try {
- $emptyStream = new FileInputStream($emptyFile);
- $this->assertEquals('', $emptyStream->readLine());
- $this->assertEquals('', $emptyStream->read(10));
- } finally {
- if (file_exists($emptyFile)) {
- unlink($emptyFile);
- }
- }
-
- // Test with file containing only newlines
- $newlineFile = $tempDir . '/webfiori_newlines.txt';
- file_put_contents($newlineFile, "\n\n\n");
-
- try {
- $newlineStream = new FileInputStream($newlineFile);
- $this->assertEquals('', $newlineStream->readLine());
- $this->assertEquals('', $newlineStream->readLine());
- $this->assertEquals('', $newlineStream->readLine());
- $this->assertEquals('', $newlineStream->readLine()); // EOF
- } finally {
- if (file_exists($newlineFile)) {
- unlink($newlineFile);
- }
- }
-
- // Test with file containing special characters
- $specialFile = $tempDir . '/webfiori_special.txt';
- $specialContent = "Special: ร รกรขรฃรครฅรฆรงรจรฉรชรซ\nไธญๆ\n๐\n";
- file_put_contents($specialFile, $specialContent);
-
- try {
- $specialStream = new FileInputStream($specialFile);
- $this->assertEquals('Special: ร รกรขรฃรครฅรฆรงรจรฉรชรซ', $specialStream->readLine());
- $this->assertEquals('ไธญๆ', $specialStream->readLine());
- $this->assertEquals('๐', $specialStream->readLine());
- } finally {
- if (file_exists($specialFile)) {
- unlink($specialFile);
- }
- }
- }
-
- /**
- * Test FileOutputStream functionality
- * @test
- */
- public function testFileOutputStreamFunctionalityEnhanced() {
- $testFile = sys_get_temp_dir() . '/webfiori_test_output.txt';
-
- try {
- $stream = new FileOutputStream($testFile);
-
- // Test writing content
- $stream->prints('Hello');
- $stream->prints(' ');
- $stream->prints('World');
- $stream->prints("\n");
- $stream->prints('Second line');
-
- // Close stream to ensure content is written
- unset($stream);
-
- // Verify file content
- $this->assertTrue(file_exists($testFile));
- $content = file_get_contents($testFile);
- $this->assertEquals("Hello World\nSecond line", $content);
- } finally {
- // Cleanup
- if (file_exists($testFile)) {
- unlink($testFile);
- }
- }
- }
-
- /**
- * Test FileOutputStream edge cases
- * @test
- */
- public function testFileOutputStreamEdgeCasesEnhanced() {
- $tempDir = sys_get_temp_dir();
-
- // Test writing to new file
- $newFile = $tempDir . '/webfiori_new_output.txt';
- $this->assertFalse(file_exists($newFile));
-
- try {
- $stream = new FileOutputStream($newFile);
- $stream->prints('New file content');
- unset($stream);
-
- $this->assertTrue(file_exists($newFile));
- $this->assertEquals('New file content', file_get_contents($newFile));
- } finally {
- if (file_exists($newFile)) {
- unlink($newFile);
- }
- }
-
- // Test writing special characters
- $specialFile = $tempDir . '/webfiori_special_output.txt';
- try {
- $specialStream = new FileOutputStream($specialFile);
- $specialContent = "Special: ร รกรขรฃรครฅรฆรงรจรฉรชรซ\nไธญๆ\n๐";
- $specialStream->prints($specialContent);
- unset($specialStream);
-
- $this->assertEquals($specialContent, file_get_contents($specialFile));
- } finally {
- if (file_exists($specialFile)) {
- unlink($specialFile);
- }
- }
-
- // Test writing large content
- $largeFile = $tempDir . '/webfiori_large_output.txt';
- try {
- $largeStream = new FileOutputStream($largeFile);
- $largeContent = str_repeat('Large content line ' . str_repeat('x', 100) . "\n", 1000);
- $largeStream->prints($largeContent);
- unset($largeStream);
-
- $this->assertEquals($largeContent, file_get_contents($largeFile));
- $this->assertGreaterThan(100000, filesize($largeFile)); // Should be large file
- } finally {
- if (file_exists($largeFile)) {
- unlink($largeFile);
- }
- }
- }
-
- /**
- * Test FileInputStream with empty file throws exception
- * @test
- */
- public function testFileInputStreamEmptyFileException() {
- $tempDir = sys_get_temp_dir();
-
- // Test with empty file
- $emptyFile = $tempDir . '/webfiori_empty.txt';
- file_put_contents($emptyFile, '');
-
- try {
- $emptyStream = new FileInputStream($emptyFile);
-
- // Reading from empty file should return empty string
- $data = $emptyStream->read(1);
- $this->assertEquals('', $data);
- $this->assertEquals(0, strlen($data));
- } finally {
- if (file_exists($emptyFile)) {
- unlink($emptyFile);
- }
- }
- }
-}
+readLine();
+ $this->assertEquals("Hello World!", $line);
+ }
+ /**
+ * @test
+ */
+ public function testInputStream01() {
+ $stream = new FileInputStream(self::STREAMS_PATH.'stream1.txt');
+ $line = $stream->readLine();
+ $this->assertEquals("Hello World!", $line);
+ // Second readLine should return empty string when EOF is reached
+ $this->assertEquals("", $stream->readLine());
+ }
+ /**
+ * @test
+ */
+ public function testInputStream02() {
+ $stream = new FileInputStream(self::STREAMS_PATH.'stream1.txt');
+ $this->assertEquals('H', $stream->read());
+ $this->assertEquals('el', $stream->read(2));
+ $this->assertEquals('l', $stream->read());
+ $this->assertEquals('o W', $stream->read(3));
+ $this->assertEquals('orld!', $stream->read(5));
+ $this->assertEquals("\n", $stream->read());
+ }
+ /**
+ * @test
+ */
+ public function testInputStream03() {
+ $stream = new FileInputStream(self::STREAMS_PATH.'stream1.txt');
+ $this->assertEquals("Hello World!\n", $stream->read(13));
+ }
+ /**
+ * @test
+ */
+ public function testInputStream04() {
+ $stream = new FileInputStream(self::STREAMS_PATH.'stream1.txt');
+ // Reading more bytes than available should return only available content
+ $data = $stream->read(14);
+ $this->assertEquals("Hello World!\n", $data);
+ $this->assertEquals(13, strlen($data)); // Only 13 bytes available
+ }
+ /**
+ * @test
+ */
+ public function testInputStream05() {
+ $stream = new FileInputStream(self::STREAMS_PATH.'stream2.txt');
+ $this->assertEquals("My", $stream->readLine());
+ $this->assertEquals("", $stream->readLine());
+ $this->assertEquals("Super", $stream->read(5));
+ $this->assertEquals(" Hero Ibrahim", $stream->readLine());
+ $this->assertEquals("Even Though I'm Not A Hero\nBut ", $stream->read(31));
+ $this->assertEquals("I'm A", $stream->readLine());
+ $this->assertEquals("Hero in Programming", $stream->readLine());
+ }
+ /**
+ * @test
+ */
+ public function testOutputStream00() {
+ $stream = new FileOutputStream(self::STREAMS_PATH.'output-stream1.txt');
+ $stream->println('Hello World!');
+ $stream2 = new FileInputStream(self::STREAMS_PATH.'output-stream1.txt');
+ $this->assertEquals("Hello World!", $stream2->readLine());
+ }
+ /**
+ * @test
+ */
+ public function testOutputStream01() {
+ $stream = new FileOutputStream(self::STREAMS_PATH.'output-stream1.txt');
+ $stream->prints('Hello Mr %s!', 'Ibrahim');
+ $stream->println('');
+ $stream2 = new FileInputStream(self::STREAMS_PATH.'output-stream1.txt');
+ $this->assertEquals("Hello Mr Ibrahim!", $stream2->readLine());
+ }
+ /**
+ * @test
+ */
+ public function testOutputStream02() {
+ $stream = new FileOutputStream(self::STREAMS_PATH.'output-stream1.txt');
+ $stream->prints('Im Cool');
+ $stream->println('. You are cool.');
+ $stream2 = new FileInputStream(self::STREAMS_PATH.'output-stream1.txt');
+ $this->assertEquals("Im Cool. You are cool.", $stream2->readLine());
+ }
+ // ========== ENHANCED FILE STREAM TESTS ==========
+
+ /**
+ * Test FileInputStream functionality
+ * @test
+ */
+ public function testFileInputStreamFunctionalityEnhanced() {
+ // Create test file
+ $testFile = sys_get_temp_dir() . '/webfiori_test_input.txt';
+ $testContent = "Line 1\nLine 2\nLine 3\n";
+ file_put_contents($testFile, $testContent);
+
+ try {
+ $stream = new FileInputStream($testFile);
+
+ // Test reading lines
+ $this->assertEquals('Line 1', $stream->readLine());
+ $this->assertEquals('Line 2', $stream->readLine());
+ $this->assertEquals('Line 3', $stream->readLine());
+ $this->assertEquals('', $stream->readLine()); // EOF
+
+ // Test reading with byte limit
+ $stream2 = new FileInputStream($testFile);
+ $this->assertEquals('Line ', $stream2->read(5));
+ $this->assertEquals('1', $stream2->read(1));
+
+ // Test reading entire file
+ $stream3 = new FileInputStream($testFile);
+ $entireContent = '';
+ while (($chunk = $stream3->read(1024)) !== '') {
+ $entireContent .= $chunk;
+ }
+ $this->assertEquals($testContent, $entireContent);
+ } finally {
+ // Cleanup
+ if (file_exists($testFile)) {
+ unlink($testFile);
+ }
+ }
+ }
+
+ /**
+ * Test FileInputStream edge cases
+ * @test
+ */
+ public function testFileInputStreamEdgeCasesEnhanced() {
+ $tempDir = sys_get_temp_dir();
+
+ // Test with empty file
+ $emptyFile = $tempDir . '/webfiori_empty.txt';
+ file_put_contents($emptyFile, '');
+
+ try {
+ $emptyStream = new FileInputStream($emptyFile);
+ $this->assertEquals('', $emptyStream->readLine());
+ $this->assertEquals('', $emptyStream->read(10));
+ } finally {
+ if (file_exists($emptyFile)) {
+ unlink($emptyFile);
+ }
+ }
+
+ // Test with file containing only newlines
+ $newlineFile = $tempDir . '/webfiori_newlines.txt';
+ file_put_contents($newlineFile, "\n\n\n");
+
+ try {
+ $newlineStream = new FileInputStream($newlineFile);
+ $this->assertEquals('', $newlineStream->readLine());
+ $this->assertEquals('', $newlineStream->readLine());
+ $this->assertEquals('', $newlineStream->readLine());
+ $this->assertEquals('', $newlineStream->readLine()); // EOF
+ } finally {
+ if (file_exists($newlineFile)) {
+ unlink($newlineFile);
+ }
+ }
+
+ // Test with file containing special characters
+ $specialFile = $tempDir . '/webfiori_special.txt';
+ $specialContent = "Special: ร รกรขรฃรครฅรฆรงรจรฉรชรซ\nไธญๆ\n๐\n";
+ file_put_contents($specialFile, $specialContent);
+
+ try {
+ $specialStream = new FileInputStream($specialFile);
+ $this->assertEquals('Special: ร รกรขรฃรครฅรฆรงรจรฉรชรซ', $specialStream->readLine());
+ $this->assertEquals('ไธญๆ', $specialStream->readLine());
+ $this->assertEquals('๐', $specialStream->readLine());
+ } finally {
+ if (file_exists($specialFile)) {
+ unlink($specialFile);
+ }
+ }
+ }
+
+ /**
+ * Test FileOutputStream functionality
+ * @test
+ */
+ public function testFileOutputStreamFunctionalityEnhanced() {
+ $testFile = sys_get_temp_dir() . '/webfiori_test_output.txt';
+
+ try {
+ $stream = new FileOutputStream($testFile);
+
+ // Test writing content
+ $stream->prints('Hello');
+ $stream->prints(' ');
+ $stream->prints('World');
+ $stream->prints("\n");
+ $stream->prints('Second line');
+
+ // Close stream to ensure content is written
+ unset($stream);
+
+ // Verify file content
+ $this->assertTrue(file_exists($testFile));
+ $content = file_get_contents($testFile);
+ $this->assertEquals("Hello World\nSecond line", $content);
+ } finally {
+ // Cleanup
+ if (file_exists($testFile)) {
+ unlink($testFile);
+ }
+ }
+ }
+
+ /**
+ * Test FileOutputStream edge cases
+ * @test
+ */
+ public function testFileOutputStreamEdgeCasesEnhanced() {
+ $tempDir = sys_get_temp_dir();
+
+ // Test writing to new file
+ $newFile = $tempDir . '/webfiori_new_output.txt';
+ $this->assertFalse(file_exists($newFile));
+
+ try {
+ $stream = new FileOutputStream($newFile);
+ $stream->prints('New file content');
+ unset($stream);
+
+ $this->assertTrue(file_exists($newFile));
+ $this->assertEquals('New file content', file_get_contents($newFile));
+ } finally {
+ if (file_exists($newFile)) {
+ unlink($newFile);
+ }
+ }
+
+ // Test writing special characters
+ $specialFile = $tempDir . '/webfiori_special_output.txt';
+ try {
+ $specialStream = new FileOutputStream($specialFile);
+ $specialContent = "Special: ร รกรขรฃรครฅรฆรงรจรฉรชรซ\nไธญๆ\n๐";
+ $specialStream->prints($specialContent);
+ unset($specialStream);
+
+ $this->assertEquals($specialContent, file_get_contents($specialFile));
+ } finally {
+ if (file_exists($specialFile)) {
+ unlink($specialFile);
+ }
+ }
+
+ // Test writing large content
+ $largeFile = $tempDir . '/webfiori_large_output.txt';
+ try {
+ $largeStream = new FileOutputStream($largeFile);
+ $largeContent = str_repeat('Large content line ' . str_repeat('x', 100) . "\n", 1000);
+ $largeStream->prints($largeContent);
+ unset($largeStream);
+
+ $this->assertEquals($largeContent, file_get_contents($largeFile));
+ $this->assertGreaterThan(100000, filesize($largeFile)); // Should be large file
+ } finally {
+ if (file_exists($largeFile)) {
+ unlink($largeFile);
+ }
+ }
+ }
+
+ /**
+ * Test FileInputStream with empty file throws exception
+ * @test
+ */
+ public function testFileInputStreamEmptyFileException() {
+ $tempDir = sys_get_temp_dir();
+
+ // Test with empty file
+ $emptyFile = $tempDir . '/webfiori_empty.txt';
+ file_put_contents($emptyFile, '');
+
+ try {
+ $emptyStream = new FileInputStream($emptyFile);
+
+ // Reading from empty file should return empty string
+ $data = $emptyStream->read(1);
+ $this->assertEquals('', $data);
+ $this->assertEquals(0, strlen($data));
+ } finally {
+ if (file_exists($emptyFile)) {
+ unlink($emptyFile);
+ }
+ }
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/FormatterTest.php b/tests/WebFiori/Tests/Cli/FormatterTest.php
index 64dfad8..21db5ac 100644
--- a/tests/WebFiori/Tests/Cli/FormatterTest.php
+++ b/tests/WebFiori/Tests/Cli/FormatterTest.php
@@ -1,440 +1,440 @@
-assertEquals('Hello', Formatter::format('Hello'));
- }
- /**
- * @test
- */
- public function test01() {
- $this->assertEquals("\e[31mHello\e[0m", Formatter::format('Hello', [
- 'color' => 'red',
- 'ansi' => true
- ]));
- }
- /**
- * @test
- */
- public function test02() {
- $this->assertEquals("\e[1mHello\e[0m", Formatter::format('Hello', [
- 'bold' => true, 'ansi' => true,
- 'ansi' => true
- ]));
- }
- /**
- * @test
- */
- public function test03() {
- $this->assertEquals("\e[4mHello\e[0m", Formatter::format('Hello', [
- 'underline' => true,
- 'ansi' => true
- ]));
- }
- /**
- * @test
- */
- public function test04() {
- $this->assertEquals("\e[1;4mHello\e[0m", Formatter::format('Hello', [
- 'underline' => true,
- 'bold' => true, 'ansi' => true,
- 'ansi' => true
- ]));
- }
- /**
- * @test
- */
- public function test05() {
- $this->assertEquals("\e[7mHello\e[0m", Formatter::format('Hello', [
- 'reverse' => true,
- 'ansi' => true
- ]));
- }
- /**
- * @test
- */
- public function test06() {
- $this->assertEquals("\e[1;4;7mHello\e[0m", Formatter::format('Hello', [
- 'reverse' => true,
- 'bold' => true, 'ansi' => true,
- 'underline' => true,
- 'ansi' => true
- ]));
- }
- /**
- * @test
- */
- public function test07() {
- $this->assertEquals("\e[1;4;7;93mHello\e[0m", Formatter::format('Hello', [
- 'reverse' => true,
- 'bold' => true, 'ansi' => true,
- 'underline' => true,
- 'color' => 'light-yellow',
- 'ansi' => true
- ]));
- }
- /**
- * @test
- */
- public function test08() {
- $this->assertEquals("\e[1;4;7mHello\e[0m", Formatter::format('Hello', [
- 'reverse' => true,
- 'bold' => true, 'ansi' => true,
- 'underline' => true,
- 'color' => 'not supported',
- 'ansi' => true
- ]));
- }
- /**
- * @test
- */
- public function test09() {
- $this->assertEquals("\e[1;4;7;40mHello\e[0m", Formatter::format('Hello', [
- 'reverse' => true,
- 'bold' => true, 'ansi' => true,
- 'underline' => true,
- 'bg-color' => 'black',
- 'ansi' => true
- ]));
- }
- /**
- * @test
- */
- public function test10() {
- $this->assertEquals("\e[1;4;7mHello\e[0m", Formatter::format('Hello', [
- 'reverse' => true,
- 'bold' => true, 'ansi' => true,
- 'underline' => true,
- 'bg-color' => 'ggg',
- 'ansi' => true
- ]));
- }
- /**
- * @test
- */
- public function test11() {
- $this->assertEquals("\e[1;4;5;7;33;43mHello\e[0m", Formatter::format('Hello', [
- 'reverse' => true,
- 'bold' => true, 'ansi' => true,
- 'underline' => true,
- 'bg-color' => 'yellow',
- 'color' => 'yellow',
- 'blink' => true,
- 'ansi' => true
- ]));
- }
- /**
- * @test
- */
- public function test12() {
- $_SERVER['NO_COLOR'] = 1;
- $this->assertEquals("\e[1;4;5;7mHello\e[0m", Formatter::format('Hello', [
- 'reverse' => true,
- 'bold' => true, 'ansi' => true,
- 'underline' => true,
- 'bg-color' => 'yellow',
- 'color' => 'yellow',
- 'blink' => true,
- 'ansi' => true
- ]));
- $_SERVER['NO_COLOR'] = null;
- }
- /**
- * @test
- */
- public function test13() {
- $_SERVER['NO_COLOR'] = 1;
- $this->assertEquals("Hello", Formatter::format('Hello', [
- 'reverse' => true,
- 'bold' => true, 'ansi' => true,
- 'underline' => true,
- 'bg-color' => 'yellow',
- 'color' => 'yellow',
- 'blink' => true,
- 'ansi' => false
- ]));
- $_SERVER['NO_COLOR'] = null;
- }
-
- /**
- * Test basic color formatting
- * @test
- */
- public function testBasicColorFormattingEnhanced() {
- // Test all supported colors
- $colors = ['black', 'red', 'light-red', 'green', 'light-green', 'yellow', 'light-yellow', 'white', 'gray', 'blue', 'light-blue'];
-
- foreach ($colors as $color) {
- $result = Formatter::format('Test text', ['color' => $color, 'ansi' => true]);
- $this->assertStringContainsString('Test text', $result);
- $this->assertStringContainsString("\e[", $result); // Should contain ANSI escape sequence
- }
- }
-
- /**
- * Test background color formatting
- * @test
- */
- public function testBackgroundColorFormattingEnhanced() {
- $bgColors = ['black', 'red', 'green', 'yellow', 'blue', 'white'];
-
- foreach ($bgColors as $bgColor) {
- $result = Formatter::format('Test text', ['bg-color' => $bgColor, 'ansi' => true]);
- $this->assertStringContainsString('Test text', $result);
- $this->assertStringContainsString("\e[", $result); // Should contain ANSI escape sequence
- }
- }
-
- /**
- * Test text styling options
- * @test
- */
- public function testTextStylingEnhanced() {
- // Test bold
- $boldResult = Formatter::format('Bold text', ['bold' => true, 'ansi' => true]);
- $this->assertStringContainsString('Bold text', $boldResult);
- $this->assertStringContainsString("\e[1m", $boldResult); // Bold ANSI code
-
- // Test underline
- $underlineResult = Formatter::format('Underlined text', ['underline' => true, 'ansi' => true]);
- $this->assertStringContainsString('Underlined text', $underlineResult);
- $this->assertStringContainsString("\e[4m", $underlineResult); // Underline ANSI code
-
- // Test blink
- $blinkResult = Formatter::format('Blinking text', ['blink' => true, 'ansi' => true]);
- $this->assertStringContainsString('Blinking text', $blinkResult);
- $this->assertStringContainsString("\e[5m", $blinkResult); // Blink ANSI code
-
- // Test reverse
- $reverseResult = Formatter::format('Reversed text', ['reverse' => true, 'ansi' => true]);
- $this->assertStringContainsString('Reversed text', $reverseResult);
- $this->assertStringContainsString("\e[7m", $reverseResult); // Reverse ANSI code
- }
-
- /**
- * Test combined formatting options
- * @test
- */
- public function testCombinedFormattingEnhanced() {
- $result = Formatter::format('Formatted text', [
- 'color' => 'red',
- 'bg-color' => 'white',
- 'bold' => true, 'ansi' => true,
- 'underline' => true
- ]);
-
- $this->assertStringContainsString('Formatted text', $result);
- $this->assertStringContainsString("\e[", $result); // Contains ANSI escape
- $this->assertStringContainsString("107m", $result); // White background code in combined format
- $this->assertStringContainsString("\e[0m", $result); // Reset
- }
-
- /**
- * Test invalid color handling
- * @test
- */
- public function testInvalidColorHandlingEnhanced() {
- // Test with invalid color
- $result = Formatter::format('Test text', ['color' => 'invalid-color']);
- $this->assertStringContainsString('Test text', $result);
-
- // Test with invalid background color
- $result2 = Formatter::format('Test text', ['bg-color' => 'invalid-bg-color']);
- $this->assertStringContainsString('Test text', $result2);
- }
-
- /**
- * Test empty and null input handling
- * @test
- */
- public function testEmptyAndNullInputHandlingEnhanced() {
- // Test empty string
- $result1 = Formatter::format('', ['color' => 'red']);
- $this->assertIsString($result1);
-
- // Test with empty options
- $result2 = Formatter::format('Test text', []);
- $this->assertEquals('Test text', $result2);
-
- // Test with null options (if supported)
- $result3 = Formatter::format('Test text', []);
- $this->assertEquals('Test text', $result3);
- }
-
- /**
- * Test special characters and unicode
- * @test
- */
- public function testSpecialCharactersAndUnicodeEnhanced() {
- $specialText = 'Special chars: ร รกรขรฃรครฅรฆรงรจรฉรชรซ ไธญๆ ๐ รฑ';
- $result = Formatter::format($specialText, ['color' => 'green', 'ansi' => true]);
-
- $this->assertStringContainsString($specialText, $result);
- $this->assertStringContainsString("\e[32m", $result); // Green color
- }
-
- /**
- * Test boolean option handling
- * @test
- */
- public function testBooleanOptionHandlingEnhanced() {
- // Test with explicit true
- $result1 = Formatter::format('Bold text', ['bold' => true, 'ansi' => true]);
- $this->assertStringContainsString("\e[1m", $result1);
-
- // Test with explicit false
- $result2 = Formatter::format('Normal text', ['bold' => false]);
- $this->assertStringNotContainsString("\e[1m", $result2);
-
- // Test with truthy values
- $result3 = Formatter::format('Bold text', ['bold' => 1, 'ansi' => true]);
- $this->assertStringContainsString("\e[1m", $result3);
-
- // Test with falsy values
- $result4 = Formatter::format('Normal text', ['bold' => 0]);
- $this->assertStringNotContainsString("\e[1m", $result4);
- }
-
- /**
- * Test case insensitive color names
- * @test
- */
- public function testCaseInsensitiveColorNamesEnhanced() {
- $result1 = Formatter::format('Red text', ['color' => 'RED', 'ansi' => true]);
- $result2 = Formatter::format('Red text', ['color' => 'red', 'ansi' => true]);
- $result3 = Formatter::format('Red text', ['color' => 'Red', 'ansi' => true]);
-
- // All should produce the same result (case insensitive)
- $this->assertStringNotContainsString("\e[31m", $result1); // RED doesn't work
- $this->assertStringContainsString("\e[31m", $result2);
- $this->assertStringNotContainsString("\e[31m", $result3); // Red doesn't work
- }
-
- /**
- * Test nested formatting (if supported)
- * @test
- */
- public function testNestedFormattingEnhanced() {
- $text = 'This is {{red}}red text{{/red}} and {{bold}}bold text{{/bold}}';
-
- // Test if the formatter supports nested formatting
- $result = Formatter::format($text, []);
- $this->assertStringContainsString('red text', $result);
- $this->assertStringContainsString('bold text', $result);
- }
-
- /**
- * Test long text formatting
- * @test
- */
- public function testLongTextFormattingEnhanced() {
- $longText = str_repeat('This is a very long text that should be formatted properly. ', 100);
- $result = Formatter::format($longText, ['color' => 'blue', 'bold' => true, 'ansi' => true]);
-
- $this->assertStringContainsString($longText, $result);
- $this->assertStringContainsString("\e[", $result); // Contains ANSI escape
- $this->assertStringContainsString("\e[0m", $result); // Reset
- }
-
- /**
- * Test multiline text formatting
- * @test
- */
- public function testMultilineTextFormattingEnhanced() {
- $multilineText = "Line 1\nLine 2\nLine 3";
- $result = Formatter::format($multilineText, ['color' => 'green', 'ansi' => true]);
-
- $this->assertStringContainsString("Line 1", $result);
- $this->assertStringContainsString("Line 2", $result);
- $this->assertStringContainsString("Line 3", $result);
- $this->assertStringContainsString("\e[32m", $result); // Green color
- }
-
- /**
- * Test format option validation
- * @test
- */
- public function testFormatOptionValidationEnhanced() {
- // Test with string values for boolean options
- $result1 = Formatter::format('Text', ['bold' => 'true']);
- $result2 = Formatter::format('Text', ['bold' => 'false']);
- $result3 = Formatter::format('Text', ['bold' => 'yes']);
- $result4 = Formatter::format('Text', ['bold' => 'no']);
-
- // The behavior depends on implementation, but should handle gracefully
- $this->assertIsString($result1);
- $this->assertIsString($result2);
- $this->assertIsString($result3);
- $this->assertIsString($result4);
- }
-
- /**
- * Test color constants
- * @test
- */
- public function testColorConstantsEnhanced() {
- $colors = Formatter::COLORS;
-
- $this->assertIsArray($colors);
- $this->assertArrayHasKey('red', $colors);
- $this->assertArrayHasKey('green', $colors);
- $this->assertArrayHasKey('blue', $colors);
- $this->assertArrayHasKey('black', $colors);
- $this->assertArrayHasKey('white', $colors);
-
- // Test that color codes are integers
- foreach ($colors as $colorName => $colorCode) {
- $this->assertIsInt($colorCode);
- $this->assertGreaterThan(0, $colorCode);
- }
- }
-
- /**
- * Test performance with large inputs
- * @test
- */
- public function testPerformanceWithLargeInputsEnhanced() {
- $largeText = str_repeat('Performance test text. ', 10000);
-
- $startTime = microtime(true);
- $result = Formatter::format($largeText, ['color' => 'red', 'bold' => true, 'ansi' => true]);
- $endTime = microtime(true);
-
- $executionTime = $endTime - $startTime;
-
- $this->assertStringContainsString('Performance test text.', $result);
- $this->assertLessThan(1.0, $executionTime); // Should complete within 1 second
- }
-
- /**
- * Test format method with various data types
- * @test
- */
- public function testFormatWithVariousDataTypesEnhanced() {
- // Test with numeric input
- $result1 = Formatter::format(123, ['color' => 'red']);
- $this->assertStringContainsString('123', $result1);
-
- // Test with float input
- $result2 = Formatter::format(3.14, ['color' => 'blue']);
- $this->assertStringContainsString('3.14', $result2);
-
- // Test with boolean input (if supported)
- $result3 = Formatter::format(true, ['color' => 'green']);
- $this->assertIsString($result3);
-
- $result4 = Formatter::format(false, ['color' => 'yellow']);
- $this->assertIsString($result4);
- }
-}
+assertEquals('Hello', Formatter::format('Hello'));
+ }
+ /**
+ * @test
+ */
+ public function test01() {
+ $this->assertEquals("\e[31mHello\e[0m", Formatter::format('Hello', [
+ 'color' => 'red',
+ 'ansi' => true
+ ]));
+ }
+ /**
+ * @test
+ */
+ public function test02() {
+ $this->assertEquals("\e[1mHello\e[0m", Formatter::format('Hello', [
+ 'bold' => true, 'ansi' => true,
+ 'ansi' => true
+ ]));
+ }
+ /**
+ * @test
+ */
+ public function test03() {
+ $this->assertEquals("\e[4mHello\e[0m", Formatter::format('Hello', [
+ 'underline' => true,
+ 'ansi' => true
+ ]));
+ }
+ /**
+ * @test
+ */
+ public function test04() {
+ $this->assertEquals("\e[1;4mHello\e[0m", Formatter::format('Hello', [
+ 'underline' => true,
+ 'bold' => true, 'ansi' => true,
+ 'ansi' => true
+ ]));
+ }
+ /**
+ * @test
+ */
+ public function test05() {
+ $this->assertEquals("\e[7mHello\e[0m", Formatter::format('Hello', [
+ 'reverse' => true,
+ 'ansi' => true
+ ]));
+ }
+ /**
+ * @test
+ */
+ public function test06() {
+ $this->assertEquals("\e[1;4;7mHello\e[0m", Formatter::format('Hello', [
+ 'reverse' => true,
+ 'bold' => true, 'ansi' => true,
+ 'underline' => true,
+ 'ansi' => true
+ ]));
+ }
+ /**
+ * @test
+ */
+ public function test07() {
+ $this->assertEquals("\e[1;4;7;93mHello\e[0m", Formatter::format('Hello', [
+ 'reverse' => true,
+ 'bold' => true, 'ansi' => true,
+ 'underline' => true,
+ 'color' => 'light-yellow',
+ 'ansi' => true
+ ]));
+ }
+ /**
+ * @test
+ */
+ public function test08() {
+ $this->assertEquals("\e[1;4;7mHello\e[0m", Formatter::format('Hello', [
+ 'reverse' => true,
+ 'bold' => true, 'ansi' => true,
+ 'underline' => true,
+ 'color' => 'not supported',
+ 'ansi' => true
+ ]));
+ }
+ /**
+ * @test
+ */
+ public function test09() {
+ $this->assertEquals("\e[1;4;7;40mHello\e[0m", Formatter::format('Hello', [
+ 'reverse' => true,
+ 'bold' => true, 'ansi' => true,
+ 'underline' => true,
+ 'bg-color' => 'black',
+ 'ansi' => true
+ ]));
+ }
+ /**
+ * @test
+ */
+ public function test10() {
+ $this->assertEquals("\e[1;4;7mHello\e[0m", Formatter::format('Hello', [
+ 'reverse' => true,
+ 'bold' => true, 'ansi' => true,
+ 'underline' => true,
+ 'bg-color' => 'ggg',
+ 'ansi' => true
+ ]));
+ }
+ /**
+ * @test
+ */
+ public function test11() {
+ $this->assertEquals("\e[1;4;5;7;33;43mHello\e[0m", Formatter::format('Hello', [
+ 'reverse' => true,
+ 'bold' => true, 'ansi' => true,
+ 'underline' => true,
+ 'bg-color' => 'yellow',
+ 'color' => 'yellow',
+ 'blink' => true,
+ 'ansi' => true
+ ]));
+ }
+ /**
+ * @test
+ */
+ public function test12() {
+ $_SERVER['NO_COLOR'] = 1;
+ $this->assertEquals("\e[1;4;5;7mHello\e[0m", Formatter::format('Hello', [
+ 'reverse' => true,
+ 'bold' => true, 'ansi' => true,
+ 'underline' => true,
+ 'bg-color' => 'yellow',
+ 'color' => 'yellow',
+ 'blink' => true,
+ 'ansi' => true
+ ]));
+ $_SERVER['NO_COLOR'] = null;
+ }
+ /**
+ * @test
+ */
+ public function test13() {
+ $_SERVER['NO_COLOR'] = 1;
+ $this->assertEquals("Hello", Formatter::format('Hello', [
+ 'reverse' => true,
+ 'bold' => true, 'ansi' => true,
+ 'underline' => true,
+ 'bg-color' => 'yellow',
+ 'color' => 'yellow',
+ 'blink' => true,
+ 'ansi' => false
+ ]));
+ $_SERVER['NO_COLOR'] = null;
+ }
+
+ /**
+ * Test basic color formatting
+ * @test
+ */
+ public function testBasicColorFormattingEnhanced() {
+ // Test all supported colors
+ $colors = ['black', 'red', 'light-red', 'green', 'light-green', 'yellow', 'light-yellow', 'white', 'gray', 'blue', 'light-blue'];
+
+ foreach ($colors as $color) {
+ $result = Formatter::format('Test text', ['color' => $color, 'ansi' => true]);
+ $this->assertStringContainsString('Test text', $result);
+ $this->assertStringContainsString("\e[", $result); // Should contain ANSI escape sequence
+ }
+ }
+
+ /**
+ * Test background color formatting
+ * @test
+ */
+ public function testBackgroundColorFormattingEnhanced() {
+ $bgColors = ['black', 'red', 'green', 'yellow', 'blue', 'white'];
+
+ foreach ($bgColors as $bgColor) {
+ $result = Formatter::format('Test text', ['bg-color' => $bgColor, 'ansi' => true]);
+ $this->assertStringContainsString('Test text', $result);
+ $this->assertStringContainsString("\e[", $result); // Should contain ANSI escape sequence
+ }
+ }
+
+ /**
+ * Test text styling options
+ * @test
+ */
+ public function testTextStylingEnhanced() {
+ // Test bold
+ $boldResult = Formatter::format('Bold text', ['bold' => true, 'ansi' => true]);
+ $this->assertStringContainsString('Bold text', $boldResult);
+ $this->assertStringContainsString("\e[1m", $boldResult); // Bold ANSI code
+
+ // Test underline
+ $underlineResult = Formatter::format('Underlined text', ['underline' => true, 'ansi' => true]);
+ $this->assertStringContainsString('Underlined text', $underlineResult);
+ $this->assertStringContainsString("\e[4m", $underlineResult); // Underline ANSI code
+
+ // Test blink
+ $blinkResult = Formatter::format('Blinking text', ['blink' => true, 'ansi' => true]);
+ $this->assertStringContainsString('Blinking text', $blinkResult);
+ $this->assertStringContainsString("\e[5m", $blinkResult); // Blink ANSI code
+
+ // Test reverse
+ $reverseResult = Formatter::format('Reversed text', ['reverse' => true, 'ansi' => true]);
+ $this->assertStringContainsString('Reversed text', $reverseResult);
+ $this->assertStringContainsString("\e[7m", $reverseResult); // Reverse ANSI code
+ }
+
+ /**
+ * Test combined formatting options
+ * @test
+ */
+ public function testCombinedFormattingEnhanced() {
+ $result = Formatter::format('Formatted text', [
+ 'color' => 'red',
+ 'bg-color' => 'white',
+ 'bold' => true, 'ansi' => true,
+ 'underline' => true
+ ]);
+
+ $this->assertStringContainsString('Formatted text', $result);
+ $this->assertStringContainsString("\e[", $result); // Contains ANSI escape
+ $this->assertStringContainsString("107m", $result); // White background code in combined format
+ $this->assertStringContainsString("\e[0m", $result); // Reset
+ }
+
+ /**
+ * Test invalid color handling
+ * @test
+ */
+ public function testInvalidColorHandlingEnhanced() {
+ // Test with invalid color
+ $result = Formatter::format('Test text', ['color' => 'invalid-color']);
+ $this->assertStringContainsString('Test text', $result);
+
+ // Test with invalid background color
+ $result2 = Formatter::format('Test text', ['bg-color' => 'invalid-bg-color']);
+ $this->assertStringContainsString('Test text', $result2);
+ }
+
+ /**
+ * Test empty and null input handling
+ * @test
+ */
+ public function testEmptyAndNullInputHandlingEnhanced() {
+ // Test empty string
+ $result1 = Formatter::format('', ['color' => 'red']);
+ $this->assertIsString($result1);
+
+ // Test with empty options
+ $result2 = Formatter::format('Test text', []);
+ $this->assertEquals('Test text', $result2);
+
+ // Test with null options (if supported)
+ $result3 = Formatter::format('Test text', []);
+ $this->assertEquals('Test text', $result3);
+ }
+
+ /**
+ * Test special characters and unicode
+ * @test
+ */
+ public function testSpecialCharactersAndUnicodeEnhanced() {
+ $specialText = 'Special chars: ร รกรขรฃรครฅรฆรงรจรฉรชรซ ไธญๆ ๐ รฑ';
+ $result = Formatter::format($specialText, ['color' => 'green', 'ansi' => true]);
+
+ $this->assertStringContainsString($specialText, $result);
+ $this->assertStringContainsString("\e[32m", $result); // Green color
+ }
+
+ /**
+ * Test boolean option handling
+ * @test
+ */
+ public function testBooleanOptionHandlingEnhanced() {
+ // Test with explicit true
+ $result1 = Formatter::format('Bold text', ['bold' => true, 'ansi' => true]);
+ $this->assertStringContainsString("\e[1m", $result1);
+
+ // Test with explicit false
+ $result2 = Formatter::format('Normal text', ['bold' => false]);
+ $this->assertStringNotContainsString("\e[1m", $result2);
+
+ // Test with truthy values
+ $result3 = Formatter::format('Bold text', ['bold' => 1, 'ansi' => true]);
+ $this->assertStringContainsString("\e[1m", $result3);
+
+ // Test with falsy values
+ $result4 = Formatter::format('Normal text', ['bold' => 0]);
+ $this->assertStringNotContainsString("\e[1m", $result4);
+ }
+
+ /**
+ * Test case insensitive color names
+ * @test
+ */
+ public function testCaseInsensitiveColorNamesEnhanced() {
+ $result1 = Formatter::format('Red text', ['color' => 'RED', 'ansi' => true]);
+ $result2 = Formatter::format('Red text', ['color' => 'red', 'ansi' => true]);
+ $result3 = Formatter::format('Red text', ['color' => 'Red', 'ansi' => true]);
+
+ // All should produce the same result (case insensitive)
+ $this->assertStringNotContainsString("\e[31m", $result1); // RED doesn't work
+ $this->assertStringContainsString("\e[31m", $result2);
+ $this->assertStringNotContainsString("\e[31m", $result3); // Red doesn't work
+ }
+
+ /**
+ * Test nested formatting (if supported)
+ * @test
+ */
+ public function testNestedFormattingEnhanced() {
+ $text = 'This is {{red}}red text{{/red}} and {{bold}}bold text{{/bold}}';
+
+ // Test if the formatter supports nested formatting
+ $result = Formatter::format($text, []);
+ $this->assertStringContainsString('red text', $result);
+ $this->assertStringContainsString('bold text', $result);
+ }
+
+ /**
+ * Test long text formatting
+ * @test
+ */
+ public function testLongTextFormattingEnhanced() {
+ $longText = str_repeat('This is a very long text that should be formatted properly. ', 100);
+ $result = Formatter::format($longText, ['color' => 'blue', 'bold' => true, 'ansi' => true]);
+
+ $this->assertStringContainsString($longText, $result);
+ $this->assertStringContainsString("\e[", $result); // Contains ANSI escape
+ $this->assertStringContainsString("\e[0m", $result); // Reset
+ }
+
+ /**
+ * Test multiline text formatting
+ * @test
+ */
+ public function testMultilineTextFormattingEnhanced() {
+ $multilineText = "Line 1\nLine 2\nLine 3";
+ $result = Formatter::format($multilineText, ['color' => 'green', 'ansi' => true]);
+
+ $this->assertStringContainsString("Line 1", $result);
+ $this->assertStringContainsString("Line 2", $result);
+ $this->assertStringContainsString("Line 3", $result);
+ $this->assertStringContainsString("\e[32m", $result); // Green color
+ }
+
+ /**
+ * Test format option validation
+ * @test
+ */
+ public function testFormatOptionValidationEnhanced() {
+ // Test with string values for boolean options
+ $result1 = Formatter::format('Text', ['bold' => 'true']);
+ $result2 = Formatter::format('Text', ['bold' => 'false']);
+ $result3 = Formatter::format('Text', ['bold' => 'yes']);
+ $result4 = Formatter::format('Text', ['bold' => 'no']);
+
+ // The behavior depends on implementation, but should handle gracefully
+ $this->assertIsString($result1);
+ $this->assertIsString($result2);
+ $this->assertIsString($result3);
+ $this->assertIsString($result4);
+ }
+
+ /**
+ * Test color constants
+ * @test
+ */
+ public function testColorConstantsEnhanced() {
+ $colors = Formatter::COLORS;
+
+ $this->assertIsArray($colors);
+ $this->assertArrayHasKey('red', $colors);
+ $this->assertArrayHasKey('green', $colors);
+ $this->assertArrayHasKey('blue', $colors);
+ $this->assertArrayHasKey('black', $colors);
+ $this->assertArrayHasKey('white', $colors);
+
+ // Test that color codes are integers
+ foreach ($colors as $colorName => $colorCode) {
+ $this->assertIsInt($colorCode);
+ $this->assertGreaterThan(0, $colorCode);
+ }
+ }
+
+ /**
+ * Test performance with large inputs
+ * @test
+ */
+ public function testPerformanceWithLargeInputsEnhanced() {
+ $largeText = str_repeat('Performance test text. ', 10000);
+
+ $startTime = microtime(true);
+ $result = Formatter::format($largeText, ['color' => 'red', 'bold' => true, 'ansi' => true]);
+ $endTime = microtime(true);
+
+ $executionTime = $endTime - $startTime;
+
+ $this->assertStringContainsString('Performance test text.', $result);
+ $this->assertLessThan(1.0, $executionTime); // Should complete within 1 second
+ }
+
+ /**
+ * Test format method with various data types
+ * @test
+ */
+ public function testFormatWithVariousDataTypesEnhanced() {
+ // Test with numeric input
+ $result1 = Formatter::format(123, ['color' => 'red']);
+ $this->assertStringContainsString('123', $result1);
+
+ // Test with float input
+ $result2 = Formatter::format(3.14, ['color' => 'blue']);
+ $this->assertStringContainsString('3.14', $result2);
+
+ // Test with boolean input (if supported)
+ $result3 = Formatter::format(true, ['color' => 'green']);
+ $this->assertIsString($result3);
+
+ $result4 = Formatter::format(false, ['color' => 'yellow']);
+ $this->assertIsString($result4);
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/InitAppCommandTest.php b/tests/WebFiori/Tests/Cli/InitAppCommandTest.php
index b465e80..45a0d34 100644
--- a/tests/WebFiori/Tests/Cli/InitAppCommandTest.php
+++ b/tests/WebFiori/Tests/Cli/InitAppCommandTest.php
@@ -1,155 +1,155 @@
-register(new InitAppCommand());
- $r->setDefaultCommand('init');
- $r->setInputs([]);
- $r->setArgsVector([
- 'main.php',
- 'init'
- ]);
- $this->assertEquals(-1, $r->start());
- $this->assertEquals([
- "Error: The following required argument(s) are missing: '--dir'\n"
- ], $r->getOutput());
- }
- /**
- * @test
- */
- public function test01() {
- $r = new Runner();
- $r->register(new InitAppCommand());
- $r->setDefaultCommand('init');
- $r->setInputs([]);
- $r->setArgsVector([
- 'main.php',
- 'init',
- '--dir' => "test\0a"
- ]);
- $this->assertEquals(-1, $r->start());
- $output = $r->getOutput();
- // Check key elements instead of exact match due to binary string representation differences
- $this->assertCount(4, $output);
- $this->assertStringContainsString('Creating new app at', $output[0]);
- $this->assertStringContainsString('Creating "test', $output[1]);
- $this->assertStringContainsString('Error: Unable to initialize', $output[2]);
- $this->assertStringContainsString('null bytes', $output[3]);
- }
- /**
- * @test
- */
- public function test02() {
- $r = new Runner();
- $r->register(new InitAppCommand())
- ->setDefaultCommand('init')
- ->setInputs([])
- ->setArgsVector([
- 'main.php',
- 'init',
- '--dir' => 'test'
- ]);
- // Cleanup existing files
- $appPath = ROOT_DIR.'test';
- if (file_exists($appPath)) {
- unlink(ROOT_DIR.DS.'test'.DS.'main.php');
- unlink(ROOT_DIR.DS.'test'.DS.'HelloCommand.php');
- unlink(ROOT_DIR.DS.'test'.DS.'main');
- rmdir(ROOT_DIR.DS.'test');
- }
- $this->assertEquals(0, $r->start());
- $this->assertEquals([
- "Creating new app at \"$appPath\" ...\n",
- "Creating \"test/main.php\"...\n",
- "Creating \"test/main\"...\n",
- "Creating \"test/HelloCommand.php\"...\n",
- "Success: App created successfully.\n"
- ], $r->getOutput());
- }
- /**
- * @test
- * @depends test02
- */
- public function test03() {
- $r = new Runner();
- $r->register(new InitAppCommand());
- $r->setDefaultCommand('init');
- $r->setInputs([]);
- $r->setArgsVector([
- 'main.php',
- 'init',
- '--dir' => 'test'
- ]);
- // Don't cleanup - this test expects files to exist
- $this->assertEquals(0, $r->start());
- $appPath = ROOT_DIR.'test';
- $this->assertEquals([
- "Creating new app at \"$appPath\" ...\n",
- "Creating \"test/main.php\"...\n",
- "Warning: File main.php already exist!\n",
- "Creating \"test/main\"...\n",
- "Warning: File main already exist!\n",
- "Creating \"test/HelloCommand.php\"...\n",
- "Warning: File HelloCommand.php already exist!\n",
- "Success: App created successfully.\n"
- ], $r->getOutput());
- unlink(ROOT_DIR.DS.'test'.DS.'main.php');
- unlink(ROOT_DIR.DS.'test'.DS.'HelloCommand.php');
- unlink(ROOT_DIR.DS.'test'.DS.'main');
- rmdir(ROOT_DIR.DS.'test');
- }
- /**
- * @test
- */
- public function test04() {
- $r = new Runner();
- $r->register(new InitAppCommand());
- $r->setDefaultCommand('init');
- $r->setInputs([]);
- $r->setArgsVector([
- 'main.php',
- 'init',
- '--dir' => 'test2',
- '--entry' => 'bang'
- ]);
- // Cleanup existing files
- $appPath = ROOT_DIR.'test2';
- if (file_exists($appPath)) {
- unlink($appPath.DS.'main.php');
- unlink($appPath.DS.'bang');
- unlink($appPath.DS.'HelloCommand.php');
- rmdir($appPath);
- }
- $this->assertEquals(0, $r->start());
- $this->assertEquals([
- "Creating new app at \"$appPath\" ...\n",
- "Creating \"test2/main.php\"...\n",
- "Creating \"test2/bang\"...\n",
- "Creating \"test2/HelloCommand.php\"...\n",
- "Success: App created successfully.\n"
- ], $r->getOutput());
- unlink($appPath.DS.'main.php');
- unlink($appPath.DS.'bang');
- unlink($appPath.DS.'HelloCommand.php');
- rmdir($appPath);
- }
-}
-
-
-
-
-
+register(new InitAppCommand());
+ $r->setDefaultCommand('init');
+ $r->setInputs([]);
+ $r->setArgsVector([
+ 'main.php',
+ 'init'
+ ]);
+ $this->assertEquals(-1, $r->start());
+ $this->assertEquals([
+ "Error: The following required argument(s) are missing: '--dir'\n"
+ ], $r->getOutput());
+ }
+ /**
+ * @test
+ */
+ public function test01() {
+ $r = new Runner();
+ $r->register(new InitAppCommand());
+ $r->setDefaultCommand('init');
+ $r->setInputs([]);
+ $r->setArgsVector([
+ 'main.php',
+ 'init',
+ '--dir' => "test\0a"
+ ]);
+ $this->assertEquals(-1, $r->start());
+ $output = $r->getOutput();
+ // Check key elements instead of exact match due to binary string representation differences
+ $this->assertCount(4, $output);
+ $this->assertStringContainsString('Creating new app at', $output[0]);
+ $this->assertStringContainsString('Creating "test', $output[1]);
+ $this->assertStringContainsString('Error: Unable to initialize', $output[2]);
+ $this->assertStringContainsString('null bytes', $output[3]);
+ }
+ /**
+ * @test
+ */
+ public function test02() {
+ $r = new Runner();
+ $r->register(new InitAppCommand())
+ ->setDefaultCommand('init')
+ ->setInputs([])
+ ->setArgsVector([
+ 'main.php',
+ 'init',
+ '--dir' => 'test'
+ ]);
+ // Cleanup existing files
+ $appPath = ROOT_DIR.'test';
+ if (file_exists($appPath)) {
+ unlink(ROOT_DIR.DS.'test'.DS.'main.php');
+ unlink(ROOT_DIR.DS.'test'.DS.'HelloCommand.php');
+ unlink(ROOT_DIR.DS.'test'.DS.'main');
+ rmdir(ROOT_DIR.DS.'test');
+ }
+ $this->assertEquals(0, $r->start());
+ $this->assertEquals([
+ "Creating new app at \"$appPath\" ...\n",
+ "Creating \"test/main.php\"...\n",
+ "Creating \"test/main\"...\n",
+ "Creating \"test/HelloCommand.php\"...\n",
+ "Success: App created successfully.\n"
+ ], $r->getOutput());
+ }
+ /**
+ * @test
+ * @depends test02
+ */
+ public function test03() {
+ $r = new Runner();
+ $r->register(new InitAppCommand());
+ $r->setDefaultCommand('init');
+ $r->setInputs([]);
+ $r->setArgsVector([
+ 'main.php',
+ 'init',
+ '--dir' => 'test'
+ ]);
+ // Don't cleanup - this test expects files to exist
+ $this->assertEquals(0, $r->start());
+ $appPath = ROOT_DIR.'test';
+ $this->assertEquals([
+ "Creating new app at \"$appPath\" ...\n",
+ "Creating \"test/main.php\"...\n",
+ "Warning: File main.php already exist!\n",
+ "Creating \"test/main\"...\n",
+ "Warning: File main already exist!\n",
+ "Creating \"test/HelloCommand.php\"...\n",
+ "Warning: File HelloCommand.php already exist!\n",
+ "Success: App created successfully.\n"
+ ], $r->getOutput());
+ unlink(ROOT_DIR.DS.'test'.DS.'main.php');
+ unlink(ROOT_DIR.DS.'test'.DS.'HelloCommand.php');
+ unlink(ROOT_DIR.DS.'test'.DS.'main');
+ rmdir(ROOT_DIR.DS.'test');
+ }
+ /**
+ * @test
+ */
+ public function test04() {
+ $r = new Runner();
+ $r->register(new InitAppCommand());
+ $r->setDefaultCommand('init');
+ $r->setInputs([]);
+ $r->setArgsVector([
+ 'main.php',
+ 'init',
+ '--dir' => 'test2',
+ '--entry' => 'bang'
+ ]);
+ // Cleanup existing files
+ $appPath = ROOT_DIR.'test2';
+ if (file_exists($appPath)) {
+ unlink($appPath.DS.'main.php');
+ unlink($appPath.DS.'bang');
+ unlink($appPath.DS.'HelloCommand.php');
+ rmdir($appPath);
+ }
+ $this->assertEquals(0, $r->start());
+ $this->assertEquals([
+ "Creating new app at \"$appPath\" ...\n",
+ "Creating \"test2/main.php\"...\n",
+ "Creating \"test2/bang\"...\n",
+ "Creating \"test2/HelloCommand.php\"...\n",
+ "Success: App created successfully.\n"
+ ], $r->getOutput());
+ unlink($appPath.DS.'main.php');
+ unlink($appPath.DS.'bang');
+ unlink($appPath.DS.'HelloCommand.php');
+ rmdir($appPath);
+ }
+}
+
+
+
+
+
diff --git a/tests/WebFiori/Tests/Cli/InputValidatorTest.php b/tests/WebFiori/Tests/Cli/InputValidatorTest.php
index 1837b6c..c271575 100644
--- a/tests/WebFiori/Tests/Cli/InputValidatorTest.php
+++ b/tests/WebFiori/Tests/Cli/InputValidatorTest.php
@@ -1,56 +1,56 @@
-assertFalse(InputValidator::isInt(''));
- $this->assertFalse(InputValidator::isInt(' 1 2 3'));
- $this->assertFalse(InputValidator::isInt(' 1 '));
- $this->assertTrue(InputValidator::isInt('66'));
- $this->assertFalse(InputValidator::isInt('6&r7'));
- }
- /**
- * @test
- */
- public function testIsValidFloat() {
- $this->assertFalse(InputValidator::isFloat(''));
- $this->assertFalse(InputValidator::isFloat(' 1 2 3'));
- $this->assertFalse(InputValidator::isFloat(' 1.1.4 '));
- $this->assertTrue(InputValidator::isFloat('66'));
- $this->assertTrue(InputValidator::isFloat('77.9'));
- $this->assertFalse(InputValidator::isFloat('6&r7.90'));
- }
- /**
- * @test
- */
- public function testIsValidClassName00() {
- $this->assertFalse(InputValidator::isValidClassName(''));
- $this->assertFalse(InputValidator::isValidClassName('Hello World'));
- $this->assertFalse(InputValidator::isValidClassName('Hello=World'));
- $this->assertTrue(InputValidator::isValidClassName('Hello9World'));
- $this->assertFalse(InputValidator::isValidClassName('7HelloWorld'));
- $this->assertTrue(InputValidator::isValidClassName('HelloWorld0'));
- $this->assertFalse(InputValidator::isValidClassName('!HelloWorld'));
- $this->assertFalse(InputValidator::isValidClassName('Hello\World'));
- }
- /**
- * @test
- */
- public function testIsValidNs00() {
- $this->assertFalse(InputValidator::isValidNamespace(''));
- $this->assertFalse(InputValidator::isValidNamespace('//'));
- $this->assertTrue(InputValidator::isValidNamespace('\\'));
- $this->assertTrue(InputValidator::isValidNamespace('\\HelloWorld'));
- $this->assertTrue(InputValidator::isValidNamespace('\\HelloWorld\\'));
- $this->assertFalse(InputValidator::isValidNamespace('\\7elloWorld'));
- $this->assertFalse(InputValidator::isValidNamespace('\\HelloWorld\HelloIbrahim\\7ood'));
- $this->assertTrue(InputValidator::isValidNamespace('\\HelloWorld\HelloIbrahim\\Uood7'));
- }
-}
+assertFalse(InputValidator::isInt(''));
+ $this->assertFalse(InputValidator::isInt(' 1 2 3'));
+ $this->assertFalse(InputValidator::isInt(' 1 '));
+ $this->assertTrue(InputValidator::isInt('66'));
+ $this->assertFalse(InputValidator::isInt('6&r7'));
+ }
+ /**
+ * @test
+ */
+ public function testIsValidFloat() {
+ $this->assertFalse(InputValidator::isFloat(''));
+ $this->assertFalse(InputValidator::isFloat(' 1 2 3'));
+ $this->assertFalse(InputValidator::isFloat(' 1.1.4 '));
+ $this->assertTrue(InputValidator::isFloat('66'));
+ $this->assertTrue(InputValidator::isFloat('77.9'));
+ $this->assertFalse(InputValidator::isFloat('6&r7.90'));
+ }
+ /**
+ * @test
+ */
+ public function testIsValidClassName00() {
+ $this->assertFalse(InputValidator::isValidClassName(''));
+ $this->assertFalse(InputValidator::isValidClassName('Hello World'));
+ $this->assertFalse(InputValidator::isValidClassName('Hello=World'));
+ $this->assertTrue(InputValidator::isValidClassName('Hello9World'));
+ $this->assertFalse(InputValidator::isValidClassName('7HelloWorld'));
+ $this->assertTrue(InputValidator::isValidClassName('HelloWorld0'));
+ $this->assertFalse(InputValidator::isValidClassName('!HelloWorld'));
+ $this->assertFalse(InputValidator::isValidClassName('Hello\World'));
+ }
+ /**
+ * @test
+ */
+ public function testIsValidNs00() {
+ $this->assertFalse(InputValidator::isValidNamespace(''));
+ $this->assertFalse(InputValidator::isValidNamespace('//'));
+ $this->assertTrue(InputValidator::isValidNamespace('\\'));
+ $this->assertTrue(InputValidator::isValidNamespace('\\HelloWorld'));
+ $this->assertTrue(InputValidator::isValidNamespace('\\HelloWorld\\'));
+ $this->assertFalse(InputValidator::isValidNamespace('\\7elloWorld'));
+ $this->assertFalse(InputValidator::isValidNamespace('\\HelloWorld\HelloIbrahim\\7ood'));
+ $this->assertTrue(InputValidator::isValidNamespace('\\HelloWorld\HelloIbrahim\\Uood7'));
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/KeysMapTest.php b/tests/WebFiori/Tests/Cli/KeysMapTest.php
index eda39c3..47763cd 100644
--- a/tests/WebFiori/Tests/Cli/KeysMapTest.php
+++ b/tests/WebFiori/Tests/Cli/KeysMapTest.php
@@ -1,80 +1,80 @@
-assertEquals('UP', $result);
-
- // Test DOWN arrow
- $inputStream = new ArrayInputStream(["\033[B"]);
- $result = KeysMap::readAndTranslate($inputStream);
- $this->assertEquals('DOWN', $result);
-
- // Test RIGHT arrow
- $inputStream = new ArrayInputStream(["\033[C"]);
- $result = KeysMap::readAndTranslate($inputStream);
- $this->assertEquals('RIGHT', $result);
-
- // Test LEFT arrow
- $inputStream = new ArrayInputStream(["\033[D"]);
- $result = KeysMap::readAndTranslate($inputStream);
- $this->assertEquals('LEFT', $result);
- }
-
- /**
- * Test that arrow keys don't appear in readline input.
- */
- public function testArrowKeysIgnoredInReadLine() {
- // Input with arrow keys mixed with regular text
- $inputStream = new ArrayInputStream(["\033[A\033[Bhello\033[C\033[D\n"]);
- $result = KeysMap::readLine($inputStream);
-
- // Should only contain "hello", arrow keys should be ignored
- $this->assertEquals('hello', $result);
- }
-
- /**
- * Test that regular characters still work normally.
- */
- public function testRegularCharacters() {
- $inputStream = new ArrayInputStream(["hello world\n"]);
- $result = KeysMap::readLine($inputStream);
-
- $this->assertEquals('hello world', $result);
- }
-
- /**
- * Test backspace functionality still works.
- */
- public function testBackspaceWithArrowKeys() {
- // Type "hello", backspace once, arrow keys (ignored), type "p"
- $inputStream = new ArrayInputStream(["hello\177\033[A\033[Bp\n"]);
- $result = KeysMap::readLine($inputStream);
-
- // Should be "hellp" (hello -> hell -> hell -> hell -> hellp)
- $this->assertEquals('hellp', $result);
- }
-
- /**
- * Test ESC key handling.
- */
- public function testEscapeKey() {
- $inputStream = new ArrayInputStream(["\ehello\n"]);
- $result = KeysMap::readAndTranslate($inputStream);
- $this->assertEquals('ESC', $result);
- }
-}
+assertEquals('UP', $result);
+
+ // Test DOWN arrow
+ $inputStream = new ArrayInputStream(["\033[B"]);
+ $result = KeysMap::readAndTranslate($inputStream);
+ $this->assertEquals('DOWN', $result);
+
+ // Test RIGHT arrow
+ $inputStream = new ArrayInputStream(["\033[C"]);
+ $result = KeysMap::readAndTranslate($inputStream);
+ $this->assertEquals('RIGHT', $result);
+
+ // Test LEFT arrow
+ $inputStream = new ArrayInputStream(["\033[D"]);
+ $result = KeysMap::readAndTranslate($inputStream);
+ $this->assertEquals('LEFT', $result);
+ }
+
+ /**
+ * Test that arrow keys don't appear in readline input.
+ */
+ public function testArrowKeysIgnoredInReadLine() {
+ // Input with arrow keys mixed with regular text
+ $inputStream = new ArrayInputStream(["\033[A\033[Bhello\033[C\033[D\n"]);
+ $result = KeysMap::readLine($inputStream);
+
+ // Should only contain "hello", arrow keys should be ignored
+ $this->assertEquals('hello', $result);
+ }
+
+ /**
+ * Test that regular characters still work normally.
+ */
+ public function testRegularCharacters() {
+ $inputStream = new ArrayInputStream(["hello world\n"]);
+ $result = KeysMap::readLine($inputStream);
+
+ $this->assertEquals('hello world', $result);
+ }
+
+ /**
+ * Test backspace functionality still works.
+ */
+ public function testBackspaceWithArrowKeys() {
+ // Type "hello", backspace once, arrow keys (ignored), type "p"
+ $inputStream = new ArrayInputStream(["hello\177\033[A\033[Bp\n"]);
+ $result = KeysMap::readLine($inputStream);
+
+ // Should be "hellp" (hello -> hell -> hell -> hell -> hellp)
+ $this->assertEquals('hellp', $result);
+ }
+
+ /**
+ * Test ESC key handling.
+ */
+ public function testEscapeKey() {
+ $inputStream = new ArrayInputStream(["\ehello\n"]);
+ $result = KeysMap::readAndTranslate($inputStream);
+ $this->assertEquals('ESC', $result);
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/MakeCommandTest.php b/tests/WebFiori/Tests/Cli/MakeCommandTest.php
index 7ce555b..9b3447e 100644
--- a/tests/WebFiori/Tests/Cli/MakeCommandTest.php
+++ b/tests/WebFiori/Tests/Cli/MakeCommandTest.php
@@ -1,236 +1,236 @@
-testOutputDir)) {
- $this->removeDirectory($this->testOutputDir);
- }
- }
-
- protected function tearDown(): void {
- parent::tearDown();
- // Clean up test directory
- if (is_dir($this->testOutputDir)) {
- $this->removeDirectory($this->testOutputDir);
- }
- }
-
- /**
- * Test basic command generation.
- *
- * @test
- */
- public function testBasicCommandGeneration() {
- $command = new MakeCommand();
-
- $output = $this->executeSingleCommand($command, [
- '--name' => 'test-command',
- '--class' => 'TestCommand',
- '--path' => $this->testOutputDir
- ], ['', 'y']); // Empty namespace, then confirm overwrite if needed
-
- // Check for success message (flexible matching)
- $found = false;
- foreach ($output as $line) {
- if (strpos($line, 'Command generated successfully!') !== false) {
- $found = true;
- break;
- }
- }
- $this->assertTrue($found, 'Success message not found in output');
- $this->assertEquals(0, $this->getExitCode());
-
- // Check if file was created
- $expectedFile = $this->testOutputDir . '/TestCommand.php';
- $this->assertTrue(file_exists($expectedFile), "Command file should be created");
-
- // Check file content
- $content = file_get_contents($expectedFile);
- $this->assertStringContainsString('class TestCommand extends Command', $content);
- $this->assertStringContainsString("'test-command'", $content);
- }
-
- /**
- * Test command generation with namespace.
- *
- * @test
- */
- public function testCommandGenerationWithNamespace() {
- $command = new MakeCommand();
-
- $output = $this->executeSingleCommand($command, [
- '--name' => 'user:create',
- '--namespace' => 'App\\Commands',
- '--path' => $this->testOutputDir
- ]);
-
- $this->assertEquals(0, $this->getExitCode());
-
- $expectedFile = $this->testOutputDir . '/UserCreateCommand.php';
- $this->assertTrue(file_exists($expectedFile));
-
- $content = file_get_contents($expectedFile);
- $this->assertStringContainsString('namespace App\\Commands;', $content);
- $this->assertStringContainsString('class UserCreateCommand extends Command', $content);
- }
-
- /**
- * Test interactive template generation.
- *
- * @test
- */
- public function testInteractiveTemplate() {
- $command = new MakeCommand();
-
- $output = $this->executeSingleCommand($command, [
- '--name' => 'setup-wizard',
- '--template' => 'interactive',
- '--path' => $this->testOutputDir
- ], ['']); // Empty namespace input
-
- $this->assertEquals(0, $this->getExitCode());
-
- $expectedFile = $this->testOutputDir . '/SetupWizardCommand.php';
- $content = file_get_contents($expectedFile);
-
- $this->assertStringContainsString('InputValidator', $content);
- $this->assertStringContainsString('getInput(', $content);
- $this->assertStringContainsString('confirm(', $content);
- }
-
- /**
- * Test CRUD template generation.
- *
- * @test
- */
- public function testCrudTemplate() {
- $command = new MakeCommand();
-
- $output = $this->executeSingleCommand($command, [
- '--name' => 'user-manager',
- '--template' => 'crud',
- '--path' => $this->testOutputDir
- ], ['']); // Empty namespace input
-
- $this->assertEquals(0, $this->getExitCode());
-
- $expectedFile = $this->testOutputDir . '/UserManagerCommand.php';
- $content = file_get_contents($expectedFile);
-
- $this->assertStringContainsString('createRecord()', $content);
- $this->assertStringContainsString('updateRecord()', $content);
- $this->assertStringContainsString('deleteRecord()', $content);
- $this->assertStringContainsString('listRecords()', $content);
- }
-
- /**
- * Test command generation with arguments.
- *
- * @test
- */
- public function testCommandWithArguments() {
- $command = new MakeCommand();
-
- $output = $this->executeSingleCommand($command, [
- '--name' => 'process-data',
- '--args' => 'input file,output format,verbose mode',
- '--path' => $this->testOutputDir
- ], ['']); // Empty namespace input
-
- $this->assertEquals(0, $this->getExitCode());
-
- $expectedFile = $this->testOutputDir . '/ProcessDataCommand.php';
- $content = file_get_contents($expectedFile);
-
- $this->assertStringContainsString('--input-file', $content);
- $this->assertStringContainsString('--output-format', $content);
- $this->assertStringContainsString('--verbose-mode', $content);
- }
-
- /**
- * Test invalid command name validation.
- *
- * @test
- */
- public function testInvalidCommandName() {
- $command = new MakeCommand();
-
- $output = $this->executeSingleCommand($command, [
- '--name' => 'Invalid Command Name!',
- '--path' => $this->testOutputDir
- ], ['']); // Empty namespace input
-
- $this->assertEquals(1, $this->getExitCode());
- // Check for validation error message (flexible matching)
- $found = false;
- foreach ($output as $line) {
- if (strpos($line, 'Command name must start with a letter') !== false) {
- $found = true;
- break;
- }
- }
- $this->assertTrue($found, 'Validation error message not found in output');
- }
-
- /**
- * Test file overwrite confirmation.
- *
- * @test
- */
- public function testFileOverwriteConfirmation() {
- $command = new MakeCommand();
-
- // Create file first
- $this->executeSingleCommand($command, [
- '--name' => 'existing-command',
- '--path' => $this->testOutputDir
- ], ['']); // Empty namespace input
-
- // Try to create again with 'no' confirmation
- $output = $this->executeSingleCommand($command, [
- '--name' => 'existing-command',
- '--path' => $this->testOutputDir
- ], ['', 'n']); // Empty namespace, then 'no' to overwrite
-
- $this->assertEquals(1, $this->getExitCode());
- // Check for overwrite declined message (flexible matching)
- $found = false;
- foreach ($output as $line) {
- if (strpos($line, 'File already exists and overwrite was declined') !== false) {
- $found = true;
- break;
- }
- }
- $this->assertTrue($found, 'Overwrite declined message not found in output');
- }
-
- /**
- * Helper method to remove directory recursively.
- */
- private function removeDirectory(string $dir): void {
- if (!is_dir($dir)) {
- return;
- }
-
- $files = array_diff(scandir($dir), ['.', '..']);
- foreach ($files as $file) {
- $path = $dir . '/' . $file;
- is_dir($path) ? $this->removeDirectory($path) : unlink($path);
- }
- rmdir($dir);
- }
-}
+testOutputDir)) {
+ $this->removeDirectory($this->testOutputDir);
+ }
+ }
+
+ protected function tearDown(): void {
+ parent::tearDown();
+ // Clean up test directory
+ if (is_dir($this->testOutputDir)) {
+ $this->removeDirectory($this->testOutputDir);
+ }
+ }
+
+ /**
+ * Test basic command generation.
+ *
+ * @test
+ */
+ public function testBasicCommandGeneration() {
+ $command = new MakeCommand();
+
+ $output = $this->executeSingleCommand($command, [
+ '--name' => 'test-command',
+ '--class' => 'TestCommand',
+ '--path' => $this->testOutputDir
+ ], ['', 'y']); // Empty namespace, then confirm overwrite if needed
+
+ // Check for success message (flexible matching)
+ $found = false;
+ foreach ($output as $line) {
+ if (strpos($line, 'Command generated successfully!') !== false) {
+ $found = true;
+ break;
+ }
+ }
+ $this->assertTrue($found, 'Success message not found in output');
+ $this->assertEquals(0, $this->getExitCode());
+
+ // Check if file was created
+ $expectedFile = $this->testOutputDir . '/TestCommand.php';
+ $this->assertTrue(file_exists($expectedFile), "Command file should be created");
+
+ // Check file content
+ $content = file_get_contents($expectedFile);
+ $this->assertStringContainsString('class TestCommand extends Command', $content);
+ $this->assertStringContainsString("'test-command'", $content);
+ }
+
+ /**
+ * Test command generation with namespace.
+ *
+ * @test
+ */
+ public function testCommandGenerationWithNamespace() {
+ $command = new MakeCommand();
+
+ $output = $this->executeSingleCommand($command, [
+ '--name' => 'user:create',
+ '--namespace' => 'App\\Commands',
+ '--path' => $this->testOutputDir
+ ]);
+
+ $this->assertEquals(0, $this->getExitCode());
+
+ $expectedFile = $this->testOutputDir . '/UserCreateCommand.php';
+ $this->assertTrue(file_exists($expectedFile));
+
+ $content = file_get_contents($expectedFile);
+ $this->assertStringContainsString('namespace App\\Commands;', $content);
+ $this->assertStringContainsString('class UserCreateCommand extends Command', $content);
+ }
+
+ /**
+ * Test interactive template generation.
+ *
+ * @test
+ */
+ public function testInteractiveTemplate() {
+ $command = new MakeCommand();
+
+ $output = $this->executeSingleCommand($command, [
+ '--name' => 'setup-wizard',
+ '--template' => 'interactive',
+ '--path' => $this->testOutputDir
+ ], ['']); // Empty namespace input
+
+ $this->assertEquals(0, $this->getExitCode());
+
+ $expectedFile = $this->testOutputDir . '/SetupWizardCommand.php';
+ $content = file_get_contents($expectedFile);
+
+ $this->assertStringContainsString('InputValidator', $content);
+ $this->assertStringContainsString('getInput(', $content);
+ $this->assertStringContainsString('confirm(', $content);
+ }
+
+ /**
+ * Test CRUD template generation.
+ *
+ * @test
+ */
+ public function testCrudTemplate() {
+ $command = new MakeCommand();
+
+ $output = $this->executeSingleCommand($command, [
+ '--name' => 'user-manager',
+ '--template' => 'crud',
+ '--path' => $this->testOutputDir
+ ], ['']); // Empty namespace input
+
+ $this->assertEquals(0, $this->getExitCode());
+
+ $expectedFile = $this->testOutputDir . '/UserManagerCommand.php';
+ $content = file_get_contents($expectedFile);
+
+ $this->assertStringContainsString('createRecord()', $content);
+ $this->assertStringContainsString('updateRecord()', $content);
+ $this->assertStringContainsString('deleteRecord()', $content);
+ $this->assertStringContainsString('listRecords()', $content);
+ }
+
+ /**
+ * Test command generation with arguments.
+ *
+ * @test
+ */
+ public function testCommandWithArguments() {
+ $command = new MakeCommand();
+
+ $output = $this->executeSingleCommand($command, [
+ '--name' => 'process-data',
+ '--args' => 'input file,output format,verbose mode',
+ '--path' => $this->testOutputDir
+ ], ['']); // Empty namespace input
+
+ $this->assertEquals(0, $this->getExitCode());
+
+ $expectedFile = $this->testOutputDir . '/ProcessDataCommand.php';
+ $content = file_get_contents($expectedFile);
+
+ $this->assertStringContainsString('--input-file', $content);
+ $this->assertStringContainsString('--output-format', $content);
+ $this->assertStringContainsString('--verbose-mode', $content);
+ }
+
+ /**
+ * Test invalid command name validation.
+ *
+ * @test
+ */
+ public function testInvalidCommandName() {
+ $command = new MakeCommand();
+
+ $output = $this->executeSingleCommand($command, [
+ '--name' => 'Invalid Command Name!',
+ '--path' => $this->testOutputDir
+ ], ['']); // Empty namespace input
+
+ $this->assertEquals(1, $this->getExitCode());
+ // Check for validation error message (flexible matching)
+ $found = false;
+ foreach ($output as $line) {
+ if (strpos($line, 'Command name must start with a letter') !== false) {
+ $found = true;
+ break;
+ }
+ }
+ $this->assertTrue($found, 'Validation error message not found in output');
+ }
+
+ /**
+ * Test file overwrite confirmation.
+ *
+ * @test
+ */
+ public function testFileOverwriteConfirmation() {
+ $command = new MakeCommand();
+
+ // Create file first
+ $this->executeSingleCommand($command, [
+ '--name' => 'existing-command',
+ '--path' => $this->testOutputDir
+ ], ['']); // Empty namespace input
+
+ // Try to create again with 'no' confirmation
+ $output = $this->executeSingleCommand($command, [
+ '--name' => 'existing-command',
+ '--path' => $this->testOutputDir
+ ], ['', 'n']); // Empty namespace, then 'no' to overwrite
+
+ $this->assertEquals(1, $this->getExitCode());
+ // Check for overwrite declined message (flexible matching)
+ $found = false;
+ foreach ($output as $line) {
+ if (strpos($line, 'File already exists and overwrite was declined') !== false) {
+ $found = true;
+ break;
+ }
+ }
+ $this->assertTrue($found, 'Overwrite declined message not found in output');
+ }
+
+ /**
+ * Helper method to remove directory recursively.
+ */
+ private function removeDirectory(string $dir): void {
+ if (!is_dir($dir)) {
+ return;
+ }
+
+ $files = array_diff(scandir($dir), ['.', '..']);
+ foreach ($files as $file) {
+ $path = $dir . '/' . $file;
+ is_dir($path) ? $this->removeDirectory($path) : unlink($path);
+ }
+ rmdir($dir);
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/MaskedInputTest.php b/tests/WebFiori/Tests/Cli/MaskedInputTest.php
index 6061bf4..29a123b 100644
--- a/tests/WebFiori/Tests/Cli/MaskedInputTest.php
+++ b/tests/WebFiori/Tests/Cli/MaskedInputTest.php
@@ -1,190 +1,190 @@
-getMaskedInput('Enter password: ');
- $this->println("Password received: $input");
- return 0;
- }
- };
-
- $output = $this->executeSingleCommand($command, [], ['secret123']);
-
- $this->assertContains("Enter password:\n", $output);
- $this->assertContains("Password received: secret123\n", $output);
- $this->assertEquals(0, $this->getExitCode());
- }
-
- /**
- * Test masked input with default value.
- *
- * @test
- */
- public function testMaskedInputWithDefault() {
- $command = new class extends \WebFiori\Cli\Command {
- public function __construct() {
- parent::__construct('test-masked-default');
- }
-
- public function exec(): int {
- $input = $this->getMaskedInput('Enter token: ', '*', 'default-token');
- $this->println("Token: $input");
- return 0;
- }
- };
-
- // Test with empty input (should use default)
- $output = $this->executeSingleCommand($command, [], ['']);
-
- $this->assertContains("Enter token: Enter = 'default-token'\n", $output);
- $this->assertContains("Token: default-token\n", $output);
- }
-
- /**
- * Test masked input with custom mask character.
- *
- * @test
- */
- public function testMaskedInputWithCustomMask() {
- $command = new class extends \WebFiori\Cli\Command {
- public function __construct() {
- parent::__construct('test-custom-mask');
- }
-
- public function exec(): int {
- $input = $this->getMaskedInput('Enter PIN: ', '#');
- $this->println("PIN: $input");
- return 0;
- }
- };
-
- $output = $this->executeSingleCommand($command, [], ['1234']);
-
- $this->assertContains("Enter PIN:\n", $output);
- $this->assertContains("PIN: 1234\n", $output);
- }
-
- /**
- * Test masked input with validation.
- *
- * @test
- */
- public function testMaskedInputWithValidation() {
- $command = new class extends \WebFiori\Cli\Command {
- public function __construct() {
- parent::__construct('test-masked-validation');
- }
-
- public function exec(): int {
- $validator = new InputValidator(function($input) {
- return strlen($input) >= 8;
- }, 'Password must be at least 8 characters long!');
-
- $input = $this->getMaskedInput('Enter password: ', '*', null, $validator);
- $this->println("Valid password received");
- return 0;
- }
- };
-
- // Test with invalid input first, then valid
- $output = $this->executeSingleCommand($command, [], ['short', 'validpassword']);
-
- $this->assertContains("Error: Password must be at least 8 characters long!\n", $output);
- $this->assertContains("Valid password received\n", $output);
- }
-
- /**
- * Test masked input with empty prompt.
- *
- * @test
- */
- public function testMaskedInputWithEmptyPrompt() {
- $command = new class extends \WebFiori\Cli\Command {
- public function __construct() {
- parent::__construct('test-empty-prompt');
- }
-
- public function exec(): int {
- $input = $this->getMaskedInput('');
- $result = $input === null ? 'null' : $input;
- $this->println("Result: $result");
- return 0;
- }
- };
-
- $output = $this->executeSingleCommand($command);
-
- $this->assertContains("Result: null\n", $output);
- }
-
- /**
- * Test masked input with whitespace handling.
- *
- * @test
- */
- public function testMaskedInputWhitespaceHandling() {
- $command = new class extends \WebFiori\Cli\Command {
- public function __construct() {
- parent::__construct('test-whitespace');
- }
-
- public function exec(): int {
- $input = $this->getMaskedInput('Enter value: ');
- $this->println("Value: '$input'");
- return 0;
- }
- };
-
- // Test with leading/trailing spaces
- $output = $this->executeSingleCommand($command, [], [' spaced ']);
-
- $this->assertContains("Value: 'spaced'\n", $output); // Should be trimmed
- }
-
- /**
- * Test masked input with special characters.
- *
- * @test
- */
- public function testMaskedInputWithSpecialCharacters() {
- $command = new class extends \WebFiori\Cli\Command {
- public function __construct() {
- parent::__construct('test-special-chars');
- }
-
- public function exec(): int {
- $input = $this->getMaskedInput('Enter complex password: ');
- $this->println("Password length: " . strlen($input));
- return 0;
- }
- };
-
- $complexPassword = 'P@ssw0rd!#$%';
- $output = $this->executeSingleCommand($command, [], [$complexPassword]);
-
- $this->assertContains("Password length: " . strlen($complexPassword) . "\n", $output);
- }
-}
+getMaskedInput('Enter password: ');
+ $this->println("Password received: $input");
+ return 0;
+ }
+ };
+
+ $output = $this->executeSingleCommand($command, [], ['secret123']);
+
+ $this->assertContains("Enter password:\n", $output);
+ $this->assertContains("Password received: secret123\n", $output);
+ $this->assertEquals(0, $this->getExitCode());
+ }
+
+ /**
+ * Test masked input with default value.
+ *
+ * @test
+ */
+ public function testMaskedInputWithDefault() {
+ $command = new class extends \WebFiori\Cli\Command {
+ public function __construct() {
+ parent::__construct('test-masked-default');
+ }
+
+ public function exec(): int {
+ $input = $this->getMaskedInput('Enter token: ', '*', 'default-token');
+ $this->println("Token: $input");
+ return 0;
+ }
+ };
+
+ // Test with empty input (should use default)
+ $output = $this->executeSingleCommand($command, [], ['']);
+
+ $this->assertContains("Enter token: Enter = 'default-token'\n", $output);
+ $this->assertContains("Token: default-token\n", $output);
+ }
+
+ /**
+ * Test masked input with custom mask character.
+ *
+ * @test
+ */
+ public function testMaskedInputWithCustomMask() {
+ $command = new class extends \WebFiori\Cli\Command {
+ public function __construct() {
+ parent::__construct('test-custom-mask');
+ }
+
+ public function exec(): int {
+ $input = $this->getMaskedInput('Enter PIN: ', '#');
+ $this->println("PIN: $input");
+ return 0;
+ }
+ };
+
+ $output = $this->executeSingleCommand($command, [], ['1234']);
+
+ $this->assertContains("Enter PIN:\n", $output);
+ $this->assertContains("PIN: 1234\n", $output);
+ }
+
+ /**
+ * Test masked input with validation.
+ *
+ * @test
+ */
+ public function testMaskedInputWithValidation() {
+ $command = new class extends \WebFiori\Cli\Command {
+ public function __construct() {
+ parent::__construct('test-masked-validation');
+ }
+
+ public function exec(): int {
+ $validator = new InputValidator(function($input) {
+ return strlen($input) >= 8;
+ }, 'Password must be at least 8 characters long!');
+
+ $input = $this->getMaskedInput('Enter password: ', '*', null, $validator);
+ $this->println("Valid password received");
+ return 0;
+ }
+ };
+
+ // Test with invalid input first, then valid
+ $output = $this->executeSingleCommand($command, [], ['short', 'validpassword']);
+
+ $this->assertContains("Error: Password must be at least 8 characters long!\n", $output);
+ $this->assertContains("Valid password received\n", $output);
+ }
+
+ /**
+ * Test masked input with empty prompt.
+ *
+ * @test
+ */
+ public function testMaskedInputWithEmptyPrompt() {
+ $command = new class extends \WebFiori\Cli\Command {
+ public function __construct() {
+ parent::__construct('test-empty-prompt');
+ }
+
+ public function exec(): int {
+ $input = $this->getMaskedInput('');
+ $result = $input === null ? 'null' : $input;
+ $this->println("Result: $result");
+ return 0;
+ }
+ };
+
+ $output = $this->executeSingleCommand($command);
+
+ $this->assertContains("Result: null\n", $output);
+ }
+
+ /**
+ * Test masked input with whitespace handling.
+ *
+ * @test
+ */
+ public function testMaskedInputWhitespaceHandling() {
+ $command = new class extends \WebFiori\Cli\Command {
+ public function __construct() {
+ parent::__construct('test-whitespace');
+ }
+
+ public function exec(): int {
+ $input = $this->getMaskedInput('Enter value: ');
+ $this->println("Value: '$input'");
+ return 0;
+ }
+ };
+
+ // Test with leading/trailing spaces
+ $output = $this->executeSingleCommand($command, [], [' spaced ']);
+
+ $this->assertContains("Value: 'spaced'\n", $output); // Should be trimmed
+ }
+
+ /**
+ * Test masked input with special characters.
+ *
+ * @test
+ */
+ public function testMaskedInputWithSpecialCharacters() {
+ $command = new class extends \WebFiori\Cli\Command {
+ public function __construct() {
+ parent::__construct('test-special-chars');
+ }
+
+ public function exec(): int {
+ $input = $this->getMaskedInput('Enter complex password: ');
+ $this->println("Password length: " . strlen($input));
+ return 0;
+ }
+ };
+
+ $complexPassword = 'P@ssw0rd!#$%';
+ $output = $this->executeSingleCommand($command, [], [$complexPassword]);
+
+ $this->assertContains("Password length: " . strlen($complexPassword) . "\n", $output);
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/Progress/CommandProgressTest.php b/tests/WebFiori/Tests/Cli/Progress/CommandProgressTest.php
index 9679fb2..4183a9d 100644
--- a/tests/WebFiori/Tests/Cli/Progress/CommandProgressTest.php
+++ b/tests/WebFiori/Tests/Cli/Progress/CommandProgressTest.php
@@ -1,167 +1,167 @@
-setOutputStream($output);
-
- $progressBar = $command->createProgressBar(50);
-
- $this->assertInstanceOf(ProgressBar::class, $progressBar);
- $this->assertEquals(0, $progressBar->getCurrent());
- $this->assertEquals(50, $progressBar->getTotal());
- }
-
- /**
- * @test
- */
- public function testCreateProgressBarDefault() {
- $command = new TestProgressCommand();
- $output = new ArrayOutputStream();
- $command->setOutputStream($output);
-
- $progressBar = $command->createProgressBar();
-
- $this->assertInstanceOf(ProgressBar::class, $progressBar);
- $this->assertEquals(100, $progressBar->getTotal());
- }
-
- /**
- * @test
- */
- public function testWithProgressBarArray() {
- $command = new TestProgressCommand();
- $output = new ArrayOutputStream();
- $command->setOutputStream($output);
-
- $items = [1, 2, 3, 4, 5];
- $processed = [];
-
- $command->withProgressBar($items, function($item, $key) use (&$processed) {
- $processed[] = $item;
- });
-
- $this->assertEquals($items, $processed);
-
- // Should have output from progress bar
- $outputArray = $output->getOutputArray();
- $this->assertNotEmpty($outputArray);
- }
-
- /**
- * @test
- */
- public function testWithProgressBarIterator() {
- $command = new TestProgressCommand();
- $output = new ArrayOutputStream();
- $command->setOutputStream($output);
-
- $items = new \ArrayIterator([10, 20, 30]);
- $processed = [];
-
- $command->withProgressBar($items, function($item, $key) use (&$processed) {
- $processed[] = $item;
- });
-
- $this->assertEquals([10, 20, 30], $processed);
-
- // Should have output from progress bar
- $outputArray = $output->getOutputArray();
- $this->assertNotEmpty($outputArray);
- }
-
- /**
- * @test
- */
- public function testWithProgressBarWithMessage() {
- $command = new TestProgressCommand();
- $output = new ArrayOutputStream();
- $command->setOutputStream($output);
-
- $items = ['a', 'b', 'c'];
- $processed = [];
-
- $command->withProgressBar($items, function($item, $key) use (&$processed) {
- $processed[] = $item;
- }, 'Processing items...');
-
- $this->assertEquals($items, $processed);
-
- // Should have output with message
- $outputArray = $output->getOutputArray();
- $this->assertNotEmpty($outputArray);
-
- $firstOutput = $outputArray[0];
- $this->assertStringContainsString('Processing items...', $firstOutput);
- }
-
- /**
- * @test
- */
- public function testWithProgressBarEmptyArray() {
- $command = new TestProgressCommand();
- $output = new ArrayOutputStream();
- $command->setOutputStream($output);
-
- $items = [];
- $processed = [];
-
- $command->withProgressBar($items, function($item, $key) use (&$processed) {
- $processed[] = $item;
- });
-
- $this->assertEquals([], $processed);
-
- // Should still have some output (start and finish)
- $outputArray = $output->getOutputArray();
- $this->assertNotEmpty($outputArray);
- }
-
- /**
- * @test
- */
- public function testWithProgressBarCallbackReceivesKeyAndValue() {
- $command = new TestProgressCommand();
- $output = new ArrayOutputStream();
- $command->setOutputStream($output);
-
- $items = ['first' => 'a', 'second' => 'b', 'third' => 'c'];
- $processedKeys = [];
- $processedValues = [];
-
- $command->withProgressBar($items, function($item, $key) use (&$processedKeys, &$processedValues) {
- $processedKeys[] = $key;
- $processedValues[] = $item;
- });
-
- $this->assertEquals(['first', 'second', 'third'], $processedKeys);
- $this->assertEquals(['a', 'b', 'c'], $processedValues);
- }
-}
-
-/**
- * Test command for progress bar testing.
- */
-class TestProgressCommand extends Command {
- public function __construct() {
- parent::__construct('test-progress');
- }
-
- public function exec(): int {
- return 0;
- }
-}
+setOutputStream($output);
+
+ $progressBar = $command->createProgressBar(50);
+
+ $this->assertInstanceOf(ProgressBar::class, $progressBar);
+ $this->assertEquals(0, $progressBar->getCurrent());
+ $this->assertEquals(50, $progressBar->getTotal());
+ }
+
+ /**
+ * @test
+ */
+ public function testCreateProgressBarDefault() {
+ $command = new TestProgressCommand();
+ $output = new ArrayOutputStream();
+ $command->setOutputStream($output);
+
+ $progressBar = $command->createProgressBar();
+
+ $this->assertInstanceOf(ProgressBar::class, $progressBar);
+ $this->assertEquals(100, $progressBar->getTotal());
+ }
+
+ /**
+ * @test
+ */
+ public function testWithProgressBarArray() {
+ $command = new TestProgressCommand();
+ $output = new ArrayOutputStream();
+ $command->setOutputStream($output);
+
+ $items = [1, 2, 3, 4, 5];
+ $processed = [];
+
+ $command->withProgressBar($items, function($item, $key) use (&$processed) {
+ $processed[] = $item;
+ });
+
+ $this->assertEquals($items, $processed);
+
+ // Should have output from progress bar
+ $outputArray = $output->getOutputArray();
+ $this->assertNotEmpty($outputArray);
+ }
+
+ /**
+ * @test
+ */
+ public function testWithProgressBarIterator() {
+ $command = new TestProgressCommand();
+ $output = new ArrayOutputStream();
+ $command->setOutputStream($output);
+
+ $items = new \ArrayIterator([10, 20, 30]);
+ $processed = [];
+
+ $command->withProgressBar($items, function($item, $key) use (&$processed) {
+ $processed[] = $item;
+ });
+
+ $this->assertEquals([10, 20, 30], $processed);
+
+ // Should have output from progress bar
+ $outputArray = $output->getOutputArray();
+ $this->assertNotEmpty($outputArray);
+ }
+
+ /**
+ * @test
+ */
+ public function testWithProgressBarWithMessage() {
+ $command = new TestProgressCommand();
+ $output = new ArrayOutputStream();
+ $command->setOutputStream($output);
+
+ $items = ['a', 'b', 'c'];
+ $processed = [];
+
+ $command->withProgressBar($items, function($item, $key) use (&$processed) {
+ $processed[] = $item;
+ }, 'Processing items...');
+
+ $this->assertEquals($items, $processed);
+
+ // Should have output with message
+ $outputArray = $output->getOutputArray();
+ $this->assertNotEmpty($outputArray);
+
+ $firstOutput = $outputArray[0];
+ $this->assertStringContainsString('Processing items...', $firstOutput);
+ }
+
+ /**
+ * @test
+ */
+ public function testWithProgressBarEmptyArray() {
+ $command = new TestProgressCommand();
+ $output = new ArrayOutputStream();
+ $command->setOutputStream($output);
+
+ $items = [];
+ $processed = [];
+
+ $command->withProgressBar($items, function($item, $key) use (&$processed) {
+ $processed[] = $item;
+ });
+
+ $this->assertEquals([], $processed);
+
+ // Should still have some output (start and finish)
+ $outputArray = $output->getOutputArray();
+ $this->assertNotEmpty($outputArray);
+ }
+
+ /**
+ * @test
+ */
+ public function testWithProgressBarCallbackReceivesKeyAndValue() {
+ $command = new TestProgressCommand();
+ $output = new ArrayOutputStream();
+ $command->setOutputStream($output);
+
+ $items = ['first' => 'a', 'second' => 'b', 'third' => 'c'];
+ $processedKeys = [];
+ $processedValues = [];
+
+ $command->withProgressBar($items, function($item, $key) use (&$processedKeys, &$processedValues) {
+ $processedKeys[] = $key;
+ $processedValues[] = $item;
+ });
+
+ $this->assertEquals(['first', 'second', 'third'], $processedKeys);
+ $this->assertEquals(['a', 'b', 'c'], $processedValues);
+ }
+}
+
+/**
+ * Test command for progress bar testing.
+ */
+class TestProgressCommand extends Command {
+ public function __construct() {
+ parent::__construct('test-progress');
+ }
+
+ public function exec(): int {
+ return 0;
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/Progress/ProgressBarFormatTest.php b/tests/WebFiori/Tests/Cli/Progress/ProgressBarFormatTest.php
index 8dde139..a83f325 100644
--- a/tests/WebFiori/Tests/Cli/Progress/ProgressBarFormatTest.php
+++ b/tests/WebFiori/Tests/Cli/Progress/ProgressBarFormatTest.php
@@ -1,196 +1,196 @@
-assertEquals(ProgressBarFormat::DEFAULT_FORMAT, $format->getFormat());
- }
-
- /**
- * @test
- */
- public function testCustomConstructor() {
- $customFormat = '[{bar}] {percent}%';
- $format = new ProgressBarFormat($customFormat);
-
- $this->assertEquals($customFormat, $format->getFormat());
- }
-
- /**
- * @test
- */
- public function testSetFormat() {
- $format = new ProgressBarFormat();
- $newFormat = '{current}/{total} [{bar}]';
- $result = $format->setFormat($newFormat);
-
- $this->assertSame($format, $result); // Test fluent interface
- $this->assertEquals($newFormat, $format->getFormat());
- }
-
- /**
- * @test
- */
- public function testRenderBasic() {
- $format = new ProgressBarFormat('[{bar}] {percent}%');
- $values = [
- 'bar' => 'โโโโโโโโโโ',
- 'percent' => '40.0'
- ];
-
- $result = $format->render($values);
- $this->assertEquals('[โโโโโโโโโโ] 40.0%', $result);
- }
-
- /**
- * @test
- */
- public function testRenderWithMissingValues() {
- $format = new ProgressBarFormat('[{bar}] {percent}% {missing}');
- $values = [
- 'bar' => 'โโโโโโโโโโ',
- 'percent' => '40.0'
- ];
-
- $result = $format->render($values);
- $this->assertEquals('[โโโโโโโโโโ] 40.0% {missing}', $result);
- }
-
- /**
- * @test
- */
- public function testGetPlaceholders() {
- $format = new ProgressBarFormat('[{bar}] {percent}% ({current}/{total}) ETA: {eta}');
- $placeholders = $format->getPlaceholders();
-
- $expected = ['bar', 'percent', 'current', 'total', 'eta'];
- $this->assertEquals($expected, $placeholders);
- }
-
- /**
- * @test
- */
- public function testGetPlaceholdersEmpty() {
- $format = new ProgressBarFormat('No placeholders here');
- $placeholders = $format->getPlaceholders();
-
- $this->assertEquals([], $placeholders);
- }
-
- /**
- * @test
- */
- public function testHasPlaceholder() {
- $format = new ProgressBarFormat('[{bar}] {percent}%');
-
- $this->assertTrue($format->hasPlaceholder('bar'));
- $this->assertTrue($format->hasPlaceholder('percent'));
- $this->assertFalse($format->hasPlaceholder('eta'));
- $this->assertFalse($format->hasPlaceholder('missing'));
- }
-
- /**
- * @test
- */
- public function testFormatDurationSeconds() {
- $this->assertEquals('00:05', ProgressBarFormat::formatDuration(5));
- $this->assertEquals('00:30', ProgressBarFormat::formatDuration(30));
- $this->assertEquals('01:00', ProgressBarFormat::formatDuration(60));
- }
-
- /**
- * @test
- */
- public function testFormatDurationMinutes() {
- $this->assertEquals('02:30', ProgressBarFormat::formatDuration(150));
- $this->assertEquals('10:00', ProgressBarFormat::formatDuration(600));
- $this->assertEquals('59:59', ProgressBarFormat::formatDuration(3599));
- }
-
- /**
- * @test
- */
- public function testFormatDurationHours() {
- $this->assertEquals('01:00:00', ProgressBarFormat::formatDuration(3600));
- $this->assertEquals('02:30:45', ProgressBarFormat::formatDuration(9045));
- $this->assertEquals('24:00:00', ProgressBarFormat::formatDuration(86400));
- }
-
- /**
- * @test
- */
- public function testFormatDurationNegative() {
- $this->assertEquals('--:--', ProgressBarFormat::formatDuration(-1));
- $this->assertEquals('--:--', ProgressBarFormat::formatDuration(-100));
- }
-
- /**
- * @test
- */
- public function testFormatMemoryBytes() {
- $this->assertEquals('512.0B', ProgressBarFormat::formatMemory(512));
- $this->assertEquals('1023.0B', ProgressBarFormat::formatMemory(1023));
- }
-
- /**
- * @test
- */
- public function testFormatMemoryKilobytes() {
- $this->assertEquals('1.0KB', ProgressBarFormat::formatMemory(1024));
- $this->assertEquals('2.5KB', ProgressBarFormat::formatMemory(2560));
- $this->assertEquals('1023.0KB', ProgressBarFormat::formatMemory(1047552));
- }
-
- /**
- * @test
- */
- public function testFormatMemoryMegabytes() {
- $this->assertEquals('1.0MB', ProgressBarFormat::formatMemory(1048576));
- $this->assertEquals('2.5MB', ProgressBarFormat::formatMemory(2621440));
- }
-
- /**
- * @test
- */
- public function testFormatMemoryGigabytes() {
- $this->assertEquals('1.0GB', ProgressBarFormat::formatMemory(1073741824));
- $this->assertEquals('2.5GB', ProgressBarFormat::formatMemory(2684354560));
- }
-
- /**
- * @test
- */
- public function testFormatRateSmall() {
- $this->assertEquals('0.50', ProgressBarFormat::formatRate(0.5));
- $this->assertEquals('0.75', ProgressBarFormat::formatRate(0.75));
- }
-
- /**
- * @test
- */
- public function testFormatRateMedium() {
- $this->assertEquals('5.5', ProgressBarFormat::formatRate(5.5));
- $this->assertEquals('9.9', ProgressBarFormat::formatRate(9.9));
- }
-
- /**
- * @test
- */
- public function testFormatRateLarge() {
- $this->assertEquals('10', ProgressBarFormat::formatRate(10));
- $this->assertEquals('100', ProgressBarFormat::formatRate(100));
- $this->assertEquals('1000', ProgressBarFormat::formatRate(1000));
- }
-}
+assertEquals(ProgressBarFormat::DEFAULT_FORMAT, $format->getFormat());
+ }
+
+ /**
+ * @test
+ */
+ public function testCustomConstructor() {
+ $customFormat = '[{bar}] {percent}%';
+ $format = new ProgressBarFormat($customFormat);
+
+ $this->assertEquals($customFormat, $format->getFormat());
+ }
+
+ /**
+ * @test
+ */
+ public function testSetFormat() {
+ $format = new ProgressBarFormat();
+ $newFormat = '{current}/{total} [{bar}]';
+ $result = $format->setFormat($newFormat);
+
+ $this->assertSame($format, $result); // Test fluent interface
+ $this->assertEquals($newFormat, $format->getFormat());
+ }
+
+ /**
+ * @test
+ */
+ public function testRenderBasic() {
+ $format = new ProgressBarFormat('[{bar}] {percent}%');
+ $values = [
+ 'bar' => 'โโโโโโโโโโ',
+ 'percent' => '40.0'
+ ];
+
+ $result = $format->render($values);
+ $this->assertEquals('[โโโโโโโโโโ] 40.0%', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testRenderWithMissingValues() {
+ $format = new ProgressBarFormat('[{bar}] {percent}% {missing}');
+ $values = [
+ 'bar' => 'โโโโโโโโโโ',
+ 'percent' => '40.0'
+ ];
+
+ $result = $format->render($values);
+ $this->assertEquals('[โโโโโโโโโโ] 40.0% {missing}', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testGetPlaceholders() {
+ $format = new ProgressBarFormat('[{bar}] {percent}% ({current}/{total}) ETA: {eta}');
+ $placeholders = $format->getPlaceholders();
+
+ $expected = ['bar', 'percent', 'current', 'total', 'eta'];
+ $this->assertEquals($expected, $placeholders);
+ }
+
+ /**
+ * @test
+ */
+ public function testGetPlaceholdersEmpty() {
+ $format = new ProgressBarFormat('No placeholders here');
+ $placeholders = $format->getPlaceholders();
+
+ $this->assertEquals([], $placeholders);
+ }
+
+ /**
+ * @test
+ */
+ public function testHasPlaceholder() {
+ $format = new ProgressBarFormat('[{bar}] {percent}%');
+
+ $this->assertTrue($format->hasPlaceholder('bar'));
+ $this->assertTrue($format->hasPlaceholder('percent'));
+ $this->assertFalse($format->hasPlaceholder('eta'));
+ $this->assertFalse($format->hasPlaceholder('missing'));
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatDurationSeconds() {
+ $this->assertEquals('00:05', ProgressBarFormat::formatDuration(5));
+ $this->assertEquals('00:30', ProgressBarFormat::formatDuration(30));
+ $this->assertEquals('01:00', ProgressBarFormat::formatDuration(60));
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatDurationMinutes() {
+ $this->assertEquals('02:30', ProgressBarFormat::formatDuration(150));
+ $this->assertEquals('10:00', ProgressBarFormat::formatDuration(600));
+ $this->assertEquals('59:59', ProgressBarFormat::formatDuration(3599));
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatDurationHours() {
+ $this->assertEquals('01:00:00', ProgressBarFormat::formatDuration(3600));
+ $this->assertEquals('02:30:45', ProgressBarFormat::formatDuration(9045));
+ $this->assertEquals('24:00:00', ProgressBarFormat::formatDuration(86400));
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatDurationNegative() {
+ $this->assertEquals('--:--', ProgressBarFormat::formatDuration(-1));
+ $this->assertEquals('--:--', ProgressBarFormat::formatDuration(-100));
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatMemoryBytes() {
+ $this->assertEquals('512.0B', ProgressBarFormat::formatMemory(512));
+ $this->assertEquals('1023.0B', ProgressBarFormat::formatMemory(1023));
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatMemoryKilobytes() {
+ $this->assertEquals('1.0KB', ProgressBarFormat::formatMemory(1024));
+ $this->assertEquals('2.5KB', ProgressBarFormat::formatMemory(2560));
+ $this->assertEquals('1023.0KB', ProgressBarFormat::formatMemory(1047552));
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatMemoryMegabytes() {
+ $this->assertEquals('1.0MB', ProgressBarFormat::formatMemory(1048576));
+ $this->assertEquals('2.5MB', ProgressBarFormat::formatMemory(2621440));
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatMemoryGigabytes() {
+ $this->assertEquals('1.0GB', ProgressBarFormat::formatMemory(1073741824));
+ $this->assertEquals('2.5GB', ProgressBarFormat::formatMemory(2684354560));
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatRateSmall() {
+ $this->assertEquals('0.50', ProgressBarFormat::formatRate(0.5));
+ $this->assertEquals('0.75', ProgressBarFormat::formatRate(0.75));
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatRateMedium() {
+ $this->assertEquals('5.5', ProgressBarFormat::formatRate(5.5));
+ $this->assertEquals('9.9', ProgressBarFormat::formatRate(9.9));
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatRateLarge() {
+ $this->assertEquals('10', ProgressBarFormat::formatRate(10));
+ $this->assertEquals('100', ProgressBarFormat::formatRate(100));
+ $this->assertEquals('1000', ProgressBarFormat::formatRate(1000));
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/Progress/ProgressBarStyleTest.php b/tests/WebFiori/Tests/Cli/Progress/ProgressBarStyleTest.php
index de4799a..d505518 100644
--- a/tests/WebFiori/Tests/Cli/Progress/ProgressBarStyleTest.php
+++ b/tests/WebFiori/Tests/Cli/Progress/ProgressBarStyleTest.php
@@ -1,137 +1,137 @@
-assertEquals('โ', $style->getBarChar());
- $this->assertEquals('โ', $style->getEmptyChar());
- $this->assertEquals('โ', $style->getProgressChar());
- }
-
- /**
- * @test
- */
- public function testCustomConstructor() {
- $style = new ProgressBarStyle('=', '-', '>');
-
- $this->assertEquals('=', $style->getBarChar());
- $this->assertEquals('-', $style->getEmptyChar());
- $this->assertEquals('>', $style->getProgressChar());
- }
-
- /**
- * @test
- */
- public function testFromNameDefault() {
- $style = ProgressBarStyle::fromName(ProgressBarStyle::DEFAULT);
-
- $this->assertEquals('โ', $style->getBarChar());
- $this->assertEquals('โ', $style->getEmptyChar());
- $this->assertEquals('โ', $style->getProgressChar());
- }
-
- /**
- * @test
- */
- public function testFromNameAscii() {
- $style = ProgressBarStyle::fromName(ProgressBarStyle::ASCII);
-
- $this->assertEquals('=', $style->getBarChar());
- $this->assertEquals('-', $style->getEmptyChar());
- $this->assertEquals('>', $style->getProgressChar());
- }
-
- /**
- * @test
- */
- public function testFromNameDots() {
- $style = ProgressBarStyle::fromName(ProgressBarStyle::DOTS);
-
- $this->assertEquals('โ', $style->getBarChar());
- $this->assertEquals('โ', $style->getEmptyChar());
- $this->assertEquals('โ', $style->getProgressChar());
- }
-
- /**
- * @test
- */
- public function testFromNameArrow() {
- $style = ProgressBarStyle::fromName(ProgressBarStyle::ARROW);
-
- $this->assertEquals('โถ', $style->getBarChar());
- $this->assertEquals('โท', $style->getEmptyChar());
- $this->assertEquals('โถ', $style->getProgressChar());
- }
-
- /**
- * @test
- */
- public function testFromNameInvalid() {
- $style = ProgressBarStyle::fromName('invalid-style');
-
- // Should fallback to default
- $this->assertEquals('โ', $style->getBarChar());
- $this->assertEquals('โ', $style->getEmptyChar());
- $this->assertEquals('โ', $style->getProgressChar());
- }
-
- /**
- * @test
- */
- public function testSetBarChar() {
- $style = new ProgressBarStyle();
- $result = $style->setBarChar('#');
-
- $this->assertSame($style, $result); // Test fluent interface
- $this->assertEquals('#', $style->getBarChar());
- }
-
- /**
- * @test
- */
- public function testSetEmptyChar() {
- $style = new ProgressBarStyle();
- $result = $style->setEmptyChar('.');
-
- $this->assertSame($style, $result); // Test fluent interface
- $this->assertEquals('.', $style->getEmptyChar());
- }
-
- /**
- * @test
- */
- public function testSetProgressChar() {
- $style = new ProgressBarStyle();
- $result = $style->setProgressChar('*');
-
- $this->assertSame($style, $result); // Test fluent interface
- $this->assertEquals('*', $style->getProgressChar());
- }
-
- /**
- * @test
- */
- public function testFluentInterface() {
- $style = new ProgressBarStyle();
- $result = $style->setBarChar('#')
- ->setEmptyChar('.')
- ->setProgressChar('*');
-
- $this->assertSame($style, $result);
- $this->assertEquals('#', $style->getBarChar());
- $this->assertEquals('.', $style->getEmptyChar());
- $this->assertEquals('*', $style->getProgressChar());
- }
-}
+assertEquals('โ', $style->getBarChar());
+ $this->assertEquals('โ', $style->getEmptyChar());
+ $this->assertEquals('โ', $style->getProgressChar());
+ }
+
+ /**
+ * @test
+ */
+ public function testCustomConstructor() {
+ $style = new ProgressBarStyle('=', '-', '>');
+
+ $this->assertEquals('=', $style->getBarChar());
+ $this->assertEquals('-', $style->getEmptyChar());
+ $this->assertEquals('>', $style->getProgressChar());
+ }
+
+ /**
+ * @test
+ */
+ public function testFromNameDefault() {
+ $style = ProgressBarStyle::fromName(ProgressBarStyle::DEFAULT);
+
+ $this->assertEquals('โ', $style->getBarChar());
+ $this->assertEquals('โ', $style->getEmptyChar());
+ $this->assertEquals('โ', $style->getProgressChar());
+ }
+
+ /**
+ * @test
+ */
+ public function testFromNameAscii() {
+ $style = ProgressBarStyle::fromName(ProgressBarStyle::ASCII);
+
+ $this->assertEquals('=', $style->getBarChar());
+ $this->assertEquals('-', $style->getEmptyChar());
+ $this->assertEquals('>', $style->getProgressChar());
+ }
+
+ /**
+ * @test
+ */
+ public function testFromNameDots() {
+ $style = ProgressBarStyle::fromName(ProgressBarStyle::DOTS);
+
+ $this->assertEquals('โ', $style->getBarChar());
+ $this->assertEquals('โ', $style->getEmptyChar());
+ $this->assertEquals('โ', $style->getProgressChar());
+ }
+
+ /**
+ * @test
+ */
+ public function testFromNameArrow() {
+ $style = ProgressBarStyle::fromName(ProgressBarStyle::ARROW);
+
+ $this->assertEquals('โถ', $style->getBarChar());
+ $this->assertEquals('โท', $style->getEmptyChar());
+ $this->assertEquals('โถ', $style->getProgressChar());
+ }
+
+ /**
+ * @test
+ */
+ public function testFromNameInvalid() {
+ $style = ProgressBarStyle::fromName('invalid-style');
+
+ // Should fallback to default
+ $this->assertEquals('โ', $style->getBarChar());
+ $this->assertEquals('โ', $style->getEmptyChar());
+ $this->assertEquals('โ', $style->getProgressChar());
+ }
+
+ /**
+ * @test
+ */
+ public function testSetBarChar() {
+ $style = new ProgressBarStyle();
+ $result = $style->setBarChar('#');
+
+ $this->assertSame($style, $result); // Test fluent interface
+ $this->assertEquals('#', $style->getBarChar());
+ }
+
+ /**
+ * @test
+ */
+ public function testSetEmptyChar() {
+ $style = new ProgressBarStyle();
+ $result = $style->setEmptyChar('.');
+
+ $this->assertSame($style, $result); // Test fluent interface
+ $this->assertEquals('.', $style->getEmptyChar());
+ }
+
+ /**
+ * @test
+ */
+ public function testSetProgressChar() {
+ $style = new ProgressBarStyle();
+ $result = $style->setProgressChar('*');
+
+ $this->assertSame($style, $result); // Test fluent interface
+ $this->assertEquals('*', $style->getProgressChar());
+ }
+
+ /**
+ * @test
+ */
+ public function testFluentInterface() {
+ $style = new ProgressBarStyle();
+ $result = $style->setBarChar('#')
+ ->setEmptyChar('.')
+ ->setProgressChar('*');
+
+ $this->assertSame($style, $result);
+ $this->assertEquals('#', $style->getBarChar());
+ $this->assertEquals('.', $style->getEmptyChar());
+ $this->assertEquals('*', $style->getProgressChar());
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/Progress/ProgressBarTest.php b/tests/WebFiori/Tests/Cli/Progress/ProgressBarTest.php
index 018015c..7057947 100644
--- a/tests/WebFiori/Tests/Cli/Progress/ProgressBarTest.php
+++ b/tests/WebFiori/Tests/Cli/Progress/ProgressBarTest.php
@@ -1,717 +1,717 @@
-output = new ArrayOutputStream();
- }
-
- /**
- * @test
- */
- public function testConstructorDefaults() {
- $progressBar = new ProgressBar($this->output);
-
- $this->assertEquals(0, $progressBar->getCurrent());
- $this->assertEquals(100, $progressBar->getTotal());
- $this->assertEquals(0.0, $progressBar->getPercent());
- $this->assertFalse($progressBar->isFinished());
- }
-
- /**
- * @test
- */
- public function testConstructorWithTotal() {
- $progressBar = new ProgressBar($this->output, 50);
-
- $this->assertEquals(0, $progressBar->getCurrent());
- $this->assertEquals(50, $progressBar->getTotal());
- $this->assertEquals(0.0, $progressBar->getPercent());
- }
-
- /**
- * @test
- */
- public function testConstructorWithZeroTotal() {
- $progressBar = new ProgressBar($this->output, 0);
-
- // Should default to 1 to avoid division by zero
- $this->assertEquals(1, $progressBar->getTotal());
- }
-
- /**
- * @test
- */
- public function testSetCurrent() {
- $progressBar = new ProgressBar($this->output, 100);
- $result = $progressBar->setCurrent(25);
-
- $this->assertSame($progressBar, $result); // Test fluent interface
- $this->assertEquals(25, $progressBar->getCurrent());
- $this->assertEquals(25.0, $progressBar->getPercent());
- }
-
- /**
- * @test
- */
- public function testSetCurrentBeyondTotal() {
- $progressBar = new ProgressBar($this->output, 100);
- $progressBar->setCurrent(150);
-
- // Should be clamped to total
- $this->assertEquals(100, $progressBar->getCurrent());
- $this->assertEquals(100.0, $progressBar->getPercent());
- }
-
- /**
- * @test
- */
- public function testSetCurrentNegative() {
- $progressBar = new ProgressBar($this->output, 100);
- $progressBar->setCurrent(-10);
-
- // Should be clamped to 0
- $this->assertEquals(0, $progressBar->getCurrent());
- $this->assertEquals(0.0, $progressBar->getPercent());
- }
-
- /**
- * @test
- */
- public function testAdvance() {
- $progressBar = new ProgressBar($this->output, 100);
- $progressBar->setCurrent(10);
-
- $result = $progressBar->advance();
- $this->assertSame($progressBar, $result); // Test fluent interface
- $this->assertEquals(11, $progressBar->getCurrent());
-
- $progressBar->advance(5);
- $this->assertEquals(16, $progressBar->getCurrent());
- }
-
- /**
- * @test
- */
- public function testStart() {
- $progressBar = new ProgressBar($this->output, 100);
- $result = $progressBar->start('Processing...');
-
- $this->assertSame($progressBar, $result); // Test fluent interface
- $this->assertEquals(0, $progressBar->getCurrent());
- $this->assertFalse($progressBar->isFinished());
-
- // Should have output
- $this->assertNotEmpty($this->output->getOutputArray());
- }
-
- /**
- * @test
- */
- public function testFinish() {
- $progressBar = new ProgressBar($this->output, 100);
- $progressBar->start();
- $progressBar->setCurrent(50);
-
- $result = $progressBar->finish('Complete!');
-
- $this->assertSame($progressBar, $result); // Test fluent interface
- $this->assertEquals(100, $progressBar->getCurrent());
- $this->assertEquals(100.0, $progressBar->getPercent());
- $this->assertTrue($progressBar->isFinished());
- }
-
- /**
- * @test
- */
- public function testFinishMultipleTimes() {
- $progressBar = new ProgressBar($this->output, 100);
- $progressBar->start();
-
- $progressBar->finish();
- $this->assertTrue($progressBar->isFinished());
-
- // Should not change state on second finish
- $progressBar->finish();
- $this->assertTrue($progressBar->isFinished());
- $this->assertEquals(100, $progressBar->getCurrent());
- }
-
- /**
- * @test
- */
- public function testSetTotal() {
- $progressBar = new ProgressBar($this->output, 100);
- $progressBar->setCurrent(50);
-
- $result = $progressBar->setTotal(200);
-
- $this->assertSame($progressBar, $result); // Test fluent interface
- $this->assertEquals(200, $progressBar->getTotal());
- $this->assertEquals(50, $progressBar->getCurrent());
- $this->assertEquals(25.0, $progressBar->getPercent());
- }
-
- /**
- * @test
- */
- public function testSetTotalSmallerThanCurrent() {
- $progressBar = new ProgressBar($this->output, 100);
- $progressBar->setCurrent(50);
- $progressBar->setTotal(25);
-
- // Current should be clamped to new total
- $this->assertEquals(25, $progressBar->getTotal());
- $this->assertEquals(25, $progressBar->getCurrent());
- $this->assertEquals(100.0, $progressBar->getPercent());
- }
-
- /**
- * @test
- */
- public function testSetTotalZero() {
- $progressBar = new ProgressBar($this->output, 100);
- $progressBar->setTotal(0);
-
- // Should default to 1
- $this->assertEquals(1, $progressBar->getTotal());
- }
-
- /**
- * @test
- */
- public function testSetWidth() {
- $progressBar = new ProgressBar($this->output, 100);
- $result = $progressBar->setWidth(30);
-
- $this->assertSame($progressBar, $result); // Test fluent interface
- }
-
- /**
- * @test
- */
- public function testSetWidthZero() {
- $progressBar = new ProgressBar($this->output, 100);
- $progressBar->setWidth(0);
-
- // Should default to 1
- // We can't directly test width, but we can test that it doesn't crash
- $progressBar->start();
- $this->assertNotEmpty($this->output->getOutputArray());
- }
-
- /**
- * @test
- */
- public function testSetStyle() {
- $progressBar = new ProgressBar($this->output, 100);
- $style = new ProgressBarStyle('=', '-', '>');
-
- $result = $progressBar->setStyle($style);
- $this->assertSame($progressBar, $result); // Test fluent interface
- }
-
- /**
- * @test
- */
- public function testSetStyleByName() {
- $progressBar = new ProgressBar($this->output, 100);
- $result = $progressBar->setStyle(ProgressBarStyle::ASCII);
-
- $this->assertSame($progressBar, $result); // Test fluent interface
- }
-
- /**
- * @test
- */
- public function testSetFormat() {
- $progressBar = new ProgressBar($this->output, 100);
- $result = $progressBar->setFormat('[{bar}] {percent}%');
-
- $this->assertSame($progressBar, $result); // Test fluent interface
- }
-
- /**
- * @test
- */
- public function testSetUpdateThrottle() {
- $progressBar = new ProgressBar($this->output, 100);
- $result = $progressBar->setUpdateThrottle(0.5);
-
- $this->assertSame($progressBar, $result); // Test fluent interface
- }
-
- /**
- * @test
- */
- public function testSetUpdateThrottleNegative() {
- $progressBar = new ProgressBar($this->output, 100);
- $progressBar->setUpdateThrottle(-1);
-
- // Should not crash - negative values should be handled
- $progressBar->start();
- $this->assertNotEmpty($this->output->getOutputArray());
- }
-
- /**
- * @test
- */
- public function testSetOverwrite() {
- $progressBar = new ProgressBar($this->output, 100);
- $result = $progressBar->setOverwrite(false);
-
- $this->assertSame($progressBar, $result); // Test fluent interface
- }
-
- /**
- * @test
- */
- public function testProgressBarOutput() {
- $progressBar = new ProgressBar($this->output, 10);
- $progressBar->setWidth(10);
- $progressBar->setFormat('[{bar}] {percent}%');
- $progressBar->setStyle(ProgressBarStyle::ASCII);
- $progressBar->setUpdateThrottle(0); // No throttling for tests
-
- $progressBar->start();
- $progressBar->setCurrent(5);
- $progressBar->finish();
-
- $output = $this->output->getOutputArray();
- $this->assertNotEmpty($output);
-
- // Should contain progress bar elements
- $lastOutput = end($output);
- $this->assertStringContainsString('[', $lastOutput);
- $this->assertStringContainsString(']', $lastOutput);
- $this->assertStringContainsString('%', $lastOutput);
- }
-
- /**
- * @test
- */
- public function testProgressBarWithMessage() {
- $progressBar = new ProgressBar($this->output, 10);
- $progressBar->setUpdateThrottle(0); // No throttling for tests
-
- $progressBar->start('Loading...');
-
- $output = $this->output->getOutputArray();
- $this->assertNotEmpty($output);
-
- $firstOutput = $output[0];
- $this->assertStringContainsString('Loading...', $firstOutput);
- }
- /**
- * Test ProgressBar initialization with different parameters
- * @test
- */
- public function testProgressBarInitializationEnhanced() {
- $output = new ArrayOutputStream();
-
- // Test with default parameters
- $bar1 = new ProgressBar($output);
- $this->assertEquals(100, $bar1->getTotal());
- $this->assertEquals(0, $bar1->getCurrent());
- $this->assertFalse($bar1->isFinished());
-
- // Test with custom total
- $bar2 = new ProgressBar($output, 50);
- $this->assertEquals(50, $bar2->getTotal());
- $this->assertEquals(0, $bar2->getCurrent());
- }
-
- /**
- * Test ProgressBar current value management
- * @test
- */
- public function testCurrentValueManagementEnhanced() {
- $output = new ArrayOutputStream();
- $bar = new ProgressBar($output, 100);
-
- // Test setting current value
- $result = $bar->setCurrent(25);
- $this->assertSame($bar, $result); // Should return self
- $this->assertEquals(25, $bar->getCurrent());
- $this->assertEquals(25.0, $bar->getPercent());
-
- // Test setting current beyond total
- $bar->setCurrent(150);
- $this->assertEquals(100, $bar->getCurrent()); // Should be capped at total
- $this->assertEquals(100.0, $bar->getPercent());
- $this->assertEquals(100, $bar->getCurrent());
-
- // Test setting negative current
- $bar->setCurrent(-10);
- $this->assertEquals(0, $bar->getCurrent()); // Should be capped at 0
- $this->assertEquals(0.0, $bar->getPercent());
- $this->assertFalse($bar->isFinished());
- }
-
- /**
- * Test ProgressBar total value management
- * @test
- */
- public function testTotalValueManagementEnhanced() {
- $output = new ArrayOutputStream();
- $bar = new ProgressBar($output, 100);
- $bar->setCurrent(50);
-
- // Test setting new total
- $result = $bar->setTotal(200);
- $this->assertSame($bar, $result); // Should return self
- $this->assertEquals(200, $bar->getTotal());
- $this->assertEquals(50, $bar->getCurrent()); // Current should remain
- $this->assertEquals(25.0, $bar->getPercent()); // Percent should recalculate
-
- // Test setting total smaller than current
- $bar->setTotal(25);
- $this->assertEquals(25, $bar->getTotal());
- $this->assertEquals(25, $bar->getCurrent()); // Current should be adjusted
- $this->assertEquals(100.0, $bar->getPercent());
- $this->assertEquals(100.0, $bar->getPercent());
-
- // Test setting zero total
- $bar->setTotal(0);
- $this->assertEquals(1, $bar->getTotal()); // Should be minimum 1
- }
-
- /**
- * Test ProgressBar advance functionality
- * @test
- */
- public function testAdvanceFunctionalityEnhanced() {
- $output = new ArrayOutputStream();
- $bar = new ProgressBar($output, 10);
-
- // Test advance with default step
- $result = $bar->advance();
- $this->assertSame($bar, $result); // Should return self
- $this->assertEquals(1, $bar->getCurrent());
-
- // Test advance with custom step
- $bar->advance(3);
- $this->assertEquals(4, $bar->getCurrent());
-
- // Test advance beyond total
- $bar->advance(10);
- $this->assertEquals(10, $bar->getCurrent()); // Should be capped
- $this->assertEquals(10, $bar->getCurrent());
-
- // Test advance when already finished
- $bar->advance();
- $this->assertEquals(10, $bar->getCurrent()); // Should remain at total
- }
-
- /**
- * Test ProgressBar start and finish
- * @test
- */
- public function testStartAndFinishEnhanced() {
- $output = new ArrayOutputStream();
- $bar = new ProgressBar($output, 100);
-
- // Test start
- $result = $bar->start('Starting process...');
- $this->assertSame($bar, $result); // Should return self
-
- $outputArray = $output->getOutputArray();
- $this->assertNotEmpty($outputArray);
-
- // Test finish
- $bar->setCurrent(50); // Set to middle
- $this->assertFalse($bar->isFinished());
-
- $result2 = $bar->finish('Process completed!');
- $this->assertSame($bar, $result2); // Should return self
- $this->assertEquals(100, $bar->getCurrent()); // Should be set to total
- $this->assertTrue($bar->isFinished());
-
- // Test multiple finish calls
- $bar->finish('Already finished');
- $this->assertEquals(100, $bar->getCurrent()); // Should remain at total
- }
-
- /**
- * Test ProgressBar message handling
- * @test
- */
- public function testMessageHandlingEnhanced() {
- $output = new ArrayOutputStream();
- $bar = new ProgressBar($output, 100);
-
- // Test starting with message (since setMessage doesn't exist)
- $result = $bar->start('Processing items...');
- $this->assertSame($bar, $result); // Should return self
-
- $outputArray = $output->getOutputArray();
- $this->assertNotEmpty($outputArray);
-
- // Test finishing with message
- $bar->finish('Process completed!');
- $finalOutput = $output->getOutputArray();
- $this->assertNotEmpty($finalOutput);
- }
-
- /**
- * Test ProgressBar format handling
- * @test
- */
- public function testFormatHandlingEnhanced() {
- $output = new ArrayOutputStream();
- $bar = new ProgressBar($output, 100);
-
- // Test setting custom format
- $customFormat = '{message} [{bar}] {percent}% ({current}/{total})';
- $result = $bar->setFormat($customFormat);
- $this->assertSame($bar, $result); // Should return self
-
- // Test that format was set by checking output contains expected elements
- $bar->start('Test');
- $outputArray = $output->getOutputArray();
- $this->assertNotEmpty($outputArray);
- }
-
- /**
- * Test ProgressBar width handling
- * @test
- */
- public function testWidthHandlingEnhanced() {
- $output = new ArrayOutputStream();
- $bar = new ProgressBar($output, 100);
-
- // Test setting width
- $result = $bar->setWidth(50);
- $this->assertSame($bar, $result); // Should return self
-
- // Test setting zero width (should use minimum)
- $bar->setWidth(0);
-
- // Test setting negative width (should use minimum)
- $bar->setWidth(-5);
-
- // Verify width setting by checking output
- $bar->start();
- $outputArray = $output->getOutputArray();
- $this->assertNotEmpty($outputArray);
- }
-
- /**
- * Test ProgressBar style handling
- * @test
- */
- public function testStyleHandlingEnhanced() {
- $output = new ArrayOutputStream();
- $bar = new ProgressBar($output, 100);
-
- // Test setting custom style
- $customStyle = new ProgressBarStyle('โ', 'โ', 'โ');
- $result = $bar->setStyle($customStyle);
- $this->assertSame($bar, $result); // Should return self
-
- // Test that style was set by checking output
- $bar->start();
- $outputArray = $output->getOutputArray();
- $this->assertNotEmpty($outputArray);
-
- // Test getting default style on new instance
- $bar2 = new ProgressBar($output, 100);
- $bar2->start();
- $this->assertNotEmpty($output->getOutputArray());
- }
-
- /**
- * Test ProgressBar update throttling
- * @test
- */
- public function testUpdateThrottlingEnhanced() {
- $output = new ArrayOutputStream();
- $bar = new ProgressBar($output, 100);
-
- // Test setting update throttle
- $result = $bar->setUpdateThrottle(0.1); // 100ms
- $this->assertSame($bar, $result); // Should return self
-
- // Test setting negative throttle (should be handled gracefully)
- $bar->setUpdateThrottle(-0.05);
-
- // Test throttling behavior by checking output
- $bar->start();
- $initialOutputCount = count($output->getOutputArray());
-
- // Multiple rapid updates
- $bar->advance();
- $bar->advance();
- $bar->advance();
-
- // Should have some output
- $this->assertGreaterThanOrEqual($initialOutputCount, count($output->getOutputArray()));
- }
-
- /**
- * Test ProgressBar timing functionality
- * @test
- */
- public function testTimingFunctionalityEnhanced() {
- $output = new ArrayOutputStream();
- $bar = new ProgressBar($output, 100);
-
- $bar->start();
-
- // Test that progress bar handles timing internally
- usleep(10000); // 10ms
- $bar->setCurrent(10);
-
- // Test that timing is working by checking output
- $outputArray = $output->getOutputArray();
- $this->assertNotEmpty($outputArray);
-
- // When finished, should complete properly
- $bar->finish();
- $finalOutput = $output->getOutputArray();
- $this->assertNotEmpty($finalOutput);
- }
-
- /**
- * Test ProgressBar performance tracking
- * @test
- */
- public function testPerformanceTrackingEnhanced() {
- $output = new ArrayOutputStream();
- $bar = new ProgressBar($output, 100);
-
- $bar->start();
- usleep(10000); // 10ms
-
- // Test that progress bar tracks performance internally
- $bar->setCurrent(10);
-
- // Verify output contains progress information
- $outputArray = $output->getOutputArray();
- $this->assertNotEmpty($outputArray);
-
- // Continue progress
- usleep(10000); // Another 10ms
- $bar->setCurrent(50);
-
- // Should have more output
- $newOutputArray = $output->getOutputArray();
- $this->assertGreaterThanOrEqual(count($outputArray), count($newOutputArray));
- }
-
- /**
- * Test ProgressBar rate monitoring
- * @test
- */
- public function testRateMonitoringEnhanced() {
- $output = new ArrayOutputStream();
- $bar = new ProgressBar($output, 100);
-
- $bar->start();
-
- // Test that progress bar monitors rate internally
- usleep(10000); // 10ms
- $bar->setCurrent(10);
-
- // Verify progress bar is working
- $outputArray = $output->getOutputArray();
- $this->assertNotEmpty($outputArray);
-
- // Continue with more progress
- usleep(10000); // Another 10ms
- $bar->setCurrent(25);
-
- // Should continue to work
- $newOutputArray = $output->getOutputArray();
- $this->assertGreaterThanOrEqual(count($outputArray), count($newOutputArray));
- }
-
- /**
- * Test ProgressBar with zero total edge case
- * @test
- */
- public function testProgressBarZeroTotalEnhanced() {
- $output = new ArrayOutputStream();
- $bar = new ProgressBar($output, 0);
-
- // Should handle zero total gracefully
- $this->assertEquals(1, $bar->getTotal()); // Should be adjusted to minimum
- $this->assertEquals(0, $bar->getCurrent());
- $this->assertEquals(0.0, $bar->getPercent());
-
- $bar->advance();
- $this->assertEquals(1, $bar->getCurrent());
- $this->assertEquals(100.0, $bar->getPercent());
- $this->assertEquals(100.0, $bar->getPercent());
- }
-
- /**
- * Test ProgressBar output rendering
- * @test
- */
- public function testProgressBarOutputRenderingEnhanced() {
- $output = new ArrayOutputStream();
- $bar = new ProgressBar($output, 10);
- $bar->setWidth(20);
- $bar->setUpdateThrottle(0); // Disable throttling for testing
-
- // Test rendering at different progress levels
- $bar->start('Starting...');
- $this->assertNotEmpty($output->getOutputArray());
-
- $output->reset(); // Clear previous output
-
- $bar->setCurrent(5); // 50% progress
- $outputArray = $output->getOutputArray();
- $this->assertNotEmpty($outputArray);
-
- // The output should contain progress bar elements
- $outputString = implode('', $outputArray);
- $this->assertNotEmpty($outputString);
-
- $output->reset();
-
- $bar->finish('Completed!');
- $finalOutput = $output->getOutputArray();
- $this->assertNotEmpty($finalOutput);
- }
-
- /**
- * Test ProgressBar format placeholders
- * @test
- */
- public function testFormatPlaceholdersEnhanced() {
- $output = new ArrayOutputStream();
- $bar = new ProgressBar($output, 100);
- $bar->setUpdateThrottle(0); // Disable throttling for testing
-
- // Test format with placeholders
- $format = 'Progress: [{bar}] {percent}% ({current}/{total})';
- $bar->setFormat($format);
-
- $bar->start('Processing');
- $bar->setCurrent(25);
-
- // The output should contain progress information
- $outputArray = $output->getOutputArray();
- $this->assertNotEmpty($outputArray);
-
- $outputString = implode('', $outputArray);
- $this->assertNotEmpty($outputString);
-
- // Should contain some progress indicators
- $this->assertStringContainsString('25', $outputString);
- $this->assertStringContainsString('100', $outputString);
- }
+output = new ArrayOutputStream();
+ }
+
+ /**
+ * @test
+ */
+ public function testConstructorDefaults() {
+ $progressBar = new ProgressBar($this->output);
+
+ $this->assertEquals(0, $progressBar->getCurrent());
+ $this->assertEquals(100, $progressBar->getTotal());
+ $this->assertEquals(0.0, $progressBar->getPercent());
+ $this->assertFalse($progressBar->isFinished());
+ }
+
+ /**
+ * @test
+ */
+ public function testConstructorWithTotal() {
+ $progressBar = new ProgressBar($this->output, 50);
+
+ $this->assertEquals(0, $progressBar->getCurrent());
+ $this->assertEquals(50, $progressBar->getTotal());
+ $this->assertEquals(0.0, $progressBar->getPercent());
+ }
+
+ /**
+ * @test
+ */
+ public function testConstructorWithZeroTotal() {
+ $progressBar = new ProgressBar($this->output, 0);
+
+ // Should default to 1 to avoid division by zero
+ $this->assertEquals(1, $progressBar->getTotal());
+ }
+
+ /**
+ * @test
+ */
+ public function testSetCurrent() {
+ $progressBar = new ProgressBar($this->output, 100);
+ $result = $progressBar->setCurrent(25);
+
+ $this->assertSame($progressBar, $result); // Test fluent interface
+ $this->assertEquals(25, $progressBar->getCurrent());
+ $this->assertEquals(25.0, $progressBar->getPercent());
+ }
+
+ /**
+ * @test
+ */
+ public function testSetCurrentBeyondTotal() {
+ $progressBar = new ProgressBar($this->output, 100);
+ $progressBar->setCurrent(150);
+
+ // Should be clamped to total
+ $this->assertEquals(100, $progressBar->getCurrent());
+ $this->assertEquals(100.0, $progressBar->getPercent());
+ }
+
+ /**
+ * @test
+ */
+ public function testSetCurrentNegative() {
+ $progressBar = new ProgressBar($this->output, 100);
+ $progressBar->setCurrent(-10);
+
+ // Should be clamped to 0
+ $this->assertEquals(0, $progressBar->getCurrent());
+ $this->assertEquals(0.0, $progressBar->getPercent());
+ }
+
+ /**
+ * @test
+ */
+ public function testAdvance() {
+ $progressBar = new ProgressBar($this->output, 100);
+ $progressBar->setCurrent(10);
+
+ $result = $progressBar->advance();
+ $this->assertSame($progressBar, $result); // Test fluent interface
+ $this->assertEquals(11, $progressBar->getCurrent());
+
+ $progressBar->advance(5);
+ $this->assertEquals(16, $progressBar->getCurrent());
+ }
+
+ /**
+ * @test
+ */
+ public function testStart() {
+ $progressBar = new ProgressBar($this->output, 100);
+ $result = $progressBar->start('Processing...');
+
+ $this->assertSame($progressBar, $result); // Test fluent interface
+ $this->assertEquals(0, $progressBar->getCurrent());
+ $this->assertFalse($progressBar->isFinished());
+
+ // Should have output
+ $this->assertNotEmpty($this->output->getOutputArray());
+ }
+
+ /**
+ * @test
+ */
+ public function testFinish() {
+ $progressBar = new ProgressBar($this->output, 100);
+ $progressBar->start();
+ $progressBar->setCurrent(50);
+
+ $result = $progressBar->finish('Complete!');
+
+ $this->assertSame($progressBar, $result); // Test fluent interface
+ $this->assertEquals(100, $progressBar->getCurrent());
+ $this->assertEquals(100.0, $progressBar->getPercent());
+ $this->assertTrue($progressBar->isFinished());
+ }
+
+ /**
+ * @test
+ */
+ public function testFinishMultipleTimes() {
+ $progressBar = new ProgressBar($this->output, 100);
+ $progressBar->start();
+
+ $progressBar->finish();
+ $this->assertTrue($progressBar->isFinished());
+
+ // Should not change state on second finish
+ $progressBar->finish();
+ $this->assertTrue($progressBar->isFinished());
+ $this->assertEquals(100, $progressBar->getCurrent());
+ }
+
+ /**
+ * @test
+ */
+ public function testSetTotal() {
+ $progressBar = new ProgressBar($this->output, 100);
+ $progressBar->setCurrent(50);
+
+ $result = $progressBar->setTotal(200);
+
+ $this->assertSame($progressBar, $result); // Test fluent interface
+ $this->assertEquals(200, $progressBar->getTotal());
+ $this->assertEquals(50, $progressBar->getCurrent());
+ $this->assertEquals(25.0, $progressBar->getPercent());
+ }
+
+ /**
+ * @test
+ */
+ public function testSetTotalSmallerThanCurrent() {
+ $progressBar = new ProgressBar($this->output, 100);
+ $progressBar->setCurrent(50);
+ $progressBar->setTotal(25);
+
+ // Current should be clamped to new total
+ $this->assertEquals(25, $progressBar->getTotal());
+ $this->assertEquals(25, $progressBar->getCurrent());
+ $this->assertEquals(100.0, $progressBar->getPercent());
+ }
+
+ /**
+ * @test
+ */
+ public function testSetTotalZero() {
+ $progressBar = new ProgressBar($this->output, 100);
+ $progressBar->setTotal(0);
+
+ // Should default to 1
+ $this->assertEquals(1, $progressBar->getTotal());
+ }
+
+ /**
+ * @test
+ */
+ public function testSetWidth() {
+ $progressBar = new ProgressBar($this->output, 100);
+ $result = $progressBar->setWidth(30);
+
+ $this->assertSame($progressBar, $result); // Test fluent interface
+ }
+
+ /**
+ * @test
+ */
+ public function testSetWidthZero() {
+ $progressBar = new ProgressBar($this->output, 100);
+ $progressBar->setWidth(0);
+
+ // Should default to 1
+ // We can't directly test width, but we can test that it doesn't crash
+ $progressBar->start();
+ $this->assertNotEmpty($this->output->getOutputArray());
+ }
+
+ /**
+ * @test
+ */
+ public function testSetStyle() {
+ $progressBar = new ProgressBar($this->output, 100);
+ $style = new ProgressBarStyle('=', '-', '>');
+
+ $result = $progressBar->setStyle($style);
+ $this->assertSame($progressBar, $result); // Test fluent interface
+ }
+
+ /**
+ * @test
+ */
+ public function testSetStyleByName() {
+ $progressBar = new ProgressBar($this->output, 100);
+ $result = $progressBar->setStyle(ProgressBarStyle::ASCII);
+
+ $this->assertSame($progressBar, $result); // Test fluent interface
+ }
+
+ /**
+ * @test
+ */
+ public function testSetFormat() {
+ $progressBar = new ProgressBar($this->output, 100);
+ $result = $progressBar->setFormat('[{bar}] {percent}%');
+
+ $this->assertSame($progressBar, $result); // Test fluent interface
+ }
+
+ /**
+ * @test
+ */
+ public function testSetUpdateThrottle() {
+ $progressBar = new ProgressBar($this->output, 100);
+ $result = $progressBar->setUpdateThrottle(0.5);
+
+ $this->assertSame($progressBar, $result); // Test fluent interface
+ }
+
+ /**
+ * @test
+ */
+ public function testSetUpdateThrottleNegative() {
+ $progressBar = new ProgressBar($this->output, 100);
+ $progressBar->setUpdateThrottle(-1);
+
+ // Should not crash - negative values should be handled
+ $progressBar->start();
+ $this->assertNotEmpty($this->output->getOutputArray());
+ }
+
+ /**
+ * @test
+ */
+ public function testSetOverwrite() {
+ $progressBar = new ProgressBar($this->output, 100);
+ $result = $progressBar->setOverwrite(false);
+
+ $this->assertSame($progressBar, $result); // Test fluent interface
+ }
+
+ /**
+ * @test
+ */
+ public function testProgressBarOutput() {
+ $progressBar = new ProgressBar($this->output, 10);
+ $progressBar->setWidth(10);
+ $progressBar->setFormat('[{bar}] {percent}%');
+ $progressBar->setStyle(ProgressBarStyle::ASCII);
+ $progressBar->setUpdateThrottle(0); // No throttling for tests
+
+ $progressBar->start();
+ $progressBar->setCurrent(5);
+ $progressBar->finish();
+
+ $output = $this->output->getOutputArray();
+ $this->assertNotEmpty($output);
+
+ // Should contain progress bar elements
+ $lastOutput = end($output);
+ $this->assertStringContainsString('[', $lastOutput);
+ $this->assertStringContainsString(']', $lastOutput);
+ $this->assertStringContainsString('%', $lastOutput);
+ }
+
+ /**
+ * @test
+ */
+ public function testProgressBarWithMessage() {
+ $progressBar = new ProgressBar($this->output, 10);
+ $progressBar->setUpdateThrottle(0); // No throttling for tests
+
+ $progressBar->start('Loading...');
+
+ $output = $this->output->getOutputArray();
+ $this->assertNotEmpty($output);
+
+ $firstOutput = $output[0];
+ $this->assertStringContainsString('Loading...', $firstOutput);
+ }
+ /**
+ * Test ProgressBar initialization with different parameters
+ * @test
+ */
+ public function testProgressBarInitializationEnhanced() {
+ $output = new ArrayOutputStream();
+
+ // Test with default parameters
+ $bar1 = new ProgressBar($output);
+ $this->assertEquals(100, $bar1->getTotal());
+ $this->assertEquals(0, $bar1->getCurrent());
+ $this->assertFalse($bar1->isFinished());
+
+ // Test with custom total
+ $bar2 = new ProgressBar($output, 50);
+ $this->assertEquals(50, $bar2->getTotal());
+ $this->assertEquals(0, $bar2->getCurrent());
+ }
+
+ /**
+ * Test ProgressBar current value management
+ * @test
+ */
+ public function testCurrentValueManagementEnhanced() {
+ $output = new ArrayOutputStream();
+ $bar = new ProgressBar($output, 100);
+
+ // Test setting current value
+ $result = $bar->setCurrent(25);
+ $this->assertSame($bar, $result); // Should return self
+ $this->assertEquals(25, $bar->getCurrent());
+ $this->assertEquals(25.0, $bar->getPercent());
+
+ // Test setting current beyond total
+ $bar->setCurrent(150);
+ $this->assertEquals(100, $bar->getCurrent()); // Should be capped at total
+ $this->assertEquals(100.0, $bar->getPercent());
+ $this->assertEquals(100, $bar->getCurrent());
+
+ // Test setting negative current
+ $bar->setCurrent(-10);
+ $this->assertEquals(0, $bar->getCurrent()); // Should be capped at 0
+ $this->assertEquals(0.0, $bar->getPercent());
+ $this->assertFalse($bar->isFinished());
+ }
+
+ /**
+ * Test ProgressBar total value management
+ * @test
+ */
+ public function testTotalValueManagementEnhanced() {
+ $output = new ArrayOutputStream();
+ $bar = new ProgressBar($output, 100);
+ $bar->setCurrent(50);
+
+ // Test setting new total
+ $result = $bar->setTotal(200);
+ $this->assertSame($bar, $result); // Should return self
+ $this->assertEquals(200, $bar->getTotal());
+ $this->assertEquals(50, $bar->getCurrent()); // Current should remain
+ $this->assertEquals(25.0, $bar->getPercent()); // Percent should recalculate
+
+ // Test setting total smaller than current
+ $bar->setTotal(25);
+ $this->assertEquals(25, $bar->getTotal());
+ $this->assertEquals(25, $bar->getCurrent()); // Current should be adjusted
+ $this->assertEquals(100.0, $bar->getPercent());
+ $this->assertEquals(100.0, $bar->getPercent());
+
+ // Test setting zero total
+ $bar->setTotal(0);
+ $this->assertEquals(1, $bar->getTotal()); // Should be minimum 1
+ }
+
+ /**
+ * Test ProgressBar advance functionality
+ * @test
+ */
+ public function testAdvanceFunctionalityEnhanced() {
+ $output = new ArrayOutputStream();
+ $bar = new ProgressBar($output, 10);
+
+ // Test advance with default step
+ $result = $bar->advance();
+ $this->assertSame($bar, $result); // Should return self
+ $this->assertEquals(1, $bar->getCurrent());
+
+ // Test advance with custom step
+ $bar->advance(3);
+ $this->assertEquals(4, $bar->getCurrent());
+
+ // Test advance beyond total
+ $bar->advance(10);
+ $this->assertEquals(10, $bar->getCurrent()); // Should be capped
+ $this->assertEquals(10, $bar->getCurrent());
+
+ // Test advance when already finished
+ $bar->advance();
+ $this->assertEquals(10, $bar->getCurrent()); // Should remain at total
+ }
+
+ /**
+ * Test ProgressBar start and finish
+ * @test
+ */
+ public function testStartAndFinishEnhanced() {
+ $output = new ArrayOutputStream();
+ $bar = new ProgressBar($output, 100);
+
+ // Test start
+ $result = $bar->start('Starting process...');
+ $this->assertSame($bar, $result); // Should return self
+
+ $outputArray = $output->getOutputArray();
+ $this->assertNotEmpty($outputArray);
+
+ // Test finish
+ $bar->setCurrent(50); // Set to middle
+ $this->assertFalse($bar->isFinished());
+
+ $result2 = $bar->finish('Process completed!');
+ $this->assertSame($bar, $result2); // Should return self
+ $this->assertEquals(100, $bar->getCurrent()); // Should be set to total
+ $this->assertTrue($bar->isFinished());
+
+ // Test multiple finish calls
+ $bar->finish('Already finished');
+ $this->assertEquals(100, $bar->getCurrent()); // Should remain at total
+ }
+
+ /**
+ * Test ProgressBar message handling
+ * @test
+ */
+ public function testMessageHandlingEnhanced() {
+ $output = new ArrayOutputStream();
+ $bar = new ProgressBar($output, 100);
+
+ // Test starting with message (since setMessage doesn't exist)
+ $result = $bar->start('Processing items...');
+ $this->assertSame($bar, $result); // Should return self
+
+ $outputArray = $output->getOutputArray();
+ $this->assertNotEmpty($outputArray);
+
+ // Test finishing with message
+ $bar->finish('Process completed!');
+ $finalOutput = $output->getOutputArray();
+ $this->assertNotEmpty($finalOutput);
+ }
+
+ /**
+ * Test ProgressBar format handling
+ * @test
+ */
+ public function testFormatHandlingEnhanced() {
+ $output = new ArrayOutputStream();
+ $bar = new ProgressBar($output, 100);
+
+ // Test setting custom format
+ $customFormat = '{message} [{bar}] {percent}% ({current}/{total})';
+ $result = $bar->setFormat($customFormat);
+ $this->assertSame($bar, $result); // Should return self
+
+ // Test that format was set by checking output contains expected elements
+ $bar->start('Test');
+ $outputArray = $output->getOutputArray();
+ $this->assertNotEmpty($outputArray);
+ }
+
+ /**
+ * Test ProgressBar width handling
+ * @test
+ */
+ public function testWidthHandlingEnhanced() {
+ $output = new ArrayOutputStream();
+ $bar = new ProgressBar($output, 100);
+
+ // Test setting width
+ $result = $bar->setWidth(50);
+ $this->assertSame($bar, $result); // Should return self
+
+ // Test setting zero width (should use minimum)
+ $bar->setWidth(0);
+
+ // Test setting negative width (should use minimum)
+ $bar->setWidth(-5);
+
+ // Verify width setting by checking output
+ $bar->start();
+ $outputArray = $output->getOutputArray();
+ $this->assertNotEmpty($outputArray);
+ }
+
+ /**
+ * Test ProgressBar style handling
+ * @test
+ */
+ public function testStyleHandlingEnhanced() {
+ $output = new ArrayOutputStream();
+ $bar = new ProgressBar($output, 100);
+
+ // Test setting custom style
+ $customStyle = new ProgressBarStyle('โ', 'โ', 'โ');
+ $result = $bar->setStyle($customStyle);
+ $this->assertSame($bar, $result); // Should return self
+
+ // Test that style was set by checking output
+ $bar->start();
+ $outputArray = $output->getOutputArray();
+ $this->assertNotEmpty($outputArray);
+
+ // Test getting default style on new instance
+ $bar2 = new ProgressBar($output, 100);
+ $bar2->start();
+ $this->assertNotEmpty($output->getOutputArray());
+ }
+
+ /**
+ * Test ProgressBar update throttling
+ * @test
+ */
+ public function testUpdateThrottlingEnhanced() {
+ $output = new ArrayOutputStream();
+ $bar = new ProgressBar($output, 100);
+
+ // Test setting update throttle
+ $result = $bar->setUpdateThrottle(0.1); // 100ms
+ $this->assertSame($bar, $result); // Should return self
+
+ // Test setting negative throttle (should be handled gracefully)
+ $bar->setUpdateThrottle(-0.05);
+
+ // Test throttling behavior by checking output
+ $bar->start();
+ $initialOutputCount = count($output->getOutputArray());
+
+ // Multiple rapid updates
+ $bar->advance();
+ $bar->advance();
+ $bar->advance();
+
+ // Should have some output
+ $this->assertGreaterThanOrEqual($initialOutputCount, count($output->getOutputArray()));
+ }
+
+ /**
+ * Test ProgressBar timing functionality
+ * @test
+ */
+ public function testTimingFunctionalityEnhanced() {
+ $output = new ArrayOutputStream();
+ $bar = new ProgressBar($output, 100);
+
+ $bar->start();
+
+ // Test that progress bar handles timing internally
+ usleep(10000); // 10ms
+ $bar->setCurrent(10);
+
+ // Test that timing is working by checking output
+ $outputArray = $output->getOutputArray();
+ $this->assertNotEmpty($outputArray);
+
+ // When finished, should complete properly
+ $bar->finish();
+ $finalOutput = $output->getOutputArray();
+ $this->assertNotEmpty($finalOutput);
+ }
+
+ /**
+ * Test ProgressBar performance tracking
+ * @test
+ */
+ public function testPerformanceTrackingEnhanced() {
+ $output = new ArrayOutputStream();
+ $bar = new ProgressBar($output, 100);
+
+ $bar->start();
+ usleep(10000); // 10ms
+
+ // Test that progress bar tracks performance internally
+ $bar->setCurrent(10);
+
+ // Verify output contains progress information
+ $outputArray = $output->getOutputArray();
+ $this->assertNotEmpty($outputArray);
+
+ // Continue progress
+ usleep(10000); // Another 10ms
+ $bar->setCurrent(50);
+
+ // Should have more output
+ $newOutputArray = $output->getOutputArray();
+ $this->assertGreaterThanOrEqual(count($outputArray), count($newOutputArray));
+ }
+
+ /**
+ * Test ProgressBar rate monitoring
+ * @test
+ */
+ public function testRateMonitoringEnhanced() {
+ $output = new ArrayOutputStream();
+ $bar = new ProgressBar($output, 100);
+
+ $bar->start();
+
+ // Test that progress bar monitors rate internally
+ usleep(10000); // 10ms
+ $bar->setCurrent(10);
+
+ // Verify progress bar is working
+ $outputArray = $output->getOutputArray();
+ $this->assertNotEmpty($outputArray);
+
+ // Continue with more progress
+ usleep(10000); // Another 10ms
+ $bar->setCurrent(25);
+
+ // Should continue to work
+ $newOutputArray = $output->getOutputArray();
+ $this->assertGreaterThanOrEqual(count($outputArray), count($newOutputArray));
+ }
+
+ /**
+ * Test ProgressBar with zero total edge case
+ * @test
+ */
+ public function testProgressBarZeroTotalEnhanced() {
+ $output = new ArrayOutputStream();
+ $bar = new ProgressBar($output, 0);
+
+ // Should handle zero total gracefully
+ $this->assertEquals(1, $bar->getTotal()); // Should be adjusted to minimum
+ $this->assertEquals(0, $bar->getCurrent());
+ $this->assertEquals(0.0, $bar->getPercent());
+
+ $bar->advance();
+ $this->assertEquals(1, $bar->getCurrent());
+ $this->assertEquals(100.0, $bar->getPercent());
+ $this->assertEquals(100.0, $bar->getPercent());
+ }
+
+ /**
+ * Test ProgressBar output rendering
+ * @test
+ */
+ public function testProgressBarOutputRenderingEnhanced() {
+ $output = new ArrayOutputStream();
+ $bar = new ProgressBar($output, 10);
+ $bar->setWidth(20);
+ $bar->setUpdateThrottle(0); // Disable throttling for testing
+
+ // Test rendering at different progress levels
+ $bar->start('Starting...');
+ $this->assertNotEmpty($output->getOutputArray());
+
+ $output->reset(); // Clear previous output
+
+ $bar->setCurrent(5); // 50% progress
+ $outputArray = $output->getOutputArray();
+ $this->assertNotEmpty($outputArray);
+
+ // The output should contain progress bar elements
+ $outputString = implode('', $outputArray);
+ $this->assertNotEmpty($outputString);
+
+ $output->reset();
+
+ $bar->finish('Completed!');
+ $finalOutput = $output->getOutputArray();
+ $this->assertNotEmpty($finalOutput);
+ }
+
+ /**
+ * Test ProgressBar format placeholders
+ * @test
+ */
+ public function testFormatPlaceholdersEnhanced() {
+ $output = new ArrayOutputStream();
+ $bar = new ProgressBar($output, 100);
+ $bar->setUpdateThrottle(0); // Disable throttling for testing
+
+ // Test format with placeholders
+ $format = 'Progress: [{bar}] {percent}% ({current}/{total})';
+ $bar->setFormat($format);
+
+ $bar->start('Processing');
+ $bar->setCurrent(25);
+
+ // The output should contain progress information
+ $outputArray = $output->getOutputArray();
+ $this->assertNotEmpty($outputArray);
+
+ $outputString = implode('', $outputArray);
+ $this->assertNotEmpty($outputString);
+
+ // Should contain some progress indicators
+ $this->assertStringContainsString('25', $outputString);
+ $this->assertStringContainsString('100', $outputString);
+ }
}
\ No newline at end of file
diff --git a/tests/WebFiori/Tests/Cli/RunnerTest.php b/tests/WebFiori/Tests/Cli/RunnerTest.php
index 38783ee..8297d32 100644
--- a/tests/WebFiori/Tests/Cli/RunnerTest.php
+++ b/tests/WebFiori/Tests/Cli/RunnerTest.php
@@ -1,1098 +1,1098 @@
-reset();
- $this->assertTrue($runner->getOutputStream() instanceof StdOut);
- $this->assertTrue($runner->getInputStream() instanceof StdIn);
- $runner->setInputStream(new ArrayInputStream());
- $runner->setOutputStream(new ArrayOutputStream());
- $this->assertFalse($runner->getOutputStream() instanceof StdOut);
- $this->assertFalse($runner->getInputStream() instanceof StdIn);
- $this->assertTrue($runner->getInputStream() instanceof ArrayInputStream);
- $this->assertTrue($runner->getOutputStream() instanceof ArrayOutputStream);
- }
- public function testIsCLI() {
- $this->assertTrue(Runner::isCLI());
- }
- /**
- * @test
- */
- public function testRunner00() {
- $runner = new Runner();
- $this->assertEquals([], $runner->getOutput());
- // Help command is automatically registered
- $this->assertEquals(['help'], array_keys($runner->getCommands()));
- $this->assertFalse($runner->addArg(' '));
- $this->assertFalse($runner->addArg(' invalid name '));
- $this->assertInstanceOf(\WebFiori\Cli\Commands\HelpCommand::class, $runner->getDefaultCommand());
- $this->assertNull($runner->getActiveCommand());
-
- $argObj = new Argument('--ansi');
- $this->assertFalse($runner->addArgument($argObj));
-
- $this->assertTrue($runner->addArg('global-arg', [
- ArgumentOption::OPTIONAL => true
- ]));
- $this->assertEquals(2, count($runner->getArgs()));
- $runner->removeArgument('--ansi');
- $this->assertEquals(1, count($runner->getArgs()));
- $this->assertFalse($runner->hasArg('--ansi'));
- $runner->register(new Command00());
- $this->assertEquals(2, count($runner->getCommands())); // help + super-hero
- $runner->register(new Command00());
- $this->assertEquals(2, count($runner->getCommands())); // Still 2, no duplicates
- $runner->setDefaultCommand('super-hero');
- $runner->setInputs([]);
- $this->assertEquals(0, $runner->runCommand(null, [
- 'name' => 'Ibrahim'
- ]));
- $this->assertEquals([
- "Hello hero Ibrahim\n"
- ], $runner->getOutput());
- }
- /**
- * @test
- */
- public function testRunner01() {
- $runner = new Runner();
- $this->assertEquals(0, $runner->getLastCommandExitStatus());
- $runner->setDefaultCommand('super-hero');
- // Since 'super-hero' is not registered, default remains the help command
- $this->assertInstanceOf(\WebFiori\Cli\Commands\HelpCommand::class, $runner->getDefaultCommand());
- $runner->setInputs([]);
- $this->assertEquals(-1, $runner->runCommand(null, [
- 'do-it',
- '--ansi'
- ]));
- $this->assertEquals(-1, $runner->getLastCommandExitStatus());
- $this->assertEquals([
- "Error: The command 'do-it' is not supported.\n"
- ], $runner->getOutput());
- }
- /**
- * @test
- */
- public function testRunner02() {
- $runner = new Runner();
- $runner->setDefaultCommand('super-hero');
- // Since 'super-hero' is not registered, default remains the help command
- $this->assertInstanceOf(\WebFiori\Cli\Commands\HelpCommand::class, $runner->getDefaultCommand());
- $runner->setInputs([]);
- $this->assertEquals(0, $runner->runCommand());
- $this->assertEquals(0, $runner->getLastCommandExitStatus());
- // Since default command is help, it will show help output instead of "No command" message
- $output = $runner->getOutput();
- $this->assertNotEmpty($output);
- $this->assertStringContainsString('Usage:', $output[0]);
- }
- /**
- * @test
- */
- public function testRunner03() {
- $this->assertEquals([
- "Error: The following argument(s) have invalid values: 'name'\n",
- "Info: Allowed values for the argument 'name':\n",
- "Ibrahim\n",
- "Ali\n"
- ], $this->executeSingleCommand(new Command00(), [
- 'super-hero',
- 'name' => 'Ok'
- ]));
- $this->assertEquals(-1, $this->getExitCode());
- }
- /**
- * @test
- */
- public function testRunner04() {
- $this->assertEquals([
- "\e[1;91mError: \e[0mThe following argument(s) have invalid values: 'name'\n",
- "\e[1;34mInfo: \e[0mAllowed values for the argument 'name':\n",
- "Ibrahim\n",
- "Ali\n"
- ], $this->executeSingleCommand(new Command00(), [
- 'name' => 'Ok',
- '--ansi'
- ]));
- $this->assertEquals(-1, $this->getExitCode());
- }
- /**
- * @test
- */
- public function testRunner05() {
- $runner = new Runner();
- $runner->register(new Command00());
- // Don't register HelpCommand again - it's already automatically registered
- $runner->removeArgument('--ansi');
- $runner->setDefaultCommand('help');
- $runner->setInputs([]);
- $this->assertEquals(0, $runner->runCommand(null, []));
- $this->assertEquals(0, $runner->getLastCommandExitStatus());
- $this->assertEquals([
- "Usage:\n",
- " command [arg1 arg2=\"val\" arg3...]\n\n",
- "Available Commands:\n",
- " help: Display CLI Help. To display help for specific command, use the argument \"--command\" with this command.\n",
- " super-hero: A command to display hero's name.\n"
- ], $runner->getOutput());
- }
- /**
- * @test
- */
- public function testRunner06() {
-
- $this->assertEquals([
- "Usage:\n",
- " command [arg1 arg2=\"val\" arg3...]\n\n",
- "Global Arguments:\n",
- " --ansi:[Optional] Force the use of ANSI output.\n",
- "Available Commands:\n",
- " help: Display CLI Help. To display help for specific command, use the argument \"--command\" with this command.\n",
- " super-hero: A command to display hero's name.\n"
- ], $this->executeMultiCommand([], [], [
- new Command00()
- // Don't register HelpCommand - it's automatically registered
- ], 'help'));
- $this->assertEquals(0, $this->getExitCode());
- }
- /**
- * @test
- */
- public function testRunner07() {
- $runner = new Runner();
- $runner->register(new Command00());
- $runner->setDefaultCommand('help');
- $runner->setInputs([]);
- $this->assertEquals(0, $runner->runCommand(new HelpCommand(), [
- '--ansi'
- ]));
- $this->assertEquals(0, $runner->getLastCommandExitStatus());
- $this->assertEquals([
- "\e[1;93mUsage:\e[0m\n",
- " command [arg1 arg2=\"val\" arg3...]\n\n",
- "\e[1;93mGlobal Arguments:\e[0m\n",
- "\e[1;33m --ansi:\e[0m[Optional] Force the use of ANSI output.\n",
- "\e[1;93mAvailable Commands:\e[0m\n",
- "\e[1;33m help\e[0m: Display CLI Help. To display help for specific command, use the argument \"--command\" with this command.\n",
- "\e[1;33m super-hero\e[0m: A command to display hero's name.\n"
- ], $runner->getOutput());
- }
- /**
- * @test
- */
- public function testRunner08() {
- $runner = new Runner();
- $runner->register(new Command00());
- $runner->setInputs([]);
- $this->assertEquals(0, $runner->runCommand(new HelpCommand(), [
- '--ansi',
- '--command' => 'super-hero'
- ]));
- $this->assertEquals([
- "\e[1;33m super-hero\e[0m: A command to display hero's name.\n",
- "\e[1;94m Supported Arguments:\e[0m\n",
- "\e[1;33m name:\e[0m The name of the hero\n",
- ], $runner->getOutput());
- }
- /**
- * @test
- */
- public function testRunner09() {
- $_SERVER['argv'] = [];
- $runner = new Runner();
- $runner->removeArgument('--ansi');
- $runner->register(new Command00());
- // Don't register HelpCommand - it's automatically registered
- $runner->setDefaultCommand('help');
- $runner->setInputs([]);
- $runner->start();
- $this->assertEquals([
- "Usage:\n",
- " command [arg1 arg2=\"val\" arg3...]\n\n",
- "Available Commands:\n",
- " help: Display CLI Help. To display help for specific command, use the argument \"--command\" with this command.\n",
- " super-hero: A command to display hero's name.\n"
- ], $runner->getOutput());
- $this->assertEquals(0, $runner->getLastCommandExitStatus());
- }
- /**
- * @test
- */
- public function testRunner10() {
- $runner = new Runner();
- $runner->register(new Command00());
- // Don't register HelpCommand - it's automatically registered
- $runner->setInputs([]);
- $runner->setArgsVector([
- 'entry.php',
- 'help',
- '--command' => 'super-hero'
- ]);
- $runner->start();
- $this->assertEquals([
- " super-hero: A command to display hero's name.\n",
- " Supported Arguments:\n",
- " name: The name of the hero\n",
- ], $runner->getOutput());
- }
- /**
- * @test
- */
- public function testRunner11() {
- $runner = new Runner();
- $runner->setBeforeStart(function (Runner $r) {
- $r->setArgsVector([
- 'entry.php',
- 'help',
- '--command' => 'super hero',
- '--ansi'
- ]);
- $r->register(new Command00());
- // Don't register HelpCommand - it's automatically registered
- $r->setInputs([]);
- });
- $runner->start();
- $this->assertEquals([
- "\e[1;91mError: \e[0mCommand 'super hero' is not supported.\n"
- ], $runner->getOutput());
- }
- /**
- * @test
- */
- public function testRunner12() {
-
- $runner = new Runner();
-
- $runner->register(new Command00());
- // Don't register HelpCommand - it's automatically registered
-
- $runner->setArgsVector([
- 'entry.php',
- '-i',
- ]);
- $runner->setInputs([
- 'exit'
- ]);
- $runner->start();
- $this->assertEquals([
- ">> Running in interactive mode.\n",
- ">> Type command name or 'exit' to close.\n",
- ">> "
- ], $runner->getOutput());
- $this->assertEquals(0, $runner->getLastCommandExitStatus());
- }
- /**
- * @test
- */
- public function testRunner13() {
-
- $runner = new Runner();
- $runner->register(new Command00());
- // Don't register HelpCommand - it's automatically registered
-
- $runner->setArgsVector([
- 'entry.php',
- '-i',
- ]);
- $runner->setInputs([
- 'help --ansi',
- 'exit'
- ]);
- $runner->start();
- $this->assertEquals([
- ">> Running in interactive mode.\n",
- ">> Type command name or 'exit' to close.\n",
- ">> Usage:\n",
- " command [arg1 arg2=\"val\" arg3...]\n\n",
- "Global Arguments:\n",
- " --ansi:[Optional] Force the use of ANSI output.\n",
- "Available Commands:\n",
- " help: Display CLI Help. To display help for specific command, use the argument \"--command\" with this command.\n",
- " super-hero: A command to display hero's name.\n",
- ">> ",
- ], $runner->getOutput());
- $this->assertEquals(0, $runner->getLastCommandExitStatus());
- }
- /**
- * @test
- */
- public function testRunner14() {
- $runner = new Runner();
-
- $runner->register(new Command00());
- // Don't register HelpCommand - it's automatically registered
-
- $runner->setArgsVector([
- 'entry.php',
- '-i',
- ]);
- $runner->setInputs([
- 'help --ansi --command=super-hero',
- 'super-hero name=Ibrahim',
- 'exit'
- ]);
- $runner->start();
- $this->assertEquals([
- ">> Running in interactive mode.\n",
- ">> Type command name or 'exit' to close.\n",
- ">> super-hero: A command to display hero's name.\n",
- " Supported Arguments:\n",
- " name: The name of the hero\n",
- ">> Hello hero Ibrahim\n",
- ">> "
- ], $runner->getOutput());
- }
- /**
- * @test
- */
- public function testRunner15() {
- $runner = new Runner();
- $runner->register(new Command00());
- // Don't register HelpCommand - it's automatically registered
- $runner->register(new WithExceptionCommand());
- $runner->setAfterExecution(function (Runner $r) {
- $r->getActiveCommand()->println('Command Exit Status: '.$r->getLastCommandExitStatus());
- });
- $runner->setArgsVector([
- 'entry.php',
- '--ansi',
- '-i',
- ]);
- $runner->setInputs([
- 'help --command=super-hero',
- 'with-exception',
- 'exit'
- ]);
- $runner->start();
- $output = $runner->getOutput();
- // Null out the stack trace content as it can vary
- for ($i = 12; $i < count($output) - 2; $i++) {
- if ($output[$i] !== null && strpos($output[$i], 'Command Exit Status: -1') === false && strpos($output[$i], '>> ') === false) {
- $output[$i] = null;
- }
- }
-
- $this->assertEquals([
- "[1;34m>>[0m Running in interactive mode.\n",
- "[1;34m>>[0m Type command name or 'exit' to close.\n",
- "[1;34m>>[0m [1;33m super-hero[0m: A command to display hero's name.\n",
- "[1;94m Supported Arguments:[0m\n",
- "[1;33m name:[0m The name of the hero\n",
- "Command Exit Status: 0\n",
- "[1;34m>>[0m [1;31mError:[0m An exception was thrown.\n",
- "[1;33mException Message:[0m Call to undefined method WebFiori\Tests\Cli\TestCommands\WithExceptionCommand::notExist()\n",
- "[1;33mCode:[0m 0\n",
- "[1;33mAt:[0m ".ROOT_DIR."tests".DS."WebFiori".DS."Tests".DS."Cli".DS."TestCommands".DS."WithExceptionCommand.php\n",
- "[1;33mLine:[0m 13\n",
- "[1;33mStack Trace:[0m \n\n",
- null,
- "Command Exit Status: -1\n",
- "[1;34m>>[0m ",
- ], $output);
- }
- /**
- * @test
- */
- public function testRunner16() {
- $runner = new Runner();
- $runner->register(new Command01());
- $runner->setInputs([]);
- $this->assertEquals(-1, $runner->runCommand(null, [
- 'show-v'
- ]));
- $this->assertEquals([
- "Error: The following required argument(s) are missing: 'arg-1', 'arg-2'\n"
- ], $runner->getOutput());
- }
- /**
- * @test
- */
- public function testRunner17() {
- $runner = new Runner();
- $runner->register(new Command01());
- $runner->setInputs([]);
- $this->assertEquals(-1, $runner->runCommand(null, [
- 'show-v',
- '--ansi'
- ]));
- $this->assertEquals([
- "\e[1;91mError: \e[0mThe following required argument(s) are missing: 'arg-1', 'arg-2'\n"
- ], $runner->getOutput());
- }
- /**
- * @test
- */
- public function testRunner18() {
- $runner = new Runner();
- $runner->register(new Command01());
- $runner->setInputs([]);
- $runner->setAfterExecution(function (Runner $r) {
- $r->getActiveCommand()->println('Command Exit Status: '.$r->getLastCommandExitStatus());
- });
- $this->assertEquals(0, $runner->runCommand(null, [
- 'show-v',
- 'arg-1' => 'Super Cool Arg',
- 'arg-2' => "First One is Coller",
- ]));
- $this->assertEquals([
- "System version: 1.0.0\n",
- "Super Cool Arg\n",
- "First One is Coller\n",
- "Hello\n",
- "Command Exit Status: 0\n"
- ], $runner->getOutput());
- }
- /**
- * @test
- */
- public function testRunner19() {
- $runner = new Runner();
- $runner->register(new Command00());
- // Don't register HelpCommand - it's automatically registered
- $runner->register(new WithExceptionCommand());
- $runner->setArgsVector([
- 'entry.php',
- '-i',
- ]);
- $runner->setInputs([
- '',
- '',
- 'exit'
- ]);
- $this->assertEquals(0, $runner->start());
- $this->assertEquals([
- ">> Running in interactive mode.\n",
- ">> Type command name or 'exit' to close.\n",
- ">> No input.\n",
- ">> No input.\n",
- ">> "
- ], $runner->getOutput());
- }
- /**
- * @test
- */
- public function testRunner20() {
- $runner = new Runner();
- $runner->register(new Command00());
- // Don't register HelpCommand - it's automatically registered
- $runner->register(new WithExceptionCommand());
- $runner->setArgsVector([
- 'entry.php',
- '--ansi',
- ]);
- $runner->setInputs([
-
- ]);
- $runner->start();
- //$this->assertEquals(0, $runner->start());
- // Since help command is now the default, it will show help output instead of "No command" message
- $output = $runner->getOutput();
- $this->assertNotEmpty($output);
- $this->assertStringContainsString('Usage:', $output[0]);
- }
- /**
- * @test
- */
- public function testRunner21() {
- $runner = new Runner();
- $runner->setArgsVector([
-
- ]);
- $runner->setInputStream(new ArrayInputStream([
-
- ]));
- $runner->setOutputStream(new ArrayOutputStream());
-
- $this->assertEquals([
-
- ], $runner->getOutput());
- $runner->register(new Command00());
- // Don't register HelpCommand - it's automatically registered
- $runner->register(new WithExceptionCommand());
- $runner->setAfterExecution(function (Runner $r) {
- $r->getActiveCommand()->println('Command Exit Status: '.$r->getLastCommandExitStatus());
- });
-
- $runner->setArgsVector([
- 'entry.php',
- 'with-exception',
- ]);
- $runner->setInputs([]);
- $runner->start();
- $output = $runner->getOutput();
- //Removing the trace
- $output[6] = null;
- $this->assertEquals([
- "Error: An exception was thrown.\n",
- "Exception Message: Call to undefined method WebFiori\\Tests\\Cli\\TestCommands\\WithExceptionCommand::notExist()\n",
- "Code: 0\n",
- "At: ".\ROOT_DIR."tests".\DS."WebFiori".\DS."Tests".\DS."Cli".\DS."TestCommands".\DS."WithExceptionCommand.php\n",
- "Line: 13\n",
- "Stack Trace: \n\n",
- null,
- "Command Exit Status: -1\n"
- ], $output);
- }
- public function testRunner22() {
- $runner = new Runner();
- $runner->register(new Command03());
- $runner->setArgsVector([
- 'entry.php',
- 'run-another',
- 'arg-1' => 'Nice',
- 'arg-2' => 'Cool'
- ]);
- $runner->setInputStream(new ArrayInputStream([
-
- ]));
- $runner->setOutputStream(new ArrayOutputStream());
- $exitCode = $runner->start();
- $output = $runner->getOutput();
- $this->assertEquals([
- "Running Sub Command\n",
- "System version: 1.0.0\n",
- "Nice\n",
- "Cool\n",
- "Ur\n",
- "Done\n",
- ], $output);
- }
- /**
- * @test
- */
- public function test00() {
- $runner = new Runner();
- $runner->setInputs([]);
- $runner->setArgsVector([
-
- ]);
- $this->assertEquals([
-
- ], $runner->getOutput());
- }
- /**
- * Test Runner initialization and basic properties
- * @test
- */
- public function testRunnerInitializationEnhanced() {
- $runner = new Runner();
-
- // Test initial state
- $this->assertNull($runner->getActiveCommand());
- $this->assertNotNull($runner->getInputStream());
- $this->assertNotNull($runner->getOutputStream());
- $this->assertEquals(0, $runner->getLastCommandExitStatus());
- $this->assertFalse($runner->isInteractive());
- }
-
- /**
- * Test command registration with aliases
- * @test
- */
- public function testCommandRegistrationWithAliasesEnhanced() {
- $runner = new Runner();
- $command = new TestCommand('test-cmd', [], 'Test command');
-
- // Register command with aliases
- $result = $runner->register($command, ['tc', 'test']);
- $this->assertSame($runner, $result); // Should return self for chaining
-
- // Test command is registered
- $this->assertSame($command, $runner->getCommandByName('test-cmd'));
-
- // Test aliases are registered
- $this->assertTrue($runner->hasAlias('tc'));
- $this->assertTrue($runner->hasAlias('test'));
- $this->assertEquals('test-cmd', $runner->resolveAlias('tc'));
- $this->assertEquals('test-cmd', $runner->resolveAlias('test'));
-
- // Test getting all aliases
- $aliases = $runner->getAliases();
- $this->assertArrayHasKey('tc', $aliases);
- $this->assertArrayHasKey('test', $aliases);
- $this->assertEquals('test-cmd', $aliases['tc']);
- $this->assertEquals('test-cmd', $aliases['test']);
- }
-
- /**
- * Test duplicate command registration
- * @test
- */
- public function testDuplicateCommandRegistrationEnhanced() {
- $runner = new Runner();
- $command1 = new TestCommand('test-cmd', [], 'First command');
- $command2 = new TestCommand('test-cmd', [], 'Second command');
-
- // Register first command
- $runner->register($command1);
- $this->assertSame($command1, $runner->getCommandByName('test-cmd'));
-
- // Register second command with same name (should replace)
- $runner->register($command2);
- $this->assertSame($command2, $runner->getCommandByName('test-cmd'));
- }
-
- /**
- * Test global arguments
- * @test
- */
- public function testGlobalArgumentsEnhanced() {
- $runner = new Runner();
-
- // Add global arguments
- $this->assertTrue($runner->addArg('--global-arg', [
- ArgumentOption::OPTIONAL => true,
- ArgumentOption::DESCRIPTION => 'Global argument'
- ]));
-
- // Test duplicate global argument
- $this->assertFalse($runner->addArg('--global-arg', [])); // Should fail
-
- // Test argument exists
- $this->assertTrue($runner->hasArg('--global-arg'));
- $this->assertFalse($runner->hasArg('--non-existent'));
-
- // Test removing argument
- $this->assertTrue($runner->removeArgument('--global-arg'));
- $this->assertFalse($runner->hasArg('--global-arg'));
-
- // Test removing non-existent argument
- $this->assertFalse($runner->removeArgument('--non-existent'));
- }
-
- /**
- * Test arguments vector handling
- * @test
- */
- public function testArgumentsVectorEnhanced() {
- $runner = new Runner();
-
- $argsVector = ['script.php', 'command', '--arg1=value1', '--arg2', 'value2'];
- $runner->setArgsVector($argsVector);
-
- $this->assertEquals($argsVector, $runner->getArgsVector());
- }
-
- /**
- * Test stream handling
- * @test
- */
- public function testStreamHandlingEnhanced() {
- $runner = new Runner();
-
- // Test setting custom streams
- $customInput = new ArrayInputStream(['test input']);
- $customOutput = new ArrayOutputStream();
-
- $result1 = $runner->setInputStream($customInput);
- $this->assertSame($runner, $result1); // Should return self
- $this->assertSame($customInput, $runner->getInputStream());
-
- $result2 = $runner->setOutputStream($customOutput);
- $this->assertSame($runner, $result2); // Should return self
- $this->assertSame($customOutput, $runner->getOutputStream());
- }
-
- /**
- * Test inputs array handling
- * @test
- */
- public function testInputsArrayHandlingEnhanced() {
- $runner = new Runner();
-
- $inputs = ['input1', 'input2', 'input3'];
- $result = $runner->setInputs($inputs);
- $this->assertSame($runner, $result); // Should return self
-
- // The inputs should be set as ArrayInputStream
- $inputStream = $runner->getInputStream();
- $this->assertInstanceOf(ArrayInputStream::class, $inputStream);
- }
-
- /**
- * Test command execution
- * @test
- */
- public function testCommandExecutionEnhanced() {
- $runner = new Runner();
- $command = new TestCommand('test-cmd');
- $output = new ArrayOutputStream();
-
- $runner->register($command);
- $runner->setOutputStream($output);
-
- // Test running command
- $exitCode = $runner->runCommand($command);
- $this->assertEquals(0, $exitCode); // TestCommand should return 0
- $this->assertEquals(0, $runner->getLastCommandExitStatus());
-
- // Test running with arguments
- $exitCode2 = $runner->runCommand($command, ['--test-arg' => 'value']);
- $this->assertEquals(0, $exitCode2);
-
- // Test running with ANSI
- $exitCode3 = $runner->runCommand($command, [], true);
- $this->assertEquals(0, $exitCode3);
- }
-
- /**
- * Test sub-command execution
- * @test
- */
- public function testSubCommandExecutionEnhanced() {
- $runner = new Runner();
- $runner->setOutputStream(new ArrayOutputStream());
- $mainCommand = new TestCommand('main-cmd');
- $subCommand = new TestCommand('sub-cmd');
-
- $runner->register($mainCommand);
- $runner->register($subCommand);
-
- // Test running sub-command
- $exitCode = $runner->runCommandAsSub('sub-cmd');
- $this->assertEquals(0, $exitCode);
-
- // Test running non-existent sub-command
- $exitCode2 = $runner->runCommandAsSub('non-existent');
- $this->assertEquals(-1, $exitCode2);
- }
-
- /**
- * Test active command management
- * @test
- */
- public function testActiveCommandManagementEnhanced() {
- $runner = new Runner();
- $command = new TestCommand('test-cmd');
-
- // Initially no active command
- $this->assertNull($runner->getActiveCommand());
-
- // Set active command
- $result = $runner->setActiveCommand($command);
- $this->assertSame($runner, $result); // Should return self
- $this->assertSame($command, $runner->getActiveCommand());
-
- // Clear active command
- $runner->setActiveCommand(null);
- $this->assertNull($runner->getActiveCommand());
- }
-
- /**
- * Test callback functionality
- * @test
- */
- public function testCallbacksEnhanced() {
- $runner = new Runner();
- $callbackExecuted = false;
-
- // Test before start callback
- $beforeCallback = function() use (&$callbackExecuted) {
- $callbackExecuted = true;
- };
-
- $result = $runner->setBeforeStart($beforeCallback);
- $this->assertSame($runner, $result); // Should return self
-
- // Test after execution callback
- $afterCallback = function($exitCode, $command) {
- // Callback should receive exit code and command
- $this->assertIsInt($exitCode);
- };
-
- $result2 = $runner->setAfterExecution($afterCallback, ['param1', 'param2']);
- $this->assertSame($runner, $result2); // Should return self
- }
-
- /**
- * Test output collection
- * @test
- */
- public function testOutputCollectionEnhanced() {
- $runner = new Runner();
- $command = new TestCommand('test-cmd');
- $output = new ArrayOutputStream();
-
- $runner->register($command);
- $runner->setOutputStream($output);
-
- // Run command to generate output
- $runner->runCommand($command);
-
- // Test getting output
- $outputArray = $runner->getOutput();
- $this->assertIsArray($outputArray);
- $this->assertNotEmpty($outputArray);
- }
-
- /**
- * Test alias resolution edge cases
- * @test
- */
- public function testAliasResolutionEdgeCasesEnhanced() {
- $runner = new Runner();
-
- // Test resolving non-existent alias
- $this->assertNull($runner->resolveAlias('non-existent'));
-
- // Test resolving actual command name (not alias)
- $command = new TestCommand('test-cmd');
- $runner->register($command);
- $this->assertNull($runner->resolveAlias('test-cmd')); // Should return null for actual command names
- }
-
- /**
- * Test command retrieval edge cases
- * @test
- */
- public function testCommandRetrievalEdgeCasesEnhanced() {
- $runner = new Runner();
-
- // Test getting non-existent command
- $this->assertNull($runner->getCommandByName('non-existent'));
-
- // Test getting command by alias
- $command = new TestCommand('test-cmd');
- $runner->register($command, ['tc']);
-
- // Should find command by alias using getCommandByName (enhanced functionality)
- $this->assertSame($command, $runner->getCommandByName('tc'));
- $this->assertSame($command, $runner->getCommandByName('test-cmd'));
- }
-
- /**
- * Test argument object handling
- * @test
- */
- public function testArgumentObjectHandlingEnhanced() {
- $runner = new Runner();
-
- // Test adding Argument object
- $arg = new Argument('--test-arg');
- $arg->setDescription('Test argument');
-
- $result = $runner->addArgument($arg);
- $this->assertTrue($result);
- $this->assertTrue($runner->hasArg('--test-arg'));
-
- // Test adding duplicate Argument object
- $arg2 = new Argument('--test-arg');
- $result2 = $runner->addArgument($arg2);
- $this->assertFalse($result2); // Should fail for duplicate
- }
-
- /**
- * Test interactive mode detection
- * @test
- */
- public function testInteractiveModeDetectionEnhanced() {
- $runner = new Runner();
-
- // Initially not interactive
- $this->assertFalse($runner->isInteractive());
-
- // Set args vector with -i flag
- $runner->setArgsVector(['script.php', '-i']);
- // Note: The actual interactive detection might depend on the start() method implementation
- }
-
- /**
- * Test command discovery methods (if available)
- * @test
- */
- public function testCommandDiscoveryMethodsEnhanced() {
- $runner = new Runner();
-
- // Test auto-discovery state
- $this->assertFalse($runner->isAutoDiscoveryEnabled()); // Default should be false
-
- // Test enabling auto-discovery
- $result = $runner->enableAutoDiscovery();
- $this->assertSame($runner, $result);
- $this->assertTrue($runner->isAutoDiscoveryEnabled());
-
- // Test disabling auto-discovery
- $result2 = $runner->disableAutoDiscovery();
- $this->assertSame($runner, $result2);
- $this->assertFalse($runner->isAutoDiscoveryEnabled());
-
- // Test exclude patterns
- $result5 = $runner->excludePattern('*Test*');
- $this->assertSame($runner, $result5);
-
- $result6 = $runner->excludePatterns(['*Test*', '*Mock*']);
- $this->assertSame($runner, $result6);
-
- // Test discovery cache
- $result7 = $runner->enableDiscoveryCache('test-cache.json');
- $this->assertSame($runner, $result7);
-
- $result8 = $runner->disableDiscoveryCache();
- $this->assertSame($runner, $result8);
-
- $result9 = $runner->clearDiscoveryCache();
- $this->assertSame($runner, $result9);
-
- // Test strict mode
- $result10 = $runner->setDiscoveryStrictMode(true);
- $this->assertSame($runner, $result10);
-
- $result11 = $runner->setDiscoveryStrictMode(false);
- $this->assertSame($runner, $result11);
- }
- /**
- * Test command help pattern in interactive mode.
- * @test
- */
- public function testCommandHelpInteractive() {
- $runner = new Runner();
- $runner->register(new Command00());
- // Don't register HelpCommand - it's automatically registered
-
- $runner->setArgsVector([
- 'entry.php',
- '-i',
- ]);
- $runner->setInputs([
- 'super-hero help',
- 'exit'
- ]);
- $runner->start();
-
- $output = $runner->getOutput();
-
- // Should show help for super-hero command
- $this->assertContains(">> super-hero: A command to display hero's name.\n", $output);
- $this->assertContains(" Supported Arguments:\n", $output);
- $this->assertEquals(0, $runner->getLastCommandExitStatus());
- }
-
- /**
- * Test command -h pattern in interactive mode.
- * @test
- */
- public function testCommandDashHInteractive() {
- $runner = new Runner();
- $runner->register(new Command00());
- // Don't register HelpCommand - it's automatically registered
-
- $runner->setArgsVector([
- 'entry.php',
- '-i',
- ]);
- $runner->setInputs([
- 'super-hero -h',
- 'exit'
- ]);
- $runner->start();
-
- $output = $runner->getOutput();
-
- // Should show help for super-hero command
- $this->assertContains(">> super-hero: A command to display hero's name.\n", $output);
- $this->assertContains(" Supported Arguments:\n", $output);
- $this->assertEquals(0, $runner->getLastCommandExitStatus());
- }
-
- /**
- * Test command help pattern in non-interactive mode.
- * @test
- */
- public function testCommandHelpNonInteractive() {
- $runner = new Runner();
- $runner->register(new Command00());
- // Don't register HelpCommand - it's automatically registered
- $runner->setInputs([]);
-
- $runner->setArgsVector([
- 'entry.php',
- 'super-hero',
- 'help'
- ]);
- $runner->start();
-
- $output = $runner->getOutput();
-
- // Should show help for super-hero command
- $this->assertContains(" super-hero: A command to display hero's name.\n", $output);
- $this->assertContains(" Supported Arguments:\n", $output);
- $this->assertEquals(0, $runner->getLastCommandExitStatus());
- }
-
- /**
- * Test command -h pattern in non-interactive mode.
- * @test
- */
- public function testCommandDashHNonInteractive() {
- $runner = new Runner();
- $runner->register(new Command00());
- // Don't register HelpCommand - it's automatically registered
- $runner->setInputs([]);
-
- $runner->setArgsVector([
- 'entry.php',
- 'super-hero',
- '-h'
- ]);
- $runner->start();
-
- $output = $runner->getOutput();
-
- // Should show help for super-hero command
- $this->assertContains(" super-hero: A command to display hero's name.\n", $output);
- $this->assertContains(" Supported Arguments:\n", $output);
- $this->assertEquals(0, $runner->getLastCommandExitStatus());
- }
-
- /**
- * Test that invalid command with help doesn't trigger help.
- * @test
- */
- public function testInvalidCommandHelp() {
- $runner = new Runner();
- $runner->register(new Command00());
- // Don't register HelpCommand - it's automatically registered
-
- $runner->setArgsVector([
- 'entry.php',
- '-i',
- ]);
- $runner->setInputs([
- 'invalid-command help',
- 'exit'
- ]);
- $runner->start();
-
- $output = $runner->getOutput();
-
- // Should show error for invalid command, not help
- $this->assertContains(">> Error: The command 'invalid-command' is not supported.\n", $output);
- $this->assertEquals(-1, $runner->getLastCommandExitStatus());
- }
-}
+reset();
+ $this->assertTrue($runner->getOutputStream() instanceof StdOut);
+ $this->assertTrue($runner->getInputStream() instanceof StdIn);
+ $runner->setInputStream(new ArrayInputStream());
+ $runner->setOutputStream(new ArrayOutputStream());
+ $this->assertFalse($runner->getOutputStream() instanceof StdOut);
+ $this->assertFalse($runner->getInputStream() instanceof StdIn);
+ $this->assertTrue($runner->getInputStream() instanceof ArrayInputStream);
+ $this->assertTrue($runner->getOutputStream() instanceof ArrayOutputStream);
+ }
+ public function testIsCLI() {
+ $this->assertTrue(Runner::isCLI());
+ }
+ /**
+ * @test
+ */
+ public function testRunner00() {
+ $runner = new Runner();
+ $this->assertEquals([], $runner->getOutput());
+ // Help command is automatically registered
+ $this->assertEquals(['help'], array_keys($runner->getCommands()));
+ $this->assertFalse($runner->addArg(' '));
+ $this->assertFalse($runner->addArg(' invalid name '));
+ $this->assertInstanceOf(\WebFiori\Cli\Commands\HelpCommand::class, $runner->getDefaultCommand());
+ $this->assertNull($runner->getActiveCommand());
+
+ $argObj = new Argument('--ansi');
+ $this->assertFalse($runner->addArgument($argObj));
+
+ $this->assertTrue($runner->addArg('global-arg', [
+ ArgumentOption::OPTIONAL => true
+ ]));
+ $this->assertEquals(2, count($runner->getArgs()));
+ $runner->removeArgument('--ansi');
+ $this->assertEquals(1, count($runner->getArgs()));
+ $this->assertFalse($runner->hasArg('--ansi'));
+ $runner->register(new Command00());
+ $this->assertEquals(2, count($runner->getCommands())); // help + super-hero
+ $runner->register(new Command00());
+ $this->assertEquals(2, count($runner->getCommands())); // Still 2, no duplicates
+ $runner->setDefaultCommand('super-hero');
+ $runner->setInputs([]);
+ $this->assertEquals(0, $runner->runCommand(null, [
+ 'name' => 'Ibrahim'
+ ]));
+ $this->assertEquals([
+ "Hello hero Ibrahim\n"
+ ], $runner->getOutput());
+ }
+ /**
+ * @test
+ */
+ public function testRunner01() {
+ $runner = new Runner();
+ $this->assertEquals(0, $runner->getLastCommandExitStatus());
+ $runner->setDefaultCommand('super-hero');
+ // Since 'super-hero' is not registered, default remains the help command
+ $this->assertInstanceOf(\WebFiori\Cli\Commands\HelpCommand::class, $runner->getDefaultCommand());
+ $runner->setInputs([]);
+ $this->assertEquals(-1, $runner->runCommand(null, [
+ 'do-it',
+ '--ansi'
+ ]));
+ $this->assertEquals(-1, $runner->getLastCommandExitStatus());
+ $this->assertEquals([
+ "Error: The command 'do-it' is not supported.\n"
+ ], $runner->getOutput());
+ }
+ /**
+ * @test
+ */
+ public function testRunner02() {
+ $runner = new Runner();
+ $runner->setDefaultCommand('super-hero');
+ // Since 'super-hero' is not registered, default remains the help command
+ $this->assertInstanceOf(\WebFiori\Cli\Commands\HelpCommand::class, $runner->getDefaultCommand());
+ $runner->setInputs([]);
+ $this->assertEquals(0, $runner->runCommand());
+ $this->assertEquals(0, $runner->getLastCommandExitStatus());
+ // Since default command is help, it will show help output instead of "No command" message
+ $output = $runner->getOutput();
+ $this->assertNotEmpty($output);
+ $this->assertStringContainsString('Usage:', $output[0]);
+ }
+ /**
+ * @test
+ */
+ public function testRunner03() {
+ $this->assertEquals([
+ "Error: The following argument(s) have invalid values: 'name'\n",
+ "Info: Allowed values for the argument 'name':\n",
+ "Ibrahim\n",
+ "Ali\n"
+ ], $this->executeSingleCommand(new Command00(), [
+ 'super-hero',
+ 'name' => 'Ok'
+ ]));
+ $this->assertEquals(-1, $this->getExitCode());
+ }
+ /**
+ * @test
+ */
+ public function testRunner04() {
+ $this->assertEquals([
+ "\e[1;91mError: \e[0mThe following argument(s) have invalid values: 'name'\n",
+ "\e[1;34mInfo: \e[0mAllowed values for the argument 'name':\n",
+ "Ibrahim\n",
+ "Ali\n"
+ ], $this->executeSingleCommand(new Command00(), [
+ 'name' => 'Ok',
+ '--ansi'
+ ]));
+ $this->assertEquals(-1, $this->getExitCode());
+ }
+ /**
+ * @test
+ */
+ public function testRunner05() {
+ $runner = new Runner();
+ $runner->register(new Command00());
+ // Don't register HelpCommand again - it's already automatically registered
+ $runner->removeArgument('--ansi');
+ $runner->setDefaultCommand('help');
+ $runner->setInputs([]);
+ $this->assertEquals(0, $runner->runCommand(null, []));
+ $this->assertEquals(0, $runner->getLastCommandExitStatus());
+ $this->assertEquals([
+ "Usage:\n",
+ " command [arg1 arg2=\"val\" arg3...]\n\n",
+ "Available Commands:\n",
+ " help: Display CLI Help. To display help for specific command, use the argument \"--command\" with this command.\n",
+ " super-hero: A command to display hero's name.\n"
+ ], $runner->getOutput());
+ }
+ /**
+ * @test
+ */
+ public function testRunner06() {
+
+ $this->assertEquals([
+ "Usage:\n",
+ " command [arg1 arg2=\"val\" arg3...]\n\n",
+ "Global Arguments:\n",
+ " --ansi:[Optional] Force the use of ANSI output.\n",
+ "Available Commands:\n",
+ " help: Display CLI Help. To display help for specific command, use the argument \"--command\" with this command.\n",
+ " super-hero: A command to display hero's name.\n"
+ ], $this->executeMultiCommand([], [], [
+ new Command00()
+ // Don't register HelpCommand - it's automatically registered
+ ], 'help'));
+ $this->assertEquals(0, $this->getExitCode());
+ }
+ /**
+ * @test
+ */
+ public function testRunner07() {
+ $runner = new Runner();
+ $runner->register(new Command00());
+ $runner->setDefaultCommand('help');
+ $runner->setInputs([]);
+ $this->assertEquals(0, $runner->runCommand(new HelpCommand(), [
+ '--ansi'
+ ]));
+ $this->assertEquals(0, $runner->getLastCommandExitStatus());
+ $this->assertEquals([
+ "\e[1;93mUsage:\e[0m\n",
+ " command [arg1 arg2=\"val\" arg3...]\n\n",
+ "\e[1;93mGlobal Arguments:\e[0m\n",
+ "\e[1;33m --ansi:\e[0m[Optional] Force the use of ANSI output.\n",
+ "\e[1;93mAvailable Commands:\e[0m\n",
+ "\e[1;33m help\e[0m: Display CLI Help. To display help for specific command, use the argument \"--command\" with this command.\n",
+ "\e[1;33m super-hero\e[0m: A command to display hero's name.\n"
+ ], $runner->getOutput());
+ }
+ /**
+ * @test
+ */
+ public function testRunner08() {
+ $runner = new Runner();
+ $runner->register(new Command00());
+ $runner->setInputs([]);
+ $this->assertEquals(0, $runner->runCommand(new HelpCommand(), [
+ '--ansi',
+ '--command' => 'super-hero'
+ ]));
+ $this->assertEquals([
+ "\e[1;33m super-hero\e[0m: A command to display hero's name.\n",
+ "\e[1;94m Supported Arguments:\e[0m\n",
+ "\e[1;33m name:\e[0m The name of the hero\n",
+ ], $runner->getOutput());
+ }
+ /**
+ * @test
+ */
+ public function testRunner09() {
+ $_SERVER['argv'] = [];
+ $runner = new Runner();
+ $runner->removeArgument('--ansi');
+ $runner->register(new Command00());
+ // Don't register HelpCommand - it's automatically registered
+ $runner->setDefaultCommand('help');
+ $runner->setInputs([]);
+ $runner->start();
+ $this->assertEquals([
+ "Usage:\n",
+ " command [arg1 arg2=\"val\" arg3...]\n\n",
+ "Available Commands:\n",
+ " help: Display CLI Help. To display help for specific command, use the argument \"--command\" with this command.\n",
+ " super-hero: A command to display hero's name.\n"
+ ], $runner->getOutput());
+ $this->assertEquals(0, $runner->getLastCommandExitStatus());
+ }
+ /**
+ * @test
+ */
+ public function testRunner10() {
+ $runner = new Runner();
+ $runner->register(new Command00());
+ // Don't register HelpCommand - it's automatically registered
+ $runner->setInputs([]);
+ $runner->setArgsVector([
+ 'entry.php',
+ 'help',
+ '--command' => 'super-hero'
+ ]);
+ $runner->start();
+ $this->assertEquals([
+ " super-hero: A command to display hero's name.\n",
+ " Supported Arguments:\n",
+ " name: The name of the hero\n",
+ ], $runner->getOutput());
+ }
+ /**
+ * @test
+ */
+ public function testRunner11() {
+ $runner = new Runner();
+ $runner->setBeforeStart(function (Runner $r) {
+ $r->setArgsVector([
+ 'entry.php',
+ 'help',
+ '--command' => 'super hero',
+ '--ansi'
+ ]);
+ $r->register(new Command00());
+ // Don't register HelpCommand - it's automatically registered
+ $r->setInputs([]);
+ });
+ $runner->start();
+ $this->assertEquals([
+ "\e[1;91mError: \e[0mCommand 'super hero' is not supported.\n"
+ ], $runner->getOutput());
+ }
+ /**
+ * @test
+ */
+ public function testRunner12() {
+
+ $runner = new Runner();
+
+ $runner->register(new Command00());
+ // Don't register HelpCommand - it's automatically registered
+
+ $runner->setArgsVector([
+ 'entry.php',
+ '-i',
+ ]);
+ $runner->setInputs([
+ 'exit'
+ ]);
+ $runner->start();
+ $this->assertEquals([
+ ">> Running in interactive mode.\n",
+ ">> Type command name or 'exit' to close.\n",
+ ">> "
+ ], $runner->getOutput());
+ $this->assertEquals(0, $runner->getLastCommandExitStatus());
+ }
+ /**
+ * @test
+ */
+ public function testRunner13() {
+
+ $runner = new Runner();
+ $runner->register(new Command00());
+ // Don't register HelpCommand - it's automatically registered
+
+ $runner->setArgsVector([
+ 'entry.php',
+ '-i',
+ ]);
+ $runner->setInputs([
+ 'help --ansi',
+ 'exit'
+ ]);
+ $runner->start();
+ $this->assertEquals([
+ ">> Running in interactive mode.\n",
+ ">> Type command name or 'exit' to close.\n",
+ ">> Usage:\n",
+ " command [arg1 arg2=\"val\" arg3...]\n\n",
+ "Global Arguments:\n",
+ " --ansi:[Optional] Force the use of ANSI output.\n",
+ "Available Commands:\n",
+ " help: Display CLI Help. To display help for specific command, use the argument \"--command\" with this command.\n",
+ " super-hero: A command to display hero's name.\n",
+ ">> ",
+ ], $runner->getOutput());
+ $this->assertEquals(0, $runner->getLastCommandExitStatus());
+ }
+ /**
+ * @test
+ */
+ public function testRunner14() {
+ $runner = new Runner();
+
+ $runner->register(new Command00());
+ // Don't register HelpCommand - it's automatically registered
+
+ $runner->setArgsVector([
+ 'entry.php',
+ '-i',
+ ]);
+ $runner->setInputs([
+ 'help --ansi --command=super-hero',
+ 'super-hero name=Ibrahim',
+ 'exit'
+ ]);
+ $runner->start();
+ $this->assertEquals([
+ ">> Running in interactive mode.\n",
+ ">> Type command name or 'exit' to close.\n",
+ ">> super-hero: A command to display hero's name.\n",
+ " Supported Arguments:\n",
+ " name: The name of the hero\n",
+ ">> Hello hero Ibrahim\n",
+ ">> "
+ ], $runner->getOutput());
+ }
+ /**
+ * @test
+ */
+ public function testRunner15() {
+ $runner = new Runner();
+ $runner->register(new Command00());
+ // Don't register HelpCommand - it's automatically registered
+ $runner->register(new WithExceptionCommand());
+ $runner->setAfterExecution(function (Runner $r) {
+ $r->getActiveCommand()->println('Command Exit Status: '.$r->getLastCommandExitStatus());
+ });
+ $runner->setArgsVector([
+ 'entry.php',
+ '--ansi',
+ '-i',
+ ]);
+ $runner->setInputs([
+ 'help --command=super-hero',
+ 'with-exception',
+ 'exit'
+ ]);
+ $runner->start();
+ $output = $runner->getOutput();
+ // Null out the stack trace content as it can vary
+ for ($i = 12; $i < count($output) - 2; $i++) {
+ if ($output[$i] !== null && strpos($output[$i], 'Command Exit Status: -1') === false && strpos($output[$i], '>> ') === false) {
+ $output[$i] = null;
+ }
+ }
+
+ $this->assertEquals([
+ "[1;34m>>[0m Running in interactive mode.\n",
+ "[1;34m>>[0m Type command name or 'exit' to close.\n",
+ "[1;34m>>[0m [1;33m super-hero[0m: A command to display hero's name.\n",
+ "[1;94m Supported Arguments:[0m\n",
+ "[1;33m name:[0m The name of the hero\n",
+ "Command Exit Status: 0\n",
+ "[1;34m>>[0m [1;31mError:[0m An exception was thrown.\n",
+ "[1;33mException Message:[0m Call to undefined method WebFiori\Tests\Cli\TestCommands\WithExceptionCommand::notExist()\n",
+ "[1;33mCode:[0m 0\n",
+ "[1;33mAt:[0m ".ROOT_DIR."tests".DS."WebFiori".DS."Tests".DS."Cli".DS."TestCommands".DS."WithExceptionCommand.php\n",
+ "[1;33mLine:[0m 13\n",
+ "[1;33mStack Trace:[0m \n\n",
+ null,
+ "Command Exit Status: -1\n",
+ "[1;34m>>[0m ",
+ ], $output);
+ }
+ /**
+ * @test
+ */
+ public function testRunner16() {
+ $runner = new Runner();
+ $runner->register(new Command01());
+ $runner->setInputs([]);
+ $this->assertEquals(-1, $runner->runCommand(null, [
+ 'show-v'
+ ]));
+ $this->assertEquals([
+ "Error: The following required argument(s) are missing: 'arg-1', 'arg-2'\n"
+ ], $runner->getOutput());
+ }
+ /**
+ * @test
+ */
+ public function testRunner17() {
+ $runner = new Runner();
+ $runner->register(new Command01());
+ $runner->setInputs([]);
+ $this->assertEquals(-1, $runner->runCommand(null, [
+ 'show-v',
+ '--ansi'
+ ]));
+ $this->assertEquals([
+ "\e[1;91mError: \e[0mThe following required argument(s) are missing: 'arg-1', 'arg-2'\n"
+ ], $runner->getOutput());
+ }
+ /**
+ * @test
+ */
+ public function testRunner18() {
+ $runner = new Runner();
+ $runner->register(new Command01());
+ $runner->setInputs([]);
+ $runner->setAfterExecution(function (Runner $r) {
+ $r->getActiveCommand()->println('Command Exit Status: '.$r->getLastCommandExitStatus());
+ });
+ $this->assertEquals(0, $runner->runCommand(null, [
+ 'show-v',
+ 'arg-1' => 'Super Cool Arg',
+ 'arg-2' => "First One is Coller",
+ ]));
+ $this->assertEquals([
+ "System version: 1.0.0\n",
+ "Super Cool Arg\n",
+ "First One is Coller\n",
+ "Hello\n",
+ "Command Exit Status: 0\n"
+ ], $runner->getOutput());
+ }
+ /**
+ * @test
+ */
+ public function testRunner19() {
+ $runner = new Runner();
+ $runner->register(new Command00());
+ // Don't register HelpCommand - it's automatically registered
+ $runner->register(new WithExceptionCommand());
+ $runner->setArgsVector([
+ 'entry.php',
+ '-i',
+ ]);
+ $runner->setInputs([
+ '',
+ '',
+ 'exit'
+ ]);
+ $this->assertEquals(0, $runner->start());
+ $this->assertEquals([
+ ">> Running in interactive mode.\n",
+ ">> Type command name or 'exit' to close.\n",
+ ">> No input.\n",
+ ">> No input.\n",
+ ">> "
+ ], $runner->getOutput());
+ }
+ /**
+ * @test
+ */
+ public function testRunner20() {
+ $runner = new Runner();
+ $runner->register(new Command00());
+ // Don't register HelpCommand - it's automatically registered
+ $runner->register(new WithExceptionCommand());
+ $runner->setArgsVector([
+ 'entry.php',
+ '--ansi',
+ ]);
+ $runner->setInputs([
+
+ ]);
+ $runner->start();
+ //$this->assertEquals(0, $runner->start());
+ // Since help command is now the default, it will show help output instead of "No command" message
+ $output = $runner->getOutput();
+ $this->assertNotEmpty($output);
+ $this->assertStringContainsString('Usage:', $output[0]);
+ }
+ /**
+ * @test
+ */
+ public function testRunner21() {
+ $runner = new Runner();
+ $runner->setArgsVector([
+
+ ]);
+ $runner->setInputStream(new ArrayInputStream([
+
+ ]));
+ $runner->setOutputStream(new ArrayOutputStream());
+
+ $this->assertEquals([
+
+ ], $runner->getOutput());
+ $runner->register(new Command00());
+ // Don't register HelpCommand - it's automatically registered
+ $runner->register(new WithExceptionCommand());
+ $runner->setAfterExecution(function (Runner $r) {
+ $r->getActiveCommand()->println('Command Exit Status: '.$r->getLastCommandExitStatus());
+ });
+
+ $runner->setArgsVector([
+ 'entry.php',
+ 'with-exception',
+ ]);
+ $runner->setInputs([]);
+ $runner->start();
+ $output = $runner->getOutput();
+ //Removing the trace
+ $output[6] = null;
+ $this->assertEquals([
+ "Error: An exception was thrown.\n",
+ "Exception Message: Call to undefined method WebFiori\\Tests\\Cli\\TestCommands\\WithExceptionCommand::notExist()\n",
+ "Code: 0\n",
+ "At: ".\ROOT_DIR."tests".\DS."WebFiori".\DS."Tests".\DS."Cli".\DS."TestCommands".\DS."WithExceptionCommand.php\n",
+ "Line: 13\n",
+ "Stack Trace: \n\n",
+ null,
+ "Command Exit Status: -1\n"
+ ], $output);
+ }
+ public function testRunner22() {
+ $runner = new Runner();
+ $runner->register(new Command03());
+ $runner->setArgsVector([
+ 'entry.php',
+ 'run-another',
+ 'arg-1' => 'Nice',
+ 'arg-2' => 'Cool'
+ ]);
+ $runner->setInputStream(new ArrayInputStream([
+
+ ]));
+ $runner->setOutputStream(new ArrayOutputStream());
+ $exitCode = $runner->start();
+ $output = $runner->getOutput();
+ $this->assertEquals([
+ "Running Sub Command\n",
+ "System version: 1.0.0\n",
+ "Nice\n",
+ "Cool\n",
+ "Ur\n",
+ "Done\n",
+ ], $output);
+ }
+ /**
+ * @test
+ */
+ public function test00() {
+ $runner = new Runner();
+ $runner->setInputs([]);
+ $runner->setArgsVector([
+
+ ]);
+ $this->assertEquals([
+
+ ], $runner->getOutput());
+ }
+ /**
+ * Test Runner initialization and basic properties
+ * @test
+ */
+ public function testRunnerInitializationEnhanced() {
+ $runner = new Runner();
+
+ // Test initial state
+ $this->assertNull($runner->getActiveCommand());
+ $this->assertNotNull($runner->getInputStream());
+ $this->assertNotNull($runner->getOutputStream());
+ $this->assertEquals(0, $runner->getLastCommandExitStatus());
+ $this->assertFalse($runner->isInteractive());
+ }
+
+ /**
+ * Test command registration with aliases
+ * @test
+ */
+ public function testCommandRegistrationWithAliasesEnhanced() {
+ $runner = new Runner();
+ $command = new TestCommand('test-cmd', [], 'Test command');
+
+ // Register command with aliases
+ $result = $runner->register($command, ['tc', 'test']);
+ $this->assertSame($runner, $result); // Should return self for chaining
+
+ // Test command is registered
+ $this->assertSame($command, $runner->getCommandByName('test-cmd'));
+
+ // Test aliases are registered
+ $this->assertTrue($runner->hasAlias('tc'));
+ $this->assertTrue($runner->hasAlias('test'));
+ $this->assertEquals('test-cmd', $runner->resolveAlias('tc'));
+ $this->assertEquals('test-cmd', $runner->resolveAlias('test'));
+
+ // Test getting all aliases
+ $aliases = $runner->getAliases();
+ $this->assertArrayHasKey('tc', $aliases);
+ $this->assertArrayHasKey('test', $aliases);
+ $this->assertEquals('test-cmd', $aliases['tc']);
+ $this->assertEquals('test-cmd', $aliases['test']);
+ }
+
+ /**
+ * Test duplicate command registration
+ * @test
+ */
+ public function testDuplicateCommandRegistrationEnhanced() {
+ $runner = new Runner();
+ $command1 = new TestCommand('test-cmd', [], 'First command');
+ $command2 = new TestCommand('test-cmd', [], 'Second command');
+
+ // Register first command
+ $runner->register($command1);
+ $this->assertSame($command1, $runner->getCommandByName('test-cmd'));
+
+ // Register second command with same name (should replace)
+ $runner->register($command2);
+ $this->assertSame($command2, $runner->getCommandByName('test-cmd'));
+ }
+
+ /**
+ * Test global arguments
+ * @test
+ */
+ public function testGlobalArgumentsEnhanced() {
+ $runner = new Runner();
+
+ // Add global arguments
+ $this->assertTrue($runner->addArg('--global-arg', [
+ ArgumentOption::OPTIONAL => true,
+ ArgumentOption::DESCRIPTION => 'Global argument'
+ ]));
+
+ // Test duplicate global argument
+ $this->assertFalse($runner->addArg('--global-arg', [])); // Should fail
+
+ // Test argument exists
+ $this->assertTrue($runner->hasArg('--global-arg'));
+ $this->assertFalse($runner->hasArg('--non-existent'));
+
+ // Test removing argument
+ $this->assertTrue($runner->removeArgument('--global-arg'));
+ $this->assertFalse($runner->hasArg('--global-arg'));
+
+ // Test removing non-existent argument
+ $this->assertFalse($runner->removeArgument('--non-existent'));
+ }
+
+ /**
+ * Test arguments vector handling
+ * @test
+ */
+ public function testArgumentsVectorEnhanced() {
+ $runner = new Runner();
+
+ $argsVector = ['script.php', 'command', '--arg1=value1', '--arg2', 'value2'];
+ $runner->setArgsVector($argsVector);
+
+ $this->assertEquals($argsVector, $runner->getArgsVector());
+ }
+
+ /**
+ * Test stream handling
+ * @test
+ */
+ public function testStreamHandlingEnhanced() {
+ $runner = new Runner();
+
+ // Test setting custom streams
+ $customInput = new ArrayInputStream(['test input']);
+ $customOutput = new ArrayOutputStream();
+
+ $result1 = $runner->setInputStream($customInput);
+ $this->assertSame($runner, $result1); // Should return self
+ $this->assertSame($customInput, $runner->getInputStream());
+
+ $result2 = $runner->setOutputStream($customOutput);
+ $this->assertSame($runner, $result2); // Should return self
+ $this->assertSame($customOutput, $runner->getOutputStream());
+ }
+
+ /**
+ * Test inputs array handling
+ * @test
+ */
+ public function testInputsArrayHandlingEnhanced() {
+ $runner = new Runner();
+
+ $inputs = ['input1', 'input2', 'input3'];
+ $result = $runner->setInputs($inputs);
+ $this->assertSame($runner, $result); // Should return self
+
+ // The inputs should be set as ArrayInputStream
+ $inputStream = $runner->getInputStream();
+ $this->assertInstanceOf(ArrayInputStream::class, $inputStream);
+ }
+
+ /**
+ * Test command execution
+ * @test
+ */
+ public function testCommandExecutionEnhanced() {
+ $runner = new Runner();
+ $command = new TestCommand('test-cmd');
+ $output = new ArrayOutputStream();
+
+ $runner->register($command);
+ $runner->setOutputStream($output);
+
+ // Test running command
+ $exitCode = $runner->runCommand($command);
+ $this->assertEquals(0, $exitCode); // TestCommand should return 0
+ $this->assertEquals(0, $runner->getLastCommandExitStatus());
+
+ // Test running with arguments
+ $exitCode2 = $runner->runCommand($command, ['--test-arg' => 'value']);
+ $this->assertEquals(0, $exitCode2);
+
+ // Test running with ANSI
+ $exitCode3 = $runner->runCommand($command, [], true);
+ $this->assertEquals(0, $exitCode3);
+ }
+
+ /**
+ * Test sub-command execution
+ * @test
+ */
+ public function testSubCommandExecutionEnhanced() {
+ $runner = new Runner();
+ $runner->setOutputStream(new ArrayOutputStream());
+ $mainCommand = new TestCommand('main-cmd');
+ $subCommand = new TestCommand('sub-cmd');
+
+ $runner->register($mainCommand);
+ $runner->register($subCommand);
+
+ // Test running sub-command
+ $exitCode = $runner->runCommandAsSub('sub-cmd');
+ $this->assertEquals(0, $exitCode);
+
+ // Test running non-existent sub-command
+ $exitCode2 = $runner->runCommandAsSub('non-existent');
+ $this->assertEquals(-1, $exitCode2);
+ }
+
+ /**
+ * Test active command management
+ * @test
+ */
+ public function testActiveCommandManagementEnhanced() {
+ $runner = new Runner();
+ $command = new TestCommand('test-cmd');
+
+ // Initially no active command
+ $this->assertNull($runner->getActiveCommand());
+
+ // Set active command
+ $result = $runner->setActiveCommand($command);
+ $this->assertSame($runner, $result); // Should return self
+ $this->assertSame($command, $runner->getActiveCommand());
+
+ // Clear active command
+ $runner->setActiveCommand(null);
+ $this->assertNull($runner->getActiveCommand());
+ }
+
+ /**
+ * Test callback functionality
+ * @test
+ */
+ public function testCallbacksEnhanced() {
+ $runner = new Runner();
+ $callbackExecuted = false;
+
+ // Test before start callback
+ $beforeCallback = function() use (&$callbackExecuted) {
+ $callbackExecuted = true;
+ };
+
+ $result = $runner->setBeforeStart($beforeCallback);
+ $this->assertSame($runner, $result); // Should return self
+
+ // Test after execution callback
+ $afterCallback = function($exitCode, $command) {
+ // Callback should receive exit code and command
+ $this->assertIsInt($exitCode);
+ };
+
+ $result2 = $runner->setAfterExecution($afterCallback, ['param1', 'param2']);
+ $this->assertSame($runner, $result2); // Should return self
+ }
+
+ /**
+ * Test output collection
+ * @test
+ */
+ public function testOutputCollectionEnhanced() {
+ $runner = new Runner();
+ $command = new TestCommand('test-cmd');
+ $output = new ArrayOutputStream();
+
+ $runner->register($command);
+ $runner->setOutputStream($output);
+
+ // Run command to generate output
+ $runner->runCommand($command);
+
+ // Test getting output
+ $outputArray = $runner->getOutput();
+ $this->assertIsArray($outputArray);
+ $this->assertNotEmpty($outputArray);
+ }
+
+ /**
+ * Test alias resolution edge cases
+ * @test
+ */
+ public function testAliasResolutionEdgeCasesEnhanced() {
+ $runner = new Runner();
+
+ // Test resolving non-existent alias
+ $this->assertNull($runner->resolveAlias('non-existent'));
+
+ // Test resolving actual command name (not alias)
+ $command = new TestCommand('test-cmd');
+ $runner->register($command);
+ $this->assertNull($runner->resolveAlias('test-cmd')); // Should return null for actual command names
+ }
+
+ /**
+ * Test command retrieval edge cases
+ * @test
+ */
+ public function testCommandRetrievalEdgeCasesEnhanced() {
+ $runner = new Runner();
+
+ // Test getting non-existent command
+ $this->assertNull($runner->getCommandByName('non-existent'));
+
+ // Test getting command by alias
+ $command = new TestCommand('test-cmd');
+ $runner->register($command, ['tc']);
+
+ // Should find command by alias using getCommandByName (enhanced functionality)
+ $this->assertSame($command, $runner->getCommandByName('tc'));
+ $this->assertSame($command, $runner->getCommandByName('test-cmd'));
+ }
+
+ /**
+ * Test argument object handling
+ * @test
+ */
+ public function testArgumentObjectHandlingEnhanced() {
+ $runner = new Runner();
+
+ // Test adding Argument object
+ $arg = new Argument('--test-arg');
+ $arg->setDescription('Test argument');
+
+ $result = $runner->addArgument($arg);
+ $this->assertTrue($result);
+ $this->assertTrue($runner->hasArg('--test-arg'));
+
+ // Test adding duplicate Argument object
+ $arg2 = new Argument('--test-arg');
+ $result2 = $runner->addArgument($arg2);
+ $this->assertFalse($result2); // Should fail for duplicate
+ }
+
+ /**
+ * Test interactive mode detection
+ * @test
+ */
+ public function testInteractiveModeDetectionEnhanced() {
+ $runner = new Runner();
+
+ // Initially not interactive
+ $this->assertFalse($runner->isInteractive());
+
+ // Set args vector with -i flag
+ $runner->setArgsVector(['script.php', '-i']);
+ // Note: The actual interactive detection might depend on the start() method implementation
+ }
+
+ /**
+ * Test command discovery methods (if available)
+ * @test
+ */
+ public function testCommandDiscoveryMethodsEnhanced() {
+ $runner = new Runner();
+
+ // Test auto-discovery state
+ $this->assertFalse($runner->isAutoDiscoveryEnabled()); // Default should be false
+
+ // Test enabling auto-discovery
+ $result = $runner->enableAutoDiscovery();
+ $this->assertSame($runner, $result);
+ $this->assertTrue($runner->isAutoDiscoveryEnabled());
+
+ // Test disabling auto-discovery
+ $result2 = $runner->disableAutoDiscovery();
+ $this->assertSame($runner, $result2);
+ $this->assertFalse($runner->isAutoDiscoveryEnabled());
+
+ // Test exclude patterns
+ $result5 = $runner->excludePattern('*Test*');
+ $this->assertSame($runner, $result5);
+
+ $result6 = $runner->excludePatterns(['*Test*', '*Mock*']);
+ $this->assertSame($runner, $result6);
+
+ // Test discovery cache
+ $result7 = $runner->enableDiscoveryCache('test-cache.json');
+ $this->assertSame($runner, $result7);
+
+ $result8 = $runner->disableDiscoveryCache();
+ $this->assertSame($runner, $result8);
+
+ $result9 = $runner->clearDiscoveryCache();
+ $this->assertSame($runner, $result9);
+
+ // Test strict mode
+ $result10 = $runner->setDiscoveryStrictMode(true);
+ $this->assertSame($runner, $result10);
+
+ $result11 = $runner->setDiscoveryStrictMode(false);
+ $this->assertSame($runner, $result11);
+ }
+ /**
+ * Test command help pattern in interactive mode.
+ * @test
+ */
+ public function testCommandHelpInteractive() {
+ $runner = new Runner();
+ $runner->register(new Command00());
+ // Don't register HelpCommand - it's automatically registered
+
+ $runner->setArgsVector([
+ 'entry.php',
+ '-i',
+ ]);
+ $runner->setInputs([
+ 'super-hero help',
+ 'exit'
+ ]);
+ $runner->start();
+
+ $output = $runner->getOutput();
+
+ // Should show help for super-hero command
+ $this->assertContains(">> super-hero: A command to display hero's name.\n", $output);
+ $this->assertContains(" Supported Arguments:\n", $output);
+ $this->assertEquals(0, $runner->getLastCommandExitStatus());
+ }
+
+ /**
+ * Test command -h pattern in interactive mode.
+ * @test
+ */
+ public function testCommandDashHInteractive() {
+ $runner = new Runner();
+ $runner->register(new Command00());
+ // Don't register HelpCommand - it's automatically registered
+
+ $runner->setArgsVector([
+ 'entry.php',
+ '-i',
+ ]);
+ $runner->setInputs([
+ 'super-hero -h',
+ 'exit'
+ ]);
+ $runner->start();
+
+ $output = $runner->getOutput();
+
+ // Should show help for super-hero command
+ $this->assertContains(">> super-hero: A command to display hero's name.\n", $output);
+ $this->assertContains(" Supported Arguments:\n", $output);
+ $this->assertEquals(0, $runner->getLastCommandExitStatus());
+ }
+
+ /**
+ * Test command help pattern in non-interactive mode.
+ * @test
+ */
+ public function testCommandHelpNonInteractive() {
+ $runner = new Runner();
+ $runner->register(new Command00());
+ // Don't register HelpCommand - it's automatically registered
+ $runner->setInputs([]);
+
+ $runner->setArgsVector([
+ 'entry.php',
+ 'super-hero',
+ 'help'
+ ]);
+ $runner->start();
+
+ $output = $runner->getOutput();
+
+ // Should show help for super-hero command
+ $this->assertContains(" super-hero: A command to display hero's name.\n", $output);
+ $this->assertContains(" Supported Arguments:\n", $output);
+ $this->assertEquals(0, $runner->getLastCommandExitStatus());
+ }
+
+ /**
+ * Test command -h pattern in non-interactive mode.
+ * @test
+ */
+ public function testCommandDashHNonInteractive() {
+ $runner = new Runner();
+ $runner->register(new Command00());
+ // Don't register HelpCommand - it's automatically registered
+ $runner->setInputs([]);
+
+ $runner->setArgsVector([
+ 'entry.php',
+ 'super-hero',
+ '-h'
+ ]);
+ $runner->start();
+
+ $output = $runner->getOutput();
+
+ // Should show help for super-hero command
+ $this->assertContains(" super-hero: A command to display hero's name.\n", $output);
+ $this->assertContains(" Supported Arguments:\n", $output);
+ $this->assertEquals(0, $runner->getLastCommandExitStatus());
+ }
+
+ /**
+ * Test that invalid command with help doesn't trigger help.
+ * @test
+ */
+ public function testInvalidCommandHelp() {
+ $runner = new Runner();
+ $runner->register(new Command00());
+ // Don't register HelpCommand - it's automatically registered
+
+ $runner->setArgsVector([
+ 'entry.php',
+ '-i',
+ ]);
+ $runner->setInputs([
+ 'invalid-command help',
+ 'exit'
+ ]);
+ $runner->start();
+
+ $output = $runner->getOutput();
+
+ // Should show error for invalid command, not help
+ $this->assertContains(">> Error: The command 'invalid-command' is not supported.\n", $output);
+ $this->assertEquals(-1, $runner->getLastCommandExitStatus());
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/Table/ColumnCalculatorTest.php b/tests/WebFiori/Tests/Cli/Table/ColumnCalculatorTest.php
index 5d75490..ebcce62 100644
--- a/tests/WebFiori/Tests/Cli/Table/ColumnCalculatorTest.php
+++ b/tests/WebFiori/Tests/Cli/Table/ColumnCalculatorTest.php
@@ -1,443 +1,443 @@
-calculator = new ColumnCalculator();
-
- $headers = ['Name', 'Age', 'City'];
- $rows = [
- ['John Doe', 30, 'New York'],
- ['Jane Smith', 25, 'Los Angeles'],
- ['Bob Johnson', 35, 'Chicago']
- ];
-
- $this->tableData = new TableData($headers, $rows);
- $this->style = TableStyle::default();
-
- $this->columns = [
- 0 => new Column('Name'),
- 1 => new Column('Age'),
- 2 => new Column('City')
- ];
- }
-
- /**
- * @test
- */
- public function testCalculateWidths() {
- $maxWidth = 80;
-
- $widths = $this->calculator->calculateWidths(
- $this->tableData,
- $this->columns,
- $maxWidth,
- $this->style
- );
-
- $this->assertIsArray($widths);
- $this->assertCount(3, $widths);
-
- // All widths should be positive integers
- foreach ($widths as $width) {
- $this->assertIsInt($width);
- $this->assertGreaterThan(0, $width);
- }
-
- // Total width should not exceed available space
- $totalWidth = array_sum($widths);
- $borderWidth = $this->style->getBorderWidth(3);
- $paddingWidth = 3 * $this->style->getTotalPadding();
-
- $this->assertLessThanOrEqual($maxWidth - $borderWidth - $paddingWidth, $totalWidth);
- }
-
- /**
- * @test
- */
- public function testCalculateWidthsWithFixedColumnWidth() {
- $this->columns[0]->setWidth(20);
- $maxWidth = 80;
-
- $widths = $this->calculator->calculateWidths(
- $this->tableData,
- $this->columns,
- $maxWidth,
- $this->style
- );
-
- $this->assertEquals(20, $widths[0]);
- }
-
- /**
- * @test
- */
- public function testCalculateWidthsWithMinWidth() {
- $this->columns[1]->setMinWidth(15);
- $maxWidth = 80;
-
- $widths = $this->calculator->calculateWidths(
- $this->tableData,
- $this->columns,
- $maxWidth,
- $this->style
- );
-
- $this->assertGreaterThanOrEqual(15, $widths[1]);
- }
-
- /**
- * @test
- */
- public function testCalculateWidthsWithMaxWidth() {
- $this->columns[0]->setMaxWidth(10);
- $maxWidth = 80;
-
- $widths = $this->calculator->calculateWidths(
- $this->tableData,
- $this->columns,
- $maxWidth,
- $this->style
- );
-
- $this->assertLessThanOrEqual(10, $widths[0]);
- }
-
- /**
- * @test
- */
- public function testCalculateWidthsEmptyColumns() {
- $widths = $this->calculator->calculateWidths(
- $this->tableData,
- [],
- 80,
- $this->style
- );
-
- $this->assertIsArray($widths);
- $this->assertEmpty($widths);
- }
-
- /**
- * @test
- */
- public function testCalculateWidthsNarrowTerminal() {
- $maxWidth = 30; // Very narrow
-
- $widths = $this->calculator->calculateWidths(
- $this->tableData,
- $this->columns,
- $maxWidth,
- $this->style
- );
-
- $this->assertIsArray($widths);
- $this->assertCount(3, $widths);
-
- // Should still provide minimum widths
- foreach ($widths as $width) {
- $this->assertGreaterThanOrEqual(3, $width); // MIN_COLUMN_WIDTH
- }
- }
-
- /**
- * @test
- */
- public function testCalculateResponsiveWidths() {
- $maxWidth = 120; // Wide terminal
-
- $widths = $this->calculator->calculateResponsiveWidths(
- $this->tableData,
- $this->columns,
- $maxWidth,
- $this->style
- );
-
- $this->assertIsArray($widths);
- $this->assertCount(3, $widths);
-
- foreach ($widths as $width) {
- $this->assertIsInt($width);
- $this->assertGreaterThan(0, $width);
- }
- }
-
- /**
- * @test
- */
- public function testCalculateResponsiveWidthsNarrow() {
- $maxWidth = 25; // Very narrow terminal
-
- $widths = $this->calculator->calculateResponsiveWidths(
- $this->tableData,
- $this->columns,
- $maxWidth,
- $this->style
- );
-
- $this->assertIsArray($widths);
- $this->assertCount(3, $widths);
-
- // Should use narrow width strategy
- foreach ($widths as $width) {
- $this->assertGreaterThanOrEqual(3, $width);
- }
- }
-
- /**
- * @test
- */
- public function testAutoConfigureColumns() {
- $columns = $this->calculator->autoConfigureColumns($this->tableData);
-
- $this->assertIsArray($columns);
- $this->assertCount(3, $columns);
-
- foreach ($columns as $column) {
- $this->assertInstanceOf(Column::class, $column);
- }
-
- // Age column should be right-aligned (numeric)
- $this->assertEquals(Column::ALIGN_RIGHT, $columns[1]->getAlignment());
-
- // Name and City should be left-aligned (string)
- $this->assertEquals(Column::ALIGN_LEFT, $columns[0]->getAlignment());
- $this->assertEquals(Column::ALIGN_LEFT, $columns[2]->getAlignment());
- }
-
- /**
- * @test
- */
- public function testAutoConfigureColumnsWithDifferentTypes() {
- $headers = ['Name', 'Price', 'Date', 'Active'];
- $rows = [
- ['Product A', 19.99, '2024-01-15', true],
- ['Product B', 29.99, '2024-01-16', false]
- ];
-
- $tableData = new TableData($headers, $rows);
- $columns = $this->calculator->autoConfigureColumns($tableData);
-
- $this->assertCount(4, $columns);
-
- // Name should be left-aligned
- $this->assertEquals(Column::ALIGN_LEFT, $columns[0]->getAlignment());
-
- // Price should be right-aligned (float)
- $this->assertEquals(Column::ALIGN_RIGHT, $columns[1]->getAlignment());
-
- // Date should be left-aligned
- $this->assertEquals(Column::ALIGN_LEFT, $columns[2]->getAlignment());
-
- // Active should be left-aligned (boolean treated as string by default)
- $this->assertEquals(Column::ALIGN_LEFT, $columns[3]->getAlignment());
- }
-
- /**
- * @test
- */
- public function testAutoConfigureColumnsWithMaxWidth() {
- // Create data with very long content
- $headers = ['Description'];
- $rows = [
- ['This is a very long description that should trigger max width constraints'],
- ['Another long description that exceeds normal column width limits']
- ];
-
- $tableData = new TableData($headers, $rows);
- $columns = $this->calculator->autoConfigureColumns($tableData);
-
- $this->assertCount(1, $columns);
-
- // Should have max width constraint
- $maxWidth = $columns[0]->getMaxWidth();
- $this->assertNotNull($maxWidth);
- $this->assertLessThanOrEqual(50, $maxWidth); // Should be capped at 50
- }
-
- /**
- * @test
- */
- public function testWidthDistributionWithConstraints() {
- // Test complex scenario with mixed constraints
- $this->columns[0]->setMinWidth(10);
- $this->columns[0]->setMaxWidth(20);
- $this->columns[1]->setWidth(8); // Fixed width
- $this->columns[2]->setMinWidth(15);
-
- $maxWidth = 60;
-
- $widths = $this->calculator->calculateWidths(
- $this->tableData,
- $this->columns,
- $maxWidth,
- $this->style
- );
-
- // Column 0: between 10 and 20
- $this->assertGreaterThanOrEqual(10, $widths[0]);
- $this->assertLessThanOrEqual(20, $widths[0]);
-
- // Column 1: exactly 8 (fixed)
- $this->assertEquals(8, $widths[1]);
-
- // Column 2: at least 15
- $this->assertGreaterThanOrEqual(15, $widths[2]);
- }
-
- /**
- * @test
- */
- public function testWidthCalculationWithDifferentStyles() {
- $simpleStyle = TableStyle::simple();
- $minimalStyle = TableStyle::minimal();
-
- $widthsDefault = $this->calculator->calculateWidths(
- $this->tableData,
- $this->columns,
- 80,
- $this->style
- );
-
- $widthsSimple = $this->calculator->calculateWidths(
- $this->tableData,
- $this->columns,
- 80,
- $simpleStyle
- );
-
- $widthsMinimal = $this->calculator->calculateWidths(
- $this->tableData,
- $this->columns,
- 80,
- $minimalStyle
- );
-
- // All should return valid widths
- $this->assertCount(3, $widthsDefault);
- $this->assertCount(3, $widthsSimple);
- $this->assertCount(3, $widthsMinimal);
-
- // Minimal style might allow more content width (less borders)
- $totalDefault = array_sum($widthsDefault);
- $totalMinimal = array_sum($widthsMinimal);
-
- $this->assertGreaterThanOrEqual($totalDefault, $totalMinimal);
- }
-
- /**
- * @test
- */
- public function testEdgeCaseVerySmallWidth() {
- $maxWidth = 15; // Extremely small
-
- $widths = $this->calculator->calculateWidths(
- $this->tableData,
- $this->columns,
- $maxWidth,
- $this->style
- );
-
- $this->assertIsArray($widths);
- $this->assertCount(3, $widths);
-
- // Should still provide minimum viable widths
- foreach ($widths as $width) {
- $this->assertGreaterThanOrEqual(3, $width);
- }
- }
-
- /**
- * @test
- */
- public function testWidthCalculationConsistency() {
- // Multiple calls should return consistent results
- $maxWidth = 80;
-
- $widths1 = $this->calculator->calculateWidths(
- $this->tableData,
- $this->columns,
- $maxWidth,
- $this->style
- );
-
- $widths2 = $this->calculator->calculateWidths(
- $this->tableData,
- $this->columns,
- $maxWidth,
- $this->style
- );
-
- $this->assertEquals($widths1, $widths2);
- }
-
- /**
- * @test
- */
- public function testWidthCalculationWithEmptyData() {
- $emptyData = new TableData(['A', 'B', 'C'], []);
-
- $widths = $this->calculator->calculateWidths(
- $emptyData,
- $this->columns,
- 80,
- $this->style
- );
-
- $this->assertIsArray($widths);
- $this->assertCount(3, $widths);
-
- // Should base widths on headers only
- foreach ($widths as $width) {
- $this->assertGreaterThan(0, $width);
- }
- }
-
- /**
- * @test
- */
- public function testProportionalWidthDistribution() {
- // Test that remaining width is distributed proportionally
- $maxWidth = 100;
-
- // Set one column to fixed small width
- $this->columns[1]->setWidth(5);
-
- $widths = $this->calculator->calculateWidths(
- $this->tableData,
- $this->columns,
- $maxWidth,
- $this->style
- );
-
- $this->assertEquals(5, $widths[1]);
-
- // Other columns should share remaining space
- $this->assertGreaterThan(5, $widths[0]);
- $this->assertGreaterThan(5, $widths[2]);
- }
-}
+calculator = new ColumnCalculator();
+
+ $headers = ['Name', 'Age', 'City'];
+ $rows = [
+ ['John Doe', 30, 'New York'],
+ ['Jane Smith', 25, 'Los Angeles'],
+ ['Bob Johnson', 35, 'Chicago']
+ ];
+
+ $this->tableData = new TableData($headers, $rows);
+ $this->style = TableStyle::default();
+
+ $this->columns = [
+ 0 => new Column('Name'),
+ 1 => new Column('Age'),
+ 2 => new Column('City')
+ ];
+ }
+
+ /**
+ * @test
+ */
+ public function testCalculateWidths() {
+ $maxWidth = 80;
+
+ $widths = $this->calculator->calculateWidths(
+ $this->tableData,
+ $this->columns,
+ $maxWidth,
+ $this->style
+ );
+
+ $this->assertIsArray($widths);
+ $this->assertCount(3, $widths);
+
+ // All widths should be positive integers
+ foreach ($widths as $width) {
+ $this->assertIsInt($width);
+ $this->assertGreaterThan(0, $width);
+ }
+
+ // Total width should not exceed available space
+ $totalWidth = array_sum($widths);
+ $borderWidth = $this->style->getBorderWidth(3);
+ $paddingWidth = 3 * $this->style->getTotalPadding();
+
+ $this->assertLessThanOrEqual($maxWidth - $borderWidth - $paddingWidth, $totalWidth);
+ }
+
+ /**
+ * @test
+ */
+ public function testCalculateWidthsWithFixedColumnWidth() {
+ $this->columns[0]->setWidth(20);
+ $maxWidth = 80;
+
+ $widths = $this->calculator->calculateWidths(
+ $this->tableData,
+ $this->columns,
+ $maxWidth,
+ $this->style
+ );
+
+ $this->assertEquals(20, $widths[0]);
+ }
+
+ /**
+ * @test
+ */
+ public function testCalculateWidthsWithMinWidth() {
+ $this->columns[1]->setMinWidth(15);
+ $maxWidth = 80;
+
+ $widths = $this->calculator->calculateWidths(
+ $this->tableData,
+ $this->columns,
+ $maxWidth,
+ $this->style
+ );
+
+ $this->assertGreaterThanOrEqual(15, $widths[1]);
+ }
+
+ /**
+ * @test
+ */
+ public function testCalculateWidthsWithMaxWidth() {
+ $this->columns[0]->setMaxWidth(10);
+ $maxWidth = 80;
+
+ $widths = $this->calculator->calculateWidths(
+ $this->tableData,
+ $this->columns,
+ $maxWidth,
+ $this->style
+ );
+
+ $this->assertLessThanOrEqual(10, $widths[0]);
+ }
+
+ /**
+ * @test
+ */
+ public function testCalculateWidthsEmptyColumns() {
+ $widths = $this->calculator->calculateWidths(
+ $this->tableData,
+ [],
+ 80,
+ $this->style
+ );
+
+ $this->assertIsArray($widths);
+ $this->assertEmpty($widths);
+ }
+
+ /**
+ * @test
+ */
+ public function testCalculateWidthsNarrowTerminal() {
+ $maxWidth = 30; // Very narrow
+
+ $widths = $this->calculator->calculateWidths(
+ $this->tableData,
+ $this->columns,
+ $maxWidth,
+ $this->style
+ );
+
+ $this->assertIsArray($widths);
+ $this->assertCount(3, $widths);
+
+ // Should still provide minimum widths
+ foreach ($widths as $width) {
+ $this->assertGreaterThanOrEqual(3, $width); // MIN_COLUMN_WIDTH
+ }
+ }
+
+ /**
+ * @test
+ */
+ public function testCalculateResponsiveWidths() {
+ $maxWidth = 120; // Wide terminal
+
+ $widths = $this->calculator->calculateResponsiveWidths(
+ $this->tableData,
+ $this->columns,
+ $maxWidth,
+ $this->style
+ );
+
+ $this->assertIsArray($widths);
+ $this->assertCount(3, $widths);
+
+ foreach ($widths as $width) {
+ $this->assertIsInt($width);
+ $this->assertGreaterThan(0, $width);
+ }
+ }
+
+ /**
+ * @test
+ */
+ public function testCalculateResponsiveWidthsNarrow() {
+ $maxWidth = 25; // Very narrow terminal
+
+ $widths = $this->calculator->calculateResponsiveWidths(
+ $this->tableData,
+ $this->columns,
+ $maxWidth,
+ $this->style
+ );
+
+ $this->assertIsArray($widths);
+ $this->assertCount(3, $widths);
+
+ // Should use narrow width strategy
+ foreach ($widths as $width) {
+ $this->assertGreaterThanOrEqual(3, $width);
+ }
+ }
+
+ /**
+ * @test
+ */
+ public function testAutoConfigureColumns() {
+ $columns = $this->calculator->autoConfigureColumns($this->tableData);
+
+ $this->assertIsArray($columns);
+ $this->assertCount(3, $columns);
+
+ foreach ($columns as $column) {
+ $this->assertInstanceOf(Column::class, $column);
+ }
+
+ // Age column should be right-aligned (numeric)
+ $this->assertEquals(Column::ALIGN_RIGHT, $columns[1]->getAlignment());
+
+ // Name and City should be left-aligned (string)
+ $this->assertEquals(Column::ALIGN_LEFT, $columns[0]->getAlignment());
+ $this->assertEquals(Column::ALIGN_LEFT, $columns[2]->getAlignment());
+ }
+
+ /**
+ * @test
+ */
+ public function testAutoConfigureColumnsWithDifferentTypes() {
+ $headers = ['Name', 'Price', 'Date', 'Active'];
+ $rows = [
+ ['Product A', 19.99, '2024-01-15', true],
+ ['Product B', 29.99, '2024-01-16', false]
+ ];
+
+ $tableData = new TableData($headers, $rows);
+ $columns = $this->calculator->autoConfigureColumns($tableData);
+
+ $this->assertCount(4, $columns);
+
+ // Name should be left-aligned
+ $this->assertEquals(Column::ALIGN_LEFT, $columns[0]->getAlignment());
+
+ // Price should be right-aligned (float)
+ $this->assertEquals(Column::ALIGN_RIGHT, $columns[1]->getAlignment());
+
+ // Date should be left-aligned
+ $this->assertEquals(Column::ALIGN_LEFT, $columns[2]->getAlignment());
+
+ // Active should be left-aligned (boolean treated as string by default)
+ $this->assertEquals(Column::ALIGN_LEFT, $columns[3]->getAlignment());
+ }
+
+ /**
+ * @test
+ */
+ public function testAutoConfigureColumnsWithMaxWidth() {
+ // Create data with very long content
+ $headers = ['Description'];
+ $rows = [
+ ['This is a very long description that should trigger max width constraints'],
+ ['Another long description that exceeds normal column width limits']
+ ];
+
+ $tableData = new TableData($headers, $rows);
+ $columns = $this->calculator->autoConfigureColumns($tableData);
+
+ $this->assertCount(1, $columns);
+
+ // Should have max width constraint
+ $maxWidth = $columns[0]->getMaxWidth();
+ $this->assertNotNull($maxWidth);
+ $this->assertLessThanOrEqual(50, $maxWidth); // Should be capped at 50
+ }
+
+ /**
+ * @test
+ */
+ public function testWidthDistributionWithConstraints() {
+ // Test complex scenario with mixed constraints
+ $this->columns[0]->setMinWidth(10);
+ $this->columns[0]->setMaxWidth(20);
+ $this->columns[1]->setWidth(8); // Fixed width
+ $this->columns[2]->setMinWidth(15);
+
+ $maxWidth = 60;
+
+ $widths = $this->calculator->calculateWidths(
+ $this->tableData,
+ $this->columns,
+ $maxWidth,
+ $this->style
+ );
+
+ // Column 0: between 10 and 20
+ $this->assertGreaterThanOrEqual(10, $widths[0]);
+ $this->assertLessThanOrEqual(20, $widths[0]);
+
+ // Column 1: exactly 8 (fixed)
+ $this->assertEquals(8, $widths[1]);
+
+ // Column 2: at least 15
+ $this->assertGreaterThanOrEqual(15, $widths[2]);
+ }
+
+ /**
+ * @test
+ */
+ public function testWidthCalculationWithDifferentStyles() {
+ $simpleStyle = TableStyle::simple();
+ $minimalStyle = TableStyle::minimal();
+
+ $widthsDefault = $this->calculator->calculateWidths(
+ $this->tableData,
+ $this->columns,
+ 80,
+ $this->style
+ );
+
+ $widthsSimple = $this->calculator->calculateWidths(
+ $this->tableData,
+ $this->columns,
+ 80,
+ $simpleStyle
+ );
+
+ $widthsMinimal = $this->calculator->calculateWidths(
+ $this->tableData,
+ $this->columns,
+ 80,
+ $minimalStyle
+ );
+
+ // All should return valid widths
+ $this->assertCount(3, $widthsDefault);
+ $this->assertCount(3, $widthsSimple);
+ $this->assertCount(3, $widthsMinimal);
+
+ // Minimal style might allow more content width (less borders)
+ $totalDefault = array_sum($widthsDefault);
+ $totalMinimal = array_sum($widthsMinimal);
+
+ $this->assertGreaterThanOrEqual($totalDefault, $totalMinimal);
+ }
+
+ /**
+ * @test
+ */
+ public function testEdgeCaseVerySmallWidth() {
+ $maxWidth = 15; // Extremely small
+
+ $widths = $this->calculator->calculateWidths(
+ $this->tableData,
+ $this->columns,
+ $maxWidth,
+ $this->style
+ );
+
+ $this->assertIsArray($widths);
+ $this->assertCount(3, $widths);
+
+ // Should still provide minimum viable widths
+ foreach ($widths as $width) {
+ $this->assertGreaterThanOrEqual(3, $width);
+ }
+ }
+
+ /**
+ * @test
+ */
+ public function testWidthCalculationConsistency() {
+ // Multiple calls should return consistent results
+ $maxWidth = 80;
+
+ $widths1 = $this->calculator->calculateWidths(
+ $this->tableData,
+ $this->columns,
+ $maxWidth,
+ $this->style
+ );
+
+ $widths2 = $this->calculator->calculateWidths(
+ $this->tableData,
+ $this->columns,
+ $maxWidth,
+ $this->style
+ );
+
+ $this->assertEquals($widths1, $widths2);
+ }
+
+ /**
+ * @test
+ */
+ public function testWidthCalculationWithEmptyData() {
+ $emptyData = new TableData(['A', 'B', 'C'], []);
+
+ $widths = $this->calculator->calculateWidths(
+ $emptyData,
+ $this->columns,
+ 80,
+ $this->style
+ );
+
+ $this->assertIsArray($widths);
+ $this->assertCount(3, $widths);
+
+ // Should base widths on headers only
+ foreach ($widths as $width) {
+ $this->assertGreaterThan(0, $width);
+ }
+ }
+
+ /**
+ * @test
+ */
+ public function testProportionalWidthDistribution() {
+ // Test that remaining width is distributed proportionally
+ $maxWidth = 100;
+
+ // Set one column to fixed small width
+ $this->columns[1]->setWidth(5);
+
+ $widths = $this->calculator->calculateWidths(
+ $this->tableData,
+ $this->columns,
+ $maxWidth,
+ $this->style
+ );
+
+ $this->assertEquals(5, $widths[1]);
+
+ // Other columns should share remaining space
+ $this->assertGreaterThan(5, $widths[0]);
+ $this->assertGreaterThan(5, $widths[2]);
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/Table/ColumnTest.php b/tests/WebFiori/Tests/Cli/Table/ColumnTest.php
index a457bef..f55a921 100644
--- a/tests/WebFiori/Tests/Cli/Table/ColumnTest.php
+++ b/tests/WebFiori/Tests/Cli/Table/ColumnTest.php
@@ -1,411 +1,411 @@
-column = new Column('Test Column');
- }
-
- /**
- * @test
- */
- public function testConstructor() {
- $column = new Column('Test Name');
-
- $this->assertEquals('Test Name', $column->getName());
- $this->assertEquals(Column::ALIGN_AUTO, $column->getAlignment());
- $this->assertTrue($column->shouldTruncate());
- $this->assertTrue($column->isVisible());
- }
-
- /**
- * @test
- */
- public function testConfigure() {
- $config = [
- 'width' => 20,
- 'align' => Column::ALIGN_RIGHT,
- 'truncate' => false,
- 'ellipsis' => '...',
- 'visible' => false,
- 'default' => 'N/A'
- ];
-
- $result = $this->column->configure($config);
-
- $this->assertSame($this->column, $result); // Fluent interface
- $this->assertEquals(20, $this->column->getWidth());
- $this->assertEquals(Column::ALIGN_RIGHT, $this->column->getAlignment());
- $this->assertFalse($this->column->shouldTruncate());
- $this->assertEquals('...', $this->column->getEllipsis());
- $this->assertFalse($this->column->isVisible());
- $this->assertEquals('N/A', $this->column->getDefaultValue());
- }
-
- /**
- * @test
- */
- public function testConfigureWithUnderscoreKeys() {
- $config = [
- 'min_width' => 10,
- 'max_width' => 50,
- 'word_wrap' => true,
- 'default_value' => 'Empty'
- ];
-
- $this->column->configure($config);
-
- $this->assertEquals(10, $this->column->getMinWidth());
- $this->assertEquals(50, $this->column->getMaxWidth());
- $this->assertTrue($this->column->shouldWordWrap());
- $this->assertEquals('Empty', $this->column->getDefaultValue());
- }
-
- /**
- * @test
- */
- public function testSetWidth() {
- $result = $this->column->setWidth(25);
-
- $this->assertSame($this->column, $result);
- $this->assertEquals(25, $this->column->getWidth());
- }
-
- /**
- * @test
- */
- public function testSetMinWidth() {
- $result = $this->column->setMinWidth(5);
-
- $this->assertSame($this->column, $result);
- $this->assertEquals(5, $this->column->getMinWidth());
- }
-
- /**
- * @test
- */
- public function testSetMaxWidth() {
- $result = $this->column->setMaxWidth(100);
-
- $this->assertSame($this->column, $result);
- $this->assertEquals(100, $this->column->getMaxWidth());
- }
-
- /**
- * @test
- */
- public function testSetAlignment() {
- $result = $this->column->setAlignment(Column::ALIGN_CENTER);
-
- $this->assertSame($this->column, $result);
- $this->assertEquals(Column::ALIGN_CENTER, $this->column->getAlignment());
- }
-
- /**
- * @test
- */
- public function testSetAlignmentInvalid() {
- $this->column->setAlignment('invalid');
-
- // Should remain unchanged
- $this->assertEquals(Column::ALIGN_AUTO, $this->column->getAlignment());
- }
-
- /**
- * @test
- */
- public function testSetFormatter() {
- $formatter = fn($value) => strtoupper($value);
- $result = $this->column->setFormatter($formatter);
-
- $this->assertSame($this->column, $result);
- $this->assertSame($formatter, $this->column->getFormatter());
- }
-
- /**
- * @test
- */
- public function testSetColorizer() {
- $colorizer = fn($value) => ['color' => 'red'];
- $result = $this->column->setColorizer($colorizer);
-
- $this->assertSame($this->column, $result);
- $this->assertSame($colorizer, $this->column->getColorizer());
- }
-
- /**
- * @test
- */
- public function testSetDefaultValue() {
- $result = $this->column->setDefaultValue('Default');
-
- $this->assertSame($this->column, $result);
- $this->assertEquals('Default', $this->column->getDefaultValue());
- }
-
- /**
- * @test
- */
- public function testSetVisible() {
- $result = $this->column->setVisible(false);
-
- $this->assertSame($this->column, $result);
- $this->assertFalse($this->column->isVisible());
- }
-
- /**
- * @test
- */
- public function testSetMetadata() {
- $result = $this->column->setMetadata('custom_key', 'custom_value');
-
- $this->assertSame($this->column, $result);
- $this->assertEquals('custom_value', $this->column->getMetadata('custom_key'));
- }
-
- /**
- * @test
- */
- public function testGetMetadataWithDefault() {
- $this->assertEquals('default', $this->column->getMetadata('nonexistent', 'default'));
- }
-
- /**
- * @test
- */
- public function testGetAllMetadata() {
- $this->column->setMetadata('key1', 'value1');
- $this->column->setMetadata('key2', 'value2');
-
- $metadata = $this->column->getAllMetadata();
-
- $this->assertIsArray($metadata);
- $this->assertEquals('value1', $metadata['key1']);
- $this->assertEquals('value2', $metadata['key2']);
- }
-
- /**
- * @test
- */
- public function testCalculateIdealWidth() {
- $this->column->setMinWidth(5);
- $this->column->setMaxWidth(20);
-
- $values = ['Short', 'Medium length', 'Very long text that exceeds normal width'];
- $width = $this->column->calculateIdealWidth($values);
-
- $this->assertIsInt($width);
- $this->assertGreaterThanOrEqual(5, $width); // At least min width
- $this->assertLessThanOrEqual(20, $width); // At most max width
- }
-
- /**
- * @test
- */
- public function testFormatValue() {
- $this->assertEquals('test', $this->column->formatValue('test'));
- $this->assertEquals('', $this->column->formatValue(null));
- $this->assertEquals('', $this->column->formatValue(''));
- }
-
- /**
- * @test
- */
- public function testFormatValueWithDefault() {
- $this->column->setDefaultValue('N/A');
-
- $this->assertEquals('N/A', $this->column->formatValue(null));
- $this->assertEquals('N/A', $this->column->formatValue(''));
- $this->assertEquals('test', $this->column->formatValue('test'));
- }
-
- /**
- * @test
- */
- public function testFormatValueWithFormatter() {
- $this->column->setFormatter(fn($value) => strtoupper($value));
-
- $this->assertEquals('TEST', $this->column->formatValue('test'));
- }
-
- /**
- * @test
- */
- public function testColorizeValue() {
- $this->assertEquals('test', $this->column->colorizeValue('test'));
- }
-
- /**
- * @test
- */
- public function testColorizeValueWithColorizer() {
- $this->column->setColorizer(fn($value) => ['color' => 'red']);
-
- $result = $this->column->colorizeValue('test');
-
- $this->assertStringContainsString('test', $result);
- $this->assertStringContainsString("\x1b[", $result); // ANSI escape sequence
- }
-
- /**
- * @test
- */
- public function testTruncateText() {
- $this->column->setTruncate(true);
- $this->column->setEllipsis('...');
-
- $result = $this->column->truncateText('This is a very long text', 10);
-
- $this->assertLessThanOrEqual(10, strlen($result));
- $this->assertStringContainsString('...', $result);
- }
-
- /**
- * @test
- */
- public function testTruncateTextDisabled() {
- $this->column->setTruncate(false);
-
- $text = 'This is a very long text';
- $result = $this->column->truncateText($text, 10);
-
- $this->assertEquals($text, $result);
- }
-
- /**
- * @test
- */
- public function testAlignTextLeft() {
- $this->column->setAlignment(Column::ALIGN_LEFT);
-
- $result = $this->column->alignText('test', 10);
-
- $this->assertEquals('test ', $result);
- }
-
- /**
- * @test
- */
- public function testAlignTextRight() {
- $this->column->setAlignment(Column::ALIGN_RIGHT);
-
- $result = $this->column->alignText('test', 10);
-
- $this->assertEquals(' test', $result);
- }
-
- /**
- * @test
- */
- public function testAlignTextCenter() {
- $this->column->setAlignment(Column::ALIGN_CENTER);
-
- $result = $this->column->alignText('test', 10);
-
- $this->assertEquals(' test ', $result);
- }
-
- /**
- * @test
- */
- public function testAlignTextAuto() {
- $this->column->setAlignment(Column::ALIGN_AUTO);
-
- // Text should be left-aligned
- $textResult = $this->column->alignText('text', 10);
- $this->assertEquals('text ', $textResult);
-
- // Numbers should be right-aligned
- $numberResult = $this->column->alignText('123', 10);
- $this->assertEquals(' 123', $numberResult);
- }
-
- /**
- * @test
- */
- public function testStaticCreateMethods() {
- $column = Column::create('Test');
- $this->assertInstanceOf(Column::class, $column);
- $this->assertEquals('Test', $column->getName());
-
- $leftColumn = Column::left('Left', 20);
- $this->assertEquals(Column::ALIGN_LEFT, $leftColumn->getAlignment());
- $this->assertEquals(20, $leftColumn->getWidth());
-
- $rightColumn = Column::right('Right', 15);
- $this->assertEquals(Column::ALIGN_RIGHT, $rightColumn->getAlignment());
- $this->assertEquals(15, $rightColumn->getWidth());
-
- $centerColumn = Column::center('Center', 25);
- $this->assertEquals(Column::ALIGN_CENTER, $centerColumn->getAlignment());
- $this->assertEquals(25, $centerColumn->getWidth());
- }
-
- /**
- * @test
- */
- public function testNumericColumn() {
- $column = Column::numeric('Price', 10, 2);
-
- $this->assertEquals(Column::ALIGN_RIGHT, $column->getAlignment());
- $this->assertEquals(10, $column->getWidth());
-
- $formatter = $column->getFormatter();
- $this->assertIsCallable($formatter);
-
- $result = $formatter(1234.567);
- $this->assertEquals('1,234.57', $result);
- }
-
- /**
- * @test
- */
- public function testDateColumn() {
- $column = Column::date('Created', 12, 'Y-m-d');
-
- $this->assertEquals(Column::ALIGN_LEFT, $column->getAlignment());
- $this->assertEquals(12, $column->getWidth());
-
- $formatter = $column->getFormatter();
- $this->assertIsCallable($formatter);
-
- $result = $formatter('2024-01-15 10:30:00');
- $this->assertEquals('2024-01-15', $result);
- }
-
- /**
- * @test
- */
- public function testDateColumnWithInvalidDate() {
- $column = Column::date('Created');
- $formatter = $column->getFormatter();
-
- $result = $formatter('invalid-date');
- $this->assertEquals('invalid-date', $result);
- }
-
- /**
- * @test
- */
- public function testConstants() {
- $this->assertEquals('left', Column::ALIGN_LEFT);
- $this->assertEquals('right', Column::ALIGN_RIGHT);
- $this->assertEquals('center', Column::ALIGN_CENTER);
- $this->assertEquals('auto', Column::ALIGN_AUTO);
- }
-}
+column = new Column('Test Column');
+ }
+
+ /**
+ * @test
+ */
+ public function testConstructor() {
+ $column = new Column('Test Name');
+
+ $this->assertEquals('Test Name', $column->getName());
+ $this->assertEquals(Column::ALIGN_AUTO, $column->getAlignment());
+ $this->assertTrue($column->shouldTruncate());
+ $this->assertTrue($column->isVisible());
+ }
+
+ /**
+ * @test
+ */
+ public function testConfigure() {
+ $config = [
+ 'width' => 20,
+ 'align' => Column::ALIGN_RIGHT,
+ 'truncate' => false,
+ 'ellipsis' => '...',
+ 'visible' => false,
+ 'default' => 'N/A'
+ ];
+
+ $result = $this->column->configure($config);
+
+ $this->assertSame($this->column, $result); // Fluent interface
+ $this->assertEquals(20, $this->column->getWidth());
+ $this->assertEquals(Column::ALIGN_RIGHT, $this->column->getAlignment());
+ $this->assertFalse($this->column->shouldTruncate());
+ $this->assertEquals('...', $this->column->getEllipsis());
+ $this->assertFalse($this->column->isVisible());
+ $this->assertEquals('N/A', $this->column->getDefaultValue());
+ }
+
+ /**
+ * @test
+ */
+ public function testConfigureWithUnderscoreKeys() {
+ $config = [
+ 'min_width' => 10,
+ 'max_width' => 50,
+ 'word_wrap' => true,
+ 'default_value' => 'Empty'
+ ];
+
+ $this->column->configure($config);
+
+ $this->assertEquals(10, $this->column->getMinWidth());
+ $this->assertEquals(50, $this->column->getMaxWidth());
+ $this->assertTrue($this->column->shouldWordWrap());
+ $this->assertEquals('Empty', $this->column->getDefaultValue());
+ }
+
+ /**
+ * @test
+ */
+ public function testSetWidth() {
+ $result = $this->column->setWidth(25);
+
+ $this->assertSame($this->column, $result);
+ $this->assertEquals(25, $this->column->getWidth());
+ }
+
+ /**
+ * @test
+ */
+ public function testSetMinWidth() {
+ $result = $this->column->setMinWidth(5);
+
+ $this->assertSame($this->column, $result);
+ $this->assertEquals(5, $this->column->getMinWidth());
+ }
+
+ /**
+ * @test
+ */
+ public function testSetMaxWidth() {
+ $result = $this->column->setMaxWidth(100);
+
+ $this->assertSame($this->column, $result);
+ $this->assertEquals(100, $this->column->getMaxWidth());
+ }
+
+ /**
+ * @test
+ */
+ public function testSetAlignment() {
+ $result = $this->column->setAlignment(Column::ALIGN_CENTER);
+
+ $this->assertSame($this->column, $result);
+ $this->assertEquals(Column::ALIGN_CENTER, $this->column->getAlignment());
+ }
+
+ /**
+ * @test
+ */
+ public function testSetAlignmentInvalid() {
+ $this->column->setAlignment('invalid');
+
+ // Should remain unchanged
+ $this->assertEquals(Column::ALIGN_AUTO, $this->column->getAlignment());
+ }
+
+ /**
+ * @test
+ */
+ public function testSetFormatter() {
+ $formatter = fn($value) => strtoupper($value);
+ $result = $this->column->setFormatter($formatter);
+
+ $this->assertSame($this->column, $result);
+ $this->assertSame($formatter, $this->column->getFormatter());
+ }
+
+ /**
+ * @test
+ */
+ public function testSetColorizer() {
+ $colorizer = fn($value) => ['color' => 'red'];
+ $result = $this->column->setColorizer($colorizer);
+
+ $this->assertSame($this->column, $result);
+ $this->assertSame($colorizer, $this->column->getColorizer());
+ }
+
+ /**
+ * @test
+ */
+ public function testSetDefaultValue() {
+ $result = $this->column->setDefaultValue('Default');
+
+ $this->assertSame($this->column, $result);
+ $this->assertEquals('Default', $this->column->getDefaultValue());
+ }
+
+ /**
+ * @test
+ */
+ public function testSetVisible() {
+ $result = $this->column->setVisible(false);
+
+ $this->assertSame($this->column, $result);
+ $this->assertFalse($this->column->isVisible());
+ }
+
+ /**
+ * @test
+ */
+ public function testSetMetadata() {
+ $result = $this->column->setMetadata('custom_key', 'custom_value');
+
+ $this->assertSame($this->column, $result);
+ $this->assertEquals('custom_value', $this->column->getMetadata('custom_key'));
+ }
+
+ /**
+ * @test
+ */
+ public function testGetMetadataWithDefault() {
+ $this->assertEquals('default', $this->column->getMetadata('nonexistent', 'default'));
+ }
+
+ /**
+ * @test
+ */
+ public function testGetAllMetadata() {
+ $this->column->setMetadata('key1', 'value1');
+ $this->column->setMetadata('key2', 'value2');
+
+ $metadata = $this->column->getAllMetadata();
+
+ $this->assertIsArray($metadata);
+ $this->assertEquals('value1', $metadata['key1']);
+ $this->assertEquals('value2', $metadata['key2']);
+ }
+
+ /**
+ * @test
+ */
+ public function testCalculateIdealWidth() {
+ $this->column->setMinWidth(5);
+ $this->column->setMaxWidth(20);
+
+ $values = ['Short', 'Medium length', 'Very long text that exceeds normal width'];
+ $width = $this->column->calculateIdealWidth($values);
+
+ $this->assertIsInt($width);
+ $this->assertGreaterThanOrEqual(5, $width); // At least min width
+ $this->assertLessThanOrEqual(20, $width); // At most max width
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatValue() {
+ $this->assertEquals('test', $this->column->formatValue('test'));
+ $this->assertEquals('', $this->column->formatValue(null));
+ $this->assertEquals('', $this->column->formatValue(''));
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatValueWithDefault() {
+ $this->column->setDefaultValue('N/A');
+
+ $this->assertEquals('N/A', $this->column->formatValue(null));
+ $this->assertEquals('N/A', $this->column->formatValue(''));
+ $this->assertEquals('test', $this->column->formatValue('test'));
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatValueWithFormatter() {
+ $this->column->setFormatter(fn($value) => strtoupper($value));
+
+ $this->assertEquals('TEST', $this->column->formatValue('test'));
+ }
+
+ /**
+ * @test
+ */
+ public function testColorizeValue() {
+ $this->assertEquals('test', $this->column->colorizeValue('test'));
+ }
+
+ /**
+ * @test
+ */
+ public function testColorizeValueWithColorizer() {
+ $this->column->setColorizer(fn($value) => ['color' => 'red']);
+
+ $result = $this->column->colorizeValue('test');
+
+ $this->assertStringContainsString('test', $result);
+ $this->assertStringContainsString("\x1b[", $result); // ANSI escape sequence
+ }
+
+ /**
+ * @test
+ */
+ public function testTruncateText() {
+ $this->column->setTruncate(true);
+ $this->column->setEllipsis('...');
+
+ $result = $this->column->truncateText('This is a very long text', 10);
+
+ $this->assertLessThanOrEqual(10, strlen($result));
+ $this->assertStringContainsString('...', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testTruncateTextDisabled() {
+ $this->column->setTruncate(false);
+
+ $text = 'This is a very long text';
+ $result = $this->column->truncateText($text, 10);
+
+ $this->assertEquals($text, $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testAlignTextLeft() {
+ $this->column->setAlignment(Column::ALIGN_LEFT);
+
+ $result = $this->column->alignText('test', 10);
+
+ $this->assertEquals('test ', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testAlignTextRight() {
+ $this->column->setAlignment(Column::ALIGN_RIGHT);
+
+ $result = $this->column->alignText('test', 10);
+
+ $this->assertEquals(' test', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testAlignTextCenter() {
+ $this->column->setAlignment(Column::ALIGN_CENTER);
+
+ $result = $this->column->alignText('test', 10);
+
+ $this->assertEquals(' test ', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testAlignTextAuto() {
+ $this->column->setAlignment(Column::ALIGN_AUTO);
+
+ // Text should be left-aligned
+ $textResult = $this->column->alignText('text', 10);
+ $this->assertEquals('text ', $textResult);
+
+ // Numbers should be right-aligned
+ $numberResult = $this->column->alignText('123', 10);
+ $this->assertEquals(' 123', $numberResult);
+ }
+
+ /**
+ * @test
+ */
+ public function testStaticCreateMethods() {
+ $column = Column::create('Test');
+ $this->assertInstanceOf(Column::class, $column);
+ $this->assertEquals('Test', $column->getName());
+
+ $leftColumn = Column::left('Left', 20);
+ $this->assertEquals(Column::ALIGN_LEFT, $leftColumn->getAlignment());
+ $this->assertEquals(20, $leftColumn->getWidth());
+
+ $rightColumn = Column::right('Right', 15);
+ $this->assertEquals(Column::ALIGN_RIGHT, $rightColumn->getAlignment());
+ $this->assertEquals(15, $rightColumn->getWidth());
+
+ $centerColumn = Column::center('Center', 25);
+ $this->assertEquals(Column::ALIGN_CENTER, $centerColumn->getAlignment());
+ $this->assertEquals(25, $centerColumn->getWidth());
+ }
+
+ /**
+ * @test
+ */
+ public function testNumericColumn() {
+ $column = Column::numeric('Price', 10, 2);
+
+ $this->assertEquals(Column::ALIGN_RIGHT, $column->getAlignment());
+ $this->assertEquals(10, $column->getWidth());
+
+ $formatter = $column->getFormatter();
+ $this->assertIsCallable($formatter);
+
+ $result = $formatter(1234.567);
+ $this->assertEquals('1,234.57', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testDateColumn() {
+ $column = Column::date('Created', 12, 'Y-m-d');
+
+ $this->assertEquals(Column::ALIGN_LEFT, $column->getAlignment());
+ $this->assertEquals(12, $column->getWidth());
+
+ $formatter = $column->getFormatter();
+ $this->assertIsCallable($formatter);
+
+ $result = $formatter('2024-01-15 10:30:00');
+ $this->assertEquals('2024-01-15', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testDateColumnWithInvalidDate() {
+ $column = Column::date('Created');
+ $formatter = $column->getFormatter();
+
+ $result = $formatter('invalid-date');
+ $this->assertEquals('invalid-date', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testConstants() {
+ $this->assertEquals('left', Column::ALIGN_LEFT);
+ $this->assertEquals('right', Column::ALIGN_RIGHT);
+ $this->assertEquals('center', Column::ALIGN_CENTER);
+ $this->assertEquals('auto', Column::ALIGN_AUTO);
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/Table/README.md b/tests/WebFiori/Tests/Cli/Table/README.md
index 8dacbba..ecd6fcf 100644
--- a/tests/WebFiori/Tests/Cli/Table/README.md
+++ b/tests/WebFiori/Tests/Cli/Table/README.md
@@ -1,241 +1,241 @@
-# WebFiori CLI Table Feature - Unit Tests
-
-Comprehensive unit test suite for the WebFiori CLI Table feature, providing thorough coverage of all classes and functionality.
-
-## ๐ฏ Test Coverage
-
-### Core Classes Tested
-
-| Class | Test File | Test Count | Coverage Areas |
-|-------|-----------|------------|----------------|
-| **TableBuilder** | `TableBuilderTest.php` | 25+ tests | Fluent interface, data management, rendering |
-| **TableStyle** | `TableStyleTest.php` | 20+ tests | Style definitions, predefined styles, customization |
-| **Column** | `ColumnTest.php` | 30+ tests | Configuration, formatting, alignment, content processing |
-| **TableData** | `TableDataTest.php` | 35+ tests | Data container, type detection, statistics, export |
-| **TableFormatter** | `TableFormatterTest.php` | 25+ tests | Content formatting, data types, custom formatters |
-| **TableTheme** | `TableThemeTest.php` | 20+ tests | Color schemes, theming, ANSI color application |
-| **ColumnCalculator** | `ColumnCalculatorTest.php` | 15+ tests | Width calculations, responsive design, optimization |
-| **TableRenderer** | `TableRendererTest.php` | 20+ tests | Rendering engine, output generation, visual formatting |
-
-### Total Test Coverage
-- **190+ individual test methods**
-- **8 test classes** covering all core functionality
-- **100% class coverage** of the table feature
-- **Edge cases and error conditions** thoroughly tested
-
-## ๐ Running Tests
-
-### Quick Test Run
-```bash
-# Run all table tests
-cd tests/WebFiori/Cli/Table
-php run-tests.php
-```
-
-### Using PHPUnit Directly
-```bash
-# Run with PHPUnit configuration
-phpunit --configuration phpunit.xml
-
-# Run specific test class
-phpunit TableBuilderTest.php
-
-# Run with coverage report
-phpunit --configuration phpunit.xml --coverage-html coverage-html
-```
-
-### Individual Test Classes
-```bash
-# Test specific functionality
-php -f TableBuilderTest.php # Main interface tests
-php -f TableStyleTest.php # Style system tests
-php -f ColumnTest.php # Column configuration tests
-php -f TableDataTest.php # Data management tests
-php -f TableFormatterTest.php # Content formatting tests
-php -f TableThemeTest.php # Color theme tests
-php -f ColumnCalculatorTest.php # Width calculation tests
-php -f TableRendererTest.php # Rendering engine tests
-```
-
-## ๐ Test Categories
-
-### 1. TableBuilder Tests
-- โ **Fluent Interface** - Method chaining and return values
-- โ **Data Management** - Headers, rows, data setting
-- โ **Configuration** - Column setup, styling, theming
-- โ **Rendering** - Output generation and display
-- โ **Edge Cases** - Empty tables, invalid data
-
-### 2. TableStyle Tests
-- โ **Predefined Styles** - All 8+ built-in styles
-- โ **Custom Styles** - User-defined styling options
-- โ **Style Properties** - Border characters, padding, flags
-- โ **Unicode Support** - Character detection and fallbacks
-- โ **Border Calculations** - Width and spacing calculations
-
-### 3. Column Tests
-- โ **Configuration** - Width, alignment, visibility settings
-- โ **Content Processing** - Formatting, truncation, alignment
-- โ **Data Types** - Numeric, date, boolean column types
-- โ **Custom Formatters** - User-defined formatting functions
-- โ **Color Application** - Status-based colorization
-- โ **Static Factories** - Convenience creation methods
-
-### 4. TableData Tests
-- โ **Data Container** - Storage and retrieval functionality
-- โ **Type Detection** - Automatic data type identification
-- โ **Statistics** - Column analysis and metrics
-- โ **Data Operations** - Filtering, sorting, transformation
-- โ **Export Formats** - JSON, CSV, array conversions
-- โ **Import Methods** - Creating from various data sources
-
-### 5. TableFormatter Tests
-- โ **Content Formatting** - Header and cell processing
-- โ **Data Type Handling** - Numbers, dates, booleans, etc.
-- โ **Custom Formatters** - Registration and application
-- โ **Built-in Formatters** - Currency, percentage, file size
-- โ **Text Processing** - Truncation and smart formatting
-
-### 6. TableTheme Tests
-- โ **Color Schemes** - Predefined theme variations
-- โ **ANSI Colors** - Color code generation and application
-- โ **Theme Configuration** - Custom color setups
-- โ **Style Application** - Header and cell styling
-- โ **Status Colors** - Conditional color application
-
-### 7. ColumnCalculator Tests
-- โ **Width Calculations** - Optimal column sizing
-- โ **Responsive Design** - Terminal width adaptation
-- โ **Constraint Handling** - Min/max width enforcement
-- โ **Auto Configuration** - Intelligent column setup
-- โ **Edge Cases** - Narrow terminals, large datasets
-
-### 8. TableRenderer Tests
-- โ **Rendering Engine** - Complete table generation
-- โ **Style Integration** - Visual formatting application
-- โ **Theme Integration** - Color and styling application
-- โ **Output Structure** - Border generation, alignment
-- โ **Content Processing** - Data formatting and display
-
-## ๐ Test Quality Assurance
-
-### Test Principles
-- **Comprehensive Coverage** - All public methods tested
-- **Edge Case Handling** - Invalid inputs, boundary conditions
-- **Integration Testing** - Component interaction verification
-- **Performance Awareness** - Efficient test execution
-- **Maintainability** - Clear, readable test code
-
-### Test Data
-- **Realistic Datasets** - Real-world data scenarios
-- **Edge Cases** - Empty data, null values, extreme sizes
-- **Type Variations** - Different data types and formats
-- **Unicode Content** - International characters and symbols
-- **Large Datasets** - Performance and memory testing
-
-### Assertions
-- **Functional Correctness** - Expected behavior verification
-- **Type Safety** - Return type and parameter validation
-- **State Consistency** - Object state after operations
-- **Output Quality** - Generated content verification
-- **Error Handling** - Exception and error conditions
-
-## ๐ Test Results Example
-
-```
-๐งช WebFiori CLI Table Feature - Unit Test Suite
-===============================================
-
-Adding test class: TableBuilder (Main Interface)
-Adding test class: TableStyle (Visual Styling)
-Adding test class: Column (Column Configuration)
-Adding test class: TableData (Data Management)
-Adding test class: TableFormatter (Content Formatting)
-Adding test class: TableTheme (Color Themes)
-Adding test class: ColumnCalculator (Width Calculations)
-Adding test class: TableRenderer (Rendering Engine)
-
-๐ Running Tests...
-==================
-
-PHPUnit 9.5.x by Sebastian Bergmann and contributors.
-
-........................................................................ 72 / 190 ( 37%)
-........................................................................ 144 / 190 ( 75%)
-.............................................. 190 / 190 (100%)
-
-Time: 00:02.543, Memory: 12.00 MB
-
-OK (190 tests, 450 assertions)
-
-๐ Test Summary
-===============
-Tests Run: 190
-Failures: 0
-Errors: 0
-Skipped: 0
-Warnings: 0
-
-โ All tests passed successfully!
-๐ WebFiori CLI Table feature is working correctly.
-```
-
-## ๐ ๏ธ Development Workflow
-
-### Adding New Tests
-1. **Create test method** with descriptive name
-2. **Follow naming convention** - `testMethodName()`
-3. **Use @test annotation** for clarity
-4. **Include setup/teardown** as needed
-5. **Add comprehensive assertions**
-
-### Test Method Template
-```php
-/**
- * @test
- */
-public function testSpecificFunctionality() {
- // Arrange
- $input = 'test data';
- $expected = 'expected result';
-
- // Act
- $result = $this->objectUnderTest->methodToTest($input);
-
- // Assert
- $this->assertEquals($expected, $result);
- $this->assertInstanceOf(ExpectedClass::class, $result);
-}
-```
-
-### Best Practices
-- **One concept per test** - Focus on single functionality
-- **Descriptive names** - Clear test purpose
-- **Arrange-Act-Assert** - Structured test organization
-- **Independent tests** - No test dependencies
-- **Fast execution** - Efficient test implementation
-
-## ๐ง Continuous Integration
-
-### Automated Testing
-- **Pre-commit hooks** - Run tests before commits
-- **CI/CD integration** - Automated test execution
-- **Coverage reporting** - Track test coverage metrics
-- **Performance monitoring** - Test execution time tracking
-
-### Quality Gates
-- **100% test pass rate** - All tests must pass
-- **Minimum coverage** - Maintain high coverage levels
-- **Performance benchmarks** - Test execution time limits
-- **Code quality** - Static analysis integration
-
-## ๐ Additional Resources
-
-- **PHPUnit Documentation** - [https://phpunit.de/documentation.html](https://phpunit.de/documentation.html)
-- **WebFiori CLI Guide** - Main project documentation
-- **Table Feature Documentation** - `WebFiori/CLI/Table/README.md`
-- **Example Usage** - `examples/15-table-display/`
-
----
-
-This comprehensive test suite ensures the WebFiori CLI Table feature is robust, reliable, and ready for production use.
+# WebFiori CLI Table Feature - Unit Tests
+
+Comprehensive unit test suite for the WebFiori CLI Table feature, providing thorough coverage of all classes and functionality.
+
+## ๐ฏ Test Coverage
+
+### Core Classes Tested
+
+| Class | Test File | Test Count | Coverage Areas |
+|-------|-----------|------------|----------------|
+| **TableBuilder** | `TableBuilderTest.php` | 25+ tests | Fluent interface, data management, rendering |
+| **TableStyle** | `TableStyleTest.php` | 20+ tests | Style definitions, predefined styles, customization |
+| **Column** | `ColumnTest.php` | 30+ tests | Configuration, formatting, alignment, content processing |
+| **TableData** | `TableDataTest.php` | 35+ tests | Data container, type detection, statistics, export |
+| **TableFormatter** | `TableFormatterTest.php` | 25+ tests | Content formatting, data types, custom formatters |
+| **TableTheme** | `TableThemeTest.php` | 20+ tests | Color schemes, theming, ANSI color application |
+| **ColumnCalculator** | `ColumnCalculatorTest.php` | 15+ tests | Width calculations, responsive design, optimization |
+| **TableRenderer** | `TableRendererTest.php` | 20+ tests | Rendering engine, output generation, visual formatting |
+
+### Total Test Coverage
+- **190+ individual test methods**
+- **8 test classes** covering all core functionality
+- **100% class coverage** of the table feature
+- **Edge cases and error conditions** thoroughly tested
+
+## ๐ Running Tests
+
+### Quick Test Run
+```bash
+# Run all table tests
+cd tests/WebFiori/Cli/Table
+php run-tests.php
+```
+
+### Using PHPUnit Directly
+```bash
+# Run with PHPUnit configuration
+phpunit --configuration phpunit.xml
+
+# Run specific test class
+phpunit TableBuilderTest.php
+
+# Run with coverage report
+phpunit --configuration phpunit.xml --coverage-html coverage-html
+```
+
+### Individual Test Classes
+```bash
+# Test specific functionality
+php -f TableBuilderTest.php # Main interface tests
+php -f TableStyleTest.php # Style system tests
+php -f ColumnTest.php # Column configuration tests
+php -f TableDataTest.php # Data management tests
+php -f TableFormatterTest.php # Content formatting tests
+php -f TableThemeTest.php # Color theme tests
+php -f ColumnCalculatorTest.php # Width calculation tests
+php -f TableRendererTest.php # Rendering engine tests
+```
+
+## ๐ Test Categories
+
+### 1. TableBuilder Tests
+- โ **Fluent Interface** - Method chaining and return values
+- โ **Data Management** - Headers, rows, data setting
+- โ **Configuration** - Column setup, styling, theming
+- โ **Rendering** - Output generation and display
+- โ **Edge Cases** - Empty tables, invalid data
+
+### 2. TableStyle Tests
+- โ **Predefined Styles** - All 8+ built-in styles
+- โ **Custom Styles** - User-defined styling options
+- โ **Style Properties** - Border characters, padding, flags
+- โ **Unicode Support** - Character detection and fallbacks
+- โ **Border Calculations** - Width and spacing calculations
+
+### 3. Column Tests
+- โ **Configuration** - Width, alignment, visibility settings
+- โ **Content Processing** - Formatting, truncation, alignment
+- โ **Data Types** - Numeric, date, boolean column types
+- โ **Custom Formatters** - User-defined formatting functions
+- โ **Color Application** - Status-based colorization
+- โ **Static Factories** - Convenience creation methods
+
+### 4. TableData Tests
+- โ **Data Container** - Storage and retrieval functionality
+- โ **Type Detection** - Automatic data type identification
+- โ **Statistics** - Column analysis and metrics
+- โ **Data Operations** - Filtering, sorting, transformation
+- โ **Export Formats** - JSON, CSV, array conversions
+- โ **Import Methods** - Creating from various data sources
+
+### 5. TableFormatter Tests
+- โ **Content Formatting** - Header and cell processing
+- โ **Data Type Handling** - Numbers, dates, booleans, etc.
+- โ **Custom Formatters** - Registration and application
+- โ **Built-in Formatters** - Currency, percentage, file size
+- โ **Text Processing** - Truncation and smart formatting
+
+### 6. TableTheme Tests
+- โ **Color Schemes** - Predefined theme variations
+- โ **ANSI Colors** - Color code generation and application
+- โ **Theme Configuration** - Custom color setups
+- โ **Style Application** - Header and cell styling
+- โ **Status Colors** - Conditional color application
+
+### 7. ColumnCalculator Tests
+- โ **Width Calculations** - Optimal column sizing
+- โ **Responsive Design** - Terminal width adaptation
+- โ **Constraint Handling** - Min/max width enforcement
+- โ **Auto Configuration** - Intelligent column setup
+- โ **Edge Cases** - Narrow terminals, large datasets
+
+### 8. TableRenderer Tests
+- โ **Rendering Engine** - Complete table generation
+- โ **Style Integration** - Visual formatting application
+- โ **Theme Integration** - Color and styling application
+- โ **Output Structure** - Border generation, alignment
+- โ **Content Processing** - Data formatting and display
+
+## ๐ Test Quality Assurance
+
+### Test Principles
+- **Comprehensive Coverage** - All public methods tested
+- **Edge Case Handling** - Invalid inputs, boundary conditions
+- **Integration Testing** - Component interaction verification
+- **Performance Awareness** - Efficient test execution
+- **Maintainability** - Clear, readable test code
+
+### Test Data
+- **Realistic Datasets** - Real-world data scenarios
+- **Edge Cases** - Empty data, null values, extreme sizes
+- **Type Variations** - Different data types and formats
+- **Unicode Content** - International characters and symbols
+- **Large Datasets** - Performance and memory testing
+
+### Assertions
+- **Functional Correctness** - Expected behavior verification
+- **Type Safety** - Return type and parameter validation
+- **State Consistency** - Object state after operations
+- **Output Quality** - Generated content verification
+- **Error Handling** - Exception and error conditions
+
+## ๐ Test Results Example
+
+```
+๐งช WebFiori CLI Table Feature - Unit Test Suite
+===============================================
+
+Adding test class: TableBuilder (Main Interface)
+Adding test class: TableStyle (Visual Styling)
+Adding test class: Column (Column Configuration)
+Adding test class: TableData (Data Management)
+Adding test class: TableFormatter (Content Formatting)
+Adding test class: TableTheme (Color Themes)
+Adding test class: ColumnCalculator (Width Calculations)
+Adding test class: TableRenderer (Rendering Engine)
+
+๐ Running Tests...
+==================
+
+PHPUnit 9.5.x by Sebastian Bergmann and contributors.
+
+........................................................................ 72 / 190 ( 37%)
+........................................................................ 144 / 190 ( 75%)
+.............................................. 190 / 190 (100%)
+
+Time: 00:02.543, Memory: 12.00 MB
+
+OK (190 tests, 450 assertions)
+
+๐ Test Summary
+===============
+Tests Run: 190
+Failures: 0
+Errors: 0
+Skipped: 0
+Warnings: 0
+
+โ All tests passed successfully!
+๐ WebFiori CLI Table feature is working correctly.
+```
+
+## ๐ ๏ธ Development Workflow
+
+### Adding New Tests
+1. **Create test method** with descriptive name
+2. **Follow naming convention** - `testMethodName()`
+3. **Use @test annotation** for clarity
+4. **Include setup/teardown** as needed
+5. **Add comprehensive assertions**
+
+### Test Method Template
+```php
+/**
+ * @test
+ */
+public function testSpecificFunctionality() {
+ // Arrange
+ $input = 'test data';
+ $expected = 'expected result';
+
+ // Act
+ $result = $this->objectUnderTest->methodToTest($input);
+
+ // Assert
+ $this->assertEquals($expected, $result);
+ $this->assertInstanceOf(ExpectedClass::class, $result);
+}
+```
+
+### Best Practices
+- **One concept per test** - Focus on single functionality
+- **Descriptive names** - Clear test purpose
+- **Arrange-Act-Assert** - Structured test organization
+- **Independent tests** - No test dependencies
+- **Fast execution** - Efficient test implementation
+
+## ๐ง Continuous Integration
+
+### Automated Testing
+- **Pre-commit hooks** - Run tests before commits
+- **CI/CD integration** - Automated test execution
+- **Coverage reporting** - Track test coverage metrics
+- **Performance monitoring** - Test execution time tracking
+
+### Quality Gates
+- **100% test pass rate** - All tests must pass
+- **Minimum coverage** - Maintain high coverage levels
+- **Performance benchmarks** - Test execution time limits
+- **Code quality** - Static analysis integration
+
+## ๐ Additional Resources
+
+- **PHPUnit Documentation** - [https://phpunit.de/documentation.html](https://phpunit.de/documentation.html)
+- **WebFiori CLI Guide** - Main project documentation
+- **Table Feature Documentation** - `WebFiori/CLI/Table/README.md`
+- **Example Usage** - `examples/15-table-display/`
+
+---
+
+This comprehensive test suite ensures the WebFiori CLI Table feature is robust, reliable, and ready for production use.
diff --git a/tests/WebFiori/Tests/Cli/Table/TableBuilderTest.php b/tests/WebFiori/Tests/Cli/Table/TableBuilderTest.php
index b5dfcea..30d6d60 100644
--- a/tests/WebFiori/Tests/Cli/Table/TableBuilderTest.php
+++ b/tests/WebFiori/Tests/Cli/Table/TableBuilderTest.php
@@ -1,371 +1,371 @@
-table = new TableBuilder();
- }
-
- /**
- * @test
- */
- public function testCreateStaticMethod() {
- $table = TableBuilder::create();
- $this->assertInstanceOf(TableBuilder::class, $table);
- }
-
- /**
- * @test
- */
- public function testSetHeaders() {
- $headers = ['Name', 'Age', 'City'];
- $result = $this->table->setHeaders($headers);
-
- $this->assertSame($this->table, $result); // Fluent interface
- $this->assertEquals(3, $this->table->getColumnCount());
- }
-
- /**
- * @test
- */
- public function testAddRow() {
- $this->table->setHeaders(['Name', 'Age']);
- $result = $this->table->addRow(['John', 30]);
-
- $this->assertSame($this->table, $result); // Fluent interface
- $this->assertEquals(1, $this->table->getRowCount());
- }
-
- /**
- * @test
- */
- public function testAddRows() {
- $this->table->setHeaders(['Name', 'Age']);
- $rows = [
- ['John', 30],
- ['Jane', 25],
- ['Bob', 35]
- ];
-
- $result = $this->table->addRows($rows);
-
- $this->assertSame($this->table, $result); // Fluent interface
- $this->assertEquals(3, $this->table->getRowCount());
- }
-
- /**
- * @test
- */
- public function testSetDataWithIndexedArray() {
- $data = [
- ['John', 30, 'New York'],
- ['Jane', 25, 'Los Angeles']
- ];
-
- $this->table->setHeaders(['Name', 'Age', 'City']);
- $result = $this->table->setData($data);
-
- $this->assertSame($this->table, $result);
- $this->assertEquals(2, $this->table->getRowCount());
- }
-
- /**
- * @test
- */
- public function testSetDataWithAssociativeArray() {
- $data = [
- ['name' => 'John', 'age' => 30, 'city' => 'New York'],
- ['name' => 'Jane', 'age' => 25, 'city' => 'Los Angeles']
- ];
-
- $result = $this->table->setData($data);
-
- $this->assertSame($this->table, $result);
- $this->assertEquals(3, $this->table->getColumnCount());
- $this->assertEquals(2, $this->table->getRowCount());
- }
-
- /**
- * @test
- */
- public function testConfigureColumnByName() {
- $this->table->setHeaders(['Name', 'Age', 'City']);
-
- $result = $this->table->configureColumn('Name', [
- 'width' => 20,
- 'align' => 'left'
- ]);
-
- $this->assertSame($this->table, $result);
- }
-
- /**
- * @test
- */
- public function testConfigureColumnByIndex() {
- $this->table->setHeaders(['Name', 'Age', 'City']);
-
- $result = $this->table->configureColumn(1, [
- 'width' => 10,
- 'align' => 'right'
- ]);
-
- $this->assertSame($this->table, $result);
- }
-
- /**
- * @test
- */
- public function testSetStyle() {
- $style = TableStyle::simple();
- $result = $this->table->setStyle($style);
-
- $this->assertSame($this->table, $result);
- }
-
- /**
- * @test
- */
- public function testUseStyle() {
- $result = $this->table->useStyle('simple');
-
- $this->assertSame($this->table, $result);
- }
-
- /**
- * @test
- */
- public function testUseStyleWithInvalidName() {
- $result = $this->table->useStyle('invalid');
-
- $this->assertSame($this->table, $result); // Should fallback to default
- }
-
- /**
- * @test
- */
- public function testSetTheme() {
- $theme = TableTheme::dark();
- $result = $this->table->setTheme($theme);
-
- $this->assertSame($this->table, $result);
- }
-
- /**
- * @test
- */
- public function testSetMaxWidth() {
- $result = $this->table->setMaxWidth(100);
-
- $this->assertSame($this->table, $result);
- }
-
- /**
- * @test
- */
- public function testSetAutoWidth() {
- $result = $this->table->setAutoWidth(false);
-
- $this->assertSame($this->table, $result);
- }
-
- /**
- * @test
- */
- public function testShowHeaders() {
- $result = $this->table->showHeaders(false);
-
- $this->assertSame($this->table, $result);
- }
-
- /**
- * @test
- */
- public function testSetTitle() {
- $result = $this->table->setTitle('Test Table');
-
- $this->assertSame($this->table, $result);
- }
-
- /**
- * @test
- */
- public function testColorizeColumn() {
- $this->table->setHeaders(['Name', 'Status']);
-
- $colorizer = function($value) {
- return ['color' => 'green'];
- };
-
- $result = $this->table->colorizeColumn('Status', $colorizer);
-
- $this->assertSame($this->table, $result);
- }
-
- /**
- * @test
- */
- public function testHasData() {
- $this->assertFalse($this->table->hasData());
-
- $this->table->setHeaders(['Name']);
- $this->table->addRow(['John']);
-
- $this->assertTrue($this->table->hasData());
- }
-
- /**
- * @test
- */
- public function testClear() {
- $this->table->setHeaders(['Name']);
- $this->table->addRow(['John']);
-
- $this->assertTrue($this->table->hasData());
-
- $result = $this->table->clear();
-
- $this->assertSame($this->table, $result);
- $this->assertFalse($this->table->hasData());
- $this->assertEquals(1, $this->table->getColumnCount()); // Headers preserved
- }
-
- /**
- * @test
- */
- public function testReset() {
- $this->table->setHeaders(['Name']);
- $this->table->addRow(['John']);
- $this->table->setTitle('Test');
-
- $result = $this->table->reset();
-
- $this->assertSame($this->table, $result);
- $this->assertFalse($this->table->hasData());
- $this->assertEquals(0, $this->table->getColumnCount());
- }
-
- /**
- * @test
- */
- public function testRenderEmptyTable() {
- $output = $this->table->render();
-
- $this->assertIsString($output);
- $this->assertStringContainsString('No data to display', $output);
- }
-
- /**
- * @test
- */
- public function testRenderWithData() {
- $this->table
- ->setHeaders(['Name', 'Age'])
- ->addRow(['John', 30])
- ->addRow(['Jane', 25]);
-
- $output = $this->table->render();
-
- $this->assertIsString($output);
- $this->assertStringContainsString('Name', $output);
- $this->assertStringContainsString('Age', $output);
- $this->assertStringContainsString('John', $output);
- $this->assertStringContainsString('Jane', $output);
- }
-
- /**
- * @test
- */
- public function testRenderWithTitle() {
- $this->table
- ->setHeaders(['Name'])
- ->addRow(['John'])
- ->setTitle('User List');
-
- $output = $this->table->render();
-
- $this->assertStringContainsString('User List', $output);
- }
-
- /**
- * @test
- */
- public function testFluentInterface() {
- $result = $this->table
- ->setHeaders(['Name', 'Age'])
- ->addRow(['John', 30])
- ->setTitle('Test')
- ->useStyle('simple')
- ->setMaxWidth(80)
- ->showHeaders(true);
-
- $this->assertSame($this->table, $result);
- }
-
- /**
- * @test
- */
- public function testGetColumnCount() {
- $this->assertEquals(0, $this->table->getColumnCount());
-
- $this->table->setHeaders(['A', 'B', 'C']);
- $this->assertEquals(3, $this->table->getColumnCount());
- }
-
- /**
- * @test
- */
- public function testGetRowCount() {
- $this->assertEquals(0, $this->table->getRowCount());
-
- $this->table->setHeaders(['Name']);
- $this->table->addRow(['John']);
- $this->table->addRow(['Jane']);
-
- $this->assertEquals(2, $this->table->getRowCount());
- }
-
- /**
- * @test
- */
- public function testDisplay() {
- $this->table
- ->setHeaders(['Name'])
- ->addRow(['John']);
-
- // Capture output
- ob_start();
- $this->table->display();
- $output = ob_get_clean();
-
- $this->assertIsString($output);
- $this->assertStringContainsString('Name', $output);
- $this->assertStringContainsString('John', $output);
- }
-}
+table = new TableBuilder();
+ }
+
+ /**
+ * @test
+ */
+ public function testCreateStaticMethod() {
+ $table = TableBuilder::create();
+ $this->assertInstanceOf(TableBuilder::class, $table);
+ }
+
+ /**
+ * @test
+ */
+ public function testSetHeaders() {
+ $headers = ['Name', 'Age', 'City'];
+ $result = $this->table->setHeaders($headers);
+
+ $this->assertSame($this->table, $result); // Fluent interface
+ $this->assertEquals(3, $this->table->getColumnCount());
+ }
+
+ /**
+ * @test
+ */
+ public function testAddRow() {
+ $this->table->setHeaders(['Name', 'Age']);
+ $result = $this->table->addRow(['John', 30]);
+
+ $this->assertSame($this->table, $result); // Fluent interface
+ $this->assertEquals(1, $this->table->getRowCount());
+ }
+
+ /**
+ * @test
+ */
+ public function testAddRows() {
+ $this->table->setHeaders(['Name', 'Age']);
+ $rows = [
+ ['John', 30],
+ ['Jane', 25],
+ ['Bob', 35]
+ ];
+
+ $result = $this->table->addRows($rows);
+
+ $this->assertSame($this->table, $result); // Fluent interface
+ $this->assertEquals(3, $this->table->getRowCount());
+ }
+
+ /**
+ * @test
+ */
+ public function testSetDataWithIndexedArray() {
+ $data = [
+ ['John', 30, 'New York'],
+ ['Jane', 25, 'Los Angeles']
+ ];
+
+ $this->table->setHeaders(['Name', 'Age', 'City']);
+ $result = $this->table->setData($data);
+
+ $this->assertSame($this->table, $result);
+ $this->assertEquals(2, $this->table->getRowCount());
+ }
+
+ /**
+ * @test
+ */
+ public function testSetDataWithAssociativeArray() {
+ $data = [
+ ['name' => 'John', 'age' => 30, 'city' => 'New York'],
+ ['name' => 'Jane', 'age' => 25, 'city' => 'Los Angeles']
+ ];
+
+ $result = $this->table->setData($data);
+
+ $this->assertSame($this->table, $result);
+ $this->assertEquals(3, $this->table->getColumnCount());
+ $this->assertEquals(2, $this->table->getRowCount());
+ }
+
+ /**
+ * @test
+ */
+ public function testConfigureColumnByName() {
+ $this->table->setHeaders(['Name', 'Age', 'City']);
+
+ $result = $this->table->configureColumn('Name', [
+ 'width' => 20,
+ 'align' => 'left'
+ ]);
+
+ $this->assertSame($this->table, $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testConfigureColumnByIndex() {
+ $this->table->setHeaders(['Name', 'Age', 'City']);
+
+ $result = $this->table->configureColumn(1, [
+ 'width' => 10,
+ 'align' => 'right'
+ ]);
+
+ $this->assertSame($this->table, $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testSetStyle() {
+ $style = TableStyle::simple();
+ $result = $this->table->setStyle($style);
+
+ $this->assertSame($this->table, $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testUseStyle() {
+ $result = $this->table->useStyle('simple');
+
+ $this->assertSame($this->table, $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testUseStyleWithInvalidName() {
+ $result = $this->table->useStyle('invalid');
+
+ $this->assertSame($this->table, $result); // Should fallback to default
+ }
+
+ /**
+ * @test
+ */
+ public function testSetTheme() {
+ $theme = TableTheme::dark();
+ $result = $this->table->setTheme($theme);
+
+ $this->assertSame($this->table, $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testSetMaxWidth() {
+ $result = $this->table->setMaxWidth(100);
+
+ $this->assertSame($this->table, $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testSetAutoWidth() {
+ $result = $this->table->setAutoWidth(false);
+
+ $this->assertSame($this->table, $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testShowHeaders() {
+ $result = $this->table->showHeaders(false);
+
+ $this->assertSame($this->table, $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testSetTitle() {
+ $result = $this->table->setTitle('Test Table');
+
+ $this->assertSame($this->table, $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testColorizeColumn() {
+ $this->table->setHeaders(['Name', 'Status']);
+
+ $colorizer = function($value) {
+ return ['color' => 'green'];
+ };
+
+ $result = $this->table->colorizeColumn('Status', $colorizer);
+
+ $this->assertSame($this->table, $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testHasData() {
+ $this->assertFalse($this->table->hasData());
+
+ $this->table->setHeaders(['Name']);
+ $this->table->addRow(['John']);
+
+ $this->assertTrue($this->table->hasData());
+ }
+
+ /**
+ * @test
+ */
+ public function testClear() {
+ $this->table->setHeaders(['Name']);
+ $this->table->addRow(['John']);
+
+ $this->assertTrue($this->table->hasData());
+
+ $result = $this->table->clear();
+
+ $this->assertSame($this->table, $result);
+ $this->assertFalse($this->table->hasData());
+ $this->assertEquals(1, $this->table->getColumnCount()); // Headers preserved
+ }
+
+ /**
+ * @test
+ */
+ public function testReset() {
+ $this->table->setHeaders(['Name']);
+ $this->table->addRow(['John']);
+ $this->table->setTitle('Test');
+
+ $result = $this->table->reset();
+
+ $this->assertSame($this->table, $result);
+ $this->assertFalse($this->table->hasData());
+ $this->assertEquals(0, $this->table->getColumnCount());
+ }
+
+ /**
+ * @test
+ */
+ public function testRenderEmptyTable() {
+ $output = $this->table->render();
+
+ $this->assertIsString($output);
+ $this->assertStringContainsString('No data to display', $output);
+ }
+
+ /**
+ * @test
+ */
+ public function testRenderWithData() {
+ $this->table
+ ->setHeaders(['Name', 'Age'])
+ ->addRow(['John', 30])
+ ->addRow(['Jane', 25]);
+
+ $output = $this->table->render();
+
+ $this->assertIsString($output);
+ $this->assertStringContainsString('Name', $output);
+ $this->assertStringContainsString('Age', $output);
+ $this->assertStringContainsString('John', $output);
+ $this->assertStringContainsString('Jane', $output);
+ }
+
+ /**
+ * @test
+ */
+ public function testRenderWithTitle() {
+ $this->table
+ ->setHeaders(['Name'])
+ ->addRow(['John'])
+ ->setTitle('User List');
+
+ $output = $this->table->render();
+
+ $this->assertStringContainsString('User List', $output);
+ }
+
+ /**
+ * @test
+ */
+ public function testFluentInterface() {
+ $result = $this->table
+ ->setHeaders(['Name', 'Age'])
+ ->addRow(['John', 30])
+ ->setTitle('Test')
+ ->useStyle('simple')
+ ->setMaxWidth(80)
+ ->showHeaders(true);
+
+ $this->assertSame($this->table, $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testGetColumnCount() {
+ $this->assertEquals(0, $this->table->getColumnCount());
+
+ $this->table->setHeaders(['A', 'B', 'C']);
+ $this->assertEquals(3, $this->table->getColumnCount());
+ }
+
+ /**
+ * @test
+ */
+ public function testGetRowCount() {
+ $this->assertEquals(0, $this->table->getRowCount());
+
+ $this->table->setHeaders(['Name']);
+ $this->table->addRow(['John']);
+ $this->table->addRow(['Jane']);
+
+ $this->assertEquals(2, $this->table->getRowCount());
+ }
+
+ /**
+ * @test
+ */
+ public function testDisplay() {
+ $this->table
+ ->setHeaders(['Name'])
+ ->addRow(['John']);
+
+ // Capture output
+ ob_start();
+ $this->table->display();
+ $output = ob_get_clean();
+
+ $this->assertIsString($output);
+ $this->assertStringContainsString('Name', $output);
+ $this->assertStringContainsString('John', $output);
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/Table/TableDataTest.php b/tests/WebFiori/Tests/Cli/Table/TableDataTest.php
index d3441cf..81940b5 100644
--- a/tests/WebFiori/Tests/Cli/Table/TableDataTest.php
+++ b/tests/WebFiori/Tests/Cli/Table/TableDataTest.php
@@ -1,475 +1,475 @@
-sampleHeaders = ['Name', 'Age', 'City', 'Active'];
- $this->sampleRows = [
- ['John Doe', 30, 'New York', true],
- ['Jane Smith', 25, 'Los Angeles', false],
- ['Bob Johnson', 35, 'Chicago', true]
- ];
-
- $this->tableData = new TableData($this->sampleHeaders, $this->sampleRows);
- }
-
- /**
- * @test
- */
- public function testConstructor() {
- $data = new TableData(['A', 'B'], [['1', '2']]);
-
- $this->assertEquals(['A', 'B'], $data->getHeaders());
- $this->assertEquals([['1', '2']], $data->getRows());
- $this->assertEquals(2, $data->getColumnCount());
- $this->assertEquals(1, $data->getRowCount());
- }
-
- /**
- * @test
- */
- public function testGetHeaders() {
- $this->assertEquals($this->sampleHeaders, $this->tableData->getHeaders());
- }
-
- /**
- * @test
- */
- public function testGetRows() {
- $this->assertEquals($this->sampleRows, $this->tableData->getRows());
- }
-
- /**
- * @test
- */
- public function testGetColumnCount() {
- $this->assertEquals(4, $this->tableData->getColumnCount());
- }
-
- /**
- * @test
- */
- public function testGetRowCount() {
- $this->assertEquals(3, $this->tableData->getRowCount());
- }
-
- /**
- * @test
- */
- public function testGetColumnValues() {
- $nameValues = $this->tableData->getColumnValues(0);
- $expectedNames = ['John Doe', 'Jane Smith', 'Bob Johnson'];
-
- $this->assertEquals($expectedNames, $nameValues);
- }
-
- /**
- * @test
- */
- public function testGetColumnValuesInvalidIndex() {
- $values = $this->tableData->getColumnValues(10);
-
- $this->assertEquals(['', '', ''], $values);
- }
-
- /**
- * @test
- */
- public function testGetColumnType() {
- // Age column should be detected as integer
- $this->assertEquals('integer', $this->tableData->getColumnType(1));
-
- // Name column should be detected as string
- $this->assertEquals('string', $this->tableData->getColumnType(0));
- }
-
- /**
- * @test
- */
- public function testGetColumnStatistics() {
- $ageStats = $this->tableData->getColumnStatistics(1);
-
- $this->assertIsArray($ageStats);
- $this->assertEquals(3, $ageStats['count']);
- $this->assertEquals(3, $ageStats['non_empty']);
- $this->assertEquals(3, $ageStats['unique']);
- $this->assertEquals('integer', $ageStats['type']);
- $this->assertEquals(25, $ageStats['min']);
- $this->assertEquals(35, $ageStats['max']);
- $this->assertEquals(30, $ageStats['avg']);
- }
-
- /**
- * @test
- */
- public function testHasData() {
- $this->assertTrue($this->tableData->hasData());
-
- $emptyData = new TableData(['A'], []);
- $this->assertFalse($emptyData->hasData());
- }
-
- /**
- * @test
- */
- public function testIsEmpty() {
- $this->assertFalse($this->tableData->isEmpty());
-
- $emptyData = new TableData(['A'], []);
- $this->assertTrue($emptyData->isEmpty());
- }
-
- /**
- * @test
- */
- public function testGetCellValue() {
- $this->assertEquals('John Doe', $this->tableData->getCellValue(0, 0));
- $this->assertEquals(30, $this->tableData->getCellValue(0, 1));
- $this->assertNull($this->tableData->getCellValue(10, 0)); // Invalid row
- $this->assertNull($this->tableData->getCellValue(0, 10)); // Invalid column
- }
-
- /**
- * @test
- */
- public function testGetRow() {
- $firstRow = $this->tableData->getRow(0);
- $this->assertEquals($this->sampleRows[0], $firstRow);
-
- $invalidRow = $this->tableData->getRow(10);
- $this->assertEquals([], $invalidRow);
- }
-
- /**
- * @test
- */
- public function testFilterRows() {
- $filtered = $this->tableData->filterRows(function($row) {
- return $row[1] > 30; // Age > 30
- });
-
- $this->assertInstanceOf(TableData::class, $filtered);
- $this->assertEquals(1, $filtered->getRowCount()); // Only Bob Johnson
- $this->assertEquals('Bob Johnson', $filtered->getCellValue(0, 0));
- }
-
- /**
- * @test
- */
- public function testSortByColumn() {
- $sorted = $this->tableData->sortByColumn(1, true); // Sort by age ascending
-
- $this->assertInstanceOf(TableData::class, $sorted);
- $this->assertEquals('Jane Smith', $sorted->getCellValue(0, 0)); // Age 25
- $this->assertEquals('John Doe', $sorted->getCellValue(1, 0)); // Age 30
- $this->assertEquals('Bob Johnson', $sorted->getCellValue(2, 0)); // Age 35
- }
-
- /**
- * @test
- */
- public function testSortByColumnDescending() {
- $sorted = $this->tableData->sortByColumn(1, false); // Sort by age descending
-
- $this->assertEquals('Bob Johnson', $sorted->getCellValue(0, 0)); // Age 35
- $this->assertEquals('John Doe', $sorted->getCellValue(1, 0)); // Age 30
- $this->assertEquals('Jane Smith', $sorted->getCellValue(2, 0)); // Age 25
- }
-
- /**
- * @test
- */
- public function testLimit() {
- $limited = $this->tableData->limit(2);
-
- $this->assertInstanceOf(TableData::class, $limited);
- $this->assertEquals(2, $limited->getRowCount());
- $this->assertEquals('John Doe', $limited->getCellValue(0, 0));
- $this->assertEquals('Jane Smith', $limited->getCellValue(1, 0));
- }
-
- /**
- * @test
- */
- public function testLimitWithOffset() {
- $limited = $this->tableData->limit(1, 1);
-
- $this->assertEquals(1, $limited->getRowCount());
- $this->assertEquals('Jane Smith', $limited->getCellValue(0, 0));
- }
-
- /**
- * @test
- */
- public function testAddRow() {
- $newData = $this->tableData->addRow(['Alice Brown', 28, 'Boston', true]);
-
- $this->assertInstanceOf(TableData::class, $newData);
- $this->assertEquals(4, $newData->getRowCount());
- $this->assertEquals('Alice Brown', $newData->getCellValue(3, 0));
- }
-
- /**
- * @test
- */
- public function testRemoveRow() {
- $newData = $this->tableData->removeRow(1); // Remove Jane Smith
-
- $this->assertInstanceOf(TableData::class, $newData);
- $this->assertEquals(2, $newData->getRowCount());
- $this->assertEquals('John Doe', $newData->getCellValue(0, 0));
- $this->assertEquals('Bob Johnson', $newData->getCellValue(1, 0));
- }
-
- /**
- * @test
- */
- public function testTransform() {
- $transformed = $this->tableData->transform(function($row) {
- $row[0] = strtoupper($row[0]); // Uppercase names
- return $row;
- });
-
- $this->assertInstanceOf(TableData::class, $transformed);
- $this->assertEquals('JOHN DOE', $transformed->getCellValue(0, 0));
- $this->assertEquals('JANE SMITH', $transformed->getCellValue(1, 0));
- }
-
- /**
- * @test
- */
- public function testGetUniqueValues() {
- $data = new TableData(['Status'], [['Active'], ['Inactive'], ['Active'], ['Pending']]);
- $unique = $data->getUniqueValues(0);
-
- $this->assertCount(3, $unique);
- $this->assertContains('Active', $unique);
- $this->assertContains('Inactive', $unique);
- $this->assertContains('Pending', $unique);
- }
-
- /**
- * @test
- */
- public function testGetValueCounts() {
- $data = new TableData(['Status'], [['Active'], ['Inactive'], ['Active'], ['Pending']]);
- $counts = $data->getValueCounts(0);
-
- $this->assertEquals(2, $counts['Active']);
- $this->assertEquals(1, $counts['Inactive']);
- $this->assertEquals(1, $counts['Pending']);
- }
-
- /**
- * @test
- */
- public function testToArray() {
- $array = $this->tableData->toArray(true);
-
- $this->assertIsArray($array);
- $this->assertEquals($this->sampleHeaders, $array[0]);
- $this->assertEquals($this->sampleRows[0], $array[1]);
- $this->assertCount(4, $array); // 3 rows + 1 header
- }
-
- /**
- * @test
- */
- public function testToArrayWithoutHeaders() {
- $array = $this->tableData->toArray(false);
-
- $this->assertIsArray($array);
- $this->assertEquals($this->sampleRows, $array);
- $this->assertCount(3, $array); // Only rows
- }
-
- /**
- * @test
- */
- public function testToAssociativeArray() {
- $assoc = $this->tableData->toAssociativeArray();
-
- $this->assertIsArray($assoc);
- $this->assertCount(3, $assoc);
- $this->assertEquals('John Doe', $assoc[0]['Name']);
- $this->assertEquals(30, $assoc[0]['Age']);
- $this->assertEquals('New York', $assoc[0]['City']);
- }
-
- /**
- * @test
- */
- public function testToJson() {
- $json = $this->tableData->toJson();
-
- $this->assertIsString($json);
- $decoded = json_decode($json, true);
- $this->assertIsArray($decoded);
- $this->assertCount(3, $decoded);
- $this->assertEquals('John Doe', $decoded[0]['Name']);
- }
-
- /**
- * @test
- */
- public function testToJsonPrettyPrint() {
- $json = $this->tableData->toJson(true);
-
- $this->assertIsString($json);
- $this->assertStringContainsString("\n", $json); // Pretty printed
- $this->assertStringContainsString(" ", $json); // Indentation
- }
-
- /**
- * @test
- */
- public function testToCsv() {
- $csv = $this->tableData->toCsv(true);
-
- $this->assertIsString($csv);
- $this->assertStringContainsString('Name,Age,City,Active', $csv);
- $this->assertStringContainsString('John Doe,30,New York,1', $csv);
- }
-
- /**
- * @test
- */
- public function testToCsvWithoutHeaders() {
- $csv = $this->tableData->toCsv(false);
-
- $this->assertIsString($csv);
- $this->assertStringNotContainsString('Name,Age,City,Active', $csv);
- $this->assertStringContainsString('John Doe,30,New York,1', $csv);
- }
-
- /**
- * @test
- */
- public function testFromArray() {
- $data = [
- ['John', 30],
- ['Jane', 25]
- ];
-
- $tableData = TableData::fromArray($data, ['Name', 'Age']);
-
- $this->assertInstanceOf(TableData::class, $tableData);
- $this->assertEquals(['Name', 'Age'], $tableData->getHeaders());
- $this->assertEquals(2, $tableData->getRowCount());
- }
-
- /**
- * @test
- */
- public function testFromArrayWithAssociativeData() {
- $data = [
- ['name' => 'John', 'age' => 30],
- ['name' => 'Jane', 'age' => 25]
- ];
-
- $tableData = TableData::fromArray($data);
-
- $this->assertEquals(['name', 'age'], $tableData->getHeaders());
- $this->assertEquals(2, $tableData->getRowCount());
- }
-
- /**
- * @test
- */
- public function testFromJson() {
- $json = '[{"name":"John","age":30},{"name":"Jane","age":25}]';
-
- $tableData = TableData::fromJson($json);
-
- $this->assertInstanceOf(TableData::class, $tableData);
- $this->assertEquals(['name', 'age'], $tableData->getHeaders());
- $this->assertEquals(2, $tableData->getRowCount());
- }
-
- /**
- * @test
- */
- public function testFromJsonInvalid() {
- $this->expectException(\InvalidArgumentException::class);
-
- TableData::fromJson('invalid json');
- }
-
- /**
- * @test
- */
- public function testFromCsv() {
- $csv = "Name,Age\nJohn,30\nJane,25";
-
- $tableData = TableData::fromCsv($csv, true);
-
- $this->assertInstanceOf(TableData::class, $tableData);
- $this->assertEquals(['Name', 'Age'], $tableData->getHeaders());
- $this->assertEquals(2, $tableData->getRowCount());
- $this->assertEquals('John', $tableData->getCellValue(0, 0));
- }
-
- /**
- * @test
- */
- public function testFromCsvWithoutHeaders() {
- $csv = "John,30\nJane,25";
-
- $tableData = TableData::fromCsv($csv, false);
-
- $this->assertEquals([], $tableData->getHeaders());
- $this->assertEquals(2, $tableData->getRowCount());
- }
-
- /**
- * @test
- */
- public function testNormalizeRowsWithMismatchedColumns() {
- $headers = ['A', 'B', 'C'];
- $rows = [
- ['1', '2'], // Missing column
- ['1', '2', '3', '4'] // Extra column
- ];
-
- $tableData = new TableData($headers, $rows);
-
- $this->assertEquals(['1', '2', ''], $tableData->getRow(0));
- $this->assertEquals(['1', '2', '3'], $tableData->getRow(1));
- }
-
- /**
- * @test
- */
- public function testTypeDetection() {
- $data = new TableData(
- ['Integer', 'Float', 'String', 'Boolean'],
- [
- [1, 1.5, 'text', true],
- [2, 2.7, 'more text', false],
- [3, 3.14, 'even more', true]
- ]
- );
-
- $this->assertEquals('integer', $data->getColumnType(0));
- $this->assertEquals('float', $data->getColumnType(1));
- $this->assertEquals('string', $data->getColumnType(2));
- $this->assertEquals('boolean', $data->getColumnType(3));
- }
-}
+sampleHeaders = ['Name', 'Age', 'City', 'Active'];
+ $this->sampleRows = [
+ ['John Doe', 30, 'New York', true],
+ ['Jane Smith', 25, 'Los Angeles', false],
+ ['Bob Johnson', 35, 'Chicago', true]
+ ];
+
+ $this->tableData = new TableData($this->sampleHeaders, $this->sampleRows);
+ }
+
+ /**
+ * @test
+ */
+ public function testConstructor() {
+ $data = new TableData(['A', 'B'], [['1', '2']]);
+
+ $this->assertEquals(['A', 'B'], $data->getHeaders());
+ $this->assertEquals([['1', '2']], $data->getRows());
+ $this->assertEquals(2, $data->getColumnCount());
+ $this->assertEquals(1, $data->getRowCount());
+ }
+
+ /**
+ * @test
+ */
+ public function testGetHeaders() {
+ $this->assertEquals($this->sampleHeaders, $this->tableData->getHeaders());
+ }
+
+ /**
+ * @test
+ */
+ public function testGetRows() {
+ $this->assertEquals($this->sampleRows, $this->tableData->getRows());
+ }
+
+ /**
+ * @test
+ */
+ public function testGetColumnCount() {
+ $this->assertEquals(4, $this->tableData->getColumnCount());
+ }
+
+ /**
+ * @test
+ */
+ public function testGetRowCount() {
+ $this->assertEquals(3, $this->tableData->getRowCount());
+ }
+
+ /**
+ * @test
+ */
+ public function testGetColumnValues() {
+ $nameValues = $this->tableData->getColumnValues(0);
+ $expectedNames = ['John Doe', 'Jane Smith', 'Bob Johnson'];
+
+ $this->assertEquals($expectedNames, $nameValues);
+ }
+
+ /**
+ * @test
+ */
+ public function testGetColumnValuesInvalidIndex() {
+ $values = $this->tableData->getColumnValues(10);
+
+ $this->assertEquals(['', '', ''], $values);
+ }
+
+ /**
+ * @test
+ */
+ public function testGetColumnType() {
+ // Age column should be detected as integer
+ $this->assertEquals('integer', $this->tableData->getColumnType(1));
+
+ // Name column should be detected as string
+ $this->assertEquals('string', $this->tableData->getColumnType(0));
+ }
+
+ /**
+ * @test
+ */
+ public function testGetColumnStatistics() {
+ $ageStats = $this->tableData->getColumnStatistics(1);
+
+ $this->assertIsArray($ageStats);
+ $this->assertEquals(3, $ageStats['count']);
+ $this->assertEquals(3, $ageStats['non_empty']);
+ $this->assertEquals(3, $ageStats['unique']);
+ $this->assertEquals('integer', $ageStats['type']);
+ $this->assertEquals(25, $ageStats['min']);
+ $this->assertEquals(35, $ageStats['max']);
+ $this->assertEquals(30, $ageStats['avg']);
+ }
+
+ /**
+ * @test
+ */
+ public function testHasData() {
+ $this->assertTrue($this->tableData->hasData());
+
+ $emptyData = new TableData(['A'], []);
+ $this->assertFalse($emptyData->hasData());
+ }
+
+ /**
+ * @test
+ */
+ public function testIsEmpty() {
+ $this->assertFalse($this->tableData->isEmpty());
+
+ $emptyData = new TableData(['A'], []);
+ $this->assertTrue($emptyData->isEmpty());
+ }
+
+ /**
+ * @test
+ */
+ public function testGetCellValue() {
+ $this->assertEquals('John Doe', $this->tableData->getCellValue(0, 0));
+ $this->assertEquals(30, $this->tableData->getCellValue(0, 1));
+ $this->assertNull($this->tableData->getCellValue(10, 0)); // Invalid row
+ $this->assertNull($this->tableData->getCellValue(0, 10)); // Invalid column
+ }
+
+ /**
+ * @test
+ */
+ public function testGetRow() {
+ $firstRow = $this->tableData->getRow(0);
+ $this->assertEquals($this->sampleRows[0], $firstRow);
+
+ $invalidRow = $this->tableData->getRow(10);
+ $this->assertEquals([], $invalidRow);
+ }
+
+ /**
+ * @test
+ */
+ public function testFilterRows() {
+ $filtered = $this->tableData->filterRows(function($row) {
+ return $row[1] > 30; // Age > 30
+ });
+
+ $this->assertInstanceOf(TableData::class, $filtered);
+ $this->assertEquals(1, $filtered->getRowCount()); // Only Bob Johnson
+ $this->assertEquals('Bob Johnson', $filtered->getCellValue(0, 0));
+ }
+
+ /**
+ * @test
+ */
+ public function testSortByColumn() {
+ $sorted = $this->tableData->sortByColumn(1, true); // Sort by age ascending
+
+ $this->assertInstanceOf(TableData::class, $sorted);
+ $this->assertEquals('Jane Smith', $sorted->getCellValue(0, 0)); // Age 25
+ $this->assertEquals('John Doe', $sorted->getCellValue(1, 0)); // Age 30
+ $this->assertEquals('Bob Johnson', $sorted->getCellValue(2, 0)); // Age 35
+ }
+
+ /**
+ * @test
+ */
+ public function testSortByColumnDescending() {
+ $sorted = $this->tableData->sortByColumn(1, false); // Sort by age descending
+
+ $this->assertEquals('Bob Johnson', $sorted->getCellValue(0, 0)); // Age 35
+ $this->assertEquals('John Doe', $sorted->getCellValue(1, 0)); // Age 30
+ $this->assertEquals('Jane Smith', $sorted->getCellValue(2, 0)); // Age 25
+ }
+
+ /**
+ * @test
+ */
+ public function testLimit() {
+ $limited = $this->tableData->limit(2);
+
+ $this->assertInstanceOf(TableData::class, $limited);
+ $this->assertEquals(2, $limited->getRowCount());
+ $this->assertEquals('John Doe', $limited->getCellValue(0, 0));
+ $this->assertEquals('Jane Smith', $limited->getCellValue(1, 0));
+ }
+
+ /**
+ * @test
+ */
+ public function testLimitWithOffset() {
+ $limited = $this->tableData->limit(1, 1);
+
+ $this->assertEquals(1, $limited->getRowCount());
+ $this->assertEquals('Jane Smith', $limited->getCellValue(0, 0));
+ }
+
+ /**
+ * @test
+ */
+ public function testAddRow() {
+ $newData = $this->tableData->addRow(['Alice Brown', 28, 'Boston', true]);
+
+ $this->assertInstanceOf(TableData::class, $newData);
+ $this->assertEquals(4, $newData->getRowCount());
+ $this->assertEquals('Alice Brown', $newData->getCellValue(3, 0));
+ }
+
+ /**
+ * @test
+ */
+ public function testRemoveRow() {
+ $newData = $this->tableData->removeRow(1); // Remove Jane Smith
+
+ $this->assertInstanceOf(TableData::class, $newData);
+ $this->assertEquals(2, $newData->getRowCount());
+ $this->assertEquals('John Doe', $newData->getCellValue(0, 0));
+ $this->assertEquals('Bob Johnson', $newData->getCellValue(1, 0));
+ }
+
+ /**
+ * @test
+ */
+ public function testTransform() {
+ $transformed = $this->tableData->transform(function($row) {
+ $row[0] = strtoupper($row[0]); // Uppercase names
+ return $row;
+ });
+
+ $this->assertInstanceOf(TableData::class, $transformed);
+ $this->assertEquals('JOHN DOE', $transformed->getCellValue(0, 0));
+ $this->assertEquals('JANE SMITH', $transformed->getCellValue(1, 0));
+ }
+
+ /**
+ * @test
+ */
+ public function testGetUniqueValues() {
+ $data = new TableData(['Status'], [['Active'], ['Inactive'], ['Active'], ['Pending']]);
+ $unique = $data->getUniqueValues(0);
+
+ $this->assertCount(3, $unique);
+ $this->assertContains('Active', $unique);
+ $this->assertContains('Inactive', $unique);
+ $this->assertContains('Pending', $unique);
+ }
+
+ /**
+ * @test
+ */
+ public function testGetValueCounts() {
+ $data = new TableData(['Status'], [['Active'], ['Inactive'], ['Active'], ['Pending']]);
+ $counts = $data->getValueCounts(0);
+
+ $this->assertEquals(2, $counts['Active']);
+ $this->assertEquals(1, $counts['Inactive']);
+ $this->assertEquals(1, $counts['Pending']);
+ }
+
+ /**
+ * @test
+ */
+ public function testToArray() {
+ $array = $this->tableData->toArray(true);
+
+ $this->assertIsArray($array);
+ $this->assertEquals($this->sampleHeaders, $array[0]);
+ $this->assertEquals($this->sampleRows[0], $array[1]);
+ $this->assertCount(4, $array); // 3 rows + 1 header
+ }
+
+ /**
+ * @test
+ */
+ public function testToArrayWithoutHeaders() {
+ $array = $this->tableData->toArray(false);
+
+ $this->assertIsArray($array);
+ $this->assertEquals($this->sampleRows, $array);
+ $this->assertCount(3, $array); // Only rows
+ }
+
+ /**
+ * @test
+ */
+ public function testToAssociativeArray() {
+ $assoc = $this->tableData->toAssociativeArray();
+
+ $this->assertIsArray($assoc);
+ $this->assertCount(3, $assoc);
+ $this->assertEquals('John Doe', $assoc[0]['Name']);
+ $this->assertEquals(30, $assoc[0]['Age']);
+ $this->assertEquals('New York', $assoc[0]['City']);
+ }
+
+ /**
+ * @test
+ */
+ public function testToJson() {
+ $json = $this->tableData->toJson();
+
+ $this->assertIsString($json);
+ $decoded = json_decode($json, true);
+ $this->assertIsArray($decoded);
+ $this->assertCount(3, $decoded);
+ $this->assertEquals('John Doe', $decoded[0]['Name']);
+ }
+
+ /**
+ * @test
+ */
+ public function testToJsonPrettyPrint() {
+ $json = $this->tableData->toJson(true);
+
+ $this->assertIsString($json);
+ $this->assertStringContainsString("\n", $json); // Pretty printed
+ $this->assertStringContainsString(" ", $json); // Indentation
+ }
+
+ /**
+ * @test
+ */
+ public function testToCsv() {
+ $csv = $this->tableData->toCsv(true);
+
+ $this->assertIsString($csv);
+ $this->assertStringContainsString('Name,Age,City,Active', $csv);
+ $this->assertStringContainsString('John Doe,30,New York,1', $csv);
+ }
+
+ /**
+ * @test
+ */
+ public function testToCsvWithoutHeaders() {
+ $csv = $this->tableData->toCsv(false);
+
+ $this->assertIsString($csv);
+ $this->assertStringNotContainsString('Name,Age,City,Active', $csv);
+ $this->assertStringContainsString('John Doe,30,New York,1', $csv);
+ }
+
+ /**
+ * @test
+ */
+ public function testFromArray() {
+ $data = [
+ ['John', 30],
+ ['Jane', 25]
+ ];
+
+ $tableData = TableData::fromArray($data, ['Name', 'Age']);
+
+ $this->assertInstanceOf(TableData::class, $tableData);
+ $this->assertEquals(['Name', 'Age'], $tableData->getHeaders());
+ $this->assertEquals(2, $tableData->getRowCount());
+ }
+
+ /**
+ * @test
+ */
+ public function testFromArrayWithAssociativeData() {
+ $data = [
+ ['name' => 'John', 'age' => 30],
+ ['name' => 'Jane', 'age' => 25]
+ ];
+
+ $tableData = TableData::fromArray($data);
+
+ $this->assertEquals(['name', 'age'], $tableData->getHeaders());
+ $this->assertEquals(2, $tableData->getRowCount());
+ }
+
+ /**
+ * @test
+ */
+ public function testFromJson() {
+ $json = '[{"name":"John","age":30},{"name":"Jane","age":25}]';
+
+ $tableData = TableData::fromJson($json);
+
+ $this->assertInstanceOf(TableData::class, $tableData);
+ $this->assertEquals(['name', 'age'], $tableData->getHeaders());
+ $this->assertEquals(2, $tableData->getRowCount());
+ }
+
+ /**
+ * @test
+ */
+ public function testFromJsonInvalid() {
+ $this->expectException(\InvalidArgumentException::class);
+
+ TableData::fromJson('invalid json');
+ }
+
+ /**
+ * @test
+ */
+ public function testFromCsv() {
+ $csv = "Name,Age\nJohn,30\nJane,25";
+
+ $tableData = TableData::fromCsv($csv, true);
+
+ $this->assertInstanceOf(TableData::class, $tableData);
+ $this->assertEquals(['Name', 'Age'], $tableData->getHeaders());
+ $this->assertEquals(2, $tableData->getRowCount());
+ $this->assertEquals('John', $tableData->getCellValue(0, 0));
+ }
+
+ /**
+ * @test
+ */
+ public function testFromCsvWithoutHeaders() {
+ $csv = "John,30\nJane,25";
+
+ $tableData = TableData::fromCsv($csv, false);
+
+ $this->assertEquals([], $tableData->getHeaders());
+ $this->assertEquals(2, $tableData->getRowCount());
+ }
+
+ /**
+ * @test
+ */
+ public function testNormalizeRowsWithMismatchedColumns() {
+ $headers = ['A', 'B', 'C'];
+ $rows = [
+ ['1', '2'], // Missing column
+ ['1', '2', '3', '4'] // Extra column
+ ];
+
+ $tableData = new TableData($headers, $rows);
+
+ $this->assertEquals(['1', '2', ''], $tableData->getRow(0));
+ $this->assertEquals(['1', '2', '3'], $tableData->getRow(1));
+ }
+
+ /**
+ * @test
+ */
+ public function testTypeDetection() {
+ $data = new TableData(
+ ['Integer', 'Float', 'String', 'Boolean'],
+ [
+ [1, 1.5, 'text', true],
+ [2, 2.7, 'more text', false],
+ [3, 3.14, 'even more', true]
+ ]
+ );
+
+ $this->assertEquals('integer', $data->getColumnType(0));
+ $this->assertEquals('float', $data->getColumnType(1));
+ $this->assertEquals('string', $data->getColumnType(2));
+ $this->assertEquals('boolean', $data->getColumnType(3));
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/Table/TableFormatterTest.php b/tests/WebFiori/Tests/Cli/Table/TableFormatterTest.php
index a7d0996..bddaac7 100644
--- a/tests/WebFiori/Tests/Cli/Table/TableFormatterTest.php
+++ b/tests/WebFiori/Tests/Cli/Table/TableFormatterTest.php
@@ -1,438 +1,438 @@
-formatter = new TableFormatter();
- $this->column = new Column('Test');
- }
-
- /**
- * @test
- */
- public function testFormatHeader() {
- $result = $this->formatter->formatHeader('test_header');
-
- $this->assertEquals('Test Header', $result);
- }
-
- /**
- * @test
- */
- public function testFormatHeaderWithDashes() {
- $result = $this->formatter->formatHeader('test-header-name');
-
- $this->assertEquals('Test Header Name', $result);
- }
-
- /**
- * @test
- */
- public function testFormatCell() {
- $result = $this->formatter->formatCell('test value', $this->column);
-
- $this->assertEquals('test value', $result);
- }
-
- /**
- * @test
- */
- public function testFormatCellWithNull() {
- $this->column->setDefaultValue('N/A');
- $result = $this->formatter->formatCell(null, $this->column);
-
- $this->assertEquals('N/A', $result);
- }
-
- /**
- * @test
- */
- public function testFormatCellWithEmpty() {
- $this->column->setDefaultValue('Empty');
- $result = $this->formatter->formatCell('', $this->column);
-
- $this->assertEquals('Empty', $result);
- }
-
- /**
- * @test
- */
- public function testFormatCellWithColumnFormatter() {
- $this->column->setFormatter(fn($value) => strtoupper($value));
- $result = $this->formatter->formatCell('test', $this->column);
-
- $this->assertEquals('TEST', $result);
- }
-
- /**
- * @test
- */
- public function testRegisterFormatter() {
- $customFormatter = fn($value) => "Custom: $value";
- $result = $this->formatter->registerFormatter('custom', $customFormatter);
-
- $this->assertSame($this->formatter, $result); // Fluent interface
- }
-
- /**
- * @test
- */
- public function testRegisterGlobalFormatter() {
- $globalFormatter = fn($value, $type) => "Global: $value";
- $result = $this->formatter->registerGlobalFormatter($globalFormatter);
-
- $this->assertSame($this->formatter, $result);
- }
-
- /**
- * @test
- */
- public function testFormatNumber() {
- $result = $this->formatter->formatNumber(1234.567, 2);
-
- $this->assertEquals('1,234.57', $result);
- }
-
- /**
- * @test
- */
- public function testFormatNumberWithCustomSeparators() {
- $result = $this->formatter->formatNumber(1234.567, 2, ',', '.');
-
- $this->assertEquals('1.234,57', $result);
- }
-
- /**
- * @test
- */
- public function testFormatCurrency() {
- $result = $this->formatter->formatCurrency(1234.56);
-
- $this->assertEquals('$1,234.56', $result);
- }
-
- /**
- * @test
- */
- public function testFormatCurrencyCustomSymbol() {
- $result = $this->formatter->formatCurrency(1234.56, 'โฌ', 2, false);
-
- $this->assertEquals('1,234.56 โฌ', $result);
- }
-
- /**
- * @test
- */
- public function testFormatPercentage() {
- $result = $this->formatter->formatPercentage(85.5);
-
- $this->assertEquals('85.5%', $result);
- }
-
- /**
- * @test
- */
- public function testFormatPercentageWithDecimals() {
- $result = $this->formatter->formatPercentage(85.567, 2);
-
- $this->assertEquals('85.57%', $result);
- }
-
- /**
- * @test
- */
- public function testFormatDate() {
- $result = $this->formatter->formatDate('2024-01-15');
-
- $this->assertEquals('2024-01-15', $result);
- }
-
- /**
- * @test
- */
- public function testFormatDateWithCustomFormat() {
- $result = $this->formatter->formatDate('2024-01-15', 'M j, Y');
-
- $this->assertEquals('Jan 15, 2024', $result);
- }
-
- /**
- * @test
- */
- public function testFormatDateWithDateTime() {
- $date = new \DateTime('2024-01-15');
- $result = $this->formatter->formatDate($date, 'Y-m-d');
-
- $this->assertEquals('2024-01-15', $result);
- }
-
- /**
- * @test
- */
- public function testFormatDateWithTimestamp() {
- $timestamp = strtotime('2024-01-15');
- $result = $this->formatter->formatDate($timestamp, 'Y-m-d');
-
- $this->assertEquals('2024-01-15', $result);
- }
-
- /**
- * @test
- */
- public function testFormatDateInvalid() {
- $result = $this->formatter->formatDate('invalid-date');
-
- $this->assertEquals('invalid-date', $result);
- }
-
- /**
- * @test
- */
- public function testFormatBoolean() {
- $this->assertEquals('Yes', $this->formatter->formatBoolean(true));
- $this->assertEquals('No', $this->formatter->formatBoolean(false));
- }
-
- /**
- * @test
- */
- public function testFormatBooleanCustomText() {
- $result = $this->formatter->formatBoolean(true, 'Active', 'Inactive');
-
- $this->assertEquals('Active', $result);
- }
-
- /**
- * @test
- */
- public function testFormatBooleanString() {
- $this->assertEquals('Yes', $this->formatter->formatBoolean('true'));
- $this->assertEquals('Yes', $this->formatter->formatBoolean('1'));
- $this->assertEquals('Yes', $this->formatter->formatBoolean('yes'));
- $this->assertEquals('No', $this->formatter->formatBoolean('false'));
- $this->assertEquals('No', $this->formatter->formatBoolean('0'));
- $this->assertEquals('No', $this->formatter->formatBoolean('no'));
- }
-
- /**
- * @test
- */
- public function testFormatFileSize() {
- $this->assertEquals('1.00 KB', $this->formatter->formatFileSize(1024));
- $this->assertEquals('1.00 MB', $this->formatter->formatFileSize(1048576));
- $this->assertEquals('1.00 GB', $this->formatter->formatFileSize(1073741824));
- }
-
- /**
- * @test
- */
- public function testFormatFileSizeBytes() {
- $this->assertEquals('512 B', $this->formatter->formatFileSize(512));
- }
-
- /**
- * @test
- */
- public function testFormatFileSizeWithPrecision() {
- $result = $this->formatter->formatFileSize(1536, 1); // 1.5 KB
-
- $this->assertEquals('1.5 KB', $result);
- }
-
- /**
- * @test
- */
- public function testFormatDuration() {
- $this->assertEquals('30s', $this->formatter->formatDuration(30));
- $this->assertEquals('2m 30s', $this->formatter->formatDuration(150));
- $this->assertEquals('1h 5m', $this->formatter->formatDuration(3900));
- $this->assertEquals('1d 2h', $this->formatter->formatDuration(93600));
- }
-
- /**
- * @test
- */
- public function testFormatDurationExact() {
- $this->assertEquals('1m', $this->formatter->formatDuration(60));
- $this->assertEquals('1h', $this->formatter->formatDuration(3600));
- $this->assertEquals('1d', $this->formatter->formatDuration(86400));
- }
-
- /**
- * @test
- */
- public function testSmartTruncate() {
- $text = 'This is a very long text that needs truncation';
- $result = $this->formatter->smartTruncate($text, 20);
-
- $this->assertLessThanOrEqual(20, strlen($result));
- $this->assertStringContainsString('...', $result);
- }
-
- /**
- * @test
- */
- public function testSmartTruncateShortText() {
- $text = 'Short text';
- $result = $this->formatter->smartTruncate($text, 20);
-
- $this->assertEquals($text, $result);
- }
-
- /**
- * @test
- */
- public function testSmartTruncateWordBoundary() {
- $text = 'This is a test';
- $result = $this->formatter->smartTruncate($text, 10);
-
- // Should break at word boundary if possible
- $this->assertStringContainsString('...', $result);
- $this->assertLessThanOrEqual(10, strlen($result));
- }
-
- /**
- * @test
- */
- public function testCreateColumnFormatter() {
- $formatter = TableFormatter::createColumnFormatter('currency', [
- 'symbol' => 'โฌ',
- 'decimals' => 2
- ]);
-
- $this->assertIsCallable($formatter);
- $result = $formatter(1234.56);
- $this->assertEquals('โฌ1,234.56', $result);
- }
-
- /**
- * @test
- */
- public function testCreateColumnFormatterPercentage() {
- $formatter = TableFormatter::createColumnFormatter('percentage', [
- 'decimals' => 2
- ]);
-
- $result = $formatter(85.567);
- $this->assertEquals('85.57%', $result);
- }
-
- /**
- * @test
- */
- public function testCreateColumnFormatterDate() {
- $formatter = TableFormatter::createColumnFormatter('date', [
- 'format' => 'M j, Y'
- ]);
-
- $result = $formatter('2024-01-15');
- $this->assertEquals('Jan 15, 2024', $result);
- }
-
- /**
- * @test
- */
- public function testCreateColumnFormatterFilesize() {
- $formatter = TableFormatter::createColumnFormatter('filesize', [
- 'precision' => 1
- ]);
-
- $result = $formatter(1536);
- $this->assertEquals('1.5 KB', $result);
- }
-
- /**
- * @test
- */
- public function testCreateColumnFormatterBoolean() {
- $formatter = TableFormatter::createColumnFormatter('boolean', [
- 'true_text' => 'Active',
- 'false_text' => 'Inactive'
- ]);
-
- $this->assertEquals('Active', $formatter(true));
- $this->assertEquals('Inactive', $formatter(false));
- }
-
- /**
- * @test
- */
- public function testCreateColumnFormatterNumber() {
- $formatter = TableFormatter::createColumnFormatter('number', [
- 'decimals' => 3,
- 'thousands_separator' => '.'
- ]);
-
- $result = $formatter(1234.5678);
- $this->assertEquals('1.234.568', $result);
- }
-
- /**
- * @test
- */
- public function testGetAvailableTypes() {
- $types = $this->formatter->getAvailableTypes();
-
- $this->assertIsArray($types);
- $this->assertContains('string', $types);
- $this->assertContains('integer', $types);
- $this->assertContains('float', $types);
- $this->assertContains('date', $types);
- $this->assertContains('boolean', $types);
- }
-
- /**
- * @test
- */
- public function testClearFormatters() {
- $this->formatter->registerFormatter('custom', fn($v) => $v);
- $this->formatter->registerGlobalFormatter(fn($v, $t) => $v);
-
- $result = $this->formatter->clearFormatters();
-
- $this->assertSame($this->formatter, $result);
- // Default formatters should be restored
- $types = $this->formatter->getAvailableTypes();
- $this->assertContains('email', $types);
- }
-
- /**
- * @test
- */
- public function testBuiltInEmailFormatter() {
- $this->formatter->registerFormatter('email', function($value) {
- return filter_var($value, FILTER_VALIDATE_EMAIL) ? $value : (string)$value;
- });
-
- $result = $this->formatter->formatCell('test@example.com', $this->column, 'email');
- $this->assertEquals('test@example.com', $result);
- }
-
- /**
- * @test
- */
- public function testBuiltInStatusFormatter() {
- // Test the status formatter that should be initialized by default
- $result = $this->formatter->formatCell('active', $this->column, 'status');
- $this->assertStringContainsString('Active', $result);
- $this->assertStringContainsString('โ ', $result);
- }
-}
+formatter = new TableFormatter();
+ $this->column = new Column('Test');
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatHeader() {
+ $result = $this->formatter->formatHeader('test_header');
+
+ $this->assertEquals('Test Header', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatHeaderWithDashes() {
+ $result = $this->formatter->formatHeader('test-header-name');
+
+ $this->assertEquals('Test Header Name', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatCell() {
+ $result = $this->formatter->formatCell('test value', $this->column);
+
+ $this->assertEquals('test value', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatCellWithNull() {
+ $this->column->setDefaultValue('N/A');
+ $result = $this->formatter->formatCell(null, $this->column);
+
+ $this->assertEquals('N/A', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatCellWithEmpty() {
+ $this->column->setDefaultValue('Empty');
+ $result = $this->formatter->formatCell('', $this->column);
+
+ $this->assertEquals('Empty', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatCellWithColumnFormatter() {
+ $this->column->setFormatter(fn($value) => strtoupper($value));
+ $result = $this->formatter->formatCell('test', $this->column);
+
+ $this->assertEquals('TEST', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testRegisterFormatter() {
+ $customFormatter = fn($value) => "Custom: $value";
+ $result = $this->formatter->registerFormatter('custom', $customFormatter);
+
+ $this->assertSame($this->formatter, $result); // Fluent interface
+ }
+
+ /**
+ * @test
+ */
+ public function testRegisterGlobalFormatter() {
+ $globalFormatter = fn($value, $type) => "Global: $value";
+ $result = $this->formatter->registerGlobalFormatter($globalFormatter);
+
+ $this->assertSame($this->formatter, $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatNumber() {
+ $result = $this->formatter->formatNumber(1234.567, 2);
+
+ $this->assertEquals('1,234.57', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatNumberWithCustomSeparators() {
+ $result = $this->formatter->formatNumber(1234.567, 2, ',', '.');
+
+ $this->assertEquals('1.234,57', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatCurrency() {
+ $result = $this->formatter->formatCurrency(1234.56);
+
+ $this->assertEquals('$1,234.56', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatCurrencyCustomSymbol() {
+ $result = $this->formatter->formatCurrency(1234.56, 'โฌ', 2, false);
+
+ $this->assertEquals('1,234.56 โฌ', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatPercentage() {
+ $result = $this->formatter->formatPercentage(85.5);
+
+ $this->assertEquals('85.5%', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatPercentageWithDecimals() {
+ $result = $this->formatter->formatPercentage(85.567, 2);
+
+ $this->assertEquals('85.57%', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatDate() {
+ $result = $this->formatter->formatDate('2024-01-15');
+
+ $this->assertEquals('2024-01-15', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatDateWithCustomFormat() {
+ $result = $this->formatter->formatDate('2024-01-15', 'M j, Y');
+
+ $this->assertEquals('Jan 15, 2024', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatDateWithDateTime() {
+ $date = new \DateTime('2024-01-15');
+ $result = $this->formatter->formatDate($date, 'Y-m-d');
+
+ $this->assertEquals('2024-01-15', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatDateWithTimestamp() {
+ $timestamp = strtotime('2024-01-15');
+ $result = $this->formatter->formatDate($timestamp, 'Y-m-d');
+
+ $this->assertEquals('2024-01-15', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatDateInvalid() {
+ $result = $this->formatter->formatDate('invalid-date');
+
+ $this->assertEquals('invalid-date', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatBoolean() {
+ $this->assertEquals('Yes', $this->formatter->formatBoolean(true));
+ $this->assertEquals('No', $this->formatter->formatBoolean(false));
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatBooleanCustomText() {
+ $result = $this->formatter->formatBoolean(true, 'Active', 'Inactive');
+
+ $this->assertEquals('Active', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatBooleanString() {
+ $this->assertEquals('Yes', $this->formatter->formatBoolean('true'));
+ $this->assertEquals('Yes', $this->formatter->formatBoolean('1'));
+ $this->assertEquals('Yes', $this->formatter->formatBoolean('yes'));
+ $this->assertEquals('No', $this->formatter->formatBoolean('false'));
+ $this->assertEquals('No', $this->formatter->formatBoolean('0'));
+ $this->assertEquals('No', $this->formatter->formatBoolean('no'));
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatFileSize() {
+ $this->assertEquals('1.00 KB', $this->formatter->formatFileSize(1024));
+ $this->assertEquals('1.00 MB', $this->formatter->formatFileSize(1048576));
+ $this->assertEquals('1.00 GB', $this->formatter->formatFileSize(1073741824));
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatFileSizeBytes() {
+ $this->assertEquals('512 B', $this->formatter->formatFileSize(512));
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatFileSizeWithPrecision() {
+ $result = $this->formatter->formatFileSize(1536, 1); // 1.5 KB
+
+ $this->assertEquals('1.5 KB', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatDuration() {
+ $this->assertEquals('30s', $this->formatter->formatDuration(30));
+ $this->assertEquals('2m 30s', $this->formatter->formatDuration(150));
+ $this->assertEquals('1h 5m', $this->formatter->formatDuration(3900));
+ $this->assertEquals('1d 2h', $this->formatter->formatDuration(93600));
+ }
+
+ /**
+ * @test
+ */
+ public function testFormatDurationExact() {
+ $this->assertEquals('1m', $this->formatter->formatDuration(60));
+ $this->assertEquals('1h', $this->formatter->formatDuration(3600));
+ $this->assertEquals('1d', $this->formatter->formatDuration(86400));
+ }
+
+ /**
+ * @test
+ */
+ public function testSmartTruncate() {
+ $text = 'This is a very long text that needs truncation';
+ $result = $this->formatter->smartTruncate($text, 20);
+
+ $this->assertLessThanOrEqual(20, strlen($result));
+ $this->assertStringContainsString('...', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testSmartTruncateShortText() {
+ $text = 'Short text';
+ $result = $this->formatter->smartTruncate($text, 20);
+
+ $this->assertEquals($text, $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testSmartTruncateWordBoundary() {
+ $text = 'This is a test';
+ $result = $this->formatter->smartTruncate($text, 10);
+
+ // Should break at word boundary if possible
+ $this->assertStringContainsString('...', $result);
+ $this->assertLessThanOrEqual(10, strlen($result));
+ }
+
+ /**
+ * @test
+ */
+ public function testCreateColumnFormatter() {
+ $formatter = TableFormatter::createColumnFormatter('currency', [
+ 'symbol' => 'โฌ',
+ 'decimals' => 2
+ ]);
+
+ $this->assertIsCallable($formatter);
+ $result = $formatter(1234.56);
+ $this->assertEquals('โฌ1,234.56', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testCreateColumnFormatterPercentage() {
+ $formatter = TableFormatter::createColumnFormatter('percentage', [
+ 'decimals' => 2
+ ]);
+
+ $result = $formatter(85.567);
+ $this->assertEquals('85.57%', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testCreateColumnFormatterDate() {
+ $formatter = TableFormatter::createColumnFormatter('date', [
+ 'format' => 'M j, Y'
+ ]);
+
+ $result = $formatter('2024-01-15');
+ $this->assertEquals('Jan 15, 2024', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testCreateColumnFormatterFilesize() {
+ $formatter = TableFormatter::createColumnFormatter('filesize', [
+ 'precision' => 1
+ ]);
+
+ $result = $formatter(1536);
+ $this->assertEquals('1.5 KB', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testCreateColumnFormatterBoolean() {
+ $formatter = TableFormatter::createColumnFormatter('boolean', [
+ 'true_text' => 'Active',
+ 'false_text' => 'Inactive'
+ ]);
+
+ $this->assertEquals('Active', $formatter(true));
+ $this->assertEquals('Inactive', $formatter(false));
+ }
+
+ /**
+ * @test
+ */
+ public function testCreateColumnFormatterNumber() {
+ $formatter = TableFormatter::createColumnFormatter('number', [
+ 'decimals' => 3,
+ 'thousands_separator' => '.'
+ ]);
+
+ $result = $formatter(1234.5678);
+ $this->assertEquals('1.234.568', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testGetAvailableTypes() {
+ $types = $this->formatter->getAvailableTypes();
+
+ $this->assertIsArray($types);
+ $this->assertContains('string', $types);
+ $this->assertContains('integer', $types);
+ $this->assertContains('float', $types);
+ $this->assertContains('date', $types);
+ $this->assertContains('boolean', $types);
+ }
+
+ /**
+ * @test
+ */
+ public function testClearFormatters() {
+ $this->formatter->registerFormatter('custom', fn($v) => $v);
+ $this->formatter->registerGlobalFormatter(fn($v, $t) => $v);
+
+ $result = $this->formatter->clearFormatters();
+
+ $this->assertSame($this->formatter, $result);
+ // Default formatters should be restored
+ $types = $this->formatter->getAvailableTypes();
+ $this->assertContains('email', $types);
+ }
+
+ /**
+ * @test
+ */
+ public function testBuiltInEmailFormatter() {
+ $this->formatter->registerFormatter('email', function($value) {
+ return filter_var($value, FILTER_VALIDATE_EMAIL) ? $value : (string)$value;
+ });
+
+ $result = $this->formatter->formatCell('test@example.com', $this->column, 'email');
+ $this->assertEquals('test@example.com', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testBuiltInStatusFormatter() {
+ // Test the status formatter that should be initialized by default
+ $result = $this->formatter->formatCell('active', $this->column, 'status');
+ $this->assertStringContainsString('Active', $result);
+ $this->assertStringContainsString('โ ', $result);
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/Table/TableRendererTest.php b/tests/WebFiori/Tests/Cli/Table/TableRendererTest.php
index f6d43e7..bcbdb1a 100644
--- a/tests/WebFiori/Tests/Cli/Table/TableRendererTest.php
+++ b/tests/WebFiori/Tests/Cli/Table/TableRendererTest.php
@@ -1,470 +1,470 @@
-renderer = new TableRenderer($style, $theme);
-
- $headers = ['Name', 'Age', 'City'];
- $rows = [
- ['John Doe', 30, 'New York'],
- ['Jane Smith', 25, 'Los Angeles']
- ];
-
- $this->tableData = new TableData($headers, $rows);
-
- $this->columns = [
- 0 => new Column('Name'),
- 1 => new Column('Age'),
- 2 => new Column('City')
- ];
- }
-
- /**
- * @test
- */
- public function testConstructor() {
- $style = TableStyle::simple();
- $theme = TableTheme::dark();
-
- $renderer = new TableRenderer($style, $theme);
-
- $this->assertInstanceOf(TableRenderer::class, $renderer);
- $this->assertSame($style, $renderer->getStyle());
- $this->assertSame($theme, $renderer->getTheme());
- }
-
- /**
- * @test
- */
- public function testConstructorWithoutTheme() {
- $style = TableStyle::default();
-
- $renderer = new TableRenderer($style);
-
- $this->assertInstanceOf(TableRenderer::class, $renderer);
- $this->assertSame($style, $renderer->getStyle());
- $this->assertNull($renderer->getTheme());
- }
-
- /**
- * @test
- */
- public function testRender() {
- $output = $this->renderer->render(
- $this->tableData,
- $this->columns,
- 80,
- true,
- ''
- );
-
- $this->assertIsString($output);
- $this->assertStringContainsString('Name', $output);
- $this->assertStringContainsString('Age', $output);
- $this->assertStringContainsString('City', $output);
- $this->assertStringContainsString('John Doe', $output);
- $this->assertStringContainsString('Jane Smith', $output);
- }
-
- /**
- * @test
- */
- public function testRenderWithTitle() {
- $output = $this->renderer->render(
- $this->tableData,
- $this->columns,
- 80,
- true,
- 'User List'
- );
-
- $this->assertStringContainsString('User List', $output);
- }
-
- /**
- * @test
- */
- public function testRenderWithoutHeaders() {
- $output = $this->renderer->render(
- $this->tableData,
- $this->columns,
- 80,
- false,
- ''
- );
-
- $this->assertIsString($output);
- // Should still contain data
- $this->assertStringContainsString('John Doe', $output);
- $this->assertStringContainsString('Jane Smith', $output);
- }
-
- /**
- * @test
- */
- public function testRenderEmptyTable() {
- $emptyData = new TableData(['Name'], []);
-
- $output = $this->renderer->render(
- $emptyData,
- [0 => new Column('Name')],
- 80,
- true,
- ''
- );
-
- $this->assertStringContainsString('No data to display', $output);
- }
-
- /**
- * @test
- */
- public function testRenderEmptyTableWithTitle() {
- $emptyData = new TableData(['Name'], []);
-
- $output = $this->renderer->render(
- $emptyData,
- [0 => new Column('Name')],
- 80,
- true,
- 'Empty List'
- );
-
- $this->assertStringContainsString('Empty List', $output);
- $this->assertStringContainsString('No data to display', $output);
- }
-
- /**
- * @test
- */
- public function testRenderWithHiddenColumns() {
- $this->columns[1]->setVisible(false); // Hide Age column
-
- $output = $this->renderer->render(
- $this->tableData,
- $this->columns,
- 80,
- true,
- ''
- );
-
- $this->assertStringContainsString('Name', $output);
- $this->assertStringContainsString('City', $output);
- $this->assertStringNotContainsString('Age', $output);
- $this->assertStringContainsString('John Doe', $output);
- $this->assertStringContainsString('New York', $output);
- }
-
- /**
- * @test
- */
- public function testRenderWithDifferentStyles() {
- $simpleStyle = TableStyle::simple();
- $simpleRenderer = new TableRenderer($simpleStyle);
-
- $output = $simpleRenderer->render(
- $this->tableData,
- $this->columns,
- 80,
- true,
- ''
- );
-
- $this->assertIsString($output);
- $this->assertStringContainsString('+', $output); // Simple style uses +
- $this->assertStringContainsString('-', $output); // Simple style uses -
- $this->assertStringContainsString('|', $output); // Simple style uses |
- }
-
- /**
- * @test
- */
- public function testRenderWithMinimalStyle() {
- $minimalStyle = TableStyle::minimal();
- $minimalRenderer = new TableRenderer($minimalStyle);
-
- $output = $minimalRenderer->render(
- $this->tableData,
- $this->columns,
- 80,
- true,
- ''
- );
-
- $this->assertIsString($output);
- $this->assertStringContainsString('โ', $output); // Minimal style uses horizontal line
- }
-
- /**
- * @test
- */
- public function testRenderWithTheme() {
- $colorfulTheme = TableTheme::colorful();
- $themedRenderer = new TableRenderer(TableStyle::default(), $colorfulTheme);
-
- $output = $themedRenderer->render(
- $this->tableData,
- $this->columns,
- 80,
- true,
- ''
- );
-
- $this->assertIsString($output);
- $this->assertStringContainsString("\x1b[", $output); // Should contain ANSI codes
- }
-
- /**
- * @test
- */
- public function testRenderWithColumnFormatting() {
- $this->columns[1]->setFormatter(fn($value) => $value . ' years');
- $this->columns[1]->setAlignment(Column::ALIGN_RIGHT);
-
- $output = $this->renderer->render(
- $this->tableData,
- $this->columns,
- 80,
- true,
- ''
- );
-
- $this->assertStringContainsString('30 years', $output);
- $this->assertStringContainsString('25 years', $output);
- }
-
- /**
- * @test
- */
- public function testRenderWithColumnColors() {
- $this->columns[0]->setColorizer(fn($value) => ['color' => 'green']);
-
- $output = $this->renderer->render(
- $this->tableData,
- $this->columns,
- 80,
- true,
- ''
- );
-
- $this->assertStringContainsString("\x1b[", $output); // Should contain ANSI codes
- $this->assertStringContainsString('John Doe', $output);
- }
-
- /**
- * @test
- */
- public function testSetStyle() {
- $newStyle = TableStyle::simple();
- $result = $this->renderer->setStyle($newStyle);
-
- $this->assertSame($this->renderer, $result); // Fluent interface
- $this->assertSame($newStyle, $this->renderer->getStyle());
- }
-
- /**
- * @test
- */
- public function testSetTheme() {
- $newTheme = TableTheme::dark();
- $result = $this->renderer->setTheme($newTheme);
-
- $this->assertSame($this->renderer, $result); // Fluent interface
- $this->assertSame($newTheme, $this->renderer->getTheme());
- }
-
- /**
- * @test
- */
- public function testSetThemeToNull() {
- $result = $this->renderer->setTheme(null);
-
- $this->assertSame($this->renderer, $result);
- $this->assertNull($this->renderer->getTheme());
- }
-
- /**
- * @test
- */
- public function testRenderWithNarrowWidth() {
- $output = $this->renderer->render(
- $this->tableData,
- $this->columns,
- 40, // Narrow width
- true,
- ''
- );
-
- $this->assertIsString($output);
- $this->assertStringContainsString('Name', $output);
- $this->assertStringContainsString('John Doe', $output);
- }
-
- /**
- * @test
- */
- public function testRenderWithWideWidth() {
- $output = $this->renderer->render(
- $this->tableData,
- $this->columns,
- 120, // Wide width
- true,
- ''
- );
-
- $this->assertIsString($output);
- $this->assertStringContainsString('Name', $output);
- $this->assertStringContainsString('John Doe', $output);
- }
-
- /**
- * @test
- */
- public function testRenderConsistency() {
- // Multiple renders should produce identical output
- $output1 = $this->renderer->render(
- $this->tableData,
- $this->columns,
- 80,
- true,
- ''
- );
-
- $output2 = $this->renderer->render(
- $this->tableData,
- $this->columns,
- 80,
- true,
- ''
- );
-
- $this->assertEquals($output1, $output2);
- }
-
- /**
- * @test
- */
- public function testRenderWithComplexData() {
- $headers = ['ID', 'Product', 'Price', 'In Stock', 'Rating'];
- $rows = [
- [1, 'Laptop Pro', 1299.99, true, 4.8],
- [2, 'Wireless Mouse', 29.99, false, 4.2],
- [3, 'Mechanical Keyboard', 149.99, true, 4.6]
- ];
-
- $complexData = new TableData($headers, $rows);
- $complexColumns = [
- 0 => Column::create('ID')->setWidth(4)->setAlignment(Column::ALIGN_CENTER),
- 1 => Column::create('Product')->setWidth(20),
- 2 => Column::create('Price')->setWidth(10)->setAlignment(Column::ALIGN_RIGHT),
- 3 => Column::create('In Stock')->setWidth(10)->setAlignment(Column::ALIGN_CENTER),
- 4 => Column::create('Rating')->setWidth(8)->setAlignment(Column::ALIGN_RIGHT)
- ];
-
- $output = $this->renderer->render(
- $complexData,
- $complexColumns,
- 80,
- true,
- 'Product Catalog'
- );
-
- $this->assertIsString($output);
- $this->assertStringContainsString('Product Catalog', $output);
- $this->assertStringContainsString('Laptop Pro', $output);
- $this->assertStringContainsString('1299.99', $output);
- }
-
- /**
- * @test
- */
- public function testRenderBorderGeneration() {
- $style = TableStyle::bordered();
- $renderer = new TableRenderer($style);
-
- $output = $renderer->render(
- $this->tableData,
- $this->columns,
- 80,
- true,
- ''
- );
-
- // Should contain Unicode box-drawing characters
- $this->assertStringContainsString('โ', $output); // Top-left
- $this->assertStringContainsString('โ', $output); // Top-right
- $this->assertStringContainsString('โ', $output); // Bottom-left
- $this->assertStringContainsString('โ', $output); // Bottom-right
- $this->assertStringContainsString('โ', $output); // Horizontal
- $this->assertStringContainsString('โ', $output); // Vertical
- }
-
- /**
- * @test
- */
- public function testRenderWithLongTitle() {
- $longTitle = 'This is a very long title that might exceed the table width';
-
- $output = $this->renderer->render(
- $this->tableData,
- $this->columns,
- 50, // Narrow width
- true,
- $longTitle
- );
-
- $this->assertStringContainsString($longTitle, $output);
- }
-
- /**
- * @test
- */
- public function testRenderOutputStructure() {
- $output = $this->renderer->render(
- $this->tableData,
- $this->columns,
- 80,
- true,
- 'Test Table'
- );
-
- $lines = explode("\n", $output);
-
- // Should have multiple lines
- $this->assertGreaterThan(5, count($lines));
-
- // Should not end with extra newlines
- $this->assertNotEquals('', end($lines));
- }
-}
+renderer = new TableRenderer($style, $theme);
+
+ $headers = ['Name', 'Age', 'City'];
+ $rows = [
+ ['John Doe', 30, 'New York'],
+ ['Jane Smith', 25, 'Los Angeles']
+ ];
+
+ $this->tableData = new TableData($headers, $rows);
+
+ $this->columns = [
+ 0 => new Column('Name'),
+ 1 => new Column('Age'),
+ 2 => new Column('City')
+ ];
+ }
+
+ /**
+ * @test
+ */
+ public function testConstructor() {
+ $style = TableStyle::simple();
+ $theme = TableTheme::dark();
+
+ $renderer = new TableRenderer($style, $theme);
+
+ $this->assertInstanceOf(TableRenderer::class, $renderer);
+ $this->assertSame($style, $renderer->getStyle());
+ $this->assertSame($theme, $renderer->getTheme());
+ }
+
+ /**
+ * @test
+ */
+ public function testConstructorWithoutTheme() {
+ $style = TableStyle::default();
+
+ $renderer = new TableRenderer($style);
+
+ $this->assertInstanceOf(TableRenderer::class, $renderer);
+ $this->assertSame($style, $renderer->getStyle());
+ $this->assertNull($renderer->getTheme());
+ }
+
+ /**
+ * @test
+ */
+ public function testRender() {
+ $output = $this->renderer->render(
+ $this->tableData,
+ $this->columns,
+ 80,
+ true,
+ ''
+ );
+
+ $this->assertIsString($output);
+ $this->assertStringContainsString('Name', $output);
+ $this->assertStringContainsString('Age', $output);
+ $this->assertStringContainsString('City', $output);
+ $this->assertStringContainsString('John Doe', $output);
+ $this->assertStringContainsString('Jane Smith', $output);
+ }
+
+ /**
+ * @test
+ */
+ public function testRenderWithTitle() {
+ $output = $this->renderer->render(
+ $this->tableData,
+ $this->columns,
+ 80,
+ true,
+ 'User List'
+ );
+
+ $this->assertStringContainsString('User List', $output);
+ }
+
+ /**
+ * @test
+ */
+ public function testRenderWithoutHeaders() {
+ $output = $this->renderer->render(
+ $this->tableData,
+ $this->columns,
+ 80,
+ false,
+ ''
+ );
+
+ $this->assertIsString($output);
+ // Should still contain data
+ $this->assertStringContainsString('John Doe', $output);
+ $this->assertStringContainsString('Jane Smith', $output);
+ }
+
+ /**
+ * @test
+ */
+ public function testRenderEmptyTable() {
+ $emptyData = new TableData(['Name'], []);
+
+ $output = $this->renderer->render(
+ $emptyData,
+ [0 => new Column('Name')],
+ 80,
+ true,
+ ''
+ );
+
+ $this->assertStringContainsString('No data to display', $output);
+ }
+
+ /**
+ * @test
+ */
+ public function testRenderEmptyTableWithTitle() {
+ $emptyData = new TableData(['Name'], []);
+
+ $output = $this->renderer->render(
+ $emptyData,
+ [0 => new Column('Name')],
+ 80,
+ true,
+ 'Empty List'
+ );
+
+ $this->assertStringContainsString('Empty List', $output);
+ $this->assertStringContainsString('No data to display', $output);
+ }
+
+ /**
+ * @test
+ */
+ public function testRenderWithHiddenColumns() {
+ $this->columns[1]->setVisible(false); // Hide Age column
+
+ $output = $this->renderer->render(
+ $this->tableData,
+ $this->columns,
+ 80,
+ true,
+ ''
+ );
+
+ $this->assertStringContainsString('Name', $output);
+ $this->assertStringContainsString('City', $output);
+ $this->assertStringNotContainsString('Age', $output);
+ $this->assertStringContainsString('John Doe', $output);
+ $this->assertStringContainsString('New York', $output);
+ }
+
+ /**
+ * @test
+ */
+ public function testRenderWithDifferentStyles() {
+ $simpleStyle = TableStyle::simple();
+ $simpleRenderer = new TableRenderer($simpleStyle);
+
+ $output = $simpleRenderer->render(
+ $this->tableData,
+ $this->columns,
+ 80,
+ true,
+ ''
+ );
+
+ $this->assertIsString($output);
+ $this->assertStringContainsString('+', $output); // Simple style uses +
+ $this->assertStringContainsString('-', $output); // Simple style uses -
+ $this->assertStringContainsString('|', $output); // Simple style uses |
+ }
+
+ /**
+ * @test
+ */
+ public function testRenderWithMinimalStyle() {
+ $minimalStyle = TableStyle::minimal();
+ $minimalRenderer = new TableRenderer($minimalStyle);
+
+ $output = $minimalRenderer->render(
+ $this->tableData,
+ $this->columns,
+ 80,
+ true,
+ ''
+ );
+
+ $this->assertIsString($output);
+ $this->assertStringContainsString('โ', $output); // Minimal style uses horizontal line
+ }
+
+ /**
+ * @test
+ */
+ public function testRenderWithTheme() {
+ $colorfulTheme = TableTheme::colorful();
+ $themedRenderer = new TableRenderer(TableStyle::default(), $colorfulTheme);
+
+ $output = $themedRenderer->render(
+ $this->tableData,
+ $this->columns,
+ 80,
+ true,
+ ''
+ );
+
+ $this->assertIsString($output);
+ $this->assertStringContainsString("\x1b[", $output); // Should contain ANSI codes
+ }
+
+ /**
+ * @test
+ */
+ public function testRenderWithColumnFormatting() {
+ $this->columns[1]->setFormatter(fn($value) => $value . ' years');
+ $this->columns[1]->setAlignment(Column::ALIGN_RIGHT);
+
+ $output = $this->renderer->render(
+ $this->tableData,
+ $this->columns,
+ 80,
+ true,
+ ''
+ );
+
+ $this->assertStringContainsString('30 years', $output);
+ $this->assertStringContainsString('25 years', $output);
+ }
+
+ /**
+ * @test
+ */
+ public function testRenderWithColumnColors() {
+ $this->columns[0]->setColorizer(fn($value) => ['color' => 'green']);
+
+ $output = $this->renderer->render(
+ $this->tableData,
+ $this->columns,
+ 80,
+ true,
+ ''
+ );
+
+ $this->assertStringContainsString("\x1b[", $output); // Should contain ANSI codes
+ $this->assertStringContainsString('John Doe', $output);
+ }
+
+ /**
+ * @test
+ */
+ public function testSetStyle() {
+ $newStyle = TableStyle::simple();
+ $result = $this->renderer->setStyle($newStyle);
+
+ $this->assertSame($this->renderer, $result); // Fluent interface
+ $this->assertSame($newStyle, $this->renderer->getStyle());
+ }
+
+ /**
+ * @test
+ */
+ public function testSetTheme() {
+ $newTheme = TableTheme::dark();
+ $result = $this->renderer->setTheme($newTheme);
+
+ $this->assertSame($this->renderer, $result); // Fluent interface
+ $this->assertSame($newTheme, $this->renderer->getTheme());
+ }
+
+ /**
+ * @test
+ */
+ public function testSetThemeToNull() {
+ $result = $this->renderer->setTheme(null);
+
+ $this->assertSame($this->renderer, $result);
+ $this->assertNull($this->renderer->getTheme());
+ }
+
+ /**
+ * @test
+ */
+ public function testRenderWithNarrowWidth() {
+ $output = $this->renderer->render(
+ $this->tableData,
+ $this->columns,
+ 40, // Narrow width
+ true,
+ ''
+ );
+
+ $this->assertIsString($output);
+ $this->assertStringContainsString('Name', $output);
+ $this->assertStringContainsString('John Doe', $output);
+ }
+
+ /**
+ * @test
+ */
+ public function testRenderWithWideWidth() {
+ $output = $this->renderer->render(
+ $this->tableData,
+ $this->columns,
+ 120, // Wide width
+ true,
+ ''
+ );
+
+ $this->assertIsString($output);
+ $this->assertStringContainsString('Name', $output);
+ $this->assertStringContainsString('John Doe', $output);
+ }
+
+ /**
+ * @test
+ */
+ public function testRenderConsistency() {
+ // Multiple renders should produce identical output
+ $output1 = $this->renderer->render(
+ $this->tableData,
+ $this->columns,
+ 80,
+ true,
+ ''
+ );
+
+ $output2 = $this->renderer->render(
+ $this->tableData,
+ $this->columns,
+ 80,
+ true,
+ ''
+ );
+
+ $this->assertEquals($output1, $output2);
+ }
+
+ /**
+ * @test
+ */
+ public function testRenderWithComplexData() {
+ $headers = ['ID', 'Product', 'Price', 'In Stock', 'Rating'];
+ $rows = [
+ [1, 'Laptop Pro', 1299.99, true, 4.8],
+ [2, 'Wireless Mouse', 29.99, false, 4.2],
+ [3, 'Mechanical Keyboard', 149.99, true, 4.6]
+ ];
+
+ $complexData = new TableData($headers, $rows);
+ $complexColumns = [
+ 0 => Column::create('ID')->setWidth(4)->setAlignment(Column::ALIGN_CENTER),
+ 1 => Column::create('Product')->setWidth(20),
+ 2 => Column::create('Price')->setWidth(10)->setAlignment(Column::ALIGN_RIGHT),
+ 3 => Column::create('In Stock')->setWidth(10)->setAlignment(Column::ALIGN_CENTER),
+ 4 => Column::create('Rating')->setWidth(8)->setAlignment(Column::ALIGN_RIGHT)
+ ];
+
+ $output = $this->renderer->render(
+ $complexData,
+ $complexColumns,
+ 80,
+ true,
+ 'Product Catalog'
+ );
+
+ $this->assertIsString($output);
+ $this->assertStringContainsString('Product Catalog', $output);
+ $this->assertStringContainsString('Laptop Pro', $output);
+ $this->assertStringContainsString('1299.99', $output);
+ }
+
+ /**
+ * @test
+ */
+ public function testRenderBorderGeneration() {
+ $style = TableStyle::bordered();
+ $renderer = new TableRenderer($style);
+
+ $output = $renderer->render(
+ $this->tableData,
+ $this->columns,
+ 80,
+ true,
+ ''
+ );
+
+ // Should contain Unicode box-drawing characters
+ $this->assertStringContainsString('โ', $output); // Top-left
+ $this->assertStringContainsString('โ', $output); // Top-right
+ $this->assertStringContainsString('โ', $output); // Bottom-left
+ $this->assertStringContainsString('โ', $output); // Bottom-right
+ $this->assertStringContainsString('โ', $output); // Horizontal
+ $this->assertStringContainsString('โ', $output); // Vertical
+ }
+
+ /**
+ * @test
+ */
+ public function testRenderWithLongTitle() {
+ $longTitle = 'This is a very long title that might exceed the table width';
+
+ $output = $this->renderer->render(
+ $this->tableData,
+ $this->columns,
+ 50, // Narrow width
+ true,
+ $longTitle
+ );
+
+ $this->assertStringContainsString($longTitle, $output);
+ }
+
+ /**
+ * @test
+ */
+ public function testRenderOutputStructure() {
+ $output = $this->renderer->render(
+ $this->tableData,
+ $this->columns,
+ 80,
+ true,
+ 'Test Table'
+ );
+
+ $lines = explode("\n", $output);
+
+ // Should have multiple lines
+ $this->assertGreaterThan(5, count($lines));
+
+ // Should not end with extra newlines
+ $this->assertNotEquals('', end($lines));
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/Table/TableStyleTest.php b/tests/WebFiori/Tests/Cli/Table/TableStyleTest.php
index 0af16f7..a7262b0 100644
--- a/tests/WebFiori/Tests/Cli/Table/TableStyleTest.php
+++ b/tests/WebFiori/Tests/Cli/Table/TableStyleTest.php
@@ -1,335 +1,335 @@
-assertInstanceOf(TableStyle::class, $style);
- $this->assertEquals('โ', $style->topLeft);
- $this->assertEquals('โ', $style->topRight);
- $this->assertEquals('โ', $style->bottomLeft);
- $this->assertEquals('โ', $style->bottomRight);
- $this->assertEquals('โ', $style->horizontal);
- $this->assertEquals('โ', $style->vertical);
- $this->assertTrue($style->showBorders);
- $this->assertTrue($style->showHeaderSeparator);
- }
-
- /**
- * @test
- */
- public function testBorderedStyle() {
- $style = TableStyle::bordered();
-
- $this->assertInstanceOf(TableStyle::class, $style);
- $this->assertTrue($style->showBorders);
- }
-
- /**
- * @test
- */
- public function testSimpleStyle() {
- $style = TableStyle::simple();
-
- $this->assertInstanceOf(TableStyle::class, $style);
- $this->assertEquals('+', $style->topLeft);
- $this->assertEquals('+', $style->topRight);
- $this->assertEquals('-', $style->horizontal);
- $this->assertEquals('|', $style->vertical);
- $this->assertTrue($style->showBorders);
- }
-
- /**
- * @test
- */
- public function testMinimalStyle() {
- $style = TableStyle::minimal();
-
- $this->assertInstanceOf(TableStyle::class, $style);
- $this->assertFalse($style->showBorders);
- $this->assertTrue($style->showHeaderSeparator);
- }
-
- /**
- * @test
- */
- public function testCompactStyle() {
- $style = TableStyle::compact();
-
- $this->assertInstanceOf(TableStyle::class, $style);
- $this->assertEquals(0, $style->paddingLeft);
- $this->assertEquals(1, $style->paddingRight);
- $this->assertFalse($style->showBorders);
- }
-
- /**
- * @test
- */
- public function testMarkdownStyle() {
- $style = TableStyle::markdown();
-
- $this->assertInstanceOf(TableStyle::class, $style);
- $this->assertEquals('|', $style->vertical);
- $this->assertEquals('-', $style->horizontal);
- $this->assertTrue($style->showBorders);
- $this->assertTrue($style->showHeaderSeparator);
- $this->assertFalse($style->showRowSeparators);
- }
-
- /**
- * @test
- */
- public function testDoubleBorderedStyle() {
- $style = TableStyle::doubleBordered();
-
- $this->assertInstanceOf(TableStyle::class, $style);
- $this->assertEquals('โ', $style->topLeft);
- $this->assertEquals('โ', $style->topRight);
- $this->assertEquals('โ', $style->horizontal);
- $this->assertEquals('โ', $style->vertical);
- }
-
- /**
- * @test
- */
- public function testRoundedStyle() {
- $style = TableStyle::rounded();
-
- $this->assertInstanceOf(TableStyle::class, $style);
- $this->assertEquals('โญ', $style->topLeft);
- $this->assertEquals('โฎ', $style->topRight);
- $this->assertEquals('โฐ', $style->bottomLeft);
- $this->assertEquals('โฏ', $style->bottomRight);
- }
-
- /**
- * @test
- */
- public function testHeavyStyle() {
- $style = TableStyle::heavy();
-
- $this->assertInstanceOf(TableStyle::class, $style);
- $this->assertEquals('โ', $style->topLeft);
- $this->assertEquals('โ', $style->topRight);
- $this->assertEquals('โ', $style->horizontal);
- $this->assertEquals('โ', $style->vertical);
- }
-
- /**
- * @test
- */
- public function testNoneStyle() {
- $style = TableStyle::none();
-
- $this->assertInstanceOf(TableStyle::class, $style);
- $this->assertFalse($style->showBorders);
- $this->assertFalse($style->showHeaderSeparator);
- $this->assertFalse($style->showRowSeparators);
- $this->assertEquals(0, $style->paddingLeft);
- $this->assertEquals(2, $style->paddingRight);
- }
-
- /**
- * @test
- */
- public function testCustomStyle() {
- $overrides = [
- 'topLeft' => 'A',
- 'topRight' => 'B',
- 'horizontal' => 'C',
- 'vertical' => 'D',
- 'paddingLeft' => 3,
- 'showBorders' => false
- ];
-
- $style = TableStyle::custom($overrides);
-
- $this->assertInstanceOf(TableStyle::class, $style);
- $this->assertEquals('A', $style->topLeft);
- $this->assertEquals('B', $style->topRight);
- $this->assertEquals('C', $style->horizontal);
- $this->assertEquals('D', $style->vertical);
- $this->assertEquals(3, $style->paddingLeft);
- $this->assertFalse($style->showBorders);
- }
-
- /**
- * @test
- */
- public function testGetTotalPadding() {
- $style = new TableStyle(['paddingLeft' => 2, 'paddingRight' => 3]);
-
- $this->assertEquals(5, $style->getTotalPadding());
- }
-
- /**
- * @test
- */
- public function testGetBorderWidth() {
- $style = new TableStyle(['showBorders' => true]);
-
- // 3 columns = left border + right border + 2 separators = 4
- $this->assertEquals(4, $style->getBorderWidth(3));
- }
-
- /**
- * @test
- */
- public function testGetBorderWidthNoBorders() {
- $style = new TableStyle(['showBorders' => false]);
-
- $this->assertEquals(0, $style->getBorderWidth(3));
- }
-
- /**
- * @test
- */
- public function testIsUnicodeWithUnicodeCharacters() {
- $style = TableStyle::default(); // Uses Unicode characters
-
- $this->assertTrue($style->isUnicode());
- }
-
- /**
- * @test
- */
- public function testIsUnicodeWithAsciiCharacters() {
- $style = TableStyle::simple(); // Uses ASCII characters
-
- $this->assertFalse($style->isUnicode());
- }
-
- /**
- * @test
- */
- public function testGetAsciiFallback() {
- $unicodeStyle = TableStyle::default();
- $fallback = $unicodeStyle->getAsciiFallback();
-
- $this->assertInstanceOf(TableStyle::class, $fallback);
- $this->assertFalse($fallback->isUnicode());
- }
-
- /**
- * @test
- */
- public function testGetAsciiFallbackForAsciiStyle() {
- $asciiStyle = TableStyle::simple();
- $fallback = $asciiStyle->getAsciiFallback();
-
- $this->assertSame($asciiStyle, $fallback);
- }
-
- /**
- * @test
- */
- public function testConstructorWithAllParameters() {
- $style = new TableStyle([
- 'topLeft' => 'A',
- 'topRight' => 'B',
- 'bottomLeft' => 'C',
- 'bottomRight' => 'D',
- 'horizontal' => 'E',
- 'vertical' => 'F',
- 'cross' => 'G',
- 'topTee' => 'H',
- 'bottomTee' => 'I',
- 'leftTee' => 'J',
- 'rightTee' => 'K',
- 'paddingLeft' => 2,
- 'paddingRight' => 3,
- 'showBorders' => false,
- 'showHeaderSeparator' => false,
- 'showRowSeparators' => true
- ]);
-
- $this->assertEquals('A', $style->topLeft);
- $this->assertEquals('B', $style->topRight);
- $this->assertEquals('C', $style->bottomLeft);
- $this->assertEquals('D', $style->bottomRight);
- $this->assertEquals('E', $style->horizontal);
- $this->assertEquals('F', $style->vertical);
- $this->assertEquals('G', $style->cross);
- $this->assertEquals('H', $style->topTee);
- $this->assertEquals('I', $style->bottomTee);
- $this->assertEquals('J', $style->leftTee);
- $this->assertEquals('K', $style->rightTee);
- $this->assertEquals(2, $style->paddingLeft);
- $this->assertEquals(3, $style->paddingRight);
- $this->assertFalse($style->showBorders);
- $this->assertFalse($style->showHeaderSeparator);
- $this->assertTrue($style->showRowSeparators);
- }
-
- /**
- * @test
- */
- public function testConstructorWithEmptyArray() {
- $style = new TableStyle([]);
-
- // Should use all defaults
- $this->assertEquals('โ', $style->topLeft);
- $this->assertEquals('โ', $style->topRight);
- $this->assertEquals('โ', $style->horizontal);
- $this->assertEquals('โ', $style->vertical);
- $this->assertEquals(1, $style->paddingLeft);
- $this->assertEquals(1, $style->paddingRight);
- $this->assertTrue($style->showBorders);
- $this->assertTrue($style->showHeaderSeparator);
- $this->assertFalse($style->showRowSeparators);
- }
-
- /**
- * @test
- */
- public function testConstructorWithPartialOverrides() {
- $style = new TableStyle([
- 'topLeft' => 'X',
- 'paddingLeft' => 5,
- 'showBorders' => false
- ]);
-
- // Should use provided values
- $this->assertEquals('X', $style->topLeft);
- $this->assertEquals(5, $style->paddingLeft);
- $this->assertFalse($style->showBorders);
-
- // Should use defaults for non-provided values
- $this->assertEquals('โ', $style->topRight);
- $this->assertEquals('โ', $style->horizontal);
- $this->assertEquals(1, $style->paddingRight);
- $this->assertTrue($style->showHeaderSeparator);
- }
-
- /**
- * @test
- */
- public function testReadonlyProperties() {
- $style = TableStyle::default();
-
- // These should not cause errors (readonly properties)
- $this->assertIsString($style->topLeft);
- $this->assertIsString($style->horizontal);
- $this->assertIsInt($style->paddingLeft);
- $this->assertIsBool($style->showBorders);
- }
-}
+assertInstanceOf(TableStyle::class, $style);
+ $this->assertEquals('โ', $style->topLeft);
+ $this->assertEquals('โ', $style->topRight);
+ $this->assertEquals('โ', $style->bottomLeft);
+ $this->assertEquals('โ', $style->bottomRight);
+ $this->assertEquals('โ', $style->horizontal);
+ $this->assertEquals('โ', $style->vertical);
+ $this->assertTrue($style->showBorders);
+ $this->assertTrue($style->showHeaderSeparator);
+ }
+
+ /**
+ * @test
+ */
+ public function testBorderedStyle() {
+ $style = TableStyle::bordered();
+
+ $this->assertInstanceOf(TableStyle::class, $style);
+ $this->assertTrue($style->showBorders);
+ }
+
+ /**
+ * @test
+ */
+ public function testSimpleStyle() {
+ $style = TableStyle::simple();
+
+ $this->assertInstanceOf(TableStyle::class, $style);
+ $this->assertEquals('+', $style->topLeft);
+ $this->assertEquals('+', $style->topRight);
+ $this->assertEquals('-', $style->horizontal);
+ $this->assertEquals('|', $style->vertical);
+ $this->assertTrue($style->showBorders);
+ }
+
+ /**
+ * @test
+ */
+ public function testMinimalStyle() {
+ $style = TableStyle::minimal();
+
+ $this->assertInstanceOf(TableStyle::class, $style);
+ $this->assertFalse($style->showBorders);
+ $this->assertTrue($style->showHeaderSeparator);
+ }
+
+ /**
+ * @test
+ */
+ public function testCompactStyle() {
+ $style = TableStyle::compact();
+
+ $this->assertInstanceOf(TableStyle::class, $style);
+ $this->assertEquals(0, $style->paddingLeft);
+ $this->assertEquals(1, $style->paddingRight);
+ $this->assertFalse($style->showBorders);
+ }
+
+ /**
+ * @test
+ */
+ public function testMarkdownStyle() {
+ $style = TableStyle::markdown();
+
+ $this->assertInstanceOf(TableStyle::class, $style);
+ $this->assertEquals('|', $style->vertical);
+ $this->assertEquals('-', $style->horizontal);
+ $this->assertTrue($style->showBorders);
+ $this->assertTrue($style->showHeaderSeparator);
+ $this->assertFalse($style->showRowSeparators);
+ }
+
+ /**
+ * @test
+ */
+ public function testDoubleBorderedStyle() {
+ $style = TableStyle::doubleBordered();
+
+ $this->assertInstanceOf(TableStyle::class, $style);
+ $this->assertEquals('โ', $style->topLeft);
+ $this->assertEquals('โ', $style->topRight);
+ $this->assertEquals('โ', $style->horizontal);
+ $this->assertEquals('โ', $style->vertical);
+ }
+
+ /**
+ * @test
+ */
+ public function testRoundedStyle() {
+ $style = TableStyle::rounded();
+
+ $this->assertInstanceOf(TableStyle::class, $style);
+ $this->assertEquals('โญ', $style->topLeft);
+ $this->assertEquals('โฎ', $style->topRight);
+ $this->assertEquals('โฐ', $style->bottomLeft);
+ $this->assertEquals('โฏ', $style->bottomRight);
+ }
+
+ /**
+ * @test
+ */
+ public function testHeavyStyle() {
+ $style = TableStyle::heavy();
+
+ $this->assertInstanceOf(TableStyle::class, $style);
+ $this->assertEquals('โ', $style->topLeft);
+ $this->assertEquals('โ', $style->topRight);
+ $this->assertEquals('โ', $style->horizontal);
+ $this->assertEquals('โ', $style->vertical);
+ }
+
+ /**
+ * @test
+ */
+ public function testNoneStyle() {
+ $style = TableStyle::none();
+
+ $this->assertInstanceOf(TableStyle::class, $style);
+ $this->assertFalse($style->showBorders);
+ $this->assertFalse($style->showHeaderSeparator);
+ $this->assertFalse($style->showRowSeparators);
+ $this->assertEquals(0, $style->paddingLeft);
+ $this->assertEquals(2, $style->paddingRight);
+ }
+
+ /**
+ * @test
+ */
+ public function testCustomStyle() {
+ $overrides = [
+ 'topLeft' => 'A',
+ 'topRight' => 'B',
+ 'horizontal' => 'C',
+ 'vertical' => 'D',
+ 'paddingLeft' => 3,
+ 'showBorders' => false
+ ];
+
+ $style = TableStyle::custom($overrides);
+
+ $this->assertInstanceOf(TableStyle::class, $style);
+ $this->assertEquals('A', $style->topLeft);
+ $this->assertEquals('B', $style->topRight);
+ $this->assertEquals('C', $style->horizontal);
+ $this->assertEquals('D', $style->vertical);
+ $this->assertEquals(3, $style->paddingLeft);
+ $this->assertFalse($style->showBorders);
+ }
+
+ /**
+ * @test
+ */
+ public function testGetTotalPadding() {
+ $style = new TableStyle(['paddingLeft' => 2, 'paddingRight' => 3]);
+
+ $this->assertEquals(5, $style->getTotalPadding());
+ }
+
+ /**
+ * @test
+ */
+ public function testGetBorderWidth() {
+ $style = new TableStyle(['showBorders' => true]);
+
+ // 3 columns = left border + right border + 2 separators = 4
+ $this->assertEquals(4, $style->getBorderWidth(3));
+ }
+
+ /**
+ * @test
+ */
+ public function testGetBorderWidthNoBorders() {
+ $style = new TableStyle(['showBorders' => false]);
+
+ $this->assertEquals(0, $style->getBorderWidth(3));
+ }
+
+ /**
+ * @test
+ */
+ public function testIsUnicodeWithUnicodeCharacters() {
+ $style = TableStyle::default(); // Uses Unicode characters
+
+ $this->assertTrue($style->isUnicode());
+ }
+
+ /**
+ * @test
+ */
+ public function testIsUnicodeWithAsciiCharacters() {
+ $style = TableStyle::simple(); // Uses ASCII characters
+
+ $this->assertFalse($style->isUnicode());
+ }
+
+ /**
+ * @test
+ */
+ public function testGetAsciiFallback() {
+ $unicodeStyle = TableStyle::default();
+ $fallback = $unicodeStyle->getAsciiFallback();
+
+ $this->assertInstanceOf(TableStyle::class, $fallback);
+ $this->assertFalse($fallback->isUnicode());
+ }
+
+ /**
+ * @test
+ */
+ public function testGetAsciiFallbackForAsciiStyle() {
+ $asciiStyle = TableStyle::simple();
+ $fallback = $asciiStyle->getAsciiFallback();
+
+ $this->assertSame($asciiStyle, $fallback);
+ }
+
+ /**
+ * @test
+ */
+ public function testConstructorWithAllParameters() {
+ $style = new TableStyle([
+ 'topLeft' => 'A',
+ 'topRight' => 'B',
+ 'bottomLeft' => 'C',
+ 'bottomRight' => 'D',
+ 'horizontal' => 'E',
+ 'vertical' => 'F',
+ 'cross' => 'G',
+ 'topTee' => 'H',
+ 'bottomTee' => 'I',
+ 'leftTee' => 'J',
+ 'rightTee' => 'K',
+ 'paddingLeft' => 2,
+ 'paddingRight' => 3,
+ 'showBorders' => false,
+ 'showHeaderSeparator' => false,
+ 'showRowSeparators' => true
+ ]);
+
+ $this->assertEquals('A', $style->topLeft);
+ $this->assertEquals('B', $style->topRight);
+ $this->assertEquals('C', $style->bottomLeft);
+ $this->assertEquals('D', $style->bottomRight);
+ $this->assertEquals('E', $style->horizontal);
+ $this->assertEquals('F', $style->vertical);
+ $this->assertEquals('G', $style->cross);
+ $this->assertEquals('H', $style->topTee);
+ $this->assertEquals('I', $style->bottomTee);
+ $this->assertEquals('J', $style->leftTee);
+ $this->assertEquals('K', $style->rightTee);
+ $this->assertEquals(2, $style->paddingLeft);
+ $this->assertEquals(3, $style->paddingRight);
+ $this->assertFalse($style->showBorders);
+ $this->assertFalse($style->showHeaderSeparator);
+ $this->assertTrue($style->showRowSeparators);
+ }
+
+ /**
+ * @test
+ */
+ public function testConstructorWithEmptyArray() {
+ $style = new TableStyle([]);
+
+ // Should use all defaults
+ $this->assertEquals('โ', $style->topLeft);
+ $this->assertEquals('โ', $style->topRight);
+ $this->assertEquals('โ', $style->horizontal);
+ $this->assertEquals('โ', $style->vertical);
+ $this->assertEquals(1, $style->paddingLeft);
+ $this->assertEquals(1, $style->paddingRight);
+ $this->assertTrue($style->showBorders);
+ $this->assertTrue($style->showHeaderSeparator);
+ $this->assertFalse($style->showRowSeparators);
+ }
+
+ /**
+ * @test
+ */
+ public function testConstructorWithPartialOverrides() {
+ $style = new TableStyle([
+ 'topLeft' => 'X',
+ 'paddingLeft' => 5,
+ 'showBorders' => false
+ ]);
+
+ // Should use provided values
+ $this->assertEquals('X', $style->topLeft);
+ $this->assertEquals(5, $style->paddingLeft);
+ $this->assertFalse($style->showBorders);
+
+ // Should use defaults for non-provided values
+ $this->assertEquals('โ', $style->topRight);
+ $this->assertEquals('โ', $style->horizontal);
+ $this->assertEquals(1, $style->paddingRight);
+ $this->assertTrue($style->showHeaderSeparator);
+ }
+
+ /**
+ * @test
+ */
+ public function testReadonlyProperties() {
+ $style = TableStyle::default();
+
+ // These should not cause errors (readonly properties)
+ $this->assertIsString($style->topLeft);
+ $this->assertIsString($style->horizontal);
+ $this->assertIsInt($style->paddingLeft);
+ $this->assertIsBool($style->showBorders);
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/Table/TableTestSuite.php b/tests/WebFiori/Tests/Cli/Table/TableTestSuite.php
index 92adee3..3440354 100644
--- a/tests/WebFiori/Tests/Cli/Table/TableTestSuite.php
+++ b/tests/WebFiori/Tests/Cli/Table/TableTestSuite.php
@@ -1,30 +1,30 @@
-addTestSuite(TableBuilderTest::class);
- $suite->addTestSuite(TableStyleTest::class);
- $suite->addTestSuite(ColumnTest::class);
- $suite->addTestSuite(TableDataTest::class);
- $suite->addTestSuite(TableFormatterTest::class);
- $suite->addTestSuite(TableThemeTest::class);
- $suite->addTestSuite(ColumnCalculatorTest::class);
- $suite->addTestSuite(TableRendererTest::class);
-
- return $suite;
- }
-}
+addTestSuite(TableBuilderTest::class);
+ $suite->addTestSuite(TableStyleTest::class);
+ $suite->addTestSuite(ColumnTest::class);
+ $suite->addTestSuite(TableDataTest::class);
+ $suite->addTestSuite(TableFormatterTest::class);
+ $suite->addTestSuite(TableThemeTest::class);
+ $suite->addTestSuite(ColumnCalculatorTest::class);
+ $suite->addTestSuite(TableRendererTest::class);
+
+ return $suite;
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/Table/TableThemeTest.php b/tests/WebFiori/Tests/Cli/Table/TableThemeTest.php
index 906f879..df27580 100644
--- a/tests/WebFiori/Tests/Cli/Table/TableThemeTest.php
+++ b/tests/WebFiori/Tests/Cli/Table/TableThemeTest.php
@@ -1,419 +1,419 @@
-theme = new TableTheme();
- }
-
- /**
- * @test
- */
- public function testConstructor() {
- $theme = new TableTheme();
-
- $this->assertInstanceOf(TableTheme::class, $theme);
- }
-
- /**
- * @test
- */
- public function testConstructorWithConfig() {
- $config = [
- 'headerColors' => ['color' => 'blue'],
- 'useAlternatingRows' => true
- ];
-
- $theme = new TableTheme($config);
-
- $this->assertInstanceOf(TableTheme::class, $theme);
- }
-
- /**
- * @test
- */
- public function testConfigure() {
- $config = [
- 'headerColors' => ['color' => 'red', 'bold' => true],
- 'cellColors' => ['color' => 'white'],
- 'useAlternatingRows' => true
- ];
-
- $result = $this->theme->configure($config);
-
- $this->assertSame($this->theme, $result); // Fluent interface
- }
-
- /**
- * @test
- */
- public function testConfigureWithUnderscoreKeys() {
- $config = [
- 'header_colors' => ['color' => 'blue'],
- 'cell_colors' => ['color' => 'black'],
- 'alternating_row_colors' => [[], ['background' => 'gray']],
- 'use_alternating_rows' => true,
- 'status_colors' => ['active' => ['color' => 'green']]
- ];
-
- $this->theme->configure($config);
-
- // Should not throw any errors
- $this->assertInstanceOf(TableTheme::class, $this->theme);
- }
-
- /**
- * @test
- */
- public function testApplyHeaderStyle() {
- $this->theme->setHeaderColors(['color' => 'blue', 'bold' => true]);
-
- $result = $this->theme->applyHeaderStyle('Test Header');
-
- $this->assertStringContainsString('Test Header', $result);
- $this->assertStringContainsString("\x1b[", $result); // ANSI escape sequence
- }
-
- /**
- * @test
- */
- public function testApplyHeaderStyleWithCustomStyler() {
- $styler = fn($text) => ">>> $text <<<";
- $this->theme->setHeaderStyler($styler);
-
- $result = $this->theme->applyHeaderStyle('Test');
-
- $this->assertEquals('>>> Test <<<', $result);
- }
-
- /**
- * @test
- */
- public function testApplyCellStyle() {
- $this->theme->setCellColors(['color' => 'green']);
-
- $result = $this->theme->applyCellStyle('Test Cell', 0, 0);
-
- $this->assertStringContainsString('Test Cell', $result);
- $this->assertStringContainsString("\x1b[", $result); // ANSI escape sequence
- }
-
- /**
- * @test
- */
- public function testApplyCellStyleWithAlternatingRows() {
- $this->theme->setAlternatingRowColors([
- [],
- ['background' => 'gray']
- ]);
-
- $result1 = $this->theme->applyCellStyle('Row 0', 0, 0);
- $result2 = $this->theme->applyCellStyle('Row 1', 1, 0);
-
- $this->assertStringContainsString('Row 0', $result1);
- $this->assertStringContainsString('Row 1', $result2);
- // Row 1 should have background color
- $this->assertStringContainsString("\x1b[", $result2);
- }
-
- /**
- * @test
- */
- public function testApplyCellStyleWithCustomStyler() {
- $styler = fn($text, $row, $col) => "[$row,$col] $text";
- $this->theme->setCellStyler($styler);
-
- $result = $this->theme->applyCellStyle('Test', 1, 2);
-
- $this->assertEquals('[1,2] Test', $result);
- }
-
- /**
- * @test
- */
- public function testSetHeaderColors() {
- $colors = ['color' => 'red', 'bold' => true];
- $result = $this->theme->setHeaderColors($colors);
-
- $this->assertSame($this->theme, $result); // Fluent interface
- }
-
- /**
- * @test
- */
- public function testSetCellColors() {
- $colors = ['color' => 'blue'];
- $result = $this->theme->setCellColors($colors);
-
- $this->assertSame($this->theme, $result);
- }
-
- /**
- * @test
- */
- public function testSetAlternatingRowColors() {
- $colors = [[], ['background' => 'light-gray']];
- $result = $this->theme->setAlternatingRowColors($colors);
-
- $this->assertSame($this->theme, $result);
- }
-
- /**
- * @test
- */
- public function testUseAlternatingRows() {
- $result = $this->theme->useAlternatingRows(true);
-
- $this->assertSame($this->theme, $result);
- }
-
- /**
- * @test
- */
- public function testSetStatusColors() {
- $colors = [
- 'active' => ['color' => 'green'],
- 'inactive' => ['color' => 'red']
- ];
- $result = $this->theme->setStatusColors($colors);
-
- $this->assertSame($this->theme, $result);
- }
-
- /**
- * @test
- */
- public function testSetHeaderStyler() {
- $styler = fn($text) => strtoupper($text);
- $result = $this->theme->setHeaderStyler($styler);
-
- $this->assertSame($this->theme, $result);
- }
-
- /**
- * @test
- */
- public function testSetCellStyler() {
- $styler = fn($text, $row, $col) => $text;
- $result = $this->theme->setCellStyler($styler);
-
- $this->assertSame($this->theme, $result);
- }
-
- /**
- * @test
- */
- public function testDefaultTheme() {
- $theme = TableTheme::default();
-
- $this->assertInstanceOf(TableTheme::class, $theme);
- }
-
- /**
- * @test
- */
- public function testDarkTheme() {
- $theme = TableTheme::dark();
-
- $this->assertInstanceOf(TableTheme::class, $theme);
-
- // Test that it applies colors
- $headerResult = $theme->applyHeaderStyle('Test');
- $this->assertStringContainsString("\x1b[", $headerResult);
- }
-
- /**
- * @test
- */
- public function testLightTheme() {
- $theme = TableTheme::light();
-
- $this->assertInstanceOf(TableTheme::class, $theme);
- }
-
- /**
- * @test
- */
- public function testColorfulTheme() {
- $theme = TableTheme::colorful();
-
- $this->assertInstanceOf(TableTheme::class, $theme);
-
- // Should have alternating rows
- $result1 = $theme->applyCellStyle('Test', 0, 0);
- $result2 = $theme->applyCellStyle('Test', 1, 0);
-
- // Both should have colors but potentially different
- $this->assertStringContainsString("\x1b[", $result1);
- $this->assertStringContainsString("\x1b[", $result2);
- }
-
- /**
- * @test
- */
- public function testMinimalTheme() {
- $theme = TableTheme::minimal();
-
- $this->assertInstanceOf(TableTheme::class, $theme);
-
- // Should have minimal styling
- $headerResult = $theme->applyHeaderStyle('Test');
- $this->assertStringContainsString('Test', $headerResult);
- }
-
- /**
- * @test
- */
- public function testProfessionalTheme() {
- $theme = TableTheme::professional();
-
- $this->assertInstanceOf(TableTheme::class, $theme);
- }
-
- /**
- * @test
- */
- public function testHighContrastTheme() {
- $theme = TableTheme::highContrast();
-
- $this->assertInstanceOf(TableTheme::class, $theme);
-
- // Should apply high contrast colors
- $headerResult = $theme->applyHeaderStyle('Test');
- $this->assertStringContainsString("\x1b[", $headerResult);
- }
-
- /**
- * @test
- */
- public function testCustomTheme() {
- $config = [
- 'headerColors' => ['color' => 'magenta'],
- 'cellColors' => ['color' => 'cyan']
- ];
-
- $theme = TableTheme::custom($config);
-
- $this->assertInstanceOf(TableTheme::class, $theme);
- }
-
- /**
- * @test
- */
- public function testGetAvailableThemes() {
- $themes = TableTheme::getAvailableThemes();
-
- $this->assertIsArray($themes);
- $this->assertContains('default', $themes);
- $this->assertContains('dark', $themes);
- $this->assertContains('light', $themes);
- $this->assertContains('colorful', $themes);
- $this->assertContains('minimal', $themes);
- $this->assertContains('professional', $themes);
- $this->assertContains('high-contrast', $themes);
- }
-
- /**
- * @test
- */
- public function testCreateByName() {
- $darkTheme = TableTheme::create('dark');
- $this->assertInstanceOf(TableTheme::class, $darkTheme);
-
- $lightTheme = TableTheme::create('light');
- $this->assertInstanceOf(TableTheme::class, $lightTheme);
-
- $colorfulTheme = TableTheme::create('colorful');
- $this->assertInstanceOf(TableTheme::class, $colorfulTheme);
-
- $minimalTheme = TableTheme::create('minimal');
- $this->assertInstanceOf(TableTheme::class, $minimalTheme);
-
- $professionalTheme = TableTheme::create('professional');
- $this->assertInstanceOf(TableTheme::class, $professionalTheme);
-
- $highContrastTheme = TableTheme::create('high-contrast');
- $this->assertInstanceOf(TableTheme::class, $highContrastTheme);
-
- $defaultTheme = TableTheme::create('invalid-name');
- $this->assertInstanceOf(TableTheme::class, $defaultTheme);
- }
-
- /**
- * @test
- */
- public function testCreateWithAlternativeNames() {
- $highContrastTheme = TableTheme::create('highcontrast');
- $this->assertInstanceOf(TableTheme::class, $highContrastTheme);
-
- $autoTheme = TableTheme::create('environment');
- $this->assertInstanceOf(TableTheme::class, $autoTheme);
-
- $autoTheme2 = TableTheme::create('auto');
- $this->assertInstanceOf(TableTheme::class, $autoTheme2);
- }
-
- /**
- * @test
- */
- public function testStatusColorApplication() {
- $this->theme->setStatusColors([
- 'success' => ['color' => 'green'],
- 'error' => ['color' => 'red']
- ]);
-
- $successResult = $this->theme->applyCellStyle('success message', 0, 0);
- $errorResult = $this->theme->applyCellStyle('error occurred', 0, 0);
- $normalResult = $this->theme->applyCellStyle('normal text', 0, 0);
-
- $this->assertStringContainsString("\x1b[", $successResult); // Should have color
- $this->assertStringContainsString("\x1b[", $errorResult); // Should have color
- $this->assertEquals('normal text', $normalResult); // Should not have color
- }
-
- /**
- * @test
- */
- public function testColorCodeGeneration() {
- $theme = new TableTheme();
-
- // Test basic colors
- $redResult = $theme->applyHeaderStyle('test');
- $theme->setHeaderColors(['color' => 'red']);
- $redResult = $theme->applyHeaderStyle('test');
-
- $this->assertStringContainsString('test', $redResult);
- }
-
- /**
- * @test
- */
- public function testComplexColorConfiguration() {
- $this->theme->setHeaderColors([
- 'color' => 'white',
- 'background' => 'blue',
- 'bold' => true,
- 'underline' => true
- ]);
-
- $result = $this->theme->applyHeaderStyle('Complex Header');
-
- $this->assertStringContainsString('Complex Header', $result);
- $this->assertStringContainsString("\x1b[", $result); // Should have ANSI codes
- $this->assertStringContainsString("\x1b[0m", $result); // Should have reset code
- }
-}
+theme = new TableTheme();
+ }
+
+ /**
+ * @test
+ */
+ public function testConstructor() {
+ $theme = new TableTheme();
+
+ $this->assertInstanceOf(TableTheme::class, $theme);
+ }
+
+ /**
+ * @test
+ */
+ public function testConstructorWithConfig() {
+ $config = [
+ 'headerColors' => ['color' => 'blue'],
+ 'useAlternatingRows' => true
+ ];
+
+ $theme = new TableTheme($config);
+
+ $this->assertInstanceOf(TableTheme::class, $theme);
+ }
+
+ /**
+ * @test
+ */
+ public function testConfigure() {
+ $config = [
+ 'headerColors' => ['color' => 'red', 'bold' => true],
+ 'cellColors' => ['color' => 'white'],
+ 'useAlternatingRows' => true
+ ];
+
+ $result = $this->theme->configure($config);
+
+ $this->assertSame($this->theme, $result); // Fluent interface
+ }
+
+ /**
+ * @test
+ */
+ public function testConfigureWithUnderscoreKeys() {
+ $config = [
+ 'header_colors' => ['color' => 'blue'],
+ 'cell_colors' => ['color' => 'black'],
+ 'alternating_row_colors' => [[], ['background' => 'gray']],
+ 'use_alternating_rows' => true,
+ 'status_colors' => ['active' => ['color' => 'green']]
+ ];
+
+ $this->theme->configure($config);
+
+ // Should not throw any errors
+ $this->assertInstanceOf(TableTheme::class, $this->theme);
+ }
+
+ /**
+ * @test
+ */
+ public function testApplyHeaderStyle() {
+ $this->theme->setHeaderColors(['color' => 'blue', 'bold' => true]);
+
+ $result = $this->theme->applyHeaderStyle('Test Header');
+
+ $this->assertStringContainsString('Test Header', $result);
+ $this->assertStringContainsString("\x1b[", $result); // ANSI escape sequence
+ }
+
+ /**
+ * @test
+ */
+ public function testApplyHeaderStyleWithCustomStyler() {
+ $styler = fn($text) => ">>> $text <<<";
+ $this->theme->setHeaderStyler($styler);
+
+ $result = $this->theme->applyHeaderStyle('Test');
+
+ $this->assertEquals('>>> Test <<<', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testApplyCellStyle() {
+ $this->theme->setCellColors(['color' => 'green']);
+
+ $result = $this->theme->applyCellStyle('Test Cell', 0, 0);
+
+ $this->assertStringContainsString('Test Cell', $result);
+ $this->assertStringContainsString("\x1b[", $result); // ANSI escape sequence
+ }
+
+ /**
+ * @test
+ */
+ public function testApplyCellStyleWithAlternatingRows() {
+ $this->theme->setAlternatingRowColors([
+ [],
+ ['background' => 'gray']
+ ]);
+
+ $result1 = $this->theme->applyCellStyle('Row 0', 0, 0);
+ $result2 = $this->theme->applyCellStyle('Row 1', 1, 0);
+
+ $this->assertStringContainsString('Row 0', $result1);
+ $this->assertStringContainsString('Row 1', $result2);
+ // Row 1 should have background color
+ $this->assertStringContainsString("\x1b[", $result2);
+ }
+
+ /**
+ * @test
+ */
+ public function testApplyCellStyleWithCustomStyler() {
+ $styler = fn($text, $row, $col) => "[$row,$col] $text";
+ $this->theme->setCellStyler($styler);
+
+ $result = $this->theme->applyCellStyle('Test', 1, 2);
+
+ $this->assertEquals('[1,2] Test', $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testSetHeaderColors() {
+ $colors = ['color' => 'red', 'bold' => true];
+ $result = $this->theme->setHeaderColors($colors);
+
+ $this->assertSame($this->theme, $result); // Fluent interface
+ }
+
+ /**
+ * @test
+ */
+ public function testSetCellColors() {
+ $colors = ['color' => 'blue'];
+ $result = $this->theme->setCellColors($colors);
+
+ $this->assertSame($this->theme, $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testSetAlternatingRowColors() {
+ $colors = [[], ['background' => 'light-gray']];
+ $result = $this->theme->setAlternatingRowColors($colors);
+
+ $this->assertSame($this->theme, $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testUseAlternatingRows() {
+ $result = $this->theme->useAlternatingRows(true);
+
+ $this->assertSame($this->theme, $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testSetStatusColors() {
+ $colors = [
+ 'active' => ['color' => 'green'],
+ 'inactive' => ['color' => 'red']
+ ];
+ $result = $this->theme->setStatusColors($colors);
+
+ $this->assertSame($this->theme, $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testSetHeaderStyler() {
+ $styler = fn($text) => strtoupper($text);
+ $result = $this->theme->setHeaderStyler($styler);
+
+ $this->assertSame($this->theme, $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testSetCellStyler() {
+ $styler = fn($text, $row, $col) => $text;
+ $result = $this->theme->setCellStyler($styler);
+
+ $this->assertSame($this->theme, $result);
+ }
+
+ /**
+ * @test
+ */
+ public function testDefaultTheme() {
+ $theme = TableTheme::default();
+
+ $this->assertInstanceOf(TableTheme::class, $theme);
+ }
+
+ /**
+ * @test
+ */
+ public function testDarkTheme() {
+ $theme = TableTheme::dark();
+
+ $this->assertInstanceOf(TableTheme::class, $theme);
+
+ // Test that it applies colors
+ $headerResult = $theme->applyHeaderStyle('Test');
+ $this->assertStringContainsString("\x1b[", $headerResult);
+ }
+
+ /**
+ * @test
+ */
+ public function testLightTheme() {
+ $theme = TableTheme::light();
+
+ $this->assertInstanceOf(TableTheme::class, $theme);
+ }
+
+ /**
+ * @test
+ */
+ public function testColorfulTheme() {
+ $theme = TableTheme::colorful();
+
+ $this->assertInstanceOf(TableTheme::class, $theme);
+
+ // Should have alternating rows
+ $result1 = $theme->applyCellStyle('Test', 0, 0);
+ $result2 = $theme->applyCellStyle('Test', 1, 0);
+
+ // Both should have colors but potentially different
+ $this->assertStringContainsString("\x1b[", $result1);
+ $this->assertStringContainsString("\x1b[", $result2);
+ }
+
+ /**
+ * @test
+ */
+ public function testMinimalTheme() {
+ $theme = TableTheme::minimal();
+
+ $this->assertInstanceOf(TableTheme::class, $theme);
+
+ // Should have minimal styling
+ $headerResult = $theme->applyHeaderStyle('Test');
+ $this->assertStringContainsString('Test', $headerResult);
+ }
+
+ /**
+ * @test
+ */
+ public function testProfessionalTheme() {
+ $theme = TableTheme::professional();
+
+ $this->assertInstanceOf(TableTheme::class, $theme);
+ }
+
+ /**
+ * @test
+ */
+ public function testHighContrastTheme() {
+ $theme = TableTheme::highContrast();
+
+ $this->assertInstanceOf(TableTheme::class, $theme);
+
+ // Should apply high contrast colors
+ $headerResult = $theme->applyHeaderStyle('Test');
+ $this->assertStringContainsString("\x1b[", $headerResult);
+ }
+
+ /**
+ * @test
+ */
+ public function testCustomTheme() {
+ $config = [
+ 'headerColors' => ['color' => 'magenta'],
+ 'cellColors' => ['color' => 'cyan']
+ ];
+
+ $theme = TableTheme::custom($config);
+
+ $this->assertInstanceOf(TableTheme::class, $theme);
+ }
+
+ /**
+ * @test
+ */
+ public function testGetAvailableThemes() {
+ $themes = TableTheme::getAvailableThemes();
+
+ $this->assertIsArray($themes);
+ $this->assertContains('default', $themes);
+ $this->assertContains('dark', $themes);
+ $this->assertContains('light', $themes);
+ $this->assertContains('colorful', $themes);
+ $this->assertContains('minimal', $themes);
+ $this->assertContains('professional', $themes);
+ $this->assertContains('high-contrast', $themes);
+ }
+
+ /**
+ * @test
+ */
+ public function testCreateByName() {
+ $darkTheme = TableTheme::create('dark');
+ $this->assertInstanceOf(TableTheme::class, $darkTheme);
+
+ $lightTheme = TableTheme::create('light');
+ $this->assertInstanceOf(TableTheme::class, $lightTheme);
+
+ $colorfulTheme = TableTheme::create('colorful');
+ $this->assertInstanceOf(TableTheme::class, $colorfulTheme);
+
+ $minimalTheme = TableTheme::create('minimal');
+ $this->assertInstanceOf(TableTheme::class, $minimalTheme);
+
+ $professionalTheme = TableTheme::create('professional');
+ $this->assertInstanceOf(TableTheme::class, $professionalTheme);
+
+ $highContrastTheme = TableTheme::create('high-contrast');
+ $this->assertInstanceOf(TableTheme::class, $highContrastTheme);
+
+ $defaultTheme = TableTheme::create('invalid-name');
+ $this->assertInstanceOf(TableTheme::class, $defaultTheme);
+ }
+
+ /**
+ * @test
+ */
+ public function testCreateWithAlternativeNames() {
+ $highContrastTheme = TableTheme::create('highcontrast');
+ $this->assertInstanceOf(TableTheme::class, $highContrastTheme);
+
+ $autoTheme = TableTheme::create('environment');
+ $this->assertInstanceOf(TableTheme::class, $autoTheme);
+
+ $autoTheme2 = TableTheme::create('auto');
+ $this->assertInstanceOf(TableTheme::class, $autoTheme2);
+ }
+
+ /**
+ * @test
+ */
+ public function testStatusColorApplication() {
+ $this->theme->setStatusColors([
+ 'success' => ['color' => 'green'],
+ 'error' => ['color' => 'red']
+ ]);
+
+ $successResult = $this->theme->applyCellStyle('success message', 0, 0);
+ $errorResult = $this->theme->applyCellStyle('error occurred', 0, 0);
+ $normalResult = $this->theme->applyCellStyle('normal text', 0, 0);
+
+ $this->assertStringContainsString("\x1b[", $successResult); // Should have color
+ $this->assertStringContainsString("\x1b[", $errorResult); // Should have color
+ $this->assertEquals('normal text', $normalResult); // Should not have color
+ }
+
+ /**
+ * @test
+ */
+ public function testColorCodeGeneration() {
+ $theme = new TableTheme();
+
+ // Test basic colors
+ $redResult = $theme->applyHeaderStyle('test');
+ $theme->setHeaderColors(['color' => 'red']);
+ $redResult = $theme->applyHeaderStyle('test');
+
+ $this->assertStringContainsString('test', $redResult);
+ }
+
+ /**
+ * @test
+ */
+ public function testComplexColorConfiguration() {
+ $this->theme->setHeaderColors([
+ 'color' => 'white',
+ 'background' => 'blue',
+ 'bold' => true,
+ 'underline' => true
+ ]);
+
+ $result = $this->theme->applyHeaderStyle('Complex Header');
+
+ $this->assertStringContainsString('Complex Header', $result);
+ $this->assertStringContainsString("\x1b[", $result); // Should have ANSI codes
+ $this->assertStringContainsString("\x1b[0m", $result); // Should have reset code
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/Table/phpunit.xml b/tests/WebFiori/Tests/Cli/Table/phpunit.xml
index 6e62d96..ded3194 100644
--- a/tests/WebFiori/Tests/Cli/Table/phpunit.xml
+++ b/tests/WebFiori/Tests/Cli/Table/phpunit.xml
@@ -1,47 +1,47 @@
-
-
-
-
-
- TableBuilderTest.php
- TableStyleTest.php
- ColumnTest.php
- TableDataTest.php
- TableFormatterTest.php
- TableThemeTest.php
- ColumnCalculatorTest.php
- TableRendererTest.php
-
-
-
-
-
- ../../../../WebFiori/Cli/Table
-
-
- ../../../../WebFiori/CLI/Table/README.md
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+ TableBuilderTest.php
+ TableStyleTest.php
+ ColumnTest.php
+ TableDataTest.php
+ TableFormatterTest.php
+ TableThemeTest.php
+ ColumnCalculatorTest.php
+ TableRendererTest.php
+
+
+
+
+
+ ../../../../WebFiori/Cli/Table
+
+
+ ../../../../WebFiori/CLI/Table/README.md
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/tests/WebFiori/Tests/Cli/Table/run-tests.php b/tests/WebFiori/Tests/Cli/Table/run-tests.php
index f8feaf0..29cc7c7 100644
--- a/tests/WebFiori/Tests/Cli/Table/run-tests.php
+++ b/tests/WebFiori/Tests/Cli/Table/run-tests.php
@@ -1,80 +1,80 @@
- 'TableBuilder (Main Interface)',
- TableStyleTest::class => 'TableStyle (Visual Styling)',
- ColumnTest::class => 'Column (Column Configuration)',
- TableDataTest::class => 'TableData (Data Management)',
- TableFormatterTest::class => 'TableFormatter (Content Formatting)',
- TableThemeTest::class => 'TableTheme (Color Themes)',
- ColumnCalculatorTest::class => 'ColumnCalculator (Width Calculations)',
- TableRendererTest::class => 'TableRenderer (Rendering Engine)'
-];
-
-foreach ($testClasses as $testClass => $description) {
- echo "Adding test class: $description\n";
- $suite->addTestSuite($testClass);
-}
-
-echo "\n๐ Running Tests...\n";
-echo "==================\n\n";
-
-// Run the tests
-$runner = new TestRunner();
-$result = $runner->run($suite);
-
-// Display summary
-echo "\n๐ Test Summary\n";
-echo "===============\n";
-echo "Tests Run: " . $result->count() . "\n";
-echo "Failures: " . $result->failureCount() . "\n";
-echo "Errors: " . $result->errorCount() . "\n";
-echo "Skipped: " . $result->skippedCount() . "\n";
-echo "Warnings: " . $result->warningCount() . "\n";
-
-if ($result->wasSuccessful()) {
- echo "\nโ All tests passed successfully!\n";
- echo "๐ WebFiori CLI Table feature is working correctly.\n";
- exit(0);
-} else {
- echo "\nโ Some tests failed.\n";
- echo "Please review the test output above for details.\n";
- exit(1);
-}
+ 'TableBuilder (Main Interface)',
+ TableStyleTest::class => 'TableStyle (Visual Styling)',
+ ColumnTest::class => 'Column (Column Configuration)',
+ TableDataTest::class => 'TableData (Data Management)',
+ TableFormatterTest::class => 'TableFormatter (Content Formatting)',
+ TableThemeTest::class => 'TableTheme (Color Themes)',
+ ColumnCalculatorTest::class => 'ColumnCalculator (Width Calculations)',
+ TableRendererTest::class => 'TableRenderer (Rendering Engine)'
+];
+
+foreach ($testClasses as $testClass => $description) {
+ echo "Adding test class: $description\n";
+ $suite->addTestSuite($testClass);
+}
+
+echo "\n๐ Running Tests...\n";
+echo "==================\n\n";
+
+// Run the tests
+$runner = new TestRunner();
+$result = $runner->run($suite);
+
+// Display summary
+echo "\n๐ Test Summary\n";
+echo "===============\n";
+echo "Tests Run: " . $result->count() . "\n";
+echo "Failures: " . $result->failureCount() . "\n";
+echo "Errors: " . $result->errorCount() . "\n";
+echo "Skipped: " . $result->skippedCount() . "\n";
+echo "Warnings: " . $result->warningCount() . "\n";
+
+if ($result->wasSuccessful()) {
+ echo "\nโ All tests passed successfully!\n";
+ echo "๐ WebFiori CLI Table feature is working correctly.\n";
+ exit(0);
+} else {
+ echo "\nโ Some tests failed.\n";
+ echo "Please review the test output above for details.\n";
+ exit(1);
+}
diff --git a/tests/WebFiori/Tests/Cli/TestCommand.php b/tests/WebFiori/Tests/Cli/TestCommand.php
index a61bd7d..80ea71f 100644
--- a/tests/WebFiori/Tests/Cli/TestCommand.php
+++ b/tests/WebFiori/Tests/Cli/TestCommand.php
@@ -1,24 +1,24 @@
-setInputStream(new StdIn());
- $this->setOutputStream(new ArrayOutputStream());
- }
- public function exec() : int {
- $name = $this->getArgValue('name');
- $this->println('Hello '.$name.'!', [
- 'color' => 'red',
- ]);
- $this->println('Ok');
- return 0;
- }
-
-}
+setInputStream(new StdIn());
+ $this->setOutputStream(new ArrayOutputStream());
+ }
+ public function exec() : int {
+ $name = $this->getArgValue('name');
+ $this->println('Hello '.$name.'!', [
+ 'color' => 'red',
+ ]);
+ $this->println('Ok');
+ return 0;
+ }
+
+}
diff --git a/tests/WebFiori/Tests/Cli/TestCommands/AliasTestCommand.php b/tests/WebFiori/Tests/Cli/TestCommands/AliasTestCommand.php
index e40575f..a5f774b 100644
--- a/tests/WebFiori/Tests/Cli/TestCommands/AliasTestCommand.php
+++ b/tests/WebFiori/Tests/Cli/TestCommands/AliasTestCommand.php
@@ -1,19 +1,19 @@
-println("Alias test command executed");
- return 0;
- }
-}
+println("Alias test command executed");
+ return 0;
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/TestCommands/Command00.php b/tests/WebFiori/Tests/Cli/TestCommands/Command00.php
index 1ebfd09..ef73339 100644
--- a/tests/WebFiori/Tests/Cli/TestCommands/Command00.php
+++ b/tests/WebFiori/Tests/Cli/TestCommands/Command00.php
@@ -1,32 +1,32 @@
- [
- ArgumentOption::VALUES => [
- 'Ibrahim', 'Ali'
- ],
- ArgumentOption::DESCRIPTION => 'The name of the hero'
- ]
- ], 'A command to display hero\'s name.');
- }
-
- public function exec(): int {
- $hero = $this->getArgValue('name');
- $this->println("Hello hero %s", $hero);
- return 0;
- }
-
-}
+ [
+ ArgumentOption::VALUES => [
+ 'Ibrahim', 'Ali'
+ ],
+ ArgumentOption::DESCRIPTION => 'The name of the hero'
+ ]
+ ], 'A command to display hero\'s name.');
+ }
+
+ public function exec(): int {
+ $hero = $this->getArgValue('name');
+ $this->println("Hello hero %s", $hero);
+ return 0;
+ }
+
+}
diff --git a/tests/WebFiori/Tests/Cli/TestCommands/Command01.php b/tests/WebFiori/Tests/Cli/TestCommands/Command01.php
index fc06f30..28df5ca 100644
--- a/tests/WebFiori/Tests/Cli/TestCommands/Command01.php
+++ b/tests/WebFiori/Tests/Cli/TestCommands/Command01.php
@@ -1,31 +1,31 @@
- [
-
- ],
- new Argument('arg-2'),
- 'arg-3' => [
- ArgumentOption::DEFAULT => 'Hello'
- ]
- ], 'No desc');
- }
-
- public function exec(): int {
- $this->println('System version: 1.0.0');
- $this->println("%s", $this->getArgValue('arg-1'));
- $this->println("%s", $this->getArgValue('arg-2'));
- $this->println("%s", $this->getArgValue('arg-3'));
- return 0;
- }
-
-}
+ [
+
+ ],
+ new Argument('arg-2'),
+ 'arg-3' => [
+ ArgumentOption::DEFAULT => 'Hello'
+ ]
+ ], 'No desc');
+ }
+
+ public function exec(): int {
+ $this->println('System version: 1.0.0');
+ $this->println("%s", $this->getArgValue('arg-1'));
+ $this->println("%s", $this->getArgValue('arg-2'));
+ $this->println("%s", $this->getArgValue('arg-3'));
+ return 0;
+ }
+
+}
diff --git a/tests/WebFiori/Tests/Cli/TestCommands/Command03.php b/tests/WebFiori/Tests/Cli/TestCommands/Command03.php
index 0022091..2705974 100644
--- a/tests/WebFiori/Tests/Cli/TestCommands/Command03.php
+++ b/tests/WebFiori/Tests/Cli/TestCommands/Command03.php
@@ -1,20 +1,20 @@
-println('Running Sub Command');
- $this->getOwner()->register(new Command01());
- $this->execSubCommand('show-v', ['arg-3' => 'Ur']);
- $this->println('Done');
- return 0;
- }
-
-}
+println('Running Sub Command');
+ $this->getOwner()->register(new Command01());
+ $this->execSubCommand('show-v', ['arg-3' => 'Ur']);
+ $this->println('Done');
+ return 0;
+ }
+
+}
diff --git a/tests/WebFiori/Tests/Cli/TestCommands/ConflictTestCommand.php b/tests/WebFiori/Tests/Cli/TestCommands/ConflictTestCommand.php
index c6a386b..2bb1e6e 100644
--- a/tests/WebFiori/Tests/Cli/TestCommands/ConflictTestCommand.php
+++ b/tests/WebFiori/Tests/Cli/TestCommands/ConflictTestCommand.php
@@ -1,19 +1,19 @@
-println("Conflict test command executed");
- return 0;
- }
-}
+println("Conflict test command executed");
+ return 0;
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/TestCommands/NoAliasCommand.php b/tests/WebFiori/Tests/Cli/TestCommands/NoAliasCommand.php
index e802d89..2ee326d 100644
--- a/tests/WebFiori/Tests/Cli/TestCommands/NoAliasCommand.php
+++ b/tests/WebFiori/Tests/Cli/TestCommands/NoAliasCommand.php
@@ -1,19 +1,19 @@
-println("No alias command executed");
- return 0;
- }
-}
+println("No alias command executed");
+ return 0;
+ }
+}
diff --git a/tests/WebFiori/Tests/Cli/TestCommands/WithExceptionCommand.php b/tests/WebFiori/Tests/Cli/TestCommands/WithExceptionCommand.php
index 820cbe3..9cecb01 100644
--- a/tests/WebFiori/Tests/Cli/TestCommands/WithExceptionCommand.php
+++ b/tests/WebFiori/Tests/Cli/TestCommands/WithExceptionCommand.php
@@ -1,16 +1,16 @@
-notExist();
- }
-
-}
+notExist();
+ }
+
+}
diff --git a/tests/WebFiori/Tests/Files/stream1.txt b/tests/WebFiori/Tests/Files/stream1.txt
index 980a0d5..4429471 100644
--- a/tests/WebFiori/Tests/Files/stream1.txt
+++ b/tests/WebFiori/Tests/Files/stream1.txt
@@ -1 +1 @@
-Hello World!
+Hello World!
diff --git a/tests/WebFiori/Tests/TestStudent.php b/tests/WebFiori/Tests/TestStudent.php
index 75b4699..058040d 100644
--- a/tests/WebFiori/Tests/TestStudent.php
+++ b/tests/WebFiori/Tests/TestStudent.php
@@ -1,7 +1,7 @@
-
-
-
-
-
-
-
-
-
-
- ../WebFiori/Cli
-
-
-
-
-
-
- ./WebFiori/Tests/Cli
-
-
-
+
+
+
+
+
+
+
+
+
+ ../WebFiori/Cli
+
+
+
+
+
+
+
+ ./WebFiori/Tests/Cli
+
+
+
diff --git a/tests/phpunit10.xml b/tests/phpunit10.xml
deleted file mode 100644
index 77a1e2b..0000000
--- a/tests/phpunit10.xml
+++ /dev/null
@@ -1,21 +0,0 @@
-
-
-
-
-
-
-
-
-
- ../WebFiori/Cli
-
-
-
-
-
-
-
- ./WebFiori/Tests/Cli
-
-
-
-
-
- 
-
-
- 
-
-
- 
-
-
|
-| 
|
-| 
|
-| 
|
-|