Home Assistant Unofficial Reference 2024.12.1
__init__.py
Go to the documentation of this file.
1 """The Open Exchange Rates integration."""
2 
3 from __future__ import annotations
4 
5 from homeassistant.config_entries import ConfigEntry
6 from homeassistant.const import CONF_API_KEY, CONF_BASE, Platform
7 from homeassistant.core import HomeAssistant
8 from homeassistant.helpers.aiohttp_client import async_get_clientsession
9 
10 from .const import BASE_UPDATE_INTERVAL, DOMAIN, LOGGER
11 from .coordinator import OpenexchangeratesCoordinator
12 
13 PLATFORMS = [Platform.SENSOR]
14 
15 
16 async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool:
17  """Set up Open Exchange Rates from a config entry."""
18  api_key: str = entry.data[CONF_API_KEY]
19  base: str = entry.data[CONF_BASE]
20 
21  # Create one coordinator per base currency per API key.
22  existing_coordinators: dict[str, OpenexchangeratesCoordinator] = hass.data.get(
23  DOMAIN, {}
24  )
25  existing_coordinator_for_api_key = {
26  existing_coordinator
27  for config_entry_id, existing_coordinator in existing_coordinators.items()
28  if (config_entry := hass.config_entries.async_get_entry(config_entry_id))
29  and config_entry.data[CONF_API_KEY] == api_key
30  }
31 
32  # Adjust update interval by coordinators per API key.
33  update_interval = BASE_UPDATE_INTERVAL * (len(existing_coordinator_for_api_key) + 1)
34  coordinator = OpenexchangeratesCoordinator(
35  hass,
37  api_key,
38  base,
39  update_interval,
40  )
41 
42  LOGGER.debug("Coordinator update interval set to: %s", update_interval)
43 
44  # Set new interval on all coordinators for this API key.
45  for existing_coordinator in existing_coordinator_for_api_key:
46  existing_coordinator.update_interval = update_interval
47 
48  await coordinator.async_config_entry_first_refresh()
49 
50  hass.data.setdefault(DOMAIN, {})[entry.entry_id] = coordinator
51 
52  await hass.config_entries.async_forward_entry_setups(entry, PLATFORMS)
53 
54  return True
55 
56 
57 async def async_unload_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool:
58  """Unload a config entry."""
59  if unload_ok := await hass.config_entries.async_unload_platforms(entry, PLATFORMS):
60  hass.data[DOMAIN].pop(entry.entry_id)
61 
62  return unload_ok
bool async_unload_entry(HomeAssistant hass, ConfigEntry entry)
Definition: __init__.py:57
bool async_setup_entry(HomeAssistant hass, ConfigEntry entry)
Definition: __init__.py:16
aiohttp.ClientSession async_get_clientsession(HomeAssistant hass, bool verify_ssl=True, socket.AddressFamily family=socket.AF_UNSPEC, ssl_util.SSLCipherList ssl_cipher=ssl_util.SSLCipherList.PYTHON_DEFAULT)