python-dali 0.15__py3-none-any.whl → 0.16__py3-none-any.whl

dali/driver/serial.py

@@ -1329,7 +1329,13 @@ class DriverLubaRs232(DriverSerialBase):
         self._transport: Optional[serialx.SerialTransport] = None
         self._protocol: Optional[DriverLubaRs232.LubaProtocol] = None
 
-    async def connect(self, *, scan_dev_inst: bool = False) -> None:
+    async def connect(
+        self, *, scan_dev_inst: bool = False, apply_settings: bool = True
+    ) -> None:
+        # ``apply_settings=False`` connects without writing the device settings,
+        # leaving the interface's hardware configuration (including its bus-power
+        # state) untouched. Use it to probe a discovered interface read-only so
+        # the probe cannot depower a bus the integrated supply is already driving.
         if self.is_connected:
             _LOG.warning(
                 f"'connect()' called but luba232 driver already connected"
@@ -1358,8 +1364,9 @@ class DriverLubaRs232(DriverSerialBase):
         for attempt in range(1, DriverLubaRs232.handshake_attempts + 1):
             try:
                 await self._protocol.send_device_info_query()
-                self._protocol.bus_power = self.bus_power
-                await self._protocol.send_device_settings()
+                if apply_settings:
+                    self._protocol.bus_power = self.bus_power
+                    await self._protocol.send_device_settings()
                 break
             except (asyncio.TimeoutError, TimeoutError):
                 if attempt >= DriverLubaRs232.handshake_attempts:
@@ -1378,8 +1385,9 @@ class DriverLubaRs232(DriverSerialBase):
 
         # After switching on the integrated power supply the bus voltage takes
         # a moment to rise; sending DALI frames before then fails, so wait for
-        # the bus to be powered before scanning.
-        if self.bus_power:
+        # the bus to be powered before scanning. Skipped when the settings were
+        # not applied, as the bus-power state was then left untouched.
+        if apply_settings and self.bus_power:
             await self._wait_for_bus_power()
 
         # Scan the bus for control devices, and create a mapping of addresses

dali/tests/test_serial_driver.py

@@ -94,6 +94,25 @@ async def test_connect_retries_handshake_on_timeout(monkeypatch):
     assert protocol.reset_luba_response.call_count == 2
 
 
+@pytest.mark.asyncio
+async def test_connect_without_applying_settings_leaves_hardware_untouched(
+    monkeypatch,
+):
+    """connect(apply_settings=False) must not write the device settings.
+
+    A read-only probe of a discovered interface must not overwrite the
+    hardware configuration, otherwise it could depower a bus the integrated
+    supply is already driving.
+    """
+    driver, protocol = _connecting_driver(monkeypatch, [None])
+
+    await driver.connect(apply_settings=False)
+
+    assert driver.is_connected
+    assert protocol.send_device_info_query.await_count == 1
+    assert protocol.send_device_settings.await_count == 0
+
+
 @pytest.mark.asyncio
 async def test_connect_raises_after_exhausting_handshake_attempts(monkeypatch):
     """When every handshake attempt times out, connect must give up and raise."""

{python_dali-0.15.dist-info → python_dali-0.16.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-dali
-Version: 0.15
+Version: 0.16
 Summary: Interface to DALI lighting systems
 Home-page: https://github.com/sde1000/python-dali
 Author: Stephen Early

{python_dali-0.15.dist-info → python_dali-0.16.dist-info}/RECORD

@@ -18,7 +18,7 @@ dali/driver/base.py,sha256=Jd_0PrkVg84CdkVLmGBr5IyK5Sm7N68tqNDdPFRB7-0,3891
 dali/driver/daliserver.py,sha256=YbaTv8glbsPWtXy-m-zakxsPwZBu5FsuXxtVPfE1n78,3120
 dali/driver/hasseb.py,sha256=dQDrkxdpXlXlxmoShsoYOpvXpGzSLqZ8eqG-HMKIGOI,9376
 dali/driver/hid.py,sha256=CyBkCZeyDFumzvfTUeTB3xIjALZkg6dugd3G4DYIeig,33591
-dali/driver/serial.py,sha256=XPMytdl7bijJBFDx2d3q94AFcZUdH6m0z0dOvkLvdI0,82350
+dali/driver/serial.py,sha256=qk58G_6nEONZqS2MRX_A0XmhwBxyy8W4tE_E4z05tCw,82883
 dali/driver/trace_logging.py,sha256=qfkEdgVQsu-dXYKsmPXb6j7VRC6O1JJovuU8ca-KEMs,2366
 dali/driver/tridonic.py,sha256=H-j0u-7oP36uKxm-KdCO35AFuoyVzKu_jQs31jeDW6Y,10889
 dali/driver/unipi.py,sha256=arQ-o8zI-PtyvnyRa6f6kPKYswFtFvvdoKfCNRxTAiY,7399
@@ -54,11 +54,11 @@ dali/tests/test_frame.py,sha256=qd9LzN5ie9zFMTeqzTW5CIsLeuR4n0U4ZqybuG-s4Ck,6035
 dali/tests/test_general_sensor.py,sha256=jQqsjzUJa9rbX5pt1K9oavDiFXzMvqclx7qZ7FHrUos,1818
 dali/tests/test_memory.py,sha256=CGcoyhyd_pVC9C4yY0D7X83RIGs8RzYcDX32VuJvd3A,29526
 dali/tests/test_sequences.py,sha256=VaGy1WbUAXFRh-RU6v0OIOHKAhFwVh4KqU7O0N28zF8,4314
-dali/tests/test_serial_driver.py,sha256=5tZYvE3D2BDD4nQc14te9oKh7z6uAj46uYdC5IaHq6w,8711
-python_dali-0.15.dist-info/licenses/COPYING,sha256=jOtLnuWt7d5Hsx6XXB2QxzrSe2sWWh3NgMfFRetluQM,35147
-python_dali-0.15.dist-info/licenses/COPYING.LESSER,sha256=2n6rt7r999OuXp8iOqW9we7ORaxWncIbOwN1ILRGR2g,7651
-python_dali-0.15.dist-info/licenses/LICENSE,sha256=HVcO3iFdIg-1DaBsl4fgk3swO0aZDktmHBZPIhhn_5o,168
-python_dali-0.15.dist-info/METADATA,sha256=NqKxhlAm09OC_InJQejTr2eQVdnboPV1nbmkFmzAZsY,6198
-python_dali-0.15.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-python_dali-0.15.dist-info/top_level.txt,sha256=VlSHNdAIGn5irB2PYMRKK0POsLocy-YusWmK3GwHViI,5
-python_dali-0.15.dist-info/RECORD,,
+dali/tests/test_serial_driver.py,sha256=rB6PBi-2tJsi9NLo2iTxAg2oD0z2epv9L-YFcUai5gY,9351
+python_dali-0.16.dist-info/licenses/COPYING,sha256=jOtLnuWt7d5Hsx6XXB2QxzrSe2sWWh3NgMfFRetluQM,35147
+python_dali-0.16.dist-info/licenses/COPYING.LESSER,sha256=2n6rt7r999OuXp8iOqW9we7ORaxWncIbOwN1ILRGR2g,7651
+python_dali-0.16.dist-info/licenses/LICENSE,sha256=HVcO3iFdIg-1DaBsl4fgk3swO0aZDktmHBZPIhhn_5o,168
+python_dali-0.16.dist-info/METADATA,sha256=cBWW6vSNaCpu-RrUmZp-tw3y0kr3AMgKeO72tnxwhU4,6198
+python_dali-0.16.dist-info/WHEEL,sha256=a-udL2m4V_6Yn8b-uKzWb12RjRxwwMo6ohYFM24tpaY,91
+python_dali-0.16.dist-info/top_level.txt,sha256=VlSHNdAIGn5irB2PYMRKK0POsLocy-YusWmK3GwHViI,5
+python_dali-0.16.dist-info/RECORD,,

{python_dali-0.15.dist-info → python_dali-0.16.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (84.0.0)
+Generator: setuptools (84.2.0)
 Root-Is-Purelib: true
 Tag: py3-none-any