JFIF $
d d 7
Viewing File: /home/alphaedg/public_html/src/vendor/phpunit/phpunit/src/Metadata/Parser/AnnotationParser.php
<?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\Parser;
use function array_merge;
use function assert;
use function count;
use function explode;
use function method_exists;
use function preg_replace;
use function rtrim;
use function sprintf;
use function str_contains;
use function str_starts_with;
use function strlen;
use function substr;
use function trim;
use PHPUnit\Event\Facade as EventFacade;
use PHPUnit\Metadata\Annotation\Parser\Registry as AnnotationRegistry;
use PHPUnit\Metadata\AnnotationsAreNotSupportedForInternalClassesException;
use PHPUnit\Metadata\InvalidVersionRequirementException;
use PHPUnit\Metadata\Metadata;
use PHPUnit\Metadata\MetadataCollection;
use PHPUnit\Metadata\ReflectionException;
use PHPUnit\Metadata\Version\ComparisonRequirement;
use PHPUnit\Metadata\Version\ConstraintRequirement;
use PHPUnit\Util\InvalidVersionOperatorException;
use PHPUnit\Util\VersionComparisonOperator;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class AnnotationParser implements Parser
{
/**
* @psalm-param class-string $className
*
* @throws AnnotationsAreNotSupportedForInternalClassesException
* @throws InvalidVersionOperatorException
* @throws ReflectionException
*/
public function forClass(string $className): MetadataCollection
{
$result = [];
foreach (AnnotationRegistry::getInstance()->forClassName($className)->symbolAnnotations() as $annotation => $values) {
switch ($annotation) {
case 'backupGlobals':
$result[] = Metadata::backupGlobalsOnClass($this->stringToBool($values[0]));
break;
case 'backupStaticAttributes':
case 'backupStaticProperties':
$result[] = Metadata::backupStaticPropertiesOnClass($this->stringToBool($values[0]));
break;
case 'covers':
foreach ($values as $value) {
$value = $this->cleanUpCoversOrUsesTarget($value);
$result[] = Metadata::coversOnClass($value);
}
break;
case 'coversDefaultClass':
foreach ($values as $value) {
$result[] = Metadata::coversDefaultClass($value);
}
break;
case 'coversNothing':
$result[] = Metadata::coversNothingOnClass();
break;
case 'doesNotPerformAssertions':
$result[] = Metadata::doesNotPerformAssertionsOnClass();
break;
case 'group':
case 'ticket':
foreach ($values as $value) {
$result[] = Metadata::groupOnClass($value);
}
break;
case 'large':
$result[] = Metadata::groupOnClass('large');
break;
case 'medium':
$result[] = Metadata::groupOnClass('medium');
break;
case 'preserveGlobalState':
$result[] = Metadata::preserveGlobalStateOnClass($this->stringToBool($values[0]));
break;
case 'runClassInSeparateProcess':
$result[] = Metadata::runClassInSeparateProcess();
break;
case 'runTestsInSeparateProcesses':
$result[] = Metadata::runTestsInSeparateProcesses();
break;
case 'small':
$result[] = Metadata::groupOnClass('small');
break;
case 'testdox':
$result[] = Metadata::testDoxOnClass($values[0]);
break;
case 'uses':
foreach ($values as $value) {
$value = $this->cleanUpCoversOrUsesTarget($value);
$result[] = Metadata::usesOnClass($value);
}
break;
case 'usesDefaultClass':
foreach ($values as $value) {
$result[] = Metadata::usesDefaultClass($value);
}
break;
}
}
try {
$result = array_merge(
$result,
$this->parseRequirements(
AnnotationRegistry::getInstance()->forClassName($className)->requirements(),
'class',
),
);
} catch (InvalidVersionRequirementException $e) {
EventFacade::emitter()->testRunnerTriggeredWarning(
sprintf(
'Class %s is annotated using an invalid version requirement: %s',
$className,
$e->getMessage(),
),
);
}
return MetadataCollection::fromArray($result);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*
* @throws AnnotationsAreNotSupportedForInternalClassesException
* @throws InvalidVersionOperatorException
* @throws ReflectionException
*/
public function forMethod(string $className, string $methodName): MetadataCollection
{
$result = [];
foreach (AnnotationRegistry::getInstance()->forMethod($className, $methodName)->symbolAnnotations() as $annotation => $values) {
switch ($annotation) {
case 'after':
$result[] = Metadata::after();
break;
case 'afterClass':
$result[] = Metadata::afterClass();
break;
case 'backupGlobals':
$result[] = Metadata::backupGlobalsOnMethod($this->stringToBool($values[0]));
break;
case 'backupStaticAttributes':
case 'backupStaticProperties':
$result[] = Metadata::backupStaticPropertiesOnMethod($this->stringToBool($values[0]));
break;
case 'before':
$result[] = Metadata::before();
break;
case 'beforeClass':
$result[] = Metadata::beforeClass();
break;
case 'covers':
foreach ($values as $value) {
$value = $this->cleanUpCoversOrUsesTarget($value);
$result[] = Metadata::coversOnMethod($value);
}
break;
case 'coversNothing':
$result[] = Metadata::coversNothingOnMethod();
break;
case 'dataProvider':
foreach ($values as $value) {
$value = rtrim($value, " ()\n\r\t\v\x00");
if (str_contains($value, '::')) {
$result[] = Metadata::dataProvider(...explode('::', $value));
continue;
}
$result[] = Metadata::dataProvider($className, $value);
}
break;
case 'depends':
foreach ($values as $value) {
$deepClone = false;
$shallowClone = false;
if (str_starts_with($value, 'clone ')) {
$deepClone = true;
$value = substr($value, strlen('clone '));
} elseif (str_starts_with($value, '!clone ')) {
$value = substr($value, strlen('!clone '));
} elseif (str_starts_with($value, 'shallowClone ')) {
$shallowClone = true;
$value = substr($value, strlen('shallowClone '));
} elseif (str_starts_with($value, '!shallowClone ')) {
$value = substr($value, strlen('!shallowClone '));
}
if (str_contains($value, '::')) {
[$_className, $_methodName] = explode('::', $value);
assert($_className !== '');
assert($_methodName !== '');
if ($_methodName === 'class') {
$result[] = Metadata::dependsOnClass($_className, $deepClone, $shallowClone);
continue;
}
$result[] = Metadata::dependsOnMethod($_className, $_methodName, $deepClone, $shallowClone);
continue;
}
$result[] = Metadata::dependsOnMethod($className, $value, $deepClone, $shallowClone);
}
break;
case 'doesNotPerformAssertions':
$result[] = Metadata::doesNotPerformAssertionsOnMethod();
break;
case 'excludeGlobalVariableFromBackup':
foreach ($values as $value) {
$result[] = Metadata::excludeGlobalVariableFromBackupOnMethod($value);
}
break;
case 'excludeStaticPropertyFromBackup':
foreach ($values as $value) {
$tmp = explode(' ', $value);
if (count($tmp) !== 2) {
continue;
}
$result[] = Metadata::excludeStaticPropertyFromBackupOnMethod(
trim($tmp[0]),
trim($tmp[1]),
);
}
break;
case 'group':
case 'ticket':
foreach ($values as $value) {
$result[] = Metadata::groupOnMethod($value);
}
break;
case 'large':
$result[] = Metadata::groupOnMethod('large');
break;
case 'medium':
$result[] = Metadata::groupOnMethod('medium');
break;
case 'postCondition':
$result[] = Metadata::postCondition();
break;
case 'preCondition':
$result[] = Metadata::preCondition();
break;
case 'preserveGlobalState':
$result[] = Metadata::preserveGlobalStateOnMethod($this->stringToBool($values[0]));
break;
case 'runInSeparateProcess':
$result[] = Metadata::runInSeparateProcess();
break;
case 'small':
$result[] = Metadata::groupOnMethod('small');
break;
case 'test':
$result[] = Metadata::test();
break;
case 'testdox':
$result[] = Metadata::testDoxOnMethod($values[0]);
break;
case 'uses':
foreach ($values as $value) {
$value = $this->cleanUpCoversOrUsesTarget($value);
$result[] = Metadata::usesOnMethod($value);
}
break;
}
}
if (method_exists($className, $methodName)) {
try {
$result = array_merge(
$result,
$this->parseRequirements(
AnnotationRegistry::getInstance()->forMethod($className, $methodName)->requirements(),
'method',
),
);
} catch (InvalidVersionRequirementException $e) {
EventFacade::emitter()->testRunnerTriggeredWarning(
sprintf(
'Method %s::%s is annotated using an invalid version requirement: %s',
$className,
$methodName,
$e->getMessage(),
),
);
}
}
return MetadataCollection::fromArray($result);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*
* @throws AnnotationsAreNotSupportedForInternalClassesException
* @throws InvalidVersionOperatorException
* @throws ReflectionException
*/
public function forClassAndMethod(string $className, string $methodName): MetadataCollection
{
return $this->forClass($className)->mergeWith(
$this->forMethod($className, $methodName),
);
}
private function stringToBool(string $value): bool
{
if ($value === 'enabled') {
return true;
}
return false;
}
private function cleanUpCoversOrUsesTarget(string $value): string
{
$value = preg_replace('/[\s()]+$/', '', $value);
return explode(' ', $value, 2)[0];
}
/**
* @psalm-return list<Metadata>
*
* @throws InvalidVersionOperatorException
*/
private function parseRequirements(array $requirements, string $level): array
{
$result = [];
if (!empty($requirements['PHP'])) {
$versionRequirement = new ComparisonRequirement(
$requirements['PHP']['version'],
new VersionComparisonOperator(empty($requirements['PHP']['operator']) ? '>=' : $requirements['PHP']['operator']),
);
if ($level === 'class') {
$result[] = Metadata::requiresPhpOnClass($versionRequirement);
} else {
$result[] = Metadata::requiresPhpOnMethod($versionRequirement);
}
} elseif (!empty($requirements['PHP_constraint'])) {
$versionRequirement = new ConstraintRequirement($requirements['PHP_constraint']['constraint']);
if ($level === 'class') {
$result[] = Metadata::requiresPhpOnClass($versionRequirement);
} else {
$result[] = Metadata::requiresPhpOnMethod($versionRequirement);
}
}
if (!empty($requirements['extensions'])) {
foreach ($requirements['extensions'] as $extension) {
if (isset($requirements['extension_versions'][$extension])) {
continue;
}
if ($level === 'class') {
$result[] = Metadata::requiresPhpExtensionOnClass($extension, null);
} else {
$result[] = Metadata::requiresPhpExtensionOnMethod($extension, null);
}
}
}
if (!empty($requirements['extension_versions'])) {
foreach ($requirements['extension_versions'] as $extension => $version) {
$versionRequirement = new ComparisonRequirement(
$version['version'],
new VersionComparisonOperator(empty($version['operator']) ? '>=' : $version['operator']),
);
if ($level === 'class') {
$result[] = Metadata::requiresPhpExtensionOnClass($extension, $versionRequirement);
} else {
$result[] = Metadata::requiresPhpExtensionOnMethod($extension, $versionRequirement);
}
}
}
if (!empty($requirements['PHPUnit'])) {
$versionRequirement = new ComparisonRequirement(
$requirements['PHPUnit']['version'],
new VersionComparisonOperator(empty($requirements['PHPUnit']['operator']) ? '>=' : $requirements['PHPUnit']['operator']),
);
if ($level === 'class') {
$result[] = Metadata::requiresPhpunitOnClass($versionRequirement);
} else {
$result[] = Metadata::requiresPhpunitOnMethod($versionRequirement);
}
} elseif (!empty($requirements['PHPUnit_constraint'])) {
$versionRequirement = new ConstraintRequirement($requirements['PHPUnit_constraint']['constraint']);
if ($level === 'class') {
$result[] = Metadata::requiresPhpunitOnClass($versionRequirement);
} else {
$result[] = Metadata::requiresPhpunitOnMethod($versionRequirement);
}
}
if (!empty($requirements['OSFAMILY'])) {
if ($level === 'class') {
$result[] = Metadata::requiresOperatingSystemFamilyOnClass($requirements['OSFAMILY']);
} else {
$result[] = Metadata::requiresOperatingSystemFamilyOnMethod($requirements['OSFAMILY']);
}
}
if (!empty($requirements['OS'])) {
if ($level === 'class') {
$result[] = Metadata::requiresOperatingSystemOnClass($requirements['OS']);
} else {
$result[] = Metadata::requiresOperatingSystemOnMethod($requirements['OS']);
}
}
if (!empty($requirements['functions'])) {
foreach ($requirements['functions'] as $function) {
$pieces = explode('::', $function);
if (count($pieces) === 2) {
if ($level === 'class') {
$result[] = Metadata::requiresMethodOnClass($pieces[0], $pieces[1]);
} else {
$result[] = Metadata::requiresMethodOnMethod($pieces[0], $pieces[1]);
}
} elseif ($level === 'class') {
$result[] = Metadata::requiresFunctionOnClass($function);
} else {
$result[] = Metadata::requiresFunctionOnMethod($function);
}
}
}
if (!empty($requirements['setting'])) {
foreach ($requirements['setting'] as $setting => $value) {
if ($level === 'class') {
$result[] = Metadata::requiresSettingOnClass($setting, $value);
} else {
$result[] = Metadata::requiresSettingOnMethod($setting, $value);
}
}
}
return $result;
}
}
Back to Directory
nL+D550H?Mx ,D"v]qv;6*Zqn)ZP 0 !1 A "#a$2Qr D8 a Ri[f\mIykIw0 cuFcRı?lO7к_f˓[C$殷WF<_W ԣs KcëIzyQy /_LKℂ;C",pFA: /]=H ~,ls/9ć:[=/#f;)x {ٛEQ )~ =𘙲r*2~ a _V=' kumF D}KYYC)({ *g&f`툪ry`=^cJ.I](*`wq 1dđ#̩͑0;H]u搂@:~וKL Nsh}OIR*8:2 !lDJVo( 3=M(zȰ+i*NA r6KnSl )!JJӁ* %݉?|D}d5:eP0R;{$X'xF@.ÊB {,WJuQɲRI;9QE琯62fT.DUJ;*cP A\ILNj!J۱+O\ ͔]ޒ SJȧc%ANolՎprULZԛerE2=XDXgVQeӓk yP7U*omQIs,K`)6\G3t?pgjrmۛجwluGtf h9uyP0D;Uڽ"OXlif$)&|ML0Zrm1[HXPlPR0'G=i2N +0e2]] 9VTPO7h(F*癈 '=QVZDF,d߬~TX
G[`le69CR(!S2!P
<0x < !1AQ "Raq02Br#SCTb
?Ζ"]mH5WR7k.ۛ!}Q~+yԏz|@T20S~Kek *zFf^2X*(@8r?CIuI|֓>^ExLgNUY+{.RѪ
τVYTD I62'8Y2 7'\TP.6d&˦@Vqi|8- OΕ]ʔ U=TL8=;6c| !qfF3aů&~$l}'NWUs$Uk^SV:U# 6w++s&r+nڐ{@29 gL
u"TÙM=6 (^"7r} =6YݾlCuhquympǦ
G jhsǜNlɻ}o7 #S6aw4!OSrD57%|?x>L
|/nD6?/8w#[)L7+6〼T ATg ! %5MmZ/c-{1_Je"|^$'O&ޱմ Trb$ w)R$&
N1EtdU3Uȉ1pM" N*(DN yd96.(jQ)X
5cQɎMyW? Q*!R>6=7)Xj5`J]e 8%t!+'!1Q 5 !1 AQaqё#2"0BRb ? Gt^## .llQT $v,,m 㵜5 ubV =sY+@d{N! dnO< .-B; _wJt6;QJd.Qc%p{ 1,sNDdFHI0ГoXшe黅XۢF:)[FGXƹ/w_cMeD,ʡcc. WDtA$j@:) -# u
c1<@ۗ9F)KJ-hpP]_x[qBlbp ʖw q"LFGd ƶ*s+ډ_Zc"? %t[IP 6J]#=ɺVvvCGsGh1 >)6|ey?Lӣm,4GWUi` ]uJVoV DG< SB 6ϏQ@ TiUly OU0kfV~~}SZ@*WUUi##; s/[ =!7}" WN]'(L! ~y5g9T̅JkbM' +s:S + B)v@Mj
e Cf jE 0Y\QnzG1д~Wo{T 9?`Rmyhsy3!HAD]mc1~2L Su7xT;j$`}4->L#vzŏ ILS ֭ T { rjGKC; bpU= -`BsK.SFw4Mq]ZdHS0)tLg