Gradle Kotlin build script example

[roded]

Hi,
A Gradle Kotlin build script example (kts) would be very useful for easier adoption.

Specifically, I'm trying to understand how to get the following to work:

tasks.register<GenerateAndAggregateDocumentsTask>("configurationDocumentation") {
    documentName = "my-doc"
    documentDescription = "configuration documentation"
    type = TemplateType.ADOC
    outputFile = file("docs/configuration-options.adoc")
    asciiDocCustomization(closureOf<AsciiDocTemplateCustomization> {
        isIncludeUnknownGroup = false
    })
...

Thanks!

[roded]

This is it apparently:

    asciiDocCustomization(delegateClosureOf<AsciiDocTemplateCustomization> {
        isIncludeUnknownGroup = false
        isIncludeGenerationDate = false
        isRemoveEmptyGroups = true
    })

[nandorholozsnyak]

I'm happy to accept pull requests, I do not have enough experience with the Kotlin DSL, I would be happy if an experienced person would do it.

If not then I can do it in the future, but I do not have any ETA on these things.

[nandorholozsnyak]

Hey @roded
Were you able to set it up with Kotlin DSL? How was/is the experience?

[roded]

Hi @nandorholozsnyak , it was just fine. Here's an example:

val configDocs = tasks.register<GenerateAndAggregateDocumentsTask>("configDocs") {
    documentName = "Configuration Options"
    documentDescription = "configuration documentation"
    type = TemplateType.ADOC
    outputFile = file("${projectDir}/docs/modules/configuration/pages/worker-configuration-options.adoc")

    asciiDocCustomization(delegateClosureOf<AsciiDocTemplateCustomization> {
        isIncludeUnknownGroup = false
        isIncludeGenerationDate = false
        isRemoveEmptyGroups = true
        templateMode = TemplateMode.COMPACT
        contentCustomization(delegateClosureOf<ContentCustomization> {
            isIncludeDeprecation = false
        })
    })

    // TODO (rodedb): Calculate dependent modules at runtime
    val workerModule = AggregationInput()
    workerModule.name = "worker"
    workerModule.input = file("${projectDir}/worker")
    metadataInputs.add(workerModule)

    val awsStarterModule = AggregationInput()
    awsStarterModule.name = "starter-aws"
    awsStarterModule.input = file("spring-boot/starter-aws-springboot3")
    metadataInputs.add(awsStarterModule)

    outputs.upToDateWhen { false }
}

I've manually edited the code above to remote internal names so it might not be perfect.
I did not yet manage to figure out how to calculate the Gradle module dependencies at task runtime though.