Apply Kt ArbitraryBuilder changes into ArbitrayBuilderCandidateListExtensions

[chanhyeong]

Describe the feature you request

I've used ArbitraryBuilderGroup like below.

class UserBuilderGroup : ArbitraryBuilderGroup {
    override fun generateCandidateList(): ArbitraryBuilderCandidateList {
        return ArbitraryBuilderCandidateList.create()
            .add(::user)
    }

    private fun user(builder: ArbitraryBuilder<User>) =
        builder
            .setExp(User::gender, Arbitraries.of("f", "m"))

    ...
}

There are ide warnings for using deprecated method setExp. (related #850)
Because the method ArbitraryBuilderCandidateList.add in ArbitraryBuilderCandidateListExtensions receive ArbitraryBuilder type.

(Optional): Suggest A Solution

Deprecate the existing one and add another method.

@Deprecated(
    message = "Extension function is deprecated. Use the method below.",
    replaceWith = ReplaceWith("addKt(builder)")
)
inline fun <reified T : Any?> ArbitraryBuilderCandidateList.add(
    noinline builder: (ArbitraryBuilder<T>) -> ArbitraryBuilder<T>
): ArbitraryBuilderCandidateList =
    this.add(
        ArbitraryBuilderCandidateFactory.of(object : TypeReference<T>() {})
            .builder(builder)
    )

inline fun <reified T : Any?> ArbitraryBuilderCandidateList.addKt(
    noinline builder: (KotlinTypeDefaultArbitraryBuilder<T>) -> KotlinTypeDefaultArbitraryBuilder<T>
): ArbitraryBuilderCandidateList =
    this.add(
        // add new factory method in ArbitraryBuilderCandidateFactory as well.
        ArbitraryBuilderCandidateFactory.of(object : TypeReference<T>() {}) { fixtureMonkey, _ ->
            fixtureMonkey.giveMeKotlinBuilder<T>()
        }.builder {
            return@builder builder.invoke(it as KotlinTypeDefaultArbitraryBuilder<T>)
        }
    )

If the feature request is approved, would you be willing to submit a PR?

Yes

[seongahjo]

@chanhyeong
Hello, thank you for the great proposal!

It might be better to use the term addKotlinBuilder' Although it is verbose, it maintains consistency with the addJavaBuilder.