ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: opt / cpanel / ea-wappspector / vendor / squizlabs / php_codesniffer / tests / Core / Ruleset

<?php
/**
 * Test the Ruleset::expandRulesetReference() method.
 *
 * @author    Juliette Reinders Folmer <phpcs_nospam@adviesenzo.nl>
 * @copyright 2024 PHPCSStandards and contributors
 * @license   https://github.com/PHPCSStandards/PHP_CodeSniffer/blob/HEAD/licence.txt BSD Licence
 */

namespace PHP_CodeSniffer\Tests\Core\Ruleset;

use PHP_CodeSniffer\Ruleset;
use PHP_CodeSniffer\Tests\ConfigDouble;
use PHP_CodeSniffer\Tests\Core\Ruleset\AbstractRulesetTestCase;

/**
 * Test various aspects of the Ruleset::expandRulesetReference() method not covered by other tests.
 *
 * @covers \PHP_CodeSniffer\Ruleset::expandRulesetReference
 */
final class ExpandRulesetReferenceTest extends AbstractRulesetTestCase
{

/**
     * Test handling of path references relative to the originally included ruleset.
     *
     * @return void
     */
    public function testRulesetRelativePathReferences()
    {
        // Set up the ruleset.
        $standard = __DIR__.'/ExpandRulesetReferenceTest.xml';
        $config   = new ConfigDouble(["--standard=$standard"]);
        $ruleset  = new Ruleset($config);

$expected = [
            'ExternalA.CheckSomething.Valid'              => 'Fixtures\\ExternalA\\Sniffs\\CheckSomething\\ValidSniff',
            'TestStandard.ValidSniffs.RegisterEmptyArray' => 'Fixtures\\TestStandard\\Sniffs\\ValidSniffs\\RegisterEmptyArraySniff',
            'ExternalB.CheckMore.Valid'                   => 'Fixtures\\ExternalB\\Sniffs\\CheckMore\\ValidSniff',
        ];

$this->assertSame($expected, $ruleset->sniffCodes);

}//end testRulesetRelativePathReferences()

/**
     * Test that an exception is thrown if a ruleset contains an unresolvable reference.
     *
     * @param string $standard    The standard to use for the test.
     * @param string $replacement The reference which will be used in the exception message.
     *
     * @dataProvider dataUnresolvableReferenceThrowsException
     *
     * @return void
     */
    public function testUnresolvableReferenceThrowsException($standard, $replacement)
    {
        // Set up the ruleset.
        $standard = __DIR__.'/'.$standard;
        $config   = new ConfigDouble(["--standard=$standard"]);

$exceptionMessage  = 'ERROR: Referenced sniff "%s" does not exist.'.PHP_EOL;
        $exceptionMessage .= 'ERROR: No sniffs were registered.'.PHP_EOL.PHP_EOL;
        $this->expectRuntimeExceptionMessage(sprintf($exceptionMessage, $replacement));

new Ruleset($config);

}//end testUnresolvableReferenceThrowsException()

/**
     * Data provider.
     *
     * @see testUnresolvableReferenceThrowsException()
     *
     * @return array<string, array<string, string>>
     */
    public static function dataUnresolvableReferenceThrowsException()
    {
        $data = [
            'Referencing a non-existent XML file'                     => [
                'standard'    => 'ExpandRulesetReferenceMissingFileTest.xml',
                'replacement' => './MissingFile.xml',
            ],
            'Referencing an invalid directory starting with "~"'      => [
                'standard'    => 'ExpandRulesetReferenceInvalidHomePathRefTest.xml',
                'replacement' => '~/src/Standards/Squiz/Sniffs/Files/',
            ],
            'Referencing an unknown standard'                         => [
                'standard'    => 'ExpandRulesetReferenceUnknownStandardTest.xml',
                'replacement' => 'UnknownStandard',
            ],
            'Referencing a non-existent category in a known standard' => [
                'standard'    => 'ExpandRulesetReferenceUnknownCategoryTest.xml',
                'replacement' => 'TestStandard.UnknownCategory',
            ],
            'Referencing a non-existent sniff in a known standard'    => [
                'standard'    => 'ExpandRulesetReferenceUnknownSniffTest.xml',
                'replacement' => 'TestStandard.InvalidSniffs.UnknownRule',
            ],
            'Referencing an invalid error code - no standard name'    => [
                'standard'    => 'ExpandRulesetReferenceInvalidErrorCode1Test.xml',
                'replacement' => '.Invalid.Undetermined.Found',
            ],
            'Referencing an invalid error code - no category name'    => [
                'standard'    => 'ExpandRulesetReferenceInvalidErrorCode2Test.xml',
                'replacement' => 'Standard..Undetermined.Found',
            ],
            'Referencing an invalid error code - no sniff name'       => [
                'standard'    => 'ExpandRulesetReferenceInvalidErrorCode3Test.xml',
                'replacement' => 'Standard.Invalid..Found',
            ],
        ];

// Add tests which are only relevant for case-sensitive OSes.
        if (stripos(PHP_OS, 'WIN') === false) {
            $data['Referencing an existing sniff, but there is a case mismatch (OS-dependent) [1]'] = [
                'standard'    => 'ExpandRulesetReferenceCaseMismatch1Test.xml',
                'replacement' => 'psr12.functions.nullabletypedeclaration',
            ];
            $data['Referencing an existing sniff, but there is a case mismatch (OS-dependent) [2]'] = [
                'standard'    => 'ExpandRulesetReferenceCaseMismatch2Test.xml',
                'replacement' => 'PSR12.Functions.ReturntypeDeclaration',
            ];
        }

return $data;

}//end dataUnresolvableReferenceThrowsException()

}//end class

