feat: add DSL overloads to paginator methods #591

ianbotsf · 2022-02-15T22:36:41Z

Issue #

(none)

Description of changes

This change adds DSL overloads to paginator methods. Previously, the only way to call paginators was with explicit request objects:

val client = SomeClient(…)
val initialRequest = ListItemsRequest {
    foo = …
    bar = …
}
val result = client.listItemsPaginated(initialRequest)

With this new change, paginators can now be called using DSL overloads that create request objects internally:

val client = SomeClient(…)
val result = client.listItemsPaginated {
    foo = …
    bar = …
}

This brings parity with the invocation options available for regular service operations, waiters, config, etc.

A minor change alongside this is an update to the KDoc formatting done in codegen. Previously, all blank lines were removed. Now, only leading, trailing, and consecutive blank lines are removed. This allows KDocs to contain empty lines which denote paragraph breaks.

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

aajtodd · 2022-02-16T14:24:36Z

...odegen/src/main/kotlin/software/amazon/smithy/kotlin/codegen/rendering/PaginatorGenerator.kt

+                $docReturn
+            """.trimIndent())
+            .withBlock(
+                "fun #T.#LPaginated(block: #T.Builder.() -> Unit): #T<#T> =",
