Separate werkzeug contrib

Author: p1c2u

docs/integrations.rst

@@ -192,25 +192,17 @@ In Flask, all unmarshalled request data are provided as Flask request object's `
 Low level
 ~~~~~~~~~
 
-You can use `FlaskOpenAPIRequest` as a Flask/Werkzeug request factory:
+You can use `FlaskOpenAPIRequest` as a Flask request factory:
 
 .. code-block:: python
 
    from openapi_core.validation.request import openapi_request_validator
    from openapi_core.contrib.flask import FlaskOpenAPIRequest
 
-   openapi_request = FlaskOpenAPIRequest(flask_request)
+   openapi_request = FlaskOpenAPIRequest(werkzeug_request)
    result = openapi_request_validator.validate(spec, openapi_request)
 
-You can use `FlaskOpenAPIResponse` as a Flask/Werkzeug response factory:
-
-.. code-block:: python
-
-   from openapi_core.validation.response import openapi_response_validator
-   from openapi_core.contrib.flask import FlaskOpenAPIResponse
-
-   openapi_response = FlaskOpenAPIResponse(flask_response)
-   result = openapi_response_validator.validate(spec, openapi_request, openapi_response)
+For response factory see `Werkzeug`_ integration.
 
 
 Pyramid
@@ -247,7 +239,37 @@ You can use `RequestsOpenAPIResponse` as a Requests response factory:
    openapi_response = RequestsOpenAPIResponse(requests_response)
    result = openapi_respose_validator.validate(spec, openapi_request, openapi_response)
 
+
 Tornado
 -------
 
 See `tornado-openapi3 <https://github.com/correl/tornado-openapi3>`_ project.
+
+
+Werkzeug
+--------
+
+This section describes integration with `Werkzeug <https://werkzeug.palletsprojects.com>`__ a WSGI web application library.
+
+Low level
+~~~~~~~~~
+
+You can use `WerkzeugOpenAPIRequest` as a Werkzeug request factory:
+
+.. code-block:: python
+
+   from openapi_core.validation.request import openapi_request_validator
+   from openapi_core.contrib.werkzeug import WerkzeugOpenAPIRequest
+
+   openapi_request = WerkzeugOpenAPIRequest(werkzeug_request)
+   result = openapi_request_validator.validate(spec, openapi_request)
+
+You can use `WerkzeugOpenAPIResponse` as a Werkzeug response factory:
+
+.. code-block:: python
+
+   from openapi_core.validation.response import openapi_response_validator
+   from openapi_core.contrib.werkzeug import WerkzeugOpenAPIResponse
+
+   openapi_response = WerkzeugOpenAPIResponse(werkzeug_response)
+   result = openapi_response_validator.validate(spec, openapi_request, openapi_response)

openapi_core/contrib/flask/requests.py

@@ -1,23 +1,15 @@
 """OpenAPI core contrib flask requests module"""
-import re
-from typing import Optional
-
 from flask.wrappers import Request
 from werkzeug.datastructures import Headers
 from werkzeug.datastructures import ImmutableMultiDict
 
+from openapi_core.contrib.werkzeug.requests import WerkzeugOpenAPIRequest
 from openapi_core.validation.request.datatypes import RequestParameters
 
-# http://flask.pocoo.org/docs/1.0/quickstart/#variable-rules
-PATH_PARAMETER_PATTERN = r"<(?:(?:string|int|float|path|uuid):)?(\w+)>"
-
-
-class FlaskOpenAPIRequest:
-
-    path_regex = re.compile(PATH_PARAMETER_PATTERN)
 
+class FlaskOpenAPIRequest(WerkzeugOpenAPIRequest):
     def __init__(self, request: Request):
-        self.request = request
+        self.request: Request = request
 
         self.parameters = RequestParameters(
             path=self.request.view_args or {},
@@ -26,29 +18,9 @@ def __init__(self, request: Request):
             cookie=self.request.cookies,
         )
 
