uploadFiles

abstract suspend fun uploadFiles(requests: List<UploadFileRequest>, maxConcurrency: Int = 5, onProgress: UploadFileProgressListener<MultiFileProgress>? = null): List<UploadFileResult>

Uploads multiple files with controlled concurrency.

Return

A list of UploadFileResult objects (one per request).

Parameters

requests

The list of upload requests.

maxConcurrency

Maximum number of concurrent uploads. Defaults to 5.

onProgress

Optional listener for per-file upload progress.

Samples

// To upload multiple files, use uploadFiles() function.

val defaultFilesPath = "path/to"
val uploadFilesRequests = listOf<UploadFileRequest>(
    UploadFileRequest(
        file = KoryFile.fromPath("$defaultFilesPath/first/file.ext"),
    ),
    UploadFileRequest(
        file = KoryFile.fromPath("$defaultFilesPath/seconds/file.ext"),
    )
)

val response: List<UploadFileResult> = client.uploadFiles(
    requests = uploadFilesRequests,
    maxConcurrency = 2, // Number of concurrently open connections (default: 5).
    onProgress = { progress ->
        val fileName = progress.fileName
        println("Uploading your file with name $fileName\nProgress: ${progress.percentage}%")
    }
)

println(response.joinToString(separator = "\n") { it.printableOutput() })

abstract suspend fun uploadFiles(maxConcurrency: Int = 5, onProgress: UploadFileProgressListener<MultiFileProgress>? = null, block: UploadFilesRequestBuilder.() -> Unit): List<UploadFileResult>

Uploads multiple files using the request DSL.

Return

A list of UploadFileResult objects (one per request).

Parameters

maxConcurrency

Maximum number of concurrent uploads. Defaults to 5.

onProgress

Optional listener for per-file upload progress.

block

DSL builder for configuring the upload requests.

See also

Samples

// To upload multiple files, use uploadFiles() function.
val response: List<UploadFileResult> = client.uploadFiles(
    maxConcurrency = 2, // Number of concurrently open connections (default: 5).
    onProgress = { progress ->
        val fileName = progress.fileName
        println("Uploading your file with name $fileName\nProgress: ${progress.percentage}%")
    }
) {
    fileFromPath("path/to/first/file.ext")
    fileFromPath("path/to/second/file.ext")
}

println(response.joinToString(separator = "\n") { it.printableOutput() })