sdc-build-wp 4.1.0 → 4.1.2

package/vendor/phpcsstandards/phpcsextra/Universal/Sniffs/UseStatements/DisallowUseFunctionSniff.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 function import `use` statements.
- *
- * Related sniffs:
- * - `Universal.UseStatements.DisallowUseClass`
- * - `Universal.UseStatements.DisallowUseConst`
- *
- * @since 1.0.0
- */
-final class DisallowUseFunctionSniff implements Sniff
-{
-
-    /**
-     * Name of the "Use import source" metric.
-     *
-     * @since 1.0.0
-     *
-     * @var string
-     */
-    const METRIC_NAME_SRC = 'Use import statement source for functions';
-
-    /**
-     * Name of the "Use import with/without alias" metric.
-     *
-     * @since 1.0.0
-     *
-     * @var string
-     */
-    const METRIC_NAME_ALIAS = 'Use import statement for functions';
-
-    /**
-     * 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['function'])) {
-            // No import statements for functions found.
-            return;
-        }
-
-        $endOfStatement = $phpcsFile->findNext([\T_SEMICOLON, \T_CLOSE_TAG], ($stackPtr + 1));
-
-        foreach ($statements['function'] 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 functions%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/KeywordSpacingSniff.php

@@ -1,207 +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\UseStatements;
-
-use PHP_CodeSniffer\Files\File;
-use PHP_CodeSniffer\Sniffs\Sniff;
-use PHP_CodeSniffer\Util\Tokens;
-use PHPCSUtils\Fixers\SpacesFixer;
-use PHPCSUtils\Utils\UseStatements;
-
-/**
- * Enforce a single space after the keywords in import `use` statements.
- *
- * The keywords this sniff check are `use`, `function`, `const` and `as`.
- * For `as`, the space *before* the keyword is also checked to be a single space.
- *
- * @since 1.1.0
- */
-final class KeywordSpacingSniff implements Sniff
-{
-
-    /**
-     * Name of the metric for spacing before.
-     *
-     * @since 1.1.0
-     *
-     * @var string
-     */
-    const METRIC_NAME_BEFORE = 'Space before "%s" keyword in import use statement';
-
-    /**
-     * Name of the metric for spacing after.
-     *
-     * @since 1.1.0
-     *
-     * @var string
-     */
-    const METRIC_NAME_AFTER = 'Space after "%s" keyword in import use statement';
-
-    /**
-     * A list of keywords that are tokenized as `T_STRING` in import `use` statements.
-     *
-     * @since 1.1.0
-     *
-     * @var array<string, true>
-     */
-    protected $keywords = [
-        'const'    => true,
-        'function' => true,
-    ];
-
-    /**
-     * Returns an array of tokens this sniff 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) {
-            // Trait or closure use statement.
-            return;
-        }
-
-        $tokens         = $phpcsFile->getTokens();
-        $endOfStatement = $phpcsFile->findNext([\T_SEMICOLON, \T_CLOSE_TAG], ($stackPtr + 1));
-        if ($endOfStatement === false) {
-            // Live coding or parse error.
-            return;
-        }
-
-        // Check the spacing after the `use` keyword.
-        $this->checkSpacingAfterKeyword($phpcsFile, $stackPtr, $tokens[$stackPtr]['content']);
-
-        // Check the spacing before and after each `as` keyword.
-        $current = $stackPtr;
-        do {
-            $current = $phpcsFile->findNext(\T_AS, ($current + 1), $endOfStatement);
-            if ($current === false) {
-                break;
-            }
-
-            // Prevent false positives when "as" is used within a "name".
-            if (isset(Tokens::$emptyTokens[$tokens[($current - 1)]['code']]) === true) {
-                $this->checkSpacingBeforeKeyword($phpcsFile, $current, $tokens[$current]['content']);
-                $this->checkSpacingAfterKeyword($phpcsFile, $current, $tokens[$current]['content']);
-            }
-        } while (true);
-
-        /*
-         * Check the spacing after `function` and `const` keywords.
-         */
-        $nextNonEmpty = $phpcsFile->findNext(Tokens::$emptyTokens, ($stackPtr + 1), null, true);
-        if (isset($this->keywords[\strtolower($tokens[$nextNonEmpty]['content'])]) === true) {
-            // Keyword found at start of statement, applies to whole statement.
-            $this->checkSpacingAfterKeyword($phpcsFile, $nextNonEmpty, $tokens[$nextNonEmpty]['content']);
-            return;
-        }
-
-        // This may still be a group use statement with function/const substatements.
-        $openGroup = $phpcsFile->findNext(\T_OPEN_USE_GROUP, ($stackPtr + 1), $endOfStatement);
-        if ($openGroup === false) {
-            // Not a group use statement.
-            return;
-        }
-
-        $closeGroup = $phpcsFile->findNext(\T_CLOSE_USE_GROUP, ($openGroup + 1), $endOfStatement);
-
-        $current = $openGroup;
-        do {
-            $current = $phpcsFile->findNext(Tokens::$emptyTokens, ($current + 1), $closeGroup, true);
-            if ($current === false) {
-                return;
-            }
-
-            if (isset($this->keywords[\strtolower($tokens[$current]['content'])]) === true) {
-                $this->checkSpacingAfterKeyword($phpcsFile, $current, $tokens[$current]['content']);
-            }
-
-            // We're within the use group, so find the next comma.
-            $current = $phpcsFile->findNext(\T_COMMA, ($current + 1), $closeGroup);
-        } while ($current !== false);
-    }
-
-    /**
-     * Check the spacing before a found keyword.
-     *
-     * @since 1.1.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
-     * @param int                         $stackPtr  The position of the keyword in the token stack.
-     * @param string                      $content   The keyword as found.
-     *
-     * @return void
-     */
-    public function checkSpacingBeforeKeyword(File $phpcsFile, $stackPtr, $content)
-    {
-        $contentLC    = \strtolower($content);
-        $prevNonEmpty = $phpcsFile->findPrevious(Tokens::$emptyTokens, ($stackPtr - 1), null, true);
-
-        SpacesFixer::checkAndFix(
-            $phpcsFile,
-            $stackPtr,
-            $prevNonEmpty,
-            1, // Expected spaces.
-            'Expected %s before the "' . $contentLC . '" keyword. Found: %s',
-            'SpaceBefore' . \ucfirst($contentLC),
-            'error',
-            0, // Severity.
-            \sprintf(self::METRIC_NAME_BEFORE, $contentLC)
-        );
-    }
-
-    /**
-     * Check the spacing after a found keyword.
-     *
-     * @since 1.1.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
-     * @param int                         $stackPtr  The position of the keyword in the token stack.
-     * @param string                      $content   The keyword as found.
-     *
-     * @return void
-     */
-    public function checkSpacingAfterKeyword(File $phpcsFile, $stackPtr, $content)
-    {
-        $contentLC    = \strtolower($content);
-        $nextNonEmpty = $phpcsFile->findNext(Tokens::$emptyTokens, ($stackPtr + 1), null, true);
-
-        SpacesFixer::checkAndFix(
-            $phpcsFile,
-            $stackPtr,
-            $nextNonEmpty,
-            1, // Expected spaces.
-            'Expected %s after the "' . $contentLC . '" keyword. Found: %s',
-            'SpaceAfter' . \ucfirst($contentLC),
-            'error',
-            0, // Severity.
-            \sprintf(self::METRIC_NAME_AFTER, $contentLC)
-        );
-    }
-}

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

