kotlin-minutest: the missing docs ... how to use @testfactory

minutest-testfactory-example.kt

// see: https://github.com/dmcg/minutest/blob/master/docs/README.md
// see: https://github.com/dmcg/minutest/blob/master/docs/installation.md
// gradle dependency (jcenter): testImplementation("dev.minutest:minutest:1.9.+")

// how to use?
class FooTests {

    @TestFactory
    fun `some dynamic tests`() = rootContext {
       test(name="a test") {
          // asertions
       }
       test(name="another test") {
          // asertions
       }
    }.toTestFactory()
    
   @TestFactory
    fun `some other dynamic tests`() = rootContext {
       test(name="a test") {
          // asertions
       }
       test(name="another test") {
          // asertions
       }
    }.toTestFactory()
    
    @TestFactory
    fun `some other tests`() = minuTestFactory(name="some other tests") {
       test(name="a test") {
          // asertions
       }
       test(name="another test") {
          // asertions
       }
    }
}



@JvmName("minuTestFactoryForClass")
inline fun <reified F> minuTestFactory(
        name:String= "root",
        noinline builder: TestContextBuilder<Unit, F>.() -> Unit
): Stream<out DynamicNode> = rootContext(name,builder).toTestFactory()


fun minuTestFactory(name:String= "root", builder: TestContextBuilder<Unit, Unit>.() -> Unit): Stream<out DynamicNode> =
        minuTestFactory<Unit>(name, builder)