Freedom251 › Property-Based Testing Tools
Scala Hedgehog

What Scala Hedgehog is
Scala Hedgehog is a free property-based testing system for Scala. It generates values for checking properties and uses integrated shrinking to simplify failing cases while preserving the invariants of generated values. Range combinators let developers constrain generated numbers and collections. For stateful software such as web services and database layers, it supports abstract state machine testing. The project provides an SBT test runner and integration modules for Minitest and MUnit; its documentation also describes Gradle support through a Scala plugin. Documented Scala versions are 2.12, 2.13, and 3.3 or later. Binary dependencies for its modules are published through Maven Central, and the core module has no external dependencies. The project describes its release as early, so its API may change before wider adoption. IntelliJ's Scala plugin does not list Hedgehog among its built-in supported test frameworks, although Properties tests can be run as applications. SBT 1.9.1 and later support the testing extension by default; older versions require a testFrameworks setting.
Who it suits
Scala developers who want generated property checks or state-machine tests may find Hedgehog useful. It suits teams using SBT, Minitest, or MUnit, with the caveat that IntelliJ does not list it as a built-in test framework.
What it does well
- Integrated shrinking preserves generated-value invariants.
- Supports state-machine testing for stateful systems.
- Includes SBT, Minitest, and MUnit integrations.
- Core module has no external dependencies.
What to know first
- The project describes the release as early.
- The API may change before wider adoption.
- IntelliJ does not list Hedgehog as a built-in test framework.
Limits
The project describes its release as early and says the API may change until wider adoption. SBT 1.9.0 and earlier require a testFrameworks setting to use the testing extension.
Plans
| Plan | Billed and limits | Price |
|---|---|---|
| Scala Hedgehog | Open-source Scala testing library · no paid plans listed | Free |
As hedgehogqa.github.io lists them, read 4 Oct 2026. The maker's own page has the final word.
Getting started
- Open the Scala Hedgehog project website.
- Add the appropriate published module dependency from Maven Central.
- Use SBT, or use Gradle through a Scala plugin.
- Add the SBT testing extension or an integration module for Minitest or MUnit.
- For SBT 1.9.0 and earlier, configure testFrameworks; for IntelliJ, run Properties tests as applications.
Verdict
Scala Hedgehog offers property-based and stateful testing with shrinking and multiple test integrations. Its early release status and IntelliJ limitation are worth weighing before adopting it.
Questions
How much does Scala Hedgehog cost?
Scala Hedgehog is free, with a listed price of $0. No paid plans are listed.
Which Scala versions does it support?
The documentation lists Scala 2.12, 2.13, and 3.3 or later.
Which test runners and integrations are available?
It includes an SBT testing extension and lists integration modules for Minitest and MUnit. Its documentation also describes Gradle support through a Scala plugin.
Does Scala Hedgehog support stateful testing?
Yes. It supports abstract state machine testing for stateful systems such as web services and database layers.
Is Scala Hedgehog open source?
Yes. It is described as an open-source Scala testing library.
What should IntelliJ users know?
The IntelliJ Scala plugin does not list Hedgehog among its built-in supported test frameworks. The documentation explains that Properties tests can be run as applications.
Facts from Scala Hedgehog's own pages
- Automatic shrinking
- Integrated shrinking simplifies failing test cases while preserving the invariants of generated values. · hedgehogqa.github.io, 4 Oct 2026
- Availability
- The project documents binary dependencies published through Maven Central, including core, runner, SBT, Minitest, and MUnit modules. · hedgehogqa.github.io, 4 Oct 2026
- Build tools
- The getting-started documentation assumes SBT and says Hedgehog is also supported for Gradle through a Scala plugin. · hedgehogqa.github.io, 4 Oct 2026
- Core dependencies
- The core module currently has no external dependencies. · hedgehogqa.github.io, 4 Oct 2026
- Generator control
- Range combinators control the scope of generated numbers and collections. · hedgehogqa.github.io, 4 Oct 2026
- IDE limitation
- The docs say the IntelliJ Scala plugin does not include Hedgehog among its hard-coded supported test frameworks; tests can be run as applications by extending Properties, with the test defined as an object. · hedgehogqa.github.io, 4 Oct 2026
- Integrated shrinking
- Its integrated shrinkers compose with generators, so shrunk values preserve their invariants by construction. · hedgehogqa.github.io, 4 Oct 2026
- IntelliJ limitation
- The docs say IntelliJ's Scala plugin does not list Hedgehog among its hard-coded supported test frameworks, and explain how to run Properties tests as an application instead. · hedgehogqa.github.io, 4 Oct 2026
- Intended users
- The project is for Scala developers who want property-based tests, including tests of stateful systems. · hedgehogqa.github.io, 4 Oct 2026
- Minitest integration
- Scala Hedgehog lists Minitest as an available integration module. · hedgehogqa.github.io, 4 Oct 2026
- MUnit integration
- The hedgehog-munit module supports property-based and example-based Hedgehog tests in an MUnit test suite. · hedgehogqa.github.io, 4 Oct 2026
- Purpose
- Scala Hedgehog is a property-based testing system for Scala, in the spirit of QuickCheck and ScalaCheck. · hedgehogqa.github.io, 4 Oct 2026
- Range controls
- Range combinators control the scope of generated numbers and collections. · hedgehogqa.github.io, 4 Oct 2026
- Release status
- The project describes itself as in an early release and says its API may break until wider adoption. · hedgehogqa.github.io, 4 Oct 2026
- SBT runner
- Hedgehog provides an sbt testing extension; sbt 1.9.1 and higher support it by default, while versions 1.9.0 and lower require a testFrameworks setting. · hedgehogqa.github.io, 4 Oct 2026
- Scala compatibility
- The documentation lists support for Scala 2.12, 2.13, and 3.3+. · hedgehogqa.github.io, 4 Oct 2026
- Scala versions
- The documented supported Scala versions are 2.12, 2.13, and 3.3+. · hedgehogqa.github.io, 4 Oct 2026
- Stateful testing
- It supports abstract state machine testing for stateful systems such as web services and database layers. · hedgehogqa.github.io, 4 Oct 2026
- State testing
- It supports abstract state machine testing for stateful systems. · hedgehogqa.github.io, 4 Oct 2026
- Test integrations
- Integration modules are available for Minitest and MUnit. · hedgehogqa.github.io, 4 Oct 2026
- Test runner
- The project includes an SBT test runner and supports SBT's testing extension. · hedgehogqa.github.io, 4 Oct 2026
Where Scala Hedgehog stands on Freedom251
- Property-Based Testing Tools#20 of 28