Add support for filename, content-type and headers when uploading files
The requests library has support for passing additional information, such as the intended filename on upload, the content-type and additional headers, by passing a tuple with 2, 3 or 4 elements instead of just a file object.
See "POST a Multipart-Encoded File" in the requests documentation for more details: https://requests.readthedocs.io/en/latest/user/quickstart/#post-a-multipart-encoded-file
Extend aptly_api files API to also be able to take similar tuples when uploading files to Aptly.
One useful use case is to pass a proper package filename, in cases where packages are generated simply as
<name>.debby upstream projects (usually via non native Debian build systems) but should more properly be stored as<name>_<epoch>:<version>_<arch>.deb. Renaming files locally is a possibility, but potentially runs into permission issues. Being able to specify the filename to the API solves this in a more elegant way, without having to modify the local filesystem. The package information can be easily derived usingdebian.debfile.DebFile()to inspect a package file, in specificgencontrol()returns the fields of the control file which can be used to derive the expected filename.Tested locally by uploading files to aptly using the modified API. Also added a test (even though it mostly relies on mocks.) Confirmed mypy is happy with all the type annotation.
Copied from #129 by @filbranden