Introduce a BinaryFile decoder

[veewee]

Q	A
Type	feature
BC Break	no
Fixed issues

Summary

Introduces a BinaryFile preset that extracts file information (like content-type, md5 hash, filename, ...) from the response.
That way, all the information you need is already there and you can focus on storing the file and.

use Phpro\HttpTools\Encoding\Binary\BinaryFile;
use Phpro\HttpTools\Request\Request;
use Phpro\HttpTools\Transport\Presets\BinaryDownloadPreset;

$transport = BinaryDownloadPreset::create($client, $uriBuilder);
$binaryFile = $transport(
    new Request('GET', '/some/file', [], null),
);

assert($binaryFile instanceof BinaryFile);
var_dump(
    $binaryFile->stream(),
    $binaryFile->fileSizeInBytes(),
    $binaryFile->hash(),
    $binaryFile->extension(),
    $binaryFile->mimeType(),
    $binaryFile->fileName(),
);