aiohomematic 2025.10.7__py3-none-any.whl → 2025.10.9__py3-none-any.whl

aiohomematic/{caches → store}/visibility.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """
 Parameter visibility rules and cache for Homematic data points.
 
@@ -8,7 +8,7 @@ ignored, or un‑ignored for channels and devices. It centralizes the rules
 that influence the visibility of data points exposed by the library.
 
 Overview
-- ParameterVisibilityCache: Computes and caches visibility decisions per model,
+- ParameterVisibilityCache: Computes and store visibility decisions per model,
   channel number, paramset and parameter. It consolidates rules from multiple
   sources, such as model‑specific defaults, paramset relevance, hidden lists,
   and explicit un‑ignore directives.
@@ -352,7 +352,7 @@ class ParameterVisibilityCache:
         "_relevant_master_paramsets_by_device",
         "_relevant_prefix_cache",
         "_required_parameters",
-        "_storage_folder",
+        "_storage_directory",
         "_un_ignore_parameters_by_device_paramset_key",
         "_un_ignore_prefix_cache",
     )
@@ -364,7 +364,7 @@ class ParameterVisibilityCache:
     ) -> None:
         """Init the parameter visibility cache."""
         self._central = central
-        self._storage_folder: Final = central.config.storage_folder
+        self._storage_directory: Final = central.config.storage_directory
         self._required_parameters: Final = get_required_parameters()
         self._raw_un_ignores: Final[frozenset[str]] = central.config.un_ignore_list or frozenset()
 

aiohomematic/support.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """
 Helper functions used within aiohomematic.
 
@@ -15,11 +15,13 @@ import contextlib
 from dataclasses import dataclass
 from datetime import datetime
 from functools import lru_cache
+import glob
 import hashlib
 import inspect
 from ipaddress import IPv4Address
 import logging
 import os
+import random
 import re
 import socket
 import ssl
