PyPlumIO 0.5.21__py3-none-any.whl → 0.5.23__py3-none-any.whl

pyplumio/structures/thermostat_parameters.py

@@ -6,6 +6,8 @@ from collections.abc import Generator
 from dataclasses import dataclass
 from typing import TYPE_CHECKING, Any, Final
 
+from dataslots import dataslots
+
 from pyplumio.const import (
     ATTR_INDEX,
     ATTR_OFFSET,
@@ -16,14 +18,16 @@ from pyplumio.const import (
 )
 from pyplumio.frames import Request
 from pyplumio.helpers.parameter import (
-    BinaryParameter,
-    BinaryParameterDescription,
+    SET_TIMEOUT,
+    Number,
+    NumberDescription,
     Parameter,
     ParameterDescription,
     ParameterValues,
+    Switch,
+    SwitchDescription,
     unpack_parameter,
 )
-from pyplumio.helpers.typing import ParameterValueType
 from pyplumio.structures import StructureDecoder
 from pyplumio.structures.thermostat_sensors import ATTR_THERMOSTATS_AVAILABLE
 from pyplumio.utils import ensure_dict
@@ -38,6 +42,16 @@ ATTR_THERMOSTAT_PARAMETERS: Final = "thermostat_parameters"
 THERMOSTAT_PARAMETER_SIZE: Final = 3
 
 
+@dataclass
+class ThermostatParameterDescription(ParameterDescription):
+    """Represents a thermostat parameter description."""
+
+    __slots__ = ()
+
+    multiplier: float = 1.0
+    size: int = 1
+
+
 class ThermostatParameter(Parameter):
     """Represents a thermostat parameter."""
 
@@ -50,14 +64,14 @@ class ThermostatParameter(Parameter):
     def __init__(
         self,
         device: Thermostat,
-        values: ParameterValues,
-        description: ParameterDescription,
+        description: ThermostatParameterDescription,
+        values: ParameterValues | None = None,
         index: int = 0,
         offset: int = 0,
     ):
         """Initialize a new thermostat parameter."""
         self.offset = offset
-        super().__init__(device, values, description, index)
+        super().__init__(device, description, values, index)
 
     async def create_request(self) -> Request:
         """Create a request to change the parameter."""
@@ -74,108 +88,126 @@ class ThermostatParameter(Parameter):
             },
         )
 
-    async def set(self, value: ParameterValueType, retries: int = 5) -> bool:
-        """Set a parameter value."""
-        if isinstance(value, (int, float)):
-            value = int(value / self.description.multiplier)
 
+@dataslots
+@dataclass
+class ThermostatNumberDescription(ThermostatParameterDescription, NumberDescription):
+    """Represent a thermostat number description."""
+
+
+class ThermostatNumber(ThermostatParameter, Number):
+    """Represents a thermostat number."""
+
+    __slots__ = ()
+
+    description: ThermostatNumberDescription
+
+    async def set(self, value: int | float, retries: int = SET_TIMEOUT) -> bool:
+        """Set a parameter value."""
+        value = value / self.description.multiplier
         return await super().set(value, retries)
 
     @property
-    def value(self) -> ParameterValueType:
-        """Return the parameter value."""
+    def value(self) -> float:
+        """Return the value."""
         return self.values.value * self.description.multiplier
 
     @property
-    def min_value(self) -> ParameterValueType:
+    def min_value(self) -> float:
         """Return the minimum allowed value."""
         return self.values.min_value * self.description.multiplier
 
     @property
-    def max_value(self) -> ParameterValueType:
+    def max_value(self) -> float:
         """Return the maximum allowed value."""
         return self.values.max_value * self.description.multiplier
 
 
-class ThermostatBinaryParameter(BinaryParameter, ThermostatParameter):
-    """Represents a thermostat binary parameter."""
-
-    __slots__ = ()
-
-
+@dataslots
 @dataclass
-class ThermostatParameterDescription(ParameterDescription):
-    """Represents a thermostat parameter description."""
+class ThermostatSwitchDescription(ThermostatParameterDescription, SwitchDescription):
+    """Represents a thermostat switch description."""
 
