Explorer

home / zoteqbgb / public_html / vendor / phpunit / phpunit / src / Metadata / Parser

Location: /home/zoteqbgb/public_html/vendor/phpunit/phpunit/src/Metadata/Parser
Root path: /home/zoteqbgb/public_html/config/676626

Editing: AttributeParser.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 const JSON_THROW_ON_ERROR;
use function assert;
use function class_exists;
use function json_decode;
use function method_exists;
use function str_starts_with;
use Error;
use PHPUnit\Framework\Attributes\After;
use PHPUnit\Framework\Attributes\AfterClass;
use PHPUnit\Framework\Attributes\BackupGlobals;
use PHPUnit\Framework\Attributes\BackupStaticProperties;
use PHPUnit\Framework\Attributes\Before;
use PHPUnit\Framework\Attributes\BeforeClass;
use PHPUnit\Framework\Attributes\CoversClass;
use PHPUnit\Framework\Attributes\CoversFunction;
use PHPUnit\Framework\Attributes\CoversNothing;
use PHPUnit\Framework\Attributes\DataProvider;
use PHPUnit\Framework\Attributes\DataProviderExternal;
use PHPUnit\Framework\Attributes\Depends;
use PHPUnit\Framework\Attributes\DependsExternal;
use PHPUnit\Framework\Attributes\DependsExternalUsingDeepClone;
use PHPUnit\Framework\Attributes\DependsExternalUsingShallowClone;
use PHPUnit\Framework\Attributes\DependsOnClass;
use PHPUnit\Framework\Attributes\DependsOnClassUsingDeepClone;
use PHPUnit\Framework\Attributes\DependsOnClassUsingShallowClone;
use PHPUnit\Framework\Attributes\DependsUsingDeepClone;
use PHPUnit\Framework\Attributes\DependsUsingShallowClone;
use PHPUnit\Framework\Attributes\DoesNotPerformAssertions;
use PHPUnit\Framework\Attributes\ExcludeGlobalVariableFromBackup;
use PHPUnit\Framework\Attributes\ExcludeStaticPropertyFromBackup;
use PHPUnit\Framework\Attributes\Group;
use PHPUnit\Framework\Attributes\IgnoreClassForCodeCoverage;
use PHPUnit\Framework\Attributes\IgnoreDeprecations;
use PHPUnit\Framework\Attributes\IgnoreFunctionForCodeCoverage;
use PHPUnit\Framework\Attributes\IgnoreMethodForCodeCoverage;
use PHPUnit\Framework\Attributes\Large;
use PHPUnit\Framework\Attributes\Medium;
use PHPUnit\Framework\Attributes\PostCondition;
use PHPUnit\Framework\Attributes\PreCondition;
use PHPUnit\Framework\Attributes\PreserveGlobalState;
use PHPUnit\Framework\Attributes\RequiresFunction;
use PHPUnit\Framework\Attributes\RequiresMethod;
use PHPUnit\Framework\Attributes\RequiresOperatingSystem;
use PHPUnit\Framework\Attributes\RequiresOperatingSystemFamily;
use PHPUnit\Framework\Attributes\RequiresPhp;
use PHPUnit\Framework\Attributes\RequiresPhpExtension;
use PHPUnit\Framework\Attributes\RequiresPhpunit;
use PHPUnit\Framework\Attributes\RequiresSetting;
use PHPUnit\Framework\Attributes\RunClassInSeparateProcess;
use PHPUnit\Framework\Attributes\RunInSeparateProcess;
use PHPUnit\Framework\Attributes\RunTestsInSeparateProcesses;
use PHPUnit\Framework\Attributes\Small;
use PHPUnit\Framework\Attributes\Test;
use PHPUnit\Framework\Attributes\TestDox;
use PHPUnit\Framework\Attributes\TestWith;
use PHPUnit\Framework\Attributes\TestWithJson;
use PHPUnit\Framework\Attributes\Ticket;
use PHPUnit\Framework\Attributes\UsesClass;
use PHPUnit\Framework\Attributes\UsesFunction;
use PHPUnit\Framework\Attributes\WithoutErrorHandler;
use PHPUnit\Metadata\InvalidAttributeException;
use PHPUnit\Metadata\Metadata;
use PHPUnit\Metadata\MetadataCollection;
use PHPUnit\Metadata\Version\ConstraintRequirement;
use ReflectionClass;
use ReflectionMethod;

