Initial Commit

custom_components/seatemperatures/sensor.py

@@ -0,0 +1,172 @@
+from __future__ import annotations
+
+import logging
+from dataclasses import dataclass
+from typing import Any
+
+from homeassistant.components.sensor import (
+    SensorDeviceClass,
+    SensorEntity,
+    SensorEntityDescription,
+    SensorStateClass,
+)
+from homeassistant.config_entries import ConfigEntry
+from homeassistant.const import UnitOfTemperature
+from homeassistant.core import HomeAssistant
+from homeassistant.helpers.entity_platform import AddEntitiesCallback
+from homeassistant.helpers.update_coordinator import (
+    CoordinatorEntity,
+    DataUpdateCoordinator,
+)
+from homeassistant.util import slugify
+
+from .const import BASE_URL, CONF_AREA, CONF_PATH, CONF_PLACE, CONF_PLACE_ID, DOMAIN
+from .parser import validate_location_path
+
+_LOGGER = logging.getLogger(__name__)
+
+
+def _to_float(val: Any, round_to: int | None = None) -> float | str:
+    """Safely convert a value to float if possible."""
+    try:
+        f_val = float(val)
+        return round(f_val, round_to) if round_to is not None else f_val
+    except (ValueError, TypeError):
+        return val
+
+
+@dataclass(frozen=True, kw_only=True)
+class SeaTemperatureSensorEntityDescription(SensorEntityDescription):
+    """Class describing Sea Temperature sensor entities."""
+
+    data_key: str | None = None
+
+
+# Single sensor per place, representing "Today's Temperature"
+SENSORS: tuple[SeaTemperatureSensorEntityDescription, ...] = (
+    SeaTemperatureSensorEntityDescription(
+        key="today",
+        name="Temperature",
+        data_key="today",
+        icon="mdi:thermometer",
+        native_unit_of_measurement=UnitOfTemperature.CELSIUS,
+        device_class=SensorDeviceClass.TEMPERATURE,
+        state_class=SensorStateClass.MEASUREMENT,
+    ),
+)
+
+
+async def async_setup_entry(
+    hass: HomeAssistant,
+    entry: ConfigEntry,
+    async_add_entities: AddEntitiesCallback,
+) -> None:
+    """Set up the Sea Temperature sensor entry."""
+    coordinator = hass.data[DOMAIN][entry.entry_id]
+
+    sensors = [
+        SeaTemperatureSensor(coordinator, entry, description) for description in SENSORS
+    ]
+
+    async_add_entities(sensors)
+
+
+class SeaTemperatureSensor(CoordinatorEntity, SensorEntity):
+    """Representation of a Sea Temperature Sensor."""
+
+    _attr_has_entity_name = True
+
+    def __init__(
+        self,
+        coordinator: DataUpdateCoordinator,
+        entry: ConfigEntry,
+        description: SeaTemperatureSensorEntityDescription,
+    ):
+        super().__init__(coordinator)
+        self.entity_description = description
+        self._entry = entry
+        self._place_name = entry.data.get(CONF_PLACE, "Unknown")
+        self._location_key = entry.data.get(CONF_PLACE_ID) or entry.data.get(CONF_PATH)
+        if self._location_key is None:
+            self._location_key = self._place_name
+
+        # Set friendly name
+        self._attr_name = "Temperature"
+
+        place_prefix = slugify(self._place_name)
+
+        self._attr_unique_id = f"{DOMAIN}_{self._location_key}_{description.key}"
+        self.entity_id = f"sensor.{DOMAIN}_{place_prefix}_{description.key}"
+
+    @property
+    def native_value(self) -> float | str | None:
+        """Return the state of the sensor."""
+        if not self.coordinator.data:
+            _LOGGER.debug("No coordinator data available for %s", self.entity_id)
+            return None
+
+        _LOGGER.debug(
+            "Coordinator data for %s: %s", self.entity_id, self.coordinator.data
+        )
+
+        # Try to get data from 'sst' nesting if it exists
+        data = self.coordinator.data.get("sst", self.coordinator.data)
+
+        if self.entity_description.data_key in data:
+            return _to_float(data[self.entity_description.data_key])
+
+        return None
+
+    @property
+    def extra_state_attributes(self):
+        """Return the state attributes."""
+        if not self.coordinator.data:
+            return None
+
+        data = self.coordinator.data
+        sst_data = data.get("sst", {})
+
+        attrs = {}
+        for attr_key in ["yesterday", "last_week", "last_year"]:
+            if attr_key in sst_data:
+                attrs[attr_key] = sst_data[attr_key]
+
+        if "date" in data:
+            attrs["date"] = data["date"]
+
+        if "average" in sst_data:
+            for avg_key in ["min", "max", "avg"]:
+                if avg_key in sst_data["average"]:
+                    attrs[f"average_{avg_key}"] = _to_float(
+                        sst_data["average"][avg_key], round_to=2
+                    )
+
+        if "charts" in data:
+            attrs["charts"] = data["charts"]
+
+        attrs["continent"] = self._entry.data.get("continent", "")
+        attrs["country"] = self._entry.data.get("country", "")
+        attrs["area"] = self._entry.data.get(CONF_AREA, "")
+        attrs["place"] = self._place_name
+        attrs["path"] = self._entry.data.get(CONF_PATH, "")
+
+        return attrs if attrs else None
+
+    @property
+    def device_info(self):
+        """Return device information."""
+        url = BASE_URL
+        location_path = self._entry.data.get(CONF_PATH)
+        if location_path:
+            try:
+                url = f"{BASE_URL}{validate_location_path(location_path)}"
+            except ValueError:
+                _LOGGER.debug("Invalid configuration URL path for %s", self._place_name)
+
+        return {
+            "identifiers": {(DOMAIN, self._location_key)},
+            "name": self._place_name,
+            "manufacturer": "Sea Temperatures",
+            "model": "Sea Temperature Monitor",
+            "configuration_url": url,
+        }