aiohomematic 2025.9.1__py3-none-any.whl → 2025.9.3__py3-none-any.whl

aiohomematic/support.py

@@ -49,6 +49,12 @@ from aiohomematic.const import (
     SysvarType,
 )
 from aiohomematic.exceptions import AioHomematicException, BaseHomematicException
+from aiohomematic.property_decorators import (
+    Kind,
+    cached_property,
+    get_hm_property_by_kind,
+    get_hm_property_by_log_context,
+)
 
 _LOGGER: Final = logging.getLogger(__name__)
 
@@ -465,13 +471,13 @@ def hash_sha256(value: Any) -> str:
 
 def _make_value_hashable(value: Any) -> Any:
     """Make a hashable object."""
-    if isinstance(value, (tuple, list)):
+    if isinstance(value, tuple | list):
         return tuple(_make_value_hashable(e) for e in value)
 
     if isinstance(value, dict):
         return tuple(sorted((k, _make_value_hashable(v)) for k, v in value.items()))
 
-    if isinstance(value, (set, frozenset)):
+    if isinstance(value, set | frozenset):
         return tuple(sorted(_make_value_hashable(e) for e in value))
 
     return value
@@ -514,7 +520,7 @@ def cleanup_text_from_html_tags(text: str) -> str:
 _BOUNDARY_MSG = "error_boundary"
 
 
-def _safe_context(context: Mapping[str, Any] | None) -> dict[str, Any]:
+def _safe_log_context(context: Mapping[str, Any] | None) -> dict[str, Any]:
     """Extract safe context from a mapping."""
     ctx: dict[str, Any] = {}
     if not context:
@@ -534,57 +540,6 @@ def _safe_context(context: Mapping[str, Any] | None) -> dict[str, Any]:
     return ctx
 
 
