meteocat 3.2.0 → 4.0.0

package/custom_components/meteocat/const.py

@@ -1,132 +1,132 @@
-# Constantes generales
-DOMAIN = "meteocat"
-BASE_URL = "https://api.meteo.cat"
-CONF_API_KEY = "api_key"
-TOWN_NAME = "town_name"
-TOWN_ID = "town_id"
-VARIABLE_NAME = "variable_name"
-VARIABLE_ID = "variable_id"
-STATION_NAME = "station_name"
-STATION_ID = "station_id"
-STATION_TYPE = "station_type"
-LATITUDE = "latitude"
-LONGITUDE = "longitude"
-ALTITUDE = "altitude"
-REGION_ID = "region_id"
-REGION_NAME = "region_name"
-PROVINCE_ID = "province_id"
-PROVINCE_NAME = "province_name"
-LIMIT_XEMA = "limit_xema"
-LIMIT_PREDICCIO = "limit_prediccio"
-LIMIT_XDDE = "limit_xdde"
-LIMIT_BASIC = "limit_basic"
-LIMIT_QUOTA = "limit_quota"
-STATION_STATUS = "station_status"
-HOURLY_FORECAST_FILE_STATUS = "hourly_forecast_file_status"
-DAILY_FORECAST_FILE_STATUS = "daily_forecast_file_status"
-UVI_FILE_STATUS = "uvi_file_status"
-ALERTS = "alerts"
-ALERT_FILE_STATUS = "alert_file_status"
-ALERT_WIND = "alert_wind"
-ALERT_RAIN_INTENSITY = "alert_rain_intensity"
-ALERT_RAIN = "alert_rain"
-ALERT_SEA = "alert_sea"
-ALERT_COLD = "alert_cold"
-ALERT_WARM = "alert_warm"
-ALERT_WARM_NIGHT = "alert_warm_night"
-ALERT_SNOW = "alert_snow"
-QUOTA_FILE_STATUS = "quota_file_status"
-QUOTA_XDDE = "quota_xdde"
-QUOTA_PREDICCIO = "quota_prediccio"
-QUOTA_BASIC = "quota_basic"
-QUOTA_XEMA = "quota_xema"
-QUOTA_QUERIES = "quota_queries"
-LIGHTNING_FILE_STATUS = "lightning_file_status"
-SUN = "sun"
-SUNRISE = "sunrise"
-SUNSET = "sunset"
-SUN_FILE_STATUS = "sun_file_status"
-MOON_PHASE = "moon_phase"
-MOON_FILE_STATUS = "moon_file_status"
-MOONRISE = "moonrise"
-MOONSET = "moonset"
-
-from homeassistant.const import Platform
-
-ATTRIBUTION = "Powered by Meteocatpy & Solarmoonpy"
-PLATFORMS = [Platform.SENSOR, Platform.WEATHER]
-DEFAULT_NAME = "METEOCAT"
-
-# Tiempos para validación de API
-DEFAULT_VALIDITY_DAYS = 1  # Número de días a partir de los cuales se considera que el archivo de información está obsoleto
-DEFAULT_VALIDITY_HOURS = 6  # Hora a partir de la cual la API tiene la información actualizada de predicciones disponible para descarga
-DEFAULT_VALIDITY_MINUTES = 0  # Minutos a partir de los cuales la API tiene la información actualizada de predicciones disponible para descarga
-DEFAULT_UVI_LOW_VALIDITY_HOURS = 5  # Hora a partir de la cual la API tiene la información actualizada de datos UVI disponible para descarga con límite bajo de cuota
-DEFAULT_UVI_LOW_VALIDITY_MINUTES = 0  # Minutos a partir de los cuales la API tiene la información actualizada de datos UVI disponible para descarga con límite bajo de cuota
-DEFAULT_UVI_HIGH_VALIDITY_HOURS = 9  # Hora a partir de la cual la API tiene la información actualizada de datos UVI disponible para descarga con límite alto de cuota
-DEFAULT_UVI_HIGH_VALIDITY_MINUTES = 0  # Minutos a partir de los cuales la API tiene la información actualizada de datos UVI disponible para descarga con límite alto de cuota
-DEFAULT_ALERT_VALIDITY_TIME = 120  # Minutos a partir de los cuales las alertas están obsoletas y se se debe proceder a una nueva llamada a la API
-DEFAULT_QUOTES_VALIDITY_TIME = 240 # Minutos a partir de los cuales los datos de cuotas están obsoletos y se se debe proceder a una nueva llamada a la API
-DEFAULT_LIGHTNING_VALIDITY_TIME = 240 # Minutos a partir de los cuales los datos de rayos están obsoletos y se se debe proceder a una nueva llamada a la API
-DEFAULT_LIGHTNING_VALIDITY_HOURS = 1  # Hora a partir de la cual la API tiene la información actualizada de rayos disponible para descarga
-DEFAULT_LIGHTNING_VALIDITY_MINUTES = 0  # Minutos a partir de los cuales la API tiene la información actualizada de rayos disponible para descarga
-
-# Multiplicadores para la duración de validez basada en limit_prediccio
-ALERT_VALIDITY_MULTIPLIER_100 = 12  # para limit_prediccio <= 100
-ALERT_VALIDITY_MULTIPLIER_200 = 6   # para 100 < limit_prediccio <= 200
-ALERT_VALIDITY_MULTIPLIER_500 = 3   # para 200 < limit_prediccio <= 500
-ALERT_VALIDITY_MULTIPLIER_DEFAULT = 1  # para limit_prediccio > 500
-
-# CUOTA ALTA PARA FAVORECER ACTUALIZACIONES DIARIAS DE LAS PREDICCIONES
-PREDICCIO_HIGH_QUOTA_LIMIT = 550
-
-# Códigos de sensores de la API
-WIND_SPEED = "wind_speed"  # Velocidad del viento
-WIND_DIRECTION = "wind_direction"  # Dirección del viento
-WIND_DIRECTION_CARDINAL = "wind_direction_cardinal"  # Dirección del viento en cardinal
-TEMPERATURE = "temperature"  # Temperatura
-HUMIDITY = "humidity"  # Humedad relativa
-PRESSURE = "pressure"  # Presión atmosférica
-PRECIPITATION = "precipitation"  # Precipitación
-PRECIPITATION_ACCUMULATED = "precipitation_accumulated" #Precipitación acumulada
-PRECIPITATION_PROBABILITY = "precipitation_probability" #Precipitación probabilidad
-SOLAR_GLOBAL_IRRADIANCE = "solar_global_irradiance"  # Irradiación solar global
-UV_INDEX = "uv_index"  # UV
-MAX_TEMPERATURE = "max_temperature"  # Temperatura máxima
-MIN_TEMPERATURE = "min_temperature"  # Temperatura mínima
-FEELS_LIKE = "feels_like"  # Sensación térmica
-WIND_GUST = "wind_gust"  # Racha de viento
-STATION_TIMESTAMP = "station_timestamp"  # Código de tiempo de la estación
-CONDITION = "condition"  # Estado del cielo
-MAX_TEMPERATURE_FORECAST = "max_temperature_forecast"  # Temperatura máxima prevista
-MIN_TEMPERATURE_FORECAST = "min_temperature_forecast"  # Temperatura mínima prevista
-LIGHTNING_REGION = "lightning_region"  # Rayos de la comarca
-LIGHTNING_TOWN = "lightning_town"  # Rayos de la población
-
-# Definición de códigos para variables
-WIND_SPEED_CODE = 30
-WIND_DIRECTION_CODE = 31
-TEMPERATURE_CODE = 32
-HUMIDITY_CODE = 33
-PRESSURE_CODE = 34
-PRECIPITATION_CODE = 35
-SOLAR_GLOBAL_IRRADIANCE_CODE = 36
-UV_INDEX_CODE = 39
-MAX_TEMPERATURE_CODE = 40
-MIN_TEMPERATURE_CODE = 42
-WIND_GUST_CODE = 50
-
-# Mapeo de códigos 'estatCel' a condiciones de Home Assistant
-CONDITION_MAPPING = {
-    "sunny": [1],
-    # "clear-night": [1],
-    "partlycloudy": [2, 3],
-    "cloudy": [4, 20, 21, 22],
-    "rainy": [5, 6, 23],
-    "pouring": [7, 8, 25],
-    "lightning-rainy": [8, 24],
-    "hail": [9],
-    "snowy": [10, 26, 27, 28],
-    "fog": [11, 12],
-    "snow-rainy": [27, 29, 30],
-}
+# Constantes generales
+DOMAIN = "meteocat"
+BASE_URL = "https://api.meteo.cat"
+CONF_API_KEY = "api_key"
+TOWN_NAME = "town_name"
+TOWN_ID = "town_id"
+VARIABLE_NAME = "variable_name"
+VARIABLE_ID = "variable_id"
+STATION_NAME = "station_name"
+STATION_ID = "station_id"
+STATION_TYPE = "station_type"
+LATITUDE = "latitude"
+LONGITUDE = "longitude"
+ALTITUDE = "altitude"
+REGION_ID = "region_id"
+REGION_NAME = "region_name"
+PROVINCE_ID = "province_id"
+PROVINCE_NAME = "province_name"
+LIMIT_XEMA = "limit_xema"
+LIMIT_PREDICCIO = "limit_prediccio"
+LIMIT_XDDE = "limit_xdde"
+LIMIT_BASIC = "limit_basic"
+LIMIT_QUOTA = "limit_quota"
+STATION_STATUS = "station_status"
+HOURLY_FORECAST_FILE_STATUS = "hourly_forecast_file_status"
+DAILY_FORECAST_FILE_STATUS = "daily_forecast_file_status"
+UVI_FILE_STATUS = "uvi_file_status"
+ALERTS = "alerts"
+ALERT_FILE_STATUS = "alert_file_status"
+ALERT_WIND = "alert_wind"
+ALERT_RAIN_INTENSITY = "alert_rain_intensity"
+ALERT_RAIN = "alert_rain"
+ALERT_SEA = "alert_sea"
+ALERT_COLD = "alert_cold"
+ALERT_WARM = "alert_warm"
+ALERT_WARM_NIGHT = "alert_warm_night"
+ALERT_SNOW = "alert_snow"
+QUOTA_FILE_STATUS = "quota_file_status"
+QUOTA_XDDE = "quota_xdde"
+QUOTA_PREDICCIO = "quota_prediccio"
+QUOTA_BASIC = "quota_basic"
+QUOTA_XEMA = "quota_xema"
+QUOTA_QUERIES = "quota_queries"
+LIGHTNING_FILE_STATUS = "lightning_file_status"
+SUN = "sun"
+SUNRISE = "sunrise"
+SUNSET = "sunset"
+SUN_FILE_STATUS = "sun_file_status"
+MOON_PHASE = "moon_phase"
+MOON_FILE_STATUS = "moon_file_status"
+MOONRISE = "moonrise"
+MOONSET = "moonset"
+
+from homeassistant.const import Platform
+
+ATTRIBUTION = "Powered by Meteocatpy & Solarmoonpy"
+PLATFORMS = [Platform.SENSOR, Platform.WEATHER]
+DEFAULT_NAME = "METEOCAT"
+
+# Tiempos para validación de API
+DEFAULT_VALIDITY_DAYS = 1  # Número de días a partir de los cuales se considera que el archivo de información está obsoleto
+DEFAULT_VALIDITY_HOURS = 6  # Hora a partir de la cual la API tiene la información actualizada de predicciones disponible para descarga
+DEFAULT_VALIDITY_MINUTES = 0  # Minutos a partir de los cuales la API tiene la información actualizada de predicciones disponible para descarga
+DEFAULT_UVI_LOW_VALIDITY_HOURS = 5  # Hora a partir de la cual la API tiene la información actualizada de datos UVI disponible para descarga con límite bajo de cuota
+DEFAULT_UVI_LOW_VALIDITY_MINUTES = 0  # Minutos a partir de los cuales la API tiene la información actualizada de datos UVI disponible para descarga con límite bajo de cuota
+DEFAULT_UVI_HIGH_VALIDITY_HOURS = 9  # Hora a partir de la cual la API tiene la información actualizada de datos UVI disponible para descarga con límite alto de cuota
+DEFAULT_UVI_HIGH_VALIDITY_MINUTES = 0  # Minutos a partir de los cuales la API tiene la información actualizada de datos UVI disponible para descarga con límite alto de cuota
+DEFAULT_ALERT_VALIDITY_TIME = 120  # Minutos a partir de los cuales las alertas están obsoletas y se se debe proceder a una nueva llamada a la API
+DEFAULT_QUOTES_VALIDITY_TIME = 240 # Minutos a partir de los cuales los datos de cuotas están obsoletos y se se debe proceder a una nueva llamada a la API
+DEFAULT_LIGHTNING_VALIDITY_TIME = 240 # Minutos a partir de los cuales los datos de rayos están obsoletos y se se debe proceder a una nueva llamada a la API
+DEFAULT_LIGHTNING_VALIDITY_HOURS = 1  # Hora a partir de la cual la API tiene la información actualizada de rayos disponible para descarga
+DEFAULT_LIGHTNING_VALIDITY_MINUTES = 0  # Minutos a partir de los cuales la API tiene la información actualizada de rayos disponible para descarga
+
+# Multiplicadores para la duración de validez basada en limit_prediccio
+ALERT_VALIDITY_MULTIPLIER_100 = 12  # para limit_prediccio <= 100
+ALERT_VALIDITY_MULTIPLIER_200 = 6   # para 100 < limit_prediccio <= 200
+ALERT_VALIDITY_MULTIPLIER_500 = 3   # para 200 < limit_prediccio <= 500
+ALERT_VALIDITY_MULTIPLIER_DEFAULT = 1  # para limit_prediccio > 500
+
+# CUOTA ALTA PARA FAVORECER ACTUALIZACIONES DIARIAS DE LAS PREDICCIONES
+PREDICCIO_HIGH_QUOTA_LIMIT = 550
+
+# Códigos de sensores de la API
+WIND_SPEED = "wind_speed"  # Velocidad del viento
+WIND_DIRECTION = "wind_direction"  # Dirección del viento
+WIND_DIRECTION_CARDINAL = "wind_direction_cardinal"  # Dirección del viento en cardinal
+TEMPERATURE = "temperature"  # Temperatura
+HUMIDITY = "humidity"  # Humedad relativa
+PRESSURE = "pressure"  # Presión atmosférica
+PRECIPITATION = "precipitation"  # Precipitación
+PRECIPITATION_ACCUMULATED = "precipitation_accumulated" #Precipitación acumulada
+PRECIPITATION_PROBABILITY = "precipitation_probability" #Precipitación probabilidad
+SOLAR_GLOBAL_IRRADIANCE = "solar_global_irradiance"  # Irradiación solar global
+UV_INDEX = "uv_index"  # UV
+MAX_TEMPERATURE = "max_temperature"  # Temperatura máxima
+MIN_TEMPERATURE = "min_temperature"  # Temperatura mínima
+FEELS_LIKE = "feels_like"  # Sensación térmica
+WIND_GUST = "wind_gust"  # Racha de viento
+STATION_TIMESTAMP = "station_timestamp"  # Código de tiempo de la estación
+CONDITION = "condition"  # Estado del cielo
+MAX_TEMPERATURE_FORECAST = "max_temperature_forecast"  # Temperatura máxima prevista
+MIN_TEMPERATURE_FORECAST = "min_temperature_forecast"  # Temperatura mínima prevista
+LIGHTNING_REGION = "lightning_region"  # Rayos de la comarca
+LIGHTNING_TOWN = "lightning_town"  # Rayos de la población
+
+# Definición de códigos para variables
+WIND_SPEED_CODE = 30
+WIND_DIRECTION_CODE = 31
+TEMPERATURE_CODE = 32
+HUMIDITY_CODE = 33
+PRESSURE_CODE = 34
+PRECIPITATION_CODE = 35
+SOLAR_GLOBAL_IRRADIANCE_CODE = 36
+UV_INDEX_CODE = 39
+MAX_TEMPERATURE_CODE = 40
+MIN_TEMPERATURE_CODE = 42
+WIND_GUST_CODE = 50
+
+# Mapeo de códigos 'estatCel' a condiciones de Home Assistant
+CONDITION_MAPPING = {
+    "sunny": [1],
+    # "clear-night": [1],
+    "partlycloudy": [2, 3],
+    "cloudy": [4, 20, 21, 22],
+    "rainy": [5, 6, 23],
+    "pouring": [7, 8, 25],
+    "lightning-rainy": [8, 24],
+    "hail": [9],
+    "snowy": [10, 26, 27, 28],
+    "fog": [11, 12],
+    "snow-rainy": [27, 29, 30],
+}

