schemathesis


Nameschemathesis JSON
Version 4.0.9 PyPI version JSON
download
home_pageNone
SummaryProperty-based testing framework for Open API and GraphQL based apps
upload_time2025-07-12 22:42:01
maintainerNone
docs_urlNone
authorNone
requires_python>=3.9
licenseNone
keywords graphql hypothesis openapi pytest testing
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <p align="center">
    <a href="https://github.com/schemathesis/schemathesis/actions" target="_blank">
        <img src="https://github.com/schemathesis/schemathesis/actions/workflows/build.yml/badge.svg" alt="Build">
    </a>
    <a href="https://codecov.io/gh/schemathesis/schemathesis/branch/master" target="_blank">
        <img src="https://codecov.io/gh/schemathesis/schemathesis/branch/master/graph/badge.svg" alt="Coverage">
    </a>
    <a href="https://pypi.org/project/schemathesis/" target="_blank">
        <img src="https://img.shields.io/pypi/v/schemathesis.svg" alt="Version">
    </a>
    <a href="https://pypi.org/project/schemathesis/" target="_blank">
        <img src="https://img.shields.io/pypi/pyversions/schemathesis.svg" alt="Python versions">
    </a>
    <a href="https://discord.gg/R9ASRAmHnA" target="_blank">
        <img src="https://img.shields.io/discord/938139740912369755" alt="Discord">
    </a>
    <a href="https://opensource.org/licenses/MIT" target="_blank">
        <img src="https://img.shields.io/pypi/l/schemathesis.svg" alt="License">
    </a>
</p>

## Schemathesis

> **Catch API bugs before your users do.** 

Schemathesis automatically generates thousands of test cases from your OpenAPI or GraphQL schema and finds edge cases that break your API.

<p align="center">
  <img src="https://raw.githubusercontent.com/schemathesis/schemathesis/master/img/demo.gif" alt="Schemathesis automatically finding a server error"/>
  <br>
  <i>Finding bugs that manual testing missed</i>
</p>

## Try it now

```console
# Test a demo API - finds real bugs instantly
uvx schemathesis run https://example.schemathesis.io/openapi.json

# Test your own API
uvx schemathesis run https://your-api.com/openapi.json
```


## What problems does it solve?

- 💥 **500 errors** that crash your API on edge case inputs
- 📋 **Schema violations** where your API returns different data than documented  
- 🚪 **Validation bypasses** where invalid data gets accepted
- 🔗 **Integration failures** when responses don't match client expectations


