sdc-build-wp 4.1.0 → 4.1.2

package/vendor/phpcsstandards/phpcsextra/Universal/Sniffs/CodeAnalysis/ConstructorDestructorReturnSniff.php

@@ -1,211 +0,0 @@
-<?php
-/**
- * PHPCSExtra, a collection of sniffs and standards for use with PHP_CodeSniffer.
- *
- * @package   PHPCSExtra
- * @copyright 2020 PHPCSExtra Contributors
- * @license   https://opensource.org/licenses/LGPL-3.0 LGPL3
- * @link      https://github.com/PHPCSStandards/PHPCSExtra
- */
-
-namespace PHPCSExtra\Universal\Sniffs\CodeAnalysis;
-
-use PHP_CodeSniffer\Files\File;
-use PHP_CodeSniffer\Sniffs\Sniff;
-use PHP_CodeSniffer\Util\Tokens;
-use PHPCSUtils\BackCompat\BCFile;
-use PHPCSUtils\BackCompat\Helper;
-use PHPCSUtils\Tokens\Collections;
-use PHPCSUtils\Utils\FunctionDeclarations;
-use PHPCSUtils\Utils\GetTokensAsString;
-use PHPCSUtils\Utils\Namespaces;
-use PHPCSUtils\Utils\NamingConventions;
-use PHPCSUtils\Utils\ObjectDeclarations;
-use PHPCSUtils\Utils\Scopes;
-
-/**
- * Verify that a class constructor/destructor does not return anything, nor has a
- * return type declaration (fatal error).
- *
- * @since 1.0.0
- */
-final class ConstructorDestructorReturnSniff implements Sniff
-{
-
-    /**
-     * PHP version as configured or 0 if unknown.
-     *
-     * @since 1.1.0
-     *
-     * @var int
-     */
-    private $phpVersion;
-
-    /**
-     * Registers the tokens that this sniff wants to listen for.
-     *
-     * @since 1.0.0
-     *
-     * @return array<int|string>
-     */
-    public function register()
-    {
-        return [\T_FUNCTION];
-    }
-
-    /**
-     * Processes this test, when one of its tokens is encountered.
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
-     * @param int                         $stackPtr  The position of the current token
-     *                                               in the stack passed in $tokens.
-     *
-     * @return void
-     */
-    public function process(File $phpcsFile, $stackPtr)
-    {
-        if (isset($this->phpVersion) === false || \defined('PHP_CODESNIFFER_IN_TESTS')) {
-            // Set default value to prevent this code from running every time the sniff is triggered.
-            $this->phpVersion = 0;
-
-            $phpVersion = Helper::getConfigData('php_version');
-            if ($phpVersion !== null) {
-                $this->phpVersion = (int) $phpVersion;
-            }
-        }
-
-        $scopePtr = Scopes::validDirectScope($phpcsFile, $stackPtr, Tokens::$ooScopeTokens);
-        if ($scopePtr === false) {
-            // Not an OO method.
-            return;
-        }
-
-        $functionName   = FunctionDeclarations::getName($phpcsFile, $stackPtr);
-        $functionNameLC = \strtolower($functionName);
-
-        if ($functionNameLC === '__construct' || $functionNameLC === '__destruct') {
-            $functionType = \sprintf('A "%s()" magic method', $functionNameLC);
-        } else {
-            // If the PHP version is explicitly set to PHP 8.0 or higher, ignore PHP 4-style constructors.
-            if ($this->phpVersion >= 80000) {
-                return;
-            }
-
-            // This may be a PHP 4-style constructor which should be handled.
-            $OOName = ObjectDeclarations::getName($phpcsFile, $scopePtr);
-
-            if (empty($OOName) === true) {
-                // Anonymous class or parse error. The function can't be a PHP 4-style constructor.
-                return;
-            }
-
-            if (NamingConventions::isEqual($functionName, $OOName) === false) {
-                // Class and function name not the same, so not a PHP 4-style constructor.
-                return;
-            }
-
-            if (Namespaces::determineNamespace($phpcsFile, $stackPtr) !== '') {
-                /*
-                 * Namespaced methods with the same name as the class are treated as
-                 * regular methods, so we can bow out if we're in a namespace.
-                 *
-                 * Note: the exception to this is PHP 5.3.0-5.3.2. This is currently
-                 * not dealt with.
-                 */
-                return;
-            }
-
-            $functionType = 'A PHP 4-style constructor';
-        }
-
-        /*
-         * OK, so now we know for sure that this is a constructor/destructor method.
-         */
-
-         // Check for a return type.
-        $tokens     = $phpcsFile->getTokens();
-        $properties = FunctionDeclarations::getProperties($phpcsFile, $stackPtr);
-        if ($properties['return_type'] !== '' && $properties['return_type_token'] !== false) {
-            $data = [
-                $functionType,
-                $properties['return_type'],
-            ];
-
-            $fix = $phpcsFile->addFixableError(
-                '%s can not declare a return type. Found: %s',
-                $properties['return_type_token'],
-                'ReturnTypeFound',
-                $data
-            );
-
-            if ($fix === true) {
-                $phpcsFile->fixer->beginChangeset();
-
-                $parensCloser = $tokens[$stackPtr]['parenthesis_closer'];
-                for ($i = ($parensCloser + 1); $i <= $properties['return_type_end_token']; $i++) {
-                    if (isset(Tokens::$commentTokens[$tokens[$i]['code']])) {
-                        // Ignore comments and leave them be.
-                        continue;
-                    }
-
-                    $phpcsFile->fixer->replaceToken($i, '');
-                }
-
-                $phpcsFile->fixer->endChangeset();
-            }
-        }
-
-        if (isset($tokens[$stackPtr]['scope_opener'], $tokens[$stackPtr]['scope_closer']) === false) {
-            // Abstract/interface method, live coding or parse error.
-            return;
-        }
-
-        // Check for a value being returned.
-        $current = $tokens[$stackPtr]['scope_opener'];
-        $end     = $tokens[$stackPtr]['scope_closer'];
-
-        // Not searching for arrow functions as those have an implicit return, so no
-        $search            = Collections::functionDeclarationTokens();
-        $search[\T_RETURN] = \T_RETURN;
-
-        do {
-            $current = $phpcsFile->findNext($search, ($current + 1), $end);
-            if ($current === false) {
-                break;
-            }
-
-            if (isset(Collections::functionDeclarationTokens()[$tokens[$current]['code']])
-                && isset($tokens[$current]['scope_closer'])
-            ) {
-                // Skip over nested function/closure declarations.
-                $current = $tokens[$current]['scope_closer'];
-                continue;
-            }
-
-            $next = $phpcsFile->findNext(Tokens::$emptyTokens, ($current + 1), $end, true);
-            if ($next === false
-                || $tokens[$next]['code'] === \T_SEMICOLON
-                || $tokens[$next]['code'] === \T_CLOSE_TAG
-            ) {
-                // Return statement without value.
-                continue;
-            }
-
-            $endOfStatement = BCFile::findEndOfStatement($phpcsFile, $next);
-
-            $data = [
-                $functionType,
-                GetTokensAsString::compact($phpcsFile, $current, $endOfStatement, true),
-            ];
-
-            $phpcsFile->addWarning(
-                '%s can not return a value. Found: "%s"',
-                $current,
-                'ReturnValueFound',
-                $data
-            );
-        } while ($current < $end);
-    }
-}

