Quickstart¶
This quickstart will get you set up using HypoFuzz.
Prerequisite: Have some Hypothesis tests¶
HypoFuzz runs hypothesis tests, so you’ll need some of those first. If you don’t have any Hypothesis tests yet, check out the Hypothesis quickstart guide, go write some Hypothesis tests, then come back!
Installation¶
HypoFuzz is a pure python package, and can be installed with:
pip install hypofuzz
Running HypoFuzz¶
The main entrypoint to HypoFuzz is hypothesis fuzz
. Installing HypoFuzz automatically adds this fuzz
sub-command to the existing Hypothesis CLI.
Running hypothesis fuzz
does two things:
Starts a local dashboard webserver.
Discovers and executes your Hypothesis tests with all available cores.
These behaviors can be isolated with the --dashboard-only
and --no-dashboard
commands, respectively. The number of cores used can be controlled with -n/--num-processes
.
HypoFuzz uses pytest to collect Hypothesis tests. hypothesis fuzz
should therefore be run in a directory where pytest can discover your tests. To control how HypoFuzz collects tests, see Test collection.
See also
See the command-line interface docs for a full command reference, and the operating guide for advice on configuring HypoFuzz.