mirror of https://github.com/home-assistant/core
103 lines
3.2 KiB
Python
103 lines
3.2 KiB
Python
"""Support for the Twitch stream status."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from typing import Any
|
|
|
|
from homeassistant.components.sensor import SensorEntity
|
|
from homeassistant.config_entries import ConfigEntry
|
|
from homeassistant.core import HomeAssistant
|
|
from homeassistant.helpers.entity_platform import AddEntitiesCallback
|
|
from homeassistant.helpers.typing import StateType
|
|
from homeassistant.helpers.update_coordinator import CoordinatorEntity
|
|
|
|
from . import TwitchCoordinator
|
|
from .const import DOMAIN
|
|
from .coordinator import TwitchUpdate
|
|
|
|
ATTR_GAME = "game"
|
|
ATTR_TITLE = "title"
|
|
ATTR_SUBSCRIPTION = "subscribed"
|
|
ATTR_SUBSCRIPTION_GIFTED = "subscription_is_gifted"
|
|
ATTR_SUBSCRIPTION_TIER = "subscription_tier"
|
|
ATTR_FOLLOW = "following"
|
|
ATTR_FOLLOW_SINCE = "following_since"
|
|
ATTR_FOLLOWING = "followers"
|
|
ATTR_VIEWERS = "viewers"
|
|
ATTR_STARTED_AT = "started_at"
|
|
|
|
STATE_OFFLINE = "offline"
|
|
STATE_STREAMING = "streaming"
|
|
|
|
PARALLEL_UPDATES = 1
|
|
|
|
|
|
async def async_setup_entry(
|
|
hass: HomeAssistant,
|
|
entry: ConfigEntry,
|
|
async_add_entities: AddEntitiesCallback,
|
|
) -> None:
|
|
"""Initialize entries."""
|
|
coordinator = hass.data[DOMAIN][entry.entry_id]
|
|
|
|
async_add_entities(
|
|
TwitchSensor(coordinator, channel_id) for channel_id in coordinator.data
|
|
)
|
|
|
|
|
|
class TwitchSensor(CoordinatorEntity[TwitchCoordinator], SensorEntity):
|
|
"""Representation of a Twitch channel."""
|
|
|
|
_attr_translation_key = "channel"
|
|
|
|
def __init__(self, coordinator: TwitchCoordinator, channel_id: str) -> None:
|
|
"""Initialize the sensor."""
|
|
super().__init__(coordinator)
|
|
self.channel_id = channel_id
|
|
self._attr_unique_id = channel_id
|
|
self._attr_name = self.channel.name
|
|
|
|
@property
|
|
def available(self) -> bool:
|
|
"""Return if entity is available."""
|
|
return super().available and self.channel_id in self.coordinator.data
|
|
|
|
@property
|
|
def channel(self) -> TwitchUpdate:
|
|
"""Return the channel data."""
|
|
return self.coordinator.data[self.channel_id]
|
|
|
|
@property
|
|
def native_value(self) -> StateType:
|
|
"""Return the state of the sensor."""
|
|
return STATE_STREAMING if self.channel.is_streaming else STATE_OFFLINE
|
|
|
|
@property
|
|
def extra_state_attributes(self) -> dict[str, Any]:
|
|
"""Return the state attributes."""
|
|
channel = self.channel
|
|
resp = {
|
|
ATTR_FOLLOWING: channel.followers,
|
|
ATTR_GAME: channel.game,
|
|
ATTR_TITLE: channel.title,
|
|
ATTR_STARTED_AT: channel.started_at,
|
|
ATTR_VIEWERS: channel.viewers,
|
|
}
|
|
resp[ATTR_SUBSCRIPTION] = False
|
|
if channel.subscribed is not None:
|
|
resp[ATTR_SUBSCRIPTION] = channel.subscribed
|
|
resp[ATTR_SUBSCRIPTION_GIFTED] = channel.subscription_gifted
|
|
resp[ATTR_SUBSCRIPTION_TIER] = channel.subscription_tier
|
|
resp[ATTR_FOLLOW] = channel.follows
|
|
if channel.follows:
|
|
resp[ATTR_FOLLOW_SINCE] = channel.following_since
|
|
return resp
|
|
|
|
@property
|
|
def entity_picture(self) -> str | None:
|
|
"""Return the picture of the sensor."""
|
|
if self.channel.is_streaming:
|
|
assert self.channel.stream_picture is not None
|
|
return self.channel.stream_picture
|
|
return self.channel.picture
|