Implement --do-not-report-useless-tests CLI option to replace --dont-report-useless-tests

Author: sebastianbergmann

ChangeLog-10.5.md

@@ -2,6 +2,16 @@
 
 All notable changes of the PHPUnit 10.5 release series are documented in this file using the [Keep a CHANGELOG](https://keepachangelog.com/) principles.
 
+## [10.5.47] - 2025-MM-DD
+
+### Added
+
+* `--do-not-report-useless-tests` CLI option as a replacement for `--dont-report-useless-tests`
+
+### Deprecated
+
+* `--dont-report-useless-tests` CLI option (use `--do-not-report-useless-tests` instead)
+
 ## [10.5.46] - 2025-05-02
 
 ### Added
@@ -414,6 +424,7 @@ All notable changes of the PHPUnit 10.5 release series are documented in this fi
 
 * [#5563](https://github.com/sebastianbergmann/phpunit/issues/5563): `createMockForIntersectionOfInterfaces()` does not automatically register mock object for expectation verification
 
+[10.5.47]: https://github.com/sebastianbergmann/phpunit/compare/10.5.46...10.5
 [10.5.46]: https://github.com/sebastianbergmann/phpunit/compare/10.5.45...10.5.46
 [10.5.45]: https://github.com/sebastianbergmann/phpunit/compare/10.5.44...10.5.45
 [10.5.44]: https://github.com/sebastianbergmann/phpunit/compare/10.5.43...10.5.44

src/TextUI/Configuration/Cli/Builder.php

@@ -95,6 +95,7 @@ final class Builder
         'no-results',
         'order-by=',
         'process-isolation',
+        'do-not-report-useless-tests',
         'dont-report-useless-tests',
         'random-order',
         'random-order-seed=',
@@ -737,6 +738,7 @@ public function fromParameters(array $parameters): Configuration
 
                     break;
 
+                case '--do-not-report-useless-tests':
                 case '--dont-report-useless-tests':
                     $reportUselessTests = false;
 

src/TextUI/Help.php

@@ -194,7 +194,7 @@ private function elements(): array
                 ['arg'    => '--disallow-test-output', 'desc' => 'Be strict about output during tests'],
                 ['arg'    => '--enforce-time-limit', 'desc' => 'Enforce time limit based on test size'],
                 ['arg'    => '--default-time-limit <sec>', 'desc' => 'Timeout in seconds for tests that have no declared size'],
-                ['arg'    => '--dont-report-useless-tests', 'desc' => 'Do not report tests that do not test anything'],
+                ['arg'    => '--do-not-report-useless-tests', 'desc' => 'Do not report tests that do not test anything'],
                 ['spacer' => ''],
 
                 ['arg'    => '--stop-on-defect', 'desc' => 'Stop after first error, failure, warning, or risky test'],

tests/end-to-end/_files/output-cli-help-color.txt

@@ -53,7 +53,7 @@
   --enforce-time-limit               Enforce time limit based on test size
   --default-time-limit <sec>         Timeout in seconds for tests that have no
                                      declared size
-  --dont-report-useless-tests        Do not report tests that do not test
+  --do-not-report-useless-tests      Do not report tests that do not test
                                      anything
 
   --stop-on-defect                   Stop after first error, failure, warning,

tests/end-to-end/_files/output-cli-usage.txt

@@ -44,7 +44,7 @@ Execution:
   --disallow-test-output             Be strict about output during tests
   --enforce-time-limit               Enforce time limit based on test size
   --default-time-limit <sec>         Timeout in seconds for tests that have no declared size
-  --dont-report-useless-tests        Do not report tests that do not test anything
+  --do-not-report-useless-tests      Do not report tests that do not test anything
 
   --stop-on-defect                   Stop after first error, failure, warning, or risky test
   --stop-on-error                    Stop after first error

tests/end-to-end/generic/exception-stack.phpt

@@ -4,7 +4,7 @@ phpunit ../../_files/ExceptionStackTest.php
 <?php declare(strict_types=1);
 $_SERVER['argv'][] = '--do-not-cache-result';
 $_SERVER['argv'][] = '--no-configuration';
-$_SERVER['argv'][] = '--dont-report-useless-tests';
+$_SERVER['argv'][] = '--do-not-report-useless-tests';
 $_SERVER['argv'][] = __DIR__ . '/../../_files/ExceptionStackTest.php';
 
 require_once __DIR__ . '/../../bootstrap.php';

tests/end-to-end/generic/transform-exception-hook-method.phpt

@@ -3,7 +3,7 @@ https://github.com/sebastianbergmann/phpunit/issues/5300
 --FILE--
 <?php declare(strict_types=1);
 $_SERVER['argv'][] = '--do-not-cache-result';
-$_SERVER['argv'][] = '--dont-report-useless-tests';
+$_SERVER['argv'][] = '--do-not-report-useless-tests';
 $_SERVER['argv'][] = '--configuration';
 $_SERVER['argv'][] = __DIR__ . '/../_files/transform-exception-hook-method';
 

tests/end-to-end/logging/junit/with-progress-with-errors.phpt

@@ -11,7 +11,7 @@ $logfile = tempnam(sys_get_temp_dir(), __FILE__);
 
 $_SERVER['argv'][] = '--do-not-cache-result';
 $_SERVER['argv'][] = '--no-configuration';
-$_SERVER['argv'][] = '--dont-report-useless-tests';
+$_SERVER['argv'][] = '--do-not-report-useless-tests';
 $_SERVER['argv'][] = '--log-junit';
 $_SERVER['argv'][] = $logfile;
 $_SERVER['argv'][] = __DIR__ . '/../_files/TypeErrorTest.php';

tests/end-to-end/logging/teamcity/teamcity-inner-exceptions.phpt

@@ -4,7 +4,7 @@ phpunit --log-teamcity php://stdout ../../_files/ExceptionStackTest.php
 <?php declare(strict_types=1);
 $_SERVER['argv'][] = '--do-not-cache-result';
 $_SERVER['argv'][] = '--no-configuration';
-$_SERVER['argv'][] = '--dont-report-useless-tests';
+$_SERVER['argv'][] = '--do-not-report-useless-tests';
 $_SERVER['argv'][] = '--no-output';
 $_SERVER['argv'][] = '--log-teamcity';
 $_SERVER['argv'][] = 'php://stdout';

tests/end-to-end/regression/4376.phpt

@@ -3,7 +3,7 @@ https://github.com/sebastianbergmann/phpunit/issues/4376
 --FILE--
 <?php declare(strict_types=1);
 $_SERVER['argv'][] = '--do-not-cache-result';
-$_SERVER['argv'][] = '--dont-report-useless-tests';
+$_SERVER['argv'][] = '--do-not-report-useless-tests';
 $_SERVER['argv'][] = '--configuration';
 $_SERVER['argv'][] = __DIR__ . '/4376/';