lifx-async 4.3.6__tar.gz → 4.3.8__tar.gz

{lifx_async-4.3.6 → lifx_async-4.3.8}/.github/workflows/ci.yml

@@ -32,7 +32,7 @@ jobs:
     name: Code Quality
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5
+    - uses: actions/checkout@1af3b93b6815bc44a9784bd300feb67ff0d1eeb3 # v6
 
     - name: Set up Python
       uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6
@@ -40,7 +40,7 @@ jobs:
         python-version: ${{ env.PYTHON_VERSION }}
 
     - name: Install uv
-      uses: astral-sh/setup-uv@85856786d1ce8acfbcc2f13a5f3fbd6b938f9f41 # v7
+      uses: astral-sh/setup-uv@1e862dfacbd1d6d858c55d9b792c756523627244 # v7
       with:
         version: ${{ env.UV_VERSION }}
         python-version: ${{ env.PYTHON_VERSION }}
@@ -74,7 +74,7 @@ jobs:
         os: [ubuntu-latest, macos-latest, windows-latest]
         python-version: ['3.11', '3.12', '3.13', '3.14']
     steps:
-    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5
+    - uses: actions/checkout@1af3b93b6815bc44a9784bd300feb67ff0d1eeb3 # v6
 
     - name: Set up Python ${{ matrix.python-version }}
       uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6
@@ -82,7 +82,7 @@ jobs:
         python-version: ${{ matrix.python-version }}
 
     - name: Install uv
-      uses: astral-sh/setup-uv@85856786d1ce8acfbcc2f13a5f3fbd6b938f9f41 # v7
+      uses: astral-sh/setup-uv@1e862dfacbd1d6d858c55d9b792c756523627244 # v7
       with:
         version: ${{ env.UV_VERSION }}
         python-version: ${{ matrix.python-version }}
@@ -95,7 +95,7 @@ jobs:
       run: uv run --frozen pytest
 
     - name: Upload coverage to Codecov
-      uses: codecov/codecov-action@v5
+      uses: codecov/codecov-action@5a1091511ad55cbe89839c7260b706298ca349f7 # v5
       with:
         env_vars: OS,PYTHON
         fail_ci_if_error: false
@@ -105,7 +105,7 @@ jobs:
         verbose: true
 
     - name: Upload test results to Codecov
-      uses: codecov/codecov-action@v5
+      uses: codecov/codecov-action@5a1091511ad55cbe89839c7260b706298ca349f7 # v5
       with:
         env_vars: OS,PYTHON
         fail_ci_if_error: false
@@ -124,7 +124,7 @@ jobs:
     if: github.event_name == 'push' && github.ref_name == 'main'
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8   # v5
+    - uses: actions/checkout@1af3b93b6815bc44a9784bd300feb67ff0d1eeb3   # v6
 
     - name: Set up Python
       uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c   # v6
@@ -132,7 +132,7 @@ jobs:
         python-version: ${{ env.PYTHON_VERSION }}
 
     - name: Install uv
-      uses: astral-sh/setup-uv@85856786d1ce8acfbcc2f13a5f3fbd6b938f9f41   # v7
+      uses: astral-sh/setup-uv@1e862dfacbd1d6d858c55d9b792c756523627244   # v7
       with:
         version: ${{ env.UV_VERSION }}
         python-version: ${{ env.PYTHON_VERSION }}
@@ -184,7 +184,7 @@ jobs:
 
     steps:
     - name: Checkout repository on release branch
-      uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5
+      uses: actions/checkout@1af3b93b6815bc44a9784bd300feb67ff0d1eeb3 # v6
       with:
         ref: ${{ github.head_ref || github.ref_name }}
         fetch-depth: 0
@@ -196,7 +196,7 @@ jobs:
         python-version: ${{ env.PYTHON_VERSION }}
 
     - name: Install uv
-      uses: astral-sh/setup-uv@85856786d1ce8acfbcc2f13a5f3fbd6b938f9f41 # v7
+      uses: astral-sh/setup-uv@1e862dfacbd1d6d858c55d9b792c756523627244 # v7
       with:
         version: ${{ env.UV_VERSION }}
         python-version: ${{ env.PYTHON_VERSION }}

{lifx_async-4.3.6 → lifx_async-4.3.8}/.github/workflows/docs.yml

@@ -25,7 +25,7 @@ jobs:
   build-docs:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5
+    - uses: actions/checkout@1af3b93b6815bc44a9784bd300feb67ff0d1eeb3 # v6
       with:
         fetch-depth: 0    # Fetch all history for git-revision-date-localized
 
