schemathesis 4.0.0a5__py3-none-any.whl → 4.0.0a6__py3-none-any.whl

schemathesis/cli/commands/run/__init__.py

@@ -239,7 +239,7 @@ DEFAULT_PHASES = ("examples", "coverage", "fuzzing", "stateful")
 @grouped_option(
     "--report",
     "report_formats",
-    help="Generate test reports in specified formats",
+    help="Generate test reports in formats specified as a comma-separated list",
     type=CsvEnumChoice(ReportFormat),
     is_eager=True,
     metavar="FORMAT",

schemathesis/cli/commands/run/handlers/output.py

@@ -788,7 +788,7 @@ class OutputHandler(EventHandler):
     warnings: WarningData = field(default_factory=WarningData)
     errors: set[events.NonFatalError] = field(default_factory=set)
     phases: dict[PhaseName, tuple[Status, PhaseSkipReason | None]] = field(
-        default_factory=lambda: {phase: (Status.SKIP, None) for phase in PhaseName}
+        default_factory=lambda: dict.fromkeys(PhaseName, (Status.SKIP, None))
     )
     console: Console = field(default_factory=_default_console)
 

schemathesis/specs/openapi/examples.py

@@ -399,45 +399,62 @@ def find_matching_in_responses(examples: dict[str, list], param: str) -> Iterato
             if not isinstance(example, dict):
                 continue
             # Unwrapping example from `{"item": [{...}]}`
-            if isinstance(example, dict) and len(example) == 1 and list(example)[0].lower() == schema_name.lower():
-                inner = list(example.values())[0]
-                if isinstance(inner, list):
-                    for sub_example in inner:
-                        found = _find_matching_in_responses(sub_example, schema_name, param, normalized, is_id_param)
-                        if found is not NOT_FOUND:
-                            yield found
-                    continue
-                if isinstance(inner, dict):
-                    example = inner
-            found = _find_matching_in_responses(example, schema_name, param, normalized, is_id_param)
-            if found is not NOT_FOUND:
-                yield found
+            if isinstance(example, dict):
+                inner = next((value for key, value in example.items() if key.lower() == schema_name.lower()), None)
+                if inner is not None:
+                    if isinstance(inner, list):
+                        for sub_example in inner:
+                            if isinstance(sub_example, dict):
+                                for found in _find_matching_in_responses(
+                                    sub_example, schema_name, param, normalized, is_id_param
+                                ):
+                                    if found is not NOT_FOUND:
+                                        yield found
+                        continue
+                    if isinstance(inner, dict):
+                        example = inner
+            for found in _find_matching_in_responses(example, schema_name, param, normalized, is_id_param):
+                if found is not NOT_FOUND:
+                    yield found
 
 
 def _find_matching_in_responses(
     example: dict[str, Any], schema_name: str, param: str, normalized: str, is_id_param: bool
-) -> Any:
+) -> Iterator[Any]:
     # Check for exact match
     if param in example:
-        return example[param]
+        yield example[param]
+        return
     if is_id_param and param[:-2] in example:
-        return example[param[:-2]]
+        value = example[param[:-2]]
+        if isinstance(value, list):
+            for sub_example in value:
+                for found in _find_matching_in_responses(sub_example, schema_name, param, normalized, is_id_param):
+                    if found is not NOT_FOUND:
+                        yield found
+            return
+        else:
+            yield value
+            return
 
     # Check for case-insensitive match
     for key in example:
         if key.lower() == normalized:
-            return example[key]
+            yield example[key]
+            return
     else:
         # If no match found and it's an ID parameter, try additional checks
         if is_id_param:
             # Check for 'id' if parameter is '{something}Id'
             if "id" in example:
-                return example["id"]
+                yield example["id"]
+                return
             # Check for '{schemaName}Id' or '{schemaName}_id'
             if normalized == "id" or normalized.startswith(schema_name.lower()):
                 for key in (schema_name, schema_name.lower()):
                     for suffix in ("_id", "Id"):
                         with_suffix = f"{key}{suffix}"
                         if with_suffix in example:
