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.