Kwik
Property-based testing library for Kotlin.
Main features:
- Test-engine agnostic
- Multiplatform
- No reflection
- Configurable built-in generators
- Easy way to create and combine generators
- Seeded generation for reproducible results
Find more information on https://kwik.readthedocs.io
Status
This project is discontinued. For property based testing with Kotlin, check out kotest.
How it looks like
class PlusOperatorTest {
@Test
fun isCommutative() = forAll { x: Int, y: Int ->
x + y == y + x
}
@Test
fun isAssociative() = forAll(iterations = 1000) { x: Int, y: Int, z: Int ->
(x + y) + z == x + (y + z)
}
@Test
fun zeroIsNeutral() = forAll(seed = -4567) { x: Int ->
x + 0 == x
}
}
For more information read the usage and look at the available generators
Motivation
Property based testing is great and very powerful. But despite the fact that many good libraries already exist, none of them fully fit my needs.
The known alternatives either:
- Are bound to a specific test-engine
- Can only be used when compiling kotlin to Java (and cannot be used in multi-platform projects)
- Relies on reflection, making the tests slower and make some errors detectable only at runtime
- Do not allow enough freedom and safety to customize existing generators
- Force the user to add unwanted dependencies in the classpath
Requirements
- Kotlin version: 1.4.0 or newer
- JDK version: 8, 11 or 15
Setup
Example of setup using gradle.
repositories {
jcenter()
}
dependencies {
testCompile("com.github.jcornaz.kwik:kwik-core-jvm:$kwikVersion")
}
Find more detailed information in the setup instructions.
0 Mar 30, 2022
1 Oct 4, 2022
61 Nov 20, 2022
2 Aug 22, 2022
23 Nov 9, 2022
7 Aug 29, 2022
1 Apr 9, 2022
6 Oct 18, 2022
21 Sep 21, 2022
3 Jan 10, 2022
420 Nov 29, 2022
38 Nov 28, 2022
2 Oct 2, 2021
0 Jan 4, 2022
2 Apr 14, 2022