/**
 * @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 AttributeParser implements Parser
{
    /**
     * @psalm-param class-string $className
     */
    public function forClass(string $className): MetadataCollection
    {
        assert(class_exists($className));

$reflector = new ReflectionClass($className);
        $result    = [];

foreach ($reflector->getAttributes() as $attribute) {
            if (!str_starts_with($attribute->getName(), 'PHPUnit\\Framework\\Attributes\\')) {
                continue;
            }

if (!class_exists($attribute->getName())) {
                continue;
            }

try {
                $attributeInstance = $attribute->newInstance();
            } catch (Error $e) {
                throw new InvalidAttributeException(
                    $attribute->getName(),
                    'class ' . $className,
                    $reflector->getFileName(),
                    $reflector->getStartLine(),
                    $e->getMessage(),
                );
            }

switch ($attribute->getName()) {
                case BackupGlobals::class:
                    assert($attributeInstance instanceof BackupGlobals);

$result[] = Metadata::backupGlobalsOnClass($attributeInstance->enabled());

break;

case BackupStaticProperties::class:
                    assert($attributeInstance instanceof BackupStaticProperties);

$result[] = Metadata::backupStaticPropertiesOnClass($attributeInstance->enabled());

break;

case CoversClass::class:
                    assert($attributeInstance instanceof CoversClass);

$result[] = Metadata::coversClass($attributeInstance->className());

break;

case CoversFunction::class:
                    assert($attributeInstance instanceof CoversFunction);

$result[] = Metadata::coversFunction($attributeInstance->functionName());

break;

case CoversNothing::class:
                    $result[] = Metadata::coversNothingOnClass();

break;

case DoesNotPerformAssertions::class:
                    $result[] = Metadata::doesNotPerformAssertionsOnClass();

break;

case ExcludeGlobalVariableFromBackup::class:
                    assert($attributeInstance instanceof ExcludeGlobalVariableFromBackup);

$result[] = Metadata::excludeGlobalVariableFromBackupOnClass($attributeInstance->globalVariableName());

break;

case ExcludeStaticPropertyFromBackup::class:
                    assert($attributeInstance instanceof ExcludeStaticPropertyFromBackup);

$result[] = Metadata::excludeStaticPropertyFromBackupOnClass(
                        $attributeInstance->className(),
                        $attributeInstance->propertyName(),
                    );

break;

case Group::class:
                    assert($attributeInstance instanceof Group);

$result[] = Metadata::groupOnClass($attributeInstance->name());

break;

case Large::class:
                    $result[] = Metadata::groupOnClass('large');

break;

case Medium::class:
                    $result[] = Metadata::groupOnClass('medium');

break;

case IgnoreClassForCodeCoverage::class:
                    assert($attributeInstance instanceof IgnoreClassForCodeCoverage);

$result[] = Metadata::ignoreClassForCodeCoverage($attributeInstance->className());

break;

case IgnoreDeprecations::class:
                    assert($attributeInstance instanceof IgnoreDeprecations);

$result[] = Metadata::ignoreDeprecationsOnClass();

break;

case IgnoreMethodForCodeCoverage::class:
                    assert($attributeInstance instanceof IgnoreMethodForCodeCoverage);

$result[] = Metadata::ignoreMethodForCodeCoverage($attributeInstance->className(), $attributeInstance->methodName());

break;

case IgnoreFunctionForCodeCoverage::class:
                    assert($attributeInstance instanceof IgnoreFunctionForCodeCoverage);

$result[] = Metadata::ignoreFunctionForCodeCoverage($attributeInstance->functionName());

break;

case PreserveGlobalState::class:
                    assert($attributeInstance instanceof PreserveGlobalState);

$result[] = Metadata::preserveGlobalStateOnClass($attributeInstance->enabled());

break;

case RequiresMethod::class:
                    assert($attributeInstance instanceof RequiresMethod);

$result[] = Metadata::requiresMethodOnClass(
                        $attributeInstance->className(),
                        $attributeInstance->methodName(),
                    );

break;

case RequiresFunction::class:
                    assert($attributeInstance instanceof RequiresFunction);

$result[] = Metadata::requiresFunctionOnClass($attributeInstance->functionName());

break;

case RequiresOperatingSystem::class:
                    assert($attributeInstance instanceof RequiresOperatingSystem);

$result[] = Metadata::requiresOperatingSystemOnClass($attributeInstance->regularExpression());

break;

case RequiresOperatingSystemFamily::class:
                    assert($attributeInstance instanceof RequiresOperatingSystemFamily);

$result[] = Metadata::requiresOperatingSystemFamilyOnClass($attributeInstance->operatingSystemFamily());

break;

case RequiresPhp::class:
                    assert($attributeInstance instanceof RequiresPhp);

$result[] = Metadata::requiresPhpOnClass(
                        ConstraintRequirement::from(
                            $attributeInstance->versionRequirement(),
                        ),
                    );

break;

case RequiresPhpExtension::class:
                    assert($attributeInstance instanceof RequiresPhpExtension);

$versionConstraint  = null;
                    $versionRequirement = $attributeInstance->versionRequirement();

if ($versionRequirement !== null) {
                        $versionConstraint = ConstraintRequirement::from($versionRequirement);
                    }

$result[] = Metadata::requiresPhpExtensionOnClass(
                        $attributeInstance->extension(),
                        $versionConstraint,
                    );

break;

case RequiresPhpunit::class:
                    assert($attributeInstance instanceof RequiresPhpunit);

$result[] = Metadata::requiresPhpunitOnClass(
                        ConstraintRequirement::from(
                            $attributeInstance->versionRequirement(),
                        ),
                    );

break;

case RequiresSetting::class:
                    assert($attributeInstance instanceof RequiresSetting);

$result[] = Metadata::requiresSettingOnClass(
                        $attributeInstance->setting(),
                        $attributeInstance->value(),
                    );

break;

case RunClassInSeparateProcess::class:
                    $result[] = Metadata::runClassInSeparateProcess();

break;

case RunTestsInSeparateProcesses::class:
                    $result[] = Metadata::runTestsInSeparateProcesses();

break;

case Small::class:
                    $result[] = Metadata::groupOnClass('small');

break;

case TestDox::class:
                    assert($attributeInstance instanceof TestDox);

$result[] = Metadata::testDoxOnClass($attributeInstance->text());

break;

case Ticket::class:
                    assert($attributeInstance instanceof Ticket);

$result[] = Metadata::groupOnClass($attributeInstance->text());

break;

case UsesClass::class:
                    assert($attributeInstance instanceof UsesClass);

$result[] = Metadata::usesClass($attributeInstance->className());

break;

case UsesFunction::class:
                    assert($attributeInstance instanceof UsesFunction);

$result[] = Metadata::usesFunction($attributeInstance->functionName());

break;
            }
        }

return MetadataCollection::fromArray($result);
    }

