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

aiohomematic/decorators.py

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

aiohomematic/exceptions.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """
 Module for AioHomematicExceptions.
 

aiohomematic/hmcli.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 #!/usr/bin/python3
 """
 Commandline tool to query Homematic hubs via XML-RPC.

aiohomematic/model/__init__.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """
 Data point and event model for AioHomematic.
 

aiohomematic/model/calculated/__init__.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """
 Calculated (derived) data points for AioHomematic.
 

aiohomematic/model/calculated/climate.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """Module for calculating the apparent temperature in the sensor category."""
 
 from __future__ import annotations

aiohomematic/model/calculated/data_point.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """Module with base class for calculated data points."""
 
 from __future__ import annotations

aiohomematic/model/calculated/operating_voltage_level.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """Module for calculating the operating voltage level in the sensor category."""
 
 from __future__ import annotations

aiohomematic/model/calculated/support.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """
 A number of functions used to calculate values based on existing data.
 

aiohomematic/model/custom/__init__.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """
 Custom data points for AioHomematic.
 

aiohomematic/model/custom/climate.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """Module for data points implemented using the climate category."""
 
 from __future__ import annotations
@@ -12,6 +12,7 @@ import logging
 from typing import Any, Final, cast
 
 from aiohomematic.const import (
+    MANU_TEMP_CUSTOM_ID,
     SCHEDULER_PROFILE_PATTERN,
     SCHEDULER_TIME_PATTERN,
     DataPointCategory,
@@ -233,7 +234,9 @@ class BaseCustomDpClimate(CustomDataPoint):
             field=Field.TEMPERATURE_MINIMUM, data_point_type=DpFloat
         )
         self._unregister_callbacks.append(
-            self._dp_setpoint.register_data_point_updated_callback(cb=self._manu_temp_changed, custom_id="manu_temp")
+            self._dp_setpoint.register_data_point_updated_callback(
+                cb=self._manu_temp_changed, custom_id=MANU_TEMP_CUSTOM_ID
+            )
         )
 
     @abstractmethod
@@ -799,7 +802,7 @@ class CustomDpRfThermostat(BaseCustomDpClimate):
 
         self._unregister_callbacks.append(
             self._dp_control_mode.register_data_point_updated_callback(
-                cb=self._manu_temp_changed, custom_id="manu_temp"
+                cb=self._manu_temp_changed, custom_id=MANU_TEMP_CUSTOM_ID
             )
         )
 
@@ -1044,7 +1047,7 @@ class CustomDpIpThermostat(BaseCustomDpClimate):
 
         self._unregister_callbacks.append(
             self._dp_set_point_mode.register_data_point_updated_callback(
-                cb=self._manu_temp_changed, custom_id="manu_temp"
+                cb=self._manu_temp_changed, custom_id=MANU_TEMP_CUSTOM_ID
             )
         )
 

aiohomematic/model/custom/const.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """Constants used by aiohomematic custom data points."""
 
 from __future__ import annotations

aiohomematic/model/custom/cover.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """Module for data points implemented using the cover category."""
 
 from __future__ import annotations

aiohomematic/model/custom/data_point.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """Module with base class for custom data points."""
 
 from __future__ import annotations

aiohomematic/model/custom/definition.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """The module contains device descriptions for custom data points."""
 
 from __future__ import annotations

aiohomematic/model/custom/light.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """Module for data points implemented using the light category."""
 
 from __future__ import annotations

aiohomematic/model/custom/lock.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """Module for data points implemented using the lock category."""
 
 from __future__ import annotations

aiohomematic/model/custom/siren.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """Module for data points implemented using the siren category."""
 
 from __future__ import annotations

aiohomematic/model/custom/support.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """Support classes used by aiohomematic custom data points."""
 
 from __future__ import annotations

aiohomematic/model/custom/switch.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """Module for data points implemented using the switch category."""
 
 from __future__ import annotations

aiohomematic/model/custom/valve.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """Module for data points implemented using the valve category."""
 
 from __future__ import annotations

