sdc-build-wp 4.1.0 → 4.1.2

package/vendor/phpcsstandards/phpcsextra/Universal/Sniffs/Classes/DisallowAnonClassParenthesesSniff.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\Classes;
-
-use PHP_CodeSniffer\Files\File;
-use PHP_CodeSniffer\Sniffs\Sniff;
-use PHP_CodeSniffer\Util\Tokens;
-
-/**
- * Forbid for an anonymous class declaration/instantiation to have parentheses, except when
- * parameters are being passed.
- *
- * @since 1.0.0
- */
-final class DisallowAnonClassParenthesesSniff implements Sniff
-{
-
-    /**
-     * Name of the metric.
-     *
-     * @since 1.0.0
-     *
-     * @var string
-     */
-    const METRIC_NAME = 'Anon class declaration with parenthesis';
-
-    /**
-     * Returns an array of tokens this test wants to listen for.
-     *
-     * @since 1.0.0
-     *
-     * @return array<int|string>
-     */
-    public function register()
-    {
-        return [\T_ANON_CLASS];
-    }
-
-    /**
-     * 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();
-        $nextNonEmpty = $phpcsFile->findNext(Tokens::$emptyTokens, ($stackPtr + 1), null, true);
-
-        // Note: no need to check for `false` as PHPCS won't retokenize `class` to `T_ANON_CLASS` in that case.
-        if ($tokens[$nextNonEmpty]['code'] !== \T_OPEN_PARENTHESIS) {
-            // No parentheses found.
-            $phpcsFile->recordMetric($stackPtr, self::METRIC_NAME, 'no');
-            return;
-        }
-
-        if (isset($tokens[$nextNonEmpty]['parenthesis_closer']) === false) {
-            /*
-             * Incomplete set of parentheses. Ignore.
-             * Shouldn't be possible as PHPCS won't retokenize `class` to `T_ANON_CLASS` in that case.
-             */
-            // @codeCoverageIgnoreStart
-            $phpcsFile->recordMetric($stackPtr, self::METRIC_NAME, 'yes');
-            return;
-            // @codeCoverageIgnoreEnd
-        }
-
-        $opener    = $nextNonEmpty;
-        $closer    = $tokens[$opener]['parenthesis_closer'];
-        $hasParams = $phpcsFile->findNext(Tokens::$emptyTokens, ($opener + 1), $closer, true);
-        if ($hasParams !== false) {
-            // There is something between the parentheses. Ignore.
-            $phpcsFile->recordMetric($stackPtr, self::METRIC_NAME, 'yes, with parameter(s)');
-            return;
-        }
-
-        $phpcsFile->recordMetric($stackPtr, self::METRIC_NAME, 'yes');
-
-        $fix = $phpcsFile->addFixableError(
-            'Parenthesis not allowed when creating a new anonymous class without passing parameters',
-            $stackPtr,
-            'Found'
-        );
-
-        if ($fix === true) {
-            $phpcsFile->fixer->beginChangeset();
-
-            for ($i = $opener; $i <= $closer; $i++) {
-                if (isset(Tokens::$commentTokens[$tokens[$i]['code']]) === true) {
-                    continue;
-                }
-
-                $phpcsFile->fixer->replaceToken($i, '');
-            }
-
-            $phpcsFile->fixer->endChangeset();
-        }
-    }
-}

package/vendor/phpcsstandards/phpcsextra/Universal/Sniffs/Classes/DisallowFinalClassSniff.php