@@ -43,6 +45,7 @@ from aiohomematic.const import (
     NO_CACHE_ENTRY,
     PRIMARY_CLIENT_CANDIDATE_INTERFACES,
     TIMEOUT,
+    UTF_8,
     CommandRxMode,
     DeviceDescription,
     ParamsetKey,
@@ -98,7 +101,7 @@ def check_config(
     host: str,
     username: str,
     password: str,
-    storage_folder: str,
+    storage_directory: str,
     callback_host: str | None,
     callback_port_xml_rpc: int | None,
     json_port: int | None,
@@ -118,7 +121,7 @@ def check_config(
     if not check_password(password=password):
         config_failures.append("Password is not valid")
     try:
-        check_or_create_directory(directory=storage_folder)
+        check_or_create_directory(directory=storage_directory)
     except BaseHomematicException as bhexc:
         config_failures.append(extract_exc_args(exc=bhexc)[0])
     if callback_host and not (is_hostname(hostname=callback_host) or is_ipv4_address(address=callback_host)):
@@ -141,15 +144,12 @@ def has_primary_client(*, interface_configs: AbstractSet[hmcl.InterfaceConfig])
     return False
 
 
-def delete_file(*, folder: str, file_name: str) -> None:
-    """Delete the file."""
-    file_path = os.path.join(folder, file_name)
-    if (
-        os.path.exists(folder)
-        and os.path.exists(file_path)
-        and (os.path.isfile(file_path) or os.path.islink(file_path))
-    ):
-        os.unlink(file_path)
+def delete_file(directory: str, file_name: str) -> None:  # kwonly: disable
+    """Delete the file. File can contain a wildcard."""
+    if os.path.exists(directory):
+        for file_path in glob.glob(os.path.join(directory, file_name)):
+            if os.path.isfile(file_path):
+                os.remove(file_path)
 
 
 def check_or_create_directory(*, directory: str) -> bool:
@@ -526,9 +526,9 @@ def hash_sha256(*, value: Any) -> str:
         data = orjson.dumps(value, option=orjson.OPT_SORT_KEYS | orjson.OPT_NON_STR_KEYS)
     except Exception:
         # Fallback: convert to a hashable representation and use repr()
-        data = repr(_make_value_hashable(value=value)).encode()
+        data = repr(_make_value_hashable(value=value)).encode(encoding=UTF_8)
     hasher.update(data)
-    return base64.b64encode(hasher.digest()).decode()
+    return base64.b64encode(hasher.digest()).decode(encoding=UTF_8)
 
 
 def _make_value_hashable(*, value: Any) -> Any:
@@ -577,6 +577,11 @@ def cleanup_text_from_html_tags(*, text: str) -> str:
     return re.sub(HTMLTAG_PATTERN, "", text)
 
 
+def create_random_device_addresses(*, addresses: list[str]) -> dict[str, str]:
+    """Create a random device address."""
+    return {adr: f"VCU{int(random.randint(1000000, 9999999))}" for adr in addresses}
+
+
 # --- Structured error boundary logging helpers ---
 
 _BOUNDARY_MSG = "error_boundary"
@@ -632,9 +637,7 @@ def log_boundary_error(
         log_message += f" {message}"
 
     if log_context:
-        log_message += (
-            f" ctx={orjson.dumps(_safe_log_context(context=log_context), option=orjson.OPT_SORT_KEYS).decode()}"
-        )
+        log_message += f" ctx={orjson.dumps(_safe_log_context(context=log_context), option=orjson.OPT_SORT_KEYS).decode(encoding=UTF_8)}"
 
     # Choose level if not provided:
     if (chosen_level := level) is None:

aiohomematic/validator.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """
 Validator functions used within aiohomematic.
 

{aiohomematic-2025.10.7.dist-info → aiohomematic-2025.10.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aiohomematic
-Version: 2025.10.7
+Version: 2025.10.9
 Summary: Homematic interface for Home Assistant running on Python 3.
 Home-page: https://github.com/sukramj/aiohomematic
 Author-email: SukramJ <sukramj@icloud.com>, Daniel Perna <danielperna84@gmail.com>

aiohomematic-2025.10.9.dist-info/RECORD

@@ -0,0 +1,78 @@
+aiohomematic/__init__.py,sha256=Uo9CIoil0Arl3GwtgMZAwM8jhcgoBKcZEgj8cXYlswY,2258
+aiohomematic/async_support.py,sha256=01chvt-Ac_UIAWI39VeGpQV9AmxpSCbNyfPPAwX_Qqc,7865
+aiohomematic/const.py,sha256=8Reu1r01pcMN3U5VQLufSJxCcuzhcU1Utn-IKDIKTgE,27124
+aiohomematic/context.py,sha256=hGE-iPcPt21dY-1MZar-Hyh9YaKL-VS42xjrulIVyRQ,429
+aiohomematic/converter.py,sha256=FiHU71M5RZ7N5FXJYh2CN14s63-PM-SHdb0cJ_CLx54,3602
+aiohomematic/decorators.py,sha256=cSW0aF3PzrW_qW6H0sjRNH9eqO8ysqhXZDgJ2OJTZM4,11038
+aiohomematic/exceptions.py,sha256=RLldRD4XY8iYuNYVdspCbbphGcKsximB7R5OL7cYKw0,5006
+aiohomematic/hmcli.py,sha256=_QZFKcfr_KJrdiyBRbhz0f8LZ95glD7LgJBmQc8cwog,4911
+aiohomematic/property_decorators.py,sha256=3Id1_rWIYnwyN_oSMgbh7XNKz9HPkGTC1CeS5ei04ZQ,17139
+aiohomematic/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+aiohomematic/support.py,sha256=R275ZIKoufMZORcBa7Tiq0MZ7KtMZiqoUXUJX4LM1qA,23083
+aiohomematic/validator.py,sha256=qX5janicu4jLrAVzKoyWgXe1XU4EOjk5-QhNFL4awTQ,3541
+aiohomematic/central/__init__.py,sha256=9q1cl0qCVvPSd6eW7ipFdbd783SVLVz1fD_Hh8iDDv8,93519
+aiohomematic/central/decorators.py,sha256=vrujdw2QMXva-7DGXMQyittujx0q7cPuGD-SCeQlD30,6886
+aiohomematic/central/rpc_server.py,sha256=PX6idUEZ5j9fx9y__Q--Zcc2cyFMhLBie-lNvkx1bsI,10949
+aiohomematic/client/__init__.py,sha256=X7lR-A9fAYKbVoR3aNRui_-pfeR20-sehNSlXvkrIoE,73905
+aiohomematic/client/_rpc_errors.py,sha256=IaYjX60mpBJ43gDCJjuUSVraamy5jXHTRjOnutK4azs,2962
+aiohomematic/client/json_rpc.py,sha256=u25nedb3AEK54GN9F4z3oOCfoE-YTYZpL4166OsRPAg,51274
+aiohomematic/client/rpc_proxy.py,sha256=T6tmfBAJJSFxzBLrhKJc6_KiHyTs5EVnStQsVJA5YkY,11604
+aiohomematic/model/__init__.py,sha256=gUYa8ROWSbXjZTWUTmINZ1bbYAxGkVpA-onxaJN2Iso,5436
+aiohomematic/model/data_point.py,sha256=7FqnFO9C0_UtUfwPIsaq61QDhjZqsmjkepzzc_9StUs,41595
+aiohomematic/model/device.py,sha256=CQ_zFRVnwmuEQzBEHlgz3DxFzDnW36FVCPlckmho2TI,52891
+aiohomematic/model/event.py,sha256=uO6Z2pCZEU_8MR8uRIIZjX8IL0rFh7sNhhTNT8yFoVU,6852
+aiohomematic/model/support.py,sha256=ITyxBIJ2Bv69fcwuUD2HyMKlburOnLo9NFs5VKg34ZY,19635
+aiohomematic/model/update.py,sha256=p_zyC73fERQxXF2d1O89zi9EJovzNlrYIONJfPOz5_g,5134
+aiohomematic/model/calculated/__init__.py,sha256=JNtxK4-XZeyR6MxfKVPdcF6ezQliQYTWEDoeOChumaE,2966
+aiohomematic/model/calculated/climate.py,sha256=rm9b4rCrmsZAA5_dzP6YRtahdveI97581_EnC4utqpg,10499
+aiohomematic/model/calculated/data_point.py,sha256=ESUqwolPViXPuH9hvL0q5FMvsGXjcqxeyySpNTUAMU8,11587
+aiohomematic/model/calculated/operating_voltage_level.py,sha256=99A8HvahVS4IxpgK1dsgQXHfeubU7JI2c0ObagbnSNQ,13505
+aiohomematic/model/calculated/support.py,sha256=GBD35_OR3TEAWo5ADeH_gk2Ebw9pHOtOnOS7umCkXB0,7989
+aiohomematic/model/custom/__init__.py,sha256=JxJXyr2CgKlj-jc1xQ14lbMT76vvswfLUecwj8RJCXA,6073
+aiohomematic/model/custom/climate.py,sha256=5r0zjBOhnp4QcL2p6x2UYhIMQqa0SG1Sw1cnnyY9POs,57274
+aiohomematic/model/custom/const.py,sha256=s4iqhwvt8x41h4-CtMCyXwryGHuBNbhBrcJ5zGVRFJU,4939
+aiohomematic/model/custom/cover.py,sha256=KQzLEoPkKgZ2oi2oblUrGReQnT_0WAuseWAxu_xH5_Y,29035
+aiohomematic/model/custom/data_point.py,sha256=WLKygP3SQwtG35BpOH3HNt_o-z9dfSUmuSyPDIEWF8A,14133
+aiohomematic/model/custom/definition.py,sha256=miZssuy1u5EcQ4opOWo9n0Eko-2aIK9f3MAKYiMmJb8,35640
+aiohomematic/model/custom/light.py,sha256=JC7GeU87gObBN0b1fCjm0VzgCtoytWsmq2Sd-fQqBGM,44426
+aiohomematic/model/custom/lock.py,sha256=iJY8jiJA_HRynpbeACEQ_kzwiXOfAaT2IcF1FbXc0xY,11974
+aiohomematic/model/custom/siren.py,sha256=iaCJuRWiQH-r_ckhPZGRfmzxI8PddBBA5z_Jo78f1qI,9763
+aiohomematic/model/custom/support.py,sha256=FPhC3kp7blJu4jWHWAmXUXv4JWJu5nhQkrr8dyYxFas,1431
+aiohomematic/model/custom/switch.py,sha256=u4zbda4MFz_rmyuIvTgQC6Gi1XDWvX5EsOhP2NiQy38,6941
+aiohomematic/model/custom/valve.py,sha256=K42YSlG6610reWo3S6lo070WvEN2InVA8MsMpXltRLs,4220
+aiohomematic/model/generic/__init__.py,sha256=-4yben7G-QKBWMWpusrLkGo65a4IXIPYoiGu49T_KMM,7653
+aiohomematic/model/generic/action.py,sha256=VDFCAkX0TkXV4xh3ya0AUIKnjOKF_rEobI6qdW5mAOQ,975
+aiohomematic/model/generic/binary_sensor.py,sha256=yABUafcBmPHLNAkdj_malYroBZc5UaunYLhmRtS2nGU,865
+aiohomematic/model/generic/button.py,sha256=3ahmj1BJZfdh6h6YV-urC8UwcKRp94QPOQtsF0fBI3Y,718
+aiohomematic/model/generic/data_point.py,sha256=P89BuRm8pWUBvCeR8XVHE2A1SqYb53REJCCOUnoKN34,6062
+aiohomematic/model/generic/number.py,sha256=WNu4EB_npDZ8f7RrCrab1g9KzRtG8dziUvNQApEKXYk,2656
+aiohomematic/model/generic/select.py,sha256=-CXHdvzwWGp74t5UVdIWOFhlcW7bf0hcuGriBl7EWXk,1516
+aiohomematic/model/generic/sensor.py,sha256=ueqXw9bkFFJeD_mer6idpMTGFg6rweDEUNOgqsF22NA,2240
+aiohomematic/model/generic/switch.py,sha256=Y5Bml60QoHs14mfsMvhsk7S7I-2QSBoB7KWHMCJak3Q,1820
+aiohomematic/model/generic/text.py,sha256=AOMZCHgPO2v4lza-OI0J6WNsQcUOvab9HA5sRN8NQZQ,832
+aiohomematic/model/hub/__init__.py,sha256=qQkjMYd9-xE5iWvN-sMTcDvHIghz7g0z7u2ja73vaKQ,13503
+aiohomematic/model/hub/binary_sensor.py,sha256=yqBXEzVS7zMoY4N7agwQ70ypAgIRkfUeBNCInsQV_kA,730
+aiohomematic/model/hub/button.py,sha256=fEtBIxKF32kyacaCgsDLohw1exDpFtE7SCwEYgBAlOY,868
+aiohomematic/model/hub/data_point.py,sha256=7AKkZM4cpO3qhVF5rKPs25H2JKGjHQlHd-wJdf73Wcg,10631
+aiohomematic/model/hub/number.py,sha256=zS5ft2wkUUJ0NkUlhkWvbXCeMcI9v-gH36NVCdrNtcU,1215
+aiohomematic/model/hub/select.py,sha256=ENF1TMk5jrNbk7lspNTfWIROMifjJMrllnu6htM1C2E,1652
+aiohomematic/model/hub/sensor.py,sha256=F--BHrgziizBOkXTupwV0ZZlzNnjsWrL9qnkHQv-lEE,1170
+aiohomematic/model/hub/switch.py,sha256=sllPvUy4NggktWjUqobDRZLSTJa2OX88WE1M8wlGmr8,1368
+aiohomematic/model/hub/text.py,sha256=JSCpC37sVm4TbjJCd0vaqybHVuCz1ctNHXEyJnmmMVs,977
+aiohomematic/rega_scripts/fetch_all_device_data.fn,sha256=7uxhHoelAOsH6yYr1n1M1XwIRgDmItiHnWIMhDYEimk,4373
+aiohomematic/rega_scripts/get_program_descriptions.fn,sha256=pGmj377MkqbZi6j-UBKQAsXTphwh1kDwDKqXij8zUBE,835
+aiohomematic/rega_scripts/get_serial.fn,sha256=t1oeo-sB_EuVeiY24PLcxFSkdQVgEWGXzpemJQZFybY,1079
+aiohomematic/rega_scripts/get_system_variable_descriptions.fn,sha256=UKXvC0_5lSApdQ2atJc0E5Stj5Zt3lqh0EcliokYu2c,849
+aiohomematic/rega_scripts/set_program_state.fn,sha256=0bnv7lUj8FMjDZBz325tDVP61m04cHjVj4kIOnUUgpY,279
+aiohomematic/rega_scripts/set_system_variable.fn,sha256=sTmr7vkPTPnPkor5cnLKlDvfsYRbGO1iq2z_2pMXq5E,383
+aiohomematic/store/__init__.py,sha256=PHwF_tw_zL20ODwLywHgpOLWrghQo_BMZzeiQSXN1Fc,1081
+aiohomematic/store/dynamic.py,sha256=kgZs5gJ4i8bHZKkJ883xuLecSKdjj6UwlLRJAvQcNGI,22528
+aiohomematic/store/persistent.py,sha256=yRrGgCLGQtuUAKg37UeLDnp0HcnZjl9DordbjJukLCA,38066
+aiohomematic/store/visibility.py,sha256=0y93kPTugqQsrh6kKamfgwBkbIdBPEZpQVv_1NaLz3A,31662
+aiohomematic-2025.10.9.dist-info/licenses/LICENSE,sha256=q-B0xpREuZuvKsmk3_iyVZqvZ-vJcWmzMZpeAd0RqtQ,1083
+aiohomematic_support/__init__.py,sha256=_0YtF4lTdC_k6-zrM2IefI0u0LMr_WA61gXAyeGLgbY,66
+aiohomematic_support/client_local.py,sha256=GAIg3DN4lD4H9eA3gs_CILtWR3tphXrf_Hai9rWFpM8,12817
+aiohomematic-2025.10.9.dist-info/METADATA,sha256=ezEHtzT_d_BJhX-cCb920mQK5ED0UmvdNsqAoGJrELw,7603
+aiohomematic-2025.10.9.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+aiohomematic-2025.10.9.dist-info/top_level.txt,sha256=5TDRlUWQPThIUwQjOj--aUo4UA-ow4m0sNhnoCBi5n8,34
+aiohomematic-2025.10.9.dist-info/RECORD,,

aiohomematic_support/client_local.py

@@ -12,7 +12,7 @@ from typing import Any, Final, cast
 
 import orjson
 
-from aiohomematic.client import _LOGGER, Client, _ClientConfig
+from aiohomematic.client import _LOGGER, Client, ClientConfig
 from aiohomematic.const import (
     ADDRESS_SEPARATOR,
     DP_KEY_VALUE,
@@ -41,7 +41,7 @@ BACKEND_LOCAL: Final = "PyDevCCU"
 class ClientLocal(Client):  # pragma: no cover
     """Local client object to provide access to locally stored files."""
 
-    def __init__(self, *, client_config: _ClientConfig, local_resources: LocalRessources) -> None:
+    def __init__(self, *, client_config: ClientConfig, local_resources: LocalRessources) -> None:
         """Initialize the Client."""
         super().__init__(client_config=client_config)
         self._local_resources = local_resources

aiohomematic/caches/__init__.py

@@ -1,12 +0,0 @@
-# SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
-"""
-Cache packages for AioHomematic.
-
-This package groups cache implementations used throughout the library:
-- persistent: Long-lived on-disk caches for device and paramset descriptions.
-- dynamic: Short-lived in-memory caches for runtime values and connection health.
-- visibility: Parameter visibility rules to decide which parameters are relevant.
-"""
-
-from __future__ import annotations