core/homeassistant/components/fully_kiosk/button.py

106 lines
3.1 KiB
Python

"""Fully Kiosk Browser button."""
from __future__ import annotations
from collections.abc import Callable
from dataclasses import dataclass
from typing import Any
from fullykiosk import FullyKiosk
from homeassistant.components.button import (
ButtonDeviceClass,
ButtonEntity,
ButtonEntityDescription,
)
from homeassistant.config_entries import ConfigEntry
from homeassistant.const import EntityCategory
from homeassistant.core import HomeAssistant
from homeassistant.helpers.entity_platform import AddEntitiesCallback
from .const import DOMAIN
from .coordinator import FullyKioskDataUpdateCoordinator
from .entity import FullyKioskEntity
@dataclass
class FullyButtonEntityDescriptionMixin:
"""Mixin to describe a Fully Kiosk Browser button entity."""
press_action: Callable[[FullyKiosk], Any]
@dataclass
class FullyButtonEntityDescription(
ButtonEntityDescription, FullyButtonEntityDescriptionMixin
):
"""Fully Kiosk Browser button description."""
BUTTONS: tuple[FullyButtonEntityDescription, ...] = (
FullyButtonEntityDescription(
key="restartApp",
translation_key="restart_browser",
device_class=ButtonDeviceClass.RESTART,
entity_category=EntityCategory.CONFIG,
press_action=lambda fully: fully.restartApp(),
),
FullyButtonEntityDescription(
key="rebootDevice",
translation_key="restart_device",
device_class=ButtonDeviceClass.RESTART,
entity_category=EntityCategory.CONFIG,
press_action=lambda fully: fully.rebootDevice(),
),
FullyButtonEntityDescription(
key="toForeground",
translation_key="to_foreground",
press_action=lambda fully: fully.toForeground(),
),
FullyButtonEntityDescription(
key="toBackground",
translation_key="to_background",
press_action=lambda fully: fully.toBackground(),
),
FullyButtonEntityDescription(
key="loadStartUrl",
translation_key="load_start_url",
press_action=lambda fully: fully.loadStartUrl(),
),
)
async def async_setup_entry(
hass: HomeAssistant,
config_entry: ConfigEntry,
async_add_entities: AddEntitiesCallback,
) -> None:
"""Set up the Fully Kiosk Browser button entities."""
coordinator: FullyKioskDataUpdateCoordinator = hass.data[DOMAIN][
config_entry.entry_id
]
async_add_entities(
FullyButtonEntity(coordinator, description) for description in BUTTONS
)
class FullyButtonEntity(FullyKioskEntity, ButtonEntity):
"""Representation of a Fully Kiosk Browser button."""
entity_description: FullyButtonEntityDescription
def __init__(
self,
coordinator: FullyKioskDataUpdateCoordinator,
description: FullyButtonEntityDescription,
) -> None:
"""Initialize the button."""
super().__init__(coordinator)
self.entity_description = description
self._attr_unique_id = f"{coordinator.data['deviceID']}-{description.key}"
async def async_press(self) -> None:
"""Set the value of the entity."""
await self.entity_description.press_action(self.coordinator.fully)
await self.coordinator.async_refresh()