File size: 2,220 Bytes
8ede856 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 | from __future__ import annotations
import os
from collections.abc import Sequence
from pathlib import Path
from urllib.parse import unquote, urlparse
ALLOWED_IMAGE_EXTENSIONS = {
".png",
".jpg",
".jpeg",
".gif",
".webp",
".bmp",
".tif",
".tiff",
".svg",
".heic",
}
def resolve_file_url_path(image_ref: str) -> str:
parsed = urlparse(image_ref)
if parsed.scheme != "file":
return image_ref
path = unquote(parsed.path or "")
netloc = unquote(parsed.netloc or "")
# Keep support for file://<host>/path and file://<path> forms.
if netloc and netloc.lower() != "localhost":
path = f"//{netloc}{path}" if path else netloc
elif not path and netloc:
path = netloc
if os.name == "nt" and len(path) > 2 and path[0] == "/" and path[2] == ":":
path = path[1:]
return path or image_ref
def _is_path_within_roots(path: str, roots: Sequence[str]) -> bool:
try:
candidate = Path(path).resolve(strict=False)
except Exception:
return False
for root in roots:
try:
root_path = Path(root).resolve(strict=False)
candidate.relative_to(root_path)
return True
except Exception:
continue
return False
def is_supported_image_ref(
image_ref: str,
*,
allow_extensionless_existing_local_file: bool = False,
extensionless_local_roots: Sequence[str] | None = None,
) -> bool:
if not image_ref:
return False
lowered = image_ref.lower()
if lowered.startswith(("http://", "https://", "base64://")):
return True
file_path = (
resolve_file_url_path(image_ref) if lowered.startswith("file://") else image_ref
)
ext = os.path.splitext(file_path)[1].lower()
if ext in ALLOWED_IMAGE_EXTENSIONS:
return True
if not allow_extensionless_existing_local_file:
return False
if not extensionless_local_roots:
return False
# Keep support for extension-less temp files returned by image converters.
return (
ext == ""
and os.path.exists(file_path)
and _is_path_within_roots(file_path, extensionless_local_roots)
)
|