Add optional argument to getPath method for building of real route path strings

Author: philipobenito

src/Route.php

@@ -180,11 +180,19 @@ public function setParentGroup(RouteGroup $group): self
     /**
      * Get the path
      *
+     * @param array $replacements
+     *
      * @return string
      */
-    public function getPath(): string
+    public function getPath(array $replacements = []): string
     {
-        return $this->path;
+        $toReplace = [];
+
+        foreach ($replacements as $wildcard => $actual) {
+            $toReplace['/{' . preg_quote($wildcard, '/') . '(:.*?)?}/'] = $actual;
+        }
+
+        return preg_replace(array_keys($toReplace), array_values($toReplace), $this->path);
     }
 
     /**

tests/RouteTest.php

@@ -167,4 +167,22 @@ public function process(
             $middleware, $middleware
         ], $route->getMiddlewareStack());
     }
+
+    /**
+     * Asserts that passing actual values to getPath replaces the wildcards.
+     *
+     * @return void
+     */
+    public function testGetPathReplacesWildcards()
+    {
+        $route = new Route('GET', '/a/{wildcard}/and/{wildcardWithMatcher:uuid}', function () {
+        });
+
+        $path = $route->getPath([
+            'wildcard'            => 'replaced-wildcard',
+            'wildcardWithMatcher' => 'replaced-wildcard-with-matcher',
+        ]);
+
+        $this->assertSame('/a/replaced-wildcard/and/replaced-wildcard-with-matcher', $path);
+    }
 }