localstack-core 4.6.1.dev60__py3-none-any.whl → 4.10.1.dev12__py3-none-any.whl

localstack/aws/protocol/parser.py

@@ -19,22 +19,23 @@ The class hierarchy looks as follows:
                           │RequestParser│
                           └─────────────┘
                              ▲   ▲   ▲
-           ┌─────────────────┘   │   └────────────────────┐
-  ┌────────┴─────────┐ ┌─────────┴───────────┐ ┌──────────┴──────────┐
-  │QueryRequestParser│ │BaseRestRequestParser│ │BaseJSONRequestParser│
-  └──────────────────┘ └─────────────────────┘ └─────────────────────┘
-          ▲                    ▲            ▲   ▲           ▲
-  ┌───────┴────────┐ ┌─────────┴──────────┐ │   │           │
-  │EC2RequestParser│ │RestXMLRequestParser│ │   │           │
-  └────────────────┘ └────────────────────┘ │   │           │
-                           ┌────────────────┴───┴┐ ┌────────┴────────┐
-                           │RestJSONRequestParser│ │JSONRequestParser│
-                           └─────────────────────┘ └─────────────────┘
+           ┌─────────────────┘   │   └────────────────────┬───────────────────────┬───────────────────────┐
+  ┌────────┴─────────┐ ┌─────────┴───────────┐ ┌──────────┴──────────┐ ┌──────────┴──────────┐ ┌──────────┴───────────┐
+  │QueryRequestParser│ │BaseRestRequestParser│ │BaseJSONRequestParser│ │BaseCBORRequestParser│ │BaseRpcV2RequestParser│
+  └──────────────────┘ └─────────────────────┘ └─────────────────────┘ └─────────────────────┘ └──────────────────────┘
+          ▲                    ▲            ▲   ▲           ▲             ▲             ▲             ▲
+  ┌───────┴────────┐ ┌─────────┴──────────┐ │   │  ┌────────┴────────┐    │         ┌───┴─────────────┴────┐
+  │EC2RequestParser│ │RestXMLRequestParser│ │   │  │JSONRequestParser│    │         │RpcV2CBORRequestParser│
+  └────────────────┘ └────────────────────┘ │   │  └─────────────────┘    │         └──────────────────────┘
+                           ┌────────────────┴───┴┐                 ▲      │
+                           │RestJSONRequestParser│             ┌───┴──────┴──────┐
+                           └─────────────────────┘             │CBORRequestParser│
+                                                               └─────────────────┘
 ::
 
 The ``RequestParser`` contains the logic that is used among all the
 different protocols (``query``, ``json``, ``rest-json``, ``rest-xml``,
-and ``ec2``).
+``cbor`` and ``ec2``).
 The relation between the different protocols is described in the
 ``serializer``.
 
@@ -44,13 +45,21 @@ The classes are structured as follows:
   which is shared among all different protocols.
 * The ``BaseRestRequestParser`` contains the logic for the REST
   protocol specifics (i.e. specific HTTP metadata parsing).
+* The ``BaseRpcV2RequestParser`` contains the logic for the RPC v2
+  protocol specifics (special path routing, no logic about body decoding)
 * The ``BaseJSONRequestParser`` contains the logic for the JSON body
   parsing.
+* The ``BaseCBORRequestParser`` contains the logic for the CBOR body
+  parsing.
 * The ``RestJSONRequestParser`` inherits the ReST specific logic from
   the ``BaseRestRequestParser`` and the JSON body parsing from the
   ``BaseJSONRequestParser``.
