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

Fixed

#594 Endpoint with types from other module
#591 Ktorfit plugin doesn't include correct generate source if build directory changes #591

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.

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

Fixes #548

2.0.0-rc01 - 2024-05-19

Build with KSP 1.0.20, Kotlin 2.0.0-RC3, Ktor 2.3.11
Optimize code generation
Fixes #548

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

Add Tag annotation https://foso.github.io/Ktorfit/requests/#tag

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

Deprecated the convert function in the SuspendResponseConverter interface See: https://foso.github.io/Ktorfit/migration/#from-170-to-181

! 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

build(deps): bump logback-classic from 1.4.0 to 1.4.3 by @dependabot in #74
Foso/revert converters changes by @Foso in #76
67 add nullable field parameters support by @Foso in #80
fix: FlowResponseConverter by @Foso in #81
Added RequestConverter support by @DATL4G in #84
feat: add option to turn off error checking #77 by @Foso in #88

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:
  - returnTypeName is replaced through typeData, you can use typeData.qualifiedName to get the same value as returnTypeName https://foso.github.io/Ktorfit/responseconverter/

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:

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

Files

CHANGELOG.md

Latest commit

History

CHANGELOG.md

File metadata and controls

Changelog

Unreleased

Fixed

2.0.0 - 2024-05-27

Changed

Breaking Changes

Fixed

2.0.0-rc01 - 2024-05-19

2.0.0-beta1 - 2024-04-28

Breaking Changes

QualifiedTypeName in Ktorfit

1.14.0 - 2024-04-15

1.13.0 - 2024-04-14

1.12.0 - 2024-01-16

1.11.1 - 2023-12-21

1.11.0 - 2023-12-06

Changed

1.10.2 - 2023-11-29

Fixed

1.10.1 - 2023-11-15

Fixed

1.10.0 - 2023-11-06

Added

Changed

1.9.1 - 2023-10-22

Added

Changed

1.8.1 - 2023-10-09

Added

Changed

Deprecated

Removed

Fixed

Security

1.8.0 - 2023-10-09

1.7.0-1.9.20-Beta2 - 2023-09-16

1.7.0 - 2023-09-16

Gradle plugin

Added

Changed

1.6.0 - 2023-08-24

Changed

1.5.0 - 2023-08-04

Changed

1.4.4 - 2023-07-26

Changed

1.4.3 - 2023-07-13

Fixed

1.4.2 - 2023-06-25

Fixed

1.4.1 - 2023-06-03

Changed

Fixed

1.4.0 - 2023-05-27

Added

Changed

Deprecated

1.3.0 - 2023-05-14

Changed

Fixed

Bumped

1.2.0 - 2023-05-05

Bumped

1.1.0 - 2023-04-15

Added

Changed

Bumped

1.0.1 - 2023-03-20

Added

Fixed

1.0.0 - 2023-03-02

Added

Fixed

Bumped