Merge pull request #2302 from tk0miya/2199_obtain_image_size_without_pillow

Fix #2199: Use ``imagesize`` package to obtain size of images

CHANGES

@@ -53,6 +53,7 @@ Features added
 * #1779: Add EPUB 3 builder
 * #1751: Add :confval:`todo_link_only` to avoid file path and line indication on
   :rst:dir:`todolist`. Thanks to Francesco Montesano.
+* #2199: Use ``imagesize`` package to obtain size of images
 
 Bugs fixed
 ----------

setup.py

@@ -53,6 +53,7 @@ requires = [
     'snowballstemmer>=1.1',
     'babel>=1.3,!=2.0',
     'alabaster>=0.7,<0.8',
+    'imagesize',
 ]
 extras_require = {
     # Environment Marker works for wheel 0.24 or later

sphinx/util/images.py

@@ -0,0 +1,39 @@
+# -*- coding: utf-8 -*-
+"""
+    sphinx.util.images
+    ~~~~~~~~~~~
+
+    Image utility functions for Sphinx.
+
+    :copyright: Copyright 2007-2016 by the Sphinx team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+
+import imagesize
+
+try:
+    from PIL import Image        # check for the Python Imaging Library
+except ImportError:
+    try:
+        import Image
+    except ImportError:
+        Image = None
+
+
+def get_image_size(filename):
+    try:
+        size = imagesize.get(filename)
+        if size[0] == -1:
+            size = None
+
+        if Image:  # fallback to PIL
+            im = Image.open(filename)
+            size = im.size
+            try:
+                im.fp.close()
+            except Exception:
+                pass
+
+        return size
+    except:
+        return None

sphinx/writers/html.py

@@ -20,16 +20,9 @@ from docutils.writers.html4css1 import Writer, HTMLTranslator as BaseTranslator
 
 from sphinx import addnodes
 from sphinx.locale import admonitionlabels, _
+from sphinx.util.images import get_image_size
 from sphinx.util.smartypants import sphinx_smarty_pants
 
-try:
-    from PIL import Image        # check for the Python Imaging Library
-except ImportError:
-    try:
-        import Image
-    except ImportError:
-        Image = None
-
 # A good overview of the purpose behind these classes can be found here:
 # http://www.arnebrodowski.de/blog/write-your-own-restructuredtext-writer.html
 
@@ -481,21 +474,16 @@ class HTMLTranslator(BaseTranslator):
             # Try to figure out image height and width.  Docutils does that too,
             # but it tries the final file name, which does not necessarily exist
             # yet at the time the HTML file is written.
-            if Image and not ('width' in node and 'height' in node):
+            if not ('width' in node and 'height' in node):
-                try:
+                size = get_image_size(os.path.join(self.builder.srcdir, olduri))
-                    im = Image.open(os.path.join(self.builder.srcdir, olduri))
+                if size is None:
-                except (IOError,  # Source image can't be found or opened
+                    self.builder.env.warn_node('Could not obtain image size. '
-                        UnicodeError):  # PIL doesn't like Unicode paths.
+                                               ':scale: option is ignored.', node)
-                    pass
                 else:
                     if 'width' not in node:
-                        node['width'] = str(im.size[0])
+                        node['width'] = str(size[0])
                     if 'height' not in node:
-                        node['height'] = str(im.size[1])
+                        node['height'] = str(size[1])
-                    try:
-                        im.fp.close()
-                    except Exception:
-                        pass
         BaseTranslator.visit_image(self, node)
 
     def visit_toctree(self, node):

test-reqs.txt

@@ -11,3 +11,4 @@ sqlalchemy>=0.9
 whoosh>=2.0
 alabaster
 sphinx_rtd_theme
+imagesize