Get rid of create_spec shortcut

Author: p1c2u

README.rst

@@ -62,12 +62,12 @@ Firstly create your specification object:
 .. code-block:: python
 
    from json import load
-   from openapi_core import create_spec
+   from openapi_core import OpenAPISpec as Spec
 
    with open('openapi.json', 'r') as spec_file:
       spec_dict = load(spec_file)
 
-   spec = create_spec(spec_dict)
+   spec = Spec.create(spec_dict)
 
 Request
 *******

docs/customizations.rst

@@ -8,9 +8,9 @@ By default, spec dict is validated on spec creation time. Disabling the validati
 
 .. code-block:: python
 
-   from openapi_core import create_spec
+   from openapi_core import OpenAPISpec as Spec
 
-   spec = create_spec(spec_dict, validate_spec=False)
+   spec = Spec.create(spec_dict, validate=False)
 
 Deserializers
 -------------

docs/integrations.rst

@@ -21,14 +21,14 @@ Django can be integrated by middleware. Add `DjangoOpenAPIMiddleware` to your `M
 .. code-block:: python
 
    # settings.py
-   from openapi_core import create_spec
+   from openapi_core import OpenAPISpec as Spec
 
    MIDDLEWARE = [
        # ...
        'openapi_core.contrib.django.middlewares.DjangoOpenAPIMiddleware',
    ]
 
-   OPENAPI_SPEC = create_spec(spec_dict)
+   OPENAPI_SPEC = Spec.create(spec_dict)
 
 After that you have access to validation result object with all validated request data from Django view through request object.
 

docs/usage.rst

@@ -6,12 +6,12 @@ Firstly create your specification: object
 .. code-block:: python
 
    from json import load
-   from openapi_core import create_spec
+   from openapi_core import OpenAPISpec as Spec
 
    with open('openapi.json', 'r') as spec_file:
       spec_dict = load(spec_file)
 
-   spec = create_spec(spec_dict)
+   spec = Spec.create(spec_dict)
 
 
 Request

openapi_core/__init__.py

@@ -1,12 +1,12 @@
 """OpenAPI core module"""
-from openapi_core.shortcuts import create_spec
 from openapi_core.shortcuts import spec_validate_body
 from openapi_core.shortcuts import spec_validate_data
 from openapi_core.shortcuts import spec_validate_headers
 from openapi_core.shortcuts import spec_validate_parameters
 from openapi_core.shortcuts import spec_validate_security
 from openapi_core.shortcuts import validate_request
 from openapi_core.shortcuts import validate_response
+from openapi_core.spec import OpenAPIv30Spec
 from openapi_core.validation.request.validators import RequestBodyValidator
 from openapi_core.validation.request.validators import (
     RequestParametersValidator,
@@ -26,7 +26,9 @@
 __license__ = "BSD 3-Clause License"
 
 __all__ = [
-    "create_spec",
+    "OpenAPIv30Spec",
+    "OpenAPIv3Spec",
+    "OpenAPISpec",
     "validate_request",
     "validate_response",
     "spec_validate_body",
@@ -42,3 +44,9 @@
     "ResponseDataValidator",
     "ResponseHeadersValidator",
 ]
+
+# aliases to the latest v3 version
+OpenAPIv3Spec = OpenAPIv30Spec
+
+# aliases to the latest version
+OpenAPISpec = OpenAPIv3Spec

openapi_core/shortcuts.py

@@ -1,6 +1,5 @@
 """OpenAPI core shortcuts module"""
 # backward compatibility
-from openapi_core.spec.shortcuts import create_spec
 from openapi_core.validation.request.shortcuts import spec_validate_body
 from openapi_core.validation.request.shortcuts import spec_validate_parameters
 from openapi_core.validation.request.shortcuts import spec_validate_security
@@ -10,7 +9,6 @@
 from openapi_core.validation.response.shortcuts import validate_response
 
 __all__ = [
-    "create_spec",
     "validate_request",
     "validate_response",
     "spec_validate_body",

openapi_core/spec/__init__.py

@@ -0,0 +1,5 @@
+from openapi_core.spec.paths import OpenAPIv30Spec
+
+__all__ = [
+    "OpenAPIv30Spec",
+]

openapi_core/spec/paths.py

@@ -1,13 +1,51 @@
+from jsonschema.validators import RefResolver
+from openapi_spec_validator import default_handlers
+from openapi_spec_validator import openapi_v3_spec_validator
+from openapi_spec_validator.validators import Dereferencer
 from pathable.paths import AccessorPath
 
 from openapi_core.spec.accessors import SpecAccessor
 
 SPEC_SEPARATOR = "#"
 
 
-class SpecPath(AccessorPath):
+class Spec(AccessorPath):
     @classmethod
-    def from_spec(cls, spec_dict, dereferencer=None, *args, **kwargs):
-        separator = kwargs.pop("separator", SPEC_SEPARATOR)
-        accessor = SpecAccessor(spec_dict, dereferencer)
+    def from_dict(
+        cls,
+        data,
+        *args,
+        url="",
+        ref_resolver_handlers=default_handlers,
+        separator=SPEC_SEPARATOR,
+    ):
+        ref_resolver = RefResolver(url, data, handlers=ref_resolver_handlers)
+        dereferencer = Dereferencer(ref_resolver)
+        accessor = SpecAccessor(data, dereferencer)
         return cls(accessor, *args, separator=separator)
+
+
+class OpenAPIv30Spec(Spec):
+
+    validator = openapi_v3_spec_validator
+
+    @classmethod
+    def create(
+        cls,
+        data,
+        *args,
+        url="",
+        ref_resolver_handlers=default_handlers,
+        separator=SPEC_SEPARATOR,
+        validate=True,
+    ):
+        if validate:
+            cls.validator.validate(data, spec_url=url)
+
+        return cls.from_dict(
+            data,
+            *args,
+            url=url,
+            ref_resolver_handlers=ref_resolver_handlers,
+            separator=separator,
+        )

openapi_core/templating/paths/util.py

@@ -1,8 +1,8 @@
 from typing import Tuple
 
-from openapi_core.spec.paths import SpecPath
+from openapi_core.spec.paths import OpenAPIv30Spec as Spec
 from openapi_core.templating.datatypes import TemplateResult
 
 
-def template_path_len(template_path: Tuple[SpecPath, TemplateResult]) -> int:
+def template_path_len(template_path: Tuple[Spec, TemplateResult]) -> int:
     return len(template_path[1].variables)

tests/integration/contrib/django/data/v3.0/djangoproject/settings.py

@@ -15,7 +15,7 @@
 
 import yaml
 
-from openapi_core import create_spec
+from openapi_core import OpenAPISpec as Spec
 
 # Build paths inside the project like this: os.path.join(BASE_DIR, ...)
 BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
@@ -123,4 +123,4 @@
 
 OPENAPI_SPEC_DICT = yaml.load(OPENAPI_SPEC_PATH.read_text(), yaml.Loader)
 
-OPENAPI_SPEC = create_spec(OPENAPI_SPEC_DICT)
+OPENAPI_SPEC = Spec.create(OPENAPI_SPEC_DICT)