package/custom_components/meteocat/helpers.py

@@ -1,58 +1,58 @@
-from __future__ import annotations
-
-import logging
-from datetime import datetime
-from pathlib import Path
-from homeassistant.core import HomeAssistant
-from homeassistant.util import dt as dt_util
-from solarmoonpy.location import Location
-
-_LOGGER = logging.getLogger(__name__)
-
-# Ruta base para guardar archivos persistentes que se descargan de la API y que son utilizados por los coordinadores
-def get_storage_dir(hass: HomeAssistant, subdir: str | None = None) -> Path:
-    """Devuelve una ruta persistente en config/meteocat_files[/subdir]."""
-    base_dir = Path(hass.config.path("meteocat_files"))
-    if subdir:
-        base_dir = base_dir / subdir
-    base_dir.mkdir(parents=True, exist_ok=True)
-    return base_dir
-
-# Cálculo de amanecer y atardecer para definir cuando es de noche
-def get_sun_times(location: Location, current_time: datetime | None = None) -> tuple[datetime, datetime]:
-    """Obtiene las horas de amanecer y atardecer para una ubicación usando solarmoonpy."""
-    now = dt_util.as_local(current_time or dt_util.now())
-    today = now.date()
-    sunrise = location.sunrise(date=today, local=True)
-    sunset = location.sunset(date=today, local=True)
-
-    if not sunrise or not sunset:
-        raise ValueError("No se pudieron calcular amanecer o atardecer.")
-
-    _LOGGER.debug(
-        "[solarmoonpy] Amanecer: %s, Atardecer: %s, Hora actual: %s",
-        sunrise, sunset, now
-    )
-    return sunrise, sunset
-
-def is_night(current_time, location: Location) -> bool:
-    """Determina si actualmente es de noche usando una instancia de Location."""
-    # Asegurarse de que current_time sea aware y en zona local
-    if current_time.tzinfo is None:
-        _LOGGER.warning("current_time sin zona horaria, asumiendo UTC")
-        current_time = dt_util.as_local(dt_util.utc_to_local(current_time))
-    else:
-        current_time = dt_util.as_local(current_time)
-
-    try:
-        sunrise, sunset = get_sun_times(location, current_time)
-    except Exception as e:
-        _LOGGER.warning("Fallo al calcular amanecer/atardecer con solarmoonpy: %s", e)
-        return False  # fallback seguro
-
-    is_night_now = current_time < sunrise or current_time > sunset
-    _LOGGER.debug(
-        "[solarmoonpy] Hora actual: %s | Amanecer: %s | Atardecer: %s → Noche: %s",
-        current_time, sunrise, sunset, is_night_now
-    )
-    return is_night_now
+from __future__ import annotations
+
+import logging
+from datetime import datetime
+from pathlib import Path
+from homeassistant.core import HomeAssistant
+from homeassistant.util import dt as dt_util
+from solarmoonpy.location import Location
+
+_LOGGER = logging.getLogger(__name__)
+
+# Ruta base para guardar archivos persistentes que se descargan de la API y que son utilizados por los coordinadores
+def get_storage_dir(hass: HomeAssistant, subdir: str | None = None) -> Path:
+    """Devuelve una ruta persistente en config/meteocat_files[/subdir]."""
+    base_dir = Path(hass.config.path("meteocat_files"))
+    if subdir:
+        base_dir = base_dir / subdir
+    base_dir.mkdir(parents=True, exist_ok=True)
+    return base_dir
+
+# Cálculo de amanecer y atardecer para definir cuando es de noche
+def get_sun_times(location: Location, current_time: datetime | None = None) -> tuple[datetime, datetime]:
+    """Obtiene las horas de amanecer y atardecer para una ubicación usando solarmoonpy."""
+    now = dt_util.as_local(current_time or dt_util.now())
+    today = now.date()
+    sunrise = location.sunrise(date=today, local=True)
+    sunset = location.sunset(date=today, local=True)
+
+    if not sunrise or not sunset:
+        raise ValueError("No se pudieron calcular amanecer o atardecer.")
+
+    _LOGGER.debug(
+        "[solarmoonpy] Amanecer: %s, Atardecer: %s, Hora actual: %s",
+        sunrise, sunset, now
+    )
+    return sunrise, sunset
+
+def is_night(current_time, location: Location) -> bool:
+    """Determina si actualmente es de noche usando una instancia de Location."""
+    # Asegurarse de que current_time sea aware y en zona local
+    if current_time.tzinfo is None:
+        _LOGGER.warning("current_time sin zona horaria, asumiendo UTC")
+        current_time = dt_util.as_local(dt_util.utc_to_local(current_time))
+    else:
+        current_time = dt_util.as_local(current_time)
+
+    try:
+        sunrise, sunset = get_sun_times(location, current_time)
+    except Exception as e:
+        _LOGGER.warning("Fallo al calcular amanecer/atardecer con solarmoonpy: %s", e)
+        return False  # fallback seguro
+
+    is_night_now = current_time < sunrise or current_time > sunset
+    _LOGGER.debug(
+        "[solarmoonpy] Hora actual: %s | Amanecer: %s | Atardecer: %s → Noche: %s",
+        current_time, sunrise, sunset, is_night_now
+    )
+    return is_night_now

