Ruleset::expandSniffDirectory(): add test

tests/Core/Ruleset/ExpandSniffDirectoryTest.php

@@ -0,0 +1,78 @@
+<?php
+/**
+ * Test the Ruleset::expandSniffDirectory() method.
+ *
+ * @author    Juliette Reinders Folmer <[email protected]>
+ * @copyright 2024 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 PHPUnit\Framework\TestCase;
+
+/**
+ * Test the Ruleset::expandSniffDirectory() method.
+ *
+ * @covers \PHP_CodeSniffer\Ruleset::expandSniffDirectory
+ */
+final class ExpandSniffDirectoryTest extends TestCase
+{
+
+
+    /**
+     * Test finding sniff files based on a given directory.
+     *
+     * This test verifies that:
+     * - Hidden (sub)directories are ignored, but the given directory is allowed to be within a hidden directory.
+     * - Hidden files are ignored.
+     * - Files without a "php" extension are ignored.
+     * - Files without a "Sniff" suffix in the file name are ignored.
+     *
+     * Note: the "[Another]AbstractSniff" files will be found and included in the return value
+     * from `Ruleset::expandSniffDirectory()`.
+     * Those are filtered out later in the `Ruleset::registerSniffs()` method.
+     *
+     * @return void
+     */
+    public function testExpandSniffDirectory()
+    {
+        // Set up the ruleset.
+        $standard = __DIR__.'/ExpandSniffDirectoryTest.xml';
+        $config   = new ConfigDouble(["--standard=$standard"]);
+        $ruleset  = new Ruleset($config);
+
+        $expectedPathToRuleset = __DIR__.'/Fixtures/DirectoryExpansion/.hiddenAbove/src/MyStandard/ruleset.xml';
+        $expectedPathToRuleset = realpath($expectedPathToRuleset);
+        $this->assertNotFalse($expectedPathToRuleset, 'Ruleset file could not be found');
+        $this->assertContains($expectedPathToRuleset, $ruleset->paths, 'Ruleset file not included in the "seen ruleset paths"');
+
+        /*
+         * Take note: the expectation includes some "undesirables" related to the convoluted directory structure
+         * in the "standard" used as a test fixture.
+         *
+         * That is okay as (for now) non-standard directory layouts are supported.
+         *
+         * This test is not about the standard directory layout.
+         */
+
+        $expectedSniffCodes = [
+            '.Sniffs.IncorrectLevelShouldStillBeFound'       => 'MyStandard\\Sniffs\\IncorrectLevelShouldStillBeFoundSniff',
+            'MyStandard.CategoryA.FindMe'                    => 'MyStandard\\Sniffs\\CategoryA\\FindMeSniff',
+            'MyStandard.CategoryB.FindMe'                    => 'MyStandard\\Sniffs\\CategoryB\\FindMeSniff',
+            'Sniffs.SubDir.IncorrectLevelShouldStillBeFound' => 'MyStandard\\Sniffs\\CategoryA\\SubDir\\IncorrectLevelShouldStillBeFoundSniff',
+        ];
+
+        // Sort the value to make the tests stable as different OSes will read directories
+        // in a different order and the order is not relevant for these tests. Just the values.
+        $actual = $ruleset->sniffCodes;
+        ksort($actual);
+
+        $this->assertSame($expectedSniffCodes, $actual, 'Registered sniffs do not match expectation');
+
+    }//end testExpandSniffDirectory()
+
+
+}//end class

tests/Core/Ruleset/ExpandSniffDirectoryTest.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0"?>
+<ruleset xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" name="ExpandSniffDirectoryTest" xsi:noNamespaceSchemaLocation="https://raw.githubusercontent.com/PHPCSStandards/PHP_CodeSniffer/master/phpcs.xsd">
+
+    <config name="installed_paths" value="./tests/Core/Ruleset/Fixtures/DirectoryExpansion/.hiddenAbove/src/"/>
+
+    <rule ref="MyStandard"/>
+
+</ruleset>

tests/Core/Ruleset/Fixtures/DirectoryExpansion/.hiddenAbove/src/MyStandard/.hidden/HiddenDirShouldBeIgnoredSniff.php

@@ -0,0 +1,15 @@
+<?php
+/**
+ * Test fixture.
+ *
+ * Note: yes, there is a parse error in this file (namespace name is invalid).
+ * No, that's not a problem.
+ *
+ * @see \PHP_CodeSniffer\Tests\Core\Ruleset\ExpandSniffDirectoryTest
+ */
+
+namespace MyStandard\.hidden;
+
+use MyStandard\DummySniff;
+
+final class HiddenDirShouldBeIgnoredSniff extends DummySniff {}

tests/Core/Ruleset/Fixtures/DirectoryExpansion/.hiddenAbove/src/MyStandard/AbstractSniff.php

@@ -0,0 +1,12 @@
+<?php
+/**
+ * Test fixture.
+ *
+ * @see \PHP_CodeSniffer\Tests\Core\Ruleset\ExpandSniffDirectoryTest
+ */
+
+namespace MyStandard\Sniffs;
+
+use PHP_CodeSniffer\Sniffs\Sniff;
+
+abstract class AbstractSniff implements Sniff {}

