aiohomematic 2025.10.1__py3-none-any.whl → 2025.10.2__py3-none-any.whl

aiohomematic/model/calculated/support.py

@@ -19,7 +19,7 @@ from aiohomematic.support import extract_exc_args
 _LOGGER: Final = logging.getLogger(__name__)
 
 
-def _calculate_heat_index(temperature: float, humidity: int) -> float:
+def _calculate_heat_index(*, temperature: float, humidity: int) -> float:
     """
     Calculate the Heat Index (feels like temperature) based on the NOAA equation.
 
@@ -68,7 +68,7 @@ def _calculate_heat_index(temperature: float, humidity: int) -> float:
     return heat_index_celsius
 
 
-def _calculate_wind_chill(temperature: float, wind_speed: float) -> float | None:
+def _calculate_wind_chill(*, temperature: float, wind_speed: float) -> float | None:
     """
     Calculate the Wind Chill (feels like temperature) based on NOAA.
 
@@ -84,7 +84,7 @@ def _calculate_wind_chill(temperature: float, wind_speed: float) -> float | None
     return float(13.12 + (0.6215 * temperature) - 11.37 * wind_speed**0.16 + 0.3965 * temperature * wind_speed**0.16)
 
 
-def calculate_vapor_concentration(temperature: float, humidity: int) -> float | None:
+def calculate_vapor_concentration(*, temperature: float, humidity: int) -> float | None:
     """Calculate the vapor concentration."""
     try:
         abs_temperature = temperature + 273.15
@@ -105,7 +105,7 @@ def calculate_vapor_concentration(temperature: float, humidity: int) -> float |
     return None
 
 
-def calculate_apparent_temperature(temperature: float, humidity: int, wind_speed: float) -> float | None:
+def calculate_apparent_temperature(*, temperature: float, humidity: int, wind_speed: float) -> float | None:
     """Calculate the apparent temperature based on NOAA."""
     try:
         if temperature <= 10 and wind_speed > 4.8:
@@ -130,7 +130,7 @@ def calculate_apparent_temperature(temperature: float, humidity: int, wind_speed
     return None
 
 
-def calculate_dew_point(temperature: float, humidity: int) -> float | None:
+def calculate_dew_point(*, temperature: float, humidity: int) -> float | None:
     """Calculate the dew point."""
     try:
         a0 = 373.15 / (273.15 + temperature)
@@ -155,7 +155,7 @@ def calculate_dew_point(temperature: float, humidity: int) -> float | None:
     return None
 
 
-def calculate_frost_point(temperature: float, humidity: int) -> float | None:
+def calculate_frost_point(*, temperature: float, humidity: int) -> float | None:
     """Calculate the frost point."""
     try:
         if (dewpoint := calculate_dew_point(temperature=temperature, humidity=humidity)) is None:
@@ -177,7 +177,7 @@ def calculate_frost_point(temperature: float, humidity: int) -> float | None:
 
 
 def calculate_operating_voltage_level(
-    operating_voltage: float | None, low_bat_limit: float | None, voltage_max: float | None
+    *, operating_voltage: float | None, low_bat_limit: float | None, voltage_max: float | None
 ) -> float | None:
     """Return the operating voltage level."""
     if operating_voltage is None or low_bat_limit is None or voltage_max is None:

aiohomematic/model/custom/__init__.py

@@ -152,7 +152,7 @@ _LOGGER: Final = logging.getLogger(__name__)
 
 
 @inspector
-def create_custom_data_points(device: hmd.Device) -> None:
+def create_custom_data_points(*, device: hmd.Device) -> None:
     """Decides which data point category should be used, and creates the required data points."""
 
     if device.ignore_for_custom_data_point:
@@ -163,7 +163,7 @@ def create_custom_data_points(device: hmd.Device) -> None:
             device.model,
         )
         return
