1 files changed, 74 insertions, 0 deletions
diff --git a/tests/test_util_images.py b/tests/test_util_images.py
new file mode 100644
index 0000000..15853c7
--- /dev/null
+++ b/tests/test_util_images.py
@@ -0,0 +1,74 @@
+"""Test images util."""
+
+import pytest
+
+from sphinx.util.images import (
+    get_image_extension,
+    get_image_size,
+    guess_mimetype,
+    parse_data_uri,
+)
+
+GIF_FILENAME = 'img.gif'
+PNG_FILENAME = 'img.png'
+PDF_FILENAME = 'img.pdf'
+TXT_FILENAME = 'index.txt'
+
+
+def test_get_image_size(rootdir):
+    assert get_image_size(rootdir / 'test-root' / GIF_FILENAME) == (200, 181)
+    assert get_image_size(rootdir / 'test-root' / PNG_FILENAME) == (200, 181)
+    assert get_image_size(rootdir / 'test-root' / PDF_FILENAME) is None
+    assert get_image_size(rootdir / 'test-root' / TXT_FILENAME) is None
+
+
+@pytest.mark.filterwarnings('ignore:The content argument')
+def test_guess_mimetype():
+    # guess by filename
+    assert guess_mimetype('img.png') == 'image/png'
+    assert guess_mimetype('img.jpg') == 'image/jpeg'
+    assert guess_mimetype('img.txt') is None
+    assert guess_mimetype('img.txt', default='text/plain') == 'text/plain'
+    assert guess_mimetype('no_extension') is None
+    assert guess_mimetype('IMG.PNG') == 'image/png'
+
+    # default parameter is used when no extension
+    assert guess_mimetype('img.png', 'text/plain') == 'image/png'
+    assert guess_mimetype('no_extension', 'text/plain') == 'text/plain'
+
+
+def test_get_image_extension():
+    assert get_image_extension('image/png') == '.png'
+    assert get_image_extension('image/jpeg') == '.jpg'
+    assert get_image_extension('image/svg+xml') == '.svg'
+    assert get_image_extension('text/plain') is None
+
+
+def test_parse_data_uri():
+    # standard case
+    uri = ("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4"
+           "//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==")
+    image = parse_data_uri(uri)
+    assert image is not None
+    assert image.mimetype == 'image/png'
+    assert image.charset == 'US-ASCII'
+
+    # no mimetype
+    uri = ("data:charset=utf-8,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElE"
+           "QVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==")
+    image = parse_data_uri(uri)
+    assert image is not None
+    assert image.mimetype == 'text/plain'
+    assert image.charset == 'utf-8'
+
+    # non data URI
+    uri = ("image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4"
+           "//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==")
+    image = parse_data_uri(uri)
+    assert image is None
+
+    # invalid data URI (no properties)
+    uri = ("data:iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4"
+           "//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==")
+    with pytest.raises(ValueError, match=r'not enough values to unpack \(expected 2, got 1\)'):
+        parse_data_uri(uri)