-* The ``QueryRequestParser``, ``RestXMLRequestParser``, and the
-  ``JSONRequestParser`` have a conventional inheritance structure.
+* The ``CBORRequestParser`` inherits the ``json``-protocol specific
+  logic from the ``JSONRequestParser`` and the CBOR body parsing
+  from the ``BaseCBORRequestParser``.
+* The ``QueryRequestParser``, ``RestXMLRequestParser``,
+  ``RpcV2CBORRequestParser`` and ``JSONRequestParser`` have a
+  conventional inheritance structure.
 
 The services and their protocols are defined by using AWS's Smithy
 (a language to define services in a - somewhat - protocol-agnostic
@@ -66,10 +75,14 @@ import abc
 import base64
 import datetime
 import functools
+import io
+import os
 import re
+import struct
 from abc import ABC
+from collections.abc import Mapping
 from email.utils import parsedate_to_datetime
-from typing import IO, Any, Dict, List, Mapping, Optional, Tuple, Union
+from typing import IO, Any
 from xml.etree import ElementTree as ETree
 
 import dateutil.parser
@@ -88,6 +101,7 @@ from cbor2._decoder import loads as cbor2_loads
 from werkzeug.exceptions import BadRequest, NotFound
 
 from localstack.aws.protocol.op_router import RestServiceOperationRouter
+from localstack.aws.spec import ProtocolName
 from localstack.http import Request
 
 
@@ -107,7 +121,7 @@ def _text_content(func):
         self,
         request: Request,
         shape: Shape,
-        node_or_string: Union[ETree.Element, str],
+        node_or_string: ETree.Element | str,
         uri_params: Mapping[str, Any] = None,
     ):
         if hasattr(node_or_string, "text"):
@@ -203,7 +217,7 @@ class RequestParser(abc.ABC):
         self.service = service
 
     @_handle_exceptions
-    def parse(self, request: Request) -> Tuple[OperationModel, Any]:
+    def parse(self, request: Request) -> tuple[OperationModel, Any]:
         """
         Determines which operation the request was aiming for and parses the incoming request such that the resulting
         dictionary can be used to invoke the service's function implementation.
@@ -233,13 +247,21 @@ class RequestParser(abc.ABC):
         if location is not None:
             if location == "header":
                 header_name = shape.serialization.get("name")
-                payload = request.headers.get(header_name)
-                if payload and shape.type_name == "list":
+                if shape.type_name == "list":
                     # headers may contain a comma separated list of values (e.g., the ObjectAttributes member in
                     # s3.GetObjectAttributes), so we prepare it here for the handler, which will be `_parse_list`.
                     # Header lists can contain optional whitespace, so we strip it
                     # https://www.rfc-editor.org/rfc/rfc9110.html#name-lists-rule-abnf-extension
-                    payload = [value.strip() for value in payload.split(",")]
+                    # It can also directly contain a list of headers
+                    # See https://datatracker.ietf.org/doc/html/rfc2616
+                    payload = request.headers.getlist(header_name) or None
+                    if payload:
+                        headers = ",".join(payload)
+                        payload = [value.strip() for value in headers.split(",")]
+
+                else:
+                    payload = request.headers.get(header_name)
+
             elif location == "headers":
                 payload = self._parse_header_map(shape, request.headers)
                 # shapes with the location trait "headers" only contain strings and are not further processed
@@ -256,12 +278,12 @@ class RequestParser(abc.ABC):
                 if uri_param_name in uri_params:
                     payload = uri_params[uri_param_name]
             else:
-                raise UnknownParserError("Unknown shape location '%s'." % location)
+                raise UnknownParserError(f"Unknown shape location '{location}'.")
         else:
             # If we don't have to use a specific location, we use the node
             payload = node
 
-        fn_name = "_parse_%s" % shape.type_name
+        fn_name = f"_parse_{shape.type_name}"
         handler = getattr(self, fn_name, self._noop_parser)
         try:
             return handler(request, shape, payload, uri_params) if payload is not None else None
@@ -313,7 +335,7 @@ class RequestParser(abc.ABC):
             return True
         if value == "false":
             return False
-        raise ValueError("cannot parse boolean value %s" % node)
+        raise ValueError(f"cannot parse boolean value {node}")
 
     @_text_content
     def _noop_parser(self, _, __, node: Any, ___):
@@ -323,11 +345,11 @@ class RequestParser(abc.ABC):
     _parse_double = _parse_float
     _parse_long = _parse_integer
 
-    def _convert_str_to_timestamp(self, value: str, timestamp_format=None):
+    def _convert_str_to_timestamp(self, value: str, timestamp_format=None) -> datetime.datetime:
         if timestamp_format is None:
             timestamp_format = self.TIMESTAMP_FORMAT
         timestamp_format = timestamp_format.lower()
-        converter = getattr(self, "_timestamp_%s" % timestamp_format)
+        converter = getattr(self, f"_timestamp_{timestamp_format}")
         final_value = converter(value)
         return final_value
 
@@ -337,11 +359,11 @@ class RequestParser(abc.ABC):
 
     @staticmethod
     def _timestamp_unixtimestamp(timestamp_string: str) -> datetime.datetime:
-        return datetime.datetime.utcfromtimestamp(int(timestamp_string))
+        return datetime.datetime.fromtimestamp(int(timestamp_string), tz=datetime.UTC)
 
     @staticmethod
     def _timestamp_unixtimestampmillis(timestamp_string: str) -> datetime.datetime:
-        return datetime.datetime.utcfromtimestamp(float(timestamp_string) / 1000)
+        return datetime.datetime.fromtimestamp(float(timestamp_string) / 1000, tz=datetime.UTC)
 
     @staticmethod
     def _timestamp_rfc822(datetime_string: str) -> datetime.datetime:
@@ -367,7 +389,7 @@ class QueryRequestParser(RequestParser):
     """
 
     @_handle_exceptions
