"""Contains various utilities that are used throughout the package.""" import asyncio import collections import html import inspect import io import logging as log import xml.etree.cElementTree as xml_etree # FIXME: bandit warning from datetime import timedelta from enum import Enum from enum import auto as autostr from functools import wraps from pathlib import Path from types import ModuleType from typing import Any, Callable, Dict, Tuple, Type from uuid import UUID import filetype from aiofiles.threadpool.binary import AsyncBufferedReader from nio.crypto import AsyncDataT as File from nio.crypto import async_generator_from_data Size = Tuple[int, int] auto = autostr CANCELLABLE_FUTURES: Dict[Tuple[Any, Callable], asyncio.Future] = {} class AutoStrEnum(Enum): """An Enum where auto() assigns the member's name instead of an int. Example: >>> class Fruits(AutoStrEnum): apple = auto() >>> Fruits.apple.value "apple" """ @staticmethod def _generate_next_value_(name, *_): return name def dict_update_recursive(dict1: dict, dict2: dict) -> None: """Recursive version of dict.update().""" # https://gist.github.com/angstwad/bf22d1822c38a92ec0a9 for k in dict2: if (k in dict1 and isinstance(dict1[k], dict) and isinstance(dict2[k], collections.Mapping)): dict_update_recursive(dict1[k], dict2[k]) else: dict1[k] = dict2[k] async def is_svg(file: File) -> bool: """Return True if the file is a SVG. Uses lxml for detection.""" chunks = [c async for c in async_generator_from_data(file)] with io.BytesIO(b"".join(chunks)) as file: try: _, element = next(xml_etree.iterparse(file, ("start",))) return element.tag == "{http://www.w3.org/2000/svg}svg" except (StopIteration, xml_etree.ParseError): return False async def svg_dimensions(file: File) -> Size: """Return the width & height or viewBox width & height for a SVG. If these properties are missing (broken file), ``(256, 256)`` is returned. """ chunks = [c async for c in async_generator_from_data(file)] with io.BytesIO(b"".join(chunks)) as file: attrs = xml_etree.parse(file).getroot().attrib try: width = round(float(attrs.get("width", attrs["viewBox"].split()[3]))) except (KeyError, IndexError, ValueError, TypeError): width = 256 try: height = round(float(attrs.get("height", attrs["viewBox"].split()[4]))) except (KeyError, IndexError, ValueError, TypeError): height = 256 return (width, height) async def guess_mime(file: File) -> str: """Return the mime type for a file, or application/octet-stream if it can't be guessed. """ if isinstance(file, io.IOBase): file.seek(0, 0) elif isinstance(file, AsyncBufferedReader): await file.seek(0, 0) try: first_chunk: bytes async for first_chunk in async_generator_from_data(file): break # TODO: plaintext mime = filetype.guess_mime(first_chunk) return mime or ( "image/svg+xml" if await is_svg(file) else "application/octet-stream" ) finally: if isinstance(file, io.IOBase): file.seek(0, 0) elif isinstance(file, AsyncBufferedReader): await file.seek(0, 0) def plain2html(text: str) -> str: """Transform plain text into HTML, this converts \n and \t.""" return html.escape(text)\ .replace("\n", "
")\ .replace("\t", " " * 4) def serialize_value_for_qml(value: Any) -> Any: """Transform a value to make it easier to use from QML. Currently, this transforms Enum members to their actual value and Path objects to their string version. """ if hasattr(value, "__class__") and issubclass(value.__class__, Enum): return value.value if isinstance(value, Path): return f"file://{value!s}" if isinstance(value, UUID): return str(value) if isinstance(value, timedelta): return value.total_seconds() * 1000 if inspect.isclass(value): return value.__name__ return value def classes_defined_in(module: ModuleType) -> Dict[str, Type]: """Return a {name: class} dict of all the classes a module defines.""" return { m[0]: m[1] for m in inspect.getmembers(module, inspect.isclass) if not m[0].startswith("_") and m[1].__module__.startswith(module.__name__) } def cancel_previous(async_func): """When the wrapped coroutine is called, cancel any previous instance of that coroutine that may still be running. """ @wraps(async_func) async def wrapper(*args, **kwargs): try: arg0_is_self = inspect.getfullargspec(async_func).args[0] == "self" except IndexError: parent_obj = None else: parent_obj = args[0] if arg0_is_self else None previous = CANCELLABLE_FUTURES.get((parent_obj, async_func)) if previous: previous.cancel() log.info("Cancelled previous coro: %s", previous) future = asyncio.ensure_future(async_func(*args, **kwargs)) CANCELLABLE_FUTURES[parent_obj, async_func] = future try: result = await future return result finally: # Make sure to do this even if an exception happens del CANCELLABLE_FUTURES[parent_obj, async_func] return wrapper