@averay/codeformat 0.2.7 → 0.2.10

package/vendor/friendsofphp/php-cs-fixer/src/Fixer/FunctionNotation/PhpdocToReturnTypeFixer.php

@@ -1,249 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-/*
- * This file is part of PHP CS Fixer.
- *
- * (c) Fabien Potencier <fabien@symfony.com>
- *     Dariusz Rumiński <dariusz.ruminski@gmail.com>
- *
- * This source file is subject to the MIT license that is bundled
- * with this source code in the file LICENSE.
- */
-
-namespace PhpCsFixer\Fixer\FunctionNotation;
-
-use PhpCsFixer\AbstractPhpdocToTypeDeclarationFixer;
-use PhpCsFixer\Fixer\ConfigurableFixerInterface;
-use PhpCsFixer\Fixer\ExperimentalFixerInterface;
-use PhpCsFixer\FixerDefinition\CodeSample;
-use PhpCsFixer\FixerDefinition\FixerDefinition;
-use PhpCsFixer\FixerDefinition\FixerDefinitionInterface;
-use PhpCsFixer\FixerDefinition\VersionSpecification;
-use PhpCsFixer\FixerDefinition\VersionSpecificCodeSample;
-use PhpCsFixer\Tokenizer\CT;
-use PhpCsFixer\Tokenizer\Token;
-use PhpCsFixer\Tokenizer\Tokens;
-
-/**
- * @author Filippo Tessarotto <zoeslam@gmail.com>
- *
- * @implements ConfigurableFixerInterface<_AutogeneratedInputConfiguration, _AutogeneratedComputedConfiguration>
- *
- * @phpstan-type _AutogeneratedInputConfiguration array{
- *  scalar_types?: bool,
- *  types_map?: array<string, string>,
- *  union_types?: bool,
- * }
- * @phpstan-type _AutogeneratedComputedConfiguration array{
- *  scalar_types: bool,
- *  types_map: array<string, string>,
- *  union_types: bool,
- * }
- */
-final class PhpdocToReturnTypeFixer extends AbstractPhpdocToTypeDeclarationFixer implements ConfigurableFixerInterface, ExperimentalFixerInterface
-{
-    private const TYPE_CHECK_TEMPLATE = '<?php function f(): %s {}';
-
-    /**
-     * @var array<int, array<int, int|string>>
-     */
-    private array $excludeFuncNames = [
-        [T_STRING, '__construct'],
-        [T_STRING, '__destruct'],
-        [T_STRING, '__clone'],
-    ];
-
-    /**
-     * @var array<string, true>
-     */
-    private array $skippedTypes = [
-        'resource' => true,
-        'null' => true,
-    ];
-
-    public function getDefinition(): FixerDefinitionInterface
-    {
-        return new FixerDefinition(
-            'Takes `@return` annotation of non-mixed types and adjusts accordingly the function signature.',
-            [
-                new CodeSample(
-                    '<?php
-
-/** @return \My\Bar */
-function f1()
-{}
-
-/** @return void */
-function f2()
-{}
-
-/** @return object */
-function my_foo()
-{}
-',
-                ),
-                new CodeSample(
-                    '<?php
-
-/** @return Foo */
-function foo() {}
-/** @return string */
-function bar() {}
-',
-                    ['scalar_types' => false]
-                ),
-                new CodeSample(
-                    '<?php
-
-/** @return Foo */
-function foo() {}
-/** @return int|string */
-function bar() {}
-',
-                    ['union_types' => false]
-                ),
-                new VersionSpecificCodeSample(
-                    '<?php
-final class Foo {
-    /**
-     * @return static
-     */
-    public function create($prototype) {
-        return new static($prototype);
-    }
-}
-',
-                    new VersionSpecification(8_00_00)
-                ),
-            ],
-            null,
-            'The `@return` annotation is mandatory for the fixer to make changes, signatures of methods without it (no docblock, inheritdocs) will not be fixed. Manual actions are required if inherited signatures are not properly documented.'
-        );
-    }
-
-    public function isCandidate(Tokens $tokens): bool
-    {
-        return $tokens->isAnyTokenKindsFound([T_FUNCTION, T_FN]);
-    }
-
-    /**
-     * {@inheritdoc}
-     *
-     * Must run before FullyQualifiedStrictTypesFixer, NoSuperfluousPhpdocTagsFixer, PhpdocAlignFixer, ReturnToYieldFromFixer, ReturnTypeDeclarationFixer.
-     * Must run after AlignMultilineCommentFixer, CommentToPhpdocFixer, PhpdocIndentFixer, PhpdocScalarFixer, PhpdocToCommentFixer, PhpdocTypesFixer.
-     */
-    public function getPriority(): int
-    {
-        return 13;
-    }
-
-    protected function isSkippedType(string $type): bool
-    {
-        return isset($this->skippedTypes[$type]);
-    }
-
-    protected function applyFix(\SplFileInfo $file, Tokens $tokens): void
-    {
-        for ($index = $tokens->count() - 1; 0 < $index; --$index) {
-            if (!$tokens[$index]->isGivenKind([T_FUNCTION, T_FN])) {
-                continue;
-            }
-
-            $funcName = $tokens->getNextMeaningfulToken($index);
-
-            if ($tokens[$funcName]->equalsAny($this->excludeFuncNames, false)) {
-                continue;
-            }
-
-            $docCommentIndex = $this->findFunctionDocComment($tokens, $index);
-            if (null === $docCommentIndex) {
-                continue;
-            }
-
-            $returnTypeAnnotations = $this->getAnnotationsFromDocComment('return', $tokens, $docCommentIndex);
-            if (1 !== \count($returnTypeAnnotations)) {
-                continue;
-            }
-
-            $returnTypeAnnotation = $returnTypeAnnotations[0];
-
-            $typesExpression = $returnTypeAnnotation->getTypeExpression();
-
-            if (null === $typesExpression) {
-                continue;
-            }
-
-            $typeInfo = $this->getCommonTypeInfo($typesExpression, true);
-            $unionTypes = null;
-
-            if (null === $typeInfo) {
-                $unionTypes = $this->getUnionTypes($typesExpression, true);
-            }
-
-            if (null === $typeInfo && null === $unionTypes) {
-                continue;
-            }
-
-            if (null !== $typeInfo) {
-                $returnType = $typeInfo['commonType'];
-                $isNullable = $typeInfo['isNullable'];
-            } elseif (null !== $unionTypes) {
-                $returnType = $unionTypes;
-                $isNullable = false;
-            }
-
-            if (!isset($returnType, $isNullable)) {
-                continue;
-            }
-
-            $paramsStartIndex = $tokens->getNextTokenOfKind($index, ['(']);
-            $paramsEndIndex = $tokens->findBlockEnd(Tokens::BLOCK_TYPE_PARENTHESIS_BRACE, $paramsStartIndex);
-
-            $bodyStartIndex = $tokens->getNextTokenOfKind($paramsEndIndex, ['{', ';', [T_DOUBLE_ARROW]]);
-
-            if ($this->hasReturnTypeHint($tokens, $bodyStartIndex)) {
-                continue;
-            }
-
-            if (!$this->isValidSyntax(\sprintf(self::TYPE_CHECK_TEMPLATE, $returnType))) {
-                continue;
-            }
-
-            $tokens->insertAt(
-                $paramsEndIndex + 1,
-                array_merge(
-                    [
-                        new Token([CT::T_TYPE_COLON, ':']),
-                        new Token([T_WHITESPACE, ' ']),
-                    ],
-                    $this->createTypeDeclarationTokens($returnType, $isNullable)
-                )
-            );
-        }
-    }
-
-    protected function createTokensFromRawType(string $type): Tokens
-    {
-        $typeTokens = Tokens::fromCode(\sprintf(self::TYPE_CHECK_TEMPLATE, $type));
-        $typeTokens->clearRange(0, 7);
-        $typeTokens->clearRange(\count($typeTokens) - 3, \count($typeTokens) - 1);
-        $typeTokens->clearEmptyTokens();
-
-        return $typeTokens;
-    }
-
-    /**
-     * Determine whether the function already has a return type hint.
-     *
-     * @param int $index The index of the end of the function definition line, EG at { or ;
-     */
-    private function hasReturnTypeHint(Tokens $tokens, int $index): bool
-    {
-        $endFuncIndex = $tokens->getPrevTokenOfKind($index, [')']);
-        $nextIndex = $tokens->getNextMeaningfulToken($endFuncIndex);
-
-        return $tokens[$nextIndex]->isGivenKind(CT::T_TYPE_COLON);
-    }
-}

