__init__.py

Go to the documentation of this file.

"""Support for Linode."""
 
from datetime import timedelta
import logging
 
import linode
import voluptuous as vol
 
from homeassistant.const import CONF_ACCESS_TOKEN, Platform
from homeassistant.core import HomeAssistant
import homeassistant.helpers.config_validation as cv
from homeassistant.helpers.typing import ConfigType
from homeassistant.util import Throttle
 
_LOGGER = logging.getLogger(__name__)
 
ATTR_CREATED = "created"
ATTR_NODE_ID = "node_id"
ATTR_NODE_NAME = "node_name"
ATTR_IPV4_ADDRESS = "ipv4_address"
ATTR_IPV6_ADDRESS = "ipv6_address"
ATTR_MEMORY = "memory"
ATTR_REGION = "region"
ATTR_VCPUS = "vcpus"
 
CONF_NODES = "nodes"
 
DATA_LINODE = "data_li"
LINODE_PLATFORMS = [Platform.BINARY_SENSOR, Platform.SWITCH]
DOMAIN = "linode"
 
MIN_TIME_BETWEEN_UPDATES = timedelta(seconds=60)
 
CONFIG_SCHEMA = vol.Schema(
    {DOMAIN: vol.Schema({vol.Required(CONF_ACCESS_TOKEN): cv.string})},
    extra=vol.ALLOW_EXTRA,
)
 
 
def setup(hass: HomeAssistant, config: ConfigType) -> bool:
    """Set up the Linode component."""
    conf = config[DOMAIN]
    access_token = conf.get(CONF_ACCESS_TOKEN)
 
    _linode = Linode(access_token)
 
    try:
        _LOGGER.debug("Linode Profile %s", _linode.manager.get_profile().username)
    except linode.errors.ApiError as _ex:
        _LOGGER.error(_ex)
        return False
 
    hass.data[DATA_LINODE] = _linode
 
    return True
 
 
class Linode:
    """Handle all communication with the Linode API."""
 
    def __init__(self, access_token):
        """Initialize the Linode connection."""
        self._access_token_access_token = access_token
        self.datadata = None
        self.managermanager = linode.LinodeClient(token=self._access_token_access_token)
 
    def get_node_id(self, node_name):
        """Get the status of a Linode Instance."""
        node_id = None
 
        try:
            all_nodes = self.managermanager.linode.get_instances()
            for node in all_nodes:
                if node_name == node.label:
                    node_id = node.id
        except linode.errors.ApiError as _ex:
            _LOGGER.error(_ex)
 
        return node_id
 
    @Throttle(MIN_TIME_BETWEEN_UPDATES)
    def update(self):
        """Use the data from Linode API."""
        try:
            self.datadata = self.managermanager.linode.get_instances()
        except linode.errors.ApiError as _ex:
            _LOGGER.error(_ex)