Merge pull request #5 from crosa7/feature-get-route-by-name

Feature: Get route by name

src/Router.php

@@ -324,4 +324,20 @@ public static function push($route, ?array $data = null)
 
         return header("location: $route$data");
     }
+
+    /**
+     * Get route url by defined route name
+     *
+     * @param string $routeName
+     *
+     * @return string
+     */
+    public static function route(string $routeName): string
+    {
+        if (!isset(static::$namedRoutes[$routeName])) {
+            trigger_error('Route named ' . $routeName . ' not found');
+        }
+
+        return static::$namedRoutes[$routeName];
+    }
 }

tests/routes.test.php

@@ -108,3 +108,18 @@ class TRoute
 
     expect(TRoute::$val)->toBe(false);
 });
+
+test('route should return url by route name', function () {
+    $router = new Router;
+    $router->match('GET', '/route/url', ['handler', 'name' => 'route-name']);
+
+    $routeUrl = $router->route('route-name');
+
+    expect($routeUrl)->toBe('/route/url');
+});
+
+test('route should throw exception if no route found for name', function () {
+    $router = new Router;
+
+    expect(fn() => $router->route('non-existent-route-name'))->toThrow(Exception::class);
+});