KTOR-9037 Make formData inline function

Author: osipxd

ktor-client/ktor-client-core/api/ktor-client-core.api

@@ -1417,6 +1417,7 @@ public final class io/ktor/client/request/forms/ChannelProvider {
 }
 
 public final class io/ktor/client/request/forms/FormBuilder {
+	public fun <init> ()V
 	public final fun append (Lio/ktor/client/request/forms/FormPart;)V
 	public final fun append (Ljava/lang/String;Lio/ktor/client/request/forms/ChannelProvider;Lio/ktor/http/Headers;)V
 	public final fun append (Ljava/lang/String;Lio/ktor/client/request/forms/InputProvider;Lio/ktor/http/Headers;)V
@@ -1440,6 +1441,7 @@ public final class io/ktor/client/request/forms/FormBuilder {
 	public static synthetic fun append$default (Lio/ktor/client/request/forms/FormBuilder;Ljava/lang/String;[Ljava/lang/String;Lio/ktor/http/Headers;ILjava/lang/Object;)V
 	public final fun appendInput (Ljava/lang/String;Lio/ktor/http/Headers;Ljava/lang/Long;Lkotlin/jvm/functions/Function0;)V
 	public static synthetic fun appendInput$default (Lio/ktor/client/request/forms/FormBuilder;Ljava/lang/String;Lio/ktor/http/Headers;Ljava/lang/Long;Lkotlin/jvm/functions/Function0;ILjava/lang/Object;)V
+	public final fun build ()Ljava/util/List;
 }
 
 public final class io/ktor/client/request/forms/FormBuildersKt {

ktor-client/ktor-client-core/api/ktor-client-core.klib.api

@@ -889,6 +889,8 @@ final class io.ktor.client.request.forms/ChannelProvider { // io.ktor.client.req
 }
 
 final class io.ktor.client.request.forms/FormBuilder { // io.ktor.client.request.forms/FormBuilder|null[0]
+    constructor <init>() // io.ktor.client.request.forms/FormBuilder.<init>|<init>(){}[0]
+
     final fun <#A1: kotlin/Any> append(io.ktor.client.request.forms/FormPart<#A1>) // io.ktor.client.request.forms/FormBuilder.append|append(io.ktor.client.request.forms.FormPart<0:0>){0§<kotlin.Any>}[0]
     final fun <#A1: kotlin/Any> append(kotlin/String, #A1, io.ktor.http/Headers = ...) // io.ktor.client.request.forms/FormBuilder.append|append(kotlin.String;0:0;io.ktor.http.Headers){0§<kotlin.Any>}[0]
     final fun append(kotlin/String, io.ktor.client.request.forms/ChannelProvider, io.ktor.http/Headers = ...) // io.ktor.client.request.forms/FormBuilder.append|append(kotlin.String;io.ktor.client.request.forms.ChannelProvider;io.ktor.http.Headers){}[0]
@@ -901,6 +903,7 @@ final class io.ktor.client.request.forms/FormBuilder { // io.ktor.client.request
     final fun append(kotlin/String, kotlin/String, io.ktor.http/Headers = ...) // io.ktor.client.request.forms/FormBuilder.append|append(kotlin.String;kotlin.String;io.ktor.http.Headers){}[0]
     final fun append(kotlin/String, kotlinx.io/Source, io.ktor.http/Headers = ...) // io.ktor.client.request.forms/FormBuilder.append|append(kotlin.String;kotlinx.io.Source;io.ktor.http.Headers){}[0]
     final fun appendInput(kotlin/String, io.ktor.http/Headers = ..., kotlin/Long? = ..., kotlin/Function0<kotlinx.io/Source>) // io.ktor.client.request.forms/FormBuilder.appendInput|appendInput(kotlin.String;io.ktor.http.Headers;kotlin.Long?;kotlin.Function0<kotlinx.io.Source>){}[0]
+    final fun build(): kotlin.collections/List<io.ktor.client.request.forms/FormPart<*>> // io.ktor.client.request.forms/FormBuilder.build|build(){}[0]
 }
 
 final class io.ktor.client.request.forms/FormDataContent : io.ktor.http.content/OutgoingContent.ByteArrayContent { // io.ktor.client.request.forms/FormDataContent|null[0]
@@ -1515,7 +1518,6 @@ final fun io.ktor.client.plugins/SocketTimeoutException(io.ktor.client.request/H
 final fun io.ktor.client.plugins/convertLongTimeoutToIntWithInfiniteAsZero(kotlin/Long): kotlin/Int // io.ktor.client.plugins/convertLongTimeoutToIntWithInfiniteAsZero|convertLongTimeoutToIntWithInfiniteAsZero(kotlin.Long){}[0]
 final fun io.ktor.client.plugins/convertLongTimeoutToLongWithInfiniteAsZero(kotlin/Long): kotlin/Long // io.ktor.client.plugins/convertLongTimeoutToLongWithInfiniteAsZero|convertLongTimeoutToLongWithInfiniteAsZero(kotlin.Long){}[0]
 final fun io.ktor.client.request.forms/formData(kotlin/Array<out io.ktor.client.request.forms/FormPart<*>>...): kotlin.collections/List<io.ktor.http.content/PartData> // io.ktor.client.request.forms/formData|formData(kotlin.Array<out|io.ktor.client.request.forms.FormPart<*>>...){}[0]
-final fun io.ktor.client.request.forms/formData(kotlin/Function1<io.ktor.client.request.forms/FormBuilder, kotlin/Unit>): kotlin.collections/List<io.ktor.http.content/PartData> // io.ktor.client.request.forms/formData|formData(kotlin.Function1<io.ktor.client.request.forms.FormBuilder,kotlin.Unit>){}[0]
 final fun io.ktor.client.request/request(kotlin/Function1<io.ktor.client.request/HttpRequestBuilder, kotlin/Unit>): io.ktor.client.request/HttpRequestBuilder // io.ktor.client.request/request|request(kotlin.Function1<io.ktor.client.request.HttpRequestBuilder,kotlin.Unit>){}[0]
 final fun io.ktor.client.utils/buildHeaders(kotlin/Function1<io.ktor.http/HeadersBuilder, kotlin/Unit> = ...): io.ktor.http/Headers // io.ktor.client.utils/buildHeaders|buildHeaders(kotlin.Function1<io.ktor.http.HeadersBuilder,kotlin.Unit>){}[0]
 final fun io.ktor.client/HttpClient(io.ktor.client.engine/HttpClientEngine, kotlin/Function1<io.ktor.client/HttpClientConfig<*>, kotlin/Unit>): io.ktor.client/HttpClient // io.ktor.client/HttpClient|HttpClient(io.ktor.client.engine.HttpClientEngine;kotlin.Function1<io.ktor.client.HttpClientConfig<*>,kotlin.Unit>){}[0]
@@ -1526,6 +1528,7 @@ final inline fun <#A: kotlin/Any?> io.ktor.client.plugins/unwrapRequestTimeoutEx
 final inline fun <#A: reified kotlin/Any?> (io.ktor.client.plugins.sse/SSESessionWithDeserialization).io.ktor.client.plugins.sse/deserialize(io.ktor.sse/TypedServerSentEvent<kotlin/String>): #A? // io.ktor.client.plugins.sse/deserialize|deserialize@io.ktor.client.plugins.sse.SSESessionWithDeserialization(io.ktor.sse.TypedServerSentEvent<kotlin.String>){0§<kotlin.Any?>}[0]
 final inline fun <#A: reified kotlin/Any?> (io.ktor.client.plugins.sse/SSESessionWithDeserialization).io.ktor.client.plugins.sse/deserialize(kotlin/String?): #A? // io.ktor.client.plugins.sse/deserialize|deserialize@io.ktor.client.plugins.sse.SSESessionWithDeserialization(kotlin.String?){0§<kotlin.Any?>}[0]
 final inline fun <#A: reified kotlin/Any?> (io.ktor.client.request/HttpRequestBuilder).io.ktor.client.request/setBody(#A) // io.ktor.client.request/setBody|[email protected](0:0){0§<kotlin.Any?>}[0]
+final inline fun io.ktor.client.request.forms/formData(kotlin/Function1<io.ktor.client.request.forms/FormBuilder, kotlin/Unit>): kotlin.collections/List<io.ktor.http.content/PartData> // io.ktor.client.request.forms/formData|formData(kotlin.Function1<io.ktor.client.request.forms.FormBuilder,kotlin.Unit>){}[0]
 final suspend fun (io.ktor.client.call/HttpClientCall).io.ktor.client.call/save(): io.ktor.client.call/HttpClientCall // io.ktor.client.call/save|[email protected](){}[0]
 final suspend fun (io.ktor.client.plugins.cache.storage/CacheStorage).io.ktor.client.plugins.cache.storage/store(io.ktor.client.statement/HttpResponse): io.ktor.client.plugins.cache.storage/CachedResponseData // io.ktor.client.plugins.cache.storage/store|[email protected](io.ktor.client.statement.HttpResponse){}[0]
 final suspend fun (io.ktor.client.plugins.cache.storage/CacheStorage).io.ktor.client.plugins.cache.storage/store(io.ktor.client.statement/HttpResponse, kotlin.collections/Map<kotlin/String, kotlin/String>, kotlin/Boolean = ...): io.ktor.client.plugins.cache.storage/CachedResponseData // io.ktor.client.plugins.cache.storage/store|[email protected](io.ktor.client.statement.HttpResponse;kotlin.collections.Map<kotlin.String,kotlin.String>;kotlin.Boolean){}[0]

ktor-client/ktor-client-core/common/src/io/ktor/client/request/forms/formDsl.kt

@@ -1,16 +1,19 @@
 /*
-* Copyright 2014-2021 JetBrains s.r.o and contributors. Use of this source code is governed by the Apache 2.0 license.
-*/
+ * Copyright 2014-2025 JetBrains s.r.o and contributors. Use of this source code is governed by the Apache 2.0 license.
+ */
 
 package io.ktor.client.request.forms
 
 import io.ktor.http.*
 import io.ktor.http.content.*
 import io.ktor.utils.io.*
 import io.ktor.utils.io.core.*
-import kotlinx.io.*
 import kotlinx.io.Buffer
-import kotlin.contracts.*
+import kotlinx.io.Sink
+import kotlinx.io.Source
+import kotlin.contracts.ExperimentalContracts
+import kotlin.contracts.InvocationKind
+import kotlin.contracts.contract
 
 /**
  * A multipart form item. Use it to build a form in client.
@@ -83,15 +86,15 @@ public fun formData(vararg values: FormPart<*>): List<PartData> {
  *
  * [Report a problem](https://ktor.io/feedback/?fqname=io.ktor.client.request.forms.formData)
  */
-public fun formData(block: FormBuilder.() -> Unit): List<PartData> =
+public inline fun formData(block: FormBuilder.() -> Unit): List<PartData> =
     formData(*FormBuilder().apply(block).build().toTypedArray())
 
 /**
  * A form builder type used in the [formData] builder function.
  *
  * [Report a problem](https://ktor.io/feedback/?fqname=io.ktor.client.request.forms.FormBuilder)
  */
-public class FormBuilder internal constructor() {
+public class FormBuilder @PublishedApi internal constructor() {
     private val parts = mutableListOf<FormPart<*>>()
 
     /**
@@ -209,6 +212,7 @@ public class FormBuilder internal constructor() {
         parts += part
     }
 
+    @PublishedApi
     internal fun build(): List<FormPart<*>> = parts
 }