Quickstart¶
This page 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, then come back after writing some!
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.
The no-argument command hypothesis fuzz
does two things:
Starts a local dashboard webserver, and
Executes your Hypothesis tests using all available cores
These behaviors can be isolated with the --dashboard-only
and --no-dashboard
commands respectively, and the number of cores used can be controlled with -n/--num-processes
.
HypoFuzz uses pytest to collect available tests. hypothesis fuzz
should therefore be run in a directory where pytest can discover your tests.
Any arguments after hypothesis fuzz --
are passed through to pytest. See Test collection for how to use this to configure which tests are collected.
Note
See the command-line interface docs for a full command reference, and the operating guide for advice on configuring HypoFuzz.