package/vendor/phpcsstandards/phpcsextra/Universal/Sniffs/CodeAnalysis/ForeachUniqueAssignmentSniff.php

@@ -1,153 +0,0 @@
-<?php
-/**
- * PHPCSExtra, a collection of sniffs and standards for use with PHP_CodeSniffer.
- *
- * @package   PHPCSExtra
- * @copyright 2020 PHPCSExtra Contributors
- * @license   https://opensource.org/licenses/LGPL-3.0 LGPL3
- * @link      https://github.com/PHPCSStandards/PHPCSExtra
- */
-
-namespace PHPCSExtra\Universal\Sniffs\CodeAnalysis;
-
-use PHP_CodeSniffer\Files\File;
-use PHP_CodeSniffer\Sniffs\Sniff;
-use PHP_CodeSniffer\Util\Tokens;
-use PHPCSUtils\Tokens\Collections;
-use PHPCSUtils\Utils\GetTokensAsString;
-use PHPCSUtils\Utils\Lists;
-
-/**
- * Detects using the same variable for both the key as well as the value in a foreach assignment.
- *
- * @link https://twitter.com/exakat/status/1509103728934203397
- * @link https://3v4l.org/DdddX
- *
- * @since 1.0.0
- */
-final class ForeachUniqueAssignmentSniff implements Sniff
-{
-
-    /**
-     * Returns an array of tokens this test wants to listen for.
-     *
-     * @since 1.0.0
-     *
-     * @return array<int|string>
-     */
-    public function register()
-    {
-        return [\T_FOREACH];
-    }
-
-    /**
-     * Processes this test, when one of its tokens is encountered.
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
-     * @param int                         $stackPtr  The position of the current token
-     *                                               in the stack passed in $tokens.
-     *
-     * @return void
-     */
-    public function process(File $phpcsFile, $stackPtr)
-    {
-        $tokens = $phpcsFile->getTokens();
-
-        if (isset($tokens[$stackPtr]['parenthesis_opener'], $tokens[$stackPtr]['parenthesis_closer']) === false) {
-            // Parse error or live coding, not our concern.
-            return;
-        }
-
-        $opener = $tokens[$stackPtr]['parenthesis_opener'];
-        $closer = $tokens[$stackPtr]['parenthesis_closer'];
-
-        $asPtr = $phpcsFile->findNext(\T_AS, ($opener + 1), $closer);
-        if ($asPtr === false) {
-            // Parse error or live coding, not our concern.
-            return;
-        }
-
-        // Real target.
-        $find = [\T_DOUBLE_ARROW];
-        // Prevent matching on double arrows within a list assignment.
-        $find += Collections::listTokens();
-
-        $doubleArrowPtr = $phpcsFile->findNext($find, ($asPtr + 1), $closer);
-        if ($doubleArrowPtr === false
-            || $tokens[$doubleArrowPtr]['code'] !== \T_DOUBLE_ARROW
-        ) {
-            // No key assignment.
-            return;
-        }
-
-        $isListAssignment = $phpcsFile->findNext(Tokens::$emptyTokens, ($doubleArrowPtr + 1), $closer, true);
-        if ($isListAssignment === false) {
-            // Parse error or live coding, not our concern.
-        }
-
-        $keyAsString      = \ltrim(GetTokensAsString::noEmpties($phpcsFile, ($asPtr + 1), ($doubleArrowPtr - 1)), '&');
-        $valueAssignments = [];
-        if (isset(Collections::listTokens()[$tokens[$isListAssignment]['code']]) === false) {
-            // Single value assignment.
-            $valueAssignments[] = GetTokensAsString::noEmpties($phpcsFile, ($doubleArrowPtr + 1), ($closer - 1));
-        } else {
-            // List assignment.
-            $assignments = Lists::getAssignments($phpcsFile, $isListAssignment);
-            foreach ($assignments as $listItem) {
-                if ($listItem['assignment'] === '') {
-                    // Ignore empty list assignments.
-                    continue;
-                }
-
-                // Note: this doesn't take nested lists into account (yet).
-                $valueAssignments[] = $listItem['assignment'];
-            }
-        }
-
-        if (empty($valueAssignments)) {
-            // No assignments found.
-            return;
-        }
-
-        foreach ($valueAssignments as $valueAsString) {
-            $valueAsString = \ltrim($valueAsString, '&');
-
-            if ($keyAsString !== $valueAsString) {
-                // Key and value not the same.
-                continue;
-            }
-
-            $error  = 'The variables used for the key and the value in a foreach assignment should be unique.';
-            $error .= 'Both the key and the value will currently be assigned to: "%s"';
-
-            $fix = $phpcsFile->addFixableError($error, $doubleArrowPtr, 'NotUnique', [$valueAsString]);
-            if ($fix === true) {
-                $phpcsFile->fixer->beginChangeset();
-
-                // Remove the key.
-                for ($i = ($asPtr + 1); $i < ($doubleArrowPtr + 1); $i++) {
-                    if ($tokens[$i]['code'] === \T_WHITESPACE
-                        && isset(Tokens::$commentTokens[$tokens[($i + 1)]['code']])
-                    ) {
-                        // Don't remove whitespace when followed directly by a comment.
-                        continue;
-                    }
-
-                    if (isset(Tokens::$commentTokens[$tokens[$i]['code']])) {
-                        // Don't remove comments.
-                        continue;
-                    }
-
-                    // Remove everything else.
-                    $phpcsFile->fixer->replaceToken($i, '');
-                }
-
-                $phpcsFile->fixer->endChangeset();
-            }
-
-            break;
-        }
-    }
-}

