aiohomematic 2025.8.7__tar.gz → 2025.8.9__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (106) hide show
  1. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/PKG-INFO +1 -1
  2. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/caches/dynamic.py +8 -12
  3. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/caches/persistent.py +27 -22
  4. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/caches/visibility.py +275 -252
  5. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/central/__init__.py +26 -31
  6. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/const.py +103 -76
  7. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/calculated/__init__.py +3 -3
  8. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/calculated/data_point.py +5 -1
  9. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/custom/data_point.py +4 -0
  10. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/data_point.py +16 -3
  11. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/device.py +35 -64
  12. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/hub/__init__.py +5 -9
  13. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/hub/data_point.py +4 -0
  14. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/update.py +4 -0
  15. aiohomematic-2025.8.9/aiohomematic/rega_scripts/fetch_all_device_data.fn +92 -0
  16. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/support.py +15 -2
  17. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic.egg-info/PKG-INFO +1 -1
  18. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/tests/test_device.py +4 -3
  19. aiohomematic-2025.8.7/aiohomematic/rega_scripts/fetch_all_device_data.fn +0 -75
  20. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/LICENSE +0 -0
  21. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/README.md +0 -0
  22. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/__init__.py +0 -0
  23. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/async_support.py +0 -0
  24. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/caches/__init__.py +0 -0
  25. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/central/decorators.py +0 -0
  26. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/central/xml_rpc_server.py +0 -0
  27. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/client/__init__.py +0 -0
  28. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/client/json_rpc.py +0 -0
  29. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/client/xml_rpc.py +0 -0
  30. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/context.py +0 -0
  31. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/converter.py +0 -0
  32. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/decorators.py +0 -0
  33. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/exceptions.py +0 -0
  34. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/hmcli.py +0 -0
  35. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/__init__.py +0 -0
  36. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/calculated/climate.py +0 -0
  37. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/calculated/operating_voltage_level.py +0 -0
  38. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/calculated/support.py +0 -0
  39. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/custom/__init__.py +0 -0
  40. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/custom/climate.py +0 -0
  41. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/custom/const.py +0 -0
  42. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/custom/cover.py +0 -0
  43. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/custom/definition.py +0 -0
  44. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/custom/light.py +0 -0
  45. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/custom/lock.py +0 -0
  46. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/custom/siren.py +0 -0
  47. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/custom/support.py +0 -0
  48. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/custom/switch.py +0 -0
  49. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/custom/valve.py +0 -0
  50. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/decorators.py +0 -0
  51. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/event.py +0 -0
  52. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/generic/__init__.py +0 -0
  53. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/generic/action.py +0 -0
  54. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/generic/binary_sensor.py +0 -0
  55. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/generic/button.py +0 -0
  56. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/generic/data_point.py +0 -0
  57. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/generic/number.py +0 -0
  58. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/generic/select.py +0 -0
  59. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/generic/sensor.py +0 -0
  60. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/generic/switch.py +0 -0
  61. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/generic/text.py +0 -0
  62. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/hub/binary_sensor.py +0 -0
  63. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/hub/button.py +0 -0
  64. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/hub/number.py +0 -0
  65. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/hub/select.py +0 -0
  66. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/hub/sensor.py +0 -0
  67. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/hub/switch.py +0 -0
  68. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/hub/text.py +0 -0
  69. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/model/support.py +0 -0
  70. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/py.typed +0 -0
  71. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/rega_scripts/get_program_descriptions.fn +0 -0
  72. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/rega_scripts/get_serial.fn +0 -0
  73. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/rega_scripts/get_system_variable_descriptions.fn +0 -0
  74. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/rega_scripts/set_program_state.fn +0 -0
  75. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/rega_scripts/set_system_variable.fn +0 -0
  76. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic/validator.py +0 -0
  77. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic.egg-info/SOURCES.txt +0 -0
  78. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic.egg-info/dependency_links.txt +0 -0
  79. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic.egg-info/requires.txt +0 -0
  80. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic.egg-info/top_level.txt +0 -0
  81. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic_support/__init__.py +0 -0
  82. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/aiohomematic_support/client_local.py +0 -0
  83. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/pyproject.toml +0 -0
  84. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/setup.cfg +0 -0
  85. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/tests/test_action.py +0 -0
  86. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/tests/test_binary_sensor.py +0 -0
  87. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/tests/test_button.py +0 -0
  88. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/tests/test_calculated_support.py +0 -0
  89. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/tests/test_central.py +0 -0
  90. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/tests/test_central_pydevccu.py +0 -0
  91. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/tests/test_climate.py +0 -0
  92. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/tests/test_cover.py +0 -0
  93. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/tests/test_decorator.py +0 -0
  94. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/tests/test_entity.py +0 -0
  95. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/tests/test_event.py +0 -0
  96. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/tests/test_json_rpc.py +0 -0
  97. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/tests/test_light.py +0 -0
  98. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/tests/test_lock.py +0 -0
  99. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/tests/test_number.py +0 -0
  100. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/tests/test_select.py +0 -0
  101. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/tests/test_sensor.py +0 -0
  102. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/tests/test_siren.py +0 -0
  103. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/tests/test_support.py +0 -0
  104. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/tests/test_switch.py +0 -0
  105. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/tests/test_text.py +0 -0
  106. {aiohomematic-2025.8.7 → aiohomematic-2025.8.9}/tests/test_valve.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: aiohomematic