-                            return example[with_suffix]
-    return NOT_FOUND
+                            yield example[with_suffix]
+                            return
+    yield NOT_FOUND

schemathesis/specs/openapi/patterns.py

@@ -124,6 +124,21 @@ def _handle_anchored_pattern(parsed: list, pattern: str, min_length: int | None,
 
     for op, value in pattern_parts:
         if op == LITERAL:
+            # Check if the literal comes from a bracketed expression,
+            # e.g. Python regex parses "[+]" as a single LITERAL token.
+            if pattern[current_position] == "[":
+                # Find the matching closing bracket.
+                end_idx = current_position + 1
+                while end_idx < len(pattern):
+                    # Check for an unescaped closing bracket.
+                    if pattern[end_idx] == "]" and (end_idx == current_position + 1 or pattern[end_idx - 1] != "\\"):
+                        end_idx += 1
+                        break
+                    end_idx += 1
+                # Append the entire character set.
+                result += pattern[current_position:end_idx]
+                current_position = end_idx
+                continue
             if pattern[current_position] == "\\":
                 # Escaped value
                 current_position += 2

schemathesis/transport/requests.py

@@ -56,12 +56,21 @@ class RequestsTransport(BaseTransport["Case", Response, "requests.Session"]):
             for key, value in additional_headers.items():
                 final_headers.setdefault(key, value)
 
+        params = case.query
+
+        # Replace empty dictionaries with empty strings, so the parameters actually present in the query string
+        if any(value == {} for value in (params or {}).values()):
+            params = deepclone(params)
+            for key, value in params.items():
+                if value == {}:
+                    params[key] = ""
+
         data = {
             "method": case.method,
             "url": url,
             "cookies": case.cookies,
             "headers": final_headers,
-            "params": case.query,
+            "params": params,
             **extra,
         }
 

{schemathesis-4.0.0a5.dist-info → schemathesis-4.0.0a6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: schemathesis
-Version: 4.0.0a5
+Version: 4.0.0a6
 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://schemathesis.readthedocs.io/en/stable/changelog.html
@@ -117,62 +117,47 @@ Description-Content-Type: text/markdown
 
 ## Schemathesis
 
-> ⚠️ You are viewing the Schemathesis V4 README (Work in Progress) ⚠️
-
-> This branch is under active development, with substantial changes expected before stabilization. While V4 is fully functional and passing tests, some features are missing, and the documentation may be outdated.
-
-> For the stable release, see the [V3 branch](https://github.com/schemathesis/schemathesis/tree/v3).
-
-> 💡 Have feedback? Share your thoughts in [this discussion](https://github.com/schemathesis/schemathesis/discussions/2677)!
-
-Schemathesis is an API testing tool that automatically finds crashes and validates spec compliance.
-
-<p align="center">
-  <img src="https://raw.githubusercontent.com/schemathesis/schemathesis/master/img/demo.gif" alt="Schemathesis Demo"/>
-</p>
+Schemathesis automatically generates and runs API tests from your OpenAPI or GraphQL schema to find bugs and spec violations.
 
 <p align="center">
-  <i>Finding server crashes in the Demo API.</i>
+  <img src="https://raw.githubusercontent.com/schemathesis/schemathesis/master/img/demo.gif" alt="Schemathesis automatically finding a server error"/>
+  <br>
+  <i>Automatically finding specification violations and server errors</i>
 </p>
 
-### Highlights
-
-- 🎯 **Catches Hard-to-Find Bugs**: Automatically uncover crashes and spec violations that manual testing might miss.
-
-- ⚡ **Accelerates Testing**: Generate a wide range of test cases directly from your API schema.
-
-- 🧩 **Integrates Seamlessly**: Works with popular API formats such as OpenAPI and GraphQL, and easily integrates into your existing CI/CD workflows.
+> **Note:** This is the V4 branch under active development. While fully functional and passing tests, some features may be missing, and documentation is being updated. For the stable release, see the [V3 branch](https://github.com/schemathesis/schemathesis/tree/v3).
 
-- 🔧 **Customizable and Extendable**: Leverage Python extensions to configure and extend your test generation.
+## Why Schemathesis?
 
-- 🐞 **Simplifies Debugging**: Detailed reports and reproducible test cases with cURL commands streamline troubleshooting.
-
-- 🔬 **Proven by Research**: Validated through academic studies on API testing automation, featured in the [ICSE 2022 paper](https://ieeexplore.ieee.org/document/9793781) on semantics-aware fuzzing, and recognized in an [ACM survey](https://dl.acm.org/doi/10.1145/3617175) as a state-of-the-art RESTful API testing tool.
+- 📑 **Schema-Based Testing** - Transform API documentation into a comprehensive test suite
+- 🚀 **Zero Configuration** - Begin testing immediately with a valid OpenAPI or GraphQL schema
+- ⚙️ **CI-Ready** - Integrate API testing into existing pipelines without complex configuration
+- 🛡️ **Effective Coverage** - Find edge cases no manual testing could uncover
+- 🔬 **Research-Backed**: [Recognized](https://dl.acm.org/doi/10.1145/3617175) in [academic research](https://ieeexplore.ieee.org/document/9793781) as a state-of-the-art API testing tool
 
 ## Installation
 
-Use Schemathesis via Docker, or install it from [PyPI](https://pypi.org/project/schemathesis/)
-
 ```console
-# Via Docker.
-$ docker pull schemathesis/schemathesis:stable
+# Using uv (recommended)
+$ uv pip install schemathesis
 
-# With pip.
+# Using pip
 $ pip install schemathesis
+
+# Using Docker
+$ docker pull schemathesis/schemathesis:stable
 ```
 
-## Getting Started
+## Usage
 
-Schemathesis works as a standalone CLI:
+### Command Line
 
 ```console
-docker run schemathesis/schemathesis:stable
-   run --checks all https://example.schemathesis.io/openapi.json
-# Or when installed with pip
-schemathesis run --checks all https://example.schemathesis.io/openapi.json
+# Run tests against a schema URL
+$ st run https://example.schemathesis.io/openapi.json
 ```
 
-Or a Python library:
+### Python Library
 
 ```python
 import schemathesis
@@ -185,36 +170,35 @@ def test_api(case):
     case.call_and_validate()
 ```
 
-See a complete working example project in the [/example](https://github.com/schemathesis/schemathesis/tree/master/example) directory.
-
-Schemathesis can be easily integrated into your CI/CD pipeline using GitHub Actions. Add this block to your GitHub Actions to run Schemathesis against your API:
+### CI/CD Integration
 
 ```yaml
-api-tests:
-  runs-on: ubuntu-latest
-  steps:
-    - uses: schemathesis/action@v1
-      with:
-        schema: "https://example.schemathesis.io/openapi.json"
+# GitHub Actions example
+steps:
+  - uses: schemathesis/action@v1
+    with:
+      schema: "https://example.schemathesis.io/openapi.json"
 ```
 
-For more details, check out our [GitHub Action](https://github.com/schemathesis/action) repository or see our [GitHub Tutorial](https://docs.schemathesis.io/tutorials/github).
+## Documentation
+
+📚 **[Read the full documentation](https://schemathesis.readthedocs.io/)** for guides, examples, and reference material.
 
 ## Who's Using Schemathesis?
 
-Schemathesis is used by a number of projects and companies, including direct usage or integration into other tools:
+Schemathesis is used by companies and open-source projects including:
 
-- Abstract Machines ([Magistrala](https://github.com/absmach/magistrala))
-- Bundesstelle für Open Data ([smard-api](https://github.com/bundesAPI/smard-api))
-- [CheckMK](https://github.com/Checkmk/checkmk)
-- Chronosphere.io ([Calyptia](https://github.com/chronosphereio/calyptia-api))
-- HXSecurity ([DongTai](https://github.com/HXSecurity/DongTai))
 - Netflix ([Dispatch](https://github.com/Netflix/dispatch))
-- [Pixie](https://github.com/pixie-io/pixie)
-- [Qdrant](https://github.com/qdrant/qdrant)
 - Spotify ([Backstage](https://github.com/backstage/backstage))
-- [Weechat](https://github.com/weechat/weechat)
 - WordPress ([OpenVerse](https://github.com/WordPress/openverse))
+- Chronosphere.io ([Calyptia](https://github.com/chronosphereio/calyptia-api))
+- [Qdrant](https://github.com/qdrant/qdrant)
+- [Pixie](https://github.com/pixie-io/pixie)
+- [CheckMK](https://github.com/Checkmk/checkmk)
+- [Weechat](https://github.com/weechat/weechat)
+- HXSecurity ([DongTai](https://github.com/HXSecurity/DongTai))
+- Abstract Machines ([Magistrala](https://github.com/absmach/magistrala))
+- Bundesstelle für Open Data ([smard-api](https://github.com/bundesAPI/smard-api))
 
 ## Testimonials
 
@@ -230,7 +214,7 @@ Schemathesis is used by a number of projects and companies, including direct usa
 
 ---
 
-"_The tool is absolutely amazing as it can do the negative scenario testing instead of me and much faster! Before I was doing the same tests in Postman client. But it's much slower and brings maintenance burden._"
+"_The tool is amazing as it can test negative scenarios instead of me and much faster!_"
 
 <div>Luděk Nový - <strong>JetBrains</strong></div>
 
@@ -250,24 +234,15 @@ Schemathesis is used by a number of projects and companies, including direct usa
 
 ## Contributing
 
-We welcome contributions in code and are especially interested in learning about your use cases. Your input is essential for improving Schemathesis and directly influences future updates.
-
-### How to Contribute
-
-1. Discuss ideas and questions through [GitHub issues](https://github.com/schemathesis/schemathesis/issues) or on our [Discord channel](https://discord.gg/R9ASRAmHnA).
-2. For code contributions, see our [contributing guidelines](https://github.com/schemathesis/schemathesis/blob/master/CONTRIBUTING.rst).
-3. Share your experience and thoughts using [this feedback form](https://forms.gle/kJ4hSxc1Yp6Ga96t5).
-
-### Why Your Input Matters
-
-- Enables us to develop useful features and fix bugs faster
-- Improves our test suite and documentation
+We welcome contributions! Your input directly influences Schemathesis development.
 
-Thank you for contributing to making Schemathesis better! 👍
+- Discuss ideas in [GitHub issues](https://github.com/schemathesis/schemathesis/issues) or our [Discord server](https://discord.gg/R9ASRAmHnA)
+- See our [contributing guidelines](https://github.com/schemathesis/schemathesis/blob/master/CONTRIBUTING.rst) for code contributions
+- Share your experience using [this feedback form](https://forms.gle/kJ4hSxc1Yp6Ga96t5)
 
 ## Get in Touch
 
-If you need assistance with integrating Schemathesis into your workflows or have specific questions, feel free to reach out at <a href="mailto:support@schemathesis.io">support@schemathesis.io</a>.
+Need assistance with integration or have specific questions? Contact us at <a href="mailto:support@schemathesis.io">support@schemathesis.io</a>.
 
 ## Acknowledgements
 

{schemathesis-4.0.0a5.dist-info → schemathesis-4.0.0a6.dist-info}/RECORD

@@ -12,7 +12,7 @@ schemathesis/cli/constants.py,sha256=rUixnqorraUFDtOu3Nmm1x_k0qbgmW9xW96kQB_fBCQ
 schemathesis/cli/core.py,sha256=Qm5xvpIIMwJDTeR3N3TjKhMCHV5d5Rp0UstVS2GjWgw,459
 schemathesis/cli/hooks.py,sha256=vTrA8EN99whRns5K5AnExViQ6WL9cak5RGsC-ZBEiJM,1458
 schemathesis/cli/commands/__init__.py,sha256=FFalEss3D7mnCRO0udtYb65onXSjQCCOv8sOSjqvTTM,1059
-schemathesis/cli/commands/run/__init__.py,sha256=ToPLYJrLcan5-fVqo-xs8peVy7O51fQMXxu1y5K2Ei4,23112
+schemathesis/cli/commands/run/__init__.py,sha256=pLuXYxgO0z1CLZH_2P_uW8xeGOy1S2VtxLnNqKXanHk,23138
 schemathesis/cli/commands/run/checks.py,sha256=lLtBCt6NhhQisrWo8aC6i0M3dSXlbjGWTTlOyjzatks,3278
 schemathesis/cli/commands/run/context.py,sha256=pUwSlS7UwW2cq1nJXfKZFEaWDipsQAElCO4tdv1qYJA,7739
 schemathesis/cli/commands/run/events.py,sha256=Dj-xvIr-Hkms8kvh4whNwKSk1Q2Hx4NIENi_4A8nQO8,1224
@@ -26,7 +26,7 @@ schemathesis/cli/commands/run/handlers/__init__.py,sha256=TPZ3KdGi8m0fjlN0GjA31M
 schemathesis/cli/commands/run/handlers/base.py,sha256=yDsTtCiztLksfk7cRzg8JlaAVOfS-zwK3tsJMOXAFyc,530
 schemathesis/cli/commands/run/handlers/cassettes.py,sha256=SVk13xPhsQduCpgvvBwzEMDNTju-SHQCW90xTQ6iL1U,18525
 schemathesis/cli/commands/run/handlers/junitxml.py,sha256=c24UiwXqRCnv2eWQWEaNXLOghMI9JtGoZ9RTJY4ao6M,2350
-schemathesis/cli/commands/run/handlers/output.py,sha256=AcnFAOm03QR4eKNQcQV2EZFV-YUcRaL4rKvMrmOyCuM,58806
+schemathesis/cli/commands/run/handlers/output.py,sha256=n25QDGvYMXPKRPHBDckkDVwkkieY3Gq4HHSG0h3paTA,58800
 schemathesis/cli/ext/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 schemathesis/cli/ext/fs.py,sha256=OA3mRzra4rq3NyDTcBvlRh0WJrh4ByN-QQ8loI04m88,408
 schemathesis/cli/ext/groups.py,sha256=kQ37t6qeArcKaY2y5VxyK3_KwAkBKCVm58IYV8gewds,2720
@@ -117,11 +117,11 @@ schemathesis/specs/openapi/checks.py,sha256=m3n5N3_iZcS7inJojW47FF6dfbUQzrBH-bXw
 schemathesis/specs/openapi/constants.py,sha256=JqM_FHOenqS_MuUE9sxVQ8Hnw0DNM8cnKDwCwPLhID4,783
 schemathesis/specs/openapi/converter.py,sha256=lil8IewM5j8tvt4lpA9g_KITvIwx1M96i45DNSHNjoc,3505
 schemathesis/specs/openapi/definitions.py,sha256=8htclglV3fW6JPBqs59lgM4LnA25Mm9IptXBPb_qUT0,93949
-schemathesis/specs/openapi/examples.py,sha256=aURgeCsQrpsdWEAhjmW6BiRFabuSf5TeRlZBd4ltgNw,20381
+schemathesis/specs/openapi/examples.py,sha256=Xvjp60QUcLaeGsJRbi2i6XM15_4uO0ceVoClIaJehiE,21062
 schemathesis/specs/openapi/formats.py,sha256=ViVF3aFeFI1ctwGQbiRDXhU3so82P0BCaF2aDDbUUm8,2816
 schemathesis/specs/openapi/media_types.py,sha256=ADedOaNWjbAtAekyaKmNj9fY6zBTeqcNqBEjN0EWNhI,1014
 schemathesis/specs/openapi/parameters.py,sha256=hv1reNpSjVuzFbtMpSTwWZ75zcWTOy5ZE0ah6AVEqAo,14565
-schemathesis/specs/openapi/patterns.py,sha256=-1_0twbsyAiSbm0uTFipcXZTYgBY8UK6PriJkzhdET0,12038
+schemathesis/specs/openapi/patterns.py,sha256=NLnGybcana_kYLVKVEjkEyAzdClAV0xKe4Oy4NVayMI,12834
 schemathesis/specs/openapi/references.py,sha256=YjD1xMlaYS7xLt6PrrVS20R72ZWHuFZFTa8Llzf54Rg,8808
 schemathesis/specs/openapi/schemas.py,sha256=VSeacEAVJJ6EKJ-llwOaX4aalzUTXyWP8s4wbxTqtWc,54720
 schemathesis/specs/openapi/security.py,sha256=6UWYMhL-dPtkTineqqBFNKca1i4EuoTduw-EOLeE0aQ,7149
@@ -143,11 +143,11 @@ schemathesis/specs/openapi/stateful/links.py,sha256=8oHpmb-yBa3kZKoCv9ytndpOp80d
 schemathesis/transport/__init__.py,sha256=z-mRNSOlMBKwQyaEIhpmYv0plWTmK5dJqc9UmQOry80,3949
 schemathesis/transport/asgi.py,sha256=qTClt6oT_xUEWnRHokACN_uqCNNUZrRPT6YG0PjbElY,926
 schemathesis/transport/prepare.py,sha256=qQ6zXBw5NN2AIM0bzLAc5Ryc3dmMb0R6xN14lnR49pU,3826
-schemathesis/transport/requests.py,sha256=OObRvcTL72-BZ7AfuDUrZZU9nZtfBqr22oF8nkzaOLE,8389
+schemathesis/transport/requests.py,sha256=j5wI1Uo_PnVuP1eV8l6ddsXosyxAPQ1mLSyWEZmTI9I,8747
 schemathesis/transport/serialization.py,sha256=jIMra1LqRGav0OX3Hx7mvORt38ll4cd2DKit2D58FN0,10531
 schemathesis/transport/wsgi.py,sha256=RWSuUXPrl91GxAy8a4jyNNozOWVMRBxKx_tljlWA_Lo,5697
-schemathesis-4.0.0a5.dist-info/METADATA,sha256=uftZyIy9oqwJ76F5tKRz5tMu-jlUwK2pg-JHxKxiUeg,12103
-schemathesis-4.0.0a5.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-schemathesis-4.0.0a5.dist-info/entry_points.txt,sha256=hiK3un-xfgPdwj9uj16YVDtTNpO128bmk0U82SMv8ZQ,152
-schemathesis-4.0.0a5.dist-info/licenses/LICENSE,sha256=PsPYgrDhZ7g9uwihJXNG-XVb55wj2uYhkl2DD8oAzY0,1103
-schemathesis-4.0.0a5.dist-info/RECORD,,
+schemathesis-4.0.0a6.dist-info/METADATA,sha256=W8GlnQVnH1VOEqPqS-ElR_yk0RvdB9TOXTxHy_p3zTU,10427
+schemathesis-4.0.0a6.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+schemathesis-4.0.0a6.dist-info/entry_points.txt,sha256=hiK3un-xfgPdwj9uj16YVDtTNpO128bmk0U82SMv8ZQ,152
+schemathesis-4.0.0a6.dist-info/licenses/LICENSE,sha256=2Ve4J8v5jMQAWrT7r1nf3bI8Vflk3rZVQefiF2zpxwg,1121
+schemathesis-4.0.0a6.dist-info/RECORD,,

{schemathesis-4.0.0a5.dist-info → schemathesis-4.0.0a6.dist-info}/licenses/LICENSE

@@ -1,7 +1,7 @@
 MIT License
 
 Copyright (c) 2019 Kiwi.com
-Copyright (c) 2020-2022 Dmitry Dygalo
+Copyright (c) 2020-2025 Dmitry Dygalo & Schemathesis.io
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal