img: add Image.from_blob()

Steve Canny · Steve Canny · commit f395f0d6cd80 · 2014-03-01T01:35:31.000-08:00
diff --git a/docx/image/image.py b/docx/image/image.py
@@ -26,6 +26,15 @@ def __init__(self, blob, filename, image_header):
         self._filename = filename
         self._image_header = image_header
 
+    @classmethod
+    def from_blob(cls, blob):
+        """
+        Return a new |Image| subclass instance parsed from the image binary
+        contained in *blob*.
+        """
+        stream = BytesIO(blob)
+        return cls._from_stream(stream, blob)
+
     @classmethod
     def from_file(cls, image_descriptor):
         """
diff --git a/tests/image/test_image.py b/tests/image/test_image.py
@@ -27,6 +27,13 @@
 
 class DescribeImage(object):
 
+    def it_can_construct_from_an_image_blob(self, from_blob_fixture):
+        blob_, BytesIO_, _from_stream_, stream_, image_ = from_blob_fixture
+        image = Image.from_blob(blob_)
+        BytesIO_.assert_called_once_with(blob_)
+        _from_stream_.assert_called_once_with(stream_, blob_)
+        assert image is image_
+
     def it_can_construct_from_an_image_path(self, from_path_fixture):
         image_path, _from_stream_, stream_, blob, filename, image_ = (
             from_path_fixture
@@ -115,6 +122,11 @@ def dpi_fixture(self, image_header_):
     def filename_(self, request):
         return instance_mock(request, str)
 
+    @pytest.fixture
+    def from_blob_fixture(
+            self, blob_, BytesIO_, _from_stream_, stream_, image_):
+        return blob_, BytesIO_, _from_stream_, stream_, image_
+
     @pytest.fixture
     def from_filelike_fixture(self, _from_stream_, image_):
         image_path = test_file('python-icon.png')
