Skip to content
🤔 Documentation issue? Report or edit

Changelog

All important changes of this project must be documented in this file.

The format is based on Keep a Changelog and this project orients towards Semantic Versioning. Note: This project needs KSP to work and every new Ktorfit with an update of the KSP version is technically a breaking change. But there is no intent to bump the Ktorfit major version for every KSP update.

Unreleased

  • Supported Kotlin version:
  • Supported KSP version:
  • Ktor version:

Fixed

OptIn annotations on interfaces and functions will now be propagated to the generated classes.

2.1.0

  • Supported Kotlin version: 2.0.0; 2.0.10; 2.0.20, 2.1.0-Beta1
  • Supported KSP version: 1.0.24; 1.0.25
  • Ktor version: 2.3.12

Added

Changed

  • Allow Http Delete with Body #647
  • By default, nullable response types will not throw an exception. You can now override this behavior by adding the DontSwallowExceptionsConverterFactory or your own ConverterFactory to the converterFactories. #618

Fixed

  • Task with path ‘kspCommonMainKotlinMetadata’ not found in project #593
  • Ktorfit Gradle Plugin not compatible with Android Multiplatform Library plugin #638

Ktor3

The “normal” dependencies will stay on Ktor 2.x till 3.0 is stable. But here are versions that you can use when want to use Ktor3 and WasmJs

de.jensklingenberg.ktorfit:ktorfit-lib-light-ktor-3.0.0-beta-2:2.1.0

de.jensklingenberg.ktorfit:ktorfit-lib-ktor-3.0.0-beta-2:2.1.0

de.jensklingenberg.ktorfit:ktorfit-converters-flow-ktor-3.0.0-beta-2:2.1.0

de.jensklingenberg.ktorfit:ktorfit-converters-call-ktor-3.0.0-beta-2:2.1.0

de.jensklingenberg.ktorfit:ktorfit-converters-response-ktor-3.0.0-beta-2:2.1.0

2.0.1

  • Supported Kotlin version: (min) 2.0.0 (max) 2.0.20
  • Supported KSP version: (min) 1.0.24 (max) 1.0.24
  • Ktor version: 2.3.12

2.0.1 - 2024-08-08

Fixed

  • Endpoint with types from other module #594
  • Ktorfit plugin doesn’t include correct generate source if build directory changes #591
  • RequestConverter causing compile error #621
  • Build with Ktor 2.3.12

ktorfit-annotations

  • 2.0.1: The annotations are now also available for WasmJs

compilerPlugin

  • Kotlin 2.0.0: 2.0.1-2.0.0 - 2024-08-08
  • Kotlin 2.0.10: 2.0.1-2.0.10 - 2024-08-10
  • Kotlin 2.0.20-RC: 2.0.1-2.0.20-RC - 2024-08-13
  • Kotlin 2.0.20-RC2: 2.0.1-2.0.20-RC2 - 2024-08-13
  • Kotlin 2.0.20: 2.0.1-2.0.20 - 2024-08-23

ktorfit-ksp

  • KSP 1.0.24: ktorfit-ksp-2.0.1-1.0.24 - 2024-08-08

Ktor3

The “normal” dependencies will stay on Ktor 2.x till 3.0 is stable. But here are versions that you can use when want to use Ktor3 and WasmJs

Project Version
ktorfit-lib-light-ktor-3.0.0-beta-2 Maven Central
ktorfit-lib-ktor-3.0.0-beta-2 Maven Central
ktorfit-converters-flow-ktor-3.0.0-beta-2 Maven Central
ktorfit-converters-call-ktor-3.0.0-beta-2 Maven Central
ktorfit-converters-response-ktor-3.0.0-beta-2 Maven Central

2.0.0

ktorfit-ksp-2.0.0-1.0.24 - 2024-08-06

  • Build with KSP 1.0.24

ktorfit-ksp-2.0.0-1.0.23 - 2024-07-14

- Build with KSP 1.0.23

ktorfit-ksp-2.0.0-1.0.22 - 2024-06-06

  • Build with KSP 1.0.22

2.0.0 - 2024-05-27

