Document the fact that CoversClass and UsesClass implicitly target traits used by the targeted classes

Author: sebastianbergmann

tests/_files/CoveredClassUsingCoveredTrait.php

@@ -0,0 +1,27 @@
+<?php declare(strict_types=1);
+/*
+ * This file is part of PHPUnit.
+ *
+ * (c) Sebastian Bergmann <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+namespace PHPUnit\TestFixture;
+
+final class CoveredClassUsingCoveredTrait
+{
+    use CoveredTrait;
+
+    public function publicMethod(): void
+    {
+    }
+
+    protected function protectedMethod(): void
+    {
+    }
+
+    private function privateMethod(): void
+    {
+    }
+}

tests/_files/CoveredClassUsingCoveredTraitTest.php

@@ -0,0 +1,23 @@
+<?php declare(strict_types=1);
+/*
+ * This file is part of PHPUnit.
+ *
+ * (c) Sebastian Bergmann <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+namespace PHPUnit\TestFixture;
+
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\Attributes\UsesClass;
+use PHPUnit\Framework\TestCase;
+
+#[CoversClass(CoveredClassUsingCoveredTrait::class)]
+#[UsesClass(CoveredClassUsingCoveredTrait::class)]
+final class CoveredClassUsingCoveredTraitTest extends TestCase
+{
+    public function testSomething(): void
+    {
+    }
+}

tests/unit/Metadata/Api/CodeCoverageTest.php

@@ -36,6 +36,7 @@
 use PHPUnit\TestFixture\CoverageNoneTest;
 use PHPUnit\TestFixture\CoverageTraitMethodTest;
 use PHPUnit\TestFixture\CoverageTraitTest;
+use PHPUnit\TestFixture\CoveredClassUsingCoveredTraitTest;
 use PHPUnit\TestFixture\InterfaceAsTargetWithAttributeTest;
 use PHPUnit\TestFixture\InterfaceTargetTest;
 use PHPUnit\TestFixture\InvalidClassTargetWithAnnotationTest;
@@ -129,6 +130,15 @@ public static function linesToBeCoveredProvider(): array
                 'testSomething',
             ],
 
+            [
+                [
+                    TEST_FILES_PATH . 'CoveredClassUsingCoveredTrait.php' => range(12, 27),
+                    TEST_FILES_PATH . 'CoveredTrait.php'                  => range(12, 18),
+                ],
+                CoveredClassUsingCoveredTraitTest::class,
+                'testSomething',
+            ],
+
             [
                 [
                     TEST_FILES_PATH . 'CoveredClass.php' => range(14, 18),
@@ -296,6 +306,15 @@ public static function linesToBeUsedProvider(): array
                 'testSomething',
             ],
 
+            [
+                [
+                    TEST_FILES_PATH . 'CoveredClassUsingCoveredTrait.php' => range(12, 27),
+                    TEST_FILES_PATH . 'CoveredTrait.php'                  => range(12, 18),
+                ],
+                CoveredClassUsingCoveredTraitTest::class,
+                'testSomething',
+            ],
+
             [
                 [
                     TEST_FILES_PATH . 'CoveredFunction.php' => range(10, 12),