package/vendor/friendsofphp/php-cs-fixer/src/Fixer/FunctionNotation/RegularCallableCallFixer.php

@@ -1,256 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-/*
- * This file is part of PHP CS Fixer.
- *
- * (c) Fabien Potencier <fabien@symfony.com>
- *     Dariusz Rumiński <dariusz.ruminski@gmail.com>
- *
- * This source file is subject to the MIT license that is bundled
- * with this source code in the file LICENSE.
- */
-
-namespace PhpCsFixer\Fixer\FunctionNotation;
-
-use PhpCsFixer\AbstractFixer;
-use PhpCsFixer\FixerDefinition\CodeSample;
-use PhpCsFixer\FixerDefinition\FixerDefinition;
-use PhpCsFixer\FixerDefinition\FixerDefinitionInterface;
-use PhpCsFixer\Tokenizer\Analyzer\ArgumentsAnalyzer;
-use PhpCsFixer\Tokenizer\Analyzer\FunctionsAnalyzer;
-use PhpCsFixer\Tokenizer\Token;
-use PhpCsFixer\Tokenizer\Tokens;
-
-/**
- * @author Dariusz Rumiński <dariusz.ruminski@gmail.com>
- */
-final class RegularCallableCallFixer extends AbstractFixer
-{
-    public function getDefinition(): FixerDefinitionInterface
-    {
-        return new FixerDefinition(
-            'Callables must be called without using `call_user_func*` when possible.',
-            [
-                new CodeSample(
-                    '<?php
-    call_user_func("var_dump", 1, 2);
-
-    call_user_func("Bar\Baz::d", 1, 2);
-
-    call_user_func_array($callback, [1, 2]);
-'
-                ),
-                new CodeSample(
-                    '<?php
-call_user_func(function ($a, $b) { var_dump($a, $b); }, 1, 2);
-
-call_user_func(static function ($a, $b) { var_dump($a, $b); }, 1, 2);
-'
-                ),
-            ],
-            null,
-            'Risky when the `call_user_func` or `call_user_func_array` function is overridden or when are used in constructions that should be avoided, like `call_user_func_array(\'foo\', [\'bar\' => \'baz\'])` or `call_user_func($foo, $foo = \'bar\')`.'
-        );
-    }
-
-    /**
-     * {@inheritdoc}
-     *
-     * Must run before NativeFunctionInvocationFixer.
-     * Must run after NoBinaryStringFixer, NoUselessConcatOperatorFixer.
-     */
-    public function getPriority(): int
-    {
-        return 2;
-    }
-
-    public function isCandidate(Tokens $tokens): bool
-    {
-        return $tokens->isTokenKindFound(T_STRING);
-    }
-
-    public function isRisky(): bool
-    {
-        return true;
-    }
-
-    protected function applyFix(\SplFileInfo $file, Tokens $tokens): void
-    {
-        $functionsAnalyzer = new FunctionsAnalyzer();
-        $argumentsAnalyzer = new ArgumentsAnalyzer();
-
-        for ($index = $tokens->count() - 1; $index > 0; --$index) {
-            if (!$tokens[$index]->equalsAny([[T_STRING, 'call_user_func'], [T_STRING, 'call_user_func_array']], false)) {
-                continue;
-            }
-
-            if (!$functionsAnalyzer->isGlobalFunctionCall($tokens, $index)) {
-                continue; // redeclare/override
-            }
-
-            $openParenthesis = $tokens->getNextMeaningfulToken($index);
-            $closeParenthesis = $tokens->findBlockEnd(Tokens::BLOCK_TYPE_PARENTHESIS_BRACE, $openParenthesis);
-            $arguments = $argumentsAnalyzer->getArguments($tokens, $openParenthesis, $closeParenthesis);
-
-            if (1 > \count($arguments)) {
-                return; // no arguments!
-            }
-
-            $this->processCall($tokens, $index, $arguments);
-        }
-    }
-
-    /**
-     * @param non-empty-array<int, int> $arguments
-     */
-    private function processCall(Tokens $tokens, int $index, array $arguments): void
-    {
-        $firstArgIndex = $tokens->getNextMeaningfulToken(
-            $tokens->getNextMeaningfulToken($index)
-        );
-
-        /** @var Token $firstArgToken */
-        $firstArgToken = $tokens[$firstArgIndex];
-
-        if ($firstArgToken->isGivenKind(T_CONSTANT_ENCAPSED_STRING)) {
-            $afterFirstArgIndex = $tokens->getNextMeaningfulToken($firstArgIndex);
-
-            if (!$tokens[$afterFirstArgIndex]->equalsAny([',', ')'])) {
-                return; // first argument is an expression like `call_user_func("foo"."bar", ...)`, not supported!
-            }
-
-            $firstArgTokenContent = $firstArgToken->getContent();
-
-            if (!$this->isValidFunctionInvoke($firstArgTokenContent)) {
-                return;
-            }
-
-            $newCallTokens = Tokens::fromCode('<?php '.substr(str_replace('\\\\', '\\', $firstArgToken->getContent()), 1, -1).'();');
-            $newCallTokensSize = $newCallTokens->count();
-            $newCallTokens->clearAt(0);
-            $newCallTokens->clearRange($newCallTokensSize - 3, $newCallTokensSize - 1);
-            $newCallTokens->clearEmptyTokens();
-
-            $this->replaceCallUserFuncWithCallback($tokens, $index, $newCallTokens, $firstArgIndex, $firstArgIndex);
-        } elseif (
-            $firstArgToken->isGivenKind(T_FUNCTION)
-            || (
-                $firstArgToken->isGivenKind(T_STATIC)
-                && $tokens[$tokens->getNextMeaningfulToken($firstArgIndex)]->isGivenKind(T_FUNCTION)
-            )
-        ) {
-            $firstArgEndIndex = $tokens->findBlockEnd(
-                Tokens::BLOCK_TYPE_CURLY_BRACE,
-                $tokens->getNextTokenOfKind($firstArgIndex, ['{'])
-            );
-
-            $newCallTokens = $this->getTokensSubcollection($tokens, $firstArgIndex, $firstArgEndIndex);
-            $newCallTokens->insertAt($newCallTokens->count(), new Token(')'));
-            $newCallTokens->insertAt(0, new Token('('));
-            $this->replaceCallUserFuncWithCallback($tokens, $index, $newCallTokens, $firstArgIndex, $firstArgEndIndex);
-        } elseif ($firstArgToken->isGivenKind(T_VARIABLE)) {
-            $firstArgEndIndex = reset($arguments);
-
-            // check if the same variable is used multiple times and if so do not fix
-
-            foreach ($arguments as $argumentStart => $argumentEnd) {
-                if ($firstArgEndIndex === $argumentEnd) {
-                    continue;
-                }
-
-                for ($i = $argumentStart; $i <= $argumentEnd; ++$i) {
-                    if ($tokens[$i]->equals($firstArgToken)) {
-                        return;
-                    }
-                }
-            }
-
-            // check if complex statement and if so wrap the call in () if on PHP 7 or up, else do not fix
-
-            $newCallTokens = $this->getTokensSubcollection($tokens, $firstArgIndex, $firstArgEndIndex);
-            $complex = false;
-
-            for ($newCallIndex = \count($newCallTokens) - 1; $newCallIndex >= 0; --$newCallIndex) {
-                if ($newCallTokens[$newCallIndex]->isGivenKind([T_WHITESPACE, T_COMMENT, T_DOC_COMMENT, T_VARIABLE])) {
-                    continue;
-                }
-
-                $blockType = Tokens::detectBlockType($newCallTokens[$newCallIndex]);
-
-                if (null !== $blockType && (Tokens::BLOCK_TYPE_ARRAY_INDEX_CURLY_BRACE === $blockType['type'] || Tokens::BLOCK_TYPE_INDEX_SQUARE_BRACE === $blockType['type'])) {
-                    $newCallIndex = $newCallTokens->findBlockStart($blockType['type'], $newCallIndex);
-
-                    continue;
-                }
-
-                $complex = true;
-
-                break;
-            }
-
-            if ($complex) {
-                $newCallTokens->insertAt($newCallTokens->count(), new Token(')'));
-                $newCallTokens->insertAt(0, new Token('('));
-            }
-            $this->replaceCallUserFuncWithCallback($tokens, $index, $newCallTokens, $firstArgIndex, $firstArgEndIndex);
-        }
-    }
-
-    private function replaceCallUserFuncWithCallback(Tokens $tokens, int $callIndex, Tokens $newCallTokens, int $firstArgStartIndex, int $firstArgEndIndex): void
-    {
-        $tokens->clearRange($firstArgStartIndex, $firstArgEndIndex);
-
-        $afterFirstArgIndex = $tokens->getNextMeaningfulToken($firstArgEndIndex);
-        $afterFirstArgToken = $tokens[$afterFirstArgIndex];
-
-        if ($afterFirstArgToken->equals(',')) {
-            $useEllipsis = $tokens[$callIndex]->equals([T_STRING, 'call_user_func_array'], false);
-
-            if ($useEllipsis) {
-                $secondArgIndex = $tokens->getNextMeaningfulToken($afterFirstArgIndex);
-                $tokens->insertAt($secondArgIndex, new Token([T_ELLIPSIS, '...']));
-            }
-
-            $tokens->clearAt($afterFirstArgIndex);
-            $tokens->removeTrailingWhitespace($afterFirstArgIndex);
-        }
-
-        $tokens->overrideRange($callIndex, $callIndex, $newCallTokens);
-        $prevIndex = $tokens->getPrevMeaningfulToken($callIndex);
-
-        if ($tokens[$prevIndex]->isGivenKind(T_NS_SEPARATOR)) {
-            $tokens->clearTokenAndMergeSurroundingWhitespace($prevIndex);
-        }
-    }
-
-    private function getTokensSubcollection(Tokens $tokens, int $indexStart, int $indexEnd): Tokens
-    {
-        $size = $indexEnd - $indexStart + 1;
-        $subCollection = new Tokens($size);
-
-        for ($i = 0; $i < $size; ++$i) {
-            /** @var Token $toClone */
-            $toClone = $tokens[$i + $indexStart];
-            $subCollection[$i] = clone $toClone;
-        }
-
-        return $subCollection;
-    }
-
-    private function isValidFunctionInvoke(string $name): bool
-    {
-        if (\strlen($name) < 3 || 'b' === $name[0] || 'B' === $name[0]) {
-            return false;
-        }
-
-        $name = substr($name, 1, -1);
-
-        if ($name !== trim($name)) {
-            return false;
-        }
-
-        return true;
-    }
-}