-    def parse(self, request: Request) -> Tuple[OperationModel, Any]:
+    def parse(self, request: Request) -> tuple[OperationModel, Any]:
         instance = request.values
         if "Action" not in instance:
             raise ProtocolParserError(
@@ -510,7 +532,7 @@ class QueryRequestParser(RequestParser):
 
         # We collect the list value as well as the integer indicating the list position so we can
         # later sort the list by the position, in case they attribute values are unordered
-        result: List[Tuple[int, Any]] = []
+        result: list[tuple[int, Any]] = []
 
         i = 0
         while True:
@@ -559,7 +581,7 @@ class BaseRestRequestParser(RequestParser):
         self._operation_router = RestServiceOperationRouter(service)
 
     @_handle_exceptions
-    def parse(self, request: Request) -> Tuple[OperationModel, Any]:
+    def parse(self, request: Request) -> tuple[OperationModel, Any]:
         try:
             operation, uri_params = self._operation_router.match(request)
         except NotFound as e:
@@ -578,7 +600,7 @@ class BaseRestRequestParser(RequestParser):
         self,
         request: Request,
         shape: Shape,
-        member_shapes: Dict[str, Shape],
+        member_shapes: dict[str, Shape],
         uri_params: Mapping[str, Any],
         final_parsed: dict,
     ) -> None:
@@ -662,7 +684,7 @@ class RestXMLRequestParser(BaseRestRequestParser):
     """
 
     def __init__(self, service_model: ServiceModel):
-        super(RestXMLRequestParser, self).__init__(service_model)
+        super().__init__(service_model)
         self.ignore_get_body_errors = True
         self._namespace_re = re.compile("{.*}")
 
@@ -731,7 +753,7 @@ class RestXMLRequestParser(BaseRestRequestParser):
                 elif tag_name == value_location_name:
                     val_name = self._parse_shape(request, value_shape, single_pair, uri_params)
                 else:
-                    raise ProtocolParserError("Unknown tag: %s" % tag_name)
+                    raise ProtocolParserError(f"Unknown tag: {tag_name}")
             parsed[key_name] = val_name
         return parsed
 
@@ -749,7 +771,7 @@ class RestXMLRequestParser(BaseRestRequestParser):
         # it's flattened, and if it's not, then we make it a one element list.
         if shape.serialization.get("flattened") and not isinstance(node, list):
             node = [node]
-        return super(RestXMLRequestParser, self)._parse_list(request, shape, node, uri_params)
+        return super()._parse_list(request, shape, node, uri_params)
 
     def _node_tag(self, node: ETree.Element) -> str:
         return self._namespace_re.sub("", node.tag)
@@ -777,11 +799,11 @@ class RestXMLRequestParser(BaseRestRequestParser):
             root = parser.close()
         except ETree.ParseError as e:
             raise ProtocolParserError(
-                "Unable to parse request (%s), invalid XML received:\n%s" % (e, xml_string)
+                f"Unable to parse request ({e}), invalid XML received:\n{xml_string}"
             ) from e
         return root
 
-    def _build_name_to_xml_node(self, parent_node: Union[list, ETree.Element]) -> dict:
+    def _build_name_to_xml_node(self, parent_node: list | ETree.Element) -> dict:
         # If the parent node is actually a list. We should not be trying
         # to serialize it to a dictionary. Instead, return the first element
         # in the list.
@@ -824,9 +846,9 @@ class BaseJSONRequestParser(RequestParser, ABC):
         self,
         request: Request,
         shape: StructureShape,
-        value: Optional[dict],
+        value: dict | None,
         uri_params: Mapping[str, Any] = None,
-    ) -> Optional[dict]:
+    ) -> dict | None:
         if shape.is_document_type:
             final_parsed = value
         else:
@@ -849,9 +871,9 @@ class BaseJSONRequestParser(RequestParser, ABC):
         self,
         request: Request,
         shape: MapShape,
-        value: Optional[dict],
+        value: dict | None,
         uri_params: Mapping[str, Any] = None,
-    ) -> Optional[dict]:
+    ) -> dict | None:
         if value is None:
             return None
         parsed = {}
@@ -916,7 +938,7 @@ class JSONRequestParser(BaseJSONRequestParser):
     """
 
     @_handle_exceptions
