aiohomematic 2025.10.2__tar.gz → 2025.10.3__tar.gz

{aiohomematic-2025.10.2 → aiohomematic-2025.10.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aiohomematic
-Version: 2025.10.2
+Version: 2025.10.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>

{aiohomematic-2025.10.2 → aiohomematic-2025.10.3}/aiohomematic/async_support.py

@@ -85,7 +85,7 @@ class Looper:
             )
             return
 
-    def _async_create_task[R](self, target: Coroutine[Any, Any, R], name: str) -> asyncio.Task[R]:
+    def _async_create_task[R](self, target: Coroutine[Any, Any, R], name: str) -> asyncio.Task[R]:  # kwonly: disable
         """Create a task from within the event_loop. This method must be run in the event_loop."""
         task = self._loop.create_task(target, name=name)
         self._tasks.add(task)

{aiohomematic-2025.10.2 → aiohomematic-2025.10.3}/aiohomematic/central/__init__.py

@@ -1640,7 +1640,7 @@ class _Scheduler(threading.Thread):
             ),
         ]
 
-    def _backend_system_callback(self, system_event: BackendSystemEvent, **kwargs: Any) -> None:
+    def _backend_system_callback(self, *, system_event: BackendSystemEvent, **kwargs: Any) -> None:
         """Handle event of new device creation, to delay the start of the sysvar scan."""
         if system_event == BackendSystemEvent.DEVICES_CREATED:
             self._devices_created = True

{aiohomematic-2025.10.2 → aiohomematic-2025.10.3}/aiohomematic/central/xml_rpc_server.py

@@ -27,6 +27,9 @@ _LOGGER: Final = logging.getLogger(__name__)
 class RPCFunctions:
     """The XML-RPC functions the backend will expect."""
 
+    # Disable kw-only linter for this class since XML-RPC signatures are positional by protocol
+    __kwonly_check__ = False
+
     def __init__(self, *, xml_rpc_server: XmlRpcServer) -> None:
         """Init RPCFunctions."""
         self._xml_rpc_server: Final = xml_rpc_server
