mirror of https://github.com/home-assistant/core
72 lines
1.9 KiB
Python
72 lines
1.9 KiB
Python
"""Trace support for automation."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from collections.abc import Generator
|
|
from contextlib import contextmanager
|
|
from typing import Any
|
|
|
|
from homeassistant.components.trace import (
|
|
CONF_STORED_TRACES,
|
|
ActionTrace,
|
|
async_store_trace,
|
|
)
|
|
from homeassistant.core import Context, HomeAssistant
|
|
from homeassistant.helpers.typing import ConfigType
|
|
|
|
from .const import DOMAIN
|
|
|
|
|
|
class AutomationTrace(ActionTrace):
|
|
"""Container for automation trace."""
|
|
|
|
_domain = DOMAIN
|
|
|
|
def __init__(
|
|
self,
|
|
item_id: str | None,
|
|
config: ConfigType | None,
|
|
blueprint_inputs: ConfigType | None,
|
|
context: Context,
|
|
) -> None:
|
|
"""Container for automation trace."""
|
|
super().__init__(item_id, config, blueprint_inputs, context)
|
|
self._trigger_description: str | None = None
|
|
|
|
def set_trigger_description(self, trigger: str) -> None:
|
|
"""Set trigger description."""
|
|
self._trigger_description = trigger
|
|
|
|
def as_short_dict(self) -> dict[str, Any]:
|
|
"""Return a brief dictionary version of this AutomationTrace."""
|
|
if self._short_dict:
|
|
return self._short_dict
|
|
|
|
result = super().as_short_dict()
|
|
result["trigger"] = self._trigger_description
|
|
return result
|
|
|
|
|
|
@contextmanager
|
|
def trace_automation(
|
|
hass: HomeAssistant,
|
|
automation_id: str | None,
|
|
config: ConfigType | None,
|
|
blueprint_inputs: ConfigType | None,
|
|
context: Context,
|
|
trace_config: ConfigType,
|
|
) -> Generator[AutomationTrace]:
|
|
"""Trace action execution of automation with automation_id."""
|
|
trace = AutomationTrace(automation_id, config, blueprint_inputs, context)
|
|
async_store_trace(hass, trace, trace_config[CONF_STORED_TRACES])
|
|
|
|
try:
|
|
yield trace
|
|
except Exception as ex:
|
|
if automation_id:
|
|
trace.set_error(ex)
|
|
raise
|
|
finally:
|
|
if automation_id:
|
|
trace.finished()
|