package/vendor/phpcsstandards/phpcsextra/Universal/Sniffs/CodeAnalysis/NoDoubleNegativeSniff.php

@@ -1,269 +0,0 @@
-<?php
-/**
- * PHPCSExtra, a collection of sniffs and standards for use with PHP_CodeSniffer.
- *
- * @package   PHPCSExtra
- * @copyright 2023 PHPCSExtra Contributors
- * @license   https://opensource.org/licenses/LGPL-3.0 LGPL3
- * @link      https://github.com/PHPCSStandards/PHPCSExtra
- */
-
-namespace PHPCSExtra\Universal\Sniffs\CodeAnalysis;
-
-use PHP_CodeSniffer\Files\File;
-use PHP_CodeSniffer\Sniffs\Sniff;
-use PHP_CodeSniffer\Util\Tokens;
-use PHPCSUtils\BackCompat\BCFile;
-use PHPCSUtils\Utils\GetTokensAsString;
-use PHPCSUtils\Utils\Parentheses;
-
-/**
- * Detects double negation in code, which is effectively the same as a boolean cast,
- * but with a much higher cognitive load.
- *
- * The sniff will only autofix if the precedence change from boolean not to boolean cast
- * will not cause a behavioural change (as it would with instanceof).
- *
- * @since 1.2.0
- */
-final class NoDoubleNegativeSniff implements Sniff
-{
-
-    /**
-     * Operators with lower precedence than the not-operator.
-     *
-     * Used to determine when to stop searching for `instanceof`.
-     *
-     * @since 1.2.0
-     *
-     * @var array<int|string, int|string>
-     */
-    private $operatorsWithLowerPrecedence;
-
-    /**
-     * Returns an array of tokens this test wants to listen for.
-     *
-     * @since 1.2.0
-     *
-     * @return array<int|string>
-     */
-    public function register()
-    {
-        // Collect all the operators only once.
-        $this->operatorsWithLowerPrecedence                 = Tokens::$assignmentTokens;
-        $this->operatorsWithLowerPrecedence                += Tokens::$booleanOperators;
-        $this->operatorsWithLowerPrecedence                += Tokens::$comparisonTokens;
-        $this->operatorsWithLowerPrecedence                += Tokens::$operators;
-        $this->operatorsWithLowerPrecedence[\T_INLINE_THEN] = \T_INLINE_THEN;
-        $this->operatorsWithLowerPrecedence[\T_INLINE_ELSE] = \T_INLINE_ELSE;
-
-        return [\T_BOOLEAN_NOT];
-    }
-
-    /**
-     * Processes this test, when one of its tokens is encountered.
-     *
-     * @since 1.2.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
-     * @param int                         $stackPtr  The position of the current token
-     *                                               in the stack passed in $tokens.
-     *
-     * @return int|void Integer stack pointer to skip forward or void to continue
-     *                  normal file processing.
-     */
-    public function process(File $phpcsFile, $stackPtr)
-    {
-        $tokens = $phpcsFile->getTokens();
-
-        $notCount = 1;
-        $lastNot  = $stackPtr;
-        for ($afterNot = ($stackPtr + 1); $afterNot < $phpcsFile->numTokens; $afterNot++) {
-            if (isset(Tokens::$emptyTokens[$tokens[$afterNot]['code']])) {
-                continue;
-            }
-
-            if ($tokens[$afterNot]['code'] === \T_BOOLEAN_NOT) {
-                $lastNot = $afterNot;
-                ++$notCount;
-                continue;
-            }
-
-            break;
-        }
-
-        if ($notCount === 1) {
-            // Singular unary not-operator. Nothing to do.
-            return;
-        }
-
-        $found = \trim(GetTokensAsString::compact($phpcsFile, $stackPtr, $lastNot));
-        $data  = [$found];
-
-        if (($notCount % 2) === 1) {
-            /*
-             * Oh dear... silly code time, found a triple negative (or other uneven number),
-             * this should just be a singular not-operator.
-             */
-            $fix = $phpcsFile->addFixableError(
-                'Triple negative (or more) detected. Use a singular not (!) operator instead. Found: %s',
-                $stackPtr,
-                'FoundTriple',
-                $data
-            );
-
-            if ($fix === true) {
-                $phpcsFile->fixer->beginChangeset();
-
-                $this->removeNotAndTrailingSpaces($phpcsFile, $stackPtr, $lastNot);
-
-                $phpcsFile->fixer->endChangeset();
-            }
-
-            // Only throw one error, even if there are more than two not-operators.
-            return $lastNot;
-        }
-
-        /*
-         * Found a double negative, which should be a boolean cast.
-         */
-
-        $fixable = true;
-
-        /*
-         * If whatever is being "cast" is within parentheses, we're good.
-         * If not, we need to prevent creating a change in behaviour
-         * when what follows is an `$x instanceof ...` expression, as
-         * the "instanceof" operator is right between a boolean cast
-         * and the ! operator precedence-wise.
-         *
-         * Note: this only applies to double negative, not triple negative.
-         *
-         * @link https://www.php.net/language.operators.precedence
-         */
-        if ($tokens[$afterNot]['code'] !== \T_OPEN_PARENTHESIS) {
-            $end = Parentheses::getLastCloser($phpcsFile, $stackPtr);
-            if ($end === false) {
-                $end = BCFile::findEndOfStatement($phpcsFile, $stackPtr);
-            }
-
-            for ($nextRelevant = $afterNot; $nextRelevant < $end; $nextRelevant++) {
-                if (isset(Tokens::$emptyTokens[$tokens[$nextRelevant]['code']])) {
-                    continue;
-                }
-
-                if ($tokens[$nextRelevant]['code'] === \T_INSTANCEOF) {
-                    $fixable = false;
-                    break;
-                }
-
-                if (isset($this->operatorsWithLowerPrecedence[$tokens[$nextRelevant]['code']])) {
-                    // The expression the `!` belongs to has ended.
-                    break;
-                }
-
-                // Skip over anything within some form of brackets.
-                if (isset($tokens[$nextRelevant]['scope_closer'])
-                    && ($nextRelevant === $tokens[$nextRelevant]['scope_opener']
-                    || $nextRelevant === $tokens[$nextRelevant]['scope_condition'])
-                ) {
-                    $nextRelevant = $tokens[$nextRelevant]['scope_closer'];
-                    continue;
-                }
-
-                if (isset($tokens[$nextRelevant]['bracket_opener'], $tokens[$nextRelevant]['bracket_closer'])
-                    && $nextRelevant === $tokens[$nextRelevant]['bracket_opener']
-                ) {
-                    $nextRelevant = $tokens[$nextRelevant]['bracket_closer'];
-                    continue;
-                }
-
-                if ($tokens[$nextRelevant]['code'] === \T_OPEN_PARENTHESIS
-                    && isset($tokens[$nextRelevant]['parenthesis_closer'])
-                ) {
-                    $nextRelevant = $tokens[$nextRelevant]['parenthesis_closer'];
-                    continue;
-                }
-
-                // Skip over attributes (just in case).
-                if ($tokens[$nextRelevant]['code'] === \T_ATTRIBUTE
-                    && isset($tokens[$nextRelevant]['attribute_closer'])
-                ) {
-                    $nextRelevant = $tokens[$nextRelevant]['attribute_closer'];
-                    continue;
-                }
-            }
-        }
-
-        $error = 'Double negative detected. Use a (bool) cast %s instead. Found: %s';
-        $code  = 'FoundDouble';
-        $data  = [
-            '',
-            $found,
-        ];
-
-        if ($fixable === false) {
-            $code    = 'FoundDoubleWithInstanceof';
-            $data[0] = 'and parentheses around the instanceof expression';
-
-            // Don't auto-fix in combination with instanceof.
-            $phpcsFile->addError($error, $stackPtr, $code, $data);
-
-            // Only throw one error, even if there are more than two not-operators.
-            return $lastNot;
-        }
-
-        $fix = $phpcsFile->addFixableError($error, $stackPtr, $code, $data);
-
-        if ($fix === true) {
-            $phpcsFile->fixer->beginChangeset();
-
-            $this->removeNotAndTrailingSpaces($phpcsFile, $stackPtr, $lastNot);
-
-            $phpcsFile->fixer->replaceToken($lastNot, '(bool)');
-
-            $phpcsFile->fixer->endChangeset();
-        }
-
-        // Only throw one error, even if there are more than two not-operators.
-        return $lastNot;
-    }
-
-    /**
-     * Remove boolean not-operators and trailing whitespace after those,
-     * but don't remove comments or trailing whitespace after comments.
-     *
-     * @since 1.2.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
-     * @param int                         $stackPtr  The position of the current token
-     *                                               in the stack passed in $tokens.
-     * @param int                         $lastNot   The position of the last boolean not token
-     *                                               in the chain.
-     *
-     * @return void
-     */
-    private function removeNotAndTrailingSpaces(File $phpcsFile, $stackPtr, $lastNot)
-    {
-        $tokens = $phpcsFile->getTokens();
-        $ignore = false;
-
-        for ($i = $stackPtr; $i < $lastNot; $i++) {
-            if (isset(Tokens::$commentTokens[$tokens[$i]['code']])) {
-                // Ignore comments and whitespace after comments.
-                $ignore = true;
-                continue;
-            }
-
-            if ($tokens[$i]['code'] === \T_WHITESPACE && $ignore === false) {
-                $phpcsFile->fixer->replaceToken($i, '');
-                continue;
-            }
-
-            if ($tokens[$i]['code'] === \T_BOOLEAN_NOT) {
-                $ignore = false;
-                $phpcsFile->fixer->replaceToken($i, '');
-            }
-        }
-    }
-}