[+] ..
[-] PropertyTypeHandlingTest.xml [open]
[-] RegisterSniffsRejectsInvalidSniffNoImplementsNoRegisterTest.xml [open]
[-] RegisterSniffsRejectsInvalidSniffNoImplementsNoRegisterOrProcessTest.xml [open]
[-] GetIgnorePatternsTest.xml [open]
[-] ProcessRuleShouldProcessElementTest.php [open]
[-] ProcessRulesetShouldProcessElementTest.xml [open]
[-] RegisterSniffsTest.php [open]
[-] ShowSniffDeprecationsTest.xml [open]
[-] ExpandRulesetReferenceInternalTest.php [open]
[-] PopulateTokenListenersSupportedTokenizersTest.php [open]
[-] ProcessRuleInvalidTypeTest.xml [open]
[-] RuleInclusionTest-include.xml [open]
[-] DisplayCachedMessagesTest.php [open]
[-] ProcessRulesetAutoloadFileNotFoundTest.xml [open]
[-] ExpandRulesetReferenceTest.php [open]
[-] RegisterSniffsRejectsInvalidSniffTest.php [open]
[-] PopulateTokenListenersRegisterNoArrayTest.xml [open]
[-] ExplainTest.php [open]
[-] ExpandRulesetReferenceUnknownStandardTest.xml [open]
[-] PropertyTypeHandlingTest.php [open]
[-] RegisterSniffsMissingInterfaceValidTest.xml [open]
[-] ExpandRulesetReferenceHomePathTest.xml [open]
[-] ExpandRulesetReferenceHomePathTest.php [open]
[-] SetPropertyNotAllowedViaAttributeTest.xml [open]
[-] ExpandSniffDirectoryTest.php [open]
[-] ProcessRulesetShouldProcessElementTest.php [open]
[-] ProcessRulesetBrokenRulesetEmptyFileTest.xml [open]
[-] ShowSniffDeprecationsInvalidDeprecationVersionTest.xml [open]
[-] RegisterSniffsMissingInterfaceTest.php [open]
[-] ExpandRulesetReferenceHomePathFailTest.xml [open]
[-] ExpandRulesetReferenceInvalidErrorCode3Test.xml [open]
[-] ShowSniffDeprecationsInvalidDeprecationMessageTest.xml [open]
[-] ExpandRulesetReferenceCaseMismatch1Test.xml [open]
[-] ExpandRulesetReferenceUnknownSniffTest.xml [open]
[-] ProcessRulesetBrokenRulesetTest.php [open]
[-] ExpandRulesetReferenceInvalidErrorCode2Test.xml [open]
[-] AbstractRulesetTestCase.php [open]
[-] RuleInclusionTest.php [open]
[-] ExpandRulesetReferenceInternalIgnoreTest.xml [open]
[-] ProcessRulesetInvalidNoSniffsDirTest.xml [open]
[-] PopulateTokenListenersNamingConventionsTest.xml [open]
[-] RuleInclusionAbsoluteLinuxTest.xml [open]
[-] SetSniffPropertyTest.php [open]
[-] ProcessRulesetTest.php [open]
[-] ConstructorNoSniffsTest.xml [open]
[+] Fixtures
[-] ProcessRulesetMiscTest.xml [open]
[-] ExpandRulesetReferenceUnknownCategoryTest.xml [open]
[-] ProcessRuleInvalidTypeTest.php [open]
[-] SetPropertyAllowedViaStdClassTest.xml [open]
[-] ExpandRulesetReferenceInternalStandardTest.xml [open]
[-] ShowSniffDeprecationsEmptyDeprecationVersionTest.xml [open]
[-] GetIgnorePatternsTest.php [open]
[-] PopulateTokenListenersSupportedTokenizersTest.xml [open]
[-] SetPropertyThrowsErrorOnInvalidPropertyTest.xml [open]
[-] ExplainCustomRulesetTest.xml [open]
[-] ExpandRulesetReferenceMissingFileTest.xml [open]
[-] ProcessRulesetAutoloadTest.xml [open]
[-] ProcessRuleShouldProcessElementTest.xml [open]
[-] ShowSniffDeprecationsOrderTest.xml [open]
[-] SetPropertyAllowedAsDeclaredTest.xml [open]
[-] SetPropertyAppliesPropertyToMultipleSniffsInCategoryTest.xml [open]
[-] ShowSniffDeprecationsEmptyRemovalVersionTest.xml [open]
[-] RegisterSniffsMissingInterfaceInvalidTest.xml [open]
[-] ExpandRulesetReferenceInvalidErrorCode1Test.xml [open]
[-] SetPropertyDoesNotThrowErrorOnInvalidPropertyWhenSetForStandardTest.xml [open]
[-] ProcessRulesetAutoExpandSniffsDirectoryTest.xml [open]
[-] ProcessRulesetExcludeSniffGroupTest.xml [open]
[-] ExpandRulesetReferenceInvalidHomePathRefTest.xml [open]
[-] RuleInclusionAbsoluteWindowsTest.php [open]
[-] ExpandSniffDirectoryTest.xml [open]
[-] SetPropertyDoesNotThrowErrorOnInvalidPropertyWhenSetForCategoryTest.xml [open]
[-] ExpandRulesetReferenceCaseMismatch2Test.xml [open]
[-] ProcessRulesetAutoloadTest.php [open]
[-] ExplainSingleSniffTest.xml [open]
[-] GetIncludePatternsTest.php [open]
[-] SetPropertyAllowedViaMagicMethodTest.xml [open]
[-] ShowSniffDeprecationsReportWidthTest.xml [open]
[-] ExpandRulesetReferenceTest.xml [open]
[-] ShowSniffDeprecationsTest.php [open]
[-] ProcessRulesetBrokenRulesetSingleErrorTest.xml [open]
[-] RuleInclusionTest.xml [open]
[-] ShowSniffDeprecationsInvalidRemovalVersionTest.xml [open]
[-] RegisterSniffsRejectsInvalidSniffNoImplementsNoProcessTest.xml [open]
[-] PopulateTokenListenersTest.php [open]
[-] ConstructorTest.php [open]
[-] ProcessRulesetBrokenRulesetMultiErrorTest.xml [open]
[-] PopulateTokenListenersTest.xml [open]
[-] GetIncludePatternsTest.xml [open]
[-] RuleInclusionAbsoluteLinuxTest.php [open]
[-] PopulateTokenListenersNamingConventionsTest.php [open]
[-] RuleInclusionAbsoluteWindowsTest.xml [open]
[-] PropertyTypeHandlingInlineTest.xml [open]