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

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 2025 PHPCSStandards and contributors
 * @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 PHP_CodeSniffer\Tests\Core\Ruleset\AbstractRulesetTestCase;

/**
 * Test home path handling in the Ruleset::expandRulesetReference() method.
 *
 * @covers \PHP_CodeSniffer\Ruleset::expandRulesetReference
 */
final class ExpandRulesetReferenceHomePathTest extends AbstractRulesetTestCase
{

/**
     * Original value of the user's home path environment variable.
     *
     * @var string|false Path or false is the `HOME` environment variable is not available.
     */
    private static $homepath = false;

/**
     * Store the user's home path.
     *
     * @beforeClass
     *
     * @return void
     */
    public static function storeHomePath()
    {
        self::$homepath = getenv('HOME');

}//end storeHomePath()

/**
     * Restore the user's home path environment variable in case the test changed it or created it.
     *
     * @afterClass
     *
     * @return void
     */
    public static function restoreHomePath()
    {
        if (is_string(self::$homepath) === true) {
            putenv('HOME='.self::$homepath);
        } else {
            // Remove the environment variable as it didn't exist before.
            putenv('HOME');
        }

}//end restoreHomePath()

/**
     * Set the home path to an alternative location.
     *
     * @before
     *
     * @return void
     */
    protected function setHomePath()
    {
        $fakeHomePath = __DIR__.DIRECTORY_SEPARATOR.'Fixtures'.DIRECTORY_SEPARATOR.'FakeHomePath';
        putenv("HOME=$fakeHomePath");

}//end setHomePath()

/**
     * Verify that a sniff reference with the magic "home path" placeholder gets expanded correctly
     * and finds sniffs if the path exists underneath the "home path".
     *
     * @return void
     */
    public function testHomePathRefGetsExpandedAndFindsSniff()
    {
        // Set up the ruleset.
        $standard = __DIR__.'/ExpandRulesetReferenceHomePathTest.xml';
        $config   = new ConfigDouble(["--standard=$standard"]);
        $ruleset  = new Ruleset($config);

$expected = ['MyStandard.Category.Valid' => 'FakeHomePath\\MyStandard\\Sniffs\\Category\\ValidSniff'];

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

}//end testHomePathRefGetsExpandedAndFindsSniff()

/**
     * Verify that a sniff reference with the magic "home path" placeholder gets expanded correctly
     * and still fails to find sniffs if the path doesn't exists underneath the "home path".
     *
     * @return void
     */
    public function testHomePathRefGetsExpandedAndThrowsExceptionWhenPathIsInvalid()
    {
        // Set up the ruleset.
        $standard = __DIR__.'/ExpandRulesetReferenceHomePathFailTest.xml';
        $config   = new ConfigDouble(["--standard=$standard"]);

$exceptionMessage  = 'ERROR: Referenced sniff "~/src/MyStandard/Sniffs/DoesntExist/" does not exist.'.PHP_EOL;
        $exceptionMessage .= 'ERROR: No sniffs were registered.'.PHP_EOL.PHP_EOL;
        $this->expectRuntimeExceptionMessage($exceptionMessage);

new Ruleset($config);

}//end testHomePathRefGetsExpandedAndThrowsExceptionWhenPathIsInvalid()

}//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]