Home Assistant Unofficial Reference 2024.12.1
diagnostics.py
Go to the documentation of this file.
1 """Diagnostics support for a Rainforest RAVEn device."""
2 
3 from __future__ import annotations
4 
5 from collections.abc import Mapping
6 from typing import Any
7 
8 from homeassistant.components.diagnostics import async_redact_data
9 from homeassistant.const import CONF_MAC
10 from homeassistant.core import HomeAssistant, callback
11 
12 from .coordinator import RAVEnConfigEntry
13 
14 TO_REDACT_CONFIG = {CONF_MAC}
15 TO_REDACT_DATA = {"device_mac_id", "meter_mac_id"}
16 
17 
18 @callback
19 def async_redact_meter_macs(data: dict) -> dict:
20  """Redact meter MAC addresses from mapping keys."""
21  if not data.get("Meters"):
22  return data
23 
24  redacted = {**data, "Meters": {}}
25  for idx, mac_id in enumerate(data["Meters"]):
26  redacted["Meters"][f"**REDACTED{idx}**"] = data["Meters"][mac_id]
27 
28  return redacted
29 
30 
32  hass: HomeAssistant, config_entry: RAVEnConfigEntry
33 ) -> Mapping[str, Any]:
34  """Return diagnostics for a config entry."""
35 
36  return {
37  "config_entry": async_redact_data(config_entry.as_dict(), TO_REDACT_CONFIG),
39  async_redact_data(config_entry.runtime_data.data, TO_REDACT_DATA)
40  ),
41  }
dict async_redact_data(Mapping data, Iterable[Any] to_redact)
Definition: util.py:14
Mapping[str, Any] async_get_config_entry_diagnostics(HomeAssistant hass, RAVEnConfigEntry config_entry)
Definition: diagnostics.py:33