adds path concatenation

Author: filecage

src/Components/Path.php

@@ -74,9 +74,10 @@ function getParts () : array {
             return $this->parts;
         }
 
-        /**
-         * @return Path
-         */
+        function getFileExtension () : string {
+            return $this->fileExtension;
+        }
+
         function withFileExtensionRemoved () : Path {
             $path = (string) $this;
             $pathInfo = pathinfo($path);
@@ -92,11 +93,18 @@ function withFileExtensionRemoved () : Path {
             return self::createFromString($pathWithoutFileExtension);
         }
 
-        /**
-         * @return string
-         */
-        function getFileExtension () {
-            return $this->fileExtension;
+        function concat (Path $path) : Path {
+            $next = clone $this;
+            $next->hasTail = $path->hasTail;
+            $next->fileExtension = $path->fileExtension;
+            $next->parts = array_merge($next->parts, $path->parts);
+
+            // The only time we inherit absoluteness is if this path was empty
+            if (empty($this->parts)) {
+                $next->absolute = $path->absolute;
+            }
+
+            return $next;
         }
 
         /**

tests/PathComponentTest.php

@@ -135,4 +135,33 @@ function provideEncodablePathStrings () : \Generator {
             yield '/foo%2Fbar/baz/' => ['/foo%2Fbar/baz/', '/foo%2fbar/baz/'];
         }
 
+        /**
+         * @param string $expectedPath
+         * @param string $initialPath
+         * @param string ...$concatPaths
+         *
+         * @dataProvider provideConcatPaths
+         */
+        function testExpectsPathsToBeConcatenated (string $expectedPath, string $expectedFileExtension, bool $expectedIsAbsolute, bool $expectedHasTail, string $initialPath, string ...$concatPaths) {
+            $path = Path::createFromString($initialPath);
+            foreach ($concatPaths as $concatPath) {
+                $path = $path->concat(Path::createFromString($concatPath));
+            }
+
+            $this->assertSame($expectedPath, $path->compose());
+            $this->assertSame($expectedFileExtension, $path->getFileExtension());
+            $this->assertSame($expectedIsAbsolute, $path->isAbsolute());
+            $this->assertSame($expectedHasTail, $path->hasTail());
+        }
+
+        function provideConcatPaths () : \Generator {
+            yield ['/foo/bar', '', true, false, '/foo', '/bar'];
+            yield ['/foo/bar', '', true, false, '/foo', 'bar'];
+            yield ['foo/bar', '', false, false, 'foo', 'bar'];
+            yield ['/foo', '', true, false, '', '/foo'];
+            yield ['/foo/bar/', '', true, true, '', '/foo', 'bar/'];
+            yield ['/foo/bar', '', true, false, '/foo/', '/bar'];
+            yield ['/foo.php/bar.html', 'html', true, false, '/foo.php', 'bar.html'];
+        }
+
     }