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.