Add Garmin Connect integration

.coveragerc

@@ -255,6 +255,9 @@ omit =
     homeassistant/components/frontier_silicon/media_player.py
     homeassistant/components/futurenow/light.py
     homeassistant/components/garadget/cover.py
+    homeassistant/components/garmin_connect/__init__.py
+    homeassistant/components/garmin_connect/const.py
+    homeassistant/components/garmin_connect/sensor.py
     homeassistant/components/gc100/*
     homeassistant/components/geniushub/*
     homeassistant/components/gearbest/sensor.py

CODEOWNERS

@@ -114,6 +114,7 @@ homeassistant/components/foursquare/* @robbiet480
 homeassistant/components/freebox/* @snoof85
 homeassistant/components/fronius/* @nielstron
 homeassistant/components/frontend/* @home-assistant/frontend
+homeassistant/components/garmin_connect/* @cyberjunky
 homeassistant/components/gearbest/* @HerrHofrat
 homeassistant/components/geniushub/* @zxdavb
 homeassistant/components/geo_rss_events/* @exxamalte

homeassistant/components/garmin_connect/.translations/en.json

@@ -0,0 +1,24 @@
+{
+  "config": {
+    "abort": {
+      "already_setup": "This account is already configured."
+    },
+    "error": {
+      "cannot_connect": "Failed to connect, please try again.",
+      "invalid_auth": "Invalid authentication.",
+      "too_many_requests": "Too many requests, retry later.",
+      "unknown": "Unexpected error."
+    },
+    "step": {
+      "user": {
+        "data": {
+          "password": "Password",
+          "username": "Username"
+        },
+        "description": "Enter your credentials.",
+        "title": "Garmin Connect"
+      }
+    },
+    "title": "Garmin Connect"
+  }
+}

homeassistant/components/garmin_connect/__init__.py

@@ -0,0 +1,104 @@
+"""The Garmin Connect integration."""
+import asyncio
+from datetime import date, timedelta
+import logging
+
+from garminconnect import (
+    Garmin,
+    GarminConnectAuthenticationError,
+    GarminConnectConnectionError,
+    GarminConnectTooManyRequestsError,
+)
+
+from homeassistant.config_entries import ConfigEntry
+from homeassistant.const import CONF_PASSWORD, CONF_USERNAME
+from homeassistant.core import HomeAssistant
+from homeassistant.exceptions import PlatformNotReady
+from homeassistant.util import Throttle
+
+from .const import DOMAIN
+
+_LOGGER = logging.getLogger(__name__)
+
+PLATFORMS = ["sensor"]
+MIN_SCAN_INTERVAL = timedelta(minutes=10)
+
+
+async def async_setup(hass: HomeAssistant, config: dict):
+    """Set up the Garmin Connect component."""
+    hass.data[DOMAIN] = {}
+    return True
+
+
+async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry):
+    """Set up Garmin Connect from a config entry."""
+    username = entry.data[CONF_USERNAME]
+    password = entry.data[CONF_PASSWORD]
+
+    try:
+        garmin_client = Garmin(username, password)
+    except (
+        GarminConnectAuthenticationError,
+        GarminConnectTooManyRequestsError,
+    ) as err:
+        _LOGGER.error("Error occured during Garmin Connect setup: %s", err)
+        return False
+    except (GarminConnectConnectionError) as err:
+        _LOGGER.error("Error occured during Garmin Connect setup: %s", err)
+        raise PlatformNotReady
+    except Exception:  # pylint: disable=broad-except
+        _LOGGER.error("Unknown error occured during Garmin Connect setup")
+        return False
+
+    garmin_data = GarminConnectData(hass, garmin_client)
+    hass.data[DOMAIN][entry.entry_id] = garmin_data
+
+    for component in PLATFORMS:
+        hass.async_create_task(
+            hass.config_entries.async_forward_entry_setup(entry, component)
+        )
+
+    return True
+
+
+async def async_unload_entry(hass: HomeAssistant, entry: ConfigEntry):
+    """Unload a config entry."""
+    unload_ok = all(
+        await asyncio.gather(
+            *[
+                hass.config_entries.async_forward_entry_unload(entry, component)
+                for component in PLATFORMS
+            ]
+        )
+    )
+    if unload_ok:
+        hass.data[DOMAIN].pop(entry.entry_id)
+
+    return unload_ok
+
+
+class GarminConnectData:
+    """Define an object to hold sensor data."""
+
+    def __init__(self, hass, client):
+        """Initialize."""
+        self.client = client
+        self.data = None
+
+    @Throttle(MIN_SCAN_INTERVAL)
+    async def async_update(self):
+        """Update data via library."""
+        today = date.today()
+
+        try:
+            self.data = self.client.get_stats(today.isoformat())
+        except (
+            GarminConnectAuthenticationError,
+            GarminConnectTooManyRequestsError,
+            GarminConnectConnectionError,
+        ) as err:
+            _LOGGER.error("Error occured during Garmin Connect stats update: %s", err)
+            raise PlatformNotReady
+        except Exception:  # pylint: disable=broad-except
+            _LOGGER.error("Unknown error occured during Garmin Connect stats update")
+            return

homeassistant/components/garmin_connect/config_flow.py

@@ -0,0 +1,74 @@
+"""Config flow for Garmin Connect integration."""
+import logging
+
+from garminconnect import (
+    Garmin,
+    GarminConnectAuthenticationError,
+    GarminConnectConnectionError,
+    GarminConnectTooManyRequestsError,
+)
+import voluptuous as vol
+
+from homeassistant import config_entries
+from homeassistant.const import CONF_ID, CONF_PASSWORD, CONF_USERNAME
+
+from .const import DOMAIN
+
+_LOGGER = logging.getLogger(__name__)
+
+
+@config_entries.HANDLERS.register(DOMAIN)
+class GarminConnectConfigFlowHandler(config_entries.ConfigFlow, domain=DOMAIN):
+    """Handle a config flow for Garmin Connect."""
+
+    VERSION = 1
+    CONNECTION_CLASS = config_entries.CONN_CLASS_CLOUD_POLL
+
+    async def _show_setup_form(self, errors=None):
+        """Show the setup form to the user."""
+        return self.async_show_form(
+            step_id="user",
+            data_schema=vol.Schema(
+                {vol.Required(CONF_USERNAME): str, vol.Required(CONF_PASSWORD): str}
+            ),
+            errors=errors or {},
+        )
+
+    async def async_step_user(self, user_input=None):
+        """Handle the initial step."""
+        if user_input is None:
+            return await self._show_setup_form(user_input)
+
+        errors = {}
+        try:
+            unique_id = Garmin(
+                user_input[CONF_USERNAME], user_input[CONF_PASSWORD]
+            ).get_full_name()
+
+        except GarminConnectConnectionError:
+            errors["base"] = "cannot_connect"
+            return await self._show_setup_form(errors)
+        except GarminConnectAuthenticationError:
+            errors["base"] = "invalid_auth"
+            return await self._show_setup_form(errors)
+        except GarminConnectTooManyRequestsError:
+            errors["base"] = "too_many_requests"
+            return await self._show_setup_form(errors)
+        except Exception:  # pylint: disable=broad-except
+            _LOGGER.exception("Unexpected exception")
+            errors["base"] = "unknown"
+            return await self._show_setup_form(errors)
+
+        entries = self._async_current_entries()
+        for entry in entries:
+            if entry.data[CONF_ID] == unique_id:
+                return self.async_abort(reason="already_setup")
+
+        return self.async_create_entry(
+            title=unique_id,
+            data={
+                CONF_ID: unique_id,
+                CONF_USERNAME: user_input[CONF_USERNAME],
+                CONF_PASSWORD: user_input[CONF_PASSWORD],
+            },
+        )