Allow returning raw bytes from a request, without attempting to decode.

[hnefatl]

Some API calls can return binary data, e.g. fetching a user's profile image (e.g. api path like /api/image/serve/<hash>/512x512).

Currently this library attempts to decode all responses from bytes to str using the default utf-8 encoding, which fails for API calls returning binary data since the first byte of e.g. JPEG data (0xFF) can't be decoded to text.

This PR adds a by-default-no-change-to-external-behaviour flag to the RawClient.request method to optionally disable decoding for that request, just returning the raw bytes.

[hnefatl]

Example usage to fetch a user's profile image to a file:

url = "..."
token = "..."
person_id = "person.keith"

with Client(api_url=url, token=token) as client:
    state = client.get_state(entity_id=person_id)
    image_path = state.attributes.get("entity_picture")
    image_path = image_path.removeprefix("/api/")
    with open('out.jpeg', 'wb') as f:
        image_data = client.request(image_path, decode_bytes=False)
        f.write(image_data)

[GrandMoff100]

Oh! That's actually pretty cool.
I'll review it shortly and we can ship it in the next release in about two weeks.

[codecov]

Codecov Report

Merging #136 (d61b20a) into dev (ec431cd) will not change coverage.
The diff coverage is 100.00%.

❗ Current head d61b20a differs from pull request most recent head d1dd678. Consider uploading reports for the commit d1dd678 to get more accurate results

@@            Coverage Diff            @@
##               dev      #136   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files           20        20           
  Lines          947       953    +6     
=========================================
+ Hits           947       953    +6     

Impacted Files	Coverage Δ
homeassistant_api/errors.py	100.00% <100.00%> (ø)
homeassistant_api/processing.py	100.00% <100.00%> (ø)
homeassistant_api/rawclient.py	100.00% <100.00%> (ø)

📣 We’re building smart automated test selection to slash your CI/CD build times. Learn more

[hnefatl]

TIL how to use poetry properly :) Previous commits weren't done from poetry shell so were missing out on the precommit checks.

There was a type error detected by mypy unrelated to my changes (self._response.method) which weirdly seemed to be fixed by switching from ternary operator to if statement ¯\_(ツ)_/¯

[GrandMoff100]

Mypy can be weird like that sometimes lol

[GrandMoff100]

Looks good

[hnefatl]

Sorry, one last tweak - copied the wrong line earlier, thank you type-checking.