-    if data_point_definition_exists(device.model):
+    if data_point_definition_exists(model=device.model):
         _LOGGER.debug(
             "CREATE_CUSTOM_DATA_POINTS: Handling custom data point integration: %s, %s, %s",
             device.interface_id,
@@ -174,4 +174,4 @@ def create_custom_data_points(device: hmd.Device) -> None:
         # Call the custom creation function.
         for custom_config in get_custom_configs(model=device.model):
             for channel in device.channels.values():
-                custom_config.make_ce_func(channel, custom_config)
+                custom_config.make_ce_func(channel=channel, custom_config=custom_config)

aiohomematic/model/custom/climate.py

@@ -191,6 +191,7 @@ class BaseCustomDpClimate(CustomDataPoint):
 
     def __init__(
         self,
+        *,
         channel: hmd.Channel,
         unique_id: str,
         device_profile: DeviceProfile,
@@ -236,7 +237,7 @@ class BaseCustomDpClimate(CustomDataPoint):
         )
 
     @abstractmethod
-    def _manu_temp_changed(self, data_point: GenericDataPoint) -> None:
+    def _manu_temp_changed(self, *, data_point: GenericDataPoint | None = None, **kwargs: Any) -> None:
         """Handle device state changes."""
 
     @state_property
@@ -354,6 +355,7 @@ class BaseCustomDpClimate(CustomDataPoint):
     @bind_collector()
     async def set_temperature(
         self,
+        *,
         temperature: float,
         collector: CallParameterCollector | None = None,
         do_validate: bool = True,
@@ -370,19 +372,19 @@ class BaseCustomDpClimate(CustomDataPoint):
         await self._dp_setpoint.send_value(value=temperature, collector=collector, do_validate=do_validate)
 
     @bind_collector()
-    async def set_mode(self, mode: ClimateMode, collector: CallParameterCollector | None = None) -> None:
+    async def set_mode(self, *, mode: ClimateMode, collector: CallParameterCollector | None = None) -> None:
         """Set new target mode."""
 
     @bind_collector()
-    async def set_profile(self, profile: ClimateProfile, collector: CallParameterCollector | None = None) -> None:
+    async def set_profile(self, *, profile: ClimateProfile, collector: CallParameterCollector | None = None) -> None:
         """Set new profile."""
 
     @inspector
-    async def enable_away_mode_by_calendar(self, start: datetime, end: datetime, away_temperature: float) -> None:
+    async def enable_away_mode_by_calendar(self, *, start: datetime, end: datetime, away_temperature: float) -> None:
         """Enable the away mode by calendar on thermostat."""
 
     @inspector
-    async def enable_away_mode_by_duration(self, hours: int, away_temperature: float) -> None:
+    async def enable_away_mode_by_duration(self, *, hours: int, away_temperature: float) -> None:
         """Enable the away mode by duration on thermostat."""
 
     @inspector
@@ -402,7 +404,7 @@ class BaseCustomDpClimate(CustomDataPoint):
         return super().is_state_change(**kwargs)
 
     @inspector
-    async def copy_schedule(self, target_climate_data_point: BaseCustomDpClimate) -> None:
+    async def copy_schedule(self, *, target_climate_data_point: BaseCustomDpClimate) -> None:
         """Copy schedule to target device."""
 
         if self.schedule_profile_nos != target_climate_data_point.schedule_profile_nos:
@@ -417,6 +419,7 @@ class BaseCustomDpClimate(CustomDataPoint):
     @inspector
     async def copy_schedule_profile(
         self,
+        *,
         source_profile: ScheduleProfile,
         target_profile: ScheduleProfile,
         target_climate_data_point: BaseCustomDpClimate | None = None,
@@ -445,7 +448,7 @@ class BaseCustomDpClimate(CustomDataPoint):
         )
 
     @inspector
-    async def get_schedule_profile(self, profile: ScheduleProfile) -> PROFILE_DICT:
+    async def get_schedule_profile(self, *, profile: ScheduleProfile) -> PROFILE_DICT:
         """Return a schedule by climate profile."""
         if not self._supports_schedule:
             raise ValidationException(f"Schedule is not supported by device {self._device.name}")
@@ -453,7 +456,7 @@ class BaseCustomDpClimate(CustomDataPoint):
         return schedule_data.get(profile, {})
 
     @inspector
-    async def get_schedule_profile_weekday(self, profile: ScheduleProfile, weekday: ScheduleWeekday) -> WEEKDAY_DICT:
+    async def get_schedule_profile_weekday(self, *, profile: ScheduleProfile, weekday: ScheduleWeekday) -> WEEKDAY_DICT:
         """Return a schedule by climate profile."""
         if not self._supports_schedule:
             raise ValidationException(f"Schedule is not supported by device {self._device.name}")
@@ -474,7 +477,7 @@ class BaseCustomDpClimate(CustomDataPoint):
         return raw_schedule
 
     async def _get_schedule_profile(
-        self, profile: ScheduleProfile | None = None, weekday: ScheduleWeekday | None = None
+        self, *, profile: ScheduleProfile | None = None, weekday: ScheduleWeekday | None = None
     ) -> _SCHEDULE_DICT:
         """Get the schedule."""
         schedule_data: _SCHEDULE_DICT = {}
@@ -506,7 +509,7 @@ class BaseCustomDpClimate(CustomDataPoint):
 
     @inspector
     async def set_schedule_profile(
-        self, profile: ScheduleProfile, profile_data: PROFILE_DICT, do_validate: bool = True
+        self, *, profile: ScheduleProfile, profile_data: PROFILE_DICT, do_validate: bool = True
     ) -> None:
         """Set a profile to device."""
         await self._set_schedule_profile(
@@ -518,6 +521,7 @@ class BaseCustomDpClimate(CustomDataPoint):
 
     async def _set_schedule_profile(
         self,
+        *,
         target_channel_address: str,
         profile: ScheduleProfile,
         profile_data: PROFILE_DICT,
@@ -547,6 +551,7 @@ class BaseCustomDpClimate(CustomDataPoint):
     @inspector
     async def set_simple_schedule_profile(
         self,
+        *,
         profile: ScheduleProfile,
         base_temperature: float,
         simple_profile_data: SIMPLE_PROFILE_DICT,
@@ -560,6 +565,7 @@ class BaseCustomDpClimate(CustomDataPoint):
     @inspector
     async def set_schedule_profile_weekday(
         self,
+        *,
         profile: ScheduleProfile,
         weekday: ScheduleWeekday,
         weekday_data: WEEKDAY_DICT,
@@ -588,6 +594,7 @@ class BaseCustomDpClimate(CustomDataPoint):
     @inspector
     async def set_simple_schedule_profile_weekday(
         self,
+        *,
         profile: ScheduleProfile,
         weekday: ScheduleWeekday,
         base_temperature: float,
@@ -600,7 +607,7 @@ class BaseCustomDpClimate(CustomDataPoint):
         await self.set_schedule_profile_weekday(profile=profile, weekday=weekday, weekday_data=weekday_data)
 
     def _validate_and_convert_simple_to_profile(
-        self, base_temperature: float, simple_profile_data: SIMPLE_PROFILE_DICT
+        self, *, base_temperature: float, simple_profile_data: SIMPLE_PROFILE_DICT
     ) -> PROFILE_DICT:
         """Convert simple profile dict to profile dict."""
         profile_dict: PROFILE_DICT = {}
@@ -611,7 +618,7 @@ class BaseCustomDpClimate(CustomDataPoint):
         return profile_dict
 
     def _validate_and_convert_simple_to_profile_weekday(
-        self, base_temperature: float, simple_weekday_list: SIMPLE_WEEKDAY_LIST
+        self, *, base_temperature: float, simple_weekday_list: SIMPLE_WEEKDAY_LIST
     ) -> WEEKDAY_DICT:
         """Convert simple weekday list to weekday dict."""
         if not self.min_temp <= base_temperature <= self.max_temp:
@@ -632,12 +639,16 @@ class BaseCustomDpClimate(CustomDataPoint):
             if (temperature := slot.get(ScheduleSlotType.TEMPERATURE)) is None:
                 raise ValidationException("VALIDATE_PROFILE: TEMPERATURE is missing.")
 
-            if _convert_time_str_to_minutes(str(starttime)) >= _convert_time_str_to_minutes(str(endtime)):
+            if _convert_time_str_to_minutes(time_str=str(starttime)) >= _convert_time_str_to_minutes(
+                time_str=str(endtime)
+            ):
                 raise ValidationException(
                     f"VALIDATE_PROFILE: Start time {starttime} must lower than end time {endtime}"
                 )
 
-            if _convert_time_str_to_minutes(str(starttime)) < _convert_time_str_to_minutes(previous_endtime):
+            if _convert_time_str_to_minutes(time_str=str(starttime)) < _convert_time_str_to_minutes(
+                time_str=previous_endtime
+            ):
                 raise ValidationException(
                     f"VALIDATE_PROFILE: Timespans are overlapping with a previous slot for start time: {starttime} / end time: {endtime}"
                 )
@@ -648,7 +659,9 @@ class BaseCustomDpClimate(CustomDataPoint):
                     f"max: {self.max_temp}) for start time: {starttime} / end time: {endtime}"
                 )
 
-            if _convert_time_str_to_minutes(str(starttime)) > _convert_time_str_to_minutes(previous_endtime):
+            if _convert_time_str_to_minutes(time_str=str(starttime)) > _convert_time_str_to_minutes(
+                time_str=previous_endtime
+            ):
                 weekday_data[slot_no] = {
                     ScheduleSlotType.ENDTIME: starttime,
                     ScheduleSlotType.TEMPERATURE: base_temperature,
@@ -664,13 +677,14 @@ class BaseCustomDpClimate(CustomDataPoint):
 
         return _fillup_weekday_data(base_temperature=base_temperature, weekday_data=weekday_data)
 
-    def _validate_schedule_profile(self, profile: ScheduleProfile, profile_data: PROFILE_DICT) -> None:
+    def _validate_schedule_profile(self, *, profile: ScheduleProfile, profile_data: PROFILE_DICT) -> None:
         """Validate the profile."""
         for weekday, weekday_data in profile_data.items():
             self._validate_schedule_profile_weekday(profile=profile, weekday=weekday, weekday_data=weekday_data)
 
     def _validate_schedule_profile_weekday(
         self,
+        *,
         profile: ScheduleProfile,
         weekday: ScheduleWeekday,
         weekday_data: WEEKDAY_DICT,
@@ -720,7 +734,7 @@ class CustomDpSimpleRfThermostat(BaseCustomDpClimate):
 
     __slots__ = ()
 
-    def _manu_temp_changed(self, data_point: GenericDataPoint) -> None:
+    def _manu_temp_changed(self, *, data_point: GenericDataPoint | None = None, **kwargs: Any) -> None:
         """Handle device state changes."""
 
 
@@ -741,6 +755,7 @@ class CustomDpRfThermostat(BaseCustomDpClimate):
 
     def __init__(
         self,
+        *,
         channel: hmd.Channel,
         unique_id: str,
         device_profile: DeviceProfile,
@@ -788,7 +803,7 @@ class CustomDpRfThermostat(BaseCustomDpClimate):
             )
         )
 
-    def _manu_temp_changed(self, data_point: GenericDataPoint) -> None:
+    def _manu_temp_changed(self, *, data_point: GenericDataPoint | None = None, **kwargs: Any) -> None:
         """Handle device state changes."""
         if (
             data_point == self._dp_control_mode
@@ -861,7 +876,7 @@ class CustomDpRfThermostat(BaseCustomDpClimate):
         return self._dp_temperature_offset.value
 
     @bind_collector()
-    async def set_mode(self, mode: ClimateMode, collector: CallParameterCollector | None = None) -> None:
+    async def set_mode(self, *, mode: ClimateMode, collector: CallParameterCollector | None = None) -> None:
         """Set new mode."""
         if not self.is_state_change(mode=mode):
             return
@@ -876,7 +891,7 @@ class CustomDpRfThermostat(BaseCustomDpClimate):
             await self.set_temperature(temperature=_OFF_TEMPERATURE, collector=collector, do_validate=False)
 
     @bind_collector()
-    async def set_profile(self, profile: ClimateProfile, collector: CallParameterCollector | None = None) -> None:
+    async def set_profile(self, *, profile: ClimateProfile, collector: CallParameterCollector | None = None) -> None:
         """Set new profile."""
         if not self.is_state_change(profile=profile):
             return
@@ -896,7 +911,7 @@ class CustomDpRfThermostat(BaseCustomDpClimate):
                 )
 
     @inspector
-    async def enable_away_mode_by_calendar(self, start: datetime, end: datetime, away_temperature: float) -> None:
+    async def enable_away_mode_by_calendar(self, *, start: datetime, end: datetime, away_temperature: float) -> None:
         """Enable the away mode by calendar on thermostat."""
         await self._client.set_value(
             channel_address=self._channel.address,
@@ -906,7 +921,7 @@ class CustomDpRfThermostat(BaseCustomDpClimate):
         )
 
     @inspector
-    async def enable_away_mode_by_duration(self, hours: int, away_temperature: float) -> None:
+    async def enable_away_mode_by_duration(self, *, hours: int, away_temperature: float) -> None:
         """Enable the away mode by duration on thermostat."""
         start = datetime.now() - timedelta(minutes=10)
         end = datetime.now() + timedelta(hours=hours)
@@ -954,7 +969,7 @@ class CustomDpRfThermostat(BaseCustomDpClimate):
         return profiles
 
 
-def _party_mode_code(start: datetime, end: datetime, away_temperature: float) -> str:
+def _party_mode_code(*, start: datetime, end: datetime, away_temperature: float) -> str:
     """
     Create the party mode code.
 
@@ -983,6 +998,7 @@ class CustomDpIpThermostat(BaseCustomDpClimate):
 
     def __init__(
         self,
+        *,
         channel: hmd.Channel,
         unique_id: str,
         device_profile: DeviceProfile,
@@ -1032,7 +1048,7 @@ class CustomDpIpThermostat(BaseCustomDpClimate):
             )
         )
 
-    def _manu_temp_changed(self, data_point: GenericDataPoint) -> None:
+    def _manu_temp_changed(self, *, data_point: GenericDataPoint | None = None, **kwargs: Any) -> None:
         """Handle device state changes."""
         if (
             data_point == self._dp_set_point_mode
@@ -1135,7 +1151,7 @@ class CustomDpIpThermostat(BaseCustomDpClimate):
         return self._dp_temperature_offset.value
 
     @bind_collector()
-    async def set_mode(self, mode: ClimateMode, collector: CallParameterCollector | None = None) -> None:
+    async def set_mode(self, *, mode: ClimateMode, collector: CallParameterCollector | None = None) -> None:
         """Set new target mode."""
         if not self.is_state_change(mode=mode):
             return
@@ -1153,7 +1169,7 @@ class CustomDpIpThermostat(BaseCustomDpClimate):
             await self.set_temperature(temperature=_OFF_TEMPERATURE, collector=collector, do_validate=False)
 
     @bind_collector()
-    async def set_profile(self, profile: ClimateProfile, collector: CallParameterCollector | None = None) -> None:
+    async def set_profile(self, *, profile: ClimateProfile, collector: CallParameterCollector | None = None) -> None:
         """Set new control mode."""
         if not self.is_state_change(profile=profile):
             return
@@ -1169,7 +1185,7 @@ class CustomDpIpThermostat(BaseCustomDpClimate):
                 await self._dp_active_profile.send_value(value=profile_idx, collector=collector)
 
     @inspector
-    async def enable_away_mode_by_calendar(self, start: datetime, end: datetime, away_temperature: float) -> None:
+    async def enable_away_mode_by_calendar(self, *, start: datetime, end: datetime, away_temperature: float) -> None:
         """Enable the away mode by calendar on thermostat."""
         await self._client.put_paramset(
             channel_address=self._channel.address,
@@ -1183,7 +1199,7 @@ class CustomDpIpThermostat(BaseCustomDpClimate):
         )
 
     @inspector
-    async def enable_away_mode_by_duration(self, hours: int, away_temperature: float) -> None:
+    async def enable_away_mode_by_duration(self, *, hours: int, away_temperature: float) -> None:
         """Enable the away mode by duration on thermostat."""
         start = datetime.now() - timedelta(minutes=10)
         end = datetime.now() + timedelta(hours=hours)
@@ -1243,7 +1259,7 @@ def _convert_minutes_to_time_str(minutes: Any) -> str:
     return time_str
 
 
-def _convert_time_str_to_minutes(time_str: str) -> int:
+def _convert_time_str_to_minutes(*, time_str: str) -> int:
     """Convert minutes to a time string."""
     if SCHEDULER_TIME_PATTERN.match(time_str) is None:
         raise ValidationException(
@@ -1256,17 +1272,18 @@ def _convert_time_str_to_minutes(time_str: str) -> int:
         raise ValidationException(f"Failed to convert time {time_str}. Format must be hh:mm.") from exc
 
 
-def _sort_simple_weekday_list(simple_weekday_list: SIMPLE_WEEKDAY_LIST) -> SIMPLE_WEEKDAY_LIST:
+def _sort_simple_weekday_list(*, simple_weekday_list: SIMPLE_WEEKDAY_LIST) -> SIMPLE_WEEKDAY_LIST:
     """Sort simple weekday list."""
     simple_weekday_dict = sorted(
         {
-            _convert_time_str_to_minutes(str(slot[ScheduleSlotType.STARTTIME])): slot for slot in simple_weekday_list
+            _convert_time_str_to_minutes(time_str=str(slot[ScheduleSlotType.STARTTIME])): slot
+            for slot in simple_weekday_list
         }.items()
     )
     return [slot[1] for slot in simple_weekday_dict]
 
 
-def _fillup_weekday_data(base_temperature: float, weekday_data: WEEKDAY_DICT) -> WEEKDAY_DICT:
+def _fillup_weekday_data(*, base_temperature: float, weekday_data: WEEKDAY_DICT) -> WEEKDAY_DICT:
     """Fillup weekday data."""
     for slot_no in SCHEDULE_SLOT_IN_RANGE:
         if slot_no not in weekday_data:
@@ -1278,7 +1295,7 @@ def _fillup_weekday_data(base_temperature: float, weekday_data: WEEKDAY_DICT) ->
     return weekday_data
 
 
-def _get_raw_schedule_paramset(schedule_data: _SCHEDULE_DICT) -> _RAW_SCHEDULE_DICT:
+def _get_raw_schedule_paramset(*, schedule_data: _SCHEDULE_DICT) -> _RAW_SCHEDULE_DICT:
     """Return the raw paramset."""
     raw_paramset: _RAW_SCHEDULE_DICT = {}
     for profile, profile_data in schedule_data.items():
@@ -1290,12 +1307,13 @@ def _get_raw_schedule_paramset(schedule_data: _SCHEDULE_DICT) -> _RAW_SCHEDULE_D
                         raise ValidationException(f"Not a valid profile name: {raw_profile_name}")
                     raw_value: float | int = cast(float | int, slot_value)
                     if slot_type == ScheduleSlotType.ENDTIME and isinstance(slot_value, str):
-                        raw_value = _convert_time_str_to_minutes(slot_value)
+                        raw_value = _convert_time_str_to_minutes(time_str=slot_value)
                     raw_paramset[raw_profile_name] = raw_value
     return raw_paramset
 
 
 def _add_to_schedule_data(
+    *,
     schedule_data: _SCHEDULE_DICT,
     profile: ScheduleProfile,
     weekday: ScheduleWeekday,
@@ -1317,6 +1335,7 @@ def _add_to_schedule_data(
 
 
 def make_simple_thermostat(
+    *,
     channel: hmd.Channel,
     custom_config: CustomConfig,
 ) -> None:
@@ -1330,6 +1349,7 @@ def make_simple_thermostat(
 
 
 def make_thermostat(
+    *,
     channel: hmd.Channel,
     custom_config: CustomConfig,
 ) -> None:
@@ -1343,6 +1363,7 @@ def make_thermostat(
 
 
 def make_thermostat_group(
+    *,
     channel: hmd.Channel,
     custom_config: CustomConfig,
 ) -> None:
@@ -1356,6 +1377,7 @@ def make_thermostat_group(
 
 
 def make_ip_thermostat(
+    *,
     channel: hmd.Channel,
     custom_config: CustomConfig,
 ) -> None:
@@ -1369,6 +1391,7 @@ def make_ip_thermostat(
 
 
 def make_ip_thermostat_group(
+    *,
     channel: hmd.Channel,
     custom_config: CustomConfig,
 ) -> None: