Home Assistant Unofficial Reference 2024.12.1
switch.py
Go to the documentation of this file.
1 """Nice G.O. switch platform."""
2 
3 from __future__ import annotations
4 
5 import logging
6 from typing import TYPE_CHECKING, Any
7 
8 from aiohttp import ClientError
9 from nice_go import ApiError
10 
11 from homeassistant.components.switch import SwitchDeviceClass, SwitchEntity
12 from homeassistant.const import Platform
13 from homeassistant.core import HomeAssistant
14 from homeassistant.exceptions import HomeAssistantError
15 from homeassistant.helpers.entity_platform import AddEntitiesCallback
16 
17 from . import NiceGOConfigEntry
18 from .const import (
19  DOMAIN,
20  KNOWN_UNSUPPORTED_DEVICE_TYPES,
21  SUPPORTED_DEVICE_TYPES,
22  UNSUPPORTED_DEVICE_WARNING,
23 )
24 from .entity import NiceGOEntity
25 
26 _LOGGER = logging.getLogger(__name__)
27 
28 
30  hass: HomeAssistant,
31  config_entry: NiceGOConfigEntry,
32  async_add_entities: AddEntitiesCallback,
33 ) -> None:
34  """Set up Nice G.O. switch."""
35  coordinator = config_entry.runtime_data
36 
37  entities = []
38 
39  for device_id, device_data in coordinator.data.items():
40  if device_data.type in SUPPORTED_DEVICE_TYPES[Platform.SWITCH]:
41  entities.append(
42  NiceGOSwitchEntity(coordinator, device_id, device_data.name)
43  )
44  elif device_data.type not in KNOWN_UNSUPPORTED_DEVICE_TYPES[Platform.SWITCH]:
45  _LOGGER.warning(
46  UNSUPPORTED_DEVICE_WARNING,
47  device_data.name,
48  device_data.type,
49  device_data.type,
50  )
51 
52  async_add_entities(entities)
53 
54 
56  """Representation of a Nice G.O. switch."""
57 
58  _attr_device_class = SwitchDeviceClass.SWITCH
59  _attr_translation_key = "vacation_mode"
60 
61  @property
62  def is_on(self) -> bool:
63  """Return if switch is on."""
64  if TYPE_CHECKING:
65  assert self.datadatadata.vacation_mode is not None
66  return self.datadatadata.vacation_mode
67 
68  async def async_turn_on(self, **kwargs: Any) -> None:
69  """Turn the switch on."""
70 
71  try:
72  await self.coordinator.api.vacation_mode_on(self.datadatadata.id)
73  except (ApiError, ClientError) as error:
74  raise HomeAssistantError(
75  translation_domain=DOMAIN,
76  translation_key="switch_on_error",
77  translation_placeholders={"exception": str(error)},
78  ) from error
79 
80  async def async_turn_off(self, **kwargs: Any) -> None:
81  """Turn the switch off."""
82 
83  try:
84  await self.coordinator.api.vacation_mode_off(self.datadatadata.id)
85  except (ApiError, ClientError) as error:
86  raise HomeAssistantError(
87  translation_domain=DOMAIN,
88  translation_key="switch_off_error",
89  translation_placeholders={"exception": str(error)},
90  ) from error
None async_setup_entry(HomeAssistant hass, NiceGOConfigEntry config_entry, AddEntitiesCallback async_add_entities)
Definition: switch.py:33