package/custom_components/meteocat/manifest.json

@@ -1,25 +1,25 @@
-{
-  "domain": "meteocat",
-  "name": "Meteocat",
-  "codeowners": [
-    "@figorr"
-  ],
-  "config_flow": true,
-  "dependencies": [
-    "persistent_notification",
-    "http"
-  ],
-  "documentation": "https://github.com/figorr/meteocat",
-  "iot_class": "cloud_polling",
-  "issue_tracker": "https://github.com/figorr/meteocat/issues",
-  "loggers": [
-    "meteocatpy"
-  ],
-  "requirements": [
-    "meteocatpy==1.0.2",
-    "solarmoonpy==1.0.8",
-    "packaging>=20.3",
-    "wrapt>=1.14.0"
-  ],
-  "version": "3.2.0"
-}
+{
+  "domain": "meteocat",
+  "name": "Meteocat",
+  "codeowners": [
+    "@figorr"
+  ],
+  "config_flow": true,
+  "dependencies": [
+    "persistent_notification",
+    "http"
+  ],
+  "documentation": "https://github.com/figorr/meteocat",
+  "iot_class": "cloud_polling",
+  "issue_tracker": "https://github.com/figorr/meteocat/issues",
+  "loggers": [
+    "meteocatpy"
+  ],
+  "requirements": [
+    "meteocatpy==1.0.2",
+    "solarmoonpy==1.0.8",
+    "packaging>=20.3",
+    "wrapt>=1.14.0"
+  ],
+  "version": "4.0.0"
+}