Skip to content
Branch: master
Find file History
Permalink
Type Name Latest commit message Commit time
..
Failed to load latest commit information.
docs Add hypothesis-networkx to strategies.rst Mar 21, 2019
examples Fix all source headers to use URL https://mozilla.org/MPL/2.0/ Jan 8, 2019
scripts Add some tests for new lark extra Jan 23, 2019
src/hypothesis
tests
.coveragerc Fix Py2 int/long in from_type Jun 25, 2018
LICENSE.txt
MANIFEST.in
README.rst
setup.cfg
setup.py Drop support for Python 3.4 at EOL Mar 19, 2019
tox.ini Drop support for Python 3.4 at EOL Mar 19, 2019

README.rst

Hypothesis

Hypothesis is an advanced testing library for Python. It lets you write tests which are parametrized by a source of examples, and then generates simple and comprehensible examples that make your tests fail. This lets you find more bugs in your code with less work.

e.g.

@given(st.lists(
  st.floats(allow_nan=False, allow_infinity=False), min_size=1))
def test_mean(xs):
    assert min(xs) <= mean(xs) <= max(xs)
Falsifying example: test_mean(
  xs=[1.7976321109618856e+308, 6.102390043022755e+303]
)

Hypothesis is extremely practical and advances the state of the art of unit testing by some way. It's easy to use, stable, and powerful. If you're not using Hypothesis to test your project then you're missing out.

Quick Start/Installation

If you just want to get started:

pip install hypothesis

Links of interest

The main Hypothesis site is at hypothesis.works, and contains a lot of good introductory and explanatory material.

Extensive documentation and examples of usage are available at readthedocs.

If you want to talk to people about using Hypothesis, we have both an IRC channel and a mailing list.

If you want to receive occasional updates about Hypothesis, including useful tips and tricks, there's a TinyLetter mailing list to sign up for them.

If you want to contribute to Hypothesis, instructions are here.

If you want to hear from people who are already using Hypothesis, some of them have written about it.

If you want to create a downstream package of Hypothesis, please read these guidelines for packagers.

You can’t perform that action at this time.