Improve Device model (#1930)

## Breaking
- The Device class no longer includes the `id` property, and the
following fields have been moved into `device.identifier.{}`:
`protocol`, `gateway_id`, `device_address`, and `subsystem_id`.
- Device.data_properties has been removed, as it was a non-existent
value.

## Enhancement
- Device class now has helper methods for retrieving the state value,
commands and definition.
- Device class now has an `identifier` property with protocol,
gateway_id, device_address, subsystem_id and base_device_url fields.
- The Device class now includes additional fields (data_properties,
ui_profiles, ui_classifiers, attributes) under device.definition.

## Full changelog

Fixes #1923

This pull request refactors and enhances the device modeling logic in
`pyoverkiz/models.py`, introducing a new `DeviceIdentifier` class to
encapsulate device URL parsing and related properties. It also adds
several helper methods to the `Device`, `States`, `Definition`, and
`CommandDefinitions` classes, improving code clarity and testability.
Extensive new tests are added to ensure the correctness of these helpers
and the new identifier logic.

**Device identifier and URL parsing improvements:**

* Introduced a new `DeviceIdentifier` class to encapsulate parsing and
properties of device URLs, replacing scattered parsing logic and related
fields in the `Device` class. Device URL parsing now raises a
`ValueError` for invalid formats. (`pyoverkiz/models.py`)
* Refactored the `Device` class to use the new `identifier` property
instead of separate protocol, gateway_id, device_address, and
subsystem_id fields. (`pyoverkiz/models.py`)
[[1]](diffhunk://#diff-abae13362160dc5f0aff1ba910ffe223a87f52dfda3a77f160ad13a6a9dbc92cL186-L194)
[[2]](diffhunk://#diff-abae13362160dc5f0aff1ba910ffe223a87f52dfda3a77f160ad13a6a9dbc92cL207-R299)

**Helper methods and API enhancements:**

* Added helper methods to `Device`, `States`, `Definition`, and
`CommandDefinitions` classes (e.g., `get_supported_command_name`,
`has_supported_command`, `get_state_value`, `get_state_definition`,
`select`, `has_any`) to simplify common queries and checks.
(`pyoverkiz/models.py`)
[[1]](diffhunk://#diff-abae13362160dc5f0aff1ba910ffe223a87f52dfda3a77f160ad13a6a9dbc92cL207-R299)
[[2]](diffhunk://#diff-abae13362160dc5f0aff1ba910ffe223a87f52dfda3a77f160ad13a6a9dbc92cR355-R366)
[[3]](diffhunk://#diff-abae13362160dc5f0aff1ba910ffe223a87f52dfda3a77f160ad13a6a9dbc92cR409-R418)
[[4]](diffhunk://#diff-abae13362160dc5f0aff1ba910ffe223a87f52dfda3a77f160ad13a6a9dbc92cR557-R573)

**Testing improvements:**

* Updated and expanded tests to cover the new `DeviceIdentifier` logic,
helper methods, and error handling for invalid device URLs. Added new
test cases for the helper methods in `Device`, `States`, `Definition`,
and `CommandDefinitions`. (`tests/test_client.py`,
`tests/test_models.py`)
[[1]](diffhunk://#diff-0d92063e88430a02df61616c5f16b148b64ac4539d9cb9b8d883d5a23351b110L279-R281)
[[2]](diffhunk://#diff-0adb667cd397bd56edce10eec11e1b10821740a10d72bd148b09645fc9108968L9-R15)
[[3]](diffhunk://#diff-0adb667cd397bd56edce10eec11e1b10821740a10d72bd148b09645fc9108968L154-L170)
[[4]](diffhunk://#diff-0adb667cd397bd56edce10eec11e1b10821740a10d72bd148b09645fc9108968L190-R194)
[[5]](diffhunk://#diff-0adb667cd397bd56edce10eec11e1b10821740a10d72bd148b09645fc9108968R203-R241)
[[6]](diffhunk://#diff-0adb667cd397bd56edce10eec11e1b10821740a10d72bd148b09645fc9108968R273-R374)

**Code cleanup:**

* Removed legacy or redundant fields and parsing logic from the `Device`
class, and improved fallback logic for `ui_class` and `widget`
properties. (`pyoverkiz/models.py`)
[[1]](diffhunk://#diff-abae13362160dc5f0aff1ba910ffe223a87f52dfda3a77f160ad13a6a9dbc92cL186-L194)
[[2]](diffhunk://#diff-abae13362160dc5f0aff1ba910ffe223a87f52dfda3a77f160ad13a6a9dbc92cL207-R299)

These changes improve the maintainability and usability of the device
modeling code, making it easier to work with device URLs and query
device capabilities in a robust and testable way.

Author: iMicknl

docs/device-control.md

@@ -24,6 +24,7 @@ devices = await client.get_devices()
 # For demo purposes we take the first available device
 device = devices[0]
 
+# Traditional approach
 availability_state = next(
     (state for state in device.states if state.name == OverkizState.CORE_AVAILABILITY),
     None,
@@ -32,6 +33,92 @@ availability_state = next(
 print(availability_state.value if availability_state else None)
 ```
 
+### Helper methods for device state queries
+
+The `Device` class provides convenient helper methods for querying device states, commands, and their definitions:
+
+#### Get state value
+
+```python
+from pyoverkiz.enums import OverkizState
+
+devices = await client.get_devices()
+device = devices[0]
+
+# Get the value of the first matching state
+slats_orientation = device.get_state_value([OverkizState.CORE_SLATS_ORIENTATION, OverkizState.CORE_SLATE_ORIENTATION])
+print(f"Orientation: {slats_orientation}")
+
+# Check if a state has a non-None value
+if device.has_state_value([OverkizState.CORE_SLATS_ORIENTATION, OverkizState.CORE_SLATE_ORIENTATION]):
+    print("Device has a slats orientation")
+```
+
+#### Get state definition
+
+```python
+devices = await client.get_devices()
+device = devices[0]
+
+# Get the state definition for querying type, valid values, etc.
+state_def = device.get_state_definition([OverkizState.CORE_OPEN_CLOSED, OverkizState.CORE_SLATS_OPEN_CLOSED])
+if state_def:
+    print(f"Type: {state_def.type}")
+    print(f"Valid values: {state_def.values}")
+```
+
+#### Check supported commands
+
+```python
+from pyoverkiz.enums import OverkizCommand
+
+devices = await client.get_devices()
+device = devices[0]
+
+# Check if device supports any of the given commands
+if device.has_supported_command([OverkizCommand.OPEN, OverkizCommand.CLOSE]):
+    print("Device supports open/close commands")
+
+# Get the first supported command from a list
+supported_cmd = device.get_supported_command_name(
+    [OverkizCommand.SET_CLOSURE, OverkizCommand.OPEN, OverkizCommand.CLOSE]
+)
+if supported_cmd:
+    print(f"Supported command: {supported_cmd}")
+```
+
+#### Get attribute value
+
+```python
+devices = await client.get_devices()
+device = devices[0]
+
+# Get the value of device attributes (like firmware)
+firmware = device.get_attribute_value([
+    OverkizAttribute.CORE_FIRMWARE_REVISION,
+])
+print(f"Firmware: {firmware}")
+```
+
+#### Access device identifier
+
+Device URLs are automatically parsed into structured identifier components for easier access:
+
+```python
+devices = await client.get_devices()
+device = devices[0]
+
+# Access parsed device URL components
+print(f"Protocol: {device.identifier.protocol}")
+print(f"Gateway ID: {device.identifier.gateway_id}")
+print(f"Device address: {device.identifier.device_address}")
+print(f"Base device URL: {device.identifier.base_device_url}")
+
+# Check if this is a sub-device
+if device.identifier.is_sub_device:
+    print(f"Sub-device ID: {device.identifier.subsystem_id}")
+```
+
 ## Send a command
 
 ```python