tests/Core/Ruleset/Fixtures/DirectoryExpansion/.hiddenAbove/src/MyStandard/DummySniff.php

@@ -0,0 +1,25 @@
+<?php
+/**
+ * Test fixture.
+ *
+ * @see \PHP_CodeSniffer\Tests\Core\Ruleset\ExpandSniffDirectoryTest
+ */
+
+namespace MyStandard;
+
+use PHP_CodeSniffer\Files\File;
+use PHP_CodeSniffer\Sniffs\Sniff;
+
+abstract class DummySniff implements Sniff
+{
+
+    public function register()
+    {
+        return [T_WHITESPACE];
+    }
+
+    public function process(File $phpcsFile, $stackPtr)
+    {
+        // Do something.
+    }
+}

tests/Core/Ruleset/Fixtures/DirectoryExpansion/.hiddenAbove/src/MyStandard/Sniffs/.hidden/HiddenDirShouldBeIgnoredSniff.php

@@ -0,0 +1,15 @@
+<?php
+/**
+ * Test fixture.
+ *
+ * Note: yes, there is a parse error in this file (namespace name is invalid).
+ * No, that's not a problem.
+ *
+ * @see \PHP_CodeSniffer\Tests\Core\Ruleset\ExpandSniffDirectoryTest
+ */
+
+namespace MyStandard\Sniffs\.hidden;
+
+use MyStandard\DummySniff;
+
+final class HiddenDirShouldBeIgnoredSniff extends DummySniff {}

tests/Core/Ruleset/Fixtures/DirectoryExpansion/.hiddenAbove/src/MyStandard/Sniffs/AbstractSniff.php

@@ -0,0 +1,12 @@
+<?php
+/**
+ * Test fixture.
+ *
+ * @see \PHP_CodeSniffer\Tests\Core\Ruleset\ExpandSniffDirectoryTest
+ */
+
+namespace MyStandard\Sniffs;
+
+use PHP_CodeSniffer\Sniffs\Sniff;
+
+abstract class AbstractSniff implements Sniff {}

tests/Core/Ruleset/Fixtures/DirectoryExpansion/.hiddenAbove/src/MyStandard/Sniffs/CategoryA/.HiddenFileSniff.php

@@ -0,0 +1,12 @@
+<?php
+/**
+ * Test fixture.
+ *
+ * @see \PHP_CodeSniffer\Tests\Core\Ruleset\ExpandSniffDirectoryTest
+ */
+
+namespace MyStandard\Sniffs\CategoryA;
+
+use MyStandard\DummySniff;
+
+final class HiddenFileSniff extends DummySniff {}

tests/Core/Ruleset/Fixtures/DirectoryExpansion/.hiddenAbove/src/MyStandard/Sniffs/CategoryA/.hidden/HiddenDirShouldBeIgnoredSniff.php

@@ -0,0 +1,15 @@
+<?php
+/**
+ * Test fixture.
+ *
+ * Note: yes, there is a parse error in this file (namespace name is invalid).
+ * No, that's not a problem.
+ *
+ * @see \PHP_CodeSniffer\Tests\Core\Ruleset\ExpandSniffDirectoryTest
+ */
+
+namespace MyStandard\Sniffs\CategoryA\.hidden;
+
+use MyStandard\DummySniff;
+
+final class HiddenDirShouldBeIgnoredSniff extends DummySniff {}

tests/Core/Ruleset/Fixtures/DirectoryExpansion/.hiddenAbove/src/MyStandard/Sniffs/CategoryA/DoNotFindMeSniff.txt

@@ -0,0 +1,12 @@
+<?php
+/**
+ * Test fixture.
+ *
+ * @see \PHP_CodeSniffer\Tests\Core\Ruleset\ExpandSniffDirectoryTest
+ */
+
+namespace MyStandard\Sniffs\CategoryA;
+
+use MyStandard\DummySniff;
+
+final class DoNotFindMeSniff extends DummySniff {}

tests/Core/Ruleset/Fixtures/DirectoryExpansion/.hiddenAbove/src/MyStandard/Sniffs/CategoryA/FindMeSniff.php

@@ -0,0 +1,12 @@
+<?php
+/**
+ * Test fixture.
+ *
+ * @see \PHP_CodeSniffer\Tests\Core\Ruleset\ExpandSniffDirectoryTest
+ */
+
+namespace MyStandard\Sniffs\CategoryA;
+
+use MyStandard\DummySniff;
+
+final class FindMeSniff extends DummySniff {}

tests/Core/Ruleset/Fixtures/DirectoryExpansion/.hiddenAbove/src/MyStandard/Sniffs/CategoryA/IncorrectFileExtensionSniff.inc

@@ -0,0 +1,12 @@
+<?php
+/**
+ * Test fixture.
+ *
+ * @see \PHP_CodeSniffer\Tests\Core\Ruleset\ExpandSniffDirectoryTest
+ */
+
+namespace MyStandard\Sniffs\CategoryA;
+
+use MyStandard\DummySniff;
+
+final class IncorrectFileExtensionSniff extends DummySniff {}

