lifx-async 5.0.0__py3-none-any.whl → 5.1.0__py3-none-any.whl

lifx/network/connection.py

@@ -5,7 +5,6 @@ from __future__ import annotations
 import asyncio
 import logging
 import random
-import secrets
 import time
 from collections.abc import AsyncGenerator
 from typing import TYPE_CHECKING, Any, TypeVar
@@ -17,6 +16,7 @@ from lifx.const import (
     DEFAULT_MAX_RETRIES,
     DEFAULT_REQUEST_TIMEOUT,
     LIFX_UDP_PORT,
+    TIMEOUT_ERRORS,
 )
 from lifx.exceptions import (
     LifxConnectionError,
@@ -26,6 +26,7 @@ from lifx.exceptions import (
 )
 from lifx.network.message import create_message, parse_message
 from lifx.network.transport import UdpTransport
+from lifx.network.utils import allocate_source
 from lifx.protocol.header import LifxHeader
 from lifx.protocol.models import Serial
 
@@ -193,7 +194,7 @@ class DeviceConnection:
                 await asyncio.wait_for(
                     self._receiver_task, timeout=_RECEIVER_SHUTDOWN_TIMEOUT
                 )
-            except TimeoutError:
+            except TIMEOUT_ERRORS:
                 self._receiver_task.cancel()
                 try:
                     await self._receiver_task
@@ -335,7 +336,7 @@ class DeviceConnection:
         Returns:
             Unique source identifier (range: 2 to 4294967295)
         """
-        return secrets.randbelow(0xFFFFFFFF - 1) + 2
+        return allocate_source()
 
     async def _background_receiver(self) -> None:
         """Background task to receive and route packets.
@@ -559,7 +560,7 @@ class DeviceConnection:
                             header, payload = await asyncio.wait_for(
                                 response_queue.get(), timeout=remaining_time
                             )
-                        except TimeoutError:
+                        except TIMEOUT_ERRORS:
                             if not has_yielded:
                                 # No response this attempt, retry
                                 raise TimeoutError(
@@ -603,7 +604,7 @@ class DeviceConnection:
 
                         # Continue loop to wait for more responses
 
-                except TimeoutError as e:
+                except TIMEOUT_ERRORS as e:
                     last_error = LifxTimeoutError(str(e))
                     if attempt < max_retries:
                         # Sleep with jitter before retry
@@ -702,7 +703,7 @@ class DeviceConnection:
                     header, _payload = await asyncio.wait_for(
                         response_queue.get(), timeout=current_timeout
                     )
-                except TimeoutError:
+                except TIMEOUT_ERRORS:
                     raise TimeoutError(
                         f"No acknowledgement within {current_timeout:.3f}s "
                         f"(attempt {attempt + 1}/{max_retries + 1})"
@@ -731,7 +732,7 @@ class DeviceConnection:
                 yield True
                 return
 
-            except TimeoutError as e:
+            except TIMEOUT_ERRORS as e:
                 last_error = LifxTimeoutError(str(e))
                 if attempt < max_retries:
                     # Sleep with jitter before retry

lifx/network/discovery.py

@@ -3,7 +3,6 @@
 from __future__ import annotations
 
 import logging
-import secrets
 import time
 from collections.abc import AsyncGenerator
 from dataclasses import dataclass, field
@@ -20,6 +19,7 @@ from lifx.const import (
 from lifx.exceptions import LifxProtocolError, LifxTimeoutError
 from lifx.network.message import create_message, parse_message
 from lifx.network.transport import UdpTransport
+from lifx.network.utils import allocate_source
 from lifx.protocol.base import Packet
 from lifx.protocol.models import Serial
 from lifx.protocol.packets import Device as DevicePackets
@@ -219,7 +219,7 @@ async def _discover_with_packet(
 
     async with UdpTransport(port=0, broadcast=True) as transport:
         # Allocate unique source for this discovery session
-        discovery_source = secrets.randbelow(0xFFFFFFFF - 1) + 2
+        discovery_source = allocate_source()
 
         message = create_message(
             packet=packet,
@@ -470,7 +470,7 @@ async def discover_devices(
     # Create transport with broadcast enabled
     async with UdpTransport(port=0, broadcast=True) as transport:
         # Allocate unique source for this discovery session
-        discovery_source = secrets.randbelow(0xFFFFFFFF - 1) + 2
+        discovery_source = allocate_source()
 
         # Create discovery message
         discovery_packet = DevicePackets.GetService()

lifx/network/mdns/transport.py

@@ -13,7 +13,7 @@ import struct
 from asyncio import DatagramTransport
 from typing import TYPE_CHECKING
 
-from lifx.const import MDNS_ADDRESS, MDNS_PORT
+from lifx.const import MDNS_ADDRESS, MDNS_PORT, TIMEOUT_ERRORS
 from lifx.exceptions import LifxNetworkError, LifxTimeoutError
 
 if TYPE_CHECKING:
@@ -259,7 +259,7 @@ class MdnsTransport:
                 self._protocol.queue.get(), timeout=timeout
             )
             return data, addr
-        except TimeoutError as e:
+        except TIMEOUT_ERRORS as e:
             raise LifxTimeoutError(f"No mDNS data received within {timeout}s") from e
         except OSError as e:
             _LOGGER.debug(

lifx/network/transport.py

@@ -6,7 +6,12 @@ import asyncio
 import logging
 from typing import TYPE_CHECKING
 
-from lifx.const import DEFAULT_IP_ADDRESS, MAX_PACKET_SIZE, MIN_PACKET_SIZE
+from lifx.const import (
+    DEFAULT_IP_ADDRESS,
+    MAX_PACKET_SIZE,
+    MIN_PACKET_SIZE,
+    TIMEOUT_ERRORS,
+)
 from lifx.exceptions import LifxNetworkError
 from lifx.exceptions import LifxTimeoutError as LifxTimeoutError
 
@@ -208,7 +213,7 @@ class UdpTransport:
             data, addr = await asyncio.wait_for(
                 self._protocol.queue.get(), timeout=timeout
             )
-        except TimeoutError as e:
+        except TIMEOUT_ERRORS as e:
             raise LifxTimeoutError(f"No data received within {timeout}s") from e
         except OSError as e:
             _LOGGER.error(
@@ -302,7 +307,7 @@ class UdpTransport:
                     continue
 
                 packets.append((data, addr))
-            except TimeoutError:
+            except TIMEOUT_ERRORS:
                 # Timeout is expected - return what we collected
                 break
             except OSError:

lifx/network/utils.py

@@ -0,0 +1,15 @@
+"""Network utilities for LIFX protocol communication."""
+
+import secrets
+
+
+def allocate_source() -> int:
+    """Allocate unique source identifier for a LIFX protocol request.
+
+    LIFX protocol defines source as Uint32, with 0 and 1 reserved.
+    We generate values in range [2, 0xFFFFFFFF].
+
+    Returns:
+        Unique source identifier (range: 2 to 4294967295)
+    """
+    return secrets.randbelow(0xFFFFFFFF - 1) + 2

lifx/protocol/serializer.py

@@ -281,88 +281,3 @@ def unpack_bytes(data: bytes, length: int, offset: int = 0) -> tuple[bytes, int]
 
     raw_bytes = data[offset : offset + length]
     return raw_bytes, offset + length
-
-
-class FieldSerializer:
-    """Serializer for structured fields with nested types."""
-
-    def __init__(self, field_definitions: dict[str, dict[str, str]]):
-        """Initialize serializer with field definitions.
-
-        Args:
-            field_definitions: Dict mapping field names to structure definitions
-        """
-        self.field_definitions = field_definitions
-
-    def pack_field(self, field_data: dict[str, Any], field_name: str) -> bytes:
-        """Pack a structured field.
-
-        Args:
-            field_data: Dictionary of field values
-            field_name: Name of the field structure (e.g., "HSBK")
-
-        Returns:
-            Packed bytes
-
-        Raises:
-            ValueError: If field_name is unknown
-        """
-        if field_name not in self.field_definitions:
-            raise ValueError(f"Unknown field: {field_name}")
-
-        field_def = self.field_definitions[field_name]
-        result = b""
-
-        for attr_name, attr_type in field_def.items():
-            if attr_name not in field_data:
-                raise ValueError(f"Missing attribute {attr_name} in {field_name}")
-            result += pack_value(field_data[attr_name], attr_type)
-
-        return result
-
-    def unpack_field(
-        self, data: bytes, field_name: str, offset: int = 0
-    ) -> tuple[dict[str, Any], int]:
-        """Unpack a structured field.
-
-        Args:
-            data: Bytes to unpack from
-            field_name: Name of the field structure
-            offset: Offset to start unpacking
-
-        Returns:
-            Tuple of (field_dict, new_offset)
-
-        Raises:
-            ValueError: If field_name is unknown
-        """
-        if field_name not in self.field_definitions:
-            raise ValueError(f"Unknown field: {field_name}")
-
-        field_def = self.field_definitions[field_name]
-        field_data: dict[str, Any] = {}
-        current_offset = offset
-
-        for attr_name, attr_type in field_def.items():
-            value, current_offset = unpack_value(data, attr_type, current_offset)
-            field_data[attr_name] = value
-
-        return field_data, current_offset
-
-    def get_field_size(self, field_name: str) -> int:
-        """Get the size in bytes of a field structure.
-
-        Args:
-            field_name: Name of the field structure
-
-        Returns:
-            Size in bytes
-
-        Raises:
-            ValueError: If field_name is unknown
-        """
-        if field_name not in self.field_definitions:
-            raise ValueError(f"Unknown field: {field_name}")
-
-        field_def = self.field_definitions[field_name]
-        return sum(TYPE_SIZES[attr_type] for attr_type in field_def.values())

{lifx_async-5.0.0.dist-info → lifx_async-5.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lifx-async
-Version: 5.0.0
+Version: 5.1.0
 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-5.0.0.dist-info → lifx_async-5.1.0.dist-info}/RECORD

@@ -1,34 +1,40 @@
-lifx/__init__.py,sha256=DKHG1vFJvPw_LpMkQgZN85gyOSD8dnceq6LnEGgR9vs,2810
-lifx/api.py,sha256=tTE9H8eSVrFIr6rEGxedWoR4ChnqvTz2EUgEQk60fgU,35428
+lifx/__init__.py,sha256=GVGsRhvFvKMFmZmdZm9yFwbYh6RywOumGRsa5CyTK84,2914
+lifx/api.py,sha256=A2cNGVewJR_ovzYYffkUT7Lknj0nzruwuhhoOtcAxwM,35134
 lifx/color.py,sha256=UfeoOiFgFih5edl2Ei-0wSzvZXRTI47yUm9GlNJZeTw,26041
-lifx/const.py,sha256=5LEh4h0-bEJlOfpG8fgyht0LkAEV9jkkpuCiuatBhEI,3840
+lifx/const.py,sha256=M_6d1yFaWzalUAWzrVHv6BOIOu_1f6JJslP267Vd_kg,4573
 lifx/exceptions.py,sha256=pikAMppLn7gXyjiQVWM_tSvXKNh-g366nG_UWyqpHhc,815
 lifx/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lifx/animation/__init__.py,sha256=1EqPk26BTEADYR5qLD1UKb7cNnVfnLo5vfAnix6yyu0,2307
+lifx/animation/animator.py,sha256=LyruwE4Z0gHnkGJfgug017-Mt0R-3FCrDoEsqGjE5ps,10154
+lifx/animation/framebuffer.py,sha256=ya3mbYtu5hepn2Fxfc3wEck5KhmmAfcbmv0RoIO-yC4,14116
+lifx/animation/orientation.py,sha256=bUMV4czLn5PH3inMObfyvbYD-jaSSH-LWaLOby-mvTs,5839
+lifx/animation/packets.py,sha256=jMNfe0EKb9oMn96UdYqJshlncYTx61IX6OzKo4SjFcg,17017
 lifx/devices/__init__.py,sha256=4b5QtO0EFWxIqN2lUYgM8uLjWyHI5hUcReiF9QCjCGw,1061
 lifx/devices/base.py,sha256=mhNLX6FoLBaZtYo9InleneYdb0dk3B2Ze8Z2eqXCNHo,63180
-lifx/devices/ceiling.py,sha256=bLAurvqTNmhKMFUUJmLqn1vDFawapYju2i4G0pHOH_4,45790
+lifx/devices/ceiling.py,sha256=cmGeEyads2O5e2H2VBsk6n0An4dZtT59HQvN2F9b4gA,45771
 lifx/devices/hev.py,sha256=kTRJRYnWyIY8Pkg_jOn978N-_1YXy9fRmBiGgEWscXw,15194
 lifx/devices/infrared.py,sha256=ePk9qxX_s-hv5gQMvio1Vv8FYiCd68HF0ySbWgSrvuU,8130
 lifx/devices/light.py,sha256=ZhC7zuruZ9nzmnAR_st2KMUH8UNQAcNK-eQUYnKXm-8,33833
-lifx/devices/matrix.py,sha256=TcfVvqFCIhGXjOtaQEARQCXe9XqSFDZ4wEQdRZBiQpA,42301
+lifx/devices/matrix.py,sha256=reB6cS2_cFe3qZKg584oCO-JGLbNTJDWwW9FZ0NLxq0,41693
 lifx/devices/multizone.py,sha256=7Te5Z_X9hDvdypjMqPGGM2TG0P9QltzFVi7UUxRdbGI,33326
 lifx/effects/__init__.py,sha256=4DF31yp7RJic5JoltMlz5dCtF5KQobU6NOUtLUKkVKE,1509
 lifx/effects/base.py,sha256=tKgX5PsV6hipffD2B236rOzudkMwWq59-eQGnfvNKdU,10354
-lifx/effects/colorloop.py,sha256=Yz9XcQ_VhTPSnJn1s4WnkoXTRh2_qFJrPhQkIiTF6Tk,15574
+lifx/effects/colorloop.py,sha256=LYlljT7XfaQ-S3mWNMWZ-3q7ce1cfl8nmyLb-VuXTZE,15592
 lifx/effects/conductor.py,sha256=Oaq-6m1kdUF6bma_U9GcA9onZzh6YRjpExBr-OGHQJI,14552
 lifx/effects/const.py,sha256=03LfL8v9PtoUs6-2IR3aa6nkyA4Otdno51SFJtntC-U,795
 lifx/effects/models.py,sha256=MS5D-cxD0Ar8XhqbqKAc9q2sk38IP1vPkYwd8V7jCr8,2446
 lifx/effects/pulse.py,sha256=k4dtBhhgVHyuwzqzx89jYVKbSRUVQdZj91cklyKarbE,8455
 lifx/effects/state_manager.py,sha256=iDfYowiCN5IJqcR1s-pM0mQEJpe-RDsMcOOSMmtPVDE,8983
 lifx/network/__init__.py,sha256=uSyA8r8qISG7qXUHbX8uk9A2E8rvDADgCcf94QIZ9so,499
-lifx/network/connection.py,sha256=qPKEkhr9DvoL2cCJoIlDi8rowNS-gUn_F3mesnzyFjs,38412
-lifx/network/discovery.py,sha256=syFfkDYWo0AEoBdEBjWqBm4K7UJwZW5x2K0FBMiA2I0,24186
+lifx/network/connection.py,sha256=_DiXNKN80ki266gg2e4kTWvcPxgYQJPJJUP8nVC6woU,38454
+lifx/network/discovery.py,sha256=J0B3yRkbZKx7g01CCIEnjv3gtqSORhmdTYQ6w0ea4WI,24178
 lifx/network/message.py,sha256=jCLC9v0tbBi54g5CaHLFM_nP1Izu8kJmo2tt23HHBbA,2600
-lifx/network/transport.py,sha256=io_3SFYQliNa_upHcKRzrLUkDVsDmNsxa2gQMlxj7Zk,10912
+lifx/network/transport.py,sha256=EykhKmvjAcdiepgCxgzDTj8Fc0b7kAQdyR8AumGXohg,10953
+lifx/network/utils.py,sha256=WLxyPh0JbA4SUHgcSqENMSBB2R8eW_J2fKCpAKZUxt4,421
 lifx/network/mdns/__init__.py,sha256=LlZgsFe6q5_SIXvXqtuZ_O9tJbcJZ-nsFkD2_wD8_TM,1412
 lifx/network/mdns/discovery.py,sha256=EZ2zlJmy96rMDmu5J-68ystXJ2gYa18zTYP3iqmTGgU,13200
 lifx/network/mdns/dns.py,sha256=OsvNSxLepIG3Nhw-kkQF3JrBYI-ikod5SHD2HO5_yGE,9363
-lifx/network/mdns/transport.py,sha256=41E_yX9Jx42ffElTcF-73A4ma48b3xkkHnG3DTcO8u8,10250
+lifx/network/mdns/transport.py,sha256=x1IzvOYSsMcTY1zGIg0Cv694KU6Pyp8CaY0YQUI_-Nc,10268
 lifx/network/mdns/types.py,sha256=9fhH5iuMQxLkFPhmFTf2-kOcUNoWEu7LrN15Qr9tFE0,990
 lifx/products/__init__.py,sha256=pf2O-fzt6nOrQd-wmzhiog91tMiGa-dDbaSNtU2ZQfE,764
 lifx/products/generator.py,sha256=DsTCJcEVPmn9sfXSbXYdFZjqMfIbodnIQL46DRASs0g,15731
@@ -41,13 +47,13 @@ lifx/protocol/header.py,sha256=HaYQ5wEjAMgefO3dIxKb0w4VG4fLcfLj-fnHVwfp1ao,7174
 lifx/protocol/models.py,sha256=eOvOSAWbglR1SYWcC_YpicewtsdbVlQ6E2lfcC4NQrk,8172
 lifx/protocol/packets.py,sha256=ENp3irGITdV5rGah3eUzgsXqihI95upAPh7AdTsP7sk,43303
 lifx/protocol/protocol_types.py,sha256=m15A82zVrwAXomTqo-GfNmAIynVRDSV94UqHDkWgiJI,23781
-lifx/protocol/serializer.py,sha256=Cl87-Y8_LnvqFANjorJK2CMoRtBGksB_Eq07xHMTqH0,10387
+lifx/protocol/serializer.py,sha256=IEnKKeCRy4Cwz03zkWhg-2pV3Lrro6cMa-3fhWYOngg,7714
 lifx/theme/__init__.py,sha256=dg4Y25dYq22EemFyxQ1fyb3D_bP2hhxGCd9BE1g_hvk,1320
 lifx/theme/canvas.py,sha256=4h7lgN8iu_OdchObGDgbxTqQLCb-FRKC-M-YCWef_i4,8048
 lifx/theme/generators.py,sha256=nq3Yvntq_h-eFHbmmow3LcAdA_hEbRRaP5mv9Bydrjk,6435
 lifx/theme/library.py,sha256=tKlKZNqJp8lRGDnilWyDm_Qr1vCRGGwuvWVS82anNpQ,21326
 lifx/theme/theme.py,sha256=qMEx_8E41C0Cc6f083XHiAXEglTv4YlXW0UFsG1rQKg,5521
-lifx_async-5.0.0.dist-info/METADATA,sha256=Ozi93MbWMkhFydTJ_nuyQUxRLLH_iGYOxtlr0iBXe2U,2660
-lifx_async-5.0.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-lifx_async-5.0.0.dist-info/licenses/LICENSE,sha256=eBz48GRA3gSiWn3rYZAz2Ewp35snnhV9cSqkVBq7g3k,1832
-lifx_async-5.0.0.dist-info/RECORD,,
+lifx_async-5.1.0.dist-info/METADATA,sha256=bT9ZFTUQCHcsnPwdyskaOeOfBQ_HP71_e-6dvtGn6SE,2660
+lifx_async-5.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+lifx_async-5.1.0.dist-info/licenses/LICENSE,sha256=eBz48GRA3gSiWn3rYZAz2Ewp35snnhV9cSqkVBq7g3k,1832
+lifx_async-5.1.0.dist-info/RECORD,,