mirror of
https://github.com/sphinx-doc/sphinx.git
synced 2025-02-25 18:55:22 -06:00
101 lines
3.6 KiB
Python
101 lines
3.6 KiB
Python
# -*- coding: utf-8 -*-
|
|
"""
|
|
test_util_images
|
|
~~~~~~~~~~~~~~~~
|
|
|
|
Test images util.
|
|
|
|
:copyright: Copyright 2007-2018 by the Sphinx team, see AUTHORS.
|
|
:license: BSD, see LICENSE for details.
|
|
"""
|
|
from __future__ import print_function
|
|
|
|
import pytest
|
|
|
|
from sphinx.util.images import (
|
|
get_image_size, guess_mimetype, get_image_extension, parse_data_uri
|
|
)
|
|
|
|
GIF_FILENAME = 'img.gif'
|
|
PNG_FILENAME = 'img.png'
|
|
PDF_FILENAME = 'img.pdf'
|
|
TXT_FILENAME = 'contents.txt'
|
|
|
|
|
|
@pytest.fixture(scope='module')
|
|
def testroot(rootdir):
|
|
return rootdir / 'test-root'
|
|
|
|
|
|
def test_get_image_size(testroot):
|
|
assert get_image_size(testroot / GIF_FILENAME) == (200, 181)
|
|
assert get_image_size(testroot / PNG_FILENAME) == (200, 181)
|
|
assert get_image_size(testroot / PDF_FILENAME) is None
|
|
assert get_image_size(testroot / TXT_FILENAME) is None
|
|
|
|
|
|
def test_guess_mimetype(testroot):
|
|
# 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'
|
|
|
|
# guess by content
|
|
assert guess_mimetype(content=(testroot / GIF_FILENAME).bytes()) == 'image/gif'
|
|
assert guess_mimetype(content=(testroot / PNG_FILENAME).bytes()) == 'image/png'
|
|
assert guess_mimetype(content=(testroot / PDF_FILENAME).bytes()) is None
|
|
assert guess_mimetype(content=(testroot / TXT_FILENAME).bytes()) is None
|
|
assert guess_mimetype(content=(testroot / TXT_FILENAME).bytes(),
|
|
default='text/plain') == 'text/plain'
|
|
|
|
# the priority of params: filename > content > default
|
|
assert guess_mimetype('img.png',
|
|
content=(testroot / GIF_FILENAME).bytes(),
|
|
default='text/plain') == 'image/png'
|
|
assert guess_mimetype('no_extension',
|
|
content=(testroot / GIF_FILENAME).bytes(),
|
|
default='text/plain') == 'image/gif'
|
|
assert guess_mimetype('no_extension',
|
|
content=(testroot / TXT_FILENAME).bytes(),
|
|
default='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)
|
|
with pytest.raises(ValueError):
|
|
uri = ("data:iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4"
|
|
"//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==")
|
|
parse_data_uri(uri)
|