tests/Core/Ruleset/Fixtures/DirectoryExpansion/.hiddenAbove/src/MyStandard/Sniffs/CategoryA/MissingSniffSuffix.php

@@ -0,0 +1,12 @@
+<?php
+/**
+ * Test fixture.
+ *
+ * @see \PHP_CodeSniffer\Tests\Core\Ruleset\ExpandSniffDirectoryTest
+ */
+
+namespace MyStandard\Sniffs\CategoryA;
+
+use MyStandard\DummySniff;
+
+final class MissingSniffSuffix extends DummySniff {}

tests/Core/Ruleset/Fixtures/DirectoryExpansion/.hiddenAbove/src/MyStandard/Sniffs/CategoryA/Subdir/IncorrectLevelShouldStillBeFoundSniff.php

@@ -0,0 +1,12 @@
+<?php
+/**
+ * Test fixture.
+ *
+ * @see \PHP_CodeSniffer\Tests\Core\Ruleset\ExpandSniffDirectoryTest
+ */
+
+namespace MyStandard\Sniffs\CategoryA\SubDir;
+
+use MyStandard\DummySniff;
+
+final class IncorrectLevelShouldStillBeFoundSniff extends DummySniff {}

tests/Core/Ruleset/Fixtures/DirectoryExpansion/.hiddenAbove/src/MyStandard/Sniffs/CategoryB/AnotherAbstractSniff.php

@@ -0,0 +1,12 @@
+<?php
+/**
+ * Test fixture.
+ *
+ * @see \PHP_CodeSniffer\Tests\Core\Ruleset\ExpandSniffDirectoryTest
+ */
+
+namespace MyStandard\Sniffs\CategoryB;
+
+use PHP_CodeSniffer\Sniffs\Sniff;
+
+abstract class AnotherAbstractSniff implements Sniff {}

tests/Core/Ruleset/Fixtures/DirectoryExpansion/.hiddenAbove/src/MyStandard/Sniffs/CategoryB/FindMeSniff.php

@@ -0,0 +1,12 @@
+<?php
+/**
+ * Test fixture.
+ *
+ * @see \PHP_CodeSniffer\Tests\Core\Ruleset\ExpandSniffDirectoryTest
+ */
+
+namespace MyStandard\Sniffs\CategoryB;
+
+use MyStandard\DummySniff;
+
+final class FindMeSniff extends DummySniff {}

tests/Core/Ruleset/Fixtures/DirectoryExpansion/.hiddenAbove/src/MyStandard/Sniffs/CategoryB/IncorrectFileExtensionSniff.php3

@@ -0,0 +1,12 @@
+<?php
+/**
+ * Test fixture.
+ *
+ * @see \PHP_CodeSniffer\Tests\Core\Ruleset\ExpandSniffDirectoryTest
+ */
+
+namespace MyStandard\Sniffs\CategoryB;
+
+use MyStandard\DummySniff;
+
+final class IncorrectFileExtensionSniff extends DummySniff {}

tests/Core/Ruleset/Fixtures/DirectoryExpansion/.hiddenAbove/src/MyStandard/Sniffs/IncorrectLevelShouldStillBeFoundSniff.php

@@ -0,0 +1,12 @@
+<?php
+/**
+ * Test fixture.
+ *
+ * @see \PHP_CodeSniffer\Tests\Core\Ruleset\ExpandSniffDirectoryTest
+ */
+
+namespace MyStandard\Sniffs;
+
+use MyStandard\DummySniff;
+
+final class IncorrectLevelShouldStillBeFoundSniff extends DummySniff {}

tests/Core/Ruleset/Fixtures/DirectoryExpansion/.hiddenAbove/src/MyStandard/Utils/NotInSniffsDirSniff.php

@@ -0,0 +1,12 @@
+<?php
+/**
+ * Test fixture.
+ *
+ * @see \PHP_CodeSniffer\Tests\Core\Ruleset\ExpandSniffDirectoryTest
+ */
+
+namespace MyStandard\Utils;
+
+use MyStandard\DummySniff;
+
+final class NotInSniffsDirSniff extends DummySniff {}

tests/Core/Ruleset/Fixtures/DirectoryExpansion/.hiddenAbove/src/MyStandard/Utils/SubDir/NotInSniffsDirSniff.php

@@ -0,0 +1,12 @@
+<?php
+/**
+ * Test fixture.
+ *
+ * @see \PHP_CodeSniffer\Tests\Core\Ruleset\ExpandSniffDirectoryTest
+ */
+
+namespace MyStandard\Utils\SubDir;
+
+use MyStandard\DummySniff;
+
+final class NotInSniffsDirSniff extends DummySniff {}

tests/Core/Ruleset/Fixtures/DirectoryExpansion/.hiddenAbove/src/MyStandard/ruleset.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0"?>
+<ruleset xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" name="MyStandard" xsi:noNamespaceSchemaLocation="https://raw.githubusercontent.com/PHPCSStandards/PHP_CodeSniffer/master/phpcs.xsd">
+
+</ruleset>