sdc-build-wp 4.1.0 → 4.1.2

package/vendor/phpcsstandards/phpcsextra/Universal/Sniffs/UseStatements/DisallowMixedGroupUseSniff.php

@@ -1,248 +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\UseStatements;
-
-use PHP_CodeSniffer\Files\File;
-use PHP_CodeSniffer\Sniffs\Sniff;
-use PHP_CodeSniffer\Util\Tokens;
-use PHPCSUtils\Utils\GetTokensAsString;
-use PHPCSUtils\Utils\UseStatements;
-
-/**
- * Disallow group use statements which combine imports for namespace/OO, functions
- * and/or constants in one statement.
- *
- * Note: the fixer will use a semi-standardized format for group use statements.
- * If there are more specific requirements for the formatting of group use statements,
- * the ruleset configurator should ensure that additional sniffs are included in the
- * ruleset to enforce the required format.
- *
- * @since 1.1.0
- */
-final class DisallowMixedGroupUseSniff implements Sniff
-{
-
-    /**
-     * Name of the "Use import source" metric.
-     *
-     * @since 1.1.0
-     *
-     * @var string
-     */
-    const METRIC_NAME = 'Import use statement type';
-
-    /**
-     * Returns an array of tokens this test wants to listen for.
-     *
-     * @since 1.1.0
-     *
-     * @return array<int|string>
-     */
-    public function register()
-    {
-        return [\T_USE];
-    }
-
-    /**
-     * Processes this test, when one of its tokens is encountered.
-     *
-     * @since 1.1.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 (UseStatements::isImportUse($phpcsFile, $stackPtr) === false) {
-            // Closure or trait use statement. Bow out.
-            return;
-        }
-
-        $useStatements = UseStatements::splitImportUseStatement($phpcsFile, $stackPtr);
-
-        $ooCount       = \count($useStatements['name']);
-        $functionCount = \count($useStatements['function']);
-        $constantCount = \count($useStatements['const']);
-        $totalCount    = $ooCount + $functionCount + $constantCount;
-
-        if ($totalCount === 0) {
-            // There must have been a parse error. Bow out.
-            return;
-        }
-
-        // End of statement will always be found, otherwise the import statement parsing would have failed.
-        $endOfStatement = $phpcsFile->findNext([\T_SEMICOLON, \T_CLOSE_TAG], ($stackPtr + 1));
-        $groupStart     = $phpcsFile->findNext(\T_OPEN_USE_GROUP, ($stackPtr + 1), $endOfStatement);
-
-        if ($groupStart === false) {
-            // Not a group use statement. Just record the metric.
-            if ($totalCount === 1) {
-                $phpcsFile->recordMetric($stackPtr, self::METRIC_NAME, 'single import');
-            } else {
-                $phpcsFile->recordMetric($stackPtr, self::METRIC_NAME, 'multi import');
-            }
-
-            return;
-        }
-
-        if ($totalCount === 1
-            || ($ooCount !== 0 && $functionCount === 0 && $constantCount === 0)
-            || ($ooCount === 0 && $functionCount !== 0 && $constantCount === 0)
-            || ($ooCount === 0 && $functionCount === 0 && $constantCount !== 0)
-        ) {
-            // Not a *mixed* group use statement.
-            $phpcsFile->recordMetric($stackPtr, self::METRIC_NAME, 'group use, single type');
-            return;
-        }
-
-        $phpcsFile->recordMetric($stackPtr, self::METRIC_NAME, 'group use, multi type');
-
-        // Build up the error message.
-        $foundPhrases = [];
-        if ($ooCount > 1) {
-            $foundPhrases[] = \sprintf('%d namespaces/OO names', $ooCount);
-        } elseif ($ooCount === 1) {
-            $foundPhrases[] = \sprintf('%d namespace/OO name', $ooCount);
-        }
-
-        if ($functionCount > 1) {
-            $foundPhrases[] = \sprintf('%d functions', $functionCount);
-        } elseif ($functionCount === 1) {
-            $foundPhrases[] = \sprintf('%d function', $functionCount);
-        }
-
-        if ($constantCount > 1) {
-            $foundPhrases[] = \sprintf('%d constants', $constantCount);
-        } elseif ($constantCount === 1) {
-            $foundPhrases[] = \sprintf('%d constant', $constantCount);
-        }
-
-        if (\count($foundPhrases) === 2) {
-            $found = \implode(' and ', $foundPhrases);
-        } else {
-            $found  = \array_shift($foundPhrases) . ', ';
-            $found .= \implode(' and ', $foundPhrases);
-        }
-
-        $error = 'Group use statements should import one type of construct.'
-            . ' Mixed group use statement found importing %s.';
-        $code  = 'Found';
-        $data  = [$found];
-
-        $hasComment = $phpcsFile->findNext(Tokens::$commentTokens, ($stackPtr + 1), $endOfStatement);
-        if ($hasComment !== false) {
-            // Don't attempt to auto-fix is there are comments or PHPCS annotations in the statement.
-            $phpcsFile->addError($error, $stackPtr, $code, $data);
-            return;
-        }
-
-        $fix = $phpcsFile->addFixableError($error, $stackPtr, $code, $data);
-
-        if ($fix === false) {
-            return;
-        }
-
-        /*
-         * Fix it.
-         *
-         * This fixer complies with the following (arbitrary) requirements:
-         * - It will re-use the original base "group" name, i.e. the part before \{.
-         * - It take take aliases into account, but only when something is aliased to a different name.
-         *   Aliases re-using the original name will be removed.
-         * - The fix will not add a trailing comma after the last group use sub-statement.
-         *   This is a PHP 7.2+ feature.
-         *   If a standard wants to enforce trailing commas, they should use a separate sniff for that.
-         * - If there is only 1 statement of a certain type, the replacement will be a single
-         *   import use statement, not a group use statement.
-         */
-
-        $phpcsFile->fixer->beginChangeset();
-
-        // Ensure that a potential close PHP tag ending the statement is not removed.
-        $tokens     = $phpcsFile->getTokens();
-        $endRemoval = $endOfStatement;
-        if ($tokens[$endOfStatement]['code'] !== \T_SEMICOLON) {
-            $endRemoval = $phpcsFile->findPrevious(Tokens::$emptyTokens, ($endOfStatement - 1), null, true);
-        }
-
-        // Remove old statement with the exception of the `use` keyword.
-        for ($i = ($stackPtr + 1); $i <= $endRemoval; $i++) {
-            $phpcsFile->fixer->replaceToken($i, '');
-        }
-
-        // Build up the new use import statements.
-        $newStatements = [];
-
-        $useIndent    = \str_repeat(' ', ($tokens[$stackPtr]['column'] - 1));
-        $insideIndent = $useIndent . \str_repeat(' ', 4);
-
-        $baseGroupName = GetTokensAsString::noEmpties($phpcsFile, ($stackPtr + 1), ($groupStart - 1));
-
-        foreach ($useStatements as $type => $statements) {
-            $count = \count($statements);
-            if ($count === 0) {
-                continue;
-            }
-
-            $typeName = $type . ' ';
-            if ($type === 'name') {
-                $typeName = '';
-            }
-
-            if ($count === 1) {
-                $fqName = \reset($statements);
-                $alias  = \key($statements);
-
-                $newStatement = 'use ' . $typeName . $fqName;
-
-                $unqualifiedName = \ltrim(\substr($fqName, \strrpos($fqName, '\\')), '\\');
-                if ($unqualifiedName !== $alias) {
-                    $newStatement .= ' as ' . $alias;
-                }
-
-                $newStatement .= ';';
-
-                $newStatements[] = $newStatement;
-                continue;
-            }
-
-            // Multiple statements, add a single-type group use statement.
-            $newStatement = 'use ' . $typeName . $baseGroupName . '{' . $phpcsFile->eolChar;
-
-            foreach ($statements as $alias => $fqName) {
-                $partialName   = \str_replace($baseGroupName, '', $fqName);
-                $newStatement .= $insideIndent . $partialName;
-
-                $unqualifiedName = \ltrim(\substr($partialName, \strrpos($partialName, '\\')), '\\');
-                if ($unqualifiedName !== $alias) {
-                    $newStatement .= ' as ' . $alias;
-                }
-
-                $newStatement .= ',' . $phpcsFile->eolChar;
-            }
-
-            // Remove trailing comma after last statement as that's PHP 7.2+.
-            $newStatement = \rtrim($newStatement, ',' . $phpcsFile->eolChar);
-
-            $newStatement   .= $phpcsFile->eolChar . $useIndent . '};';
-            $newStatements[] = $newStatement;
-        }
-
-        $replacement = \implode($phpcsFile->eolChar . $useIndent, $newStatements);
-
-        $phpcsFile->fixer->replaceToken($stackPtr, $replacement);
-
-        $phpcsFile->fixer->endChangeset();
-    }
-}