@@ -161,6 +164,8 @@ class AioHomematicXMLRPCServer(SimpleXMLRPCServer):
     system_listMethods(self, interface_id: str.
     """
 
+    __kwonly_check__ = False
+
     def system_listMethods(self, interface_id: str | None = None, /) -> list[str]:
         """Return a list of the methods supported by the server."""
         return SimpleXMLRPCServer.system_listMethods(self)
@@ -198,7 +203,7 @@ class XmlRpcServer(threading.Thread):
         self._simple_xml_rpc_server.register_instance(RPCFunctions(xml_rpc_server=self), allow_dotted_names=True)
         self._centrals: Final[dict[str, hmcu.CentralUnit]] = {}
 
-    def __new__(cls, ip_addr: str, port: int) -> XmlRpcServer:  # noqa: PYI034
+    def __new__(cls, ip_addr: str, port: int) -> XmlRpcServer:  # noqa: PYI034  # kwonly: disable
         """Create new XmlRPC server."""
         if (xml_rpc := cls._instances.get((ip_addr, port))) is None:
             _LOGGER.debug("Creating XmlRpc server")

{aiohomematic-2025.10.2 → aiohomematic-2025.10.3}/aiohomematic/const.py

@@ -19,7 +19,7 @@ import sys
 from types import MappingProxyType
 from typing import Any, Final, NamedTuple, Required, TypeAlias, TypedDict
 
-VERSION: Final = "2025.10.2"
+VERSION: Final = "2025.10.3"
 
 # Detect test speedup mode via environment
 _TEST_SPEEDUP: Final = (

{aiohomematic-2025.10.2 → aiohomematic-2025.10.3}/aiohomematic/model/custom/siren.py

@@ -79,6 +79,7 @@ class BaseCustomDpSiren(CustomDataPoint):
     @bind_collector()
     async def turn_on(
         self,
+        *,
         collector: CallParameterCollector | None = None,
         **kwargs: Unpack[SirenOnArgs],
     ) -> None:
@@ -143,6 +144,7 @@ class CustomDpIpSiren(BaseCustomDpSiren):
     @bind_collector()
     async def turn_on(
         self,
+        *,
         collector: CallParameterCollector | None = None,
         **kwargs: Unpack[SirenOnArgs],
     ) -> None:

{aiohomematic-2025.10.2 → aiohomematic-2025.10.3}/aiohomematic/model/data_point.py

@@ -999,6 +999,7 @@ class CallParameterCollector:
 
     def add_data_point(
         self,
+        *,
         data_point: BaseParameterDataPoint,
         value: Any,
         collector_order: int,

{aiohomematic-2025.10.2 → aiohomematic-2025.10.3}/aiohomematic/model/generic/data_point.py

@@ -111,7 +111,7 @@ class GenericDataPoint[ParameterT: GenericParameterType, InputParameterT: Generi
         converted_value = self._convert_value(value=prepared_value)
         # if collector is set, then add value to collector
         if collector:
-            collector.add_data_point(self, value=converted_value, collector_order=collector_order)
+            collector.add_data_point(data_point=self, value=converted_value, collector_order=collector_order)
             return set()
 
         # if collector is not set, then send value directly

{aiohomematic-2025.10.2 → aiohomematic-2025.10.3}/aiohomematic/model/support.py

@@ -87,7 +87,7 @@ class ChannelNameData:
         return ChannelNameData(device_name="", channel_name="")
 
     @staticmethod
-    def _get_channel_name(device_name: str, channel_name: str) -> str:
+    def _get_channel_name(*, device_name: str, channel_name: str) -> str:
         """Return the channel_name of the data_point only name."""
         if device_name and channel_name and channel_name.startswith(device_name):
             c_name = channel_name.replace(device_name, "").strip()
@@ -121,7 +121,7 @@ class DataPointNameData(ChannelNameData):
         return DataPointNameData(device_name="", channel_name="")
 
     @staticmethod
-    def _get_channel_parameter_name(channel_name: str, parameter_name: str | None) -> str:
+    def _get_channel_parameter_name(*, channel_name: str, parameter_name: str | None) -> str:
         """Return the channel parameter name of the data_point."""
         if channel_name and parameter_name:
             return f"{channel_name} {parameter_name}".strip()

{aiohomematic-2025.10.2 → aiohomematic-2025.10.3}/aiohomematic/property_decorators.py

@@ -65,6 +65,8 @@ class _GenericProperty[GETTER, SETTER](property):
 
     """
 
+    __kwonly_check__ = False
+
     fget: Callable[[Any], GETTER] | None
     fset: Callable[[Any, SETTER], None] | None
     fdel: Callable[[Any], None] | None

{aiohomematic-2025.10.2 → aiohomematic-2025.10.3}/aiohomematic.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aiohomematic
-Version: 2025.10.2
+Version: 2025.10.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>

{aiohomematic-2025.10.2 → aiohomematic-2025.10.3}/aiohomematic.egg-info/SOURCES.txt

@@ -93,6 +93,7 @@ tests/test_device.py
 tests/test_entity.py
 tests/test_event.py
 tests/test_json_rpc.py
+tests/test_kwonly_lint.py
 tests/test_light.py
 tests/test_lock.py
 tests/test_number.py

{aiohomematic-2025.10.2 → aiohomematic-2025.10.3}/aiohomematic_support/client_local.py

@@ -153,7 +153,7 @@ class ClientLocal(Client):  # pragma: no cover
 
     @inspector(re_raise=False)
     async def get_all_system_variables(
-        self, markers: tuple[DescriptionMarker | str, ...]
+        self, *, markers: tuple[DescriptionMarker | str, ...]
     ) -> tuple[SystemVariableData, ...]:
         """Get all system variables from the backend."""
         return ()
@@ -203,6 +203,7 @@ class ClientLocal(Client):  # pragma: no cover
     @inspector(log_level=logging.NOTSET)
     async def get_value(
         self,
+        *,
         channel_address: str,
         paramset_key: ParamsetKey,
         parameter: str,
@@ -214,6 +215,7 @@ class ClientLocal(Client):  # pragma: no cover
     @inspector(re_raise=False, no_raise_return=set())
     async def set_value(
         self,
+        *,
         channel_address: str,
         paramset_key: ParamsetKey,
         parameter: str,
@@ -236,6 +238,7 @@ class ClientLocal(Client):  # pragma: no cover
     @inspector
     async def get_paramset(
         self,
+        *,
         address: str,
         paramset_key: ParamsetKey | str,
         call_source: CallSource = CallSource.MANUAL_OR_SCHEDULED,
@@ -249,7 +252,7 @@ class ClientLocal(Client):  # pragma: no cover
         return {}
 
     async def _get_paramset_description(
-        self, address: str, paramset_key: ParamsetKey
+        self, *, address: str, paramset_key: ParamsetKey
     ) -> dict[str, ParameterData] | None:
         """Get paramset description from the backend."""
         if not self._local_resources:
@@ -277,6 +280,7 @@ class ClientLocal(Client):  # pragma: no cover
     @inspector(measure_performance=True)
     async def put_paramset(
         self,
+        *,
         channel_address: str,
         paramset_key_or_link_address: ParamsetKey | str,
         values: Any,
@@ -312,6 +316,7 @@ class ClientLocal(Client):  # pragma: no cover
 
     async def _load_all_json_files(
         self,
+        *,
         anchor: str,
         resource: str,
         include_list: list[str] | None = None,

{aiohomematic-2025.10.2 → aiohomematic-2025.10.3}/tests/test_central.py

@@ -183,7 +183,9 @@ async def test_device_un_ignore_etrv(
     expected_result: bool,
 ) -> None:
     """Test device un ignore."""
-    central, _ = await factory.get_default_central({"VCU3609622": "HmIP-eTRV-2.json"}, un_ignore_list=[line])
+    central, _ = await factory.get_default_central(
+        address_device_translation={"VCU3609622": "HmIP-eTRV-2.json"}, un_ignore_list=[line]
+    )
     try:
         channel = _FakeChannel(model="HmIP-eTRV-2", no=channel_no)
         assert (
@@ -221,7 +223,9 @@ async def test_device_un_ignore_broll(
     expected_result: bool,
 ) -> None:
     """Test device un ignore."""
-    central, _ = await factory.get_default_central({"VCU8537918": "HmIP-BROLL.json"}, un_ignore_list=[line])
+    central, _ = await factory.get_default_central(
+        address_device_translation={"VCU8537918": "HmIP-BROLL.json"}, un_ignore_list=[line]
+    )
     try:
         channel = _FakeChannel(model="HmIP-BROLL", no=channel_no)
         assert (
@@ -262,7 +266,9 @@ async def test_device_un_ignore_hm(
     expected_result: bool,
 ) -> None:
     """Test device un ignore."""
-    central, _ = await factory.get_default_central({"VCU0000341": "HM-TC-IT-WM-W-EU.json"}, un_ignore_list=[line])
+    central, _ = await factory.get_default_central(
+        address_device_translation={"VCU0000341": "HM-TC-IT-WM-W-EU.json"}, un_ignore_list=[line]
+    )
     try:
         channel = _FakeChannel(model="HM-TC-IT-WM-W-EU", no=channel_no)
         assert (
@@ -347,7 +353,9 @@ async def test_device_un_ignore_hm2(
     expected_result: bool,
 ) -> None:
     """Test device un ignore."""
-    central, _ = await factory.get_default_central({"VCU0000137": "HM-ES-PMSw1-Pl.json"}, un_ignore_list=lines)
+    central, _ = await factory.get_default_central(
+        address_device_translation={"VCU0000137": "HM-ES-PMSw1-Pl.json"}, un_ignore_list=lines
+    )
     try:
         channel = _FakeChannel(model="HM-ES-PMSw1-Pl", no=channel_no)
         assert (
@@ -401,7 +409,7 @@ async def test_ignore_(
 ) -> None:
     """Test device un ignore."""
     central, _ = await factory.get_default_central(
-        {"VCU1769958": "HmIP-BWTH.json", "VCU3609622": "HmIP-eTRV-2.json"},
+        address_device_translation={"VCU1769958": "HmIP-BWTH.json", "VCU3609622": "HmIP-eTRV-2.json"},
         ignore_custom_device_definition_models=ignore_custom_device_definition_models,
     )
     try:
@@ -438,7 +446,7 @@ async def test_all_parameters(
     expected_result: int,
 ) -> None:
     """Test all_parameters."""
-    central, _ = await factory.get_default_central(TEST_DEVICES)
+    central, _ = await factory.get_default_central(address_device_translation=TEST_DEVICES)
     parameters = central.get_parameters(
         paramset_key=ParamsetKey.VALUES,
         operations=operations,
@@ -472,7 +480,9 @@ async def test_all_parameters_with_un_ignore(
     expected_result: int,
 ) -> None:
     """Test all_parameters."""
-    central, _ = await factory.get_default_central(TEST_DEVICES, un_ignore_list=["ACTIVE_PROFILE"])
+    central, _ = await factory.get_default_central(
+        address_device_translation=TEST_DEVICES, un_ignore_list=["ACTIVE_PROFILE"]
+    )
     parameters = central.get_parameters(
         paramset_key=ParamsetKey.VALUES,
         operations=operations,
@@ -675,7 +685,7 @@ async def test_virtual_remote_delete(
 @pytest.mark.asyncio
 async def test_central_not_alive(factory: helper.Factory) -> None:
     """Test central other methods."""
-    central, client = await factory.get_unpatched_default_central({}, do_mock_client=False)
+    central, client = await factory.get_unpatched_default_central(address_device_translation={}, do_mock_client=False)
     try:
         mock_client = helper.get_mock(instance=client, available=False)
         assert central.system_information.serial is None
@@ -817,7 +827,9 @@ async def test_central_services(
 @pytest.mark.asyncio
 async def test_central_direct(factory: helper.Factory) -> None:
     """Test central other methods."""
-    central, client = await factory.get_unpatched_default_central(TEST_DEVICES, do_mock_client=False)
+    central, client = await factory.get_unpatched_default_central(
+        address_device_translation=TEST_DEVICES, do_mock_client=False
+    )
     try:
         mock_client = helper.get_mock(instance=client, available=False)
         assert central.system_information.serial is None

aiohomematic-2025.10.3/tests/test_kwonly_lint.py

@@ -0,0 +1,29 @@
+"""Tests for keyword-only method linter (script.lint_kwonly)."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import script.lint_kwonly as kwlint
+
+
+def test_kwonly_lint_detects_simple_init(tmp_path: Path) -> None:
+    """The linter must detect missing '*' for __init__ beyond the first param."""
+    code = "class Foo:\n    def __init__(self, x):\n        pass\n"
+    p = tmp_path / "sample.py"
+    p.write_text(code, encoding="utf-8")
+
+    violations = kwlint.check_file(str(p))
+    assert violations, "Expected at least one violation to be reported"
+    msgs = "\n".join(str(v) for v in violations)
+    assert "method '__init__'" in msgs
+
+
+def test_kwonly_lint_ignores_varargs(tmp_path: Path) -> None:
+    """If *args is in the method signature, the linter must not flag it."""
+    code = "class Foo:\n    def bar(self, x, *args):\n        pass\n"
+    p = tmp_path / "sample_varargs.py"
+    p.write_text(code, encoding="utf-8")
+
+    violations = kwlint.check_file(str(p))
+    assert not violations, f"Did not expect violations, got: {[str(v) for v in violations]}"