PyPlumIO 0.5.40__tar.gz → 0.5.41__tar.gz

{pyplumio-0.5.40 → pyplumio-0.5.41}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyPlumIO
-Version: 0.5.40
+Version: 0.5.41
 Summary: PyPlumIO is a native ecoNET library for Plum ecoMAX controllers.
 Author-email: Denis Paavilainen <denpa@denpa.pro>
 License: MIT License

{pyplumio-0.5.40 → pyplumio-0.5.41}/PyPlumIO.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyPlumIO
-Version: 0.5.40
+Version: 0.5.41
 Summary: PyPlumIO is a native ecoNET library for Plum ecoMAX controllers.
 Author-email: Denis Paavilainen <denpa@denpa.pro>
 License: MIT License

{pyplumio-0.5.40 → pyplumio-0.5.41}/pyplumio/_version.py

@@ -17,5 +17,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '0.5.40'
-__version_tuple__ = version_tuple = (0, 5, 40)
+__version__ = version = '0.5.41'
+__version_tuple__ = version_tuple = (0, 5, 41)

{pyplumio-0.5.40 → pyplumio-0.5.41}/pyplumio/helpers/parameter.py

@@ -47,17 +47,6 @@ def is_valid_parameter(data: bytearray) -> bool:
     return any(x for x in data if x != BYTE_UNDEFINED)
 
 
-def parameter_value_to_int(value: NumericType | State | bool) -> int:
-    """Convert a parameter value to an integer.
-
-    If the value is STATE_OFF or STATE_ON, it returns 0 or 1 respectively.
-    """
-    if value in get_args(State):
-        return 1 if value == STATE_ON else 0
-
-    return int(value)
-
-
 @dataclass
 class ParameterValues:
     """Represents a parameter values."""
@@ -125,7 +114,7 @@ class Parameter(ABC):
 
         if isinstance(other, (int, float, bool)) or other in get_args(State):
             handler = getattr(self.values.value, method_to_call)
-            return handler(parameter_value_to_int(other))
+            return handler(self._pack_value(other))
         else:
             return NotImplemented
 
@@ -180,25 +169,16 @@ class Parameter(ABC):
         )
         return type(self)(self.device, self.description, values)
 
-    def validate(self, value: NumericType | State | bool) -> int:
-        """Validate a parameter value."""
-        int_value = parameter_value_to_int(value)
-        if int_value < self.values.min_value or int_value > self.values.max_value:
-            raise ValueError(
-                f"Invalid value: {value}. Must be between "
-                f"{self.min_value} and {self.max_value}."
-            )
-
-        return int_value
-
     async def set(self, value: Any, retries: int = 5, timeout: float = 5.0) -> bool:
         """Set a parameter value."""
-        return await self._attempt_update(self.validate(value), retries, timeout)
+        self.validate(value)
+        return await self._attempt_update(self._pack_value(value), retries, timeout)
 
     def set_nowait(self, value: Any, retries: int = 5, timeout: float = 5.0) -> None:
         """Set a parameter value without waiting."""