@@ -1,116 +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\Classes;
-
-use PHP_CodeSniffer\Files\File;
-use PHP_CodeSniffer\Sniffs\Sniff;
-use PHP_CodeSniffer\Util\Tokens;
-use PHPCSUtils\Utils\GetTokensAsString;
-use PHPCSUtils\Utils\ObjectDeclarations;
-
-/**
- * Forbids classes from being declared as "final".
- *
- * @since 1.0.0
- */
-final class DisallowFinalClassSniff implements Sniff
-{
-
-    /**
-     * Name of the metric.
-     *
-     * @since 1.0.0
-     *
-     * @var string
-     */
-    const METRIC_NAME = 'Class is abstract or final ?';
-
-    /**
-     * Returns an array of tokens this test wants to listen for.
-     *
-     * @since 1.0.0
-     *
-     * @return array<int|string>
-     */
-    public function register()
-    {
-        return [\T_CLASS];
-    }
-
-    /**
-     * 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)
-    {
-        $classProp = ObjectDeclarations::getClassProperties($phpcsFile, $stackPtr);
-        if ($classProp['is_final'] === false) {
-            if ($classProp['is_abstract'] === true) {
-                $phpcsFile->recordMetric($stackPtr, self::METRIC_NAME, 'abstract');
-                return;
-            }
-
-            $phpcsFile->recordMetric($stackPtr, self::METRIC_NAME, 'not abstract, not final');
-            return;
-        }
-
-        $phpcsFile->recordMetric($stackPtr, self::METRIC_NAME, 'final');
-
-        $nextNonEmpty = $phpcsFile->findNext(Tokens::$emptyTokens, ($stackPtr + 1), null, true);
-        if ($nextNonEmpty === false) {
-            // Live coding or parse error.
-            return;
-        }
-
-        // No extra safeguards needed, we know the keyword will exist based on the check above.
-        $finalKeyword = $phpcsFile->findPrevious(\T_FINAL, ($stackPtr - 1));
-        $snippetEnd   = $nextNonEmpty;
-        $classCloser  = '';
-
-        $tokens = $phpcsFile->getTokens();
-        if (isset($tokens[$stackPtr]['scope_opener']) === true) {
-            $snippetEnd  = $tokens[$stackPtr]['scope_opener'];
-            $classCloser = '}';
-        }
-
-        $snippet = GetTokensAsString::compact($phpcsFile, $finalKeyword, $snippetEnd, true);
-        $fix     = $phpcsFile->addFixableError(
-            'Declaring a class as final is not allowed. Found: %s%s',
-            $finalKeyword,
-            'FinalClassFound',
-            [$snippet, $classCloser]
-        );
-
-        if ($fix === true) {
-            $phpcsFile->fixer->beginChangeset();
-            $phpcsFile->fixer->replaceToken($finalKeyword, '');
-
-            // Remove redundant whitespace.
-            for ($i = ($finalKeyword + 1); $i < $stackPtr; $i++) {
-                if ($tokens[$i]['code'] === \T_WHITESPACE) {
-                    $phpcsFile->fixer->replaceToken($i, '');
-                    continue;
-                }
-
-                break;
-            }
-
-            $phpcsFile->fixer->endChangeset();
-        }
-    }
-}

package/vendor/phpcsstandards/phpcsextra/Universal/Sniffs/Classes/ModifierKeywordOrderSniff.php

@@ -1,188 +0,0 @@
-<?php
-/**
- * PHPCSExtra, a collection of sniffs and standards for use with PHP_CodeSniffer.
- *
- * @package   PHPCSExtra
- * @copyright 2022 PHPCSExtra Contributors
- * @license   https://opensource.org/licenses/LGPL-3.0 LGPL3
- * @link      https://github.com/PHPCSStandards/PHPCSExtra
- */
-
-namespace PHPCSExtra\Universal\Sniffs\Classes;
-
-use PHP_CodeSniffer\Files\File;
-use PHP_CodeSniffer\Sniffs\Sniff;
-use PHPCSUtils\Utils\ObjectDeclarations;
-
-/**
- * Standardize the modifier keyword order for class declarations.
- *
- * @since 1.0.0
- */
-final class ModifierKeywordOrderSniff implements Sniff
-{
-
-    /**
-     * Name of the metric.
-     *
-     * @since 1.0.0
-     *
-     * @var string
-     */
-    const METRIC_NAME = 'Class modifier keyword order';
-
-    /**
-     * Order preference: abstract/final readonly.
-     *
-     * @since 1.0.0
-     *
-     * @var string
-     */
-    const EXTEND_READONLY = 'extendability readonly';
-
-    /**
-     * Order preference: readonly abstract/final.
-     *
-     * @since 1.0.0
-     *
-     * @var string
-     */
-    const READONLY_EXTEND = 'readonly extendability';
-
-    /**
-     * Preferred order for the modifier keywords.
-     *
-     * Accepted values:
-     * - "extendability readonly".
-     * - or "readonly extendability".
-     *
-     * Defaults to "extendability readonly".
-     *
-     * @since 1.0.0
-     *
-     * @var string
-     */
-    public $order = self::EXTEND_READONLY;
-
-    /**
-     * Returns an array of tokens this test wants to listen for.
-     *
-     * @since 1.0.0
-     *
-     * @return array<int|string>
-     */
-    public function register()
-    {
-        return [\T_CLASS];
-    }
-
-    /**
-     * 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)
-    {
-        $classProp = ObjectDeclarations::getClassProperties($phpcsFile, $stackPtr);
-
-        if ($classProp['readonly_token'] === false
-            || ($classProp['final_token'] === false && $classProp['abstract_token'] === false)
-        ) {
-            /*
-             * Either no modifier keywords found at all; or only one type of modifier
-             * keyword (abstract/final or readonly) declared, but not both. No ordering needed.
-             */
-            return;
-        }
-
-        if ($classProp['final_token'] !== false && $classProp['abstract_token'] !== false) {
-            // Parse error. Ignore.
-            return;
-        }
-
-        $readonly = $classProp['readonly_token'];
-
-        if ($classProp['final_token'] !== false) {
-            $extendability = $classProp['final_token'];
-        } else {
-            $extendability = $classProp['abstract_token'];
-        }
-
-        if ($readonly < $extendability) {
-            $phpcsFile->recordMetric($stackPtr, self::METRIC_NAME, self::READONLY_EXTEND);
-        } else {
-            $phpcsFile->recordMetric($stackPtr, self::METRIC_NAME, self::EXTEND_READONLY);
-        }
-
-        $message = 'Class modifier keywords are not in the correct order. Expected: "%s", found: "%s"';
-
-        switch ($this->order) {
-            case self::READONLY_EXTEND:
-                if ($readonly < $extendability) {
-                    // Order is correct. Nothing to do.
-                    return;
-                }
-
-                $this->handleError($phpcsFile, $extendability, $readonly);
-                break;
-
-            case self::EXTEND_READONLY:
-            default:
-                if ($extendability < $readonly) {
-                    // Order is correct. Nothing to do.
-                    return;
-                }
-
-                $this->handleError($phpcsFile, $readonly, $extendability);
-                break;
-        }
-    }
-
-    /**
-     * Throw the error and potentially fix it.
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile     The file being scanned.
-     * @param int                         $firstKeyword  The position of the first keyword found.
-     * @param int                         $secondKeyword The position of the second keyword token.
-     *
-     * @return void
-     */
-    private function handleError(File $phpcsFile, $firstKeyword, $secondKeyword)
-    {
-        $tokens = $phpcsFile->getTokens();
-
-        $message = 'Class modifier keywords are not in the correct order. Expected: "%s", found: "%s"';
-        $data    = [
-            $tokens[$secondKeyword]['content'] . ' ' . $tokens[$firstKeyword]['content'],
-            $tokens[$firstKeyword]['content'] . ' ' . $tokens[$secondKeyword]['content'],
-        ];
-
-        $fix = $phpcsFile->addFixableError($message, $firstKeyword, 'Incorrect', $data);
-
-        if ($fix === true) {
-            $phpcsFile->fixer->beginChangeset();
-
-            $phpcsFile->fixer->replaceToken($secondKeyword, '');
-
-            // Prevent leaving behind trailing whitespace.
-            $i = ($secondKeyword + 1);
-            while ($tokens[$i]['code'] === \T_WHITESPACE) {
-                $phpcsFile->fixer->replaceToken($i, '');
-                ++$i;
-            }
-
-            // Use the original token content as the case used for keywords is not the concern of this sniff.
-            $phpcsFile->fixer->addContentBefore($firstKeyword, $tokens[$secondKeyword]['content'] . ' ');
-
-            $phpcsFile->fixer->endChangeset();
-        }
-    }
-}