-def build_log_context_from_obj(obj: Any | None) -> dict[str, Any]:
-    """
-    Extract structured context like device_id/channel/parameter from common objects.
-
-    Tries best-effort extraction without raising. Returns a dict suitable for logger.extra.
-    """
-    ctx: dict[str, Any] = {}
-    if obj is None:
-        return ctx
-    try:
-        # DataPoint-like: has channel and parameter
-        if hasattr(obj, "channel"):
-            ch = getattr(obj, "channel")
-            try:
-                # channel address/id
-                channel_address = ch.address if not callable(ch.address) else ch.address()
-                ctx["channel"] = channel_address
-            except Exception:
-                # Fallback to str
-                ctx["channel"] = str(ch)
-            try:
-                if (dev := ch.device if hasattr(ch, "device") else None) is not None:
-                    device_id = dev.id if not callable(dev.id) else dev.id()
-                    ctx["device_id"] = device_id
-            except Exception:
-                pass
-        # Parameter on DataPoint-like
-        if hasattr(obj, "parameter"):
-            with contextlib.suppress(Exception):
-                ctx["parameter"] = getattr(obj, "parameter")
-
-        # Also support objects exposing address directly
-        if "device_id" not in ctx and hasattr(obj, "device"):
-            dev = getattr(obj, "device")
-            try:
-                device_id = dev.id if not callable(dev.id) else dev.id()
-                ctx["device_id"] = device_id
-            except Exception:
-                pass
-        if "channel" not in ctx and hasattr(obj, "address"):
-            try:
-                addr = obj.address if not callable(obj.address) else obj.address()
-                ctx["channel"] = addr
-            except Exception:
-                pass
-    except Exception:
-        # Never allow context building to break the application
-        return {}
-    return ctx
-
-
 def log_boundary_error(
     logger: logging.Logger,
     *,
@@ -592,7 +547,8 @@ def log_boundary_error(
     action: str,
     err: Exception,
     level: int | None = None,
-    context: Mapping[str, Any] | None = None,
+    log_context: Mapping[str, Any] | None = None,
+    message: str | None = None,
 ) -> None:
     """
     Log a boundary error with the provided logger.
@@ -602,42 +558,72 @@ def log_boundary_error(
     logging level if not explicitly provided. Additionally, it enriches the log
     record with extra context about the error and action boundaries.
 
-    :param logger: The logger instance used to log the error.
-    :type logger: logging.Logger
-    :param boundary: The name of the boundary at which the error occurred.
-    :type boundary: str
-    :param action: The action being performed when the error occurred.
-    :type action: str
-    :param err: The exception instance representing the error to log.
-    :type err: Exception
-    :param level: The optional logging level. Defaults to WARNING for recoverable
-        domain errors and ERROR for non-recoverable errors if not provided.
-    :type level: int | None
-    :param context: Optional mapping of additional information or context to
-        include in the log record.
-    :type context: Mapping[str, Any] | None
-    :return: None. This function logs the provided information but does not
-        return a value.
-    :rtype: None
     """
-    extra = {
-        "boundary": boundary,
-        "action": action,
-        "err_type": err.__class__.__name__,
-        "err": extract_exc_args(exc=err),
-        **_safe_context(context),
-    }
+    err_name = err.__class__.__name__
+    log_message = f"[boundary={boundary} action={action} err={err_name}"
+
+    if (err_args := extract_exc_args(exc=err)) and err_args != err_name:
+        log_message += f": {err_args}"
+    log_message += "]"
+
+    if message:
+        log_message += f" {message}"
+
+    if log_context:
+        log_message += f" ctx={orjson.dumps(_safe_log_context(log_context), option=orjson.OPT_SORT_KEYS).decode()}"
 
     # Choose level if not provided:
-    chosen_level = level
-    if chosen_level is None:
+    if (chosen_level := level) is None:
         # Use WARNING for expected/recoverable domain errors, ERROR otherwise.
         chosen_level = logging.WARNING if isinstance(err, BaseHomematicException) else logging.ERROR
 
-    if chosen_level >= logging.ERROR:
-        logger.exception(_BOUNDARY_MSG, extra=extra)
-    else:
-        logger.log(chosen_level, _BOUNDARY_MSG, extra=extra)
+    logger.log(chosen_level, log_message)
+
+
+class LogContextMixin:
+    """Mixin to add log context methods to class."""
+
+    __slots__ = ("_cached_log_context",)
+
+    @cached_property
+    def log_context(self) -> Mapping[str, Any]:
+        """Return the log context for this object."""
+        return {
+            key: value for key, value in get_hm_property_by_log_context(data_object=self).items() if value is not None
+        }
+
+
+class PayloadMixin:
+    """Mixin to add payload methods to class."""
+
+    __slots__ = ()
+
+    @property
+    def config_payload(self) -> Mapping[str, Any]:
+        """Return the config payload."""
+        return {
+            key: value
+            for key, value in get_hm_property_by_kind(data_object=self, kind=Kind.CONFIG).items()
+            if value is not None
+        }
+
+    @property
+    def info_payload(self) -> Mapping[str, Any]:
+        """Return the info payload."""
+        return {
+            key: value
+            for key, value in get_hm_property_by_kind(data_object=self, kind=Kind.INFO).items()
+            if value is not None
+        }
+
+    @property
+    def state_payload(self) -> Mapping[str, Any]:
+        """Return the state payload."""
+        return {
+            key: value
+            for key, value in get_hm_property_by_kind(data_object=self, kind=Kind.STATE).items()
+            if value is not None
+        }
 
 
 # Define public API for this module

{aiohomematic-2025.9.1.dist-info → aiohomematic-2025.9.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aiohomematic
-Version: 2025.9.1
+Version: 2025.9.3
 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>
@@ -52,7 +52,7 @@ Unlike pyhomematic, which required manual device mappings, aiohomematic automati
 Use the Home Assistant custom integration "Homematic(IP) Local", which is powered by aiohomematic.
 
 1. Prerequisites
-   - Home Assistant 2024.6 or newer recommended.
+   - Use latest version of Home Assistant.
    - A CCU3, RaspberryMatic, or Homegear instance reachable from Home Assistant.
    - For HomematicIP devices, ensure CCU firmware meets the minimum versions listed below.
 2. Install the integration
@@ -60,11 +60,11 @@ Use the Home Assistant custom integration "Homematic(IP) Local", which is powere
    - Follow the installation guide: https://github.com/sukramj/homematicip_local/wiki/Installation
 3. Configure via Home Assistant UI
    - In Home Assistant: Settings → Devices & Services → Add Integration → search for "Homematic(IP) Local".
-   - Enter the CCU/Homegear host (IP or hostname). If you use HTTPS on the CCU, enable SSL and accept the certificate if self‑signed.
-   - Provide credentials if your CCU requires them.
+   - Enter the CCU/Homegear host (IP or hostname). If you use HTTPS on the CCU, enable TLS and don't use verify if self‑signed.
+   - Always enter credentials.
    - Choose which interfaces to enable (HM, HmIP, Virtual). Default ports are typically 2001 (HM), 2010 (HmIP), 9292 (Virtual).
 4. Network callbacks
-   - The integration needs to receive XML‑RPC callbacks from the CCU. Make sure Home Assistant is reachable from the CCU (no NAT/firewall blocking). The default callback port is 43439; you can adjust it in advanced options.
+   - The integration needs to receive XML‑RPC callbacks from the CCU. Make sure Home Assistant is reachable from the CCU (no NAT/firewall blocking). Callbacks ar only required for special network setups.
 5. Verify
    - After setup, devices should appear under Devices & Services → Homematic(IP) Local. Discovery may take a few seconds after the first connection while paramsets are fetched and cached for faster restarts.
 
@@ -84,10 +84,12 @@ See details here: https://github.com/jens-maus/RaspberryMatic/issues/843. Other
 - The public API of aiohomematic is explicitly defined via **all** in each module and subpackage.
 - Backwards‑compatible imports should target these modules:
   - aiohomematic.central: CentralUnit, CentralConfig and related schemas
+  - aiohomematic.central.event: display received events from the backend
   - aiohomematic.client: Client, InterfaceConfig, create_client, get_client
   - aiohomematic.model: device/data point abstractions (see subpackages for details)
   - aiohomematic.exceptions: library exception types intended for consumers
   - aiohomematic.const: constants and enums (stable subset; see module **all**)
+  - aiohomematic.performance: display some performance metrics (enabled when DEBUG is enabled)
 - The top‑level package only exposes **version** to avoid import cycles and keep startup lean. Prefer importing from the specific submodules listed above.
 
 Example:

aiohomematic-2025.9.3.dist-info/RECORD

@@ -0,0 +1,78 @@
+aiohomematic/__init__.py,sha256=VPESkjzeVserFI2DDVAxD782cgYRlLK0sXJzLrr3e_k,2283
+aiohomematic/async_support.py,sha256=Xc55KkIV0h8rf936QKyU4OHSZsPEZ8TwuV8gVveeRh8,6106
+aiohomematic/const.py,sha256=U6GjonNWYX6PLDyzMZqVeYsrVPgG7QqoBhVjRec0Xwk,25411
+aiohomematic/context.py,sha256=M7gkA7KFT0dp35gzGz2dzKVXu1PP0sAnepgLlmjyRS4,451
+aiohomematic/converter.py,sha256=QTOL8_B6SoCoqLuRSkjtOlfa7BVFSvOfnSBrDngiinA,3558
+aiohomematic/decorators.py,sha256=oHEFSJoJVd-h9RYb6NLTJ60erkpRHPYv7EEipKn1a9Q,10636
+aiohomematic/exceptions.py,sha256=o_H3Z0A2TQ0irNxUM9u8bmivq0L_mwPCB7nhxEawDxE,5018
+aiohomematic/hmcli.py,sha256=wHOLq4IJRSY9RJux_ZfDH1gQ1ZqD0k68ua5agyBkkE8,4933
+aiohomematic/property_decorators.py,sha256=fDuh3sydnlc-8R1gJAh-9ZxW4jApkk-LohA2Rqk-qPI,17609
+aiohomematic/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+aiohomematic/support.py,sha256=THiA1zqOSVkR6rnPTdNpRZkdEhGgEiP-jtgTU68tEwE,20331
+aiohomematic/validator.py,sha256=vChkYQ9dGKCQEigiBMnoeyPkCJDJlIm6DSgR1gmeHH0,3545
+aiohomematic/caches/__init__.py,sha256=_gI30tbsWgPRaHvP6cRxOQr6n9bYZzU-jp1WbHhWg-A,470
+aiohomematic/caches/dynamic.py,sha256=Kp0bL5JZaPGGfsezuBX3VtADhEcUvu93AEB5j2rgzzY,21326
+aiohomematic/caches/persistent.py,sha256=YBThIByt0mLQCgcZwBBmqanI8obAhHNcFULz_H-de8o,19932
+aiohomematic/caches/visibility.py,sha256=uZ1sSCfmEQURllPvSbJ3EzFVFE7TU8XcxMDSHRpNmMs,31481
+aiohomematic/central/__init__.py,sha256=y8JErLEY4zh8qsGyS1qMQPaPlQn3GEx6q5_L4OvqxlQ,86148
+aiohomematic/central/decorators.py,sha256=Sl-cMDhreiAOKkIHiei-QbIOcvbWGVX-QwB5bLeohak,6904
+aiohomematic/central/xml_rpc_server.py,sha256=DZcE3t_KWgJyQJM5Z9_yPO4s075DRJmnIdkIx0OTL9M,10549
+aiohomematic/client/__init__.py,sha256=6ik0d9VPcwBguL31zdKw_2Zslkra4rnTmwH_sY7oWXo,69964
+aiohomematic/client/_rpc_errors.py,sha256=vu76ZWMwJJEgB0cnXc10JzK8PaiRU7jYOvj1aC21CqE,2971
+aiohomematic/client/json_rpc.py,sha256=MR7lpxd3UddNuUojWh8-CZkxVY8_jUPhLXkDQeIXbfA,49307
+aiohomematic/client/xml_rpc.py,sha256=pTnLjY81bJd8goD_zAkSEE7Q_UTKwBmiiyLOwJ1DOMs,9640
+aiohomematic/model/__init__.py,sha256=LBKHws0W-zgFywTsWfklVVCxrO0w6QUY9ptT6LKxJls,5457
+aiohomematic/model/data_point.py,sha256=Mls6b20e_fzYhB3EPYab0tocRqbl-v5ityV6uKTBOnU,40837
+aiohomematic/model/device.py,sha256=JNRY7mEIZjwdvDnt-kV95QOjWVLrny-PnamitQqjZ-w,52136
+aiohomematic/model/event.py,sha256=EMoKjbOZRXD3jumRrSlSoUr3nZ2QM3GDKKFfhlf-D50,6837
+aiohomematic/model/support.py,sha256=4VQsOlkJuPhq0hLHKt5LB43YgbITjnyJMwucUYGghzM,19616
+aiohomematic/model/update.py,sha256=QVYFhaEqtHZhZ8yGPXEx2hPMne8WAc_SkVaQ0J20oQw,5138
+aiohomematic/model/calculated/__init__.py,sha256=pk56FYa0MNyN0MTsejSy6RdQjOUCKAqzwWSzN6_ENmk,2808
+aiohomematic/model/calculated/climate.py,sha256=0BhrsiVS74_6jo24I8Cg9WzVAD5od3IqgiwTM0ao2n0,8518
+aiohomematic/model/calculated/data_point.py,sha256=Bnv2R9ViFf48C7-BjmJh6999EcWZdJxYZfLpBg57oQg,11525
+aiohomematic/model/calculated/operating_voltage_level.py,sha256=urlCkHjisCJ-DO6tUE0evfp45tPwsYcb81_2uoHYxS0,13521
+aiohomematic/model/calculated/support.py,sha256=K-oUSSH6k6_J7zZ9cwxt6qIfArWd-SBWo93LuZUs1_s,6674
+aiohomematic/model/custom/__init__.py,sha256=1sWRrAjHnHSakdrrlNW4_SZ2rg5g2WjGdI4X2PUg_h0,6064
+aiohomematic/model/custom/climate.py,sha256=utcyx2cWOK-jYz-EWQlCD9tjBsl_uDk77Fzt9kIcdXc,53987
+aiohomematic/model/custom/const.py,sha256=Kh1pnab6nmwbaY43CfXQy3yrWpPwsrQdl1Ea2aZ6aw0,4961
+aiohomematic/model/custom/cover.py,sha256=xaU-MfgpnG3Zkdb20BIDUezbvh3rI3HpM0sBg6IcX90,28555
+aiohomematic/model/custom/data_point.py,sha256=d7B8gfyDDZf8HW3f0ofeHYF32GE8kgnQ0DZYSUbLHxY,14112
+aiohomematic/model/custom/definition.py,sha256=1GkUyEsmjJfAdrBCW1ZBmboYZOyb00MctUE_xn4Zyl8,35481
+aiohomematic/model/custom/light.py,sha256=8ourpK9U89a3nVp0_WZBTPl3TK9km9fir7W23Q9c4Ns,44173
+aiohomematic/model/custom/lock.py,sha256=5G5BsQFHbYul-_FQwFWDq9E3o8RL54FjJm0yfnIMejc,11940
+aiohomematic/model/custom/siren.py,sha256=O9SnAsR8E04d46O-Ahx_xRK4XwYQ_pk5BLpufCQ9BTc,9729
+aiohomematic/model/custom/support.py,sha256=UvencsvCwgpm4iqRNRt5KRs560tyw1NhYP5ZaqmCT2k,1453
+aiohomematic/model/custom/switch.py,sha256=sFBt0orv9NeWEkUqjGvc5g5COVQU239u2_9XxnSNGSs,6872
+aiohomematic/model/custom/valve.py,sha256=XTjs0yqLvqjYEk2SS2SH4UGCMJOuqNgMd43TfQPKa2s,4229
+aiohomematic/model/generic/__init__.py,sha256=goR2uBBGizm-A5Vvd7ii9Ai3OihBl3hIztmAEI3ceVQ,7611
+aiohomematic/model/generic/action.py,sha256=5SPWVliRqXlPgtb2bI6le0-V6JR5krzw8z_0FaOXu5U,994
+aiohomematic/model/generic/binary_sensor.py,sha256=U5GvfRYbhwe0jRmaedD4LVZ_24SyyPbVr74HEfZXoxE,887
+aiohomematic/model/generic/button.py,sha256=6jZ49woI9gYJEx__PjguDNbc5vdE1P-YcLMZZFkYRCg,740
+aiohomematic/model/generic/data_point.py,sha256=wlPQQjm3YDQRbSONpSyzLVWeivVHdkoo1lLxRE7AAWE,5923
+aiohomematic/model/generic/number.py,sha256=wHNIIVr41IOoROPOnBXuMRsANG6doguIEWXYnQHJbBk,2669
+aiohomematic/model/generic/select.py,sha256=kxN5BR85Yli7kQF2DYkGiLnTgcY9LBJWI7MMwWpH1mo,1535
+aiohomematic/model/generic/sensor.py,sha256=dWff7yBJfJSjoD4rcYdmH5HhaRCUEKfPFfOu4T1LrPo,2253
+aiohomematic/model/generic/switch.py,sha256=oaXhECjSPT1WUdItEFTEbOLNCFZlaaqYByEHtL3GpTY,1833
+aiohomematic/model/generic/text.py,sha256=vtNV7YxZuxF6LzNRKRAeOtSQtPQxPaEd560OFaVR13U,854
+aiohomematic/model/hub/__init__.py,sha256=_UEEiNHfUVb0D0qTMcR2_YH1ZcYu1jzgLnUApPWfT2k,13493
+aiohomematic/model/hub/binary_sensor.py,sha256=Z4o-zghHSc83ZHUUCtHqWEGueD9K1Fe0JEt_xJNdx_Y,752
+aiohomematic/model/hub/button.py,sha256=XO4ied740BDOXBfTxFW30ROdZiOOxxu05Rmt4b_h06k,890
+aiohomematic/model/hub/data_point.py,sha256=H_3REBK2lvoqITvqvupvg_ZnkcdxAIu_Qu8o0Wgc2Ds,10555
+aiohomematic/model/hub/number.py,sha256=O5KrBU4nfZaxw2Pi2AmWAwQo8V_x79xrdt8ukoPme5Q,1222
+aiohomematic/model/hub/select.py,sha256=My6flvM7Lmt5hF-Szx4a4X1KZZPkQ5lCVPCXTLuqBbQ,1659
+aiohomematic/model/hub/sensor.py,sha256=cIr-7bsbOLBxnH33EHQ6D42vc61abO4QYLWLzkm1T10,1192
+aiohomematic/model/hub/switch.py,sha256=510Vrlyak5TRsMvURrGYMkad-CbGUKWh20jjHQGOios,1390
+aiohomematic/model/hub/text.py,sha256=bSNq4rgv2AIXELz-4HsaY-IMTYQYKsa-UX2aIwWle34,990
+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-2025.9.3.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=4p0-PagFeNgu-r0EjhpHWfImgHMrdSgt8VUMBBC66J0,12514
+aiohomematic-2025.9.3.dist-info/METADATA,sha256=vI27ZQjSHKOzV8Qs8e-W7Gk1iHhAG-qLk-W234XkXZo,7075
+aiohomematic-2025.9.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+aiohomematic-2025.9.3.dist-info/top_level.txt,sha256=5TDRlUWQPThIUwQjOj--aUo4UA-ow4m0sNhnoCBi5n8,34
+aiohomematic-2025.9.3.dist-info/RECORD,,

aiohomematic_support/client_local.py

@@ -126,12 +126,12 @@ class ClientLocal(Client):  # pragma: no cover
             self._ping_pong_cache.handle_send_ping(ping_ts=datetime.now())
         return True
 
-    @inspector()
+    @inspector
     async def execute_program(self, pid: str) -> bool:
         """Execute a program on CCU / Homegear."""
         return True
 
-    @inspector()
+    @inspector
     async def set_program_state(self, pid: str, state: bool) -> bool:
         """Set the program state on CCU / Homegear."""
         return True
@@ -141,12 +141,12 @@ class ClientLocal(Client):  # pragma: no cover
         """Set a system variable on CCU / Homegear."""
         return True
 
-    @inspector()
+    @inspector
     async def delete_system_variable(self, name: str) -> bool:
         """Delete a system variable from CCU / Homegear."""
         return True
 
-    @inspector()
+    @inspector
     async def get_system_variable(self, name: str) -> str:
         """Get single system variable from CCU / Homegear."""
         return "Empty"
@@ -231,7 +231,7 @@ class ClientLocal(Client):  # pragma: no cover
         await self.central.data_point_event(self.interface_id, channel_address, parameter, value)
         return result
 
-    @inspector()
+    @inspector
     async def get_paramset(
         self,
         address: str,

aiohomematic/model/decorators.py

@@ -1,194 +0,0 @@
-# SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
-"""Decorators for data points used within aiohomematic."""
-
-from __future__ import annotations
-
-from collections.abc import Callable, Mapping
-from datetime import datetime
-from enum import Enum
-from typing import Any, ParamSpec, TypeVar, cast
-from weakref import WeakKeyDictionary
-
-__all__ = [
-    "config_property",
-    "get_public_attributes_for_config_property",
-    "get_public_attributes_for_info_property",
-    "get_public_attributes_for_state_property",
-    "info_property",
-    "state_property",
-]
-
-P = ParamSpec("P")
-T = TypeVar("T")
-
-
-# pylint: disable=invalid-name
-class generic_property[GETTER, SETTER](property):
-    """Generic property implementation."""
-
-    fget: Callable[[Any], GETTER] | None
-    fset: Callable[[Any, SETTER], None] | None
-    fdel: Callable[[Any], None] | None
-
-    def __init__(
-        self,
-        fget: Callable[[Any], GETTER] | None = None,
-        fset: Callable[[Any, SETTER], None] | None = None,
-        fdel: Callable[[Any], None] | None = None,
-        doc: str | None = None,
-    ) -> None:
-        """Init the generic property."""
-        super().__init__(fget, fset, fdel, doc)
-        if doc is None and fget is not None:
-            doc = fget.__doc__
-        self.__doc__ = doc
-
-    def getter(self, fget: Callable[[Any], GETTER], /) -> generic_property:
-        """Return generic getter."""
-        return type(self)(fget, self.fset, self.fdel, self.__doc__)  # pragma: no cover
-
-    def setter(self, fset: Callable[[Any, SETTER], None], /) -> generic_property:
-        """Return generic setter."""
-        return type(self)(self.fget, fset, self.fdel, self.__doc__)
-
-    def deleter(self, fdel: Callable[[Any], None], /) -> generic_property:
-        """Return generic deleter."""
-        return type(self)(self.fget, self.fset, fdel, self.__doc__)
-
-    def __get__(self, obj: Any, gtype: type | None = None, /) -> GETTER:  # type: ignore[override]
-        """Return the attribute."""
-        if obj is None:
-            return self  # type: ignore[return-value]
-        if self.fget is None:
-            raise AttributeError("unreadable attribute")  # pragma: no cover
-        return self.fget(obj)
-
-    def __set__(self, obj: Any, value: Any, /) -> None:
-        """Set the attribute."""
-        if self.fset is None:
-            raise AttributeError("can't set attribute")  # pragma: no cover
-        self.fset(obj, value)
-
-    def __delete__(self, obj: Any, /) -> None:
-        """Delete the attribute."""
-        if self.fdel is None:
-            raise AttributeError("can't delete attribute")  # pragma: no cover
-        self.fdel(obj)
-
-
-# pylint: disable=invalid-name
-class config_property[GETTER, SETTER](generic_property[GETTER, SETTER]):
-    """Decorate to mark own config properties."""
-
-
-# pylint: disable=invalid-name
-class info_property[GETTER, SETTER](generic_property[GETTER, SETTER]):
-    """Decorate to mark own info properties."""
-
-
-# pylint: disable=invalid-name
-class state_property[GETTER, SETTER](generic_property[GETTER, SETTER]):
-    """Decorate to mark own value properties."""
-
-
-# Cache for per-class attribute names by decorator to avoid repeated dir() scans
-# Use WeakKeyDictionary to allow classes to be garbage-collected without leaking cache entries.
-# Structure: {cls: {decorator_class: (attr_name1, attr_name2, ...)}}
-_PUBLIC_ATTR_CACHE: WeakKeyDictionary[type, dict[type, tuple[str, ...]]] = WeakKeyDictionary()
-
-
-def _get_public_attributes_by_class_decorator(data_object: Any, class_decorator: type) -> Mapping[str, Any]:
-    """
-    Return the object attributes by decorator.
-
-    This caches the attribute names per (class, decorator) to reduce overhead
-    from repeated dir()/getattr() scans. Values are not cached as they are
-    instance-dependent and may change over time.
-
-    To minimize side effects, exceptions raised by property getters are caught
-    and the corresponding value is set to None. This ensures that payload
-    construction and attribute introspection do not fail due to individual
-    properties with transient errors or expensive side effects.
-    """
-    cls = data_object.__class__
-
-    # Get or create the per-class cache dict
-    if (decorator_cache := _PUBLIC_ATTR_CACHE.get(cls)) is None:
-        decorator_cache = {}
-        _PUBLIC_ATTR_CACHE[cls] = decorator_cache
-
-    # Get or compute the attribute names for this decorator
-    if (names := decorator_cache.get(class_decorator)) is None:
-        names = tuple(y for y in dir(cls) if not y.startswith("_") and isinstance(getattr(cls, y), class_decorator))
-        decorator_cache[class_decorator] = names
-
-    result: dict[str, Any] = {}
-    for name in names:
-        try:
-            value = getattr(data_object, name)
-        except Exception:
-            # Avoid propagating side effects/errors from getters
-            value = None
-        result[name] = _get_text_value(value)
-    return result
-
-
-def _get_text_value(value: Any) -> Any:
-    """Convert value to text."""
-    if isinstance(value, (list, tuple, set)):
-        return tuple(_get_text_value(v) for v in value)
-    if isinstance(value, Enum):
-        return str(value)
-    if isinstance(value, datetime):
-        return datetime.timestamp(value)
-    return value
-
-
-def get_public_attributes_for_config_property(data_object: Any) -> Mapping[str, Any]:
-    """Return the object attributes by decorator config_property."""
-    return _get_public_attributes_by_class_decorator(data_object=data_object, class_decorator=config_property)
-
-
-def get_public_attributes_for_info_property(data_object: Any) -> Mapping[str, Any]:
-    """Return the object attributes by decorator info_property."""
-    return _get_public_attributes_by_class_decorator(data_object=data_object, class_decorator=info_property)
-
-
-def get_public_attributes_for_state_property(data_object: Any) -> Mapping[str, Any]:
-    """Return the object attributes by decorator state_property."""
-    return _get_public_attributes_by_class_decorator(data_object=data_object, class_decorator=state_property)
-
-
-# pylint: disable=invalid-name
-class cached_slot_property[T, R]:
-    """A property-like descriptor that caches the computed value in a slot attribute. Designed to work with classes that use __slots__ and do not define __dict__."""
-
-    def __init__(self, func: Callable[[T], R]) -> None:
-        """Init the cached property."""
-        self._func = func  # The function to compute the value
-        self._cache_attr = f"_cached_{func.__name__}"  # Default name of the cache attribute
-        self._name = func.__name__
-
-    def __get__(self, instance: T | None, owner: type | None = None) -> R:
-        """Return the cached value if it exists. Otherwise, compute it using the function and cache it."""
-        if instance is None:
-            # Accessed from class, return the descriptor itself
-            return cast(R, self)
-
-        # If the cached value is not set yet, compute and store it
-        if not hasattr(instance, self._cache_attr):
-            value = self._func(instance)
-            setattr(instance, self._cache_attr, value)
-
-        # Return the cached value
-        return cast(R, getattr(instance, self._cache_attr))
-
-    def __set__(self, instance: T, value: Any) -> None:
-        """Raise an error to prevent manual assignment to the property."""
-        raise AttributeError(f"Can't set read-only cached property '{self._name}'")
-
-    def __delete__(self, instance: T) -> None:
-        """Delete the cached value so it can be recomputed on next access."""
-        if hasattr(instance, self._cache_attr):
-            delattr(instance, self._cache_attr)

aiohomematic-2025.9.1.dist-info/RECORD

@@ -1,78 +0,0 @@
-aiohomematic/__init__.py,sha256=VPESkjzeVserFI2DDVAxD782cgYRlLK0sXJzLrr3e_k,2283
-aiohomematic/async_support.py,sha256=Xc55KkIV0h8rf936QKyU4OHSZsPEZ8TwuV8gVveeRh8,6106
-aiohomematic/const.py,sha256=1a7G-J_JY45Ta7qAPcfp5XLOHI0Ubw7Y6yJrz3FB0aI,25407
-aiohomematic/context.py,sha256=M7gkA7KFT0dp35gzGz2dzKVXu1PP0sAnepgLlmjyRS4,451
-aiohomematic/converter.py,sha256=QTOL8_B6SoCoqLuRSkjtOlfa7BVFSvOfnSBrDngiinA,3558
-aiohomematic/decorators.py,sha256=piayP-1t9PQe0pR8IGc_85so5XSiFLi-sIwtgkf3eWU,9725
-aiohomematic/exceptions.py,sha256=o_H3Z0A2TQ0irNxUM9u8bmivq0L_mwPCB7nhxEawDxE,5018
-aiohomematic/hmcli.py,sha256=wHOLq4IJRSY9RJux_ZfDH1gQ1ZqD0k68ua5agyBkkE8,4933
-aiohomematic/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-aiohomematic/support.py,sha256=d70tjuajEQYGFsINJQA9-RkKuCRN8-2Sw33B0bPMym8,21495
-aiohomematic/validator.py,sha256=vChkYQ9dGKCQEigiBMnoeyPkCJDJlIm6DSgR1gmeHH0,3545
-aiohomematic/caches/__init__.py,sha256=_gI30tbsWgPRaHvP6cRxOQr6n9bYZzU-jp1WbHhWg-A,470
-aiohomematic/caches/dynamic.py,sha256=ZrAQqXlzhoCvzjZ9cTEtlWqygvkn5xTzOJ987WcrPBc,21539
-aiohomematic/caches/persistent.py,sha256=YBThIByt0mLQCgcZwBBmqanI8obAhHNcFULz_H-de8o,19932
-aiohomematic/caches/visibility.py,sha256=uZ1sSCfmEQURllPvSbJ3EzFVFE7TU8XcxMDSHRpNmMs,31481
-aiohomematic/central/__init__.py,sha256=uZ_Ns5upjTcz4AaA6cN1WNWYkpxtZZebDRvag0g7bwM,85736
-aiohomematic/central/decorators.py,sha256=Sl-cMDhreiAOKkIHiei-QbIOcvbWGVX-QwB5bLeohak,6904
-aiohomematic/central/xml_rpc_server.py,sha256=dM-gbAS1NpRy4wJKUZTsMI2LJfv_vjd4kvyv3pl86yw,10545
-aiohomematic/client/__init__.py,sha256=hGpdDb518VdMYMHxrBBj2PBpUBN2Ah8ID5vjokd9PAU,69832
-aiohomematic/client/_rpc_errors.py,sha256=vu76ZWMwJJEgB0cnXc10JzK8PaiRU7jYOvj1aC21CqE,2971
-aiohomematic/client/json_rpc.py,sha256=6eHRYM4xcXUS_Ny3tnjSxw7F0GpaRMUjkqwj1HGaT7w,48231
-aiohomematic/client/xml_rpc.py,sha256=OUWQkvYYbw9duFzNAB4CXavwwh-slBtitmMPGWShbNg,8504
-aiohomematic/model/__init__.py,sha256=l1YMXkx1ugdUf7ms8lD8ObVaOzKAhi-4O2TO5s0IMd0,5459
-aiohomematic/model/data_point.py,sha256=N446xJizb9jMtrX8TFW7NQ0wj8VbTxQREFsiVUnArKA,40738
-aiohomematic/model/decorators.py,sha256=JGhDzWx983zBCEKA9UoptjFmIHOGX-UfgozhqXAeZsM,7663
-aiohomematic/model/device.py,sha256=6PDtZPZ6S-3cjEmb20zrnAh6VYG9fMtAIi1OnuV9r5s,51991
-aiohomematic/model/event.py,sha256=vXtqb9OfpumOOmbgj9z6DG-QeVUEHMOvK1gnv0piKDY,7014
-aiohomematic/model/support.py,sha256=TnEpCB8EgJq_-4LoH-et1R0cPT6Lq4LTv7MxmRn5JQU,20767
-aiohomematic/model/update.py,sha256=DemrlE8TleJgaxBwj984NxzZGeLEKpC3xAo0Ew21HLU,5107
-aiohomematic/model/calculated/__init__.py,sha256=BHYLdWMMMjqvDI5T9cQ1sPOyk7t8_q-Ngfm4cFySvJ4,2810
-aiohomematic/model/calculated/climate.py,sha256=BUKXT5kd6mbEE7TAJpRs8-A1K4pVq2d2E5cSfjsOPJw,8515
-aiohomematic/model/calculated/data_point.py,sha256=hspOOnEp-WbXb4VMTcuXkgTWxjy0ug5E46zXZy6YReQ,11493
-aiohomematic/model/calculated/operating_voltage_level.py,sha256=sf5Fy0bSbvee9lvq95-iFC05rSGkHBOKIQkdjQBU_XY,14011
-aiohomematic/model/calculated/support.py,sha256=ODH3a2B1y8Mr9N_3sMt0pyUs1qQ1tDZsD2GthScntbg,6098
-aiohomematic/model/custom/__init__.py,sha256=KNvUy3hZvdr3aRZk9CDyMqJBqRorQedZfOP3M-zwjp8,6066
-aiohomematic/model/custom/climate.py,sha256=te8GoqqDU8wQAEDTf3Pyi8NFdm9MACCe8WyhBG74x28,54018
-aiohomematic/model/custom/const.py,sha256=Kh1pnab6nmwbaY43CfXQy3yrWpPwsrQdl1Ea2aZ6aw0,4961
-aiohomematic/model/custom/cover.py,sha256=dXYZGVzR-cFELbVP2az8tkM8h7jIrvzweUz4yWh7AM8,28552
-aiohomematic/model/custom/data_point.py,sha256=mz143_hLKaF9HzJRhqqqzsoJhouLF0L_9Jo_4oq_6Gc,14109
-aiohomematic/model/custom/definition.py,sha256=1GkUyEsmjJfAdrBCW1ZBmboYZOyb00MctUE_xn4Zyl8,35481
-aiohomematic/model/custom/light.py,sha256=0QC6x6eYuDypNMbk-Ey7CMfVs1B0vgFz2YzFzqQhbzw,44170
-aiohomematic/model/custom/lock.py,sha256=q-jsvMTly6s7kEWDT42rMEfEEJsd9lBIuwzpO2STFBk,11937
-aiohomematic/model/custom/siren.py,sha256=yfWdNj-vEUGLqXBejjURd98RzY8MQv99oXxy35Ul_6U,9726
-aiohomematic/model/custom/support.py,sha256=UvencsvCwgpm4iqRNRt5KRs560tyw1NhYP5ZaqmCT2k,1453
-aiohomematic/model/custom/switch.py,sha256=JSmWUWc_WB8XmZPPgcISB9r3TNNUeg-E4skX46z7vwA,6869
-aiohomematic/model/custom/valve.py,sha256=S5i2ZePa9Jt8JplIykzeJxpJrSBEN5w-3UEmGu0Q5G0,4226
-aiohomematic/model/generic/__init__.py,sha256=OI0-ijDRYS6OkDqVd9C9UOfde2rfcB7WZZ9CLTlX1S0,7613
-aiohomematic/model/generic/action.py,sha256=5SPWVliRqXlPgtb2bI6le0-V6JR5krzw8z_0FaOXu5U,994
-aiohomematic/model/generic/binary_sensor.py,sha256=TI_KNzObiprHFS6rUKb7cYr2EsQQElfNo8Sk7eBY9NQ,884
-aiohomematic/model/generic/button.py,sha256=9wStCwiE3NeGfKHum5IVpLlbq5jRdYOA1bGHSqReY8k,742
-aiohomematic/model/generic/data_point.py,sha256=a7AXyYd0o-AfMOaGIn1qu8Q73ipjjsLLQrxMFJRw5xQ,6019
-aiohomematic/model/generic/number.py,sha256=39paL6us6KMLD5L8GhR7BLl8bKtEiicAIfcd_3HyOw4,2666
-aiohomematic/model/generic/select.py,sha256=vCe5FpMe2iqePQMHFBxKmkIBY6Y99SnTyiatmeZC6dM,1532
-aiohomematic/model/generic/sensor.py,sha256=N2GeZjZQbRyc4s8lX11xvho_TOqIdT6Uqc7LguBF9Ho,2250
-aiohomematic/model/generic/switch.py,sha256=wr6vEBc0iTyCGaRSVdoO_9UY8lt3-NPTyAXEhuZbAqU,1836
-aiohomematic/model/generic/text.py,sha256=vTgQpX_COn1OxExZ5az9jPU410fGZIbq0PajPS8vXgs,851
-aiohomematic/model/hub/__init__.py,sha256=_UEEiNHfUVb0D0qTMcR2_YH1ZcYu1jzgLnUApPWfT2k,13493
-aiohomematic/model/hub/binary_sensor.py,sha256=0cF1SCJY1BRM1_Fx5oYPMaSZu9tDy1GnBMn_UqpqqPk,749
-aiohomematic/model/hub/button.py,sha256=N0QSN-SdnLY38JslCoUaqjI2pcdp0DJY2kxoODUKO0s,889
-aiohomematic/model/hub/data_point.py,sha256=3HscnhIbOQlipWZKliHZPvZulvtpTAF83qS0-4iCzVQ,10645
-aiohomematic/model/hub/number.py,sha256=mj4HVRGgUqoyAyluSzKwlE_0jconltBAx-2nJuL9bhY,1224
-aiohomematic/model/hub/select.py,sha256=s5_nmMCae35I7WtUK2Oo_577JzBt68BSpgv5cTussps,1658
-aiohomematic/model/hub/sensor.py,sha256=Uqqb1rqVmYCemJK4yIkarkllKWZJTpd-VNiyLOKXl3M,1189
-aiohomematic/model/hub/switch.py,sha256=1Dp_jG4qtnAs-itaZDKStmeD4PdiMtdZctDOoGWI-Qg,1391
-aiohomematic/model/hub/text.py,sha256=AQOQB2W0jt8t__FxahDAAEOGhshkAX1pImHIFt_Xwqg,987
-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-2025.9.1.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=cvkO3tcxSJKy5ZLVdeqDbvSmeottxqZJNI4ccdxIVD4,12524
-aiohomematic-2025.9.1.dist-info/METADATA,sha256=qsC9QfkxhshJIvpgktrIYwKsmoTrBtnsPtpcl2HbgE4,6960
-aiohomematic-2025.9.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-aiohomematic-2025.9.1.dist-info/top_level.txt,sha256=5TDRlUWQPThIUwQjOj--aUo4UA-ow4m0sNhnoCBi5n8,34
-aiohomematic-2025.9.1.dist-info/RECORD,,