Coverage for custom_components/supernotify/transports/alexa_devices.py: 93%

30 statements  

« prev     ^ index     » next       coverage.py v7.10.6, created at 2025-11-21 23:31 +0000

1import logging 

2from typing import Any 

3 

4from homeassistant.components.notify.const import ATTR_MESSAGE 

5from homeassistant.const import ATTR_ENTITY_ID 

6 

7from custom_components.supernotify import ( 

8 OPTION_MESSAGE_USAGE, 

9 OPTION_SIMPLIFY_TEXT, 

10 OPTION_STRIP_URLS, 

11 OPTION_TARGET_CATEGORIES, 

12 OPTION_TARGET_INCLUDE_RE, 

13 OPTION_UNIQUE_TARGETS, 

14 TRANSPORT_ALEXA, 

15) 

16from custom_components.supernotify.envelope import Envelope 

17from custom_components.supernotify.model import MessageOnlyPolicy, SelectionRank, TargetRequired, TransportConfig 

18from custom_components.supernotify.transport import ( 

19 Transport, 

20) 

21 

22_LOGGER = logging.getLogger(__name__) 

23 

24 

25class AlexaDevicesTransport(Transport): 

26 """Notify via Home Assistant's built-in Alexa Devices integration 

27 

28 options: 

29 message_usage: standard | use_title | combine_title 

30 

31 """ 

32 

33 name = TRANSPORT_ALEXA 

34 

35 def __init__(self, *args: Any, **kwargs: Any) -> None: 

36 super().__init__(*args, **kwargs) 

37 

38 @property 

39 def default_config(self) -> TransportConfig: 

40 config = TransportConfig() 

41 config.delivery_defaults.action = "notify.send_message" 

42 config.delivery_defaults.target_required = TargetRequired.ALWAYS 

43 config.delivery_defaults.selection_rank = SelectionRank.FIRST 

44 config.delivery_defaults.options = { 

45 OPTION_SIMPLIFY_TEXT: True, 

46 OPTION_STRIP_URLS: True, 

47 OPTION_MESSAGE_USAGE: MessageOnlyPolicy.STANDARD, 

48 OPTION_UNIQUE_TARGETS: True, 

49 OPTION_TARGET_CATEGORIES: [ATTR_ENTITY_ID], 

50 OPTION_TARGET_INCLUDE_RE: [r"notify\.[a-z0-9_]+\_(speak|announce)", r"group\.[a-z0-9_]+"], 

51 } 

52 return config 

53 

54 async def deliver(self, envelope: Envelope) -> bool: 

55 _LOGGER.debug("SUPERNOTIFY notify_alexa_devices: %s", envelope.message) 

56 

57 targets = envelope.target.entity_ids or [] 

58 

59 if not targets: 

60 _LOGGER.debug("SUPERNOTIFY skipping alexa devices, no targets") 

61 return False 

62 

63 action_data: dict[str, Any] = {ATTR_MESSAGE: envelope.message or ""} 

64 target_data: dict[str, Any] = {ATTR_ENTITY_ID: targets} 

65 

66 return await self.call_action(envelope, action_data=action_data, target_data=target_data)