3
- Version: 2025.8.7
3
+ Version: 2025.8.9
4
4
  Summary: Homematic interface for Home Assistant running on Python 3.
5
5
  Home-page: https://github.com/sukramj/aiohomematic
6
6
  Author-email: SukramJ <sukramj@icloud.com>, Daniel Perna <danielperna84@gmail.com>
@@ -25,11 +25,13 @@ from collections.abc import Mapping
25
25
  from datetime import datetime
26
26
  import logging
27
27
  from typing import Any, Final, cast
28
+ from urllib.parse import unquote
28
29
 
29
30
  from aiohomematic import central as hmcu
30
31
  from aiohomematic.const import (
31
32
  DP_KEY_VALUE,
32
33
  INIT_DATETIME,
34
+ ISO_8859_1,
33
35
  LAST_COMMAND_SEND_STORE_TIMEOUT,
34
36
  MAX_CACHE_AGE,
35
37
  NO_CACHE_ENTRY,
@@ -272,7 +274,6 @@ class CentralDataCache:
272
274
 
273
275
  __slots__ = (
274
276
  "_central",
275
- "_escaped_channel_cache",
276
277
  "_refreshed_at",
277
278
  "_value_cache",
278
279
  )
@@ -283,7 +284,6 @@ class CentralDataCache:
283
284
  # { key, value}
284
285
  self._value_cache: Final[dict[Interface, Mapping[str, Any]]] = {}
285
286
  self._refreshed_at: Final[dict[Interface, datetime]] = {}
286
- self._escaped_channel_cache: Final[dict[str, str]] = {}
287
287
 
288
288
  async def load(self, direct_call: bool = False, interface: Interface | None = None) -> None:
289
289
  """Fetch data from backend."""
@@ -310,7 +310,10 @@ class CentralDataCache:
310
310
 
311
311
  def add_data(self, interface: Interface, all_device_data: Mapping[str, Any]) -> None:
312
312
  """Add data to cache."""
313
- self._value_cache[interface] = all_device_data
313
+ self._value_cache[interface] = {
314
+ unquote(string=k, encoding=ISO_8859_1): unquote(string=v, encoding=ISO_8859_1) if isinstance(v, str) else v
315
+ for k, v in all_device_data.items()
316
+ }
314
317
  self._refreshed_at[interface] = datetime.now()
315
318
 
316
319
  def get_data(
@@ -320,14 +323,8 @@ class CentralDataCache:
320
323
  parameter: str,
321
324
  ) -> Any:
322
325
  """Get data from cache."""
323
- if not self._is_empty(interface=interface):
324
- # Escape channel address only once per unique address
325
- if (escaped := self._escaped_channel_cache.get(channel_address)) is None:
326
- escaped = channel_address.replace(":", "%3A") if ":" in channel_address else channel_address
327
- self._escaped_channel_cache[channel_address] = escaped
328
- key = f"{interface}.{escaped}.{parameter}"
329
- if (iface_cache := self._value_cache.get(interface)) is not None:
330
- return iface_cache.get(key, NO_CACHE_ENTRY)
326
+ if not self._is_empty(interface=interface) and (iface_cache := self._value_cache.get(interface)) is not None:
327
+ return iface_cache.get(f"{interface}.{channel_address}.{parameter}", NO_CACHE_ENTRY)
331
328
  return NO_CACHE_ENTRY
332
329
 
333
330
  def clear(self, interface: Interface | None = None) -> None:
@@ -335,7 +332,6 @@ class CentralDataCache:
335
332
  if interface:
336
333
  self._value_cache[interface] = {}
337
334
  self._refreshed_at[interface] = INIT_DATETIME
338
- self._escaped_channel_cache.clear()
339
335
  else:
340
336
  for _interface in self._central.interfaces:
341
337
  self.clear(interface=_interface)
@@ -208,9 +208,15 @@ class DeviceDescriptionCache(BasePersistentCache):
208
208
 
209
209
  def add_device(self, interface_id: str, device_description: DeviceDescription) -> None:
210
210
  """Add a device to the cache."""
211
+ # Fast-path: If the address is not yet known, skip costly removal operations.
212
+ if (address := device_description["ADDRESS"]) not in self._device_descriptions[interface_id]:
213
+ self._raw_device_descriptions[interface_id].append(device_description)
214
+ self._process_device_description(interface_id=interface_id, device_description=device_description)
215
+ return
216
+ # Address exists: remove old entries before adding the new description.
211
217
  self._remove_device(
212
218
  interface_id=interface_id,
213
- addresses_to_remove=[device_description["ADDRESS"]],
219
+ addresses_to_remove=[address],
214
220
  )
215
221
  self._raw_device_descriptions[interface_id].append(device_description)
216
222
  self._process_device_description(interface_id=interface_id, device_description=device_description)
@@ -228,23 +234,22 @@ class DeviceDescriptionCache(BasePersistentCache):
228
234
 
229
235
  def _remove_device(self, interface_id: str, addresses_to_remove: list[str]) -> None:
230
236
  """Remove a device from the cache."""
237
+ # Use a set for faster membership checks
238
+ addresses_set = set(addresses_to_remove)
231
239
  self._raw_device_descriptions[interface_id] = [
232
- device
233
- for device in self._raw_device_descriptions[interface_id]
234
- if device["ADDRESS"] not in addresses_to_remove
240
+ device for device in self._raw_device_descriptions[interface_id] if device["ADDRESS"] not in addresses_set
235
241
  ]
236
- for address in addresses_to_remove:
237
- try:
238
- if ADDRESS_SEPARATOR not in address and self._addresses[interface_id].get(address):
239
- del self._addresses[interface_id][address]
240
- if self._device_descriptions[interface_id].get(address):
241
- del self._device_descriptions[interface_id][address]
242
- except KeyError:
243
- _LOGGER.warning("REMOVE_DEVICE failed: Unable to delete: %s", address)
244
-
245
- def get_addresses(self, interface_id: str) -> tuple[str, ...]:
246
- """Return the addresses by interface."""
247
- return tuple(self._addresses[interface_id].keys())
242
+ addr_map = self._addresses[interface_id]
243
+ desc_map = self._device_descriptions[interface_id]
244
+ for address in addresses_set:
245
+ # Pop with default to avoid KeyError and try/except overhead
246
+ if ADDRESS_SEPARATOR not in address:
247
+ addr_map.pop(address, None)
248
+ desc_map.pop(address, None)
249
+
250
+ def get_addresses(self, interface_id: str) -> frozenset[str]:
251
+ """Return the addresses by interface as a set."""
252
+ return frozenset(self._addresses[interface_id])
248
253
 
249
254
  def get_device_descriptions(self, interface_id: str) -> Mapping[str, DeviceDescription]:
250
255
  """Return the devices by interface."""
@@ -288,9 +293,10 @@ class DeviceDescriptionCache(BasePersistentCache):
288
293
  device_address = get_device_address(address)
289
294
  self._device_descriptions[interface_id][address] = device_description
290
295
 
291
- if device_address not in self._addresses[interface_id][device_address]:
292
- self._addresses[interface_id][device_address].add(device_address)
293
- self._addresses[interface_id][device_address].add(address)
296
+ # Avoid redundant membership checks; set.add is idempotent and cheaper than check+add
297
+ addr_set = self._addresses[interface_id][device_address]
298
+ addr_set.add(device_address)
299
+ addr_set.add(address)
294
300
 
295
301
  async def load(self) -> DataOperationResult:
296
302
  """Load device data from disk into _device_description_cache."""
@@ -420,13 +426,12 @@ class ParamsetDescriptionCache(BasePersistentCache):
420
426
  def _add_address_parameter(self, channel_address: str, paramsets: list[dict[str, Any]]) -> None:
421
427
  """Add address parameter to cache."""
422
428
  device_address, channel_no = get_split_channel_address(channel_address)
429
+ cache = self._address_parameter_cache
423
430
  for paramset in paramsets:
424
431
  if not paramset:
425
432
  continue
426
433
  for parameter in paramset:
427
- if (device_address, parameter) not in self._address_parameter_cache:
428
- self._address_parameter_cache[(device_address, parameter)] = set()
429
- self._address_parameter_cache[(device_address, parameter)].add(channel_no)
434
+ cache.setdefault((device_address, parameter), set()).add(channel_no)
430
435
 
431
436
  async def load(self) -> DataOperationResult:
432
437
  """Load paramset descriptions from disk into paramset cache."""