package/vendor/phpcsstandards/phpcsextra/Universal/Sniffs/Classes/RequireAnonClassParenthesesSniff.php

@@ -1,81 +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\Classes;
-
-use PHP_CodeSniffer\Files\File;
-use PHP_CodeSniffer\Sniffs\Sniff;
-use PHP_CodeSniffer\Util\Tokens;
-
-/**
- * Require that an anonymous class declaration/instantiation has parentheses, i.e. `new class().
- *
- * @since 1.0.0
- */
-final class RequireAnonClassParenthesesSniff implements Sniff
-{
-
-    /**
-     * Name of the metric.
-     *
-     * @since 1.0.0
-     *
-     * @var string
-     */
-    const METRIC_NAME = 'Anon class declaration with parenthesis';
-
-    /**
-     * Returns an array of tokens this test wants to listen for.
-     *
-     * @since 1.0.0
-     *
-     * @return array<int|string>
-     */
-    public function register()
-    {
-        return [\T_ANON_CLASS];
-    }
-
-    /**
-     * 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();
-        $nextNonEmpty = $phpcsFile->findNext(Tokens::$emptyTokens, ($stackPtr + 1), null, true);
-
-        // Note: no need to check for `false` as PHPCS won't retokenize `class` to `T_ANON_CLASS` in that case.
-        if ($tokens[$nextNonEmpty]['code'] === \T_OPEN_PARENTHESIS) {
-            // Parentheses found.
-            $phpcsFile->recordMetric($stackPtr, self::METRIC_NAME, 'yes');
-            return;
-        }
-
-        $phpcsFile->recordMetric($stackPtr, self::METRIC_NAME, 'no');
-
-        $fix = $phpcsFile->addFixableError(
-            'Parenthesis required when creating a new anonymous class.',
-            $stackPtr,
-            'Missing'
-        );
-
-        if ($fix === true) {
-            $phpcsFile->fixer->addContent($stackPtr, '()');
-        }
-    }
-}

package/vendor/phpcsstandards/phpcsextra/Universal/Sniffs/Classes/RequireFinalClassSniff.php

@@ -1,102 +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\Classes;
-
-use PHP_CodeSniffer\Files\File;
-use PHP_CodeSniffer\Sniffs\Sniff;
-use PHP_CodeSniffer\Util\Tokens;
-use PHPCSUtils\Utils\GetTokensAsString;
-use PHPCSUtils\Utils\ObjectDeclarations;
-
-/**
- * Require classes being declared as "final".
- *
- * @since 1.0.0
- */
-final class RequireFinalClassSniff implements Sniff
-{
-
-    /**
-     * Name of the metric.
-     *
-     * @since 1.0.0
-     *
-     * @var string
-     */
-    const METRIC_NAME = 'Class is abstract or final ?';
-
-    /**
-     * Returns an array of tokens this test wants to listen for.
-     *
-     * @since 1.0.0
-     *
-     * @return array<int|string>
-     */
-    public function register()
-    {
-        return [\T_CLASS];
-    }
-
-    /**
-     * 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)
-    {
-        $classProp = ObjectDeclarations::getClassProperties($phpcsFile, $stackPtr);
-        if ($classProp['is_final'] === true) {
-            $phpcsFile->recordMetric($stackPtr, self::METRIC_NAME, 'final');
-            return;
-        }
-
-        if ($classProp['is_abstract'] === true) {
-            // Abstract classes can't be final.
-            $phpcsFile->recordMetric($stackPtr, self::METRIC_NAME, 'abstract');
-            return;
-        }
-
-        $phpcsFile->recordMetric($stackPtr, self::METRIC_NAME, 'not abstract, not final');
-
-        $nextNonEmpty = $phpcsFile->findNext(Tokens::$emptyTokens, ($stackPtr + 1), null, true);
-        if ($nextNonEmpty === false) {
-            // Live coding or parse error.
-            return;
-        }
-
-        $snippetEnd  = $nextNonEmpty;
-        $classCloser = '';
-
-        $tokens = $phpcsFile->getTokens();
-        if (isset($tokens[$stackPtr]['scope_opener']) === true) {
-            $snippetEnd  = $tokens[$stackPtr]['scope_opener'];
-            $classCloser = '}';
-        }
-
-        $snippet = GetTokensAsString::compact($phpcsFile, $stackPtr, $snippetEnd, true);
-        $fix     = $phpcsFile->addFixableError(
-            'A non-abstract class should be declared as final. Found: %s%s',
-            $stackPtr,
-            'NonFinalClassFound',
-            [$snippet, $classCloser]
-        );
-
-        if ($fix === true) {
-            $phpcsFile->fixer->addContentBefore($stackPtr, 'final ');
-        }
-    }
-}