"""Init file for Supervisor Multicast RESTful API.""" import asyncio from collections.abc import Awaitable import logging from typing import Any from aiohttp import web import voluptuous as vol from ..const import ( ATTR_BLK_READ, ATTR_BLK_WRITE, ATTR_CPU_PERCENT, ATTR_MEMORY_LIMIT, ATTR_MEMORY_PERCENT, ATTR_MEMORY_USAGE, ATTR_NETWORK_RX, ATTR_NETWORK_TX, ATTR_UPDATE_AVAILABLE, ATTR_VERSION, ATTR_VERSION_LATEST, ) from ..coresys import CoreSysAttributes from ..exceptions import APIError from ..validate import version_tag from .utils import api_process, api_validate _LOGGER: logging.Logger = logging.getLogger(__name__) SCHEMA_VERSION = vol.Schema({vol.Optional(ATTR_VERSION): version_tag}) class APIMulticast(CoreSysAttributes): """Handle RESTful API for Multicast functions.""" @api_process async def info(self, request: web.Request) -> dict[str, Any]: """Return Multicast information.""" return { ATTR_VERSION: self.sys_plugins.multicast.version, ATTR_VERSION_LATEST: self.sys_plugins.multicast.latest_version, ATTR_UPDATE_AVAILABLE: self.sys_plugins.multicast.need_update, } @api_process async def stats(self, request: web.Request) -> dict[str, Any]: """Return resource information.""" stats = await self.sys_plugins.multicast.stats() return { ATTR_CPU_PERCENT: stats.cpu_percent, ATTR_MEMORY_USAGE: stats.memory_usage, ATTR_MEMORY_LIMIT: stats.memory_limit, ATTR_MEMORY_PERCENT: stats.memory_percent, ATTR_NETWORK_RX: stats.network_rx, ATTR_NETWORK_TX: stats.network_tx, ATTR_BLK_READ: stats.blk_read, ATTR_BLK_WRITE: stats.blk_write, } @api_process async def update(self, request: web.Request) -> None: """Update Multicast plugin.""" body = await api_validate(SCHEMA_VERSION, request) version = body.get(ATTR_VERSION, self.sys_plugins.multicast.latest_version) if version == self.sys_plugins.multicast.version: raise APIError(f"Version {version} is already in use") await asyncio.shield(self.sys_plugins.multicast.update(version)) @api_process def restart(self, request: web.Request) -> Awaitable[None]: """Restart Multicast plugin.""" return asyncio.shield(self.sys_plugins.multicast.restart())