uploadSplit

This function uploads a file in chunks to an Amazon S3 bucket using the S3Client.

Particularly useful for handling streams of unknown size, since it automatically splits the flow into separate files, allowing for seamless processing and storage.

When the split size exceeds 5MB, the function automatically utilizes S3's multipart file upload to prevent retaining large chunks of data in-memory. If it is smaller, the function uses the put object operation for a quicker and more efficient processing.

val s3Client:  S3Client = ...
val bucket = "my-bucket"
val byteArrayFlow = flowOf<ByteArray> { ... } // A Flow<ByteArray> containing the byte arrays to upload.
val oneMB = 1024 * 1024

s3Client.uploadSplit(bucket = bucket, upstream = byteArrayFlow, splitEach = oneMB) { part ->
    "folder/file-part-$part"
}
.collect { response ->
    println("Uploaded part: ${response.key}")
}

Parameters