mirror of
https://github.com/home-assistant/core
synced 2024-09-03 08:14:07 +02:00
123 lines
4.0 KiB
Python
123 lines
4.0 KiB
Python
"""Helper methods for common tasks."""
|
|
from __future__ import annotations
|
|
|
|
from collections.abc import Callable
|
|
import logging
|
|
from typing import TYPE_CHECKING, Any, TypeVar, overload
|
|
|
|
from soco import SoCo
|
|
from soco.exceptions import SoCoException, SoCoUPnPException
|
|
from typing_extensions import Concatenate, ParamSpec
|
|
|
|
from homeassistant.helpers.dispatcher import dispatcher_send
|
|
|
|
from .const import SONOS_SPEAKER_ACTIVITY
|
|
from .exception import SonosUpdateError
|
|
|
|
if TYPE_CHECKING:
|
|
from .entity import SonosEntity
|
|
from .household_coordinator import SonosHouseholdCoordinator
|
|
from .media import SonosMedia
|
|
from .speaker import SonosSpeaker
|
|
|
|
UID_PREFIX = "RINCON_"
|
|
UID_POSTFIX = "01400"
|
|
|
|
_LOGGER = logging.getLogger(__name__)
|
|
|
|
_T = TypeVar(
|
|
"_T", bound="SonosSpeaker | SonosMedia | SonosEntity | SonosHouseholdCoordinator"
|
|
)
|
|
_R = TypeVar("_R")
|
|
_P = ParamSpec("_P")
|
|
|
|
|
|
@overload
|
|
def soco_error(
|
|
errorcodes: None = ...,
|
|
) -> Callable[[Callable[Concatenate[_T, _P], _R]], Callable[Concatenate[_T, _P], _R]]:
|
|
...
|
|
|
|
|
|
@overload
|
|
def soco_error(
|
|
errorcodes: list[str],
|
|
) -> Callable[
|
|
[Callable[Concatenate[_T, _P], _R]], Callable[Concatenate[_T, _P], _R | None]
|
|
]:
|
|
...
|
|
|
|
|
|
def soco_error(
|
|
errorcodes: list[str] | None = None,
|
|
) -> Callable[
|
|
[Callable[Concatenate[_T, _P], _R]], Callable[Concatenate[_T, _P], _R | None]
|
|
]:
|
|
"""Filter out specified UPnP errors and raise exceptions for service calls."""
|
|
|
|
def decorator(
|
|
funct: Callable[Concatenate[_T, _P], _R]
|
|
) -> Callable[Concatenate[_T, _P], _R | None]:
|
|
"""Decorate functions."""
|
|
|
|
def wrapper(self: _T, *args: _P.args, **kwargs: _P.kwargs) -> _R | None:
|
|
"""Wrap for all soco UPnP exception."""
|
|
args_soco = next((arg for arg in args if isinstance(arg, SoCo)), None)
|
|
try:
|
|
result = funct(self, *args, **kwargs)
|
|
except (OSError, SoCoException, SoCoUPnPException) as err:
|
|
error_code = getattr(err, "error_code", None)
|
|
function = funct.__qualname__
|
|
if errorcodes and error_code in errorcodes:
|
|
_LOGGER.debug(
|
|
"Error code %s ignored in call to %s", error_code, function
|
|
)
|
|
return None
|
|
|
|
if (target := _find_target_identifier(self, args_soco)) is None:
|
|
raise RuntimeError("Unexpected use of soco_error") from err
|
|
|
|
message = f"Error calling {function} on {target}: {err}"
|
|
raise SonosUpdateError(message) from err
|
|
|
|
dispatch_soco = args_soco or self.soco # type: ignore[union-attr]
|
|
dispatcher_send(
|
|
self.hass,
|
|
f"{SONOS_SPEAKER_ACTIVITY}-{dispatch_soco.uid}",
|
|
funct.__qualname__,
|
|
)
|
|
return result
|
|
|
|
return wrapper
|
|
|
|
return decorator
|
|
|
|
|
|
def _find_target_identifier(instance: Any, fallback_soco: SoCo | None) -> str | None:
|
|
"""Extract the the best available target identifier from the provided instance object."""
|
|
if entity_id := getattr(instance, "entity_id", None):
|
|
# SonosEntity instance
|
|
return entity_id
|
|
if zone_name := getattr(instance, "zone_name", None):
|
|
# SonosSpeaker instance
|
|
return zone_name
|
|
if speaker := getattr(instance, "speaker", None):
|
|
# Holds a SonosSpeaker instance attribute
|
|
return speaker.zone_name
|
|
if soco := getattr(instance, "soco", fallback_soco):
|
|
# Holds a SoCo instance attribute
|
|
# Only use attributes with no I/O
|
|
return soco._player_name or soco.ip_address # pylint: disable=protected-access
|
|
return None
|
|
|
|
|
|
def hostname_to_uid(hostname: str) -> str:
|
|
"""Convert a Sonos hostname to a uid."""
|
|
if hostname.startswith("Sonos-"):
|
|
baseuid = hostname.split("-")[1].replace(".local.", "")
|
|
elif hostname.startswith("sonos"):
|
|
baseuid = hostname[5:].replace(".local.", "")
|
|
else:
|
|
raise ValueError(f"{hostname} is not a sonos device.")
|
|
return f"{UID_PREFIX}{baseuid}{UID_POSTFIX}"
|