package/vendor/phpcsstandards/phpcsextra/Universal/Sniffs/UseStatements/DisallowUseClassSniff.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\UseStatements;
-
-use PHP_CodeSniffer\Exceptions\RuntimeException;
-use PHP_CodeSniffer\Files\File;
-use PHP_CodeSniffer\Sniffs\Sniff;
-use PHP_CodeSniffer\Util\Tokens;
-use PHPCSUtils\Utils\Namespaces;
-use PHPCSUtils\Utils\UseStatements;
-
-/**
- * Disallow class/trait/interface/enum import `use` statements.
- *
- * Related sniffs:
- * - `Universal.UseStatements.DisallowUseFunction`
- * - `Universal.UseStatements.DisallowUseConst`
- *
- * @since 1.0.0
- */
-final class DisallowUseClassSniff implements Sniff
-{
-
-    /**
-     * Name of the "Use import source" metric.
-     *
-     * @since 1.0.0
-     *
-     * @var string
-     */
-    const METRIC_NAME_SRC = 'Use import statement source for class/interface/trait/enum';
-
-    /**
-     * Name of the "Use import with/without alias" metric.
-     *
-     * @since 1.0.0
-     *
-     * @var string
-     */
-    const METRIC_NAME_ALIAS = 'Use import statement for class/interface/trait/enum';
-
-    /**
-     * Keep track of which file is being scanned.
-     *
-     * @since 1.0.0
-     *
-     * @var string
-     */
-    private $currentFile = '';
-
-    /**
-     * Keep track of the current namespace.
-     *
-     * @since 1.0.0
-     *
-     * @var string
-     */
-    private $currentNamespace = '';
-
-    /**
-     * Returns an array of tokens this test wants to listen for.
-     *
-     * @since 1.0.0
-     *
-     * @return array<int|string>
-     */
-    public function register()
-    {
-        return [
-            \T_USE,
-            \T_NAMESPACE,
-        ];
-    }
-
-    /**
-     * 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)
-    {
-        $file = $phpcsFile->getFilename();
-        if ($file !== $this->currentFile) {
-            // Reset the current namespace for each new file.
-            $this->currentFile      = $file;
-            $this->currentNamespace = '';
-        }
-
-        $tokens = $phpcsFile->getTokens();
-
-        // Get the name of the current namespace.
-        if ($tokens[$stackPtr]['code'] === \T_NAMESPACE) {
-            $namespaceName = Namespaces::getDeclaredName($phpcsFile, $stackPtr);
-            if ($namespaceName !== false) {
-                $this->currentNamespace = $namespaceName;
-            }
-
-            return;
-        }
-
-        // Ok, so this is a T_USE token.
-        try {
-            $statements = UseStatements::splitImportUseStatement($phpcsFile, $stackPtr);
-        } catch (RuntimeException $e) {
-            // Not an import use statement. Bow out.
-            return;
-        }
-
-        if (empty($statements['name'])) {
-            // No class/trait/interface/enum import statements found.
-            return;
-        }
-
-        $endOfStatement = $phpcsFile->findNext([\T_SEMICOLON, \T_CLOSE_TAG], ($stackPtr + 1));
-
-        foreach ($statements['name'] as $alias => $fullName) {
-            $reportPtr = $stackPtr;
-            do {
-                $reportPtr = $phpcsFile->findNext(\T_STRING, ($reportPtr + 1), $endOfStatement, false, $alias);
-                if ($reportPtr === false) {
-                    // Shouldn't be possible.
-                    continue 2; // @codeCoverageIgnore
-                }
-
-                $next = $phpcsFile->findNext(Tokens::$emptyTokens, ($reportPtr + 1), $endOfStatement, true);
-                if ($next !== false && $tokens[$next]['code'] === \T_NS_SEPARATOR) {
-                    // Namespace level with same name. Continue searching.
-                    continue;
-                }
-
-                break;
-            } while (true);
-
-            /*
-             * Build the error message and code.
-             *
-             * Check whether this is a non-namespaced (global) import and check whether this is an
-             * import from within the same namespace.
-             *
-             * Takes incorrect use statements with leading backslash into account.
-             * Takes case-INsensitivity of namespaces names into account.
-             *
-             * The "GlobalNamespace" error code takes precedence over the "SameNamespace" error code
-             * in case this is a non-namespaced file.
-             */
-
-            $error     = 'Use import statements for class/interface/trait/enum%s are not allowed.';
-            $error    .= ' Found import statement for: "%s"';
-            $errorCode = 'Found';
-            $data      = [
-                '',
-                $fullName,
-            ];
-
-            $globalNamespace = false;
-            $sameNamespace   = false;
-            if (\strpos($fullName, '\\', 1) === false) {
-                $globalNamespace = true;
-                $errorCode       = 'FromGlobalNamespace';
-                $data[0]         = ' from the global namespace';
-
-                $phpcsFile->recordMetric($reportPtr, self::METRIC_NAME_SRC, 'global namespace');
-            } elseif ($this->currentNamespace !== ''
-                && (\stripos($fullName, $this->currentNamespace . '\\') === 0
-                    || \stripos($fullName, '\\' . $this->currentNamespace . '\\') === 0)
-            ) {
-                $sameNamespace = true;
-                $errorCode     = 'FromSameNamespace';
-                $data[0]       = ' from the same namespace';
-
-                $phpcsFile->recordMetric($reportPtr, self::METRIC_NAME_SRC, 'same namespace');
-            } else {
-                $phpcsFile->recordMetric($reportPtr, self::METRIC_NAME_SRC, 'different namespace');
-            }
-
-            $hasAlias = false;
-            $lastLeaf = \strtolower(\substr($fullName, -(\strlen($alias) + 1)));
-            $aliasLC  = \strtolower($alias);
-            if ($lastLeaf !== $aliasLC && $lastLeaf !== '\\' . $aliasLC) {
-                $hasAlias   = true;
-                $error     .= ' with alias: "%s"';
-                $errorCode .= 'WithAlias';
-                $data[]     = $alias;
-
-                $phpcsFile->recordMetric($reportPtr, self::METRIC_NAME_ALIAS, 'with alias');
-            } else {
-                $phpcsFile->recordMetric($reportPtr, self::METRIC_NAME_ALIAS, 'without alias');
-            }
-
-            if ($errorCode === 'Found') {
-                $errorCode = 'FoundWithoutAlias';
-            }
-
-            $phpcsFile->addError($error, $reportPtr, $errorCode, $data);
-        }
-    }
-}

