return response instead of raw for stream requests

[rupurt]

What It Does

• enables use of iterator
• https://requests.readthedocs.io/en/latest/user/quickstart/#raw-response-content

How to Test

• Download dataset via stream

response = zosmf_files.get_dsn_content_streamed(dsn)
with open(destination_path, "wb") as fd:
    for chunk in response.iter_content(chunk_size=256):
        fd.write(chunk)
        size += len(chunk)

Review Checklist
I certify that I have:

• tested my changes
• added/updated automated tests
• updated the changelog
• followed the contribution guidelines

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (8c9580a) 83.79% compared to head (a1770cb) 83.79%.

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #245   +/-   ##
=======================================
  Coverage   83.79%   83.79%           
=======================================
  Files          34       34           
  Lines        2117     2117           
=======================================
  Hits         1774     1774           
  Misses        343      343           

Flag	Coverage Δ
unittests	83.79% <100.00%> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[t1m0thyj]

@rupurt Thanks for your contribution!

Although this is a breaking change for anyone using SDK methods that return streams, it seems to follow the best practices recommended by the requests package 👍

[rupurt]

@t1m0thyj yeah, that would be unfortunate. But I feel like this is something worth making a breaking change for. Currently you need to manually decode the gzipped responses. If we want to avoid a breaking change, how do you feel about an extra argument raw = True ?

[zFernand0]

I agree with the position of just making the breaking change.
We do want to handle as much as it makes sense, and also follow recommended practices.

LGTM! 😋

P.S. I don't think we need an extra parameter 😋