diff --git a/src/Framework/TestListener.php b/src/Framework/TestListener.php index 96ce4eec737..a29fcdeee35 100644 --- a/src/Framework/TestListener.php +++ b/src/Framework/TestListener.php @@ -12,73 +12,32 @@ 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. + * + * @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 35ded5d09da..871c8a34a21 100644 --- a/src/Runner/Hook/AfterIncompleteTestHook.php +++ b/src/Runner/Hook/AfterIncompleteTestHook.php @@ -9,6 +9,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. + * + * @see https://github.com/sebastianbergmann/phpunit/issues/4676 + */ interface AfterIncompleteTestHook extends TestHook { public function executeAfterIncompleteTest(string $test, string $message, float $time): void; diff --git a/src/Runner/Hook/AfterLastTestHook.php b/src/Runner/Hook/AfterLastTestHook.php index 7dee9f9e8b7..34f58e07e43 100644 --- a/src/Runner/Hook/AfterLastTestHook.php +++ b/src/Runner/Hook/AfterLastTestHook.php @@ -9,6 +9,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. + * + * @see https://github.com/sebastianbergmann/phpunit/issues/4676 + */ interface AfterLastTestHook extends Hook { public function executeAfterLastTest(): void; diff --git a/src/Runner/Hook/AfterRiskyTestHook.php b/src/Runner/Hook/AfterRiskyTestHook.php index 7fe9ee72ecd..f0417ac3285 100644 --- a/src/Runner/Hook/AfterRiskyTestHook.php +++ b/src/Runner/Hook/AfterRiskyTestHook.php @@ -9,6 +9,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. + * + * @see https://github.com/sebastianbergmann/phpunit/issues/4676 + */ interface AfterRiskyTestHook extends TestHook { public function executeAfterRiskyTest(string $test, string $message, float $time): void; diff --git a/src/Runner/Hook/AfterSkippedTestHook.php b/src/Runner/Hook/AfterSkippedTestHook.php index f9253b5ba46..f0c914f738c 100644 --- a/src/Runner/Hook/AfterSkippedTestHook.php +++ b/src/Runner/Hook/AfterSkippedTestHook.php @@ -9,6 +9,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. + * + * @see https://github.com/sebastianbergmann/phpunit/issues/4676 + */ interface AfterSkippedTestHook extends TestHook { public function executeAfterSkippedTest(string $test, string $message, float $time): void; diff --git a/src/Runner/Hook/AfterSuccessfulTestHook.php b/src/Runner/Hook/AfterSuccessfulTestHook.php index 6b55cc877e9..b7625793603 100644 --- a/src/Runner/Hook/AfterSuccessfulTestHook.php +++ b/src/Runner/Hook/AfterSuccessfulTestHook.php @@ -9,6 +9,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. + * + * @see https://github.com/sebastianbergmann/phpunit/issues/4676 + */ interface AfterSuccessfulTestHook extends TestHook { public function executeAfterSuccessfulTest(string $test, float $time): void; diff --git a/src/Runner/Hook/AfterTestErrorHook.php b/src/Runner/Hook/AfterTestErrorHook.php index f5c23fb2156..15824b0507a 100644 --- a/src/Runner/Hook/AfterTestErrorHook.php +++ b/src/Runner/Hook/AfterTestErrorHook.php @@ -9,6 +9,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. + * + * @see https://github.com/sebastianbergmann/phpunit/issues/4676 + */ interface AfterTestErrorHook extends TestHook { public function executeAfterTestError(string $test, string $message, float $time): void; diff --git a/src/Runner/Hook/AfterTestFailureHook.php b/src/Runner/Hook/AfterTestFailureHook.php index 9ed2939bf13..d12e553c3da 100644 --- a/src/Runner/Hook/AfterTestFailureHook.php +++ b/src/Runner/Hook/AfterTestFailureHook.php @@ -9,6 +9,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. + * + * @see https://github.com/sebastianbergmann/phpunit/issues/4676 + */ interface AfterTestFailureHook extends TestHook { public function executeAfterTestFailure(string $test, string $message, float $time): void; diff --git a/src/Runner/Hook/AfterTestHook.php b/src/Runner/Hook/AfterTestHook.php index 7e0af80b12f..53effae8030 100644 --- a/src/Runner/Hook/AfterTestHook.php +++ b/src/Runner/Hook/AfterTestHook.php @@ -9,6 +9,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. + * + * @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 12de80f9c91..ad2ab13ee35 100644 --- a/src/Runner/Hook/AfterTestWarningHook.php +++ b/src/Runner/Hook/AfterTestWarningHook.php @@ -9,6 +9,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. + * + * @see https://github.com/sebastianbergmann/phpunit/issues/4676 + */ interface AfterTestWarningHook extends TestHook { public function executeAfterTestWarning(string $test, string $message, float $time): void; diff --git a/src/Runner/Hook/BeforeFirstTestHook.php b/src/Runner/Hook/BeforeFirstTestHook.php index 59b66664984..8d580f4f4be 100644 --- a/src/Runner/Hook/BeforeFirstTestHook.php +++ b/src/Runner/Hook/BeforeFirstTestHook.php @@ -9,6 +9,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. + * + * @see https://github.com/sebastianbergmann/phpunit/issues/4676 + */ interface BeforeFirstTestHook extends Hook { public function executeBeforeFirstTest(): void; diff --git a/src/Runner/Hook/BeforeTestHook.php b/src/Runner/Hook/BeforeTestHook.php index 8bbf8a99d77..c69c12e0a88 100644 --- a/src/Runner/Hook/BeforeTestHook.php +++ b/src/Runner/Hook/BeforeTestHook.php @@ -9,6 +9,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. + * + * @see https://github.com/sebastianbergmann/phpunit/issues/4676 + */ interface BeforeTestHook extends TestHook { public function executeBeforeTest(string $test): void; diff --git a/src/Runner/Hook/Hook.php b/src/Runner/Hook/Hook.php index 546f1a35164..36da047ad47 100644 --- a/src/Runner/Hook/Hook.php +++ b/src/Runner/Hook/Hook.php @@ -9,6 +9,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. + * + * @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 47c41f9eba7..86cf3f8e7b2 100644 --- a/src/Runner/Hook/TestHook.php +++ b/src/Runner/Hook/TestHook.php @@ -9,6 +9,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. + * + * @see https://github.com/sebastianbergmann/phpunit/issues/4676 + */ interface TestHook extends Hook { }