@@ -35,7 +35,7 @@ jobs:
         python-version: ${{ env.PYTHON_VERSION }}
 
     - name: Install uv
-      uses: astral-sh/setup-uv@85856786d1ce8acfbcc2f13a5f3fbd6b938f9f41 # v7
+      uses: astral-sh/setup-uv@1e862dfacbd1d6d858c55d9b792c756523627244 # v7
       with:
         version: ${{ env.UV_VERSION }}
         python-version: ${{ env.PYTHON_VERSION }}
@@ -59,7 +59,7 @@ jobs:
     if: github.ref == 'refs/heads/main' && github.event_name == 'push'
     needs: build-docs
     steps:
-    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5
+    - uses: actions/checkout@1af3b93b6815bc44a9784bd300feb67ff0d1eeb3 # v6
       with:
         fetch-depth: 0
 
@@ -69,7 +69,7 @@ jobs:
         python-version: ${{ env.PYTHON_VERSION }}
 
     - name: Install uv
-      uses: astral-sh/setup-uv@85856786d1ce8acfbcc2f13a5f3fbd6b938f9f41 # v7
+      uses: astral-sh/setup-uv@1e862dfacbd1d6d858c55d9b792c756523627244 # v7
       with:
         version: ${{ env.UV_VERSION }}
         python-version: ${{ env.PYTHON_VERSION }}
@@ -89,7 +89,7 @@ jobs:
   validate-links:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5
+    - uses: actions/checkout@1af3b93b6815bc44a9784bd300feb67ff0d1eeb3 # v6
 
     - name: Set up Python
       uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6
@@ -97,7 +97,7 @@ jobs:
         python-version: ${{ env.PYTHON_VERSION }}
 
     - name: Install uv
-      uses: astral-sh/setup-uv@85856786d1ce8acfbcc2f13a5f3fbd6b938f9f41 # v7
+      uses: astral-sh/setup-uv@1e862dfacbd1d6d858c55d9b792c756523627244 # v7
       with:
         version: ${{ env.UV_VERSION }}
         python-version: ${{ env.PYTHON_VERSION }}

