About the Port on genhttp-kt

Coming from GenHTTP

Mon, 01 Jan 0001 00:00:00 +0000

If you know GenHTTP, you already know genhttp-kt. The API is the same - the same builders, modules, handlers and concerns - written the way a Kotlin developer expects. This page shows how C# translates, so you can use the samples you find for GenHTTP, and the GenHTTP documentation itself, with genhttp-kt.

The samples on this page have a C# and a Kotlin tab. Choose one and every sample of the page switches with it.

Deviations

Mon, 01 Jan 0001 00:00:00 +0000

genhttp-kt keeps the API and the behavior of GenHTTP. Where the JVM, Kotlin or a library requires a different solution, the port says so - this page lists every such place, grouped by the area you will meet it in. The complete log is DEVIATIONS.md in the repository.

The one you are most likely to trip over: Kotlin does not allow annotations or default values on lambda parameters. A functional handler that needs @FromBody or an optional parameter is written as a function reference (post(::create)), see Coming from GenHTTP.

Versions and Sync

Mon, 01 Jan 0001 00:00:00 +0000

Versions

Versions of genhttp-kt have four components: the version of GenHTTP the port is based on, followed by a counter of releases of the port itself.

Version	Meaning
`11.1.0.0`	The first release based on GenHTTP `11.1.0`
`11.1.0.1`	A release of the port only - a fix in the port, updated libraries
`11.2.0.0`	The first release based on GenHTTP `11.2.0` - the counter resets

Gradle and Maven order these versions correctly, and the tags of the repository are named after them (v11.1.0.0). This documentation describes genhttp-kt 11.1.0.3, based on GenHTTP 11.1.0.