Changed

  • Build with KSP 1.0.21, Kotlin 2.0.0, Ktor 2.3.11
  • The needed dependencies for Ktorfit KSP processor are now included in the Ktorfit Gradle plugin. You can remove the ksp() block from your build.gradle.kts file. You still need to apply the KSP plugin. 
plugins {
id("com.google.devtools.ksp") version "CURRENT_KSP_VERSION"
id("de.jensklingenberg.ktorfit") version "2.0.0"
}

See the installation guide for more information: https://foso.github.io/Ktorfit/installation/

  • The code that is generated by KSP is now accessible from the module where the interface is defined. That means code from commonMain can now find the generated code. Generated code from the platform specific code is still only available from the specific modules.
  • The create function is now deprecated. The reason for that is that it is relying on a compiler plugin to work. This can lead to compile errors when the class can’t be found. The plan is to get rid of the plugin. When your project is configured correct, the autocompletion should show an extension function create followed by the name of the interface. This function will not trigger the compiler plugin
val api = ktorfit.create<ExampleApi>()

replace with:

val api = ktorfit.createExampleApi()

Breaking Changes

The deprecated code got removed. This will simplify the codebase and make it easier to maintain. When you haven’t used the deprecated converters, there is not much you need to change. The dependencies for the converters that were previously auto added now need to be added manually. See the migration guide for more information: https://foso.github.io/Ktorfit/migration/#from-2-to-200

  • QualifiedTypeName in Ktorfit

In the previous versions of Ktorfit, the qualifiedTypename was always generated in the code. This was used in the TypeData.createTypeData() function to provide a fully qualified type name for the data type being used.

val _typeData = TypeData.createTypeData(
    typeInfo = typeInfo<Call<People>>(),
    qualifiedTypename = "de.jensklingenberg.ktorfit.Call<com.example.model.People>"
)

In the new version of Ktorfit, this behavior has been changed. Now, by default, Ktorfit will keep qualifiedTypename for TypeData in the generated code empty. This means that the qualifiedTypename will not be automatically generated.

val _typeData = TypeData.createTypeData(
    typeInfo = typeInfo<Call<People>>(),
)

However, if you want to keep the old behavior and generate qualifiedTypename, you can set it in the Ktorfit config generateQualifiedTypeName to true in your build.gradle.kts file.

build.gradle.kts
ktorfit {
  generateQualifiedTypeName = true
}

This change was made to provide more flexibility and control to the developers over the generated code. Please update your code accordingly if you were relying on the automatic generation of qualifiedTypename.

Fixed

2.0.0-rc01 - 2024-05-19

2.0.0-beta1 - 2024-04-28

Breaking Changes

The deprecated code got removed. This will simplify the codebase and make it easier to maintain. When you haven’t used the deprecated converters, there is not much you need to change. Some converters that were previously auto applied now need to be added manually. See the migration guide for more information: https://foso.github.io/Ktorfit/migration/#from-2-to-200

QualifiedTypeName in Ktorfit

In the previous versions of Ktorfit, the qualifiedTypename was always generated in the code. This was used in the TypeData.createTypeData() function to provide a fully qualified type name for the data type being used.

val _typeData = TypeData.createTypeData(
    typeInfo = typeInfo<Call<People>>(),
    qualifiedTypename = "de.jensklingenberg.ktorfit.Call<com.example.model.People>"
)

In the new version of Ktorfit, this behavior has been changed. Now, by default, Ktorfit will keep qualifiedTypename for TypeData in the generated code empty. This means that the qualifiedTypename will not be automatically generated.

val _typeData = TypeData.createTypeData(
    typeInfo = typeInfo<Call<People>>(),
)

However, if you want to keep the old behavior and generate qualifiedTypename, you can set a KSP argument Ktorfit_QualifiedTypeName to true in your build.gradle.kts file.

ksp {
    arg("Ktorfit_QualifiedTypeName", "true")
}

This change was made to provide more flexibility and control to the developers over the generated code. Please update your code accordingly if you were relying on the automatic generation of qualifiedTypename.

1.14.0 - 2024-04-15

  • Build with KSP 1.0.20, Kotlin 2.0.0-RC1, Ktor 2.3.10

1.13.0 - 2024-04-14

  • Build with KSP 1.0.20, Kotlin 1.9.23, Ktor 2.3.10