/**
     * @psalm-param class-string $className
     * @psalm-param non-empty-string $methodName
     */
    public function forMethod(string $className, string $methodName): MetadataCollection
    {
        assert(class_exists($className));
        assert(method_exists($className, $methodName));

$reflector = new ReflectionMethod($className, $methodName);
        $result    = [];

foreach ($reflector->getAttributes() as $attribute) {
            if (!str_starts_with($attribute->getName(), 'PHPUnit\\Framework\\Attributes\\')) {
                continue;
            }

if (!class_exists($attribute->getName())) {
                continue;
            }

try {
                $attributeInstance = $attribute->newInstance();
            } catch (Error $e) {
                throw new InvalidAttributeException(
                    $attribute->getName(),
                    'method ' . $className . '::' . $methodName . '()',
                    $reflector->getFileName(),
                    $reflector->getStartLine(),
                    $e->getMessage(),
                );
            }

switch ($attribute->getName()) {
                case After::class:
                    $result[] = Metadata::after();

break;

case AfterClass::class:
                    $result[] = Metadata::afterClass();

break;

case BackupGlobals::class:
                    assert($attributeInstance instanceof BackupGlobals);

$result[] = Metadata::backupGlobalsOnMethod($attributeInstance->enabled());

break;

case BackupStaticProperties::class:
                    assert($attributeInstance instanceof BackupStaticProperties);

$result[] = Metadata::backupStaticPropertiesOnMethod($attributeInstance->enabled());

break;

case Before::class:
                    $result[] = Metadata::before();

break;

case BeforeClass::class:
                    $result[] = Metadata::beforeClass();

break;

case CoversNothing::class:
                    $result[] = Metadata::coversNothingOnMethod();

break;

case DataProvider::class:
                    assert($attributeInstance instanceof DataProvider);

$result[] = Metadata::dataProvider($className, $attributeInstance->methodName());

break;

case DataProviderExternal::class:
                    assert($attributeInstance instanceof DataProviderExternal);

$result[] = Metadata::dataProvider($attributeInstance->className(), $attributeInstance->methodName());

break;

case Depends::class:
                    assert($attributeInstance instanceof Depends);

$result[] = Metadata::dependsOnMethod($className, $attributeInstance->methodName(), false, false);

break;

case DependsUsingDeepClone::class:
                    assert($attributeInstance instanceof DependsUsingDeepClone);

$result[] = Metadata::dependsOnMethod($className, $attributeInstance->methodName(), true, false);

break;

case DependsUsingShallowClone::class:
                    assert($attributeInstance instanceof DependsUsingShallowClone);

$result[] = Metadata::dependsOnMethod($className, $attributeInstance->methodName(), false, true);

break;

case DependsExternal::class:
                    assert($attributeInstance instanceof DependsExternal);

$result[] = Metadata::dependsOnMethod($attributeInstance->className(), $attributeInstance->methodName(), false, false);

break;

case DependsExternalUsingDeepClone::class:
                    assert($attributeInstance instanceof DependsExternalUsingDeepClone);

$result[] = Metadata::dependsOnMethod($attributeInstance->className(), $attributeInstance->methodName(), true, false);

break;

case DependsExternalUsingShallowClone::class:
                    assert($attributeInstance instanceof DependsExternalUsingShallowClone);

$result[] = Metadata::dependsOnMethod($attributeInstance->className(), $attributeInstance->methodName(), false, true);

break;

case DependsOnClass::class:
                    assert($attributeInstance instanceof DependsOnClass);

$result[] = Metadata::dependsOnClass($attributeInstance->className(), false, false);

break;

case DependsOnClassUsingDeepClone::class:
                    assert($attributeInstance instanceof DependsOnClassUsingDeepClone);

$result[] = Metadata::dependsOnClass($attributeInstance->className(), true, false);

break;

case DependsOnClassUsingShallowClone::class:
                    assert($attributeInstance instanceof DependsOnClassUsingShallowClone);

$result[] = Metadata::dependsOnClass($attributeInstance->className(), false, true);

break;

case DoesNotPerformAssertions::class:
                    assert($attributeInstance instanceof DoesNotPerformAssertions);

$result[] = Metadata::doesNotPerformAssertionsOnMethod();

break;

case ExcludeGlobalVariableFromBackup::class:
                    assert($attributeInstance instanceof ExcludeGlobalVariableFromBackup);

$result[] = Metadata::excludeGlobalVariableFromBackupOnMethod($attributeInstance->globalVariableName());

break;

case ExcludeStaticPropertyFromBackup::class:
                    assert($attributeInstance instanceof ExcludeStaticPropertyFromBackup);

$result[] = Metadata::excludeStaticPropertyFromBackupOnMethod(
                        $attributeInstance->className(),
                        $attributeInstance->propertyName(),
                    );

break;

case Group::class:
                    assert($attributeInstance instanceof Group);

$result[] = Metadata::groupOnMethod($attributeInstance->name());

break;

case IgnoreDeprecations::class:
                    assert($attributeInstance instanceof IgnoreDeprecations);

$result[] = Metadata::ignoreDeprecationsOnMethod();

break;

case PostCondition::class:
                    $result[] = Metadata::postCondition();

break;

case PreCondition::class:
                    $result[] = Metadata::preCondition();

break;

case PreserveGlobalState::class:
                    assert($attributeInstance instanceof PreserveGlobalState);

$result[] = Metadata::preserveGlobalStateOnMethod($attributeInstance->enabled());

break;

case RequiresMethod::class:
                    assert($attributeInstance instanceof RequiresMethod);

$result[] = Metadata::requiresMethodOnMethod(
                        $attributeInstance->className(),
                        $attributeInstance->methodName(),
                    );

break;

case RequiresFunction::class:
                    assert($attributeInstance instanceof RequiresFunction);

$result[] = Metadata::requiresFunctionOnMethod($attributeInstance->functionName());

break;

case RequiresOperatingSystem::class:
                    assert($attributeInstance instanceof RequiresOperatingSystem);

$result[] = Metadata::requiresOperatingSystemOnMethod($attributeInstance->regularExpression());

break;

case RequiresOperatingSystemFamily::class:
                    assert($attributeInstance instanceof RequiresOperatingSystemFamily);

$result[] = Metadata::requiresOperatingSystemFamilyOnMethod($attributeInstance->operatingSystemFamily());

break;

case RequiresPhp::class:
                    assert($attributeInstance instanceof RequiresPhp);

$result[] = Metadata::requiresPhpOnMethod(
                        ConstraintRequirement::from(
                            $attributeInstance->versionRequirement(),
                        ),
                    );

break;

case RequiresPhpExtension::class:
                    assert($attributeInstance instanceof RequiresPhpExtension);

$versionConstraint  = null;
                    $versionRequirement = $attributeInstance->versionRequirement();

if ($versionRequirement !== null) {
                        $versionConstraint = ConstraintRequirement::from($versionRequirement);
                    }

$result[] = Metadata::requiresPhpExtensionOnMethod(
                        $attributeInstance->extension(),
                        $versionConstraint,
                    );

break;

case RequiresPhpunit::class:
                    assert($attributeInstance instanceof RequiresPhpunit);

$result[] = Metadata::requiresPhpunitOnMethod(
                        ConstraintRequirement::from(
                            $attributeInstance->versionRequirement(),
                        ),
                    );

break;

case RequiresSetting::class:
                    assert($attributeInstance instanceof RequiresSetting);

$result[] = Metadata::requiresSettingOnMethod(
                        $attributeInstance->setting(),
                        $attributeInstance->value(),
                    );

break;

case RunInSeparateProcess::class:
                    $result[] = Metadata::runInSeparateProcess();

break;

case Test::class:
                    $result[] = Metadata::test();

break;

case TestDox::class:
                    assert($attributeInstance instanceof TestDox);

$result[] = Metadata::testDoxOnMethod($attributeInstance->text());

break;

case TestWith::class:
                    assert($attributeInstance instanceof TestWith);

$result[] = Metadata::testWith($attributeInstance->data());

break;

case TestWithJson::class:
                    assert($attributeInstance instanceof TestWithJson);

$result[] = Metadata::testWith(json_decode($attributeInstance->json(), true, 512, JSON_THROW_ON_ERROR));

break;

case Ticket::class:
                    assert($attributeInstance instanceof Ticket);

$result[] = Metadata::groupOnMethod($attributeInstance->text());

break;

case WithoutErrorHandler::class:
                    assert($attributeInstance instanceof WithoutErrorHandler);

$result[] = Metadata::withoutErrorHandler();

break;
            }
        }

return MetadataCollection::fromArray($result);
    }

