Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

PropEr

proper-testing.github.io

  • Free plan
  • Self-hosted

What PropEr is

PropEr is a free, open-source tool for automated, semi-random property-based testing of Erlang programs. It can generate test data from Erlang type declarations and use information in Erlang specifications to test functions automatically. Properties are written as Erlang expressions using predefined macros. For stateful systems, PropEr can run model-based random testing; recent releases also support targeted property-based testing that applies search-based testing techniques. The project supports EUnit and Common Test, as well as failing-case shrinking. Its generator language differs from Erlang’s type language for list expressions: generators can describe lists with particular lengths and element types. Constraints that cannot be expressed with Erlang types can be handled with custom generators, though filtering may continue trying random values until a value passes. PropEr is designed for Erlang programs, especially pure functions and library modules for stateful code. It is self-hosted and distributed under GPL version 3 or later. The user guide describes getting the source from GitHub and compiling it with make, or installing it with Homebrew.

Who it suits

PropEr suits developers testing Erlang programs, particularly pure functions and library modules for stateful code. It is intended for Erlang rather than general-purpose testing across languages.

Good to know, and what to watch

  • Generates test data from Erlang type declarations.
  • Can test functions using their Erlang specifications.
  • Supports model-based testing of stateful systems.
  • Works with EUnit and Common Test.
  • Open-source under GPL version 3 or later.
  • Designed specifically for Erlang programs.
  • Filtering constraints may keep trying random values.
  • Installation guidance involves source compilation or Homebrew.

PropEr

Free

Free plan

The verdict

PropEr offers Erlang-focused property-based testing, including stateful testing and failing-case shrinking. Its generator and type-language differences, plus the possibility of repeated filtering, are worth understanding before expressing constraints.

What the maker publishes

Automatic testing
PropEr can test functions automatically using information in their Erlang specifications. source
Constraints
Constraints that cannot be expressed in Erlang's type language can be expressed with custom generators; the FAQ cautions that filtering may keep trying random values until one passes. source
Erlang types
Erlang type declarations can be used as input specifications, and PropEr can generate data from them. source
Installation
The user guide describes obtaining source from GitHub, compiling it with make, or installing it with Homebrew. source
Integrations
The user guide explains using PropEr with EUnit and describes handling a shared ?LET macro and captured output. source
Intended users
PropEr is designed for testing programs written in Erlang, with a focus on pure functions and library modules for stateful code. source
Known limitation
PropEr's generator language and Erlang type language differ for list expressions, allowing generators to specify lists of particular lengths and element types. source
License
PropEr is open-source software distributed under the GPL, version 3 or later. source
Properties
Properties are written using Erlang expressions with predefined macros. source
Purpose
PropEr is a tool for automated, semi-random, property-based testing of Erlang programs. source
Stateful testing
It can also be used for model-based random testing of stateful systems. source
Support
The developers invite comments, suggestions, feature requests, bug reports, patches, and other contributions through the project website, GitHub, or email. source
Targeted testing
Recent releases support targeted property-based testing, which brings search-based testing techniques into property-based testing. source

Checked against the maker's pages on 5 Oct 2026.