package/vendor/friendsofphp/php-cs-fixer/src/Fixer/FunctionNotation/ReturnTypeDeclarationFixer.php

@@ -1,132 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-/*
- * This file is part of PHP CS Fixer.
- *
- * (c) Fabien Potencier <fabien@symfony.com>
- *     Dariusz Rumiński <dariusz.ruminski@gmail.com>
- *
- * This source file is subject to the MIT license that is bundled
- * with this source code in the file LICENSE.
- */
-
-namespace PhpCsFixer\Fixer\FunctionNotation;
-
-use PhpCsFixer\AbstractFixer;
-use PhpCsFixer\Fixer\ConfigurableFixerInterface;
-use PhpCsFixer\Fixer\ConfigurableFixerTrait;
-use PhpCsFixer\FixerConfiguration\FixerConfigurationResolver;
-use PhpCsFixer\FixerConfiguration\FixerConfigurationResolverInterface;
-use PhpCsFixer\FixerConfiguration\FixerOptionBuilder;
-use PhpCsFixer\FixerDefinition\CodeSample;
-use PhpCsFixer\FixerDefinition\FixerDefinition;
-use PhpCsFixer\FixerDefinition\FixerDefinitionInterface;
-use PhpCsFixer\Tokenizer\CT;
-use PhpCsFixer\Tokenizer\Token;
-use PhpCsFixer\Tokenizer\Tokens;
-
-/**
- * @author Dariusz Rumiński <dariusz.ruminski@gmail.com>
- *
- * @implements ConfigurableFixerInterface<_AutogeneratedInputConfiguration, _AutogeneratedComputedConfiguration>
- *
- * @phpstan-type _AutogeneratedInputConfiguration array{
- *  space_before?: 'none'|'one',
- * }
- * @phpstan-type _AutogeneratedComputedConfiguration array{
- *  space_before: 'none'|'one',
- * }
- */
-final class ReturnTypeDeclarationFixer extends AbstractFixer implements ConfigurableFixerInterface
-{
-    /** @use ConfigurableFixerTrait<_AutogeneratedInputConfiguration, _AutogeneratedComputedConfiguration> */
-    use ConfigurableFixerTrait;
-
-    public function getDefinition(): FixerDefinitionInterface
-    {
-        return new FixerDefinition(
-            'Adjust spacing around colon in return type declarations and backed enum types.',
-            [
-                new CodeSample(
-                    "<?php\nfunction foo(int \$a):string {};\n"
-                ),
-                new CodeSample(
-                    "<?php\nfunction foo(int \$a):string {};\n",
-                    ['space_before' => 'none']
-                ),
-                new CodeSample(
-                    "<?php\nfunction foo(int \$a):string {};\n",
-                    ['space_before' => 'one']
-                ),
-            ],
-            'Rule is applied only in a PHP 7+ environment.'
-        );
-    }
-
-    /**
-     * {@inheritdoc}
-     *
-     * Must run after PhpUnitDataProviderReturnTypeFixer, PhpdocToReturnTypeFixer, VoidReturnFixer.
-     */
-    public function getPriority(): int
-    {
-        return -17;
-    }
-
-    public function isCandidate(Tokens $tokens): bool
-    {
-        return $tokens->isTokenKindFound(CT::T_TYPE_COLON);
-    }
-
-    protected function applyFix(\SplFileInfo $file, Tokens $tokens): void
-    {
-        $oneSpaceBefore = 'one' === $this->configuration['space_before'];
-
-        for ($index = 0, $limit = $tokens->count(); $index < $limit; ++$index) {
-            if (!$tokens[$index]->isGivenKind(CT::T_TYPE_COLON)) {
-                continue;
-            }
-
-            $previousIndex = $index - 1;
-            $previousToken = $tokens[$previousIndex];
-
-            if ($previousToken->isWhitespace()) {
-                if (!$tokens[$tokens->getPrevNonWhitespace($index - 1)]->isComment()) {
-                    if ($oneSpaceBefore) {
-                        $tokens[$previousIndex] = new Token([T_WHITESPACE, ' ']);
-                    } else {
-                        $tokens->clearAt($previousIndex);
-                    }
-                }
-            } elseif ($oneSpaceBefore) {
-                $tokenWasAdded = $tokens->ensureWhitespaceAtIndex($index, 0, ' ');
-
-                if ($tokenWasAdded) {
-                    ++$limit;
-                }
-
-                ++$index;
-            }
-
-            ++$index;
-
-            $tokenWasAdded = $tokens->ensureWhitespaceAtIndex($index, 0, ' ');
-
-            if ($tokenWasAdded) {
-                ++$limit;
-            }
-        }
-    }
-
-    protected function createConfigurationDefinition(): FixerConfigurationResolverInterface
-    {
-        return new FixerConfigurationResolver([
-            (new FixerOptionBuilder('space_before', 'Spacing to apply before colon.'))
-                ->setAllowedValues(['one', 'none'])
-                ->setDefault('none')
-                ->getOption(),
-        ]);
-    }
-}