Test project for media files management.
<?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Api;
use function array_flip;
use function array_key_exists;
use function array_unique;
use function assert;
use function strtolower;
use function trim;
use PHPUnit\Framework\TestSize\TestSize;
use PHPUnit\Metadata\Covers;
use PHPUnit\Metadata\CoversClass;
use PHPUnit\Metadata\CoversFunction;
use PHPUnit\Metadata\Group;
use PHPUnit\Metadata\Parser\Registry;
use PHPUnit\Metadata\Uses;
use PHPUnit\Metadata\UsesClass;
use PHPUnit\Metadata\UsesFunction;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Groups
{
/**
* @var array<string, array<int, string>>
*/
private static array $groupCache = [];
/**
* @param class-string $className
* @param non-empty-string $methodName
*
* @return array<int, string>
*/
public function groups(string $className, string $methodName, bool $includeVirtual = true): array
{
$key = $className . '::' . $methodName . '::' . $includeVirtual;
if (array_key_exists($key, self::$groupCache)) {
return self::$groupCache[$key];
}
$groups = [];
foreach (Registry::parser()->forClassAndMethod($className, $methodName)->isGroup() as $group) {
assert($group instanceof Group);
$groups[] = $group->groupName();
}
if ($groups === []) {
$groups[] = 'default';
}
if (!$includeVirtual) {
return self::$groupCache[$key] = array_unique($groups);
}
foreach (Registry::parser()->forClassAndMethod($className, $methodName) as $metadata) {
if ($metadata->isCoversClass() || $metadata->isCoversFunction()) {
/** @phpstan-ignore booleanOr.alwaysTrue */
assert($metadata instanceof CoversClass || $metadata instanceof CoversFunction);
$groups[] = '__phpunit_covers_' . $this->canonicalizeName($metadata->asStringForCodeUnitMapper());
continue;
}
if ($metadata->isCovers()) {
assert($metadata instanceof Covers);
$groups[] = '__phpunit_covers_' . $this->canonicalizeName($metadata->target());
continue;
}
if ($metadata->isUsesClass() || $metadata->isUsesFunction()) {
/** @phpstan-ignore booleanOr.alwaysTrue */
assert($metadata instanceof UsesClass || $metadata instanceof UsesFunction);
$groups[] = '__phpunit_uses_' . $this->canonicalizeName($metadata->asStringForCodeUnitMapper());
continue;
}
if ($metadata->isUses()) {
assert($metadata instanceof Uses);
$groups[] = '__phpunit_uses_' . $this->canonicalizeName($metadata->target());
}
}
return self::$groupCache[$key] = array_unique($groups);
}
/**
* @param class-string $className
* @param non-empty-string $methodName
*/
public function size(string $className, string $methodName): TestSize
{
$groups = array_flip($this->groups($className, $methodName));
if (isset($groups['large'])) {
return TestSize::large();
}
if (isset($groups['medium'])) {
return TestSize::medium();
}
if (isset($groups['small'])) {
return TestSize::small();
}
return TestSize::unknown();
}
private function canonicalizeName(string $name): string
{
return strtolower(trim($name, '\\'));
}
}