1.12.0 - 2024-01-16

  • Compatible with KSP 1.0.16 and Kotlin 1.9.22

1.11.1 - 2023-12-21

  • Fix compile errors #505 #496

1.11.0 - 2023-12-06

Compatible with KSP 1.0.15 and Kotlin 1.9.21

Changed

  • KSP 1.0.15 required
  • Upgrade dependencies: Ktor 2.3.6

1.10.2 - 2023-11-29

Fixed

  • fix compile errors because of missing import #490 #486

1.10.1 - 2023-11-15

Fixed

  • Using @FieldMap generates uncompiled code due to missing import #479

1.10.0 - 2023-11-06

Compatible with KSP 1.0.14 and Kotlin 1.9.20

Added

  • LinuxArm64 support #475

Changed

  • KSP 1.0.14 required
  • Optimized code generation

1.9.1 - 2023-10-22

Compatible with KSP 1.0.13 and Kotlin 1.9.10/1.9.20-RC

When you are still using the Ktorfit Gradle plugin in version 1.0.0, please also update this to 1.9.1

Added

Changed

  • The generated code will not produce warnings anymore

1.8.1 - 2023-10-09

Compatible with KSP 1.0.13 and Kotlin 1.9.10/1.9.20-Beta2

Added

Changed

  • Allow nullable body type #424
  • Use @Path parameter name as default value #426
  • Use @Query parameter name as default value #428
  • Use @Field parameter name as default value #430
  • You can now also get exceptions like NetworkException with SuspendResponseConverter.#389

Deprecated

! When you still use the deprecated converters because there are use cases which you can’t do with the converter factories, please write a GitHub Issue. The deprecated converters will be removed in one of the upcoming versions

Removed

Fixed

Security

1.8.0 - 2023-10-09

Skip this version, it had an issue with Kotlin 1.9.20

1.7.0-1.9.20-Beta2 - 2023-09-16

Version of 1.7.0 that is compatible with Kotlin 1.9.20-Beta2

1.7.0 - 2023-09-16

Gradle plugin

From now on with every Ktorfit release there will also be a Gradle plugin with the same version. That means that drop you can drop the Gradle extension block where you previously set the version number and just bump the number of the Gradle plugin. https://foso.github.io/Ktorfit/installation/

plugins {
id("de.jensklingenberg.ktorfit") version "1.7.0"
}

Added

  • Added a compiler type checks if the type used for the create function is an interface

Changed

  • Upgrade dependencies: Ktor 2.3.4

1.6.0 - 2023-08-24

Changed

  • KSP version 1.9.10-1.0.13 is now required
  • Upgrade dependencies: Ktor 2.3.3

1.5.0 - 2023-08-04

Changed

  • KSP version 1.9.0-1.0.13 is now needed

1.4.4 - 2023-07-26

Changed

  • Upgrade dependencies: Ktor 2.3.2

1.4.3 - 2023-07-13

Fixed

372 Crash with Xiaomi on create Ktorfit.Builder by @princeparadoxes

1.4.2 - 2023-06-25

Fixed

323 Code generation issue for @Multipart / @FormUrlEncoded by @Ph1ll1pp

1.4.1 - 2023-06-03

Changed

  • Upgrade dependencies: Ktor 2.3.1

Fixed

236 Parsing error for list/array

1.4.0 - 2023-05-27

Added

  • 85 Added a Response class that can be used as a wrapper around the API Response, the converter for it is automatically applied. thx to @vovahost, @DATL4G

e.g.

interface ExampleApi{
  suspend fun getUser(): Response<User>
}

val user = userKtorfit.create<ExampleApi>().getUser()

if(user.isSuccessful){
  user.body()
}else{
  user.errorBody()
}
  • Ktorfit is now using converters factories to apply the converters, similar to Retrofit see more here https://foso.github.io/Ktorfit/converters/converters/
  • TypeData now has a field “typeInfo” can be used to convert the Ktor HttpResponse body to the wanted type
  • CallConverterFactory for replacement of CallResponseConverter

  • FlowConverterFactory for replacement of FlowResponseConverter

  • Added support for targets: macosArm64, tvosArm64, tvosX64, tvosSimulatorArm64, watchosSimulatorArm64 #315

