Home Assistant Unofficial Reference 2024.12.1
__init__.py
Go to the documentation of this file.
1 """Support for namecheap DNS services."""
2 
3 from datetime import timedelta
4 import logging
5 
6 import defusedxml.ElementTree as ET
7 import voluptuous as vol
8 
9 from homeassistant.const import CONF_DOMAIN, CONF_HOST, CONF_PASSWORD
10 from homeassistant.core import HomeAssistant
11 from homeassistant.helpers.aiohttp_client import async_get_clientsession
13 from homeassistant.helpers.event import async_track_time_interval
14 from homeassistant.helpers.typing import ConfigType
15 
16 _LOGGER = logging.getLogger(__name__)
17 
18 DOMAIN = "namecheapdns"
19 
20 INTERVAL = timedelta(minutes=5)
21 
22 UPDATE_URL = "https://dynamicdns.park-your-domain.com/update"
23 
24 CONFIG_SCHEMA = vol.Schema(
25  {
26  DOMAIN: vol.Schema(
27  {
28  vol.Required(CONF_DOMAIN): cv.string,
29  vol.Required(CONF_PASSWORD): cv.string,
30  vol.Optional(CONF_HOST, default="@"): cv.string,
31  }
32  )
33  },
34  extra=vol.ALLOW_EXTRA,
35 )
36 
37 
38 async def async_setup(hass: HomeAssistant, config: ConfigType) -> bool:
39  """Initialize the namecheap DNS component."""
40  host = config[DOMAIN][CONF_HOST]
41  domain = config[DOMAIN][CONF_DOMAIN]
42  password = config[DOMAIN][CONF_PASSWORD]
43 
44  session = async_get_clientsession(hass)
45 
46  result = await _update_namecheapdns(session, host, domain, password)
47 
48  if not result:
49  return False
50 
51  async def update_domain_interval(now):
52  """Update the namecheap DNS entry."""
53  await _update_namecheapdns(session, host, domain, password)
54 
55  async_track_time_interval(hass, update_domain_interval, INTERVAL)
56 
57  return result
58 
59 
60 async def _update_namecheapdns(session, host, domain, password):
61  """Update namecheap DNS entry."""
62  params = {"host": host, "domain": domain, "password": password}
63 
64  resp = await session.get(UPDATE_URL, params=params)
65  xml_string = await resp.text()
66  root = ET.fromstring(xml_string)
67  err_count = root.find("ErrCount").text
68 
69  if int(err_count) != 0:
70  _LOGGER.warning("Updating namecheap domain failed: %s", domain)
71  return False
72 
73  return True
def _update_namecheapdns(session, host, domain, password)
Definition: __init__.py:60
bool async_setup(HomeAssistant hass, ConfigType config)
Definition: __init__.py:38
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)
CALLBACK_TYPE async_track_time_interval(HomeAssistant hass, Callable[[datetime], Coroutine[Any, Any, None]|None] action, timedelta interval, *str|None name=None, bool|None cancel_on_shutdown=None)
Definition: event.py:1679