"Handling Streaming Responses" buffers the file in memory

[bra-fsn]

Hi,

The following example on http://treq.readthedocs.org/en/latest/howto.html:

def download_file(reactor, url, destination_filename):
    destination = file(destination_filename, 'w')
    d = treq.get(url)
    d.addCallback(treq.collect, destination.write)
    d.addBoth(lambda _: destination.close())
    return d

buffers the whole file in memory, making the process use 5+ GiB when downloading a 4 GiB file.
Is this intended?

[bra-fsn]

OK, read the code and found treq.get's undocumented unbuffered option.
So with treq.get(url,unbuffered=True), the response is not buffered into memory.
Could you please document it?