Changed

  • Upgrade dependencies: Kotlin 1.8.21

Deprecated

  • ResponseConverter, use Converter.ResponseConverter instead
  • SuspendResponseConverter, use Converter.SuspendResponseConverter instead
  • RequestConverter, use Converter.RequestParameterConverter instead
  • See also: https://foso.github.io/Ktorfit/converters/migration/

1.3.0 - 2023-05-14

Changed

  • Optimized generated code, the generated code that is used for a request will now directly set the Ktor code instead of delegating it to a Ktorfit class. This will make the code easier to understand.

  • KSP version 1.0.11 is now needed

Fixed

[Bug]: IllegalArgumentException with Custom Http Annotation #274

Bumped

KSP version to 1.0.11

1.2.0 - 2023-05-05

Bumped

Now based on Ktor 2.3.0

1.1.0 - 2023-04-15

Added

From now on there are two versions of the ktorfit-lib.

“de.jensklingenberg.ktorfit:ktorfit-lib” will stay like before and add the platform client dependencies for the clients.

“de.jensklingenberg.ktorfit:ktorfit-lib-light” this will only add the client core dependency and not the platform dependencies for the clients. This will give you more control over the used clients, but you have to add them yourself. https://ktor.io/docs/http-client-engines.html Everything else is the same as “ktorfit-lib”

Changed

  • Kotlin version 1.8.20 is now needed
  • KSP version 1.8.20-1.0.10 is now needed

Bumped

  • Kotlin to 1.8.20
  • KSP version to 1.8.20-1.0.10

1.0.1 - 2023-03-20

Added

From now on there are two versions of the ktorfit-lib.

“de.jensklingenberg.ktorfit:ktorfit-lib” will stay like before and add the platform client dependencies for the clients.

“de.jensklingenberg.ktorfit:ktorfit-lib-light” this will only add the client core dependency and not the platform dependencies for the clients. This will give you more control over the used clients, but you have to add them yourself. https://ktor.io/docs/http-client-engines.html Everything else is the same as “ktorfit-lib”

Fixed

[Bug]: Post request body serialization doesn’t work #202

1.0.0 - 2023-03-02

This project is now following semver

Added

  • internal optimizations
  • throw compile error when generated class can not be found

