jeans/core
jeans/core
1
0
Fork 0
mirror of https://github.com/home-assistant/core.git synced 2025-07-21 04:07:08 +00:00
Code Issues Packages Projects Releases Wiki Activity

Migrate media player device classes to StrEnum (#60656)

Browse Source
This commit is contained in:
Franck Nijhof 2021-12-01 07:25:10 +01:00 committed by GitHub
parent 9715601255
commit 3770a72601
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 29 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
homeassistant/components/media_player/__init__.py
View File

@ -63,6 +63,7 @@ from homeassistant.helpers.entity import Entity, EntityDescription
from homeassistant.helpers.entity_component import EntityComponent from homeassistant.helpers.entity_component import EntityComponent
from homeassistant.helpers.network import get_url from homeassistant.helpers.network import get_url
from homeassistant.loader import bind_hass from homeassistant.loader import bind_hass
from homeassistant.util.enum import StrEnum
from .const import ( from .const import (
ATTR_APP_ID, ATTR_APP_ID,
@ -140,13 +141,24 @@ ENTITY_IMAGE_CACHE = {CACHE_IMAGES: collections.OrderedDict(), CACHE_MAXSIZE: 16
SCAN_INTERVAL = dt.timedelta(seconds=10) SCAN_INTERVAL = dt.timedelta(seconds=10)
DEVICE_CLASS_TV = "tv"
DEVICE_CLASS_SPEAKER = "speaker"
DEVICE_CLASS_RECEIVER = "receiver"
DEVICE_CLASSES = [DEVICE_CLASS_TV, DEVICE_CLASS_SPEAKER, DEVICE_CLASS_RECEIVER] class MediaPlayerDeviceClass(StrEnum):
"""Device class for media players."""
DEVICE_CLASSES_SCHEMA = vol.All(vol.Lower, vol.In(DEVICE_CLASSES)) TV = "tv"
SPEAKER = "speaker"
RECEIVER = "receiver"
DEVICE_CLASSES_SCHEMA = vol.All(vol.Lower, vol.Coerce(MediaPlayerDeviceClass))
# DEVICE_CLASS* below are deprecated as of 2021.12
# use the MediaPlayerDeviceClass enum instead.
DEVICE_CLASSES = [cls.value for cls in MediaPlayerDeviceClass]
DEVICE_CLASS_TV = MediaPlayerDeviceClass.TV.value
DEVICE_CLASS_SPEAKER = MediaPlayerDeviceClass.SPEAKER.value
DEVICE_CLASS_RECEIVER = MediaPlayerDeviceClass.RECEIVER.value
MEDIA_PLAYER_PLAY_MEDIA_SCHEMA = { MEDIA_PLAYER_PLAY_MEDIA_SCHEMA = {
@ -373,6 +385,8 @@ async def async_unload_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool:
class MediaPlayerEntityDescription(EntityDescription): class MediaPlayerEntityDescription(EntityDescription):
"""A class that describes media player entities.""" """A class that describes media player entities."""
device_class: MediaPlayerDeviceClass | str | None = None
class MediaPlayerEntity(Entity): class MediaPlayerEntity(Entity):
"""ABC for media player entities.""" """ABC for media player entities."""
@ -382,6 +396,7 @@ class MediaPlayerEntity(Entity):
_attr_app_id: str | None = None _attr_app_id: str | None = None
_attr_app_name: str | None = None _attr_app_name: str | None = None
_attr_device_class: MediaPlayerDeviceClass | str | None
_attr_group_members: list[str] | None = None _attr_group_members: list[str] | None = None
_attr_is_volume_muted: bool | None = None _attr_is_volume_muted: bool | None = None
_attr_media_album_artist: str | None = None _attr_media_album_artist: str | None = None
@ -413,6 +428,15 @@ class MediaPlayerEntity(Entity):
_attr_volume_level: float | None = None _attr_volume_level: float | None = None
# Implement these for your media player # Implement these for your media player
@property
def device_class(self) -> MediaPlayerDeviceClass | str | None:
"""Return the class of this entity."""
if hasattr(self, "_attr_device_class"):
return self._attr_device_class
if hasattr(self, "entity_description"):
return self.entity_description.device_class
return None
@property @property
def state(self) -> str | None: def state(self) -> str | None:
"""State of the player.""" """State of the player."""