-    def parse(self, request: Request) -> Tuple[OperationModel, Any]:
+    def parse(self, request: Request) -> tuple[OperationModel, Any]:
         target = request.headers["X-Amz-Target"]
         # assuming that the last part of the target string (e.g., "x.y.z.MyAction") contains the operation name
         operation_name = target.rpartition(".")[2]
@@ -967,6 +989,405 @@ class RestJSONRequestParser(BaseRestRequestParser, BaseJSONRequestParser):
         raise NotImplementedError
 
 
+class BaseCBORRequestParser(RequestParser, ABC):
+    """
+    The ``BaseCBORRequestParser`` is the base class for all CBOR-based AWS service protocols.
+    This base-class handles parsing the payload / body as CBOR.
+    """
+
+    INDEFINITE_ITEM_ADDITIONAL_INFO = 31
+    BREAK_CODE = 0xFF
+    # timestamp format for requests with CBOR content type
+    TIMESTAMP_FORMAT = "unixtimestamp"
+
+    @functools.cached_property
+    def major_type_to_parsing_method_map(self):
+        return {
+            0: self._parse_type_unsigned_integer,
+            1: self._parse_type_negative_integer,
+            2: self._parse_type_byte_string,
+            3: self._parse_type_text_string,
+            4: self._parse_type_array,
+            5: self._parse_type_map,
+            6: self._parse_type_tag,
+            7: self._parse_type_simple_and_float,
+        }
+
+    @staticmethod
+    def get_peekable_stream_from_bytes(_bytes: bytes) -> io.BufferedReader:
+        return io.BufferedReader(io.BytesIO(_bytes))
+
+    def parse_data_item(self, stream: io.BufferedReader) -> Any:
+        # CBOR data is divided into "data items", and each data item starts
+        # with an initial byte that describes how the following bytes should be parsed
+        initial_byte = self._read_bytes_as_int(stream, 1)
+        # The highest order three bits of the initial byte describe the CBOR major type
+        major_type = initial_byte >> 5
+        # The lowest order 5 bits of the initial byte tells us more information about
+        # how the bytes should be parsed that will be used
+        additional_info: int = initial_byte & 0b00011111
+
+        if major_type in self.major_type_to_parsing_method_map:
+            method = self.major_type_to_parsing_method_map[major_type]
+            return method(stream, additional_info)
+        else:
+            raise ProtocolParserError(
+                f"Unsupported initial byte found for data item- "
+                f"Major type:{major_type}, Additional info: "
+                f"{additional_info}"
+            )
+
+    # Major type 0 - unsigned integers
+    def _parse_type_unsigned_integer(self, stream: io.BufferedReader, additional_info: int) -> int:
+        additional_info_to_num_bytes = {
+            24: 1,
+            25: 2,
+            26: 4,
+            27: 8,
+        }
+        # Values under 24 don't need a full byte to be stored; their values are
+        # instead stored as the "additional info" in the initial byte
+        if additional_info < 24:
+            return additional_info
+        elif additional_info in additional_info_to_num_bytes:
+            num_bytes = additional_info_to_num_bytes[additional_info]
+            return self._read_bytes_as_int(stream, num_bytes)
+        else:
+            raise ProtocolParserError(
+                "Invalid CBOR integer returned from the service; unparsable "
+                f"additional info found for major type 0 or 1: {additional_info}"
+            )
+
+    # Major type 1 - negative integers
+    def _parse_type_negative_integer(self, stream: io.BufferedReader, additional_info: int) -> int:
+        return -1 - self._parse_type_unsigned_integer(stream, additional_info)
+
+    # Major type 2 - byte string
+    def _parse_type_byte_string(self, stream: io.BufferedReader, additional_info: int) -> bytes:
+        if additional_info != self.INDEFINITE_ITEM_ADDITIONAL_INFO:
+            length = self._parse_type_unsigned_integer(stream, additional_info)
+            return self._read_from_stream(stream, length)
+        else:
+            chunks = []
+            while True:
+                if self._handle_break_code(stream):
+                    break
+                initial_byte = self._read_bytes_as_int(stream, 1)
+                additional_info = initial_byte & 0b00011111
+                length = self._parse_type_unsigned_integer(stream, additional_info)
+                chunks.append(self._read_from_stream(stream, length))
+            return b"".join(chunks)
+
+    # Major type 3 - text string
+    def _parse_type_text_string(self, stream: io.BufferedReader, additional_info: int) -> str:
+        return self._parse_type_byte_string(stream, additional_info).decode("utf-8")
+
+    # Major type 4 - lists
+    def _parse_type_array(self, stream: io.BufferedReader, additional_info: int) -> list:
+        if additional_info != self.INDEFINITE_ITEM_ADDITIONAL_INFO:
+            length = self._parse_type_unsigned_integer(stream, additional_info)
+            return [self.parse_data_item(stream) for _ in range(length)]
+        else:
+            items = []
+            while not self._handle_break_code(stream):
+                items.append(self.parse_data_item(stream))
+            return items
+
+    # Major type 5 - maps
+    def _parse_type_map(self, stream: io.BufferedReader, additional_info: int) -> dict:
+        items = {}
+        if additional_info != self.INDEFINITE_ITEM_ADDITIONAL_INFO:
+            length = self._parse_type_unsigned_integer(stream, additional_info)
+            for _ in range(length):
+                self._parse_type_key_value_pair(stream, items)
+            return items
+
+        else:
+            while not self._handle_break_code(stream):
+                self._parse_type_key_value_pair(stream, items)
+            return items
+
+    def _parse_type_key_value_pair(self, stream: io.BufferedReader, items: dict) -> None:
+        key = self.parse_data_item(stream)
+        value = self.parse_data_item(stream)
+        if value is not None:
+            items[key] = value
+
+    # Major type 6 is tags.  The only tag we currently support is tag 1 for unix
+    # timestamps
+    def _parse_type_tag(self, stream: io.BufferedReader, additional_info: int):
+        tag = self._parse_type_unsigned_integer(stream, additional_info)
+        value = self.parse_data_item(stream)
+        if tag == 1:  # Epoch-based date/time in milliseconds
+            return self._parse_type_datetime(value)
+        else:
+            raise ProtocolParserError(f"Found CBOR tag not supported by botocore: {tag}")
+
+    def _parse_type_datetime(self, value: int | float) -> datetime.datetime:
+        if isinstance(value, (int, float)):
+            return self._convert_str_to_timestamp(str(value))
+        else:
+            raise ProtocolParserError(f"Unable to parse datetime value: {value}")
+
+    # Major type 7 includes floats and "simple" types.  Supported simple types are
+    # currently boolean values, CBOR's null, and CBOR's undefined type.  All other
+    # values are either floats or invalid.
+    def _parse_type_simple_and_float(
+        self, stream: io.BufferedReader, additional_info: int
+    ) -> bool | float | None:
+        # For major type 7, values 20-23 correspond to CBOR "simple" values
+        additional_info_simple_values = {
+            20: False,  # CBOR false
+            21: True,  # CBOR true
+            22: None,  # CBOR null
+            23: None,  # CBOR undefined
+        }
+        # First we check if the additional info corresponds to a supported simple value
+        if additional_info in additional_info_simple_values:
+            return additional_info_simple_values[additional_info]
+
+        # If it's not a simple value, we need to parse it into the correct format and
+        # number fo bytes
+        float_formats = {
+            25: (">e", 2),
+            26: (">f", 4),
+            27: (">d", 8),
+        }
+
+        if additional_info in float_formats:
+            float_format, num_bytes = float_formats[additional_info]
+            return struct.unpack(float_format, self._read_from_stream(stream, num_bytes))[0]
+        raise ProtocolParserError(
+            f"Invalid additional info found for major type 7: {additional_info}.  "
+            f"This indicates an unsupported simple type or an indefinite float value"
+        )
+
+    @_text_content
+    def _parse_blob(self, _, __, node: bytes, ___) -> bytes:
+        return node
+
+    @_text_content
+    def _parse_timestamp(
+        self, _, shape: Shape, node: datetime.datetime | str, ___
+    ) -> datetime.datetime:
+        if isinstance(node, datetime.datetime):
+            return node
+        return super()._parse_timestamp(_, shape, node, ___)
+
+    @_text_content
+    def _parse_boolean(self, _, __, node: str | bool, ___) -> bool:
+        if isinstance(node, str):
+            value = node.lower()
+            if value == "true":
+                return True
+            if value == "false":
+                return False
+            raise ValueError(f"cannot parse boolean value {node}")
+        return node
+
+    # This helper method is intended for use when parsing indefinite length items.
+    # It does nothing if the next byte is not the break code.  If the next byte is
+    # the break code, it advances past that byte and returns True so the calling
+    # method knows to stop parsing that data item.
+    def _handle_break_code(self, stream: io.BufferedReader) -> bool | None:
+        if int.from_bytes(stream.peek(1)[:1], "big") == self.BREAK_CODE:
+            stream.seek(1, os.SEEK_CUR)
+            return True
+
+    def _read_bytes_as_int(self, stream: IO[bytes], num_bytes: int) -> int:
+        byte = self._read_from_stream(stream, num_bytes)
+        return int.from_bytes(byte, "big")
+
+    @staticmethod
+    def _read_from_stream(stream: IO[bytes], num_bytes: int) -> bytes:
+        value = stream.read(num_bytes)
+        if len(value) != num_bytes:
+            raise ProtocolParserError(
+                "End of stream reached; this indicates a "
+                "malformed CBOR response from the server or an "
+                "issue in botocore"
+            )
+        return value
+
+
+class CBORRequestParser(BaseCBORRequestParser, JSONRequestParser):
+    """
+    The ``CBORRequestParser`` is responsible for parsing incoming requests for services which use the ``cbor``
+    protocol.
+    The requests for these services encode the majority of their parameters as CBOR in the request body.
+    The operation is defined in an HTTP header field.
+    This protocol is not properly defined in the specs, but it is derived from the ``json`` protocol. Only Kinesis uses
+    it for now.
+    """
+
+    # timestamp format is different from traditional CBOR, and is encoded as a milliseconds integer
+    TIMESTAMP_FORMAT = "unixtimestampmillis"
+
+    def _do_parse(
+        self, request: Request, shape: Shape, uri_params: Mapping[str, Any] = None
+    ) -> dict:
+        parsed = {}
+        if shape is not None:
+            event_name = shape.event_stream_name
+            if event_name:
+                parsed = self._handle_event_stream(request, shape, event_name)
+            else:
+                self._parse_payload(request, shape, parsed, uri_params)
+        return parsed
+
+    def _handle_event_stream(self, request: Request, shape: Shape, event_name: str):
+        # TODO handle event streams
+        raise NotImplementedError
+
+    def _parse_payload(
+        self,
+        request: Request,
+        shape: Shape,
+        final_parsed: dict,
+        uri_params: Mapping[str, Any] = None,
+    ) -> None:
+        original_parsed = self._initial_body_parse(request)
+        body_parsed = self._parse_shape(request, shape, original_parsed, uri_params)
+        final_parsed.update(body_parsed)
+
+    def _initial_body_parse(self, request: Request) -> Any:
+        body_contents = request.data
+        if body_contents == b"":
+            return body_contents
+        body_contents_stream = self.get_peekable_stream_from_bytes(body_contents)
+        return self.parse_data_item(body_contents_stream)
+
+    def _parse_timestamp(
+        self, request: Request, shape: Shape, node: str, uri_params: Mapping[str, Any] = None
+    ) -> datetime.datetime:
+        # TODO: remove once CBOR support has been removed from `JSONRequestParser`
+        return super()._parse_timestamp(request, shape, node, uri_params)
+
+
+class BaseRpcV2RequestParser(RequestParser):
+    """
+    The ``BaseRpcV2RequestParser`` is the base class for all RPC V2-based AWS service protocols.
+    This base class handles the routing of the request, which is specific based on the path.
+    The body decoding is done in the respective subclasses.
+    """
+
+    @_handle_exceptions
+    def parse(self, request: Request) -> tuple[OperationModel, Any]:
+        # see https://smithy.io/2.0/additional-specs/protocols/smithy-rpc-v2.html
+        if request.method != "POST":
+            raise ProtocolParserError("RPC v2 only accepts POST requests.")
+
+        headers = request.headers
+        if "X-Amz-Target" in headers or "X-Amzn-Target" in headers:
+            raise ProtocolParserError(
+                "RPC v2 does not accept 'X-Amz-Target' or 'X-Amzn-Target'. "
+                "Such requests are rejected for security reasons."
+            )
+        # The Smithy RPCv2 CBOR protocol will only use the last four segments of the URL when routing requests.
+        rpc_v2_params = request.path.lstrip("/").split("/")
+        if len(rpc_v2_params) < 4 or not (
+            operation := self.service.operation_model(rpc_v2_params[-1])
+        ):
+            raise OperationNotFoundParserError(
+                f"Unable to find operation for request to service "
+                f"{self.service.service_name}: {request.method} {request.path}"
+            )
+
+        # there are no URI params in RPC v2
+        uri_params = {}
+        shape: StructureShape = operation.input_shape
+        final_parsed = self._do_parse(request, shape, uri_params)
+        return operation, final_parsed
+
+    @_handle_exceptions
+    def _do_parse(
+        self, request: Request, shape: Shape, uri_params: Mapping[str, Any] = None
+    ) -> dict[str, Any]:
+        parsed = {}
+        if shape is not None:
+            event_stream_name = shape.event_stream_name
+            if event_stream_name:
+                parsed = self._handle_event_stream(request, shape, event_stream_name)
+            else:
+                parsed = {}
+                self._parse_payload(request, shape, parsed, uri_params)
+
+        return parsed
+
+    def _handle_event_stream(self, request: Request, shape: Shape, event_name: str):
+        # TODO handle event streams
+        raise NotImplementedError
+
+    def _parse_structure(
+        self,
+        request: Request,
+        shape: StructureShape,
+        node: dict | None,
+        uri_params: Mapping[str, Any] = None,
+    ):
+        if shape.is_document_type:
+            final_parsed = node
+        else:
+            if node is None:
+                # If the comes across the wire as "null" (None in python),
+                # we should be returning this unchanged, instead of as an
+                # empty dict.
+                return None
+            final_parsed = {}
+            members = shape.members
+            if shape.is_tagged_union:
+                cleaned_value = node.copy()
+                cleaned_value.pop("__type", None)
+                cleaned_value = {k: v for k, v in cleaned_value.items() if v is not None}
+                if len(cleaned_value) != 1:
+                    raise ProtocolParserError(
+                        f"Invalid service response: {shape.name} must have one and only one member set."
+                    )
+
+            for member_name, member_shape in members.items():
+                member_value = node.get(member_name)
+                if member_value is not None:
+                    final_parsed[member_name] = self._parse_shape(
+                        request, member_shape, member_value, uri_params
+                    )
+
+        return final_parsed
+
+    def _parse_payload(
+        self,
+        request: Request,
+        shape: Shape,
+        final_parsed: dict,
+        uri_params: Mapping[str, Any] = None,
+    ) -> None:
+        original_parsed = self._initial_body_parse(request)
+        body_parsed = self._parse_shape(request, shape, original_parsed, uri_params)
+        final_parsed.update(body_parsed)
+
+    def _initial_body_parse(self, request: Request):
+        # This method should do the initial parsing of the
+        # body.  We still need to walk the parsed body in order
+        # to convert types, but this method will do the first round
+        # of parsing.
+        raise NotImplementedError("_initial_body_parse")
+
+
+class RpcV2CBORRequestParser(BaseRpcV2RequestParser, BaseCBORRequestParser):
+    """
+    The ``RpcV2CBORRequestParser`` is responsible for parsing incoming requests for services which use the
+    ``rpc-v2-cbor`` protocol. The requests for these services encode all of their parameters as CBOR in the
+    request body.
+    """
+
+    # TODO: investigate datetime format for RpcV2CBOR protocol, which might be different than Kinesis CBOR
+    def _initial_body_parse(self, request: Request):
+        body_contents = request.data
+        if body_contents == b"":
+            return body_contents
+        body_contents_stream = self.get_peekable_stream_from_bytes(body_contents)
+        return self.parse_data_item(body_contents_stream)
+
+
 class EC2RequestParser(QueryRequestParser):
     """
     The ``EC2RequestParser`` is responsible for parsing incoming requests for services which use the ``ec2``
@@ -1038,9 +1459,7 @@ class S3RequestParser(RestXMLRequestParser):
                 )
 
         @staticmethod
-        def _set_request_props(
-            request: Request, path: str, host: str, raw_uri: Optional[str] = None
-        ):
+        def _set_request_props(request: Request, path: str, host: str, raw_uri: str | None = None):
             """Sets the HTTP request's path and host and clears the cache in the request object."""
             request.path = path
             request.headers["Host"] = host
