pywiim 2.2.7__tar.gz → 2.2.8__tar.gz

{pywiim-2.2.7/pywiim.egg-info → pywiim-2.2.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pywiim
-Version: 2.2.7
+Version: 2.2.8
 Summary: Python library for WiiM/LinkPlay device communication
 Author-email: Michael Cumming <mjcumming@gmail.com>
 License: MIT

{pywiim-2.2.7 → pywiim-2.2.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pywiim"
-version = "2.2.7"
+version = "2.2.8"
 description = "Python library for WiiM/LinkPlay device communication"
 readme = "README.md"
 requires-python = ">=3.11"

{pywiim-2.2.7 → pywiim-2.2.8}/pywiim/__init__.py

@@ -62,6 +62,7 @@ from .discovery import (
     discover_devices,
     discover_via_ssdp,
     validate_device,
+    validate_device_strict,
 )
 from .exceptions import (
     WiiMConnectionError,
@@ -87,7 +88,7 @@ from .profiles import (
 from .role import RoleDetectionResult, detect_role
 from .state import GroupStateSynchronizer, StateSynchronizer
 
-__version__ = "2.2.7"
+__version__ = "2.2.8"
 __all__ = [
     # Main client
     "WiiMClient",
@@ -111,6 +112,7 @@ __all__ = [
     "discover_devices",
     "discover_via_ssdp",
     "validate_device",
+    "validate_device_strict",
     # Backoff
     "BackoffController",
     # Normalization

{pywiim-2.2.7 → pywiim-2.2.8}/pywiim/discovery.py

@@ -22,6 +22,7 @@ except ImportError:
     async_search = None  # type: ignore[assignment]
 
 from .client import WiiMClient
+from .exceptions import WiiMConnectionError
 
 _LOGGER = logging.getLogger(__name__)
 
@@ -32,6 +33,7 @@ __all__ = [
     "is_known_linkplay",
     "is_linkplay_device",
     "validate_device",
+    "validate_device_strict",
 ]
 
 # Known LinkPlay/WiiM server patterns (devices we're CERTAIN are LinkPlay)
@@ -485,6 +487,32 @@ async def validate_device(device: DiscoveredDevice) -> DiscoveredDevice:
     return device
 
 
+async def validate_device_strict(device: DiscoveredDevice) -> DiscoveredDevice:
+    """Validate a discovered device and raise if it is not usable.
+
+    ``validate_device()`` is intentionally soft-fail for bulk discovery: it
+    returns the input device with ``validated=False`` when the host does not
+    pass the LinkPlay/WiiM probe. Use this helper for manual setup flows or
+    other code paths where an unvalidated device is an error.
+
+    Args:
+        device: Device to validate.
+
+    Returns:
+        Updated device with full information.
+
+    Raises:
+        WiiMConnectionError: If the host cannot be validated as LinkPlay/WiiM.
+    """
+    validated_device = await validate_device(device)
+    if not validated_device.validated:
+        raise WiiMConnectionError(
+            f"Device at {device.ip} did not validate as a LinkPlay/WiiM device",
+            operation_context="device_validation",
+        )
+    return validated_device
+
+
 async def discover_devices(
     methods: list[str] | None = None,
     validate: bool = True,

{pywiim-2.2.7 → pywiim-2.2.8/pywiim.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pywiim
-Version: 2.2.7
+Version: 2.2.8
 Summary: Python library for WiiM/LinkPlay device communication
 Author-email: Michael Cumming <mjcumming@gmail.com>
 License: MIT