# [HypoFuzz](https://hypofuzz.com/)
*Adaptive fuzzing of [Hypothesis](https://hypothesis.readthedocs.io) tests.*
Property-based approaches help you to write better tests which find more bugs,
but don't have great ways to exchange much more CPU time for more bugs.
The goal of this project is to bring togther the best parts of fuzzing and PBT.
## Motivation
You can [run a traditional fuzzer](https://hypothesis.readthedocs.io/en/latest/details.html#use-with-external-fuzzers)
like AFL on Hypothesis tests to get basic coverage guidance. This works OK, but there's
a lot of performance overhead. Installing, configuring, and connecting all the parts is
a pain, and because it assumes one fuzz target per core you probably can't scale up far
enough to fuzz your whole test suite.
Alternatively, you can just run Hypothesis with a large `max_examples` setting.
This also works pretty well, but doesn't get the benefits of coverage guidance and
you have to guess how long it'll take to run the tests - each gets the same budget.
HypoFuzz solves all of these problems, and more!
## Features
- Interleave execution of many test functions
- Prioritise functions where we expect to make progress
- Coverage-guided exploration of your system-under-test
- Seamless python-native and CLI integrations (replaces the `pytest` command)
- Web-based time-travel debugging with [PyTrace](https://pytrace.com/)
(automatic if you `pip install hypofuzz[pytrace]`)
Read more about HypoFuzz at https://hypofuzz.com/docs/, including
[the changelog](https://hypofuzz.com/docs/changelog.html).
Raw data
{
"_id": null,
"home_page": "https://hypofuzz.com/",
"name": "hypofuzz",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "python testing fuzzing property-based-testing",
"author": "Zac Hatfield-Dodds",
"author_email": "zac@hypofuzz.com",
"download_url": "https://files.pythonhosted.org/packages/5d/ff/ab10e5f1b6cd90fdbadb5e26f5dd0f5d7b5f1f31f1aae1f72a21e4b8d6c5/hypofuzz-24.11.1.tar.gz",
"platform": null,
"description": "# [HypoFuzz](https://hypofuzz.com/)\n\n*Adaptive fuzzing of [Hypothesis](https://hypothesis.readthedocs.io) tests.*\n\n\nProperty-based approaches help you to write better tests which find more bugs,\nbut don't have great ways to exchange much more CPU time for more bugs.\nThe goal of this project is to bring togther the best parts of fuzzing and PBT.\n\n\n## Motivation\n\nYou can [run a traditional fuzzer](https://hypothesis.readthedocs.io/en/latest/details.html#use-with-external-fuzzers)\nlike AFL on Hypothesis tests to get basic coverage guidance. This works OK, but there's\na lot of performance overhead. Installing, configuring, and connecting all the parts is\na pain, and because it assumes one fuzz target per core you probably can't scale up far\nenough to fuzz your whole test suite.\n\nAlternatively, you can just run Hypothesis with a large `max_examples` setting.\nThis also works pretty well, but doesn't get the benefits of coverage guidance and\nyou have to guess how long it'll take to run the tests - each gets the same budget.\n\nHypoFuzz solves all of these problems, and more!\n\n\n## Features\n\n- Interleave execution of many test functions\n- Prioritise functions where we expect to make progress\n- Coverage-guided exploration of your system-under-test\n- Seamless python-native and CLI integrations (replaces the `pytest` command)\n- Web-based time-travel debugging with [PyTrace](https://pytrace.com/)\n (automatic if you `pip install hypofuzz[pytrace]`)\n\nRead more about HypoFuzz at https://hypofuzz.com/docs/, including\n[the changelog](https://hypofuzz.com/docs/changelog.html).\n",
"bugtrack_url": null,
"license": "AGPL-3.0",
"summary": "Adaptive fuzzing for property-based tests",
"version": "24.11.1",
"project_urls": {
"Changelog": "https://hypofuzz.com/docs/changelog.html",
"Documentation": "https://hypofuzz.com/docs/",
"Homepage": "https://hypofuzz.com/"
},
"split_keywords": [
"python",
"testing",
"fuzzing",
"property-based-testing"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c24e0e2b101b5b885ebd94b43127bc67bed5b2809170d426517cc5bc602a91fd",
"md5": "612b94a6fb1d50b7235d203a25186ea9",
"sha256": "6be22123a9833c6817608d97ceee49e7c2e47389affb804e3c4f517e174bca42"
},
"downloads": -1,
"filename": "hypofuzz-24.11.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "612b94a6fb1d50b7235d203a25186ea9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 39634,
"upload_time": "2024-12-05T08:29:16",
"upload_time_iso_8601": "2024-12-05T08:29:16.991575Z",
"url": "https://files.pythonhosted.org/packages/c2/4e/0e2b101b5b885ebd94b43127bc67bed5b2809170d426517cc5bc602a91fd/hypofuzz-24.11.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "5dffab10e5f1b6cd90fdbadb5e26f5dd0f5d7b5f1f31f1aae1f72a21e4b8d6c5",
"md5": "85ca945101f0e75473fdf69a0c343139",
"sha256": "ad21b1fd8c07e20bd5315cdb029be361fc5fb2e432b33b90a4de9f1660e900ef"
},
"downloads": -1,
"filename": "hypofuzz-24.11.1.tar.gz",
"has_sig": false,
"md5_digest": "85ca945101f0e75473fdf69a0c343139",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 40384,
"upload_time": "2024-12-05T08:29:18",
"upload_time_iso_8601": "2024-12-05T08:29:18.571732Z",
"url": "https://files.pythonhosted.org/packages/5d/ff/ab10e5f1b6cd90fdbadb5e26f5dd0f5d7b5f1f31f1aae1f72a21e4b8d6c5/hypofuzz-24.11.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-05 08:29:18",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "hypofuzz"
}
JSON