@@ -1072,7 +1491,7 @@ class S3RequestParser(RestXMLRequestParser):
             return uses_host_addressing(request.headers)
 
     @_handle_exceptions
-    def parse(self, request: Request) -> Tuple[OperationModel, Any]:
+    def parse(self, request: Request) -> tuple[OperationModel, Any]:
         """Handle virtual-host-addressing for S3."""
         with self.VirtualHostRewriter(request):
             return super().parse(request)
@@ -1147,11 +1566,12 @@ class SQSQueryRequestParser(QueryRequestParser):
 
 
 @functools.cache
-def create_parser(service: ServiceModel) -> RequestParser:
+def create_parser(service: ServiceModel, protocol: ProtocolName | None = None) -> RequestParser:
     """
     Creates the right parser for the given service model.
 
     :param service: to create the parser for
+    :param protocol: the protocol for the parser. If not provided, fallback to the service's default protocol
     :return: RequestParser which can handle the protocol of the service
     """
     # Unfortunately, some services show subtle differences in their parsing or operation detection behavior, even though
@@ -1169,14 +1589,20 @@ def create_parser(service: ServiceModel) -> RequestParser:
         "rest-json": RestJSONRequestParser,
         "rest-xml": RestXMLRequestParser,
         "ec2": EC2RequestParser,
+        "smithy-rpc-v2-cbor": RpcV2CBORRequestParser,
+        # TODO: implement multi-protocol support for Kinesis, so that it can uses the `cbor` protocol and remove
+        #  CBOR handling from JSONRequestParser
+        # this is not an "official" protocol defined from the spec, but is derived from ``json``
     }
 
+    service_protocol = protocol or service.protocol
+
     # Try to select a service- and protocol-specific parser implementation
     if (
         service.service_name in service_specific_parsers
-        and service.protocol in service_specific_parsers[service.service_name]
+        and service_protocol in service_specific_parsers[service.service_name]
     ):
-        return service_specific_parsers[service.service_name][service.protocol](service)
+        return service_specific_parsers[service.service_name][service_protocol](service)
     else:
         # Otherwise, pick the protocol-specific parser for the protocol of the service
-        return protocol_specific_parsers[service.protocol](service)
+        return protocol_specific_parsers[service_protocol](service)