{lifx_async-4.3.6 → lifx_async-4.3.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lifx-async
-Version: 4.3.6
+Version: 4.3.8
 Summary: A modern, type-safe, async Python library for controlling LIFX lights
 Author-email: Avi Miller <me@dje.li>
 Maintainer-email: Avi Miller <me@dje.li>

{lifx_async-4.3.6 → lifx_async-4.3.8}/docs/changelog.md

@@ -2,6 +2,22 @@
 
 <!-- version list -->
 
+## v4.3.8 (2025-11-25)
+
+### Bug Fixes
+
+- **network**: Raise exception on StateUnhandled instead of returning False
+  ([`5ca3e8a`](https://github.com/Djelibeybi/lifx-async/commit/5ca3e8abcde0ec0eefe77645aeb0a2e63b18418c))
+
+
+## v4.3.7 (2025-11-25)
+
+### Bug Fixes
+
+- **devices**: Raise LifxUnsupportedCommandError on StateUnhandled responses
+  ([`ec142cf`](https://github.com/Djelibeybi/lifx-async/commit/ec142cf0130847d65d4b9cd825575658936ef823))
+
+
 ## v4.3.6 (2025-11-25)
 
 ### Bug Fixes

{lifx_async-4.3.6 → lifx_async-4.3.8}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "lifx-async"
-version = "4.3.6"
+version = "4.3.8"
 description = "A modern, type-safe, async Python library for controlling LIFX lights"
 readme = "README.md"
 requires-python = ">=3.11"

{lifx_async-4.3.6 → lifx_async-4.3.8}/src/lifx/devices/base.py

@@ -19,7 +19,7 @@ from lifx.const import (
     LIFX_LOCATION_NAMESPACE,
     LIFX_UDP_PORT,
 )
-from lifx.exceptions import LifxDeviceNotFoundError
+from lifx.exceptions import LifxDeviceNotFoundError, LifxUnsupportedCommandError
 from lifx.network.connection import DeviceConnection
 from lifx.products.registry import ProductInfo, get_product
 from lifx.protocol import packets
@@ -152,6 +152,21 @@ class Device:
         ```
     """
 
+    @staticmethod
+    def _raise_if_unhandled(response: object) -> None:
+        """Raise LifxUnsupportedCommandError if device doesn't support the command.
+
+        Args:
+            response: The response from connection.request()
+
+        Raises:
+            LifxUnsupportedCommandError: If response is StateUnhandled or False
+        """
+        if isinstance(response, packets.Device.StateUnhandled):
+            raise LifxUnsupportedCommandError(
+                f"Device does not support packet type {response.unhandled_type}"
+            )
+
     def __init__(
         self,
         serial: str,
@@ -456,6 +471,7 @@ class Device:
             LifxDeviceNotFoundError: If device is not connected
             LifxTimeoutError: If device does not respond
             LifxProtocolError: If response is invalid
+            LifxUnsupportedCommandError: If device doesn't support this command
 
         Example:
             ```python
@@ -469,6 +485,7 @@ class Device:
         """
         # Request automatically unpacks and decodes label
         state = await self.connection.request(packets.Device.GetLabel())
+        self._raise_if_unhandled(state)
 
         # Store label
         self._label = state.label
@@ -492,6 +509,7 @@ class Device:
             ValueError: If label is too long
             LifxDeviceNotFoundError: If device is not connected
             LifxTimeoutError: If device does not respond
+            LifxUnsupportedCommandError: If device doesn't support this command
 
         Example:
             ```python
@@ -508,9 +526,10 @@ class Device:
         label_bytes = label_bytes.ljust(32, b"\x00")
 
         # Request automatically handles acknowledgement
-        await self.connection.request(
+        result = await self.connection.request(
             packets.Device.SetLabel(label=label_bytes),
         )
+        self._raise_if_unhandled(result)
 
         # Update cached state
         self._label = label
@@ -535,6 +554,7 @@ class Device:
             LifxDeviceNotFoundError: If device is not connected
             LifxTimeoutError: If device does not respond
             LifxProtocolError: If response is invalid
+            LifxUnsupportedCommandError: If device doesn't support this command
 
         Example:
             ```python
@@ -544,6 +564,7 @@ class Device:
         """
         # Request automatically unpacks response
         state = await self.connection.request(packets.Device.GetPower())
+        self._raise_if_unhandled(state)
 
         # Power level is uint16 (0 or 65535)
         _LOGGER.debug(
@@ -566,6 +587,7 @@ class Device:
             ValueError: If integer value is not 0 or 65535
             LifxDeviceNotFoundError: If device is not connected
             LifxTimeoutError: If device does not respond
+            LifxUnsupportedCommandError: If device doesn't support this command
 
         Example:
             ```python
@@ -591,9 +613,10 @@ class Device:
             raise TypeError(f"Expected bool or int, got {type(level).__name__}")
 
         # Request automatically handles acknowledgement
-        await self.connection.request(
+        result = await self.connection.request(
             packets.Device.SetPower(level=power_level),
         )
+        self._raise_if_unhandled(result)
 
         _LOGGER.debug(
             {
@@ -616,6 +639,7 @@ class Device:
             LifxDeviceNotFoundError: If device is not connected
             LifxTimeoutError: If device does not respond
             LifxProtocolError: If response is invalid
+            LifxUnsupportedCommandError: If device doesn't support this command
 
         Example:
             ```python
@@ -625,6 +649,7 @@ class Device:
         """
         # Request automatically unpacks response
         state = await self.connection.request(packets.Device.GetVersion())
+        self._raise_if_unhandled(state)
 
         version = DeviceVersion(
             vendor=state.vendor,
@@ -655,6 +680,7 @@ class Device:
             LifxDeviceNotFoundError: If device is not connected
             LifxTimeoutError: If device does not respond
             LifxProtocolError: If response is invalid
+            LifxUnsupportedCommandError: If device doesn't support this command
 
         Example:
             ```python
@@ -665,6 +691,7 @@ class Device:
         """
         # Request automatically unpacks response
         state = await self.connection.request(packets.Device.GetInfo())  # type: ignore
+        self._raise_if_unhandled(state)
 
         info = DeviceInfo(time=state.time, uptime=state.uptime, downtime=state.downtime)
 
@@ -694,6 +721,7 @@ class Device:
             LifxDeviceNotFoundError: If device is not connected
             LifxTimeoutError: If device does not respond
             LifxProtocolError: If response is invalid
+            LifxUnsupportedCommandError: If device doesn't support this command
 
         Example:
             ```python
@@ -704,6 +732,7 @@ class Device:
         """
         # Request WiFi info from device
         state = await self.connection.request(packets.Device.GetWifiInfo())
+        self._raise_if_unhandled(state)
 
         # Extract WiFi info from response
         wifi_info = WifiInfo(signal=state.signal)
@@ -730,6 +759,7 @@ class Device:
             LifxDeviceNotFoundError: If device is not connected
             LifxTimeoutError: If device does not respond
             LifxProtocolError: If response is invalid
+            LifxUnsupportedCommandError: If device doesn't support this command
 
         Example:
             ```python
@@ -739,6 +769,7 @@ class Device:
         """
         # Request automatically unpacks response
         state = await self.connection.request(packets.Device.GetHostFirmware())  # type: ignore
+        self._raise_if_unhandled(state)
 
         firmware = FirmwareInfo(
             build=state.build,
@@ -778,6 +809,7 @@ class Device:
             LifxDeviceNotFoundError: If device is not connected
             LifxTimeoutError: If device does not respond
             LifxProtocolError: If response is invalid
+            LifxUnsupportedCommandError: If device doesn't support this command
 
         Example:
             ```python
@@ -787,6 +819,7 @@ class Device:
         """
         # Request automatically unpacks response
         state = await self.connection.request(packets.Device.GetWifiFirmware())  # type: ignore
+        self._raise_if_unhandled(state)
 
         firmware = FirmwareInfo(
             build=state.build,
@@ -822,6 +855,7 @@ class Device:
             LifxDeviceNotFoundError: If device is not connected
             LifxTimeoutError: If device does not respond
             LifxProtocolError: If response is invalid
+            LifxUnsupportedCommandError: If device doesn't support this command
 
         Example:
             ```python
@@ -832,6 +866,7 @@ class Device:
         """
         # Request automatically unpacks response
         state = await self.connection.request(packets.Device.GetLocation())  # type: ignore
+        self._raise_if_unhandled(state)
 
         location = LocationInfo(
             location=state.location,
@@ -873,6 +908,7 @@ class Device:
             LifxDeviceNotFoundError: If device is not connected
             LifxTimeoutError: If device does not respond
             ValueError: If label is invalid
+            LifxUnsupportedCommandError: If device doesn't support this command
 
         Example:
             ```python
@@ -967,11 +1003,12 @@ class Device:
         updated_at = int(time.time() * 1e9)
 
         # Update this device
-        await self.connection.request(
+        result = await self.connection.request(
             packets.Device.SetLocation(
                 location=location_uuid_to_use, label=label_bytes, updated_at=updated_at
             ),
         )
+        self._raise_if_unhandled(result)
 
         # Update cached state
         location_info = LocationInfo(
@@ -1003,6 +1040,7 @@ class Device:
             LifxDeviceNotFoundError: If device is not connected
             LifxTimeoutError: If device does not respond
             LifxProtocolError: If response is invalid
+            LifxUnsupportedCommandError: If device doesn't support this command
 
         Example:
             ```python
@@ -1013,6 +1051,7 @@ class Device:
         """
         # Request automatically unpacks response
         state = await self.connection.request(packets.Device.GetGroup())  # type: ignore
+        self._raise_if_unhandled(state)
 
         group = GroupInfo(
             group=state.group,
@@ -1054,6 +1093,7 @@ class Device:
             LifxDeviceNotFoundError: If device is not connected
             LifxTimeoutError: If device does not respond
             ValueError: If label is invalid
+            LifxUnsupportedCommandError: If device doesn't support this command
 
         Example:
             ```python
@@ -1148,11 +1188,12 @@ class Device:
         updated_at = int(time.time() * 1e9)
 
         # Update this device
-        await self.connection.request(
+        result = await self.connection.request(
             packets.Device.SetGroup(
                 group=group_uuid_to_use, label=label_bytes, updated_at=updated_at
             ),
         )
+        self._raise_if_unhandled(result)
 
         # Update cached state
         group_info = GroupInfo(
@@ -1181,6 +1222,7 @@ class Device:
         Raises:
             LifxDeviceNotFoundError: If device is not connected
             LifxTimeoutError: If device does not respond
+            LifxUnsupportedCommandError: If device doesn't support this command
 
         Example:
             ```python
@@ -1194,9 +1236,10 @@ class Device:
             comes back online and is discoverable again.
         """
         # Send reboot request
-        await self.connection.request(
+        result = await self.connection.request(
             packets.Device.SetReboot(),
         )
+        self._raise_if_unhandled(result)
         _LOGGER.debug(
             {
                 "class": "Device",

{lifx_async-4.3.6 → lifx_async-4.3.8}/src/lifx/devices/hev.py

@@ -70,6 +70,7 @@ class HevLight(Light):
             LifxDeviceNotFoundError: If device is not connected
             LifxTimeoutError: If device does not respond
             LifxProtocolError: If response is invalid
+            LifxUnsupportedCommandError: If device doesn't support this command
 
         Example:
             ```python
@@ -82,6 +83,7 @@ class HevLight(Light):
         """
         # Request HEV cycle state
         state = await self.connection.request(packets.Light.GetHevCycle())
+        self._raise_if_unhandled(state)
 
         # Create state object
         cycle_state = HevCycleState(
@@ -116,6 +118,7 @@ class HevLight(Light):
             ValueError: If duration is negative
             LifxDeviceNotFoundError: If device is not connected
             LifxTimeoutError: If device does not respond
+            LifxUnsupportedCommandError: If device doesn't support this command
 
         Example:
             ```python
@@ -130,12 +133,13 @@ class HevLight(Light):
             raise ValueError(f"Duration must be non-negative, got {duration_seconds}")
 
         # Request automatically handles acknowledgement
-        await self.connection.request(
+        result = await self.connection.request(
             packets.Light.SetHevCycle(
                 enable=enable,
                 duration_s=duration_seconds,
             ),
         )
+        self._raise_if_unhandled(result)
 
         _LOGGER.debug(
             {
@@ -156,6 +160,7 @@ class HevLight(Light):
             LifxDeviceNotFoundError: If device is not connected
             LifxTimeoutError: If device does not respond
             LifxProtocolError: If response is invalid
+            LifxUnsupportedCommandError: If device doesn't support this command
 
         Example:
             ```python
@@ -166,6 +171,7 @@ class HevLight(Light):
         """
         # Request HEV configuration
         state = await self.connection.request(packets.Light.GetHevCycleConfiguration())
+        self._raise_if_unhandled(state)
 
         # Create config object
         config = HevConfig(
@@ -201,6 +207,7 @@ class HevLight(Light):
             ValueError: If duration is negative
             LifxDeviceNotFoundError: If device is not connected
             LifxTimeoutError: If device does not respond
+            LifxUnsupportedCommandError: If device doesn't support this command
 
         Example:
             ```python
@@ -212,12 +219,13 @@ class HevLight(Light):
             raise ValueError(f"Duration must be non-negative, got {duration_seconds}")
 
         # Request automatically handles acknowledgement
-        await self.connection.request(
+        result = await self.connection.request(
             packets.Light.SetHevCycleConfiguration(
                 indication=indication,
                 duration_s=duration_seconds,
             ),
         )
+        self._raise_if_unhandled(result)
 
         # Update cached state
         self._hev_config = HevConfig(indication=indication, duration_s=duration_seconds)
@@ -242,6 +250,7 @@ class HevLight(Light):
             LifxDeviceNotFoundError: If device is not connected
             LifxTimeoutError: If device does not respond
             LifxProtocolError: If response is invalid
+            LifxUnsupportedCommandError: If device doesn't support this command
 
         Example:
             ```python
@@ -254,6 +263,7 @@ class HevLight(Light):
         """
         # Request last HEV result
         state = await self.connection.request(packets.Light.GetLastHevCycleResult())
+        self._raise_if_unhandled(state)
 
         # Store cached state
         self._hev_result = state.result

{lifx_async-4.3.6 → lifx_async-4.3.8}/src/lifx/devices/infrared.py

@@ -58,6 +58,7 @@ class InfraredLight(Light):
             LifxDeviceNotFoundError: If device is not connected
             LifxTimeoutError: If device does not respond
             LifxProtocolError: If response is invalid
+            LifxUnsupportedCommandError: If device doesn't support this command
 
         Example:
             ```python
@@ -68,6 +69,7 @@ class InfraredLight(Light):
         """
         # Request infrared state
         state = await self.connection.request(packets.Light.GetInfrared())
+        self._raise_if_unhandled(state)
 
         # Convert from uint16 (0-65535) to float (0.0-1.0)
         brightness = state.brightness / 65535.0
@@ -96,6 +98,7 @@ class InfraredLight(Light):
             ValueError: If brightness is out of range
             LifxDeviceNotFoundError: If device is not connected
             LifxTimeoutError: If device does not respond
+            LifxUnsupportedCommandError: If device doesn't support this command
 
         Example:
             ```python
@@ -115,9 +118,10 @@ class InfraredLight(Light):
         brightness_u16 = max(0, min(65535, int(round(brightness * 65535))))
 
         # Request automatically handles acknowledgement
-        await self.connection.request(
+        result = await self.connection.request(
             packets.Light.SetInfrared(brightness=brightness_u16),
         )
+        self._raise_if_unhandled(result)
 
         # Update cached state
         self._infrared = brightness