sdc-build-wp 4.1.0 → 4.1.2

package/vendor/phpcsstandards/phpcsextra/Universal/Sniffs/OOStructures/AlphabeticExtendsImplementsSniff.php

@@ -1,275 +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\OOStructures;
-
-use PHP_CodeSniffer\Files\File;
-use PHP_CodeSniffer\Sniffs\Sniff;
-use PHP_CodeSniffer\Util\Tokens;
-use PHPCSUtils\Tokens\Collections;
-use PHPCSUtils\Utils\ObjectDeclarations;
-
-/**
- * Verifies that the interface names used in a class/enum "implements" statement or an interface "extends" statement,
- * are listed in alphabetic order.
- *
- * @since 1.0.0
- */
-final class AlphabeticExtendsImplementsSniff implements Sniff
-{
-
-    /**
-     * Name of the "Alphabetically ordered" metric.
-     *
-     * @since 1.0.0
-     *
-     * @var string
-     */
-    const METRIC_NAME_ALPHA = 'Interface names in implements/extends ordered alphabetically (%s)';
-
-    /**
-     * Name of the "interface count" metric.
-     *
-     * @since 1.0.0
-     *
-     * @var string
-     */
-    const METRIC_NAME_COUNT = 'Number of interfaces being implemented/extended';
-
-    /**
-     * The sort order to use for the statement.
-     *
-     * If all names used are unqualified, the sort order won't make a difference.
-     * However, if one or more of the names are partially or fully qualified, the chosen
-     * sort order will determine how the sorting between unqualified, partially and
-     * fully qualified names is handled.
-     *
-     * The sniff supports two sort order options:
-     * - 'name' : sort by the interface name only (default);
-     * - 'full' : sort by the full name as used in the statement (without leading backslash).
-     *
-     * In both cases, the sorting will be done using natural sort, case-insensitive.
-     *
-     * Example:
-     * <code>
-     *   class Foo implements \Vendor\DiffIterator, My\Count, DateTimeInterface {}
-     * </code>
-     *
-     * If sorted using the "name" sort-order, the sniff looks just at the interface name, i.e.
-     * `DiffIterator`, `Count` and `DateTimeInterface`, which for this example would mean
-     * the correct order would be `My\Count, DateTimeInterface, \Vendor\DiffIterator`.
-     *
-     * If sorted using the "full" sort-order, the sniff will look at the full name as used
-     * in the `implements` statement, without leading backslashes.
-     * For the example above, this would mean that the correct order would be:
-     * `DateTimeInterface, My\Count, \Vendor\DiffIterator`.
-     *
-     * @since 1.0.0
-     *
-     * @var string
-     */
-    public $orderby = 'name';
-
-    /**
-     * Returns an array of tokens this test wants to listen for.
-     *
-     * @since 1.0.0
-     *
-     * @return array<int|string>
-     */
-    public function register()
-    {
-        return (Collections::ooCanExtend() + Collections::ooCanImplement());
-    }
-
-    /**
-     * 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)
-    {
-        /*
-         * Validate the setting.
-         */
-        if ($this->orderby !== 'full') {
-            // Use the default.
-            $this->orderby = 'name';
-        }
-        $metricNameAlpha = \sprintf(self::METRIC_NAME_ALPHA, $this->orderby);
-
-        $tokens = $phpcsFile->getTokens();
-        if (isset($tokens[$stackPtr]['scope_opener']) === false) {
-            // Parse error or live coding. Ignore.
-            return;
-        }
-
-        $scopeOpener = $tokens[$stackPtr]['scope_opener'];
-
-        /*
-         * Get the names.
-         */
-        if (isset(Collections::ooCanImplement()[$tokens[$stackPtr]['code']]) === true) {
-            $names = ObjectDeclarations::findImplementedInterfaceNames($phpcsFile, $stackPtr);
-        } else {
-            $names = ObjectDeclarations::findExtendedInterfaceNames($phpcsFile, $stackPtr);
-        }
-
-        if (\is_array($names) === false) {
-            // Class/interface/enum doesn't extend or implement.
-            $phpcsFile->recordMetric($stackPtr, self::METRIC_NAME_COUNT, 0);
-            $phpcsFile->recordMetric($stackPtr, $metricNameAlpha, 'n/a');
-            return;
-        }
-
-        $count = \count($names);
-        $phpcsFile->recordMetric($stackPtr, self::METRIC_NAME_COUNT, $count);
-
-        if ($count < 2) {
-            // Nothing to sort.
-            $phpcsFile->recordMetric($stackPtr, $metricNameAlpha, 'n/a');
-            return;
-        }
-
-        /*
-         * Check the order.
-         */
-        if ($this->orderby === 'name') {
-            $sorted = $this->sortByName($names);
-        } else {
-            $sorted = $this->sortByFull($names);
-        }
-
-        if ($sorted === $names) {
-            // Order is already correct.
-            $phpcsFile->recordMetric($stackPtr, $metricNameAlpha, 'yes');
-            return;
-        }
-
-        $phpcsFile->recordMetric($stackPtr, $metricNameAlpha, 'no');
-
-        /*
-         * Throw the error.
-         */
-        $keyword = \T_IMPLEMENTS;
-        if (isset(Collections::ooCanImplement()[$tokens[$stackPtr]['code']]) === false) {
-            $keyword = \T_EXTENDS;
-        }
-
-        $fixable    = true;
-        $keywordPtr = $phpcsFile->findNext($keyword, ($stackPtr + 1), $scopeOpener);
-        $hasComment = $phpcsFile->findNext(Tokens::$commentTokens, ($keywordPtr + 1), $scopeOpener);
-        if ($hasComment !== false) {
-            $fixable = false;
-        }
-
-        $error  = "The interface names in a \"%s %s\" statement should be ordered alphabetically.\n";
-        $error .= 'Expected: %s; Found: %s';
-        $code   = \ucfirst(\strtolower($tokens[$keywordPtr]['content'])) . 'WrongOrder';
-        $data   = [
-            $tokens[$stackPtr]['content'],
-            $tokens[$keywordPtr]['content'],
-            \implode(', ', $names),
-            \implode(', ', $sorted),
-        ];
-
-        if ($fixable === false) {
-            $code .= 'WithComments';
-            $phpcsFile->addError($error, $keywordPtr, $code, $data);
-            return;
-        }
-
-        // OK, so we appear to have a fixable error.
-        $fix = $phpcsFile->addFixableError($error, $keywordPtr, $code, $data);
-        if ($fix === false) {
-            return;
-        }
-
-        $phpcsFile->fixer->beginChangeset();
-
-        // Remove the complete previous extends/implements part.
-        for ($i = ($keywordPtr + 1); $i < $scopeOpener; $i++) {
-            $phpcsFile->fixer->replaceToken($i, '');
-        }
-
-        $phpcsFile->fixer->addContent($keywordPtr, ' ' . \implode(', ', $sorted) . ' ');
-
-        $phpcsFile->fixer->endChangeset();
-    }
-
-    /**
-     * Sort an array of potentially mixed qualified and unqualified names by the interface name.
-     *
-     * @since 1.0.0
-     *
-     * @param string[] $names Interface names, potentially mixed qualified and unqualified.
-     *
-     * @return string[]
-     */
-    protected function sortByName(array $names)
-    {
-        $getLastName = function ($name) {
-            $last = \strrchr($name, '\\');
-            if ($last === false) {
-                $last = $name;
-            } else {
-                $last = \substr($last, 1);
-            }
-
-            return $last;
-        };
-
-        return $this->sortNames($names, $getLastName);
-    }
-
-    /**
-     * Sort an array of potentially mixed qualified and unqualified names by the full name.
-     *
-     * @since 1.0.0
-     *
-     * @param string[] $names Interface names, potentially mixed qualified and unqualified.
-     *
-     * @return string[]
-     */
-    protected function sortByFull(array $names)
-    {
-        $trimLeadingBackslash = function ($name) {
-            return \ltrim($name, '\\');
-        };
-
-        return $this->sortNames($names, $trimLeadingBackslash);
-    }
-
-    /**
-     * Sort an array of names.
-     *
-     * @since 1.0.0
-     *
-     * @param string[] $names        Interface names, potentially mixed qualified and unqualified.
-     * @param callable $prepareNames Function to call to prepare the names before sorting.
-     *
-     * @return string[]
-     */
-    private function sortNames(array $names, callable $prepareNames)
-    {
-        $preppedNames = \array_map($prepareNames, $names);
-        $names        = \array_combine($names, $preppedNames);
-
-        \natcasesort($names);
-
-        return \array_keys($names);
-    }
-}

