Last updated
Last updated
Skribe is the Yin to Yang. It is a Gradle plugin for generating Ktor API Client boilerplate from an OpenAPI specification.
Unlike other OpenAPI generators, Skribe does not generate an entire app. Instead, it relies on Kotlin extension functions to provide type-safe generated functions for each API call. This allows you to use the generated code in a highly flexible manner, taking the routes that you wish to leverage, without having to translate them from the definition yourself.
Skribe is still very early in development. There are many OpenAPI features that are not supported, and likely many bugs in the code generation. If you encounter any issues, please open an issue
Skribe is a gradle plugin available via the Gradle Plugin Portal. As such, it can be easily added to any Gradle project by declaring it in the plugins block
To set up the plugin, you can then configure the extension properties
Then, if you run ./gradlew skribeGenerate -q
you will see your glorious generated code!