Added docs and example about **params

Author: michalpokusa

docs/examples.rst

@@ -180,6 +180,8 @@ In the example below the second route has only one URL parameter, so the ``actio
 Keep in mind that URL parameters are always passed as strings, so you need to convert them to the desired type.
 Also note that the names of the function parameters **have to match** with the ones used in route, but they **do not have to** be in the same order.
 
+Alternatively you can use e.g. ``**params`` to get all the parameters as a dictionary and access them using ``params['parameter_name']``.
+
 It is also possible to specify a wildcard route:
 
 - ``...`` - matches one path segment, e.g ``/api/...`` will match ``/api/123``, but **not** ``/api/123/456``
@@ -189,7 +191,7 @@ In both cases, wildcards will not match empty path segment, so ``/api/.../users`
 
 .. literalinclude:: ../examples/httpserver_url_parameters.py
     :caption: examples/httpserver_url_parameters.py
-    :emphasize-lines: 30-34,53-54
+    :emphasize-lines: 30-34,53-54,65-66
     :linenos:
 
 Authentication

examples/httpserver_url_parameters.py

@@ -50,6 +50,18 @@ def perform_action(
     )
 
 
+@server.route("/device/<device_id>/status/<date>")
+def device_status_on_date(request: Request, **params: dict):
+    """
+    Return the status of a specified device between two dates.
+    """
+
+    device_id = params.get("device_id")
+    date = params.get("date")
+
+    return Response(request, f"Status of {device_id} on {date}: ...")
+
+
 @server.route("/device/.../status", append_slash=True)
 @server.route("/device/....", append_slash=True)
 def device_status(request: Request):