package/vendor/phpcsstandards/phpcsextra/Universal/Sniffs/Operators/ConcatPositionSniff.php

@@ -1,204 +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\Operators;
-
-use PHP_CodeSniffer\Files\File;
-use PHP_CodeSniffer\Sniffs\Sniff;
-use PHP_CodeSniffer\Util\Tokens;
-
-/**
- * Enforces that the concatenation operator in multi-line concatenations is in a preferred position,
- * either always at the start of the next line or always at the end of the previous line.
- *
- * Note: this sniff has no opinion on spacing before/after the concatenation operator.
- * It will normalize based on the "one space before/after" PSR-12 industry standard.
- * If different spacing is preferred, use the `Squiz.Strings.ConcatenationSpacing` to enforce/correct that.
- *
- * @since 1.2.0
- */
-final class ConcatPositionSniff implements Sniff
-{
-
-    /**
-     * The phrase to use for the metric recorded by this sniff.
-     *
-     * @since 1.2.0
-     *
-     * @var string
-     */
-    const METRIC_NAME = 'Multi-line concatenation operator position';
-
-    /**
-     * Position indication: start of next line.
-     *
-     * @since 1.2.0
-     *
-     * @var string
-     */
-    const POSITION_START = 'start';
-
-    /**
-     * Position indication: end of previous line.
-     *
-     * @since 1.2.0
-     *
-     * @var string
-     */
-    const POSITION_END = 'end';
-
-    /**
-     * Position indication: neither start of next line nor end of previous line.
-     *
-     * @since 1.2.0
-     *
-     * @var string
-     */
-    const POSITION_STANDALONE = 'stand-alone';
-
-    /**
-     * Preferred position for the concatenation operator.
-     *
-     * Valid values are: 'start' and 'end'.
-     * Defaults to 'start'.
-     *
-     * @since 1.2.0
-     *
-     * @var string
-     */
-    public $allowOnly = self::POSITION_START;
-
-    /**
-     * Returns an array of tokens this test wants to listen for.
-     *
-     * @since 1.2.0
-     *
-     * @return array<int|string>
-     */
-    public function register()
-    {
-        return [\T_STRING_CONCAT];
-    }
-
-    /**
-     * 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)
-    {
-        /*
-         * Validate the setting.
-         */
-        if ($this->allowOnly !== self::POSITION_END) {
-            // Use the default.
-            $this->allowOnly = self::POSITION_START;
-        }
-
-        $prevNonEmpty = $phpcsFile->findPrevious(Tokens::$emptyTokens, ($stackPtr - 1), null, true);
-        $nextNonEmpty = $phpcsFile->findNext(Tokens::$emptyTokens, ($stackPtr + 1), null, true);
-
-        if ($nextNonEmpty === false) {
-            // Parse error/live coding.
-            return;
-        }
-
-        $tokens = $phpcsFile->getTokens();
-        if ($tokens[$prevNonEmpty]['line'] === $tokens[$nextNonEmpty]['line']) {
-            // Not multi-line concatenation. Not our target.
-            return;
-        }
-
-        $position = self::POSITION_STANDALONE;
-        if ($tokens[$prevNonEmpty]['line'] === $tokens[$stackPtr]['line']) {
-            $position = self::POSITION_END;
-        } elseif ($tokens[$nextNonEmpty]['line'] === $tokens[$stackPtr]['line']) {
-            $position = self::POSITION_START;
-        }
-
-        // Record metric.
-        $phpcsFile->recordMetric($stackPtr, self::METRIC_NAME, $position);
-
-        if ($this->allowOnly === $position) {
-            // All okay.
-            return;
-        }
-
-        $fix = $phpcsFile->addFixableError(
-            'The concatenation operator for multi-line concatenations should always be at the %s of a line.',
-            $stackPtr,
-            'Incorrect',
-            [$this->allowOnly]
-        );
-
-        if ($fix === true) {
-            if ($this->allowOnly === self::POSITION_END) {
-                $phpcsFile->fixer->beginChangeset();
-
-                // Move the concat operator.
-                $phpcsFile->fixer->replaceToken($stackPtr, '');
-                $phpcsFile->fixer->addContent($prevNonEmpty, ' .');
-
-                if ($position === self::POSITION_START
-                    && $tokens[($stackPtr + 1)]['code'] === \T_WHITESPACE
-                ) {
-                    // Remove trailing space.
-                    $phpcsFile->fixer->replaceToken(($stackPtr + 1), '');
-                } elseif ($position === self::POSITION_STANDALONE) {
-                    // Remove potential indentation space.
-                    if ($tokens[($stackPtr - 1)]['code'] === \T_WHITESPACE) {
-                        $phpcsFile->fixer->replaceToken(($stackPtr - 1), '');
-                    }
-
-                    // Remove new line.
-                    if ($tokens[($stackPtr + 1)]['code'] === \T_WHITESPACE) {
-                        $phpcsFile->fixer->replaceToken(($stackPtr + 1), '');
-                    }
-                }
-
-                $phpcsFile->fixer->endChangeset();
-                return;
-            }
-
-            // Fixer for allowOnly === self::POSITION_START.
-            $phpcsFile->fixer->beginChangeset();
-
-            // Move the concat operator.
-            $phpcsFile->fixer->replaceToken($stackPtr, '');
-            $phpcsFile->fixer->addContentBefore($nextNonEmpty, '. ');
-
-            if ($position === self::POSITION_END
-                && $tokens[($stackPtr - 1)]['code'] === \T_WHITESPACE
-            ) {
-                // Remove trailing space.
-                $phpcsFile->fixer->replaceToken(($stackPtr - 1), '');
-            } elseif ($position === self::POSITION_STANDALONE) {
-                // Remove potential indentation space.
-                if ($tokens[($stackPtr - 1)]['code'] === \T_WHITESPACE) {
-                    $phpcsFile->fixer->replaceToken(($stackPtr - 1), '');
-                }
-
-                // Remove new line.
-                if ($tokens[($stackPtr + 1)]['code'] === \T_WHITESPACE) {
-                    $phpcsFile->fixer->replaceToken(($stackPtr + 1), '');
-                }
-            }
-
-            $phpcsFile->fixer->endChangeset();
-        }
-    }
-}