> ⚠️ **Upgrading from older versions?** Check our [Migration Guide](https://github.com/schemathesis/schemathesis/blob/master/MIGRATION.md) for key changes.

# Installation & Usage

**Command Line:**
```console
uv pip install schemathesis
schemathesis run https://your-api.com/openapi.json
```

**Python Tests:**
```python
import schemathesis

schema = schemathesis.openapi.from_url("https://your-api.com/openapi.json")

@schema.parametrize()
def test_api(case):
    case.call_and_validate()  # Finds bugs automatically
```

**CI/CD:**
```yaml
- uses: schemathesis/action@v2
  with:
    schema: "https://your-api.com/openapi.json"
```

## Who uses it

Used by teams at **[Spotify](https://github.com/backstage/backstage)**, **[WordPress](https://github.com/WordPress/openverse)**, **JetBrains**, **Red Hat** and dozens other companies.


> "_Schemathesis is the best tool for fuzz testing of REST API on the market. We are at Red Hat use it for examining our applications in functional and integrations testing levels._" - Dmitry Misharov, RedHat

## Documentation

📚 **[Complete documentation](https://schemathesis.readthedocs.io/en/stable/)** with guides, examples, and API reference.

## Get Help

- 💬 [Discord community](https://discord.gg/R9ASRAmHnA)
- 🐛 [GitHub issues](https://github.com/schemathesis/schemathesis/issues)

## Contributing

We welcome contributions! See our [contributing guidelines](CONTRIBUTING.md) and join discussions in [issues](https://github.com/schemathesis/schemathesis/issues) or [Discord](https://discord.gg/R9ASRAmHnA).

## Acknowledgements

Schemathesis is built on top of <a href="https://hypothesis.works/" target="_blank">Hypothesis</a>, a powerful property-based testing library for Python.

## License

This project is licensed under the terms of the [MIT license](https://opensource.org/licenses/MIT).

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "schemathesis",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": "Dmitry Dygalo <dmitry@dygalo.dev>",
    "keywords": "graphql, hypothesis, openapi, pytest, testing",
    "author": null,
    "author_email": "Dmitry Dygalo <dmitry@dygalo.dev>",
    "download_url": "https://files.pythonhosted.org/packages/75/f5/136a45a087a76818f3ef725d3dcf7d26ab2ecc3de6a31c8a642035ab2110/schemathesis-4.0.9.tar.gz",
    "platform": null,
    "description": "<p align=\"center\">\n    <a href=\"https://github.com/schemathesis/schemathesis/actions\" target=\"_blank\">\n        <img src=\"https://github.com/schemathesis/schemathesis/actions/workflows/build.yml/badge.svg\" alt=\"Build\">\n    </a>\n    <a href=\"https://codecov.io/gh/schemathesis/schemathesis/branch/master\" target=\"_blank\">\n        <img src=\"https://codecov.io/gh/schemathesis/schemathesis/branch/master/graph/badge.svg\" alt=\"Coverage\">\n    </a>\n    <a href=\"https://pypi.org/project/schemathesis/\" target=\"_blank\">\n        <img src=\"https://img.shields.io/pypi/v/schemathesis.svg\" alt=\"Version\">\n    </a>\n    <a href=\"https://pypi.org/project/schemathesis/\" target=\"_blank\">\n        <img src=\"https://img.shields.io/pypi/pyversions/schemathesis.svg\" alt=\"Python versions\">\n    </a>\n    <a href=\"https://discord.gg/R9ASRAmHnA\" target=\"_blank\">\n        <img src=\"https://img.shields.io/discord/938139740912369755\" alt=\"Discord\">\n    </a>\n    <a href=\"https://opensource.org/licenses/MIT\" target=\"_blank\">\n        <img src=\"https://img.shields.io/pypi/l/schemathesis.svg\" alt=\"License\">\n    </a>\n</p>\n\n## Schemathesis\n\n> **Catch API bugs before your users do.** \n\nSchemathesis automatically generates thousands of test cases from your OpenAPI or GraphQL schema and finds edge cases that break your API.\n\n<p align=\"center\">\n  <img src=\"https://raw.githubusercontent.com/schemathesis/schemathesis/master/img/demo.gif\" alt=\"Schemathesis automatically finding a server error\"/>\n  <br>\n  <i>Finding bugs that manual testing missed</i>\n</p>\n\n## Try it now\n\n```console\n# Test a demo API - finds real bugs instantly\nuvx schemathesis run https://example.schemathesis.io/openapi.json\n\n# Test your own API\nuvx schemathesis run https://your-api.com/openapi.json\n```\n\n\n## What problems does it solve?\n\n- \ud83d\udca5 **500 errors** that crash your API on edge case inputs\n- \ud83d\udccb **Schema violations** where your API returns different data than documented  \n- \ud83d\udeaa **Validation bypasses** where invalid data gets accepted\n- \ud83d\udd17 **Integration failures** when responses don't match client expectations\n\n\n> \u26a0\ufe0f **Upgrading from older versions?** Check our [Migration Guide](https://github.com/schemathesis/schemathesis/blob/master/MIGRATION.md) for key changes.\n\n# Installation & Usage\n\n**Command Line:**\n```console\nuv pip install schemathesis\nschemathesis run https://your-api.com/openapi.json\n```\n\n**Python Tests:**\n```python\nimport schemathesis\n\nschema = schemathesis.openapi.from_url(\"https://your-api.com/openapi.json\")\n\n@schema.parametrize()\ndef test_api(case):\n    case.call_and_validate()  # Finds bugs automatically\n```\n\n**CI/CD:**\n```yaml\n- uses: schemathesis/action@v2\n  with:\n    schema: \"https://your-api.com/openapi.json\"\n```\n\n## Who uses it\n\nUsed by teams at **[Spotify](https://github.com/backstage/backstage)**, **[WordPress](https://github.com/WordPress/openverse)**, **JetBrains**, **Red Hat** and dozens other companies.\n\n\n> \"_Schemathesis is the best tool for fuzz testing of REST API on the market. We are at Red Hat use it for examining our applications in functional and integrations testing levels._\" - Dmitry Misharov, RedHat\n\n## Documentation\n\n\ud83d\udcda **[Complete documentation](https://schemathesis.readthedocs.io/en/stable/)** with guides, examples, and API reference.\n\n## Get Help\n\n- \ud83d\udcac [Discord community](https://discord.gg/R9ASRAmHnA)\n- \ud83d\udc1b [GitHub issues](https://github.com/schemathesis/schemathesis/issues)\n\n## Contributing\n\nWe welcome contributions! See our [contributing guidelines](CONTRIBUTING.md) and join discussions in [issues](https://github.com/schemathesis/schemathesis/issues) or [Discord](https://discord.gg/R9ASRAmHnA).\n\n## Acknowledgements\n\nSchemathesis is built on top of <a href=\"https://hypothesis.works/\" target=\"_blank\">Hypothesis</a>, a powerful property-based testing library for Python.\n\n## License\n\nThis project is licensed under the terms of the [MIT license](https://opensource.org/licenses/MIT).\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Property-based testing framework for Open API and GraphQL based apps",
    "version": "4.0.9",
    "project_urls": {
        "Bug Tracker": "https://github.com/schemathesis/schemathesis",
        "Changelog": "https://github.com/schemathesis/schemathesis/blob/master/CHANGELOG.md",
        "Documentation": "https://schemathesis.readthedocs.io/en/stable/",
        "Funding": "https://github.com/sponsors/Stranger6667",
        "Source Code": "https://github.com/schemathesis/schemathesis"
    },
    "split_keywords": [
        "graphql",
        " hypothesis",
        " openapi",
        " pytest",
        " testing"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "2207c3275d20ac0106ad397d100778ce11dae74ccb4e36e1f21a75c439650565",
                "md5": "a49cb0e8301ec78595220a57e2009950",
                "sha256": "655b01aa276e4c4389e2983af0657bd2ac09a68c1fd900edc917376c65d12c40"
            },
            "downloads": -1,
            "filename": "schemathesis-4.0.9-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "a49cb0e8301ec78595220a57e2009950",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 305870,
            "upload_time": "2025-07-12T22:41:59",
            "upload_time_iso_8601": "2025-07-12T22:41:59.209389Z",
            "url": "https://files.pythonhosted.org/packages/22/07/c3275d20ac0106ad397d100778ce11dae74ccb4e36e1f21a75c439650565/schemathesis-4.0.9-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "75f5136a45a087a76818f3ef725d3dcf7d26ab2ecc3de6a31c8a642035ab2110",
                "md5": "ded04f06ff675e51ec2209a542b281d7",
                "sha256": "47ab1a791413f4731a8953f44d6968a519d1137d37739f47d7b587af3b4ef1be"
            },
            "downloads": -1,
            "filename": "schemathesis-4.0.9.tar.gz",
            "has_sig": false,
            "md5_digest": "ded04f06ff675e51ec2209a542b281d7",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 57710166,
            "upload_time": "2025-07-12T22:42:01",
            "upload_time_iso_8601": "2025-07-12T22:42:01.978492Z",
            "url": "https://files.pythonhosted.org/packages/75/f5/136a45a087a76818f3ef725d3dcf7d26ab2ecc3de6a31c8a642035ab2110/schemathesis-4.0.9.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-07-12 22:42:01",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "schemathesis",
    "github_project": "schemathesis",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "tox": true,
    "lcname": "schemathesis"
}
        
Elapsed time: 0.59230s