Home Assistant Unofficial Reference 2024.12.1
diagnostics.py
Go to the documentation of this file.
1 """Diagnostics support for Guardian."""
2 
3 from __future__ import annotations
4 
5 from typing import Any
6 
7 from homeassistant.components.diagnostics import async_redact_data
8 from homeassistant.config_entries import ConfigEntry
9 from homeassistant.const import CONF_UNIQUE_ID
10 from homeassistant.core import HomeAssistant
11 
12 from . import GuardianData
13 from .const import CONF_UID, DOMAIN
14 
15 CONF_BSSID = "bssid"
16 CONF_PAIRED_UIDS = "paired_uids"
17 CONF_SSID = "ssid"
18 CONF_TITLE = "title"
19 
20 TO_REDACT = {
21  CONF_BSSID,
22  CONF_PAIRED_UIDS,
23  CONF_SSID,
24  # Config entry title and unique ID may contain sensitive data:
25  CONF_TITLE,
26  CONF_UNIQUE_ID,
27  CONF_UID,
28 }
29 
30 
32  hass: HomeAssistant, entry: ConfigEntry
33 ) -> dict[str, Any]:
34  """Return diagnostics for a config entry."""
35  data: GuardianData = hass.data[DOMAIN][entry.entry_id]
36 
37  return {
38  "entry": async_redact_data(entry.as_dict(), TO_REDACT),
39  "data": {
40  "valve_controller": {
41  api_category: async_redact_data(coordinator.data, TO_REDACT)
42  for api_category, coordinator in data.valve_controller_coordinators.items()
43  },
44  "paired_sensors": [
45  async_redact_data(coordinator.data, TO_REDACT)
46  for coordinator in data.paired_sensor_manager.coordinators.values()
47  ],
48  },
49  }
dict async_redact_data(Mapping data, Iterable[Any] to_redact)
Definition: util.py:14
dict[str, Any] async_get_config_entry_diagnostics(HomeAssistant hass, ConfigEntry entry)
Definition: diagnostics.py:33