mirror of
https://github.com/sphinx-doc/sphinx.git
synced 2025-02-25 18:55:22 -06:00
88 lines
2.8 KiB
Python
88 lines
2.8 KiB
Python
"""Test images util."""
|
|
|
|
from __future__ import annotations
|
|
|
|
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)
|