aiohomematic/model/data_point.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """
 Core data point model for AioHomematic.
 
@@ -43,6 +43,7 @@ from aiohomematic.const import (
     DEFAULT_MULTIPLIER,
     DP_KEY_VALUE,
     INIT_DATETIME,
+    INTERNAL_CUSTOM_IDS,
     KEY_CHANNEL_OPERATION_MODE_VISIBILITY,
     KWARGS_ARG_CUSTOM_ID,
     KWARGS_ARG_DATA_POINT,
@@ -312,7 +313,7 @@ class CallbackDataPoint(ABC, LogContextMixin):
 
     def register_data_point_updated_callback(self, *, cb: Callable, custom_id: str) -> CALLBACK_TYPE:
         """Register data_point updated callback."""
-        if custom_id != DEFAULT_CUSTOM_ID:
+        if custom_id not in INTERNAL_CUSTOM_IDS:
             if self._custom_id is not None and self._custom_id != custom_id:
                 raise AioHomematicException(
                     f"REGISTER_data_point_updated_CALLBACK failed: hm_data_point: {self.full_name} is already registered by {self._custom_id}"

aiohomematic/model/device.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """
 Device and channel model for AioHomematic.
 
@@ -671,7 +671,7 @@ class Device(LogContextMixin, PayloadMixin):
                     channel_address=channel_address,
                     paramset_key=paramset_key,
                 )
-        await self._central.save_caches(save_paramset_descriptions=True)
+        await self._central.save_files(save_paramset_descriptions=True)
         for dp in self.generic_data_points:
             dp.update_parameter_data()
         self.fire_device_updated_callback()
@@ -1240,7 +1240,7 @@ class _ValueCache:
         *,
         dpk: DataPointKey,
     ) -> Any:
-        """Load data from caches."""
+        """Load data from store."""
         # Try to get data from central cache
         if (
             dpk.paramset_key == ParamsetKey.VALUES
@@ -1269,14 +1269,14 @@ class _DefinitionExporter:
         "_device_address",
         "_interface_id",
         "_random_id",
-        "_storage_folder",
+        "_storage_directory",
     )
 
     def __init__(self, *, device: Device) -> None:
         """Init the device exporter."""
         self._client: Final = device.client
         self._central: Final = device.client.central
-        self._storage_folder: Final = self._central.config.storage_folder
+        self._storage_directory: Final = self._central.config.storage_directory
         self._interface_id: Final = device.interface_id
         self._device_address: Final = device.address
         self._random_id: Final[str] = f"VCU{int(random.randint(1000000, 9999999))}"
@@ -1315,14 +1315,14 @@ class _DefinitionExporter:
 
         # Save device_descriptions for device to file.
         await self._save(
-            file_dir=f"{self._storage_folder}/{DEVICE_DESCRIPTIONS_DIR}",
+            directory=f"{self._storage_directory}/{DEVICE_DESCRIPTIONS_DIR}",
             filename=filename,
             data=anonymize_device_descriptions,
         )
 
         # Save device_descriptions for device to file.
         await self._save(
-            file_dir=f"{self._storage_folder}/{PARAMSET_DESCRIPTIONS_DIR}",
+            directory=f"{self._storage_directory}/{PARAMSET_DESCRIPTIONS_DIR}",
             filename=filename,
             data=anonymize_paramset_descriptions,
         )
@@ -1332,13 +1332,13 @@ class _DefinitionExporter:
         address_parts[0] = self._random_id
         return ADDRESS_SEPARATOR.join(address_parts)
 
-    async def _save(self, *, file_dir: str, filename: str, data: Any) -> DataOperationResult:
+    async def _save(self, *, directory: str, filename: str, data: Any) -> DataOperationResult:
         """Save file to disk."""
 
         def perform_save() -> DataOperationResult:
-            if not check_or_create_directory(directory=file_dir):
+            if not check_or_create_directory(directory=directory):
                 return DataOperationResult.NO_SAVE  # pragma: no cover
-            with open(file=os.path.join(file_dir, filename), mode="wb") as fptr:
+            with open(file=os.path.join(directory, filename), mode="wb") as fptr:
                 fptr.write(orjson.dumps(data, option=orjson.OPT_INDENT_2 | orjson.OPT_NON_STR_KEYS))
             return DataOperationResult.SAVE_SUCCESS
 

aiohomematic/model/event.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """
 Event model for AioHomematic.
 

aiohomematic/model/generic/__init__.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """
 Generic data points for AioHomematic.
 

