pest/src/Factories/Attributes/Covers.php

<?php

declare(strict_types=1);

namespace Pest\Factories\Attributes;

use Pest\Factories\Covers\CoversClass;
use Pest\Factories\Covers\CoversFunction;
use Pest\Factories\TestCaseMethodFactory;

/**
 * @internal
 */
final class Covers extends Attribute
{
    /**
     * Determine if the attribute should be placed above the class instead of above the method.
     */
    public static bool $above = true;

    /**
     * Adds attributes regarding the "covers" feature.
     *
     * @param  array<int, string>  $attributes
     * @return array<int, string>
     */
    public function __invoke(TestCaseMethodFactory $method, array $attributes): array
    {
        foreach ($method->covers as $covering) {
            if ($covering instanceof CoversClass) {
                // Prepend a backslash for FQN classes
                if (str_contains($covering->class, '\\')) {
                    $covering->class = '\\'.$covering->class;
                }

                $attributes[] = "#[\PHPUnit\Framework\Attributes\CoversClass({$covering->class}::class)]";
            } elseif ($covering instanceof CoversFunction) {
                $attributes[] = "#[\PHPUnit\Framework\Attributes\CoversFunction('{$covering->function}')]";
            }
        }

        return $attributes;
    }
}