327 lines
12 KiB
Python
Executable File
327 lines
12 KiB
Python
Executable File
from copy import deepcopy
|
|
from dataclasses import dataclass, field
|
|
from datetime import datetime, time, timedelta
|
|
from pathlib import Path
|
|
from typing import Dict, List
|
|
|
|
import appdaemon.utils as utils
|
|
import yaml
|
|
from appdaemon.entity import Entity
|
|
from appdaemon.plugins.hass.hassapi import Hass
|
|
from appdaemon.plugins.mqtt.mqttapi import Mqtt
|
|
from astral import SunDirection
|
|
|
|
|
|
def str_to_timedelta(input_str: str) -> timedelta:
|
|
try:
|
|
hours, minutes, seconds = map(int, input_str.split(':'))
|
|
return timedelta(hours=hours, minutes=minutes, seconds=seconds)
|
|
except Exception:
|
|
return timedelta()
|
|
|
|
@dataclass
|
|
class RoomState:
|
|
scene: Dict[str, Dict[str, str | int]]
|
|
off_duration: timedelta = None
|
|
time: time = None
|
|
time_fmt: List[str] = field(default_factory=lambda : ['%H:%M:%S', '%I:%M:%S %p'], repr=False)
|
|
elevation: int | float = None
|
|
direction: SunDirection = None
|
|
|
|
def __post_init__(self):
|
|
if isinstance(self.time, str):
|
|
for fmt in self.time_fmt:
|
|
try:
|
|
self.time = datetime.strptime(self.time, fmt).time()
|
|
except:
|
|
continue
|
|
else:
|
|
break
|
|
|
|
if self.elevation is not None:
|
|
assert self.direction is not None, f'Elevation setting requires a direction'
|
|
if self.direction.lower() == 'setting':
|
|
self.direction = SunDirection.SETTING
|
|
elif self.direction.lower() == 'rising':
|
|
self.direction = SunDirection.RISING
|
|
else:
|
|
raise ValueError(f'Invalid sun direction: {self.direction}')
|
|
|
|
if isinstance(self.elevation, str):
|
|
self.elevation = float(self.elevation)
|
|
|
|
if isinstance(self.off_duration, str):
|
|
self.off_duration = str_to_timedelta(self.off_duration)
|
|
|
|
@classmethod
|
|
def from_json(cls, json_input):
|
|
return cls(**json_input)
|
|
|
|
|
|
@dataclass
|
|
class RoomConfig:
|
|
states: List[RoomState]
|
|
off_duration: timedelta = field(default_factory=timedelta)
|
|
|
|
def __post_init__(self):
|
|
if isinstance(self.off_duration, str):
|
|
self.off_duration = str_to_timedelta(self.off_duration)
|
|
|
|
@classmethod
|
|
def from_app_config(cls, app_cfg: Dict[str, Dict]):
|
|
if 'class' in app_cfg:
|
|
app_cfg.pop('class')
|
|
if 'module' in app_cfg:
|
|
app_cfg.pop('module')
|
|
self = cls(states=[RoomState.from_json(s) for s in app_cfg['states']])
|
|
for state in self.states:
|
|
if state.off_duration is None:
|
|
state.off_duration = self.off_duration
|
|
return self
|
|
|
|
@classmethod
|
|
def from_yaml(cls, yaml_path: Path, app_name: str):
|
|
with yaml_path.open('r') as f:
|
|
cfg: Dict = yaml.load(f, Loader=yaml.SafeLoader)[app_name]
|
|
return cls.from_app_config(cfg)
|
|
|
|
def sort_states(self):
|
|
"""Should only be called after all the times have been resolved
|
|
"""
|
|
assert all(isinstance(state.time, time) for state in self.states), 'Times have not all been resolved yet'
|
|
self.states = sorted(self.states, key=lambda s: s.time, reverse=True)
|
|
|
|
def current_state(self, current_time: time) -> RoomState:
|
|
time_fmt = "%I:%M:%S %p"
|
|
print(current_time.strftime(time_fmt))
|
|
|
|
self.sort_states()
|
|
for state in self.states:
|
|
if state.time <= current_time:
|
|
return state
|
|
else:
|
|
# self.log(f'Defaulting to first state')
|
|
return self.states[0]
|
|
|
|
class RoomController(Hass, Mqtt):
|
|
"""Class for linking an light with a motion sensor.
|
|
|
|
- Separate the turning on and turning off functions.
|
|
- Use the state change of the light to set up the event for changing to the other state
|
|
- `handle_on`
|
|
- `handle_off`
|
|
- When the light comes on, check if it's attributes match what they should, given the time.
|
|
"""
|
|
|
|
@property
|
|
def states(self) -> List[RoomState]:
|
|
return self._room_config.states
|
|
|
|
@states.setter
|
|
def states(self, new: List[RoomState]):
|
|
assert all(isinstance(s, RoomState) for s in new), f'Invalid: {new}'
|
|
self._room_config.states = new
|
|
|
|
async def initialize(self):
|
|
self.app_entities = await self.gather_app_entities()
|
|
# self.log(f'entities: {self.app_entities}')
|
|
await self.refresh_state_times()
|
|
await self.run_daily(callback=self.refresh_state_times, start='00:00:00')
|
|
|
|
async def gather_app_entities(self) -> List[str]:
|
|
"""Returns a list of all the entities involved in any of the states
|
|
"""
|
|
async def async_generator():
|
|
for settings in deepcopy(self.args['states']):
|
|
if (scene := settings.get('scene')):
|
|
if isinstance(scene, str):
|
|
assert scene.startswith('scene.'), f"Scene definition must start with 'scene.' for app {self.name}"
|
|
entity: Entity = self.get_entity(scene)
|
|
entity_state = await entity.get_state('all')
|
|
attributes = entity_state['attributes']
|
|
for entity in attributes['entity_id']:
|
|
yield entity
|
|
else:
|
|
for key in scene.keys():
|
|
yield key
|
|
else:
|
|
yield self.args['entity']
|
|
|
|
entities = [e async for e in async_generator()]
|
|
return set(entities)
|
|
|
|
async def refresh_state_times(self, *args, **kwargs):
|
|
"""Resets the `self.states` attribute to a newly parsed version of the states.
|
|
|
|
Parsed states have an absolute time for the current day.
|
|
"""
|
|
# re-parse the state strings into times for the current day
|
|
self._room_config = RoomConfig.from_app_config(self.args)
|
|
self.log(f'{len(self._room_config.states)} states in the RoomConfig')
|
|
|
|
for state in self._room_config.states:
|
|
if state.time is None and state.elevation is not None:
|
|
state.time = self.AD.sched.location.time_at_elevation(
|
|
elevation=state.elevation,
|
|
direction=state.direction
|
|
).time()
|
|
elif isinstance(state.time, str):
|
|
state.time = await self.parse_time(state.time)
|
|
|
|
assert isinstance(state.time, time), f'Invalid time: {state.time}'
|
|
|
|
for state in self.states:
|
|
self.log(f'State: {state.time.strftime("%I:%M:%S %p")} {state.scene}')
|
|
|
|
self.states = sorted(self.states, key=lambda s: s.time, reverse=True)
|
|
|
|
# schedule the transitions
|
|
for state in self.states[::-1]:
|
|
# t: time = state['time']
|
|
t: time = state.time
|
|
try:
|
|
await self.run_at(
|
|
callback=self.activate_any_on,
|
|
start=t.strftime('%H:%M:%S'),
|
|
cause='scheduled transition'
|
|
)
|
|
except ValueError:
|
|
# happens when the callback time is in the past
|
|
pass
|
|
except Exception as e:
|
|
self.log(f'Failed with {type(e)}: {e}')
|
|
|
|
async def current_state(self, now: time = None) -> RoomState:
|
|
if (await self.sleep_bool()):
|
|
self.log(f'sleep: active')
|
|
if (state := self.args.get('sleep_state')):
|
|
return RoomState.from_json(state)
|
|
else:
|
|
return RoomState(scene={})
|
|
else:
|
|
now = now or (await self.get_now()).time()
|
|
self.log(f'Getting state for {now}', level='DEBUG')
|
|
|
|
state = self._room_config.current_state(now)
|
|
self.log(f'Current state: {state}', level='DEBUG')
|
|
|
|
return state
|
|
|
|
async def current_scene(self, now: time = None) -> Dict[str, Dict[str, str | int]]:
|
|
state = await self.current_state(now)
|
|
assert isinstance(state, RoomState)
|
|
self.log(f'Current scene: {state}')
|
|
return state.scene
|
|
|
|
async def app_entity_states(self) -> Dict[str, str]:
|
|
states = {
|
|
entity: (await self.get_state(entity))
|
|
for entity in self.app_entities
|
|
}
|
|
return states
|
|
|
|
async def all_off(self) -> bool:
|
|
""""All off" is the logic opposite of "any on"
|
|
|
|
Returns:
|
|
bool: Whether all the lights associated with the app are off
|
|
"""
|
|
states = await self.app_entity_states()
|
|
return all(state != 'on' for entity, state in states.items())
|
|
|
|
async def any_on(self) -> bool:
|
|
""""Any on" is the logic opposite of "all off"
|
|
|
|
Returns:
|
|
bool: Whether any of the lights associated with the app are on
|
|
"""
|
|
states = await self.app_entity_states()
|
|
return any(state == 'on' for entity, state in states.items())
|
|
|
|
async def sleep_bool(self) -> bool:
|
|
if (sleep_var := self.args.get('sleep')):
|
|
return (await self.get_state(sleep_var)) == 'on'
|
|
else:
|
|
return False
|
|
|
|
# @sleep_bool.setter
|
|
# def sleep_bool(self, val) -> bool:
|
|
# if (sleep_var := self.args.get('sleep')):
|
|
# if isinstance(val, str):
|
|
# self.set_state(sleep_var, state=val)
|
|
# elif isinstance(val, bool):
|
|
# self.set_state(sleep_var, state='on' if val else 'off')
|
|
# else:
|
|
# raise ValueError('Sleep variable is undefined')
|
|
|
|
async def off_duration(self) -> timedelta:
|
|
"""Determines the time that the motion sensor has to be clear before deactivating
|
|
|
|
Priority:
|
|
- Value in scene definition
|
|
- Default value
|
|
- Normal - value in app definition
|
|
- Sleep - 0
|
|
|
|
"""
|
|
current_state = await self.current_state()
|
|
if isinstance(current_state.off_duration, timedelta):
|
|
return current_state.off_duration
|
|
else:
|
|
return timedelta()
|
|
|
|
@utils.sync_wrapper
|
|
async def activate(self, entity = None, attribute = None, old = None, new = None, kwargs = None):
|
|
if kwargs is not None:
|
|
cause = kwargs.get('cause', 'unknown')
|
|
else:
|
|
cause = 'unknown'
|
|
|
|
self.log(f'Activating: {cause}')
|
|
scene = await self.current_scene()
|
|
|
|
if isinstance(scene, str):
|
|
self.turn_on(scene)
|
|
self.log(f'Turned on scene: {scene}')
|
|
|
|
elif isinstance(scene, dict):
|
|
# makes setting the state to 'on' optional in the yaml definition
|
|
for entity, settings in scene.items():
|
|
if 'state' not in settings:
|
|
scene[entity]['state'] = 'on'
|
|
|
|
self.call_service('scene/apply', entities=scene, transition=0)
|
|
self.log(f'Applied scene: {scene}')
|
|
|
|
elif scene is None:
|
|
self.log(f'No scene, ignoring...')
|
|
# Need to act as if the light had just turned off to reset the motion (and maybe other things?)
|
|
# self.callback_light_off()
|
|
else:
|
|
self.log(f'ERROR: unknown scene: {scene}')
|
|
|
|
@utils.sync_wrapper
|
|
async def activate_all_off(self, *args, **kwargs):
|
|
"""Activate if all of the entities are off. Args and kwargs are passed directly to self.activate()
|
|
"""
|
|
if (await self.all_off()):
|
|
self.activate(*args, **kwargs)
|
|
else:
|
|
self.log(f'Skipped activating - everything is not off')
|
|
|
|
@utils.sync_wrapper
|
|
async def activate_any_on(self, *args, **kwargs):
|
|
"""Activate if any of the entities are on. Args and kwargs are passed directly to self.activate()
|
|
"""
|
|
if (await self.any_on()):
|
|
self.activate(*args, **kwargs)
|
|
else:
|
|
self.log(f'Skipped activating - everything is off')
|
|
|
|
def deactivate(self, entity = None, attribute = None, old = None, new = None, kwargs = None):
|
|
cause = kwargs.get('cause', 'unknown')
|
|
self.log(f'Deactivating: {cause}')
|
|
for e in self.app_entities:
|
|
self.turn_off(e)
|
|
self.log(f'Turned off {e}')
|