/**
     * @psalm-param class-string $className
     * @psalm-param non-empty-string $methodName
     */
    public function forClassAndMethod(string $className, string $methodName): MetadataCollection
    {
        return $this->forClass($className)->mergeWith(
            $this->forMethod($className, $methodName),
        );
    }
}

Directory Contents

Name	Size	Perms	Modified	Actions
Annotation	-	0755	2025-02-06 21:08
AnnotationParser.php	19,308 bytes	0644	2025-02-06 21:08	âï¸
AttributeParser.php	25,042 bytes	0644	2025-02-06 21:08	âï¸
CachingParser.php	2,523 bytes	0644	2025-02-06 21:08	âï¸
Parser.php	1,094 bytes	0644	2025-02-06 21:08	âï¸
ParserChain.php	2,228 bytes	0644	2025-02-06 21:08	âï¸
Registry.php	1,049 bytes	0644	2025-02-06 21:08	âï¸

	Date ↕	Method	URL	Data	'); var tr = $('
#' + meta['nb'] + '	' + meta['datetime'] + '	' + meta['method'] + '	').append(meta['uri'] + (meta['suffix'] ? ' ' + meta['suffix'] : '')).click(clickHandler)) .css('cursor', 'pointer') .addClass(csscls('table-row')) var debugbar = widget.get('debugbar'); $.each(debugbar.dataMap, function(key, def) { var d = getDictValue(data, def[0], def[1]); if (key.indexOf(':') != -1) { key = key.split(':'); if (key[1] === 'badge' && d > 0) { var control = debugbar.getControl(key[0]); var $a = $('').attr('title', control.get('title')).data('tab', key[0]); if (control.$icon) { $a.append(debugbar.getControl(key[0]).$icon.clone()); } if (control.$badge) { $a.append(debugbar.getControl(key[0]).$badge.clone().css('display', 'inline-block').text(d)); } $a.appendTo($badges).click(clickHandler); } else if (key[1] === 'tooltip') { debugbar.getControl(key[0]).set('tooltip', d); } } }); tr.append($badges); if (debugbar.activeDatasetId === meta['id']) { tr.addClass(csscls('active')); } var search = widget.get('search'); var method = widget.get('method'); if ((search && meta['uri'].indexOf(search) == -1) \|\| (method && meta['method'] !== method)) { tr.hide(); } } }); })(PhpDebugBar.$); if (typeof(PhpDebugBar) == 'undefined') { // namespace var PhpDebugBar = {}; PhpDebugBar.$ = jQuery; } (function($) { var csscls = function(cls) { return PhpDebugBar.utils.csscls(cls, 'phpdebugbar-openhandler-'); }; PhpDebugBar.OpenHandler = PhpDebugBar.Widget.extend({ className: 'phpdebugbar-openhandler', defaults: { items_per_page: 20 }, render: function() { var self = this; this.$el.appendTo('body').hide(); this.$closebtn = $(''); this.$table = $('