Raise OverkizError instead of ValueError for API data issues

DeviceIdentifier.from_device_url() and Device validation now raise
OverkizError, consistent with the rest of the exception hierarchy.
ValueError is reserved for programming errors (wrong argument types).

Author: iMicknl

pyoverkiz/models.py

@@ -27,6 +27,7 @@
 from pyoverkiz.enums.command import OverkizCommand
 from pyoverkiz.enums.protocol import Protocol
 from pyoverkiz.enums.server import APIType, Server
+from pyoverkiz.exceptions import OverkizError
 from pyoverkiz.obfuscate import obfuscate_email, obfuscate_id, obfuscate_string
 from pyoverkiz.types import DATA_TYPE_TO_PYTHON, CommandParameterValue, StateType
 
@@ -363,7 +364,7 @@ def from_device_url(cls, device_url: str) -> DeviceIdentifier:
         """Parse a device URL into its structured identifier components."""
         match = DEVICE_URL_RE.fullmatch(device_url)
         if not match:
-            raise ValueError(f"Invalid device URL: {device_url}")
+            raise OverkizError(f"Invalid device URL: {device_url}")
 
         subsystem_id = (
             int(match.group("subsystemId")) if match.group("subsystemId") else None
@@ -414,7 +415,9 @@ def __attrs_post_init__(self) -> None:
                 self.widget = UIWidget(self.definition.widget_name)
 
         if self.ui_class is None or self.widget is None:
-            raise ValueError(f"Device {self.device_url} is missing ui_class or widget")
+            raise OverkizError(
+                f"Device {self.device_url} is missing ui_class or widget"
+            )
 
     def supports_command(self, command: str | OverkizCommand) -> bool:
         """Check if device supports a command."""