Fixed

  • Timeout throws exception outside of scope of SuspendResponseConverter #127
  • Fix broken/outdated docs link (#140) by @T-Spoon

Bumped

  • based on Ktor 2.2.4

1.0.0-beta18 (12-02-2023)

NEW:

  • You can now disable the check if the baseUrl ends with a /
Ktorfit.Builder().baseUrl(testBaseUrl, checkUrl = false).build()

🐛 Bugs fixed

  • Fixed Ktorfit breaking incremental compilation #110

⬆️ Deps updates

  • based on Ktor 2.2.3

1.0.0-beta17 (21-01-2023)

💥 Breaking changes:

  • Ktorfit now needs an additional gradle plugin. This will solve several issues with multi-module projects.

Add this plugin: 

plugins {
  id "de.jensklingenberg.ktorfit" version "1.0.0"
}

NEW:

  • interfaces can now be internal

🐛 Bugs fixed

  • Ktorfit multiple module support #92
  • Add support for ‘internal’ parameter type #13
  • Duplicate class KtorfitExtKt found in modules moduleA and moduleB #86
  • Android overload resolution ambiguity #64
  • Form data is double encoded #95

⬆️ Deps updates

  • based on Ktor 2.2.2
  • Kotlin 1.8.0
  • KSP 1.8.0-1.0.8
  • update Android TargetSdk to 33

1.0.0-beta16 (13-11-2022)

NEW: - Field parameters can now be nullable, null values will be ignored in requests - Add option to turn of error checking

ksp { arg(“Ktorfit_Errors”, “1”) }

You can set it in your build.gradle.kts file,

0: Turn off all Ktorfit related error checking

1: Check for errors

2: Turn errors into warnings

  • Added RequestConverter support #84

⬆️ Deps updates

  • based on Ktor 2.1.3
  • Kotlin 1.7.21
  • KSP 1.0.8
  • update Android TargetSdk to 33

🐛 Bugs fixed

  • FlowResponseConverter #81

What’s Changed

Full Changelog: https://github.com/Foso/Ktorfit/compare/v1.0.0-beta15...v1.0.0-beta16

1.0.0-beta15 (05-10-2022)

⬆️ Deps updates

  • based on Ktor 2.1.2

🐛 Bugs fixed

  • kotlinx.coroutines.JobCancellationException: Parent job is Completed #70

💥 Breaking changes

  • reverted the api of converters to the state of beta13, see #71
  • when you are updating from beta13, this is the only change to converters: returnTypeName is replaced through typeData, you can use typeData.qualifiedName to get the same value as returnTypeName

1.0.0-beta14 (24-09-2022)

NEW: - Query parameters can now be nullable, null values will be ignored in requests - Function return types can now be nullable

FIX: - Url annotation not resolved correctly #65

BREAKING CHANGES: - Changed naming of Converters:

  • SuspendResponseConverter:
    • is now called RequestConverter
    • the wrapSuspendResponse is now called convertRequest.
    • returnTypeName is replaced through typeData, you can use typeData.qualifiedName to get the same value as returnTypeName RequestConverter need to be added with the requestConverter() on your Ktorfit object.
    • https://foso.github.io/Ktorfit/requestconverter/
  • ResponseConverters:

1.0.0-beta13 (10-09-2022)

  • KtorfitCallResponseConverter and KtorfitSuspendCallResponseConverter are now combined in KtorfitCallResponseConverter
  • based on Ktor 2.1.1

Fixed: - Url annotation not resolved correctly #52

1.0.0-beta12 (31-08-2022)

Breaking Changes:

wrapResponse from SuspendResponseConverter got renamed to wrapSuspendResponse. This add the possibility to have ResponseConverter and SuspendResponseConverter implemented in the same class.

Changes:

  • throw compiler time error when you use @Path without the corresponding value inside the relative url path
  • every generated implementation class of an interface that Ktorfit generates will now contain a “create” ext function that can be used instead of the generic create() function e.g. Let’s say you have a interface GithubService, then you can create an instance like this:

val ktorfit = ktorfit {
baseUrl("http://example.com/")
}.create<GithubService>()
or this

val ktorfit = ktorfit {
baseUrl("http://example.com/")
}.createGithubService()

By default, IntelliJ/Android Studio can’t find the generated code, you need to add the KSP generated folder to the sourcesets like this: (See more here: https://kotlinlang.org/docs/ksp-quickstart.html#make-ide-aware-of-generated-code)

kotlin.srcDir("build/generated/ksp/jvm/jvmMain/")

1.0.0-beta11 (21-08-2022)

  • you can now use ResponseConverter in combination with suspend functions. Implement the SuspendResponseConverter
  • KtorfitCallResponseConverter and FlowResponseConverter moved to de.jensklingenberg.ktorfit.converter.builtin

1.0.0-beta10 (18-08-2022)

  • based on Ktor 2.0.2
  • added windows target #26
  • @PATCH, @POST, @PUT now have a default value #22
  • Ktorfit now uses a builder pattern for setup e.g. change this: kotlin Ktorfit("https://example.com/", HttpClient {})

to this: 

Ktorfit.Builder()
.baseUrl("https://example.com/")
.httpClient(HttpClient {})
.build()

Breaking Changes:

@Headers now requires a vararg of String instead of an Array e.g. you need to change from:

@Headers(
["Authorization: token ghp_abcdefgh",
"Content-Type: application/json"]
)

to this: 

@Headers(
"Authorization: token ghp_abcdefgh",
"Content-Type: application/json"
)

1.0.0-beta09

  • 15 fix encoding of query parameters

1.0.0-beta08

  • fix issue with Koin Annotations

1.0.0-beta07

  • fix issue with FormUrlEncoded
  • based on Ktor 2.0.2

1.0.0-beta06

  • fix issue with KSP 1.0.5 #19

1.0.0-beta05

  • fixed: Custom Http Method with @Body is now possible #6
  • based on Ktor 2.0.1
  • cleanup example project @mattrob33

1.0.0-beta04

initial release

Last update: September 21, 2024