adds method to add path segments to URI

Author: filecage

src/Uri.php

@@ -207,6 +207,18 @@ function withPath ($path) : static {
             return $instance;
         }
 
+        function withPathAdded (string $addedPath) : static {
+            $instance = clone $this;
+            $addedPath = Parse::parsePath($addedPath);
+            if ($instance->path !== null) {
+                $instance->path = $instance->path->concat($addedPath);
+            } else {
+                $instance->path = $addedPath;
+            }
+
+            return $instance;
+        }
+
         /**
          * @throws InvalidArgumentException
          * @param string $scheme

tests/UriTest.php

@@ -193,4 +193,20 @@ function provideSetterMethodsWithInvalidTypes () : \Generator {
         yield 'fragment' => ['withFragment'];
     }
 
+    function testExpectsUriWithAddedPath () {
+        $uri = new Uri('https://www.example.com/foo');
+        $uri = $uri->withPathAdded('/bar');
+
+        $this->assertSame('https://www.example.com/foo/bar', $uri->compose());
+        $this->assertSame('/foo/bar', $uri->getPath());
+    }
+
+    function testExpectsUriWithAddedPathEvenIfPathWasEmptyBefore () {
+        $uri = new Uri('https://www.example.com');
+        $uri = $uri->withPathAdded('/foo/bar');
+
+        $this->assertSame('https://www.example.com/foo/bar', $uri->compose());
+        $this->assertSame('/foo/bar', $uri->getPath());
+    }
+
 }