[FEATURE] #82

Ignore coverage for the last line of the globstar function, since it's only used if the glob function returns an error.
Added a test to validate the behaviour of the globstar function when passing non existant glob pattern.
Fixed code using php-cs-fixer.
Fixed error reported by phpstan.

Author: Nicolas D'Amours

src/Factory.php

@@ -13,11 +13,15 @@
 use function array_filter;
 use function array_map;
 use function array_merge;
+use function array_unique;
 use function array_values;
 use function glob;
 use function is_dir;
 use function is_string;
 use function realpath;
+use function sort;
+use function stripos;
+use function substr;
 use AppendIterator;
 use FilesystemIterator;
 use RecursiveDirectoryIterator;
@@ -106,39 +110,45 @@ private function resolveWildcards(array $paths): array
 
     /**
      * @see https://gist.github.com/funkjedi/3feee27d873ae2297b8e2370a7082aad
-     * @param string $pattern
-     * @return list<non-empty-string>
+     *
+     * @return list<string>
      */
-    private function globstar(string $pattern) {
+    private function globstar(string $pattern)
+    {
         if (stripos($pattern, '**') === false) {
             $files = glob($pattern, GLOB_ONLYDIR);
         } else {
-            $position = stripos($pattern, '**');
+            $position    = stripos($pattern, '**');
             $rootPattern = substr($pattern, 0, $position - 1);
             $restPattern = substr($pattern, $position + 2);
 
-            $patterns = [$rootPattern.$restPattern];
+            $patterns = [$rootPattern . $restPattern];
             $rootPattern .= '/*';
 
-            while($dirs = glob($rootPattern, GLOB_ONLYDIR)) {
+            while ($dirs = glob($rootPattern, GLOB_ONLYDIR)) {
                 $rootPattern .= '/*';
-                foreach($dirs as $dir) {
+
+                foreach ($dirs as $dir) {
                     $patterns[] = $dir . $restPattern;
                 }
             }
 
             $files = [];
-            foreach($patterns as $pat) {
+
+            foreach ($patterns as $pat) {
                 $files = array_merge($files, $this->globstar($pat));
             }
         }
 
-        if($files !== false) {
+        if ($files !== false) {
             $files = array_unique($files);
             sort($files);
+
             return $files;
         }
 
+        // @codeCoverageIgnoreStart
         return [];
+        // @codeCoverageIgnoreEnd
     }
 }

tests/fixture/a/c/d/i/PrefixSuffix.php

@@ -1 +1,9 @@
-<?php
+<?php declare(strict_types=1);
+/*
+ * This file is part of phpunit/php-file-iterator.
+ *
+ * (c) Sebastian Bergmann <sebastian@phpunit.de>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */

tests/fixture/b/e/g/i/PrefixSuffix.php

@@ -1 +1,9 @@
-<?php
+<?php declare(strict_types=1);
+/*
+ * This file is part of phpunit/php-file-iterator.
+ *
+ * (c) Sebastian Bergmann <sebastian@phpunit.de>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */

tests/fixture/b/e/i/PrefixSuffix.php

@@ -1 +1,9 @@
-<?php
+<?php declare(strict_types=1);
+/*
+ * This file is part of phpunit/php-file-iterator.
+ *
+ * (c) Sebastian Bergmann <sebastian@phpunit.de>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */

tests/fixture/b/f/h/i/PrefixSuffix.php

@@ -1 +1,9 @@
-<?php
+<?php declare(strict_types=1);
+/*
+ * This file is part of phpunit/php-file-iterator.
+ *
+ * (c) Sebastian Bergmann <sebastian@phpunit.de>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */

tests/unit/FacadeTest.php

@@ -7,7 +7,6 @@
  * For the full copyright and license information, please view the LICENSE
  * file that was distributed with this source code.
  */
-
 namespace SebastianBergmann\FileIterator;
 
 use function realpath;
@@ -148,7 +147,14 @@ public static function provider(): array
                 __DIR__ . '/../fixture/**/i',
                 '',
                 '',
-                []
+                [],
+            ],
+            'invalid path, filter prefix: no, filter suffix: no, excludes: none' => [
+                [],
+                __DIR__ . '/../fixture/**/this/path/does/not/exists',
+                '',
+                '',
+                [],
             ],
         ];
     }