diff --git a/src/Framework/TestListener.php b/src/Framework/TestListener.php index aaf5e7cd978..eade600f209 100644 --- a/src/Framework/TestListener.php +++ b/src/Framework/TestListener.php @@ -12,74 +12,34 @@ use Throwable; /** - * @deprecated Use the `TestHook` interfaces instead + * This interface, as well as the associated mechanism for extending PHPUnit, + * will be removed in PHPUnit 10. There is no alternative available in this + * version of PHPUnit. + * * @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit + * + * @deprecated + * @see https://github.com/sebastianbergmann/phpunit/issues/4676 */ interface TestListener { - /** - * An error occurred. - * - * @deprecated Use `AfterTestErrorHook::executeAfterTestError` instead - */ public function addError(Test $test, Throwable $t, float $time): void; - /** - * A warning occurred. - * - * @deprecated Use `AfterTestWarningHook::executeAfterTestWarning` instead - */ public function addWarning(Test $test, Warning $e, float $time): void; - /** - * A failure occurred. - * - * @deprecated Use `AfterTestFailureHook::executeAfterTestFailure` instead - */ public function addFailure(Test $test, AssertionFailedError $e, float $time): void; - /** - * Incomplete test. - * - * @deprecated Use `AfterIncompleteTestHook::executeAfterIncompleteTest` instead - */ public function addIncompleteTest(Test $test, Throwable $t, float $time): void; - /** - * Risky test. - * - * @deprecated Use `AfterRiskyTestHook::executeAfterRiskyTest` instead - */ public function addRiskyTest(Test $test, Throwable $t, float $time): void; - /** - * Skipped test. - * - * @deprecated Use `AfterSkippedTestHook::executeAfterSkippedTest` instead - */ public function addSkippedTest(Test $test, Throwable $t, float $time): void; - /** - * A test suite started. - */ public function startTestSuite(TestSuite $suite): void; - /** - * A test suite ended. - */ public function endTestSuite(TestSuite $suite): void; - /** - * A test started. - * - * @deprecated Use `BeforeTestHook::executeBeforeTest` instead - */ public function startTest(Test $test): void; - /** - * A test ended. - * - * @deprecated Use `AfterTestHook::executeAfterTest` instead - */ public function endTest(Test $test, float $time): void; } diff --git a/src/Runner/Hook/AfterIncompleteTestHook.php b/src/Runner/Hook/AfterIncompleteTestHook.php index 48441e6a22e..432be9a93a6 100644 --- a/src/Runner/Hook/AfterIncompleteTestHook.php +++ b/src/Runner/Hook/AfterIncompleteTestHook.php @@ -10,7 +10,13 @@ namespace PHPUnit\Runner; /** + * This interface, as well as the associated mechanism for extending PHPUnit, + * will be removed in PHPUnit 10. There is no alternative available in this + * version of PHPUnit. + * * @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit + * + * @see https://github.com/sebastianbergmann/phpunit/issues/4676 */ interface AfterIncompleteTestHook extends TestHook { diff --git a/src/Runner/Hook/AfterLastTestHook.php b/src/Runner/Hook/AfterLastTestHook.php index 29997b7522e..eb789f2643b 100644 --- a/src/Runner/Hook/AfterLastTestHook.php +++ b/src/Runner/Hook/AfterLastTestHook.php @@ -10,7 +10,13 @@ namespace PHPUnit\Runner; /** + * This interface, as well as the associated mechanism for extending PHPUnit, + * will be removed in PHPUnit 10. There is no alternative available in this + * version of PHPUnit. + * * @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit + * + * @see https://github.com/sebastianbergmann/phpunit/issues/4676 */ interface AfterLastTestHook extends Hook { diff --git a/src/Runner/Hook/AfterRiskyTestHook.php b/src/Runner/Hook/AfterRiskyTestHook.php index b45c77d2ad0..31cc91abf22 100644 --- a/src/Runner/Hook/AfterRiskyTestHook.php +++ b/src/Runner/Hook/AfterRiskyTestHook.php @@ -10,7 +10,13 @@ namespace PHPUnit\Runner; /** + * This interface, as well as the associated mechanism for extending PHPUnit, + * will be removed in PHPUnit 10. There is no alternative available in this + * version of PHPUnit. + * * @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit + * + * @see https://github.com/sebastianbergmann/phpunit/issues/4676 */ interface AfterRiskyTestHook extends TestHook { diff --git a/src/Runner/Hook/AfterSkippedTestHook.php b/src/Runner/Hook/AfterSkippedTestHook.php index 17b20253162..76980b3fcb5 100644 --- a/src/Runner/Hook/AfterSkippedTestHook.php +++ b/src/Runner/Hook/AfterSkippedTestHook.php @@ -10,7 +10,13 @@ namespace PHPUnit\Runner; /** + * This interface, as well as the associated mechanism for extending PHPUnit, + * will be removed in PHPUnit 10. There is no alternative available in this + * version of PHPUnit. + * * @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit + * + * @see https://github.com/sebastianbergmann/phpunit/issues/4676 */ interface AfterSkippedTestHook extends TestHook { diff --git a/src/Runner/Hook/AfterSuccessfulTestHook.php b/src/Runner/Hook/AfterSuccessfulTestHook.php index 7ceb30f1596..d0a10dd1566 100644 --- a/src/Runner/Hook/AfterSuccessfulTestHook.php +++ b/src/Runner/Hook/AfterSuccessfulTestHook.php @@ -10,7 +10,13 @@ namespace PHPUnit\Runner; /** + * This interface, as well as the associated mechanism for extending PHPUnit, + * will be removed in PHPUnit 10. There is no alternative available in this + * version of PHPUnit. + * * @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit + * + * @see https://github.com/sebastianbergmann/phpunit/issues/4676 */ interface AfterSuccessfulTestHook extends TestHook { diff --git a/src/Runner/Hook/AfterTestErrorHook.php b/src/Runner/Hook/AfterTestErrorHook.php index 5e21ce6adfb..12ecebd32cd 100644 --- a/src/Runner/Hook/AfterTestErrorHook.php +++ b/src/Runner/Hook/AfterTestErrorHook.php @@ -10,7 +10,13 @@ namespace PHPUnit\Runner; /** + * This interface, as well as the associated mechanism for extending PHPUnit, + * will be removed in PHPUnit 10. There is no alternative available in this + * version of PHPUnit. + * * @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit + * + * @see https://github.com/sebastianbergmann/phpunit/issues/4676 */ interface AfterTestErrorHook extends TestHook { diff --git a/src/Runner/Hook/AfterTestFailureHook.php b/src/Runner/Hook/AfterTestFailureHook.php index 011cca42634..94b2f3004a4 100644 --- a/src/Runner/Hook/AfterTestFailureHook.php +++ b/src/Runner/Hook/AfterTestFailureHook.php @@ -10,7 +10,13 @@ namespace PHPUnit\Runner; /** + * This interface, as well as the associated mechanism for extending PHPUnit, + * will be removed in PHPUnit 10. There is no alternative available in this + * version of PHPUnit. + * * @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit + * + * @see https://github.com/sebastianbergmann/phpunit/issues/4676 */ interface AfterTestFailureHook extends TestHook { diff --git a/src/Runner/Hook/AfterTestHook.php b/src/Runner/Hook/AfterTestHook.php index 451510ecf12..3d5bcaa93ce 100644 --- a/src/Runner/Hook/AfterTestHook.php +++ b/src/Runner/Hook/AfterTestHook.php @@ -10,7 +10,13 @@ namespace PHPUnit\Runner; /** + * This interface, as well as the associated mechanism for extending PHPUnit, + * will be removed in PHPUnit 10. There is no alternative available in this + * version of PHPUnit. + * * @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit + * + * @see https://github.com/sebastianbergmann/phpunit/issues/4676 */ interface AfterTestHook extends TestHook { diff --git a/src/Runner/Hook/AfterTestWarningHook.php b/src/Runner/Hook/AfterTestWarningHook.php index 0b782939d4e..860fcceeb80 100644 --- a/src/Runner/Hook/AfterTestWarningHook.php +++ b/src/Runner/Hook/AfterTestWarningHook.php @@ -10,7 +10,13 @@ namespace PHPUnit\Runner; /** + * This interface, as well as the associated mechanism for extending PHPUnit, + * will be removed in PHPUnit 10. There is no alternative available in this + * version of PHPUnit. + * * @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit + * + * @see https://github.com/sebastianbergmann/phpunit/issues/4676 */ interface AfterTestWarningHook extends TestHook { diff --git a/src/Runner/Hook/BeforeFirstTestHook.php b/src/Runner/Hook/BeforeFirstTestHook.php index b4ffdbd05f3..feeb90fbace 100644 --- a/src/Runner/Hook/BeforeFirstTestHook.php +++ b/src/Runner/Hook/BeforeFirstTestHook.php @@ -10,7 +10,13 @@ namespace PHPUnit\Runner; /** + * This interface, as well as the associated mechanism for extending PHPUnit, + * will be removed in PHPUnit 10. There is no alternative available in this + * version of PHPUnit. + * * @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit + * + * @see https://github.com/sebastianbergmann/phpunit/issues/4676 */ interface BeforeFirstTestHook extends Hook { diff --git a/src/Runner/Hook/BeforeTestHook.php b/src/Runner/Hook/BeforeTestHook.php index 381a6558f21..b7e0827d0a0 100644 --- a/src/Runner/Hook/BeforeTestHook.php +++ b/src/Runner/Hook/BeforeTestHook.php @@ -10,7 +10,13 @@ namespace PHPUnit\Runner; /** + * This interface, as well as the associated mechanism for extending PHPUnit, + * will be removed in PHPUnit 10. There is no alternative available in this + * version of PHPUnit. + * * @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit + * + * @see https://github.com/sebastianbergmann/phpunit/issues/4676 */ interface BeforeTestHook extends TestHook { diff --git a/src/Runner/Hook/Hook.php b/src/Runner/Hook/Hook.php index 9a957ce63d0..a08dc72b0cb 100644 --- a/src/Runner/Hook/Hook.php +++ b/src/Runner/Hook/Hook.php @@ -10,7 +10,13 @@ namespace PHPUnit\Runner; /** + * This interface, as well as the associated mechanism for extending PHPUnit, + * will be removed in PHPUnit 10. There is no alternative available in this + * version of PHPUnit. + * * @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit + * + * @see https://github.com/sebastianbergmann/phpunit/issues/4676 */ interface Hook { diff --git a/src/Runner/Hook/TestHook.php b/src/Runner/Hook/TestHook.php index f3387b4c8a8..31e880e2cef 100644 --- a/src/Runner/Hook/TestHook.php +++ b/src/Runner/Hook/TestHook.php @@ -10,7 +10,13 @@ namespace PHPUnit\Runner; /** + * This interface, as well as the associated mechanism for extending PHPUnit, + * will be removed in PHPUnit 10. There is no alternative available in this + * version of PHPUnit. + * * @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit + * + * @see https://github.com/sebastianbergmann/phpunit/issues/4676 */ interface TestHook extends Hook {