Files
MoviePilot/tests/test_system_image_proxy.py
2026-09-15 07:42:18 +08:00

336 lines
10 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

import asyncio
import io
from collections.abc import Iterator, Mapping
from types import SimpleNamespace
from typing import Any, Optional
from unittest.mock import AsyncMock, Mock, patch
import pytest
from PIL import Image
from app.api.endpoints import system as system_endpoint
from app.application import image as image_service
from app.application.image import (
ImageHelper,
ImageResponsePort,
configure_image_ports,
reset_image_ports,
)
class _FakeImageTransport:
"""返回测试响应并记录同步、异步图片请求。"""
def __init__(
self,
*,
sync_response: Optional[ImageResponsePort] = None,
async_response: Optional[ImageResponsePort] = None,
) -> None:
"""保存固定响应。"""
self.sync_response = sync_response
self.async_response = async_response
self.sync_calls: list[tuple[str, Mapping[str, Any]]] = []
self.async_calls: list[tuple[str, Mapping[str, Any]]] = []
def get(
self,
url: str,
*,
options: Mapping[str, Any],
) -> Optional[ImageResponsePort]:
"""记录同步请求并返回固定响应。"""
self.sync_calls.append((url, options))
return self.sync_response
async def async_get(
self,
url: str,
*,
options: Mapping[str, Any],
) -> Optional[ImageResponsePort]:
"""记录异步请求并返回固定响应。"""
self.async_calls.append((url, options))
return self.async_response
class _FakeInternalAddress:
"""返回固定内部地址判断并记录 URL。"""
def __init__(self, internal: bool = False) -> None:
"""保存固定判断。"""
self.internal = internal
self.calls: list[str] = []
def is_internal(self, url: str) -> bool:
"""记录 URL 并返回固定判断。"""
self.calls.append(url)
return self.internal
@pytest.fixture(autouse=True)
def restore_image_ports() -> Iterator[None]:
"""为每个用例装配无网络 fake并在结束后恢复原端口。"""
previous = configure_image_ports(
transport=_FakeImageTransport(),
internal_address=_FakeInternalAddress(),
)
yield
reset_image_ports(*previous)
def _image_bytes(image_format: str, trailing: bytes = b"") -> bytes:
buffer = io.BytesIO()
Image.new("RGB", (2, 2), color=(32, 96, 160)).save(buffer, format=image_format)
return buffer.getvalue() + trailing
def test_bangumi_image_proxy_domain_is_added_to_allowlist() -> None:
"""启用 Bangumi 图片代理时,应允许其配置主机通过通用图片端点。"""
with patch.object(
system_endpoint,
"get_runtime_settings",
return_value={
"BANGUMI_PROXY_ENABLE": True,
"BANGUMI_IMAGE_DOMAIN": "https://image-proxy.example/?url=",
"SECURITY_IMAGE_DOMAINS": ["lain.bgm.tv"],
},
):
assert system_endpoint._get_image_proxy_allowed_domains() == {
"lain.bgm.tv",
"image-proxy.example",
}
@pytest.mark.parametrize(
("image_format", "expected_mime"),
[
("PNG", "image/png"),
("JPEG", "image/jpeg"),
("GIF", "image/gif"),
("WEBP", "image/webp"),
("PCX", "image/x-pcx"),
("PPM", "image/x-portable-anymap"),
],
)
def test_get_image_mime_type_uses_pillow_detected_format(
image_format: str,
expected_mime: str,
):
assert ImageHelper.get_image_mime_type(_image_bytes(image_format)) == expected_mime
def test_get_image_mime_type_rejects_non_image_pillow_mime():
assert ImageHelper.get_image_mime_type(_image_bytes("EPS")) is None
def test_get_image_mime_type_rejects_scriptable_svg_mime():
with patch.dict(Image.MIME, {"PNG": "image/svg+xml"}):
assert ImageHelper.get_image_mime_type(_image_bytes("PNG")) is None
def test_fetch_image_with_mime_type_only_reads_cached_format_header():
content = _image_bytes("PNG")
image_helper = ImageHelper()
with patch.object(
image_helper.file_cache,
"get",
return_value=content,
), patch.object(
image_helper,
"get_image_mime_type",
return_value="image/png",
) as get_mime_type:
result = image_helper.fetch_image_with_mime_type(
"https://images.example/wallpaper.png"
)
assert result == (content, "image/png")
get_mime_type.assert_called_once_with(content, verify=False)
def test_fetch_image_with_mime_type_validates_network_content_once():
content = _image_bytes("PNG")
image_helper = ImageHelper()
response = Mock(status_code=200, content=content)
transport = _FakeImageTransport(sync_response=response)
configure_image_ports(
transport=transport,
internal_address=_FakeInternalAddress(),
)
with patch.object(
image_helper.file_cache,
"get",
return_value=None,
), patch.object(
image_helper.file_cache,
"set",
), patch.object(
image_helper,
"get_image_mime_type",
return_value="image/png",
) as get_mime_type:
result = image_helper.fetch_image_with_mime_type(
"https://images.example/wallpaper.png"
)
assert result == (content, "image/png")
get_mime_type.assert_called_once_with(content)
assert transport.sync_calls[0][0] == "https://images.example/wallpaper.png"
def test_async_fetch_image_with_mime_type_only_reads_cached_format_header():
content = _image_bytes("PNG")
image_helper = ImageHelper()
with patch.object(
image_helper.async_file_cache,
"get",
new=AsyncMock(return_value=content),
), patch.object(
image_helper,
"get_image_mime_type",
return_value="image/png",
) as get_mime_type:
result = asyncio.run(
image_helper.async_fetch_image_with_mime_type(
"https://images.example/wallpaper.png"
)
)
assert result == (content, "image/png")
get_mime_type.assert_called_once_with(content, verify=False)
def test_async_fetch_image_with_mime_type_validates_network_content_once():
content = _image_bytes("PNG")
image_helper = ImageHelper()
response = Mock(status_code=200, content=content)
transport = _FakeImageTransport(async_response=response)
configure_image_ports(
transport=transport,
internal_address=_FakeInternalAddress(),
)
with patch.object(
image_helper.async_file_cache,
"get",
new=AsyncMock(return_value=None),
), patch.object(
image_helper.async_file_cache,
"set",
new=AsyncMock(),
), patch.object(
image_helper,
"get_image_mime_type",
return_value="image/png",
) as get_mime_type:
result = asyncio.run(
image_helper.async_fetch_image_with_mime_type(
"https://images.example/wallpaper.png"
)
)
assert result == (content, "image/png")
get_mime_type.assert_called_once_with(content)
assert transport.async_calls[0][0] == "https://images.example/wallpaper.png"
def test_image_request_uses_internal_address_port_for_proxy_decision(monkeypatch):
"""自动代理策略必须通过注入端口判断内部地址。"""
internal_address = _FakeInternalAddress(internal=True)
configure_image_ports(
transport=_FakeImageTransport(),
internal_address=internal_address,
)
monkeypatch.setattr(
image_service,
"get_chain_runtime_config_snapshot",
lambda: SimpleNamespace(
proxy={"https": "http://proxy.example"},
normal_user_agent="MoviePilot/Test",
),
)
params = ImageHelper._get_request_params(
"https://images.example/wallpaper.png",
proxy=None,
cookies=None,
)
assert params["proxies"] is None
assert internal_address.calls == ["https://images.example/wallpaper.png"]
def test_fetch_image_does_not_trust_active_url_suffix():
content = _image_bytes("PNG", b"<script>window.xss = true</script>")
image_helper = Mock()
image_helper.async_fetch_image_with_mime_type = AsyncMock(
return_value=(content, "image/png")
)
with patch.object(
system_endpoint.SecurityUtils,
"is_safe_image_url_async",
new=AsyncMock(return_value=True),
), patch.object(system_endpoint, "ImageHelper", return_value=image_helper):
response = asyncio.run(
system_endpoint.fetch_image(
url="https://images.example/wallpaper.html",
allowed_domains={"images.example"},
)
)
assert response is not None
assert response.headers["content-type"] == "image/png"
assert response.headers["x-content-type-options"] == "nosniff"
assert response.body == content
def test_fetch_image_rejects_unverified_content():
image_helper = Mock()
image_helper.async_fetch_image_with_mime_type = AsyncMock(return_value=None)
with patch.object(
system_endpoint.SecurityUtils,
"is_safe_image_url_async",
new=AsyncMock(return_value=True),
), patch.object(system_endpoint, "ImageHelper", return_value=image_helper):
response = asyncio.run(
system_endpoint.fetch_image(
url="https://images.example/wallpaper.png",
allowed_domains={"images.example"},
)
)
assert response is None
def test_fetch_image_adds_nosniff_to_not_modified_response():
content = _image_bytes("JPEG")
image_helper = Mock()
image_helper.async_fetch_image_with_mime_type = AsyncMock(
return_value=(content, "image/jpeg")
)
etag = system_endpoint.HashUtils.md5(content)
with patch.object(
system_endpoint.SecurityUtils,
"is_safe_image_url_async",
new=AsyncMock(return_value=True),
), patch.object(system_endpoint, "ImageHelper", return_value=image_helper):
response = asyncio.run(
system_endpoint.fetch_image(
url="https://images.example/wallpaper.jpg",
if_none_match=etag,
allowed_domains={"images.example"},
)
)
assert response is not None
assert response.status_code == 304
assert response.headers["content-type"] == "image/jpeg"
assert response.headers["x-content-type-options"] == "nosniff"