Multipart streaming interface update

[nggit]

Added the part.stream(), a per-part streaming method to make it simpler to use and more intuitive.

# `part` represents a field/file received in a multipart request
async for part in request.files(max_file_size=16384):
    filename = part['filename']
    # ...
    # stream a (possibly) large part in chunks
    async for data in part.stream():
        # ...

    # NOTE: `part['data']` is `pop()`ed and
    # the second `stream()` call on the same `part` is a no-op
    async for data in part.stream():
        raise ValueError  # should not raised!

This change does not break the old way.

# `part` represents a field/file received in a multipart request
async for part in request.files(max_file_size=16384):
    filename = part['filename']
    # ...
    data = part['data']
    # ...
    if part['eof']:
        # end of a multipart field/file
    else:
        # this is a partial file

See the full example: https://github.com/nggit/tremolo/blob/main/examples/upload_and_save.py

[sonarqubecloud]

Quality Gate failed

Failed conditions
C Reliability Rating on New Code (required ≥ A)
C Maintainability Rating on New Code (required ≥ A)

See analysis details on SonarQube Cloud

Catch issues before they fail your Quality Gate with our IDE extension SonarQube for IDE