schemathesis 4.3.1__tar.gz → 4.3.2__tar.gz

{schemathesis-4.3.1 → schemathesis-4.3.2}/CHANGELOG.md

@@ -1,6 +1,16 @@
 # Changelog
 
-## [Unreleased](https://github.com/schemathesis/schemathesis/compare/v4.3.1...HEAD) - TBD
+## [Unreleased](https://github.com/schemathesis/schemathesis/compare/v4.3.2...HEAD) - TBD
+
+## [4.3.2](https://github.com/schemathesis/schemathesis/compare/v4.3.1...v4.3.2) - 2025-10-14
+
+### :bug: Fixed
+
+- Incorrect reference resolution scope change when resolving responses. [#1184](https://github.com/schemathesis/schemathesis/issues/1184)
+
+### :wrench: Changed
+
+- Display cycles in error messages for infinitely recursive schemas.
 
 ## [4.3.1](https://github.com/schemathesis/schemathesis/compare/v4.3.0...v4.3.1) - 2025-10-14
 

{schemathesis-4.3.1 → schemathesis-4.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: schemathesis
-Version: 4.3.1
+Version: 4.3.2
 Summary: Property-based testing framework for Open API and GraphQL based apps
 Project-URL: Documentation, https://schemathesis.readthedocs.io/en/stable/
 Project-URL: Changelog, https://github.com/schemathesis/schemathesis/blob/master/CHANGELOG.md

{schemathesis-4.3.1 → schemathesis-4.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "schemathesis"
-version = "4.3.1"
+version = "4.3.2"
 description = "Property-based testing framework for Open API and GraphQL based apps"
 keywords = ["pytest", "hypothesis", "openapi", "graphql", "testing"]
 authors = [{ name = "Dmitry Dygalo", email = "dmitry@dygalo.dev" }]

{schemathesis-4.3.1 → schemathesis-4.3.2}/src/schemathesis/core/errors.py

@@ -298,13 +298,17 @@ class UnresolvableReference(SchemathesisError):
 
 
 class InfiniteRecursiveReference(SchemathesisError):
-    """Required recursive reference creates a cycle."""
+    """A schema has required references forming an infinite cycle."""
 
-    def __init__(self, reference: str) -> None:
+    def __init__(self, reference: str, cycle: list[str]) -> None:
         self.reference = reference
+        self.cycle = cycle
 
     def __str__(self) -> str:
-        return f"Required reference `{self.reference}` creates a cycle"
+        if len(self.cycle) == 1:
+            return f"Schema `{self.reference}` has a required reference to itself"
+        cycle_str = " ->\n  ".join(self.cycle + [self.cycle[0]])
+        return f"Schema `{self.reference}` has required references forming a cycle:\n\n  {cycle_str}"
 
 
 class SerializationNotPossible(SerializationError):

{schemathesis-4.3.1 → schemathesis-4.3.2}/src/schemathesis/core/jsonschema/bundler.py

@@ -73,7 +73,9 @@ class Bundler:
                         raise BundleError(reference, resolved_schema)
                     def_name = get_def_name(resolved_uri)
 
-                    is_recursive_reference = resolved_uri in resolver._scopes_stack
+                    scopes = resolver._scopes_stack
+
+                    is_recursive_reference = resolved_uri in scopes
                     has_recursive_references |= is_recursive_reference
                     if inline_recursive and is_recursive_reference:
                         # This is a recursive reference! As of Sep 2025, `hypothesis-jsonschema` does not support
@@ -91,9 +93,9 @@ class Bundler:
                         cloned = deepclone(resolved_schema)
                         remaining_references = sanitize(cloned)
                         if reference in remaining_references:
-                            # This schema is either infinitely recursive or the sanitization logic misses it, in any
-                            # event, we git up here
-                            raise InfiniteRecursiveReference(reference)
+                            # This schema is either infinitely recursive or the sanitization logic misses it
+                            cycle = scopes[scopes.index(resolved_uri) :]
+                            raise InfiniteRecursiveReference(reference, cycle)
 
                         result = {key: _bundle_recursive(value) for key, value in current.items() if key != "$ref"}
                         # Recursive references need `$ref` to be in them, which is only possible with `dict`

{schemathesis-4.3.1 → schemathesis-4.3.2}/src/schemathesis/specs/openapi/adapter/responses.py

@@ -177,11 +177,11 @@ def _iter_resolved_responses(
 ) -> Iterator[tuple[str, OpenApiResponse]]:
     for key, response in definition.items():
         status_code = str(key)
-        scope, resolved = maybe_resolve(response, resolver, scope)
+        new_scope, resolved = maybe_resolve(response, resolver, scope)
         yield (
             status_code,
             OpenApiResponse(
-                status_code=status_code, definition=resolved, resolver=resolver, scope=scope, adapter=adapter
+                status_code=status_code, definition=resolved, resolver=resolver, scope=new_scope, adapter=adapter
             ),
         )
 
@@ -300,10 +300,10 @@ def _iter_resolved_headers(
     definition: types.v3.Headers, resolver: RefResolver, scope: str, adapter: SpecificationAdapter
 ) -> Iterator[tuple[str, OpenApiResponseHeader]]:
     for name, header in definition.items():
-        scope, resolved = maybe_resolve(header, resolver, scope)
+        new_scope, resolved = maybe_resolve(header, resolver, scope)
         yield (
             name,
-            OpenApiResponseHeader(name=name, definition=resolved, resolver=resolver, scope=scope, adapter=adapter),
+            OpenApiResponseHeader(name=name, definition=resolved, resolver=resolver, scope=new_scope, adapter=adapter),
         )
 
 

{schemathesis-4.3.1 → schemathesis-4.3.2}/src/schemathesis/specs/openapi/examples.py

@@ -219,7 +219,8 @@ def _resolve_bundled(
                 # Try to remove recursive references to avoid infinite recursion
                 remaining_references = references.sanitize(schema)
                 if reference in remaining_references:
-                    raise InfiniteRecursiveReference(reference)
+                    cycle = list(reference_path[reference_path.index(reference) :])
+                    raise InfiniteRecursiveReference(reference, cycle)
 
             new_path = reference_path + (reference,)
 

{schemathesis-4.3.1 → schemathesis-4.3.2}/test/__snapshots__/test_dereferencing/test_multiple_hops_references[paths0-components0].raw

@@ -24,7 +24,11 @@ Schemathesis dev
 ________________________________ POST /changes _________________________________
 Runtime Error
 
-Required reference `#/x-bundled/schema4` creates a cycle
+Schema `#/x-bundled/schema4` has required references forming a cycle:
+
+  #/x-bundled/schema4 ->
+  #/x-bundled/schema3 ->
+  #/x-bundled/schema4
 
 Need more help?
     Join our Discord server: https://discord.gg/R9ASRAmHnA

{schemathesis-4.3.1 → schemathesis-4.3.2}/test/__snapshots__/test_dereferencing/test_multiple_hops_references[paths1-components1].raw

@@ -24,7 +24,7 @@ Schemathesis dev
 ________________________________ POST /changes _________________________________
 Runtime Error
 
-Required reference `#/x-bundled/schema4` creates a cycle
+Schema `#/x-bundled/schema4` has a required reference to itself
 
 Need more help?
     Join our Discord server: https://discord.gg/R9ASRAmHnA

schemathesis-4.3.2/test/__snapshots__/test_dereferencing/test_responses_in_another_file.raw

@@ -0,0 +1,83 @@
+Exit code: 1
+---
+Stdout:
+Schemathesis dev
+━━━━━━━━━━━━━━━━
+
+
+ ✅  Loaded specification from /tmp/schema.json (in 0.00s)
+
+     Base URL:         http://127.0.0.1/api
+     Specification:    Open API 3.1.0
+     Operations:       1 selected / 1 total
+
+
+ ✅  API capabilities:
+
+     Supports NULL byte in headers:    ✘
+
+ ⏭   Examples (in 0.00s)
+
+     ⏭  1 skipped
+
+ ❌  Coverage (in 0.00s)
+
+     ❌ 1 failed
+
+ ❌  Fuzzing (in 0.00s)
+
+     ❌ 1 failed
+
+=================================== FAILURES ===================================
+______________________________ GET /api/v1/items _______________________________
+1. Test Case ID: <PLACEHOLDER>
+
+- Unsupported method incorrect response
+
+    Wrong status for unsupported method TRACE (got 404, expected 405)
+
+[404] Not Found:
+
+    `404: Not Found`
+
+Reproduce with:
+
+    curl -X TRACE http://127.0.0.1/api/api/v1/items
+
+2. Test Case ID: <PLACEHOLDER>
+
+- Undocumented HTTP status code
+
+    Received: 404
+    Documented: 200, 400, 500
+
+[404] Not Found:
+
+    `404: Not Found`
+
+Reproduce with:
+
+    curl -X GET http://127.0.0.1/api/api/v1/items
+
+=================================== SUMMARY ====================================
+
+API Operations:
+  Selected: 1/1
+  Tested: 1
+
+Test Phases:
+  ⏭  Examples
+  ❌ Coverage
+  ❌ Fuzzing
+  ⏭  Stateful (not applicable)
+
+Failures:
+  ❌ Undocumented HTTP status code: 1
+  ❌ Unsupported method incorrect response: 1
+
+Test cases:
+  N generated, N found N unique failures
+
+Seed: 42
+
+============================= 2 failures in 1.00s ==============================

{schemathesis-4.3.1 → schemathesis-4.3.2}/test/cli/__snapshots__/test_commands/test_recursive_reference_error_message.raw

@@ -32,7 +32,7 @@ Schemathesis dev
 __________________________________ POST /foo ___________________________________
 Schema Error
 
-Required reference `#/components/schemas/Node` creates a cycle
+Schema `#/components/schemas/Node` has a required reference to itself
 
 Need more help?
     Join our Discord server: https://discord.gg/R9ASRAmHnA

{schemathesis-4.3.1 → schemathesis-4.3.2}/test/coverage/test_phase.py

@@ -2215,7 +2215,7 @@ def test_references(ctx, operation, components):
             ):
                 pass
         else:
-            assert str(operation.err()) == "Required reference `` creates a cycle"
+            assert str(operation.err()) == "Schema `` has a required reference to itself"
 
 
 def test_urlencoded_payloads_are_valid(ctx):

{schemathesis-4.3.1 → schemathesis-4.3.2}/test/engine/test_engine.py

@@ -620,7 +620,7 @@ def test_skip_operations_with_recursive_references(schema_with_recursive_referen
     stream = EventStream(schema).execute()
     # Then it causes an error with a proper error message
     stream.assert_after_execution_status(Status.ERROR)
-    assert "Required reference `#/components/schemas/Node` creates a cycle" in str(
+    assert "Schema `#/components/schemas/Node` has a required reference to itself" in str(
         stream.find(events.NonFatalError).info
     )
 

{schemathesis-4.3.1 → schemathesis-4.3.2}/test/fixtures/ctx.py

@@ -61,11 +61,21 @@ class Context:
     def _testdir(self):
         return self.request.getfixturevalue("testdir")
 
-    def makefile(self, schema: dict[str, Any], *, format: str = "json", filename: str = "schema"):
+    def makefile(
+        self, schema: dict[str, Any], *, format: str = "json", filename: str = "schema", parent: str | None = None
+    ):
+        if parent is not None:
+            directory = self._testdir.mkdir(parent)
+        else:
+            directory = self._testdir.tmpdir
         if format == "json":
-            return self._testdir.makefile(".json", **{filename: json.dumps(schema)})
+            path = directory / f"{filename}.json"
+            path.write_text(json.dumps(schema), "utf8")
+            return path
         if format == "yaml":
-            return self._testdir.makefile(".yaml", **{filename: yaml.dump(schema)})
+            path = directory / f"{filename}.yaml"
+            path.write_text(yaml.dump(schema), "utf8")
+            return path
         raise ValueError(f"Unknown format: {format}")
 
     def write_pymodule(self, content: str, *, filename: str = "module"):

{schemathesis-4.3.1 → schemathesis-4.3.2}/test/test_dereferencing.py

@@ -838,6 +838,34 @@ def test_multiple_hops_references(ctx, cli, openapi3_base_url, snapshot_cli, pat
     assert cli.run(str(schema_path), f"--url={openapi3_base_url}", "--phases=examples") == snapshot_cli
 
 
+@pytest.mark.filterwarnings("error")
+def test_responses_in_another_file(ctx, cli, openapi3_base_url, snapshot_cli):
+    schema_path = ctx.openapi.write_schema(
+        {
+            "/api/v1/items": {
+                "get": {
+                    "responses": {
+                        "200": {"description": "ОК"},
+                        "400": {"$ref": "./schemas/responses.json#/BadRequest"},
+                        "500": {"$ref": "./schemas/responses.json#/InternalServerError"},
+                    }
+                }
+            }
+        },
+        version="3.1.0",
+    )
+    ctx.makefile(
+        {
+            "BadRequest": {"content": {"application/json": {"schema": {"$ref": "#/Error"}}}},
+            "InternalServerError": {"content": {"application/json": {"schema": {"$ref": "#/Error"}}}},
+            "Error": {"type": "object", "properties": {"message": {"type": "string"}}},
+        },
+        filename="responses",
+        parent="schemas",
+    )
+    assert cli.run(str(schema_path), f"--url={openapi3_base_url}") == snapshot_cli
+
+
 def test_iter_when_ref_resolves_to_none_in_body(ctx):
     # Key0 -> Key1 -> Key2 -> Key3 (None)
     schema = ctx.openapi.build_schema(

{schemathesis-4.3.1 → schemathesis-4.3.2}/test/test_pytest.py

@@ -341,7 +341,7 @@ def test(case):
     result = testdir.runpytest("-rs")
     # Then this test should be failed with a proper error message
     result.assert_outcomes(failed=1)
-    assert "Required reference `#/components/schemas/Node` creates a cycle" in result.stdout.str()
+    assert "Schema `#/components/schemas/Node` has a required reference to itself" in result.stdout.str()
 
 
 def test_checks_as_a_list(testdir, openapi3_base_url):