Pillow/docs/releasenotes/2.8.0.rst

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

33 lines
1.3 KiB
ReStructuredText
Raw Normal View History

2015-03-28 14:22:14 +03:00
2.8.0
-----
2015-03-28 14:22:14 +03:00
Open HTTP response objects with Image.open
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
2015-03-28 14:22:14 +03:00
HTTP response objects returned from ``urllib2.urlopen(url)`` or
``requests.get(url, stream=True).raw`` are 'file-like' but do not support ``.seek()``
operations. As a result PIL was unable to open them as images, requiring a wrap in
``cStringIO`` or ``BytesIO``.
2015-03-28 14:22:14 +03:00
Now new functionality has been added to ``Image.open()`` by way of an ``.seek(0)`` check and
2023-11-01 21:18:25 +03:00
catch on exception :py:exc:`AttributeError` or :py:exc:`io.UnsupportedOperation`. If this is caught we
attempt to wrap the object using ``io.BytesIO`` (which will only work on buffer-file-like
objects).
2015-03-28 14:22:14 +03:00
This allows opening of files using both ``urllib2`` and ``requests``, e.g.::
2015-03-28 14:22:14 +03:00
Image.open(urllib2.urlopen(url))
Image.open(requests.get(url, stream=True).raw)
If the response uses content-encoding (compression, either gzip or deflate) then this
will fail as both the urllib2 and requests raw file object will produce compressed data
in that case. Using Content-Encoding on images is rather non-sensical as most images are
already compressed, but it can still happen.
For requests the work-around is to set the decode_content attribute on the raw object to
True::
response = requests.get(url, stream=True)
response.raw.decode_content = True
image = Image.open(response.raw)