Swift Concurrency - Docs Unclear - Upload Request Progress

[thatMacAdmin]

• [X ] I've read, understood, and done my best to follow the *CONTRIBUTING guidelines.

Problem

The current docs around swift concurrency are unclear. How do you get the progress from AF.upload(file, to: url)

Feature Request

Please update the docs with an upload example.

Value to Alamofire

This will make the new concurrency more accessible to new developers like myself!

[jshier]

UploadRequest has the same progress as DataRequest, as it's a subclass. I don't tend to give UploadRequest specific examples because it has exactly the same interface as DataRequest aside from some upload specific functionality. I guess I can make most references to DataRequest read DataRequest and UploadRequest though.

[thatMacAdmin]

Looking at the docs I coded this:

func upload(file: URL) async throws -> String {
        let putURL = try await self.getPutURL(key: file.lastPathComponent, expiration: 30)
        
        let request = AF.upload(file,to: putURL, method: .put)
        
        for await progress in request.uploadProgress() {
            debugPrint("Progress: \(progress.fractionCompleted * 100)")
        }
        
        guard let etag = await request.validate()
                .serializingData().response.response?.headers["Etag"] else {
                    throw S3Error.unableToDecodeResponse
                }
        
        return etag
    }

But this does not work. It works without the progress block.. but not with. I would post on StackOverflow but this is still pretty new....

[jshier]

It's working correctly, which is why many of my progress examples include throwing the uploadProgress() into its own Task. for await suspends awaiting new values and only completes the loop when progress is complete. Unfortunately, since you suspend before actually starting the request, no progress values are ever received and the code is suspended forever. For progress I recommend still using the older closure APIs.