add \Astrotomic\PhpunitAssertions\PathAssertions

Author: Gummibeer

README.md

@@ -137,6 +137,15 @@ This will prevent any method name conflicts with core, your custom or other trai
 \Astrotomic\PhpunitAssertions\UrlAssertions::assertComponent('gummibeer', 'https://gummibeer@astrotomic.info', PHP_URL_USER);
 ```
 
+### Path
+
+```php
+\Astrotomic\PhpunitAssertions\PathAssertions::assertDirname('/foo/bar', '/foo/bar/image.jpg');
+\Astrotomic\PhpunitAssertions\PathAssertions::assertBasename('image.jpg', '/foo/bar/image.jpg');
+\Astrotomic\PhpunitAssertions\PathAssertions::assertFilename('image', '/foo/bar/image.jpg');
+\Astrotomic\PhpunitAssertions\PathAssertions::assertExtension('jpg', '/foo/bar/image.jpg');
+```
+
 ### UUID
 
 `composer require --dev ramsey/uuid:^4.0`

phpunit.xml.dist

@@ -1,5 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<phpunit bootstrap="vendor/autoload.php"
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/9.3/phpunit.xsd"
+         bootstrap="vendor/autoload.php"
          backupGlobals="false"
          backupStaticAttributes="false"
          colors="true"
@@ -8,16 +10,15 @@
          convertNoticesToExceptions="true"
          convertWarningsToExceptions="true"
          processIsolation="false"
-         stopOnFailure="false"
->
+         stopOnFailure="false">
     <testsuites>
         <testsuite name="Test Suite">
             <directory>tests</directory>
         </testsuite>
     </testsuites>
-    <filter>
-        <whitelist>
+    <coverage>
+        <include>
             <directory suffix=".php">src/</directory>
-        </whitelist>
-    </filter>
+        </include>
+    </coverage>
 </phpunit>

src/PathAssertions.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace Astrotomic\PhpunitAssertions;
+
+use PHPUnit\Framework\Assert as PHPUnit;
+
+final class PathAssertions
+{
+    public static function assertDirname(string $expected, $actual): void
+    {
+        self::assertComponent($expected, $actual, PATHINFO_DIRNAME);
+    }
+
+    public static function assertBasename(string $expected, $actual): void
+    {
+        self::assertComponent($expected, $actual, PATHINFO_BASENAME);
+    }
+
+    public static function assertFilename(string $expected, $actual): void
+    {
+        self::assertComponent($expected, $actual, PATHINFO_FILENAME);
+    }
+
+    public static function assertExtension(string $expected, $actual): void
+    {
+        self::assertComponent($expected, $actual, PATHINFO_EXTENSION);
+    }
+
+    public static function assertComponent($expected, $actual, int $component): void
+    {
+        PHPUnit::assertIsString($actual);
+        PHPUnit::assertSame($expected, pathinfo($actual, $component));
+    }
+}

tests/PathAssertionsTest.php

@@ -0,0 +1,60 @@
+<?php
+
+namespace Astrotomic\PhpunitAssertions\Tests;
+
+use Astrotomic\PhpunitAssertions\PathAssertions;
+
+final class PathAssertionsTest extends TestCase
+{
+    /**
+     * @test
+     * @dataProvider hundredTimes
+     */
+    public static function it_can_validate_dirname(): void
+    {
+        $directory = '/'.self::randomString().'/'.self::randomString();
+        $filename = self::randomString();
+        $extension = self::randomString(3);
+
+        PathAssertions::assertDirname($directory, $directory.'/'.$filename.'.'.$extension);
+    }
+
+    /**
+     * @test
+     * @dataProvider hundredTimes
+     */
+    public static function it_can_validate_basename(): void
+    {
+        $directory = '/'.self::randomString().'/'.self::randomString();
+        $filename = self::randomString();
+        $extension = self::randomString(3);
+
+        PathAssertions::assertBasename($filename.'.'.$extension, $directory.'/'.$filename.'.'.$extension);
+    }
+
+    /**
+     * @test
+     * @dataProvider hundredTimes
+     */
+    public static function it_can_validate_filename(): void
+    {
+        $directory = '/'.self::randomString().'/'.self::randomString();
+        $filename = self::randomString();
+        $extension = self::randomString(3);
+
+        PathAssertions::assertFilename($filename, $directory.'/'.$filename.'.'.$extension);
+    }
+
+    /**
+     * @test
+     * @dataProvider hundredTimes
+     */
+    public static function it_can_validate_extension(): void
+    {
+        $directory = '/'.self::randomString().'/'.self::randomString();
+        $filename = self::randomString();
+        $extension = self::randomString(3);
+
+        PathAssertions::assertExtension($extension, $directory.'/'.$filename.'.'.$extension);
+    }
+}

tests/Utils/Randomize.php

@@ -39,15 +39,15 @@ protected static function randomArray(int $count, bool $assoc = false): array
         $array = array_fill(0, $count, null);
 
         $array = array_map(static function (): string {
-            return self::randomString(self::randomInt(4, 64));
+            return self::randomString(self::randomInt(8, 64));
         }, $array);
 
         if ($assoc) {
             $values = $array;
             $array = [];
 
             foreach ($values as $value) {
-                $array[self::randomString(self::randomInt(4, 64))] = $value;
+                $array[self::randomString(self::randomInt(8, 64))] = $value;
             }
         }