aiohomematic/model/generic/action.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """
 Module for action data points.
 

aiohomematic/model/generic/binary_sensor.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """Module for data points implemented using the binary_sensor category."""
 
 from __future__ import annotations

aiohomematic/model/generic/button.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """Module for data points implemented using the button category."""
 
 from __future__ import annotations

aiohomematic/model/generic/data_point.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """Generic python representation of a backend parameter."""
 
 from __future__ import annotations

aiohomematic/model/generic/number.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """Module for data points implemented using the number category."""
 
 from __future__ import annotations

aiohomematic/model/generic/select.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """Module for data points implemented using the select category."""
 
 from __future__ import annotations

aiohomematic/model/generic/sensor.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """Module for data points implemented using the sensor category."""
 
 from __future__ import annotations

aiohomematic/model/generic/switch.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """Module for data points implemented using the switch category."""
 
 from __future__ import annotations

aiohomematic/model/generic/text.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """Module for data points implemented using the text category."""
 
 from __future__ import annotations

aiohomematic/model/hub/__init__.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """
 Hub (backend) data points for AioHomematic.
 

aiohomematic/model/hub/binary_sensor.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """Module for hub data points implemented using the binary_sensor category."""
 
 from __future__ import annotations

aiohomematic/model/hub/button.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """Module for hub data points implemented using the button category."""
 
 from __future__ import annotations

aiohomematic/model/hub/data_point.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """Module for AioHomematic hub data points."""
 
 from __future__ import annotations

aiohomematic/model/hub/number.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """Module for data points implemented using the number category."""
 
 from __future__ import annotations

aiohomematic/model/hub/select.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """Module for hub data points implemented using the select category."""
 
 from __future__ import annotations

aiohomematic/model/hub/sensor.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """Module for hub data points implemented using the sensor category."""
 
 from __future__ import annotations

aiohomematic/model/hub/switch.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """Module for hub data points implemented using the switch category."""
 
 from __future__ import annotations

aiohomematic/model/hub/text.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """Module for hub data points implemented using the text category."""
 
 from __future__ import annotations

aiohomematic/model/support.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """Support for data points used within aiohomematic."""
 
 from __future__ import annotations

aiohomematic/model/update.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """Module for data points implemented using the update category."""
 
 from __future__ import annotations

aiohomematic/property_decorators.py

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """
 Decorators and helpers for declaring public attributes on data point classes.
 
@@ -15,7 +15,7 @@ All decorators accept an optional keyword-only argument log_context. If set to
 True, the property will be included in the LogContextMixin.log_context mapping.
 
 Notes on caching
-- Marked with cached=True always caches on first access and invalidates on set/delete.
+- Marked with cached=True always store on first access and invalidates on set/delete.
 """
 
 from __future__ import annotations

aiohomematic/store/__init__.py

@@ -0,0 +1,34 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2021-2025
+"""
+Store packages for AioHomematic.
+
+This package groups store implementations used throughout the library:
+- persistent: Long-lived on-disk store for device and paramset descriptions.
+- dynamic: Short-lived in-memory store for runtime values and connection health.
+- visibility: Parameter visibility rules to decide which parameters are relevant.
+"""
+
+from __future__ import annotations
+
+from aiohomematic.store.dynamic import CentralDataCache, CommandCache, DeviceDetailsCache, PingPongCache
+from aiohomematic.store.persistent import (
+    DeviceDescriptionCache,
+    ParamsetDescriptionCache,
+    SessionRecorder,
+    cleanup_files,
+)
+from aiohomematic.store.visibility import ParameterVisibilityCache, check_ignore_parameters_is_clean
+
+__all__ = [
+    "CentralDataCache",
+    "CommandCache",
+    "DeviceDescriptionCache",
+    "DeviceDetailsCache",
+    "ParameterVisibilityCache",
+    "ParamsetDescriptionCache",
+    "PingPongCache",
+    "SessionRecorder",
+    "cleanup_files",
+    "check_ignore_parameters_is_clean",
+]

aiohomematic/{caches → store}/dynamic.py

@@ -1,9 +1,9 @@
 # SPDX-License-Identifier: MIT
-# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+# Copyright (c) 2021-2025
 """
-Dynamic caches used at runtime by the central unit and clients.
+Dynamic store used at runtime by the central unit and clients.
 
-This module provides short-lived, in-memory caches that support robust and efficient
+This module provides short-lived, in-memory store that support robust and efficient
 communication with Homematic interfaces:
 
 - CommandCache: Tracks recently sent commands and their values per data point,
@@ -16,7 +16,7 @@ communication with Homematic interfaces:
 - PingPongCache: Tracks ping/pong timestamps to detect connection health issues
   and emits interface events on mismatch thresholds.
 
-The caches are intentionally ephemeral and cleared/aged according to the rules in
+The store are intentionally ephemeral and cleared/aged according to the rules in
 constants to keep memory footprint predictable while improving responsiveness.
 """