feat: route_params::is_method

Author: vinniefalco

include/boost/http_proto/server/router.hpp

@@ -16,6 +16,8 @@
 namespace boost {
 namespace http_proto {
 
+struct route_params;
+
 /** A router for HTTP servers
 
     This is a specialization of `basic_router` using

include/boost/http_proto/server/router_types.hpp

@@ -299,6 +299,20 @@ class basic_router;
 class route_params_base
 {
 public:
+    /** Return true if the request method matches `m`
+    */
+    bool is_method(
+        http_proto::method m) const noexcept
+    {
+        return verb_ == m;
+    }
+
+    /** Return true if the request method matches `s`
+    */
+    BOOST_HTTP_PROTO_DECL
+    bool is_method(
+        core::string_view s) const noexcept;
+
     /** The mount path of the current router
 
         This is the portion of the request path

src/server/router_types.cpp

@@ -8,6 +8,7 @@
 //
 
 #include <boost/http_proto/server/router_types.hpp>
+#include <boost/url/grammar/ci_string.hpp>
 #include <boost/assert.hpp>
 #include <cstring>
 
@@ -78,5 +79,16 @@ do_detach()
     detail::throw_logic_error();
 }
 
+bool
+route_params_base::
+is_method(
+    core::string_view s) const noexcept
+{
+    auto m = http_proto::string_to_method(s);
+    if(m != http_proto::method::unknown)
+        return verb_ == m;
+    return s == verb_str_;
+}
+
 } // http_proto
 } // boost

test/unit/server/router_types.cpp

@@ -1,5 +1,5 @@
 //
-// Copyright (c) 2025 Vinnie Falco (vinnie dot falco at gmail dot com)
+// Copyright (c) 2025 Vinnie Falco (vinnie.falco@gmail.com)
 //
 // Distributed under the Boost Software License, Version 1.0. (See accompanying
 // file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
@@ -9,3 +9,39 @@
 
 // Test that header file is self-contained.
 #include <boost/http_proto/server/router_types.hpp>
+#include <boost/http_proto/server/router.hpp>
+
+#include "test_suite.hpp"
+
+namespace boost {
+namespace http_proto {
+
+struct router_types_test
+{
+    void
+    run()
+    {
+        basic_router<route_params_base> r;
+        r.add(http_proto::method::post, "/",
+            [](route_params_base& rp) ->
+                route_result
+            {
+                BOOST_TEST(  rp.is_method(http_proto::method::post));
+                BOOST_TEST(! rp.is_method(http_proto::method::get));
+                BOOST_TEST(! rp.is_method("GET"));
+                BOOST_TEST(! rp.is_method("Post"));
+                BOOST_TEST(  rp.is_method("POST"));
+                return route::send;
+            });
+        route_params_base rp;
+        auto rv = r.dispatch("POST", "/", rp);
+        BOOST_TEST(rv = route::send);
+    }
+};
+
+TEST_SUITE(
+    router_types_test,
+    "boost.http_proto.server.router_types");
+
+} // http_proto
+} // boost