+        self.validate(value)
         self.device.create_task(
-            self._attempt_update(self.validate(value), retries, timeout)
+            self._attempt_update(self._pack_value(value), retries, timeout)
         )
 
     async def _attempt_update(
@@ -269,6 +249,18 @@ class Parameter(ABC):
 
         return parameter
 
+    @abstractmethod
+    def _pack_value(self, value: Any) -> int:
+        """Pack the parameter value."""
+
+    @abstractmethod
+    def _unpack_value(self, value: int) -> Any:
+        """Unpack the parameter value."""
+
+    @abstractmethod
+    def validate(self, value: Any) -> bool:
+        """Validate a parameter value."""
+
     @property
     @abstractmethod
     def value(self) -> NumericType | State | bool:
@@ -304,6 +296,24 @@ class Number(Parameter):
 
     description: NumberDescription
 
+    def _pack_value(self, value: NumericType) -> int:
+        """Pack the parameter value."""
+        return int(value)
+
+    def _unpack_value(self, value: int) -> NumericType:
+        """Unpack the parameter value."""
+        return value
+
+    def validate(self, value: Any) -> bool:
+        """Validate a parameter value."""
+        if value < self.min_value or value > self.max_value:
+            raise ValueError(
+                f"Invalid number value: {value}. Must be between "
+                f"{self.min_value} and {self.max_value}."
+            )
+
+        return True
+
     async def set(
         self, value: NumericType, retries: int = 5, timeout: float = 5.0
     ) -> bool:
@@ -323,17 +333,17 @@ class Number(Parameter):
     @property
     def value(self) -> NumericType:
         """Return the value."""
-        return self.values.value
+        return self._unpack_value(self.values.value)
 
     @property
     def min_value(self) -> NumericType:
         """Return the minimum allowed value."""
-        return self.values.min_value
+        return self._unpack_value(self.values.min_value)
 
     @property
     def max_value(self) -> NumericType:
         """Return the maximum allowed value."""
-        return self.values.max_value
+        return self._unpack_value(self.values.max_value)
 
     @property
     def unit_of_measurement(self) -> UnitOfMeasurement | Literal["%"] | None:
@@ -354,6 +364,24 @@ class Switch(Parameter):
 
     description: SwitchDescription
 
+    def _pack_value(self, value: State | bool) -> int:
+        """Pack the parameter value."""
+        if value in get_args(State):
+            return 1 if value == STATE_ON else 0
+
+        return int(value)
+
+    def _unpack_value(self, value: int) -> State:
+        """Unpack the parameter value."""
+        return STATE_ON if value == 1 else STATE_OFF
+
+    def validate(self, value: Any) -> bool:
+        """Validate a parameter value."""
+        if not isinstance(value, bool) and value not in get_args(State):
+            raise ValueError(f"Invalid switch value: {value}. Must be 'on' or 'off'.")
+
+        return True
+
     async def set(
         self, value: State | bool, retries: int = 5, timeout: float = 5.0
     ) -> bool:
@@ -399,7 +427,7 @@ class Switch(Parameter):
     @property
     def value(self) -> State:
         """Return the value."""
-        return STATE_ON if self.values.value == 1 else STATE_OFF
+        return self._unpack_value(self.values.value)
 
     @property
     def min_value(self) -> Literal["off"]:

{pyplumio-0.5.40 → pyplumio-0.5.41}/pyplumio/structures/ecomax_parameters.py

@@ -23,6 +23,7 @@ from pyplumio.frames import Request
 from pyplumio.helpers.parameter import (
     Number,
     NumberDescription,
+    NumericType,
     Parameter,
     ParameterDescription,
     ParameterValues,
@@ -32,7 +33,7 @@ from pyplumio.helpers.parameter import (
 )
 from pyplumio.structures import StructureDecoder
 from pyplumio.structures.thermostat_parameters import ATTR_THERMOSTAT_PROFILE
-from pyplumio.utils import ensure_dict
+from pyplumio.utils import ensure_dict, is_divisible
 
 if TYPE_CHECKING:
     from pyplumio.devices.ecomax import EcoMAX
@@ -89,7 +90,7 @@ class EcomaxParameter(Parameter):
 class EcomaxNumberDescription(EcomaxParameterDescription, NumberDescription):
     """Represents an ecoMAX number description."""
 
-    multiplier: float = 1.0
+    step: float = 1.0
     offset: int = 0
     precision: int = 6
 
@@ -101,31 +102,25 @@ class EcomaxNumber(EcomaxParameter, Number):
 
     description: EcomaxNumberDescription
 
-    async def set(
-        self, value: float | int, retries: int = 5, timeout: float = 5.0
-    ) -> bool:
-        """Set a parameter value."""
-        value += self.description.offset
-        value = round(value / self.description.multiplier, self.description.precision)
-        return await super().set(value, retries, timeout)
+    def validate(self, value: NumericType) -> bool:
+        """Validate the parameter value."""
+        if not is_divisible(value, self.description.step, self.description.precision):
+            raise ValueError(
+                f"Invalid value: {value}. The value must be adjusted in increments of "
+                f"{self.description.step}."
+            )
 
-    @property
-    def value(self) -> float:
-        """Return the value."""
-        value = self.values.value - self.description.offset
-        return round(value * self.description.multiplier, self.description.precision)
+        return super().validate(value)
 
-    @property
-    def min_value(self) -> float:
-        """Return the minimum allowed value."""
-        value = self.values.min_value - self.description.offset
-        return round(value * self.description.multiplier, self.description.precision)
+    def _pack_value(self, value: NumericType) -> int:
+        """Pack the parameter value."""
+        value += self.description.offset
+        return round(value / self.description.step)
 
-    @property
-    def max_value(self) -> float:
-        """Return the maximum allowed value."""
-        value = self.values.max_value - self.description.offset
-        return round(value * self.description.multiplier, self.description.precision)
+    def _unpack_value(self, value: int) -> NumericType:
+        """Unpack the parameter value."""
+        value -= self.description.offset
+        return round(value * self.description.step, self.description.precision)
 
 
 @dataslots
@@ -468,8 +463,8 @@ ECOMAX_PARAMETERS: dict[ProductType, tuple[EcomaxParameterDescription, ...]] = {
         ),
         EcomaxNumberDescription(
             name="max_fuel_flow",
-            multiplier=20,
-            unit_of_measurement=UnitOfMeasurement.GRAMS,
+            step=0.2,
+            unit_of_measurement=UnitOfMeasurement.KILOGRAMS_PER_HOUR,
         ),
         EcomaxNumberDescription(
             name="feeder_calibration",
@@ -479,7 +474,7 @@ ECOMAX_PARAMETERS: dict[ProductType, tuple[EcomaxParameterDescription, ...]] = {
         ),
         EcomaxNumberDescription(
             name="fuel_calorific_value",
-            multiplier=0.1,
+            step=0.1,
             unit_of_measurement=UnitOfMeasurement.KILO_WATT_HOUR_PER_KILOGRAM,
         ),
         EcomaxNumberDescription(
@@ -546,7 +541,7 @@ ECOMAX_PARAMETERS: dict[ProductType, tuple[EcomaxParameterDescription, ...]] = {
         ),
         EcomaxNumberDescription(
             name="heating_curve",
-            multiplier=0.1,
+            step=0.1,
         ),
         EcomaxNumberDescription(
             name="heating_curve_shift",
@@ -703,12 +698,12 @@ ECOMAX_PARAMETERS: dict[ProductType, tuple[EcomaxParameterDescription, ...]] = {
         ),
         EcomaxNumberDescription(
             name="solar_pump_on_delta_temp",
-            multiplier=0.1,
+            step=0.1,
             unit_of_measurement=UnitOfMeasurement.CELSIUS,
         ),
         EcomaxNumberDescription(
             name="solar_pump_off_delta_temp",
-            multiplier=0.1,
+            step=0.1,
             unit_of_measurement=UnitOfMeasurement.CELSIUS,
         ),
         EcomaxNumberDescription(
@@ -801,7 +796,7 @@ ECOMAX_PARAMETERS: dict[ProductType, tuple[EcomaxParameterDescription, ...]] = {
         ),
         EcomaxNumberDescription(
             name="thermostat_hysteresis",
-            multiplier=0.1,
+            step=0.1,
             unit_of_measurement=UnitOfMeasurement.CELSIUS,
         ),
         EcomaxNumberDescription(

{pyplumio-0.5.40 → pyplumio-0.5.41}/pyplumio/structures/mixer_parameters.py

@@ -20,6 +20,7 @@ from pyplumio.frames import Request
 from pyplumio.helpers.parameter import (
     Number,
     NumberDescription,
+    NumericType,
     Parameter,
     ParameterDescription,
     ParameterValues,
@@ -28,7 +29,7 @@ from pyplumio.helpers.parameter import (
     unpack_parameter,
 )
 from pyplumio.structures import StructureDecoder
-from pyplumio.utils import ensure_dict
+from pyplumio.utils import ensure_dict, is_divisible
 
 if TYPE_CHECKING:
     from pyplumio.devices.mixer import Mixer
@@ -71,7 +72,7 @@ class MixerParameter(Parameter):
 class MixerNumberDescription(MixerParameterDescription, NumberDescription):
     """Represent a mixer number description."""
 
-    multiplier: float = 1.0
+    step: float = 1.0
     offset: int = 0
     precision: int = 6
 
@@ -83,31 +84,25 @@ class MixerNumber(MixerParameter, Number):
 
     description: MixerNumberDescription
 
-    async def set(
-        self, value: int | float, retries: int = 5, timeout: float = 5.0
-    ) -> bool:
-        """Set a parameter value."""
-        value += self.description.offset
-        value = round(value / self.description.multiplier, self.description.precision)
-        return await super().set(value, retries, timeout)
+    def validate(self, value: NumericType) -> bool:
+        """Validate the parameter value."""
+        if not is_divisible(value, self.description.step, self.description.precision):
+            raise ValueError(
+                f"Invalid value: {value}. The value must be adjusted in increments of "
+                f"{self.description.step}."
+            )
 
-    @property
-    def value(self) -> float:
-        """Return the parameter value."""
-        value = self.values.value - self.description.offset
-        return round(value * self.description.multiplier, self.description.precision)
+        return super().validate(value)
 
-    @property
-    def min_value(self) -> float:
-        """Return the minimum allowed value."""
-        value = self.values.min_value - self.description.offset
-        return round(value * self.description.multiplier, self.description.precision)
+    def _pack_value(self, value: NumericType) -> int:
+        """Pack the parameter value."""
+        value += self.description.offset
+        return round(value / self.description.step)
 
-    @property
-    def max_value(self) -> float:
-        """Return the maximum allowed value."""
-        value = self.values.max_value - self.description.offset
-        return round(value * self.description.multiplier, self.description.precision)
+    def _unpack_value(self, value: int) -> NumericType:
+        """Unpack the parameter value."""
+        value -= self.description.offset
+        return round(value * self.description.step, self.description.precision)
 
 
 @dataslots
@@ -147,7 +142,7 @@ MIXER_PARAMETERS: dict[ProductType, tuple[MixerParameterDescription, ...]] = {
         ),
         MixerNumberDescription(
             name="heating_curve",
-            multiplier=0.1,
+            step=0.1,
         ),
         MixerNumberDescription(
             name="heating_curve_shift",
@@ -162,7 +157,7 @@ MIXER_PARAMETERS: dict[ProductType, tuple[MixerParameterDescription, ...]] = {
         ),
         MixerNumberDescription(
             name="mixer_input_dead_zone",
-            multiplier=0.1,
+            step=0.1,
             unit_of_measurement=UnitOfMeasurement.CELSIUS,
         ),
         MixerSwitchDescription(
@@ -232,7 +227,7 @@ MIXER_PARAMETERS: dict[ProductType, tuple[MixerParameterDescription, ...]] = {
         ),
         MixerNumberDescription(
             name="mixer_input_dead_zone",
-            multiplier=0.1,
+            step=0.1,
             unit_of_measurement=UnitOfMeasurement.CELSIUS,
         ),
         MixerNumberDescription(
@@ -243,7 +238,7 @@ MIXER_PARAMETERS: dict[ProductType, tuple[MixerParameterDescription, ...]] = {
         ),
         MixerNumberDescription(
             name="heating_curve",
-            multiplier=0.1,
+            step=0.1,
         ),
         MixerNumberDescription(
             name="heating_curve_shift",

{pyplumio-0.5.40 → pyplumio-0.5.41}/pyplumio/structures/thermostat_parameters.py

@@ -20,6 +20,7 @@ from pyplumio.frames import Request
 from pyplumio.helpers.parameter import (
     Number,
     NumberDescription,
+    NumericType,
     Parameter,
     ParameterDescription,
     ParameterValues,
@@ -29,7 +30,7 @@ from pyplumio.helpers.parameter import (
 )
 from pyplumio.structures import StructureDecoder
 from pyplumio.structures.thermostat_sensors import ATTR_THERMOSTATS_AVAILABLE
-from pyplumio.utils import ensure_dict
+from pyplumio.utils import ensure_dict, is_divisible
 
 if TYPE_CHECKING:
     from pyplumio.devices.thermostat import Thermostat
@@ -92,7 +93,7 @@ class ThermostatParameter(Parameter):
 class ThermostatNumberDescription(ThermostatParameterDescription, NumberDescription):
     """Represent a thermostat number description."""
 
-    multiplier: float = 1.0
+    step: float = 1.0
     precision: int = 6
 
 
@@ -103,30 +104,23 @@ class ThermostatNumber(ThermostatParameter, Number):
 
     description: ThermostatNumberDescription
 
-    async def set(
-        self, value: int | float, retries: int = 5, timeout: float = 5.0
-    ) -> bool:
-        """Set a parameter value."""
-        value = round(value / self.description.multiplier, self.description.precision)
-        return await super().set(value, retries, timeout)
+    def validate(self, value: NumericType) -> bool:
+        """Validate the parameter value."""
+        if not is_divisible(value, self.description.step, self.description.precision):
+            raise ValueError(
+                f"Invalid value: {value}. The value must be adjusted in increments of "
+                f"{self.description.step}."
+            )
 
-    @property
-    def value(self) -> float:
-        """Return the value."""
-        value = self.values.value * self.description.multiplier
-        return round(value, self.description.precision)
+        return super().validate(value)
 
-    @property
-    def min_value(self) -> float:
-        """Return the minimum allowed value."""
-        value = self.values.min_value * self.description.multiplier
-        return round(value, self.description.precision)
+    def _pack_value(self, value: NumericType) -> int:
+        """Pack the parameter value."""
+        return round(value / self.description.step)
 
-    @property
-    def max_value(self) -> float:
-        """Return the maximum allowed value."""
-        value = self.values.max_value * self.description.multiplier
-        return round(value, self.description.precision)
+    def _unpack_value(self, value: int) -> NumericType:
+        """Unpack the parameter value."""
+        return round(value * self.description.step, self.description.precision)
 
 
 @dataslots
@@ -150,13 +144,13 @@ THERMOSTAT_PARAMETERS: tuple[ThermostatParameterDescription, ...] = (
     ThermostatNumberDescription(
         name="party_target_temp",
         size=2,
-        multiplier=0.1,
+        step=0.1,
         unit_of_measurement=UnitOfMeasurement.CELSIUS,
     ),
     ThermostatNumberDescription(
         name="holidays_target_temp",
         size=2,
-        multiplier=0.1,
+        step=0.1,
         unit_of_measurement=UnitOfMeasurement.CELSIUS,
     ),
     ThermostatNumberDescription(
@@ -181,31 +175,31 @@ THERMOSTAT_PARAMETERS: tuple[ThermostatParameterDescription, ...] = (
     ),
     ThermostatNumberDescription(
         name="hysteresis",
-        multiplier=0.1,
+        step=0.1,
         unit_of_measurement=UnitOfMeasurement.CELSIUS,
     ),
     ThermostatNumberDescription(
         name="day_target_temp",
         size=2,
-        multiplier=0.1,
+        step=0.1,
         unit_of_measurement=UnitOfMeasurement.CELSIUS,
     ),
     ThermostatNumberDescription(
         name="night_target_temp",
         size=2,
-        multiplier=0.1,
+        step=0.1,
         unit_of_measurement=UnitOfMeasurement.CELSIUS,
     ),
     ThermostatNumberDescription(
         name="antifreeze_target_temp",
         size=2,
-        multiplier=0.1,
+        step=0.1,
         unit_of_measurement=UnitOfMeasurement.CELSIUS,
     ),
     ThermostatNumberDescription(
         name="heating_target_temp",
         size=2,
-        multiplier=0.1,
+        step=0.1,
         unit_of_measurement=UnitOfMeasurement.CELSIUS,
     ),
     ThermostatNumberDescription(

{pyplumio-0.5.40 → pyplumio-0.5.41}/pyplumio/utils.py

@@ -28,3 +28,14 @@ def ensure_dict(initial: dict[KT, VT] | None, *args: dict[KT, VT]) -> dict[KT, V
         data |= extra
 
     return data
+
+
+def is_divisible(a: float, b: float, precision: int = 6) -> bool:
+    """Check if a is divisible by b."""
+    scale: int = 10**precision
+    b_scaled = round(b * scale)
+    if b_scaled == 0:
+        raise ValueError("Division by zero is not allowed.")
+
+    a_scaled = round(a * scale)
+    return a_scaled % b_scaled == 0

{pyplumio-0.5.40 → pyplumio-0.5.41}/tests/test_devices.py

@@ -241,19 +241,19 @@ async def test_ecomax_parameters_callbacks(ecomax: EcoMAX) -> None:
     await ecomax.wait_until_done()
     assert await ecomax.get("fuzzy_logic") is fuzzy_logic
 
-    # Test parameter with the multiplier (heating_heat_curve)
+    # Test parameter with the step (heating_heat_curve)
     fuel_calorific_value = await ecomax.get("fuel_calorific_value")
     assert fuel_calorific_value.value == 4.6
     assert fuel_calorific_value.min_value == 0.1
     assert fuel_calorific_value.max_value == 25.0
 
-    # Test setting parameter with the multiplier.
-    with patch(
-        "pyplumio.structures.ecomax_parameters.Parameter.set", new_callable=AsyncMock
-    ) as mock_set:
+    # Test setting parameter with the step.
+    with patch("asyncio.Queue.put", new_callable=AsyncMock) as mock_put:
         await fuel_calorific_value.set(2.5)
 
-    mock_set.assert_awaited_once_with(25, 5, 5.0)
+    request = mock_put.call_args[0][0]
+    assert isinstance(request, SetEcomaxParameterRequest)
+    assert request.data[ATTR_VALUE] == 25
 
     # Test parameter with the offset (heating_heat_curve_shift)
     heating_heat_curve_shift = await ecomax.get("heating_curve_shift")
@@ -264,12 +264,12 @@ async def test_ecomax_parameters_callbacks(ecomax: EcoMAX) -> None:
     assert heating_heat_curve_shift.unit_of_measurement == UnitOfMeasurement.CELSIUS
 
     # Test setting the parameter with the offset.
-    with patch(
-        "pyplumio.structures.ecomax_parameters.Parameter.set", new_callable=AsyncMock
-    ) as mock_set:
+    with patch("asyncio.Queue.put", new_callable=AsyncMock) as mock_put:
         await heating_heat_curve_shift.set(1)
 
-    mock_set.assert_awaited_once_with(21, 5, 5.0)
+    request = mock_put.call_args[0][0]
+    assert isinstance(request, SetEcomaxParameterRequest)
+    assert request.data[ATTR_VALUE] == 21
 
 
 async def test_unknown_ecomax_parameter(ecomax: EcoMAX, caplog) -> None:
@@ -629,9 +629,13 @@ async def test_set(ecomax: EcoMAX) -> None:
     await ecomax.wait_until_done()
 
     # Test setting an ecomax parameter.
-    assert await ecomax.set("max_fuel_flow", 2600)
+    assert await ecomax.set("max_fuel_flow", 26.0)
     max_fuel_flow = await ecomax.get("max_fuel_flow")
-    assert max_fuel_flow.value == 2600
+    assert max_fuel_flow.value == 26.0
+
+    # Test setting an ecomax parameter with invalid step.
+    with pytest.raises(ValueError):
+        await ecomax.set("max_fuel_flow", 26.1)
 
     # Test setting an ecomax parameter without blocking.
     with (
@@ -646,16 +650,24 @@ async def test_set(ecomax: EcoMAX) -> None:
 
     # Test setting a thermostat parameter.
     thermostat = ecomax.data[ATTR_THERMOSTATS][0]
-    assert await thermostat.set("party_target_temp", 21.0)
+    assert await thermostat.set("party_target_temp", 21)
     target_party_temp = await thermostat.get("party_target_temp")
     assert target_party_temp.value == 21.0
 
+    # Test setting a thermostat parameter with invalid step.
+    with pytest.raises(ValueError):
+        await thermostat.set("party_target_temp", 26.01)
+
     # Test setting a mixer parameter.
     mixer = ecomax.data[ATTR_MIXERS][0]
     assert await mixer.set("mixer_target_temp", 35.0)
     mixer_target_temp = await mixer.get("mixer_target_temp")
     assert mixer_target_temp.value == 35.0
 
+    # Test setting a mixer parameter with invalid step.
+    with pytest.raises(ValueError):
+        await mixer.set("mixer_target_temp", 35.01)
+
     # Test with invalid parameter.
     ecomax.data["bar"] = Mock()
     with pytest.raises(TypeError):

{pyplumio-0.5.40 → pyplumio-0.5.41}/tests/test_utils.py

@@ -1,5 +1,7 @@
 """Contains tests for the utility functions."""
 
+import pytest
+
 from pyplumio import utils
 
 
@@ -20,3 +22,13 @@ def test_ensure_dict() -> None:
         "foo": "bar",
         "baz": "foobar",
     }
+
+
+def test_is_divisible() -> None:
+    """Test divisibility check."""
+    assert utils.is_divisible(10.0, 0.2)
+    assert utils.is_divisible(0.0, 1.0)
+    assert not utils.is_divisible(10.0, 3.0)
+
+    with pytest.raises(ValueError, match="Division by zero is not allowed."):
+        utils.is_divisible(10.0, 0.0)