Recurse references in validation

JSON schema references can be nested complex schemas.
Recurse in dereferencing logic until the returned item is no
longer a reference.

Also: Added a recursion to test data and fixed a typo
in test_shortcuts.py.

Author: evahala

openapi_spec_validator/validators.py

@@ -34,6 +34,8 @@ def dereference(self, item):
         ref = item['$ref']
         with self.resolver_manager.in_scope(item) as resolver:
             with resolver.resolving(ref) as target:
+                if is_ref(target):
+                    target = self.dereference(target)
                 return target
 
 

tests/integration/data/v3.0/parent-reference/openapi.yaml

@@ -14,6 +14,7 @@ paths:
       tags:
         - pets
       parameters:
+        - $ref: "recursive.yaml#/parameters/RecursiveReference"
         - name: limit
           in: query
           description: How many items to return at one time (max 100)

tests/integration/data/v3.0/parent-reference/recursive.yaml

@@ -0,0 +1,3 @@
+parameters:
+  RecursiveReference:
+    $ref : "recursive2.yaml#/parameters/RecursiveReference"

tests/integration/data/v3.0/parent-reference/recursive2.yaml

@@ -0,0 +1,8 @@
+parameters:
+  RecursiveReference:
+    name: sampleParameter
+    in: query
+    description: Tests recursion
+    required: false
+    schema:
+      type: boolean

tests/integration/test_shortcuts.py

@@ -156,7 +156,7 @@ def spec_url(self):
         )
 
 
-class TestApiWithExampe(BaseTestValidValidateV3SpecUrl):
+class TestApiWithExample(BaseTestValidValidateV3SpecUrl):
 
     @pytest.fixture
     def spec_url(self):