Home Assistant Unofficial Reference 2024.12.1
diagnostics.py
Go to the documentation of this file.
1 """Diagnostics for the Subaru integration."""
2 
3 from __future__ import annotations
4 
5 from typing import Any
6 
7 from subarulink.const import (
8  LATITUDE,
9  LONGITUDE,
10  ODOMETER,
11  RAW_API_FIELDS_TO_REDACT,
12  VEHICLE_NAME,
13 )
14 
15 from homeassistant.components.diagnostics import async_redact_data
16 from homeassistant.config_entries import ConfigEntry
17 from homeassistant.const import CONF_DEVICE_ID, CONF_PASSWORD, CONF_PIN, CONF_USERNAME
18 from homeassistant.core import HomeAssistant
19 from homeassistant.exceptions import HomeAssistantError
20 from homeassistant.helpers.device_registry import DeviceEntry
21 
22 from .const import DOMAIN, ENTRY_CONTROLLER, ENTRY_COORDINATOR, VEHICLE_VIN
23 
24 CONFIG_FIELDS_TO_REDACT = [CONF_USERNAME, CONF_PASSWORD, CONF_PIN, CONF_DEVICE_ID]
25 DATA_FIELDS_TO_REDACT = [VEHICLE_VIN, VEHICLE_NAME, LATITUDE, LONGITUDE, ODOMETER]
26 
27 
29  hass: HomeAssistant, config_entry: ConfigEntry
30 ) -> dict[str, Any]:
31  """Return diagnostics for a config entry."""
32  coordinator = hass.data[DOMAIN][config_entry.entry_id][ENTRY_COORDINATOR]
33 
34  return {
35  "config_entry": async_redact_data(config_entry.data, CONFIG_FIELDS_TO_REDACT),
36  "options": async_redact_data(config_entry.options, []),
37  "data": [
38  async_redact_data(info, DATA_FIELDS_TO_REDACT)
39  for info in coordinator.data.values()
40  ],
41  }
42 
43 
45  hass: HomeAssistant, config_entry: ConfigEntry, device: DeviceEntry
46 ) -> dict[str, Any]:
47  """Return diagnostics for a device."""
48  entry = hass.data[DOMAIN][config_entry.entry_id]
49  coordinator = entry[ENTRY_COORDINATOR]
50  controller = entry[ENTRY_CONTROLLER]
51 
52  vin = next(iter(device.identifiers))[1]
53 
54  if info := coordinator.data.get(vin):
55  return {
56  "config_entry": async_redact_data(
57  config_entry.data, CONFIG_FIELDS_TO_REDACT
58  ),
59  "options": async_redact_data(config_entry.options, []),
60  "data": async_redact_data(info, DATA_FIELDS_TO_REDACT),
61  "raw_data": async_redact_data(
62  controller.get_raw_data(vin), RAW_API_FIELDS_TO_REDACT
63  ),
64  }
65 
66  raise HomeAssistantError("Device not found")
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 config_entry)
Definition: diagnostics.py:30
dict[str, Any] async_get_device_diagnostics(HomeAssistant hass, ConfigEntry config_entry, DeviceEntry device)
Definition: diagnostics.py:46