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

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

<?php
/**
 * Tests to verify that the "explain" command functions as expected.
 *
 * @author    Juliette Reinders Folmer <phpcs_nospam@adviesenzo.nl>
 * @copyright 2023 Juliette Reinders Folmer. All rights reserved.
 * @license   https://github.com/PHPCSStandards/PHP_CodeSniffer/blob/master/licence.txt BSD Licence
 */

namespace PHP_CodeSniffer\Tests\Core\Ruleset;

use PHP_CodeSniffer\Ruleset;
use PHP_CodeSniffer\Tests\ConfigDouble;
use PHPUnit\Framework\TestCase;

/**
 * Test the Ruleset::explain() function.
 *
 * @covers \PHP_CodeSniffer\Ruleset::explain
 */
final class ExplainTest extends TestCase
{

/**
     * Test the output of the "explain" command.
     *
     * @return void
     */
    public function testExplain()
    {
        // Set up the ruleset.
        $config  = new ConfigDouble(['--standard=PSR1', '-e']);
        $ruleset = new Ruleset($config);

$expected  = PHP_EOL;
        $expected .= 'The PSR1 standard contains 8 sniffs'.PHP_EOL.PHP_EOL;
        $expected .= 'Generic (4 sniffs)'.PHP_EOL;
        $expected .= '------------------'.PHP_EOL;
        $expected .= '  Generic.Files.ByteOrderMark'.PHP_EOL;
        $expected .= '  Generic.NamingConventions.UpperCaseConstantName'.PHP_EOL;
        $expected .= '  Generic.PHP.DisallowAlternativePHPTags'.PHP_EOL;
        $expected .= '  Generic.PHP.DisallowShortOpenTag'.PHP_EOL.PHP_EOL;
        $expected .= 'PSR1 (3 sniffs)'.PHP_EOL;
        $expected .= '---------------'.PHP_EOL;
        $expected .= '  PSR1.Classes.ClassDeclaration'.PHP_EOL;
        $expected .= '  PSR1.Files.SideEffects'.PHP_EOL;
        $expected .= '  PSR1.Methods.CamelCapsMethodName'.PHP_EOL.PHP_EOL;
        $expected .= 'Squiz (1 sniff)'.PHP_EOL;
        $expected .= '---------------'.PHP_EOL;
        $expected .= '  Squiz.Classes.ValidClassName'.PHP_EOL;

$this->expectOutputString($expected);

$ruleset->explain();

}//end testExplain()

/**
     * Test the output of the "explain" command is not influenced by a user set report width.
     *
     * @return void
     */
    public function testExplainAlwaysDisplaysCompleteSniffName()
    {
        // Set up the ruleset.
        $config  = new ConfigDouble(['--standard=PSR1', '-e', '--report-width=30']);
        $ruleset = new Ruleset($config);

$this->expectOutputString($expected);

$ruleset->explain();

}//end testExplainAlwaysDisplaysCompleteSniffName()

/**
     * Test the output of the "explain" command when a ruleset only contains a single sniff.
     *
     * This is mostly about making sure that the summary line uses the correct grammar.
     *
     * @return void
     */
    public function testExplainSingleSniff()
    {
        // Set up the ruleset.
        $standard = __DIR__.'/ExplainSingleSniffTest.xml';
        $config   = new ConfigDouble(["--standard=$standard", '-e']);
        $ruleset  = new Ruleset($config);

$expected  = PHP_EOL;
        $expected .= 'The ExplainSingleSniffTest standard contains 1 sniff'.PHP_EOL.PHP_EOL;
        $expected .= 'Squiz (1 sniff)'.PHP_EOL;
        $expected .= '---------------'.PHP_EOL;
        $expected .= '  Squiz.Scope.MethodScope'.PHP_EOL;

$this->expectOutputString($expected);

$ruleset->explain();

}//end testExplainSingleSniff()

/**
     * Test that "explain" works correctly with custom rulesets.
     *
     * Verifies that:
     * - The "standard" name is taken from the custom ruleset.
     * - Any and all sniff additions and exclusions in the ruleset are taken into account correctly.
     * - That the displayed list will have both the standards as well as the sniff names
     *   ordered alphabetically.
     *
     * @return void
     */
    public function testExplainCustomRuleset()
    {
        // Set up the ruleset.
        $standard = __DIR__.'/ExplainCustomRulesetTest.xml';
        $config   = new ConfigDouble(["--standard=$standard", '-e']);
        $ruleset  = new Ruleset($config);

$expected  = PHP_EOL;
        $expected .= 'The ExplainCustomRulesetTest standard contains 10 sniffs'.PHP_EOL.PHP_EOL;
        $expected .= 'Generic (4 sniffs)'.PHP_EOL;
        $expected .= '------------------'.PHP_EOL;
        $expected .= '  Generic.Files.ByteOrderMark'.PHP_EOL;
        $expected .= '  Generic.NamingConventions.UpperCaseConstantName'.PHP_EOL;
        $expected .= '  Generic.PHP.DisallowAlternativePHPTags'.PHP_EOL;
        $expected .= '  Generic.PHP.DisallowShortOpenTag'.PHP_EOL.PHP_EOL;
        $expected .= 'PSR1 (2 sniffs)'.PHP_EOL;
        $expected .= '---------------'.PHP_EOL;
        $expected .= '  PSR1.Classes.ClassDeclaration'.PHP_EOL;
        $expected .= '  PSR1.Methods.CamelCapsMethodName'.PHP_EOL.PHP_EOL;
        $expected .= 'PSR12 (2 sniffs)'.PHP_EOL;
        $expected .= '----------------'.PHP_EOL;
        $expected .= '  PSR12.ControlStructures.BooleanOperatorPlacement'.PHP_EOL;
        $expected .= '  PSR12.ControlStructures.ControlStructureSpacing'.PHP_EOL.PHP_EOL;
        $expected .= 'Squiz (2 sniffs)'.PHP_EOL;
        $expected .= '----------------'.PHP_EOL;
        $expected .= '  Squiz.Classes.ValidClassName'.PHP_EOL;
        $expected .= '  Squiz.Scope.MethodScope'.PHP_EOL;

$this->expectOutputString($expected);

$ruleset->explain();

}//end testExplainCustomRuleset()

/**
     * Test the output of the "explain" command for a standard containing both deprecated
     * and non-deprecated sniffs.
     *
     * Tests that:
     * - Deprecated sniffs are marked with an asterix in the list.
     * - A footnote is displayed explaining the asterix.
     * - And that the "standard uses # deprecated sniffs" listing is **not** displayed.
     *
     * @return void
     */
    public function testExplainWithDeprecatedSniffs()
    {
        // Set up the ruleset.
        $standard = __DIR__."/ShowSniffDeprecationsTest.xml";
        $config   = new ConfigDouble(["--standard=$standard", '-e']);
        $ruleset  = new Ruleset($config);

$expected  = PHP_EOL;
        $expected .= 'The ShowSniffDeprecationsTest standard contains 11 sniffs'.PHP_EOL.PHP_EOL;

$expected .= 'TestStandard (11 sniffs)'.PHP_EOL;
        $expected .= '------------------------'.PHP_EOL;
        $expected .= '  TestStandard.Deprecated.WithLongReplacement *'.PHP_EOL;
        $expected .= '  TestStandard.Deprecated.WithoutReplacement *'.PHP_EOL;
        $expected .= '  TestStandard.Deprecated.WithReplacement *'.PHP_EOL;
        $expected .= '  TestStandard.Deprecated.WithReplacementContainingLinuxNewlines *'.PHP_EOL;
        $expected .= '  TestStandard.Deprecated.WithReplacementContainingNewlines *'.PHP_EOL;
        $expected .= '  TestStandard.SetProperty.AllowedAsDeclared'.PHP_EOL;
        $expected .= '  TestStandard.SetProperty.AllowedViaMagicMethod'.PHP_EOL;
        $expected .= '  TestStandard.SetProperty.AllowedViaStdClass'.PHP_EOL;
        $expected .= '  TestStandard.SetProperty.NotAllowedViaAttribute'.PHP_EOL;
        $expected .= '  TestStandard.SetProperty.PropertyTypeHandling'.PHP_EOL;
        $expected .= '  TestStandard.ValidSniffs.RegisterEmptyArray'.PHP_EOL.PHP_EOL;

$expected .= '* Sniffs marked with an asterisk are deprecated.'.PHP_EOL;

$this->expectOutputString($expected);

$ruleset->explain();

}//end testExplainWithDeprecatedSniffs()

}//end class

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