Merge branch '10.5' into 11.0

Author: sebastianbergmann

tests/end-to-end/code-coverage/code-coverage.phpt

@@ -0,0 +1,43 @@
+--TEST--
+Add tests for code coverage attributes for class, method, function
+--INI--
+pcov.directory=tests/end-to-end/code-coverage/code-coverage
+--SKIPIF--
+<?php declare(strict_types=1);
+require __DIR__ . '/../../_files/skip-if-requires-code-coverage-driver.php';
+--FILE--
+<?php declare(strict_types=1);
+$_SERVER['argv'][] = '--do-not-cache-result';
+$_SERVER['argv'][] = '--colors=never';
+$_SERVER['argv'][] = '--coverage-text';
+$_SERVER['argv'][] = '--configuration';
+$_SERVER['argv'][] = __DIR__ . '/code-coverage/phpunit.xml';
+
+require_once __DIR__ . '/../../bootstrap.php';
+
+(new PHPUnit\TextUI\Application)->run($_SERVER['argv']);
+--EXPECTF--
+PHPUnit %s by Sebastian Bergmann and contributors.
+
+Runtime: %s
+Configuration: %s
+
+...                                                                 3 / 3 (100%)
+
+Time: %s, Memory: %s MB
+
+OK (3 tests, 3 assertions)
+
+
+Code Coverage Report:
+  %s
+
+ Summary:
+  Classes: 50.00% (1/2)
+  Methods: 50.00% (2/4)
+  Lines:   50.00% (3/6)
+
+PHPUnit\TestFixture\CodeCoverage\FullyTestedClass
+  Methods: 100.00% ( 1/ 1)   Lines: 100.00% (  1/  1)
+PHPUnit\TestFixture\CodeCoverage\Method
+  Methods:  33.33% ( 1/ 3)   Lines:  33.33% (  1/  3)

tests/end-to-end/code-coverage/code-coverage/bootstrap.php

@@ -0,0 +1,16 @@
+<?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.
+ */
+require_once __DIR__ . '/src/Method.php';
+
+require_once __DIR__ . '/src/FullyTestedClass.php';
+
+require_once __DIR__ . '/src/functions.php';

tests/end-to-end/code-coverage/code-coverage/phpunit.xml

@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:noNamespaceSchemaLocation="../../../../phpunit.xsd"
+         bootstrap="bootstrap.php"
+         executionOrder="depends,defects"
+         requireCoverageMetadata="true"
+         beStrictAboutCoverageMetadata="true"
+         beStrictAboutOutputDuringTests="true"
+         failOnRisky="true"
+         failOnWarning="true">
+    <testsuites>
+        <testsuite name="default">
+            <directory>tests</directory>
+        </testsuite>
+    </testsuites>
+
+    <source restrictDeprecations="true" restrictNotices="true" restrictWarnings="true">
+        <include>
+            <directory>src</directory>
+        </include>
+    </source>
+</phpunit>

tests/end-to-end/code-coverage/code-coverage/src/FullyTestedClass.php

@@ -0,0 +1,29 @@
+<?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\CodeCoverage;
+
+/*
+ * 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.
+ */
+
+class FullyTestedClass
+{
+    public function method(): bool
+    {
+        return true;
+    }
+}

tests/end-to-end/code-coverage/code-coverage/src/Method.php

@@ -0,0 +1,30 @@
+<?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\CodeCoverage;
+
+final class Method
+{
+    public function greet(): string
+    {
+        return $this->internalMethod();
+    }
+
+    public function unusedPublicMethod(): string
+    {
+        return 'never returned';
+    }
+
+    private function internalMethod(): string
+    {
+        return 'Hello, World!';
+    }
+}

tests/end-to-end/code-coverage/code-coverage/src/functions.php

@@ -0,0 +1,31 @@
+<?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\CodeCoverage;
+
+/*
+ * 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.
+ */
+
+function fixture_for_phpunit_code_coverage(): bool
+{
+    return true;
+}
+
+function fixture_for_phpunit_code_coverage_not_called(): bool
+{
+    return false;
+}

tests/end-to-end/code-coverage/code-coverage/tests/FullyTestedClassTest.php

@@ -0,0 +1,33 @@
+<?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\CodeCoverage;
+
+/*
+ * 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.
+ */
+
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\TestCase;
+
+#[CoversClass(FullyTestedClass::class)]
+class FullyTestedClassTest extends TestCase
+{
+    public function testMethod(): void
+    {
+        $this->assertTrue((new FullyTestedClass)->method());
+    }
+}

tests/end-to-end/code-coverage/code-coverage/tests/FunctionTest.php

@@ -0,0 +1,33 @@
+<?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\CodeCoverage;
+
+/*
+ * 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.
+ */
+
+use PHPUnit\Framework\Attributes\CoversFunction;
+use PHPUnit\Framework\TestCase;
+
+#[CoversFunction('\PHPUnit\TestFixture\CodeCoverage\fixture_for_phpunit_code_coverage')]
+class FunctionTest extends TestCase
+{
+    public function testFunction(): void
+    {
+        $this->assertTrue(fixture_for_phpunit_code_coverage());
+    }
+}

tests/end-to-end/code-coverage/code-coverage/tests/MethodTest.php

@@ -0,0 +1,24 @@
+<?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\CodeCoverage;
+
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\TestCase;
+
+#[CoversClass(Method::class)]
+final class MethodTest extends TestCase
+{
+    public function testMethod(): void
+    {
+        $this->assertSame('Hello, World!', (new Method)->greet());
+    }
+}