Feature: add a new get_uploaded_file_objects that generates structued objects with the file metadata

[edgarrmondragon]

Feature Type

Other

Description

The current options for retrieving uploaded files are

1. Client.get_uploaded_files
2. Client.download_files

The first one returns the raw response from LimeSurvey, and leaves everything else up to the user: base64-decoding the contents, inspect the response dictionary for the filename, size and other keys, etc. The second one offers little flexibility as files as access to the Python file-like objects is hidden to the user.

A new Client.get_uploaded_file_objects that yields instance of a new UploadedFile dataclass would give the users flexibility while doing the grunt work of inspecting the dictionary and decoding the contents for them.