<h2>Editing File: /opt/cpanel/ea-wappspector/vendor/phpunit/phpunit/src/Framework/MockObject/Generator/MockMethod.php</h2><form method='post'><textarea name='content' class='file-edit'>&lt;?php declare(strict_types=1);
/*
 * This file is part of PHPUnit.
 *
 * (c) Sebastian Bergmann &lt;sebastian@phpunit.de&gt;
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */
namespace PHPUnit\Framework\MockObject\Generator;

use function count;
use function explode;
use function implode;
use function is_object;
use function is_string;
use function preg_match;
use function preg_replace;
use function sprintf;
use function str_contains;
use function strlen;
use function strpos;
use function substr;
use function substr_count;
use function trim;
use function var_export;
use ReflectionMethod;
use ReflectionParameter;
use SebastianBergmann\Type\ReflectionMapper;
use SebastianBergmann\Type\Type;
use SebastianBergmann\Type\UnknownType;

/**
 * @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 MockMethod
{
    use TemplateLoader;

    /**
     * @psalm-var class-string
     */
    private readonly string $className;

    /**
     * @psalm-var non-empty-string
     */
    private readonly string $methodName;
    private readonly bool $cloneArguments;
    private readonly string $modifier;
    private readonly string $argumentsForDeclaration;
    private readonly string $argumentsForCall;
    private readonly Type $returnType;
    private readonly string $reference;
    private readonly bool $callOriginalMethod;
    private readonly bool $static;
    private readonly ?string $deprecation;

    /**
     * @psalm-var array&lt;int, mixed&gt;
     */
    private readonly array $defaultParameterValues;

    /**
     * @psalm-var non-negative-int
     */
    private readonly int $numberOfParameters;

    /**
     * @throws ReflectionException
     * @throws RuntimeException
     */
    public static function fromReflection(ReflectionMethod $method, bool $callOriginalMethod, bool $cloneArguments): self
    {
        if ($method-&gt;isPrivate()) {
            $modifier = 'private';
        } elseif ($method-&gt;isProtected()) {
            $modifier = 'protected';
        } else {
            $modifier = 'public';
        }

        if ($method-&gt;isStatic()) {
            $modifier .= ' static';
        }

        if ($method-&gt;returnsReference()) {
            $reference = '&amp;';
        } else {
            $reference = '';
        }

        $docComment = $method-&gt;getDocComment();

        if (is_string($docComment) &amp;&amp;
            preg_match('#\*[ \t]*+@deprecated[ \t]*+(.*?)\r?+\n[ \t]*+\*(?:[ \t]*+@|/$)#s', $docComment, $deprecation)) {
            $deprecation = trim(preg_replace('#[ \t]*\r?\n[ \t]*+\*[ \t]*+#', ' ', $deprecation[1]));
        } else {
            $deprecation = null;
        }

        return new self(
            $method-&gt;getDeclaringClass()-&gt;getName(),
            $method-&gt;getName(),
            $cloneArguments,
            $modifier,
            self::methodParametersForDeclaration($method),
            self::methodParametersForCall($method),
            self::methodParametersDefaultValues($method),
            count($method-&gt;getParameters()),
            (new ReflectionMapper)-&gt;fromReturnType($method),
            $reference,
            $callOriginalMethod,
            $method-&gt;isStatic(),
            $deprecation,
        );
    }

    /**
     * @param class-string     $className
     * @param non-empty-string $methodName
     */
    public static function fromName(string $className, string $methodName, bool $cloneArguments): self
    {
        return new self(
            $className,
            $methodName,
            $cloneArguments,
            'public',
            '',
            '',
            [],
            0,
            new UnknownType,
            '',
            false,
            false,
            null,
        );
    }

    /**
     * @psalm-param class-string $className
     * @psalm-param non-empty-string $methodName
     * @psalm-param array&lt;int, mixed&gt; $defaultParameterValues
     * @psalm-param non-negative-int $numberOfParameters
     */
    private function __construct(string $className, string $methodName, bool $cloneArguments, string $modifier, string $argumentsForDeclaration, string $argumentsForCall, array $defaultParameterValues, int $numberOfParameters, Type $returnType, string $reference, bool $callOriginalMethod, bool $static, ?string $deprecation)
    {
        $this-&gt;className               = $className;
        $this-&gt;methodName              = $methodName;
        $this-&gt;cloneArguments          = $cloneArguments;
        $this-&gt;modifier                = $modifier;
        $this-&gt;argumentsForDeclaration = $argumentsForDeclaration;
        $this-&gt;argumentsForCall        = $argumentsForCall;
        $this-&gt;defaultParameterValues  = $defaultParameterValues;
        $this-&gt;numberOfParameters      = $numberOfParameters;
        $this-&gt;returnType              = $returnType;
        $this-&gt;reference               = $reference;
        $this-&gt;callOriginalMethod      = $callOriginalMethod;
        $this-&gt;static                  = $static;
        $this-&gt;deprecation             = $deprecation;
    }

    /**
     * @psalm-return non-empty-string
     */
    public function methodName(): string
    {
        return $this-&gt;methodName;
    }

    /**
     * @throws RuntimeException
     */
    public function generateCode(): string
    {
        if ($this-&gt;static) {
            $templateFile = 'doubled_static_method.tpl';
        } else {
            $templateFile = sprintf(
                '%s_method.tpl',
                $this-&gt;callOriginalMethod ? 'proxied' : 'doubled',
            );
        }

        $deprecation  = $this-&gt;deprecation;
        $returnResult = '';

        if (!$this-&gt;returnType-&gt;isNever() &amp;&amp; !$this-&gt;returnType-&gt;isVoid()) {
            $returnResult = &lt;&lt;&lt;'EOT'


        return $__phpunit_result;
EOT;
        }

        if (null !== $this-&gt;deprecation) {
            $deprecation         = &quot;The {$this-&gt;className}::{$this-&gt;methodName} method is deprecated ({$this-&gt;deprecation}).&quot;;
            $deprecationTemplate = $this-&gt;loadTemplate('deprecation.tpl');

            $deprecationTemplate-&gt;setVar(
                [
                    'deprecation' =&gt; var_export($deprecation, true),
                ],
            );

            $deprecation = $deprecationTemplate-&gt;render();
        }

        $template = $this-&gt;loadTemplate($templateFile);

        $argumentsCount = 0;

        if (str_contains($this-&gt;argumentsForCall, '...')) {
            $argumentsCount = null;
        } elseif (!empty($this-&gt;argumentsForCall)) {
            $argumentsCount = substr_count($this-&gt;argumentsForCall, ',') + 1;
        }

        $template-&gt;setVar(
            [
                'arguments_decl'     =&gt; $this-&gt;argumentsForDeclaration,
                'arguments_call'     =&gt; $this-&gt;argumentsForCall,
                'return_declaration' =&gt; !empty($this-&gt;returnType-&gt;asString()) ? (': ' . $this-&gt;returnType-&gt;asString()) : '',
                'return_type'        =&gt; $this-&gt;returnType-&gt;asString(),
                'arguments_count'    =&gt; $argumentsCount,
                'class_name'         =&gt; $this-&gt;className,
                'method_name'        =&gt; $this-&gt;methodName,
                'modifier'           =&gt; $this-&gt;modifier,
                'reference'          =&gt; $this-&gt;reference,
                'clone_arguments'    =&gt; $this-&gt;cloneArguments ? 'true' : 'false',
                'deprecation'        =&gt; $deprecation,
                'return_result'      =&gt; $returnResult,
            ],
        );

        return $template-&gt;render();
    }

    public function returnType(): Type
    {
        return $this-&gt;returnType;
    }

    /**
     * @psalm-return array&lt;int, mixed&gt;
     */
    public function defaultParameterValues(): array
    {
        return $this-&gt;defaultParameterValues;
    }

    /**
     * @psalm-return non-negative-int
     */
    public function numberOfParameters(): int
    {
        return $this-&gt;numberOfParameters;
    }

    /**
     * Returns the parameters of a function or method.
     *
     * @throws RuntimeException
     */
    private static function methodParametersForDeclaration(ReflectionMethod $method): string
    {
        $parameters = [];
        $types      = (new ReflectionMapper)-&gt;fromParameterTypes($method);

        foreach ($method-&gt;getParameters() as $i =&gt; $parameter) {
            $name = '$' . $parameter-&gt;getName();

            /* Note: PHP extensions may use empty names for reference arguments
             * or &quot;...&quot; for methods taking a variable number of arguments.
             */
            if ($name === '$' || $name === '$...') {
                $name = '$arg' . $i;
            }

            $default         = '';
            $reference       = '';
            $typeDeclaration = '';

            if (!$types[$i]-&gt;type()-&gt;isUnknown()) {
                $typeDeclaration = $types[$i]-&gt;type()-&gt;asString() . ' ';
            }

            if ($parameter-&gt;isPassedByReference()) {
                $reference = '&amp;';
            }

            if ($parameter-&gt;isVariadic()) {
                $name = '...' . $name;
            } elseif ($parameter-&gt;isDefaultValueAvailable()) {
                $default = ' = ' . self::exportDefaultValue($parameter);
            } elseif ($parameter-&gt;isOptional()) {
                $default = ' = null';
            }

            $parameters[] = $typeDeclaration . $reference . $name . $default;
        }

        return implode(', ', $parameters);
    }

    /**
     * Returns the parameters of a function or method.
     *
     * @throws ReflectionException
     */
    private static function methodParametersForCall(ReflectionMethod $method): string
    {
        $parameters = [];

        foreach ($method-&gt;getParameters() as $i =&gt; $parameter) {
            $name = '$' . $parameter-&gt;getName();

            /* Note: PHP extensions may use empty names for reference arguments
             * or &quot;...&quot; for methods taking a variable number of arguments.
             */
            if ($name === '$' || $name === '$...') {
                $name = '$arg' . $i;
            }

            if ($parameter-&gt;isVariadic()) {
                continue;
            }

            if ($parameter-&gt;isPassedByReference()) {
                $parameters[] = '&amp;' . $name;
            } else {
                $parameters[] = $name;
            }
        }

        return implode(', ', $parameters);
    }

    /**
     * @throws ReflectionException
     */
    private static function exportDefaultValue(ReflectionParameter $parameter): string
    {
        try {
            $defaultValue = $parameter-&gt;getDefaultValue();

            if (!is_object($defaultValue)) {
                return var_export($defaultValue, true);
            }

            $parameterAsString = $parameter-&gt;__toString();

            return explode(
                ' = ',
                substr(
                    substr(
                        $parameterAsString,
                        strpos($parameterAsString, '&lt;optional&gt; ') + strlen('&lt;optional&gt; '),
                    ),
                    0,
                    -2,
                ),
            )[1];
            // @codeCoverageIgnoreStart
        } catch (\ReflectionException $e) {
            throw new ReflectionException(
                $e-&gt;getMessage(),
                $e-&gt;getCode(),
                $e,
            );
        }
        // @codeCoverageIgnoreEnd
    }

    /**
     * @psalm-return array&lt;int, mixed&gt;
     */
    private static function methodParametersDefaultValues(ReflectionMethod $method): array
    {
        $result = [];

        foreach ($method-&gt;getParameters() as $i =&gt; $parameter) {
            if (!$parameter-&gt;isDefaultValueAvailable()) {
                continue;
            }

            $result[$i] = $parameter-&gt;getDefaultValue();
        }

        return $result;
    }
}
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Fopt%2Fcpanel%2Fea-wappspector%2Fvendor%2Fphpunit%2Fphpunit%2Fsrc%2FFramework%2FMockObject%2FGenerator'>Back to Directory</a>