-    @property
-    def host_url(self) -> str:
-        return self.request.host_url
-
-    @property
-    def path(self) -> str:
-        return self.request.path
-
     @property
     def path_pattern(self) -> str:
         if self.request.url_rule is None:
             return self.request.path
-        else:
-            return self.path_regex.sub(r"{\1}", self.request.url_rule.rule)
-
-    @property
-    def method(self) -> str:
-        return self.request.method.lower()
 
-    @property
-    def body(self) -> Optional[str]:
-        return self.request.get_data(as_text=True)
-
-    @property
-    def mimetype(self) -> str:
-        return self.request.mimetype
+        return self.path_regex.sub(r"{\1}", self.request.url_rule.rule)

openapi_core/contrib/flask/responses.py

@@ -1,24 +1,5 @@
-"""OpenAPI core contrib flask responses module"""
-from flask.wrappers import Response
-from werkzeug.datastructures import Headers
+from openapi_core.contrib.werkzeug.responses import (
+    WerkzeugOpenAPIResponse as FlaskOpenAPIResponse,
+)
 
-
-class FlaskOpenAPIResponse:
-    def __init__(self, response: Response):
-        self.response = response
-
-    @property
-    def data(self) -> str:
-        return self.response.get_data(as_text=True)
-
-    @property
-    def status_code(self) -> int:
-        return self.response._status_code
-
-    @property
-    def mimetype(self) -> str:
-        return str(self.response.mimetype)
-
-    @property
-    def headers(self) -> Headers:
-        return Headers(self.response.headers)
+__all__ = ["FlaskOpenAPIResponse"]

openapi_core/contrib/werkzeug/__init__.py

@@ -0,0 +1,7 @@
+from openapi_core.contrib.werkzeug.requests import WerkzeugOpenAPIRequest
+from openapi_core.contrib.werkzeug.responses import WerkzeugOpenAPIResponse
+
+__all__ = [
+    "WerkzeugOpenAPIRequest",
+    "WerkzeugOpenAPIResponse",
+]

openapi_core/contrib/werkzeug/requests.py

@@ -0,0 +1,46 @@
+"""OpenAPI core contrib werkzeug requests module"""
+import re
+from typing import Optional
+
+from werkzeug.datastructures import Headers
+from werkzeug.datastructures import ImmutableMultiDict
+from werkzeug.wrappers import Request
+
+from openapi_core.validation.request.datatypes import RequestParameters
+
+# http://flask.pocoo.org/docs/1.0/quickstart/#variable-rules
+PATH_PARAMETER_PATTERN = r"<(?:(?:string|int|float|path|uuid):)?(\w+)>"
+
+
+class WerkzeugOpenAPIRequest:
+
+    path_regex = re.compile(PATH_PARAMETER_PATTERN)
+
+    def __init__(self, request: Request):
+        self.request = request
+
+        self.parameters = RequestParameters(
+            query=ImmutableMultiDict(self.request.args),
+            header=Headers(self.request.headers),
+            cookie=self.request.cookies,
+        )
+
+    @property
+    def host_url(self) -> str:
+        return self.request.host_url
+
+    @property
+    def path(self) -> str:
+        return self.request.path
+
+    @property
+    def method(self) -> str:
+        return self.request.method.lower()
+
+    @property
+    def body(self) -> Optional[str]:
+        return self.request.get_data(as_text=True)
+
+    @property
+    def mimetype(self) -> str:
+        return self.request.mimetype

openapi_core/contrib/werkzeug/responses.py

@@ -0,0 +1,24 @@
+"""OpenAPI core contrib werkzeug responses module"""
+from werkzeug.datastructures import Headers
+from werkzeug.wrappers import Response
+
+
+class WerkzeugOpenAPIResponse:
+    def __init__(self, response: Response):
+        self.response = response
+
+    @property
+    def data(self) -> str:
+        return self.response.get_data(as_text=True)
+
+    @property
+    def status_code(self) -> int:
+        return self.response._status_code
+
+    @property
+    def mimetype(self) -> str:
+        return str(self.response.mimetype)
+
+    @property
+    def headers(self) -> Headers:
+        return Headers(self.response.headers)