-    multiplier: float = 1.0
-    size: int = 1
 
+class ThermostatSwitch(ThermostatParameter, Switch):
+    """Represents a thermostat switch."""
 
-@dataclass
-class ThermostatBinaryParameterDescription(
-    ThermostatParameterDescription, BinaryParameterDescription
-):
-    """Represents a thermostat binary parameter description."""
+    __slots__ = ()
+
+    description: ThermostatSwitchDescription
 
 
 THERMOSTAT_PARAMETERS: tuple[ThermostatParameterDescription, ...] = (
-    ThermostatParameterDescription(name="mode"),
-    ThermostatParameterDescription(
+    ThermostatNumberDescription(
+        name="mode",
+    ),
+    ThermostatNumberDescription(
         name="party_target_temp",
         size=2,
         multiplier=0.1,
         unit_of_measurement=UnitOfMeasurement.CELSIUS,
     ),
-    ThermostatParameterDescription(
+    ThermostatNumberDescription(
         name="holidays_target_temp",
         size=2,
         multiplier=0.1,
         unit_of_measurement=UnitOfMeasurement.CELSIUS,
     ),
-    ThermostatParameterDescription(
-        name="correction", unit_of_measurement=UnitOfMeasurement.CELSIUS
+    ThermostatNumberDescription(
+        name="correction",
+        unit_of_measurement=UnitOfMeasurement.CELSIUS,
     ),
-    ThermostatParameterDescription(
-        name="away_timer", unit_of_measurement=UnitOfMeasurement.DAYS
+    ThermostatNumberDescription(
+        name="away_timer",
+        unit_of_measurement=UnitOfMeasurement.DAYS,
     ),
-    ThermostatParameterDescription(
-        name="airing_timer", unit_of_measurement=UnitOfMeasurement.DAYS
+    ThermostatNumberDescription(
+        name="airing_timer",
+        unit_of_measurement=UnitOfMeasurement.DAYS,
     ),
-    ThermostatParameterDescription(
-        name="party_timer", unit_of_measurement=UnitOfMeasurement.DAYS
+    ThermostatNumberDescription(
+        name="party_timer",
+        unit_of_measurement=UnitOfMeasurement.DAYS,
     ),
-    ThermostatParameterDescription(
-        name="holidays_timer", unit_of_measurement=UnitOfMeasurement.DAYS
+    ThermostatNumberDescription(
+        name="holidays_timer",
+        unit_of_measurement=UnitOfMeasurement.DAYS,
     ),
-    ThermostatParameterDescription(
-        name="hysteresis", multiplier=0.1, unit_of_measurement=UnitOfMeasurement.CELSIUS
+    ThermostatNumberDescription(
+        name="hysteresis",
+        multiplier=0.1,
+        unit_of_measurement=UnitOfMeasurement.CELSIUS,
     ),
-    ThermostatParameterDescription(
+    ThermostatNumberDescription(
         name="day_target_temp",
         size=2,
         multiplier=0.1,
         unit_of_measurement=UnitOfMeasurement.CELSIUS,
     ),
-    ThermostatParameterDescription(
+    ThermostatNumberDescription(
         name="night_target_temp",
         size=2,
         multiplier=0.1,
         unit_of_measurement=UnitOfMeasurement.CELSIUS,
     ),
-    ThermostatParameterDescription(
+    ThermostatNumberDescription(
         name="antifreeze_target_temp",
         size=2,
         multiplier=0.1,
         unit_of_measurement=UnitOfMeasurement.CELSIUS,
     ),
-    ThermostatParameterDescription(
+    ThermostatNumberDescription(
         name="heating_target_temp",
         size=2,
         multiplier=0.1,
         unit_of_measurement=UnitOfMeasurement.CELSIUS,
     ),
-    ThermostatParameterDescription(name="heating_timer"),
-    ThermostatParameterDescription(name="off_timer"),
+    ThermostatNumberDescription(
+        name="heating_timer",
+    ),
+    ThermostatNumberDescription(
+        name="off_timer",
+    ),
 )
 
 

pyplumio/utils.py

@@ -2,12 +2,13 @@
 
 from __future__ import annotations
 
-from typing import Any
+from collections.abc import Mapping
+from typing import TypeVar
 
 
-def to_camelcase(text: str, overrides: dict[str, str] | None = None) -> str:
+def to_camelcase(text: str, overrides: Mapping[str, str] | None = None) -> str:
     """Convert snake_case to CamelCase."""
-    if overrides is None:
+    if not overrides:
         return "".join((x.capitalize() or "_") for x in text.split("_"))
 
     return "".join(
@@ -16,10 +17,14 @@ def to_camelcase(text: str, overrides: dict[str, str] | None = None) -> str:
     )
 
 
-def ensure_dict(data: dict | None, *args: Any) -> dict:
+KT = TypeVar("KT")  # Key type.
+VT = TypeVar("VT")  # Value type.
+
+
+def ensure_dict(initial: dict[KT, VT] | None, *args: dict[KT, VT]) -> dict[KT, VT]:
     """Create or merge multiple dictionaries."""
-    data = data if data is not None else {}
-    for new_data in args:
-        data |= new_data
+    data = initial if initial is not None else {}
+    for extra in args:
+        data |= extra
 
     return data

PyPlumIO-0.5.21.dist-info/RECORD

@@ -1,61 +0,0 @@
-pyplumio/__init__.py,sha256=cclyAwy7OsW673iHcwkVrJSNnf32oF51Y_0uEEF5cdI,3293
-pyplumio/__main__.py,sha256=3IwHHSq-iay5FaeMc95klobe-xv82yydSKcBE7BFZ6M,500
-pyplumio/_version.py,sha256=qwvYpiZ4pV_W2HOchGsudGTbl7hCvV-xhS0ii39Ac0I,413
-pyplumio/connection.py,sha256=ZZHXHFpbOBVd9DGZV_H8lpdYtYoc3nP9fRolKATKDnQ,6096
-pyplumio/const.py,sha256=8rpiVbVb5R_6Rm6J2sgCnaVrkD-2Fzhd1RYMz0MBgwo,3915
-pyplumio/exceptions.py,sha256=193z3zfnswYhIYPzCIpxCiWat4qI3cV85sqT4YOSo-4,699
-pyplumio/filters.py,sha256=bIonYc_QbGMsL8aWweSLUmP7gKqDD646zELf_PqqQBg,11161
-pyplumio/protocol.py,sha256=Ci4p4bqADfWeGk9fzcGMudRbe-dFFa1UNot9no5Lj3M,7845
-pyplumio/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pyplumio/stream.py,sha256=DqMqdi3HG9hODgfGo4eTKLkfoaSh5RS4kBHNn3ODvVg,4472
-pyplumio/utils.py,sha256=GV7P1hPLoQsx3uqYviQ15FXJmkmTxwtDibAc-yRarvo,688
-pyplumio/devices/__init__.py,sha256=O5SyEt_x1nJ1JYkG6v3dTZ54tu9sKIdj4l256JhvLHg,6585
-pyplumio/devices/ecomax.py,sha256=IPHyC8OjnGaQ_ZztcchgQjEJmNj8LfnP9sTJyslEQ14,16914
-pyplumio/devices/ecoster.py,sha256=J4YtPmFmFwaq4LzYf28aMmB97cRAbMsVyUdBLGki42g,313
-pyplumio/devices/mixer.py,sha256=qJAmar7DdsQL1Syg0WOCBVQn3GyBTWEVyr5ZfpGytCk,2975
-pyplumio/devices/thermostat.py,sha256=HCnLVBX8mn6lmpCgl1DbDoCMI6T97sqmK-36cYcjXVA,2430
-pyplumio/frames/__init__.py,sha256=BAMbMHbn4F9psrf3sv0eJQA2Jd86qf7LQ5vBQY59gjA,7462
-pyplumio/frames/messages.py,sha256=QLuvo1wlpDZR1MpOdu7s6fRUX20Dtt6EWFLkAsqyax4,3617
-pyplumio/frames/requests.py,sha256=Ra8xH5oKYhkEUtadN-9ZsJKkt5xZkz5O7edQVsDhNsM,7221
-pyplumio/frames/responses.py,sha256=j4awA2-MfsoPdENC4Fvae4_Oa70rDhH19ebmEoAqhh8,6532
-pyplumio/helpers/__init__.py,sha256=H2xxdkF-9uADLwEbfBUoxNTdwru3L5Z2cfJjgsuRsn0,31
-pyplumio/helpers/data_types.py,sha256=H_pYkLgIu30lDFU0UUZ1V3vYxa9A_-1nhiJu-HCLuoc,8212
-pyplumio/helpers/event_manager.py,sha256=dCNLnSRZgewZ9Ppi-JtkxtvOmNd4ZejA7UT4oAT8FWM,5865
-pyplumio/helpers/factory.py,sha256=eiTkYUCernUn0VNDDdEN4IyjNPrXK8vnJESXyLaqFzE,1017
-pyplumio/helpers/parameter.py,sha256=gYCA2SLU_lbdtQZq5U64yzpyLoEIa0R1wyJJGmgL63I,8699
-pyplumio/helpers/schedule.py,sha256=-IZJ-CU4PhFlsE586wTw--ovDrTo2Hs4JneCHhc0e-Y,5013
-pyplumio/helpers/task_manager.py,sha256=y5j7u31V6UE7g2ZhdsYsPykY-Awo73oWsNRUOrLSILg,1075
-pyplumio/helpers/timeout.py,sha256=k-829fBcHT5IR3isrMSgNbPYK-ubeY1BAwndCDIiX9E,824
-pyplumio/helpers/typing.py,sha256=y55UdpIpPIRuUBPgfPmZHAwPdIUjQO924-kO7AVXhes,685
-pyplumio/helpers/uid.py,sha256=yaBjcsFKuhOaznftk33kdIepQHpK-labEQr59QNKhPM,975
-pyplumio/structures/__init__.py,sha256=EjK-5qJZ0F7lpP2b6epvTMg9cIBl4Kn91nqNkEcLwTc,1299
-pyplumio/structures/alerts.py,sha256=a1CIf8vSEj5aefdqECIfCY5kV4tQ4kabMkp-_ixeWic,3260
-pyplumio/structures/boiler_load.py,sha256=p3mOzZUU-g7A2tG_yp8podEqpI81hlsOZmHELyPNRY8,838
-pyplumio/structures/boiler_power.py,sha256=72qsvccg49FdRdXv2f2K5sGpjT7wAOLFjlIGWpO-DVg,901
-pyplumio/structures/ecomax_parameters.py,sha256=6HVEh4aNw0CGZD3CVQeYyKXQ0pzueQR_Tpm5fF3_0hA,25815
-pyplumio/structures/fan_power.py,sha256=Q5fv-7_2NVuLeQPIVIylvgN7M8-a9D8rRUE0QGjyS3w,871
-pyplumio/structures/frame_versions.py,sha256=x_OSirGYopQYgsRZIM3b1YlKHNIPmCbvAzhzO1wqy5k,1560
-pyplumio/structures/fuel_consumption.py,sha256=_p2dI4H67Eopn7IF0Gj77A8c_8lNKhhDDAtmugxLd4s,976
-pyplumio/structures/fuel_level.py,sha256=mJpp1dnRD1wXi_6EyNX7TNXosjcr905rSHOnuZ5VD74,1069
-pyplumio/structures/lambda_sensor.py,sha256=6iUVyrPe6_QaGPo1lRzOfqorcTIIXRwnq3h861IJYGs,1587
-pyplumio/structures/mixer_parameters.py,sha256=ny7Ox94IooQd1ua22zGYkXLFaZQWGUYLEIM2_8vXk0U,8249
-pyplumio/structures/mixer_sensors.py,sha256=O91929Ts1YXFmKdPRc1r_BYDgrqkv5QVtE1nGzLpuAI,2260
-pyplumio/structures/modules.py,sha256=ukju4TQmRRJfgl94QU4zytZLU5px8nw3sgfSLn9JysU,2520
-pyplumio/structures/network_info.py,sha256=ws2UdOhB89oKqmtW1Vsmfj0InRW4Sp6_kL1d4psk-8w,4094
-pyplumio/structures/output_flags.py,sha256=07N0kxlvR5WZAURuChk_BqSiXR8eaQrtI5qlkgCf4Yc,1345
-pyplumio/structures/outputs.py,sha256=1xsJPkjN643-aFawqVoupGatUIUJfQG_g252n051Qi0,1916
-pyplumio/structures/pending_alerts.py,sha256=Uq9WpB4MW9AhDkqmDhk-g0J0h4pVq0Q50z12dYEv6kY,739
-pyplumio/structures/product_info.py,sha256=bVH7NvIOWwmmHcgbLfD-IIag4sgBRA6RMmuC6SKTrJE,2409
-pyplumio/structures/program_version.py,sha256=4h3u46l2btUcooDRHyrqN3Y9M8WNEzwCmkNVEzfi-V8,2359
-pyplumio/structures/regulator_data.py,sha256=Dun3RjfHHoV2W5RTSQcAimBL0Or3O957vYQj7Pbi7CM,2309
-pyplumio/structures/regulator_data_schema.py,sha256=BMshEpiP-lwTgSkbTuow9KlxCwKwQXV0nFPcBpW0SJg,1505
-pyplumio/structures/schedules.py,sha256=-koo05nLkpKuj1ZPiC1NB_21MAFn1FzQ6VLC0DboYeg,6346
-pyplumio/structures/statuses.py,sha256=wkoynyMRr1VREwfBC6vU48kPA8ZQ83pcXuciy2xHJrk,1166
-pyplumio/structures/temperatures.py,sha256=1CDzehNmbALz1Jyt_9gZNIk52q6Wv-xQXjijVDCVYec,2337
-pyplumio/structures/thermostat_parameters.py,sha256=pjbWsT6z7mlDiUrC5MWGqMtGP0deeVMYeeTa7yGEwJ8,7706
-pyplumio/structures/thermostat_sensors.py,sha256=ZmjWgYtTZ5M8Lnz_Q5N4JD8G3MvEmByPFjYsy6XZOmo,3177
-PyPlumIO-0.5.21.dist-info/LICENSE,sha256=m-UuZFjXJ22uPTGm9kSHS8bqjsf5T8k2wL9bJn1Y04o,1088
-PyPlumIO-0.5.21.dist-info/METADATA,sha256=mc-yvbFJArE1iYRxb8RCkL2MdoKZjkZKOn8nWgWD8t8,5415
-PyPlumIO-0.5.21.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
-PyPlumIO-0.5.21.dist-info/top_level.txt,sha256=kNBz9UPPkPD9teDn3U_sEy5LjzwLm9KfADCXtBlbw8A,9
-PyPlumIO-0.5.21.dist-info/RECORD,,

pyplumio/helpers/typing.py

@@ -1,29 +0,0 @@
-"""Contains type aliases."""
-
-from __future__ import annotations
-
-from typing import Literal, Protocol, Union, runtime_checkable
-
-ParameterValueType = Union[int, float, bool, Literal["off"], Literal["on"]]
-
-
-@runtime_checkable
-class SupportsSubtraction(Protocol):
-    """Supports subtraction operation."""
-
-    __slots__ = ()
-
-    def __sub__(
-        self: SupportsSubtraction, other: SupportsSubtraction
-    ) -> SupportsSubtraction:
-        """Subtract a value."""
-
-
-@runtime_checkable
-class SupportsComparison(Protocol):
-    """Supports comparison."""
-
-    __slots__ = ()
-
-    def __eq__(self: SupportsComparison, other: SupportsComparison) -> bool:
-        """Compare a value."""