package/vendor/phpcsstandards/phpcsextra/Universal/Sniffs/UseStatements/DisallowUseConstSniff.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\UseStatements;
-
-use PHP_CodeSniffer\Exceptions\RuntimeException;
-use PHP_CodeSniffer\Files\File;
-use PHP_CodeSniffer\Sniffs\Sniff;
-use PHP_CodeSniffer\Util\Tokens;
-use PHPCSUtils\Utils\Namespaces;
-use PHPCSUtils\Utils\UseStatements;
-
-/**
- * Disallow constant import `use` statements.
- *
- * Related sniffs:
- * - `Universal.UseStatements.DisallowUseClass`
- * - `Universal.UseStatements.DisallowUseFunction`
- *
- * @since 1.0.0
- */
-final class DisallowUseConstSniff implements Sniff
-{
-
-    /**
-     * Name of the "Use import source" metric.
-     *
-     * @since 1.0.0
-     *
-     * @var string
-     */
-    const METRIC_NAME_SRC = 'Use import statement source for constant';
-
-    /**
-     * Name of the "Use import with/without alias" metric.
-     *
-     * @since 1.0.0
-     *
-     * @var string
-     */
-    const METRIC_NAME_ALIAS = 'Use import statement for constant';
-
-    /**
-     * Keep track of which file is being scanned.
-     *
-     * @since 1.0.0
-     *
-     * @var string
-     */
-    private $currentFile = '';
-
-    /**
-     * Keep track of the current namespace.
-     *
-     * @since 1.0.0
-     *
-     * @var string
-     */
-    private $currentNamespace = '';
-
-    /**
-     * Returns an array of tokens this test wants to listen for.
-     *
-     * @since 1.0.0
-     *
-     * @return array<int|string>
-     */
-    public function register()
-    {
-        return [
-            \T_USE,
-            \T_NAMESPACE,
-        ];
-    }
-
-    /**
-     * 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)
-    {
-        $file = $phpcsFile->getFilename();
-        if ($file !== $this->currentFile) {
-            // Reset the current namespace for each new file.
-            $this->currentFile      = $file;
-            $this->currentNamespace = '';
-        }
-
-        $tokens = $phpcsFile->getTokens();
-
-        // Get the name of the current namespace.
-        if ($tokens[$stackPtr]['code'] === \T_NAMESPACE) {
-            $namespaceName = Namespaces::getDeclaredName($phpcsFile, $stackPtr);
-            if ($namespaceName !== false) {
-                $this->currentNamespace = $namespaceName;
-            }
-
-            return;
-        }
-
-        // Ok, so this is a T_USE token.
-        try {
-            $statements = UseStatements::splitImportUseStatement($phpcsFile, $stackPtr);
-        } catch (RuntimeException $e) {
-            // Not an import use statement. Bow out.
-            return;
-        }
-
-        if (empty($statements['const'])) {
-            // No import statements for constants found.
-            return;
-        }
-
-        $endOfStatement = $phpcsFile->findNext([\T_SEMICOLON, \T_CLOSE_TAG], ($stackPtr + 1));
-
-        foreach ($statements['const'] as $alias => $fullName) {
-            $reportPtr = $stackPtr;
-            do {
-                $reportPtr = $phpcsFile->findNext(\T_STRING, ($reportPtr + 1), $endOfStatement, false, $alias);
-                if ($reportPtr === false) {
-                    // Shouldn't be possible.
-                    continue 2; // @codeCoverageIgnore
-                }
-
-                $next = $phpcsFile->findNext(Tokens::$emptyTokens, ($reportPtr + 1), $endOfStatement, true);
-                if ($next !== false && $tokens[$next]['code'] === \T_NS_SEPARATOR) {
-                    // Namespace level with same name. Continue searching.
-                    continue;
-                }
-
-                break;
-            } while (true);
-
-            /*
-             * Build the error message and code.
-             *
-             * Check whether this is a non-namespaced (global) import and check whether this is an
-             * import from within the same namespace.
-             *
-             * Takes incorrect use statements with leading backslash into account.
-             * Takes case-INsensitivity of namespaces names into account.
-             *
-             * The "GlobalNamespace" error code takes precedence over the "SameNamespace" error code
-             * in case this is a non-namespaced file.
-             */
-
-            $error     = 'Use import statements for constants%s are not allowed.';
-            $error    .= ' Found import statement for: "%s"';
-            $errorCode = 'Found';
-            $data      = [
-                '',
-                $fullName,
-            ];
-
-            $globalNamespace = false;
-            $sameNamespace   = false;
-            if (\strpos($fullName, '\\', 1) === false) {
-                $globalNamespace = true;
-                $errorCode       = 'FromGlobalNamespace';
-                $data[0]         = ' from the global namespace';
-
-                $phpcsFile->recordMetric($reportPtr, self::METRIC_NAME_SRC, 'global namespace');
-            } elseif ($this->currentNamespace !== ''
-                && (\stripos($fullName, $this->currentNamespace . '\\') === 0
-                    || \stripos($fullName, '\\' . $this->currentNamespace . '\\') === 0)
-            ) {
-                $sameNamespace = true;
-                $errorCode     = 'FromSameNamespace';
-                $data[0]       = ' from the same namespace';
-
-                $phpcsFile->recordMetric($reportPtr, self::METRIC_NAME_SRC, 'same namespace');
-            } else {
-                $phpcsFile->recordMetric($reportPtr, self::METRIC_NAME_SRC, 'different namespace');
-            }
-
-            $hasAlias = false;
-            $lastLeaf = \strtolower(\substr($fullName, -(\strlen($alias) + 1)));
-            $aliasLC  = \strtolower($alias);
-            if ($lastLeaf !== $aliasLC && $lastLeaf !== '\\' . $aliasLC) {
-                $hasAlias   = true;
-                $error     .= ' with alias: "%s"';
-                $errorCode .= 'WithAlias';
-                $data[]     = $alias;
-
-                $phpcsFile->recordMetric($reportPtr, self::METRIC_NAME_ALIAS, 'with alias');
-            } else {
-                $phpcsFile->recordMetric($reportPtr, self::METRIC_NAME_ALIAS, 'without alias');
-            }
-
-            if ($errorCode === 'Found') {
-                $errorCode = 'FoundWithoutAlias';
-            }
-
-            $phpcsFile->addError($error, $reportPtr, $errorCode, $data);
-        }
-    }
-}