Merge pull request #690 from python-openapi/feature/move-to-jsonschema-path

Move to jsonschema-path

Author: p1c2u

README.rst

@@ -61,9 +61,9 @@ Firstly create your specification object.
 
 .. code-block:: python
 
-    from openapi_core import Spec
+    from jsonschema_path import SchemaPath
 
-    spec = Spec.from_file_path('openapi.json')
+    spec = SchemaPath.from_file_path('openapi.json')
 
 Now you can use it to validate and unmarshal against requests and/or responses. 
 

docs/index.rst

@@ -49,9 +49,9 @@ Firstly create your specification object.
 
 .. code-block:: python
 
-    from openapi_core import Spec
+    from jsonschema_path import SchemaPath
 
-    spec = Spec.from_file_path('openapi.json')
+    spec = SchemaPath.from_file_path('openapi.json')
 
 Now you can use it to validate and unmarshal your requests and/or responses. 
 

docs/integrations.rst

@@ -54,29 +54,29 @@ Django can be integrated by middleware. Add ``DjangoOpenAPIMiddleware`` to your
   :emphasize-lines: 6,9
 
     # settings.py
-    from openapi_core import Spec
+    from jsonschema_path import SchemaPath
 
     MIDDLEWARE = [
        # ...
        'openapi_core.contrib.django.middlewares.DjangoOpenAPIMiddleware',
     ]
 
-    OPENAPI_SPEC = Spec.from_dict(spec_dict)
+    OPENAPI_SPEC = SchemaPath.from_dict(spec_dict)
 
 You can skip response validation process: by setting ``OPENAPI_RESPONSE_CLS`` to ``None``
 
 .. code-block:: python
   :emphasize-lines: 10
 
     # settings.py
-    from openapi_core import Spec
+    from jsonschema_path import SchemaPath
 
     MIDDLEWARE = [
        # ...
        'openapi_core.contrib.django.middlewares.DjangoOpenAPIMiddleware',
     ]
 
-    OPENAPI_SPEC = Spec.from_dict(spec_dict)
+    OPENAPI_SPEC = SchemaPath.from_dict(spec_dict)
     OPENAPI_RESPONSE_CLS = None
 
 After that you have access to unmarshal result object with all validated request data from Django view through request object.

openapi_core/casting/schemas/casters.py

@@ -3,16 +3,17 @@
 from typing import Callable
 from typing import List
 
+from jsonschema_path import SchemaPath
+
 from openapi_core.casting.schemas.datatypes import CasterCallable
 from openapi_core.casting.schemas.exceptions import CastError
-from openapi_core.spec import Spec
 
 if TYPE_CHECKING:
     from openapi_core.casting.schemas.factories import SchemaCastersFactory
 
 
 class BaseSchemaCaster:
-    def __init__(self, schema: Spec):
+    def __init__(self, schema: SchemaPath):
         self.schema = schema
 
     def __call__(self, value: Any) -> Any:
@@ -26,7 +27,7 @@ def cast(self, value: Any) -> Any:
 
 
 class CallableSchemaCaster(BaseSchemaCaster):
-    def __init__(self, schema: Spec, caster_callable: CasterCallable):
+    def __init__(self, schema: SchemaPath, caster_callable: CasterCallable):
         super().__init__(schema)
         self.caster_callable = caster_callable
 
@@ -43,7 +44,9 @@ def cast(self, value: Any) -> Any:
 
 
 class ComplexCaster(BaseSchemaCaster):
-    def __init__(self, schema: Spec, casters_factory: "SchemaCastersFactory"):
+    def __init__(
+        self, schema: SchemaPath, casters_factory: "SchemaCastersFactory"
+    ):
         super().__init__(schema)
         self.casters_factory = casters_factory
 

openapi_core/casting/schemas/factories.py

@@ -1,11 +1,12 @@
 from typing import Dict
 
+from jsonschema_path import SchemaPath
+
 from openapi_core.casting.schemas.casters import ArrayCaster
 from openapi_core.casting.schemas.casters import BaseSchemaCaster
 from openapi_core.casting.schemas.casters import CallableSchemaCaster
 from openapi_core.casting.schemas.casters import DummyCaster
 from openapi_core.casting.schemas.datatypes import CasterCallable
-from openapi_core.spec import Spec
 from openapi_core.util import forcebool
 
 
@@ -24,7 +25,7 @@ class SchemaCastersFactory:
         "array": ArrayCaster,
     }
 
-    def create(self, schema: Spec) -> BaseSchemaCaster:
+    def create(self, schema: SchemaPath) -> BaseSchemaCaster:
         schema_type = schema.getkey("type", "any")
 
         if schema_type in self.DUMMY_CASTERS:

openapi_core/contrib/falcon/middlewares.py

@@ -5,14 +5,14 @@
 
 from falcon.request import Request
 from falcon.response import Response
+from jsonschema_path import SchemaPath
 
 from openapi_core.contrib.falcon.handlers import FalconOpenAPIErrorsHandler
 from openapi_core.contrib.falcon.handlers import (
     FalconOpenAPIValidRequestHandler,
 )
 from openapi_core.contrib.falcon.requests import FalconOpenAPIRequest
 from openapi_core.contrib.falcon.responses import FalconOpenAPIResponse
