Merge branch 'release/0.8.9'

Author: ljonesfl

.github/workflows/ci.yml

@@ -5,30 +5,29 @@ on: [push]
 jobs:
   build-test:
     runs-on: ubuntu-latest
-    container:
-      image: php:8.4  # This forces the job to run in a Docker container
 
     steps:
     - name: Checkout
       uses: actions/checkout@v3
 
-    - name: Install System Dependencies (Git, Zip, Unzip)
-      run: |
-        apt-get update
-        apt-get install -y unzip git zip
-
-    - name: Install and Enable extensions
-      run: |
-        docker-php-ext-install sockets calendar
-        docker-php-ext-enable sockets calendar
-
-    - name: Install Composer
-      run: |
-        curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer
-        composer --version
+    - name: Setup PHP
+      uses: shivammathur/setup-php@v2
+      with:
+        php-version: 8.4
+        extensions: sockets, calendar, pcov
+        coverage: pcov
 
     - name: Install Dependencies
-      run: composer install --prefer-dist --no-progress
-
-    - name: Run PHPUnit
-      run: vendor/bin/phpunit tests
+      run: composer install --prefer-dist --no-progress --no-interaction --optimize-autoloader
+
+    - name: Run PHPUnit with Coverage
+      run: vendor/bin/phpunit tests --coverage-clover coverage.xml --coverage-filter src
+
+    - name: Upload coverage to Codecov
+      uses: codecov/codecov-action@v5
+      with:
+        token: ${{ secrets.CODECOV_TOKEN }}
+        files: ./coverage.xml
+        flags: cli
+        slug: Neuron-PHP/cli
+        fail_ci_if_error: true

.version.json

@@ -2,6 +2,6 @@
   "strategy": "semver",
   "major": 0,
   "minor": 8,
-  "patch": 8,
+  "patch": 9,
   "build": 0
 }

composer.json

@@ -25,7 +25,8 @@
     },
     "autoload-dev": {
         "psr-4": {
-            "Tests\\": "tests/"
+            "Tests\\": "tests/",
+            "Neuron\\Core\\": "../core/src/Core/"
         }
     },
     "bin": [

readme.md

@@ -1,4 +1,5 @@
 [![CI](https://github.com/Neuron-PHP/cli/actions/workflows/ci.yml/badge.svg)](https://github.com/Neuron-PHP/cli/actions)
+[![codecov](https://codecov.io/gh/Neuron-PHP/cli/branch/develop/graph/badge.svg)](https://codecov.io/gh/Neuron-PHP/cli)
 # Neuron CLI Component
 
 A unified command-line interface for the Neuron PHP framework that provides a modern, extensible CLI tool for all Neuron components.
@@ -473,6 +474,10 @@ public function execute(): int
 
 ## Testing Your Commands
 
+The CLI component provides comprehensive testing support, including the ability to test commands that require user input.
+
+### Testing Commands Without User Input
+
 ```php
 use PHPUnit\Framework\TestCase;
 use Neuron\Cli\Console\Input;
@@ -483,23 +488,155 @@ class MakeControllerCommandTest extends TestCase
     public function testExecute(): void
     {
         $command = new MakeControllerCommand();
-        
+
         // Mock input
         $input = new Input(['UserController', '--resource']);
         $output = new Output(false); // No colors for testing
-        
+
         $command->setInput($input);
         $command->setOutput($output);
         $command->configure();
         $input->parse($command);
-        
+
         $exitCode = $command->execute();
-        
+
         $this->assertEquals(0, $exitCode);
     }
 }
 ```
 
+### Testing Commands With User Input
+
+Commands that use `prompt()`, `confirm()`, `secret()`, or `choice()` can be tested using the `TestInputReader`:
+
+```php
+use PHPUnit\Framework\TestCase;
+use Neuron\Cli\Console\Input;
+use Neuron\Cli\Console\Output;
+use Neuron\Cli\IO\TestInputReader;
+
+class SetupCommandTest extends TestCase
+{
+    public function testInteractiveSetup(): void
+    {
+        $command = new SetupCommand();
+
+        // Create test input reader with pre-programmed responses
+        $inputReader = new TestInputReader();
+        $inputReader->addResponse('my-project');        // Project name
+        $inputReader->addResponse('John Doe');          // Author name
+        $inputReader->addResponse('john@example.com');  // Email
+        $inputReader->addResponse('yes');               // Confirmation
+
+        // Configure command
+        $input = new Input([]);
+        $output = new Output(false);
+
+        $command->setInput($input);
+        $command->setOutput($output);
+        $command->setInputReader($inputReader);
+
+        // Execute command
+        $exitCode = $command->execute();
+
+        // Assertions
+        $this->assertEquals(0, $exitCode);
+
+        // Verify the prompts that were shown
+        $prompts = $inputReader->getPromptHistory();
+        $this->assertCount(4, $prompts);
+        $this->assertStringContainsString('Project name', $prompts[0]);
+        $this->assertStringContainsString('Author name', $prompts[1]);
+    }
+
+    public function testUserCancelsSetup(): void
+    {
+        $command = new SetupCommand();
+
+        // User will cancel the setup
+        $inputReader = new TestInputReader();
+        $inputReader->addResponses([
+            'test-project',
+            'Test User',
+            'test@example.com',
+            'no'  // Cancel confirmation
+        ]);
+
+        $input = new Input([]);
+        $output = new Output(false);
+
+        $command->setInput($input);
+        $command->setOutput($output);
+        $command->setInputReader($inputReader);
+
+        $exitCode = $command->execute();
+
+        // Should return non-zero exit code when cancelled
+        $this->assertNotEquals(0, $exitCode);
+    }
+}
+```
+
+### Using Input Reader in Commands
+
+To make your commands testable, use the convenience methods provided by the `Command` base class:
+
+```php
+class SetupCommand extends Command
+{
+    public function execute(): int
+    {
+        // Use built-in convenience methods instead of reading STDIN directly
+        $name = $this->prompt('Enter project name: ');
+
+        if ($this->confirm('Enable caching?', true)) {
+            // User confirmed
+        }
+
+        $password = $this->secret('Enter password: ');
+
+        $env = $this->choice(
+            'Select environment:',
+            ['development', 'staging', 'production'],
+            'development'
+        );
+
+        return 0;
+    }
+}
+```
+
+These convenience methods automatically use the injected `IInputReader`, making your commands fully testable without requiring actual user input.
+
+### TestInputReader Features
+
+The `TestInputReader` class provides:
+
+- **Response Queue**: Pre-program multiple responses with `addResponse()` or `addResponses()`
+- **Prompt History**: Track all prompts shown with `getPromptHistory()`
+- **Automatic Validation**: Throws exceptions if responses run out, helping catch test bugs
+- **Fluent Interface**: Chain `addResponse()` calls for cleaner test setup
+- **Full Interface Support**: Implements all `IInputReader` methods (prompt, confirm, secret, choice)
+
+```php
+$reader = new TestInputReader();
+$reader
+    ->addResponse('value1')
+    ->addResponse('value2')
+    ->addResponse('yes');
+
+// Check if there are responses remaining
+if ($reader->hasMoreResponses()) {
+    $count = $reader->getRemainingResponseCount();
+}
+
+// Get history of prompts
+$prompts = $reader->getPromptHistory();
+
+// Reset for reuse
+$reader->reset();
+```
+
 ## Contributing
 
 When adding new features to the CLI component: