Skip to main content

Extends Hypothesis to add fully automatic testing of type annotated functions

Project description

hypothesis-auto - Fully Automatic Tests for Type Annotated Functions Using Hypothesis.

PyPI version Build Status codecov Join the chat at License Downloads

Read Latest Documentation - Browse GitHub Code Repository

hypothesis-auto is an extension for the Hypothesis project that enables fully automatic tests for type annotated functions.

Hypothesis Pytest Auto Example

Key Features:

  • Type Annotation Powered: Utilize your function's existing type annotations to build dozens of test cases automatically.
  • Low Barrier: Start utilizing property-based testing in the lowest barrier way possible. Just run auto_test(FUNCTION) to run dozens of test.
  • py.test Compatible: Built-n compatibility with the popular py.test testing framework. This means that you can turn your automatically generated tests into individual py.test test cases with one line.
  • Scales Up: As you find your self needing to customize your auto_test cases, you can easily utilize all the features of Hypothesis, including custom strategies per a parameter.


To get started - install hypothesis-auto into your projects virtual environment:

pip3 install hypothesis-auto


poetry add hypothesis-auto


pipenv install hypothesis-auto

Usage Examples:

Framework independent usage

Basic auto_test usage:

from hypothesis_auto import auto_test

def add(number_1: int, number_2: int = 1) -> int:
    return number_1 + number_2

auto_test(add)  # 50 property based scenerios are generated and ran against add
auto_test(add, _auto_runs=1_000)  # Let's make that 1,000

Adding an allowed exception:

from hypothesis_auto import auto_test

def divide(number_1: int, number_2: int) -> int:
    return number_1 / number_2


-> 1012                     raise the_error_hypothesis_found
   1014         for attrib in dir(test):

<ipython-input-2-65a3aa66e9f9> in divide(number_1, number_2)
      1 def divide(number_1: int, number_2: int) -> int:
----> 2     return number_1 / number_2


ZeroDivisionError: division by zero

auto_test(divide, _auto_allow_exceptions=(ZeroDivisionError, ))

For the full set of parameters, you can pass into auto_test see its API reference documentation.

py.test usage

Using auto_pytest_magic to auto-generate dozens of py.test test cases:

from hypothesis_auto import auto_pytest_magic

def add(number_1: int, number_2: int = 1) -> int:
    return number_1 + number_2


Using auto_pytest to run dozens of test case within a temporary directory:

from hypothesis_auto import auto_pytest

def add(number_1: int, number_2: int = 1) -> int:
    return number_1 + number_2

def test_add(test_case, tmpdir):

For the full reference of the py.test integration API see the [API reference documentation]( othesis-auto/reference/hypothesis_auto/pytest/).

Why Create hypothesis-auto?

I wanted a no/low resistance way to start incorporating property-based tests across my projects. Such a solution that also encouraged the use of type hints was a win/win for me.

I hope you too find hypothesis-auto useful!

~Timothy Crosley

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for hypothesis-auto, version 1.0.1
Filename, size File type Python version Upload date Hashes
Filename, size hypothesis_auto-1.0.1-py3-none-any.whl (7.1 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size hypothesis-auto-1.0.1.tar.gz (6.4 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page