-from openapi_core.spec import Spec
 from openapi_core.unmarshalling.processors import UnmarshallingProcessor
 from openapi_core.unmarshalling.request.types import RequestUnmarshallerType
 from openapi_core.unmarshalling.response.types import ResponseUnmarshallerType
@@ -28,7 +28,7 @@ class FalconOpenAPIMiddleware(UnmarshallingProcessor[Request, Response]):
 
     def __init__(
         self,
-        spec: Spec,
+        spec: SchemaPath,
         request_unmarshaller_cls: Optional[RequestUnmarshallerType] = None,
         response_unmarshaller_cls: Optional[ResponseUnmarshallerType] = None,
         request_cls: Type[FalconOpenAPIRequest] = FalconOpenAPIRequest,
@@ -51,7 +51,7 @@ def __init__(
     @classmethod
     def from_spec(
         cls,
-        spec: Spec,
+        spec: SchemaPath,
         request_unmarshaller_cls: Optional[RequestUnmarshallerType] = None,
         response_unmarshaller_cls: Optional[ResponseUnmarshallerType] = None,
         request_cls: Type[FalconOpenAPIRequest] = FalconOpenAPIRequest,

openapi_core/contrib/flask/decorators.py

@@ -8,13 +8,13 @@
 from flask.globals import request
 from flask.wrappers import Request
 from flask.wrappers import Response
+from jsonschema_path import SchemaPath
 
 from openapi_core.contrib.flask.handlers import FlaskOpenAPIErrorsHandler
 from openapi_core.contrib.flask.handlers import FlaskOpenAPIValidRequestHandler
 from openapi_core.contrib.flask.providers import FlaskRequestProvider
 from openapi_core.contrib.flask.requests import FlaskOpenAPIRequest
 from openapi_core.contrib.flask.responses import FlaskOpenAPIResponse
-from openapi_core.spec import Spec
 from openapi_core.unmarshalling.processors import UnmarshallingProcessor
 from openapi_core.unmarshalling.request.types import RequestUnmarshallerType
 from openapi_core.unmarshalling.response.types import ResponseUnmarshallerType
@@ -28,7 +28,7 @@ class FlaskOpenAPIViewDecorator(UnmarshallingProcessor[Request, Response]):
 
     def __init__(
         self,
-        spec: Spec,
+        spec: SchemaPath,
         request_unmarshaller_cls: Optional[RequestUnmarshallerType] = None,
         response_unmarshaller_cls: Optional[ResponseUnmarshallerType] = None,
         request_cls: Type[FlaskOpenAPIRequest] = FlaskOpenAPIRequest,
@@ -85,7 +85,7 @@ def _validate_response(self) -> bool:
     @classmethod
     def from_spec(
         cls,
-        spec: Spec,
+        spec: SchemaPath,
         request_unmarshaller_cls: Optional[RequestUnmarshallerType] = None,
         response_unmarshaller_cls: Optional[ResponseUnmarshallerType] = None,
         request_cls: Type[FlaskOpenAPIRequest] = FlaskOpenAPIRequest,

openapi_core/contrib/flask/views.py

@@ -2,18 +2,18 @@
 from typing import Any
 
 from flask.views import MethodView
+from jsonschema_path import SchemaPath
 
 from openapi_core.contrib.flask.decorators import FlaskOpenAPIViewDecorator
 from openapi_core.contrib.flask.handlers import FlaskOpenAPIErrorsHandler
-from openapi_core.spec import Spec
 
 
 class FlaskOpenAPIView(MethodView):
     """Brings OpenAPI specification validation and unmarshalling for views."""
 
     openapi_errors_handler = FlaskOpenAPIErrorsHandler
 
-    def __init__(self, spec: Spec, **unmarshaller_kwargs: Any):
+    def __init__(self, spec: SchemaPath, **unmarshaller_kwargs: Any):
         super().__init__()
 
         self.decorator = FlaskOpenAPIViewDecorator(

openapi_core/deserializing/styles/deserializers.py

@@ -4,20 +4,21 @@
 from typing import List
 from typing import Optional
 
+from jsonschema_path import SchemaPath
+
 from openapi_core.deserializing.exceptions import DeserializeError
 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 CallableStyleDeserializer:
     def __init__(
         self,
-        param_or_header: Spec,
+        param_or_header: SchemaPath,
         style: str,
         deserializer_callable: Optional[DeserializerCallable] = None,
     ):

openapi_core/deserializing/styles/factories.py

@@ -2,13 +2,14 @@
 from functools import partial
 from typing import Dict
 
+from jsonschema_path import SchemaPath
+
 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:
@@ -20,7 +21,7 @@ class StyleDeserializersFactory:
         "deepObject": partial(re.split, pattern=r"\[|\]"),
     }
 
-    def create(self, param_or_header: Spec) -> CallableStyleDeserializer:
+    def create(self, param_or_header: SchemaPath) -> CallableStyleDeserializer:
         style = get_style(param_or_header)
 
         deserialize_callable = self.STYLE_DESERIALIZERS.get(style)