allows casting route params

Author: mlebkowski

Readme.md

@@ -188,10 +188,10 @@ $requestParams = WonderNetwork\SlimKernel\Http\RequestParams::of($serverRequest)
 $requestParams->post->requireString('userId'); 
 $requestParams->query->int('limit', 10); 
 $requestParams->server->bool('HTTPS');
-// simpler interface, since route arguments are all string:
-WonderNetwork\SlimKernel\Http\RouteArgument::get($serverRequest, 'userId');
-WonderNetwork\SlimKernel\Http\RouteArgument::find($serverRequest, 'userId');
-WonderNetwork\SlimKernel\Http\RouteArgument::maybe($serverRequest, 'userId');
+// route arguments are all string, but you can still cast them to ints
+$routeArguments = WonderNetwork\SlimKernel\Http\RouteArgument::of($serverRequest);
+$routeArguments->string('token');
+$routeArguments->int('limit', 10);
 // CLI
 $cliParams = WonderNetwork\SlimKernel\Cli\InputParams::ofInput($input);
 $cliParams->options
@@ -211,7 +211,7 @@ it throws if it encounters some unexpected input.
    arguments and options. Each field is returned as an [Array Accessor](#array-accessor)
 
  * _Route Argument_: created from `RequestInterface` and represent the arguments
-   matched by slim routing. 
+   matched by slim routing. Returns a single [Array Accessor](#array-accessor)
 
 ### Array Accessor
 

src/Http/RouteArgument.php

@@ -6,28 +6,39 @@
 use Psr\Http\Message\ServerRequestInterface;
 use Slim\Exception\HttpBadRequestException;
 use Slim\Routing\RouteContext;
+use WonderNetwork\SlimKernel\Accessor\ArrayAccessor;
 
 final class RouteArgument {
+    public static function of(ServerRequestInterface $request): ArrayAccessor {
+        $route = RouteContext::fromRequest($request)->getRoute();
+        if (null === $route) {
+            throw new HttpBadRequestException($request, "Route is not initialized on request");
+        }
+
+        return ArrayAccessor::of(
+            $route->getArguments(),
+            fn (string $message) => new HttpBadRequestException($request, $message),
+        );
+    }
+
+    /**
+     * @deprecated use self::of($request)->string($name)
+     */
     public static function maybe(ServerRequestInterface $request, string $name): string {
-        return self::find($request, $name) ?? '';
+        return self::of($request)->string($name);
     }
 
+    /**
+     * @deprecated use self::of($request)->maybeString($name)
+     */
     public static function find(ServerRequestInterface $request, string $name): ?string {
-        $route = RouteContext::fromRequest($request)->getRoute();
-        if (null === $route) {
-            throw new HttpBadRequestException(
-                $request,
-                "Route is not initialized on request while accessing $name",
-            );
-        }
-        return $route->getArgument($name);
+        return self::of($request)->maybeString($name);
     }
 
+    /**
+     * @deprecated use self::of($request)->requireString($name)
+     */
     public static function get(ServerRequestInterface $request, string $name): string {
-        $value = self::find($request, $name);
-        if (null === $value) {
-            throw new HttpBadRequestException($request, "Route argument $name not found");
-        }
-        return $value;
+        return self::of($request)->requireString($name);
     }
 }