package/vendor/phpcsstandards/phpcsextra/Universal/Sniffs/Operators/DisallowLogicalAndOrSniff.php

@@ -1,112 +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\Operators;
-
-use PHP_CodeSniffer\Files\File;
-use PHP_CodeSniffer\Sniffs\Sniff;
-
-/**
- * Enforce the use of the boolean `&&` and `||` operators instead of the logical `and`/`or` operators.
- *
- * Note: as the {@link https://www.php.net/manual/en/language.operators.precedence.php operator precedence}
- * of the logical operators is significantly lower than the operator precedence of boolean operators,
- * this sniff does not contain an auto-fixer.
- *
- * @since 1.0.0
- */
-final class DisallowLogicalAndOrSniff implements Sniff
-{
-
-    /**
-     * Name of the metric.
-     *
-     * @since 1.0.0
-     *
-     * @var string
-     */
-    const METRIC_NAME = 'Type of and/or operator used';
-
-    /**
-     * The tokens this sniff records metrics for.
-     *
-     * @since 1.0.0
-     *
-     * @var array<int|string, string>
-     */
-    private $metricType = [
-        \T_LOGICAL_AND => 'logical (and/or)',
-        \T_LOGICAL_OR  => 'logical (and/or)',
-        \T_BOOLEAN_AND => 'boolean (&&/||)',
-        \T_BOOLEAN_OR  => 'boolean (&&/||)',
-    ];
-
-    /**
-     * The tokens this sniff targets with error code and replacements.
-     *
-     * @since 1.0.0
-     *
-     * @var array<int|string, array<string, string>>
-     */
-    private $targetTokenInfo = [
-        \T_LOGICAL_AND => [
-            'error_code'  => 'LogicalAnd',
-            'replacement' => '&&',
-        ],
-        \T_LOGICAL_OR  => [
-            'error_code'  => 'LogicalOr',
-            'replacement' => '||',
-        ],
-    ];
-
-    /**
-     * Returns an array of tokens this test wants to listen for.
-     *
-     * @since 1.0.0
-     *
-     * @return array<int|string>
-     */
-    public function register()
-    {
-        return \array_keys($this->metricType);
-    }
-
-    /**
-     * 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();
-        $tokenCode = $tokens[$stackPtr]['code'];
-
-        $phpcsFile->recordMetric($stackPtr, self::METRIC_NAME, $this->metricType[$tokenCode]);
-
-        if (isset($this->targetTokenInfo[$tokenCode]) === false) {
-            // Already using boolean operator.
-            return;
-        }
-
-        $error = 'Using logical operators is not allowed. Expected: "%s"; Found: "%s"';
-        $data  = [
-            $this->targetTokenInfo[$tokenCode]['replacement'],
-            $tokens[ $stackPtr ]['content'],
-        ];
-
-        $phpcsFile->addError($error, $stackPtr, $this->targetTokenInfo[$tokenCode]['error_code'], $data);
-    }
-}

package/vendor/phpcsstandards/phpcsextra/Universal/Sniffs/Operators/DisallowShortTernarySniff.php

@@ -1,76 +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\Operators;
-
-use PHP_CodeSniffer\Files\File;
-use PHP_CodeSniffer\Sniffs\Sniff;
-use PHPCSUtils\Utils\Operators;
-
-/**
- * Disallow the use of short ternaries.
- *
- * While short ternaries are useful when used correctly, the principle of them is
- * often misunderstood and they are more often than not used incorrectly, leading to
- * hard to debug issues and/or PHP warnings/notices.
- *
- * @since 1.0.0
- */
-final class DisallowShortTernarySniff implements Sniff
-{
-
-    /**
-     * Name of the metric.
-     *
-     * @since 1.0.0
-     *
-     * @var string
-     */
-    const METRIC_NAME = 'Ternary usage';
-
-    /**
-     * Registers the tokens that this sniff wants to listen for.
-     *
-     * @since 1.0.0
-     *
-     * @return array<int|string>
-     */
-    public function register()
-    {
-        return [\T_INLINE_THEN];
-    }
-
-    /**
-     * 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 (Operators::isShortTernary($phpcsFile, $stackPtr) === false) {
-            $phpcsFile->recordMetric($stackPtr, self::METRIC_NAME, 'long');
-            return;
-        }
-
-        $phpcsFile->recordMetric($stackPtr, self::METRIC_NAME, 'short');
-
-        $phpcsFile->addError(
-            'Using short ternaries is not allowed as they are rarely used correctly',
-            $stackPtr,
-            'Found'
-        );
-    }
-}