@@ -1,156 +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\UseStatements;
-
-/**
- * Verify that the `function` and `const` keyword in import `use` statements are lowercase.
- *
- * Companion sniff to the upstream `Generic.PHP.LowerCaseKeyword` sniff which doesn't cover
- * these keywords as they are not tokenized as `T_FUNCTION`/`T_CONST`, but as `T_STRING`.
- *
- * @since 1.0.0
- */
-final class LowercaseFunctionConstSniff implements Sniff
-{
-
-    /**
-     * Name of the metric.
-     *
-     * @since 1.0.0
-     *
-     * @var string
-     */
-    const METRIC_NAME = 'Import use statement %s keyword case';
-
-    /**
-     * A list of keywords that can follow use statements.
-     *
-     * @since 1.0.0
-     *
-     * @var array<string, true>
-     */
-    protected $keywords = [
-        'const'    => true,
-        'function' => true,
-    ];
-
-    /**
-     * 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];
-    }
-
-    /**
-     * 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 (UseStatements::isImportUse($phpcsFile, $stackPtr) === false) {
-            // Trait or closure use statement.
-            return;
-        }
-
-        $tokens       = $phpcsFile->getTokens();
-        $nextNonEmpty = $phpcsFile->findNext(Tokens::$emptyTokens, ($stackPtr + 1), null, true);
-        if ($nextNonEmpty === false) {
-            // Live coding or parse error.
-            return;
-        }
-
-        if (isset($this->keywords[\strtolower($tokens[$nextNonEmpty]['content'])]) === true) {
-            // Keyword found at start of statement, applies to whole statement.
-            $this->processKeyword($phpcsFile, $nextNonEmpty, $tokens[$nextNonEmpty]['content']);
-            return;
-        }
-
-        // This may still be a group use statement with function/const substatements.
-        $openGroup = $phpcsFile->findNext([\T_SEMICOLON, \T_CLOSE_TAG, \T_OPEN_USE_GROUP], ($stackPtr + 1));
-        if ($openGroup === false || $tokens[$openGroup]['code'] !== \T_OPEN_USE_GROUP) {
-            // Not a group use statement.
-            return;
-        }
-
-        $closeGroup = $phpcsFile->findNext([\T_SEMICOLON, \T_CLOSE_TAG, \T_CLOSE_USE_GROUP], ($openGroup + 1));
-        if ($closeGroup === false || $tokens[$closeGroup]['code'] !== \T_CLOSE_USE_GROUP) {
-            // Live coding or parse error.
-            return;
-        }
-
-        $current = $openGroup;
-        do {
-            $current = $phpcsFile->findNext(Tokens::$emptyTokens, ($current + 1), $closeGroup, true);
-            if ($current === false) {
-                return;
-            }
-
-            if (isset($this->keywords[\strtolower($tokens[$current]['content'])]) === true) {
-                $this->processKeyword($phpcsFile, $current, $tokens[$current]['content']);
-            }
-
-            // We're within the use group, so find the next comma.
-            $current = $phpcsFile->findNext(\T_COMMA, ($current + 1), $closeGroup);
-        } while ($current !== false);
-    }
-
-    /**
-     * Processes a found keyword.
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
-     * @param int                         $stackPtr  The position of the keyword in the token stack.
-     * @param string                      $content   The keyword as found.
-     *
-     * @return void
-     */
-    public function processKeyword(File $phpcsFile, $stackPtr, $content)
-    {
-        $contentLC  = \strtolower($content);
-        $metricName = \sprintf(self::METRIC_NAME, $contentLC);
-        if ($contentLC === $content) {
-            // Already lowercase. Bow out.
-            $phpcsFile->recordMetric($stackPtr, $metricName, 'lowercase');
-            return;
-        }
-
-        if (\strtoupper($content) === $content) {
-            $phpcsFile->recordMetric($stackPtr, $metricName, 'uppercase');
-        } else {
-            $phpcsFile->recordMetric($stackPtr, $metricName, 'mixed case');
-        }
-
-        $error = 'The "%s" keyword when used in an import use statements must be lowercase.';
-        $fix   = $phpcsFile->addFixableError($error, $stackPtr, 'NotLowercase', [$contentLC]);
-
-        if ($fix === true) {
-            $phpcsFile->fixer->replaceToken($stackPtr, $contentLC);
-        }
-    }
-}