Merge branch 'master' into 4.x

Author: jrfnl

.github/workflows/test.yml

@@ -227,23 +227,30 @@ jobs:
             echo 'FILE=phpunit-lte9.xml.dist' >> "$GITHUB_OUTPUT"
           fi
 
-      # Note: The code style check is run multiple times against every PHP version
-      # as it also acts as an integration test.
       - name: 'PHPCS: set the path to PHP'
         run: php "bin/phpcs" --config-set php_path php
 
       - name: 'PHPUnit: run the full test suite without code coverage'
         if: ${{ matrix.skip_tests != true }}
         run: php "vendor/bin/phpunit" -c ${{ steps.phpunit_config.outputs.FILE }} --no-coverage
 
+      # Do one test run against the complete test suite in CBF mode to ensure all tests can run in CBF mode.
+      - name: 'PHPUnit: run the full test suite without code coverage in CBF mode (PHP 8.3 only)'
+        if: ${{ matrix.php == '8.3' }}
+        run: php "vendor/bin/phpunit" -c ${{ steps.phpunit_config.outputs.FILE }} --exclude-group nothing --no-coverage
+        env:
+          PHP_CODESNIFFER_CBF: '1'
+
       - name: 'PHPUnit: run select tests in CBF mode'
-        if: ${{ matrix.skip_tests != true }}
+        if: ${{ matrix.skip_tests != true && matrix.php != '8.3' }}
         run: >
           php "vendor/bin/phpunit" -c ${{ steps.phpunit_config.outputs.FILE }} --no-coverage
           --group CBF --exclude-group nothing
         env:
           PHP_CODESNIFFER_CBF: '1'
 
+      # Note: The code style check is run multiple times against every PHP version
+      # as it also acts as an integration test.
       - name: 'PHPCS: check code style without cache, no parallel'
         if: ${{ matrix.custom_ini == false }}
         run: php "bin/phpcs" --no-cache --parallel=1

tests/Core/Config/GeneratorArgTest.php

@@ -20,6 +20,20 @@ final class GeneratorArgTest extends TestCase
 {
 
 
+    /**
+     * Skip these tests when in CBF mode.
+     *
+     * @return void
+     */
+    protected function setUp(): void
+    {
+        if (PHP_CODESNIFFER_CBF === true) {
+            $this->markTestSkipped('This test needs CS mode to run');
+        }
+
+    }//end setUp()
+
+
     /**
      * Ensure that the generator property is set when the parameter is passed a valid value.
      *

tests/Core/Config/SniffsExcludeArgsTest.php

@@ -34,6 +34,11 @@ final class SniffsExcludeArgsTest extends TestCase
      */
     public function testInvalid($argument, $value, $errors, $suggestion)
     {
+        $cmd = 'phpcs';
+        if (PHP_CODESNIFFER_CBF === true) {
+            $cmd = 'phpcbf';
+        }
+
         $exception = 'PHP_CodeSniffer\Exceptions\DeepExitException';
         $message   = 'ERROR: The --'.$argument.' option only supports sniff codes.'.PHP_EOL;
         $message  .= 'Sniff codes are in the form "Standard.Category.Sniff".'.PHP_EOL;
@@ -47,7 +52,7 @@ public function testInvalid($argument, $value, $errors, $suggestion)
         }
 
         $message .= PHP_EOL;
-        $message .= 'Run "phpcs --help" for usage information'.PHP_EOL;
+        $message .= "Run \"{$cmd} --help\" for usage information".PHP_EOL;
         $message .= PHP_EOL;
 
         $this->expectException($exception);

tests/Core/Ruleset/DisplayCachedMessagesTest.php

@@ -237,18 +237,24 @@ public function testNonBlockingErrorsDoNotShowUnderSpecificCircumstances($config
      */
     public static function dataSelectiveDisplayOfMessages()
     {
-        return [
-            'Explain mode'               => [
+        $data = [
+            'Explain mode' => [
                 'configArgs' => ['-e'],
             ],
-            'Quiet mode'                 => [
+            'Quiet mode'   => [
                 'configArgs' => ['-q'],
             ],
-            'Documentation is requested' => [
-                'configArgs' => ['--generator=text'],
-            ],
         ];
 
+        // Setting the `--generator` arg is only supported when running `phpcs`.
+        if (PHP_CODESNIFFER_CBF === false) {
+            $data['Documentation is requested'] = [
+                'configArgs' => ['--generator=text'],
+            ];
+        }
+
+        return $data;
+
     }//end dataSelectiveDisplayOfMessages()