Merge pull request #676 from python-openapi/fix/parameter-deserialize…

…r-renamed-into-style-deserializer

Parameter deserializers renamed Style deserializers

openapi_core/deserializing/styles/__init__.py

@@ -0,0 +1,7 @@
+from openapi_core.deserializing.styles.factories import (
+    StyleDeserializersFactory,
+)
+
+__all__ = ["style_deserializers_factory"]
+
+style_deserializers_factory = StyleDeserializersFactory()

openapi_core/deserializing/parameters/deserializers.py → openapi_core/deserializing/styles/deserializers.py

@@ -5,18 +5,16 @@
 from typing import Optional
 
 from openapi_core.deserializing.exceptions import DeserializeError
-from openapi_core.deserializing.parameters.datatypes import (
-    DeserializerCallable,
-)
-from openapi_core.deserializing.parameters.exceptions import (
+from openapi_core.deserializing.styles.datatypes import DeserializerCallable
+from openapi_core.deserializing.styles.exceptions import (
     EmptyQueryParameterValue,
 )
 from openapi_core.schema.parameters import get_aslist
 from openapi_core.schema.parameters import get_explode
 from openapi_core.spec import Spec
 
 
-class CallableParameterDeserializer:
+class CallableStyleDeserializer:
     def __init__(
         self,
         param_or_header: Spec,

openapi_core/deserializing/parameters/exceptions.py → openapi_core/deserializing/styles/exceptions.py

@@ -4,14 +4,14 @@
 
 
 @dataclass
-class BaseParameterDeserializeError(DeserializeError):
-    """Base parameter deserialize operation error"""
+class BaseStyleDeserializeError(DeserializeError):
+    """Base style deserialize operation error"""
 
     location: str
 
 
 @dataclass
-class ParameterDeserializeError(BaseParameterDeserializeError):
+class ParameterDeserializeError(BaseStyleDeserializeError):
     """Parameter deserialize operation error"""
 
     style: str
@@ -25,7 +25,7 @@ def __str__(self) -> str:
 
 
 @dataclass(init=False)
-class EmptyQueryParameterValue(BaseParameterDeserializeError):
+class EmptyQueryParameterValue(BaseStyleDeserializeError):
     name: str
 
     def __init__(self, name: str):

openapi_core/deserializing/styles/factories.py

@@ -0,0 +1,29 @@
+import re
+from functools import partial
+from typing import Dict
+
+from openapi_core.deserializing.styles.datatypes import DeserializerCallable
+from openapi_core.deserializing.styles.deserializers import (
+    CallableStyleDeserializer,
+)
+from openapi_core.deserializing.styles.util import split
+from openapi_core.schema.parameters import get_style
+from openapi_core.spec import Spec
+
+
+class StyleDeserializersFactory:
+    STYLE_DESERIALIZERS: Dict[str, DeserializerCallable] = {
+        "form": partial(split, separator=","),
+        "simple": partial(split, separator=","),
+        "spaceDelimited": partial(split, separator=" "),
+        "pipeDelimited": partial(split, separator="|"),
+        "deepObject": partial(re.split, pattern=r"\[|\]"),
+    }
+
+    def create(self, param_or_header: Spec) -> CallableStyleDeserializer:
+        style = get_style(param_or_header)
+
+        deserialize_callable = self.STYLE_DESERIALIZERS.get(style)
+        return CallableStyleDeserializer(
+            param_or_header, style, deserialize_callable
+        )

openapi_core/unmarshalling/request/unmarshallers.py

@@ -11,11 +11,9 @@
 from openapi_core.deserializing.media_types.factories import (
     MediaTypeDeserializersFactory,
 )
-from openapi_core.deserializing.parameters import (
-    parameter_deserializers_factory,
-)
-from openapi_core.deserializing.parameters.factories import (
-    ParameterDeserializersFactory,
+from openapi_core.deserializing.styles import style_deserializers_factory
+from openapi_core.deserializing.styles.factories import (
+    StyleDeserializersFactory,
 )
 from openapi_core.protocols import BaseRequest
 from openapi_core.protocols import Request
@@ -86,7 +84,7 @@ def __init__(
         spec: Spec,
         base_url: Optional[str] = None,
         schema_casters_factory: SchemaCastersFactory = schema_casters_factory,
-        parameter_deserializers_factory: ParameterDeserializersFactory = parameter_deserializers_factory,
+        style_deserializers_factory: StyleDeserializersFactory = style_deserializers_factory,
         media_type_deserializers_factory: MediaTypeDeserializersFactory = media_type_deserializers_factory,
         schema_validators_factory: Optional[SchemaValidatorsFactory] = None,
         format_validators: Optional[FormatValidatorsDict] = None,
@@ -106,7 +104,7 @@ def __init__(
             spec,
             base_url=base_url,
             schema_casters_factory=schema_casters_factory,
-            parameter_deserializers_factory=parameter_deserializers_factory,
+            style_deserializers_factory=style_deserializers_factory,
             media_type_deserializers_factory=media_type_deserializers_factory,
             schema_validators_factory=schema_validators_factory,
             format_validators=format_validators,
@@ -121,7 +119,7 @@ def __init__(
             spec,
             base_url=base_url,
             schema_casters_factory=schema_casters_factory,
-            parameter_deserializers_factory=parameter_deserializers_factory,
+            style_deserializers_factory=style_deserializers_factory,
             media_type_deserializers_factory=media_type_deserializers_factory,
             schema_validators_factory=schema_validators_factory,
             format_validators=format_validators,

openapi_core/unmarshalling/unmarshallers.py

@@ -14,11 +14,9 @@
 from openapi_core.deserializing.media_types.factories import (
     MediaTypeDeserializersFactory,
 )
-from openapi_core.deserializing.parameters import (
-    parameter_deserializers_factory,
-)
-from openapi_core.deserializing.parameters.factories import (
-    ParameterDeserializersFactory,
+from openapi_core.deserializing.styles import style_deserializers_factory
+from openapi_core.deserializing.styles.factories import (
+    StyleDeserializersFactory,
 )
 from openapi_core.spec import Spec
 from openapi_core.unmarshalling.schemas.datatypes import (
@@ -40,7 +38,7 @@ def __init__(
         spec: Spec,
         base_url: Optional[str] = None,
         schema_casters_factory: SchemaCastersFactory = schema_casters_factory,
-        parameter_deserializers_factory: ParameterDeserializersFactory = parameter_deserializers_factory,
+        style_deserializers_factory: StyleDeserializersFactory = style_deserializers_factory,
         media_type_deserializers_factory: MediaTypeDeserializersFactory = media_type_deserializers_factory,
         schema_validators_factory: Optional[SchemaValidatorsFactory] = None,
         format_validators: Optional[FormatValidatorsDict] = None,
@@ -62,7 +60,7 @@ def __init__(
             spec,
             base_url=base_url,
             schema_casters_factory=schema_casters_factory,
-            parameter_deserializers_factory=parameter_deserializers_factory,
+            style_deserializers_factory=style_deserializers_factory,
             media_type_deserializers_factory=media_type_deserializers_factory,
             schema_validators_factory=schema_validators_factory,
             format_validators=format_validators,

openapi_core/validation/request/validators.py

@@ -18,11 +18,9 @@
 from openapi_core.deserializing.media_types.factories import (
     MediaTypeDeserializersFactory,
 )
-from openapi_core.deserializing.parameters import (
-    parameter_deserializers_factory,
-)
-from openapi_core.deserializing.parameters.factories import (
-    ParameterDeserializersFactory,
+from openapi_core.deserializing.styles import style_deserializers_factory
+from openapi_core.deserializing.styles.factories import (
+    StyleDeserializersFactory,
 )
 from openapi_core.protocols import BaseRequest
 from openapi_core.protocols import Request
@@ -68,7 +66,7 @@ def __init__(
         spec: Spec,
         base_url: Optional[str] = None,
         schema_casters_factory: SchemaCastersFactory = schema_casters_factory,
-        parameter_deserializers_factory: ParameterDeserializersFactory = parameter_deserializers_factory,
+        style_deserializers_factory: StyleDeserializersFactory = style_deserializers_factory,
         media_type_deserializers_factory: MediaTypeDeserializersFactory = media_type_deserializers_factory,
         schema_validators_factory: Optional[SchemaValidatorsFactory] = None,
         format_validators: Optional[FormatValidatorsDict] = None,
@@ -82,7 +80,7 @@ def __init__(
             spec,
             base_url=base_url,
             schema_casters_factory=schema_casters_factory,
-            parameter_deserializers_factory=parameter_deserializers_factory,
+            style_deserializers_factory=style_deserializers_factory,
             media_type_deserializers_factory=media_type_deserializers_factory,
             schema_validators_factory=schema_validators_factory,
             format_validators=format_validators,

openapi_core/validation/validators.py

@@ -17,11 +17,9 @@
 from openapi_core.deserializing.media_types.factories import (
     MediaTypeDeserializersFactory,
 )
-from openapi_core.deserializing.parameters import (
-    parameter_deserializers_factory,
-)
-from openapi_core.deserializing.parameters.factories import (
-    ParameterDeserializersFactory,
+from openapi_core.deserializing.styles import style_deserializers_factory
+from openapi_core.deserializing.styles.factories import (
+    StyleDeserializersFactory,
 )
 from openapi_core.protocols import Request
 from openapi_core.protocols import WebhookRequest
@@ -44,7 +42,7 @@ def __init__(
         spec: Spec,
         base_url: Optional[str] = None,
         schema_casters_factory: SchemaCastersFactory = schema_casters_factory,
-        parameter_deserializers_factory: ParameterDeserializersFactory = parameter_deserializers_factory,
+        style_deserializers_factory: StyleDeserializersFactory = style_deserializers_factory,
         media_type_deserializers_factory: MediaTypeDeserializersFactory = media_type_deserializers_factory,
         schema_validators_factory: Optional[SchemaValidatorsFactory] = None,
         format_validators: Optional[FormatValidatorsDict] = None,
@@ -57,7 +55,7 @@ def __init__(
         self.base_url = base_url
 
         self.schema_casters_factory = schema_casters_factory
-        self.parameter_deserializers_factory = parameter_deserializers_factory
+        self.style_deserializers_factory = style_deserializers_factory
         self.media_type_deserializers_factory = (
             media_type_deserializers_factory
         )
@@ -78,15 +76,15 @@ def _get_media_type(self, content: Spec, mimetype: str) -> MediaType:
         finder = MediaTypeFinder(content)
         return finder.find(mimetype)
 
-    def _deserialise_data(self, mimetype: str, value: Any) -> Any:
+    def _deserialise_media_type(self, mimetype: str, value: Any) -> Any:
         deserializer = self.media_type_deserializers_factory.create(
             mimetype,
             extra_media_type_deserializers=self.extra_media_type_deserializers,
         )
         return deserializer.deserialize(value)
 
-    def _deserialise_parameter(self, param: Spec, value: Any) -> Any:
-        deserializer = self.parameter_deserializers_factory.create(param)
+    def _deserialise_style(self, param_or_header: Spec, value: Any) -> Any:
+        deserializer = self.style_deserializers_factory.create(param_or_header)
         return deserializer.deserialize(value)
 
     def _cast(self, schema: Spec, value: Any) -> Any:
@@ -144,15 +142,17 @@ def _get_param_or_header_value_and_schema(
         else:
             # Simple scenario
             if "content" not in param_or_header:
-                deserialised = self._deserialise_parameter(
+                deserialised = self._deserialise_style(
                     param_or_header, raw_value
                 )
                 schema = param_or_header / "schema"
             # Complex scenario
             else:
                 content = param_or_header / "content"
                 mimetype, media_type = next(content.items())
-                deserialised = self._deserialise_data(mimetype, raw_value)
+                deserialised = self._deserialise_media_type(
+                    mimetype, raw_value
+                )
                 schema = media_type / "schema"
             casted = self._cast(schema, deserialised)
         return casted, schema
@@ -161,7 +161,7 @@ def _get_content_value_and_schema(
         self, raw: Any, mimetype: str, content: Spec
     ) -> Tuple[Any, Optional[Spec]]:
         media_type, mimetype = self._get_media_type(content, mimetype)
-        deserialised = self._deserialise_data(mimetype, raw)
+        deserialised = self._deserialise_media_type(mimetype, raw)
         casted = self._cast(media_type, deserialised)
 
         if "schema" not in media_type:

tests/integration/test_petstore.py

@@ -14,7 +14,7 @@
 from openapi_core.casting.schemas.exceptions import CastError
 from openapi_core.datatypes import Parameters
 from openapi_core.deserializing.exceptions import DeserializeError
-from openapi_core.deserializing.parameters.exceptions import (
+from openapi_core.deserializing.styles.exceptions import (
     EmptyQueryParameterValue,
 )
 from openapi_core.templating.media_types.exceptions import MediaTypeNotFound

tests/unit/deserializing/test_parameters_deserializers.py → tests/unit/deserializing/test_styles_deserializers.py

@@ -1,19 +1,19 @@
 import pytest
 
-from openapi_core.deserializing.parameters.exceptions import (
+from openapi_core.deserializing.styles.exceptions import (
     EmptyQueryParameterValue,
 )
-from openapi_core.deserializing.parameters.factories import (
-    ParameterDeserializersFactory,
+from openapi_core.deserializing.styles.factories import (
+    StyleDeserializersFactory,
 )
 from openapi_core.spec.paths import Spec
 
 
-class TestParameterDeserializer:
+class TestStyleDeserializer:
     @pytest.fixture
     def deserializer_factory(self):
         def create_deserializer(param):
-            return ParameterDeserializersFactory().create(param)
+            return StyleDeserializersFactory().create(param)
 
         return create_deserializer