feat: add OverkizClientSettings dataclass (#766)

Add OverkizClientSettings to group behavioral configuration for OverkizClient.
Includes action_queue (ActionQueueSettings | None) and rts_command_duration (int | None).
This replaces the standalone action_queue constructor param and enables RTS duration injection.

Author: iMicknl

pyoverkiz/client_settings.py

@@ -0,0 +1,18 @@
+"""Behavioral configuration for OverkizClient."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from pyoverkiz.action_queue import ActionQueueSettings
+
+
+@dataclass(frozen=True, slots=True)
+class OverkizClientSettings:
+    """Behavioral configuration for OverkizClient.
+
+    All fields are optional and default to passive behavior.
+    """
+
+    action_queue: ActionQueueSettings | None = None
+    rts_command_duration: int | None = None

tests/test_client_settings.py

@@ -0,0 +1,24 @@
+"""Tests for OverkizClientSettings."""
+
+from pyoverkiz.action_queue import ActionQueueSettings
+from pyoverkiz.client_settings import OverkizClientSettings
+
+
+def test_defaults():
+    """Default settings have no queue and no RTS duration."""
+    settings = OverkizClientSettings()
+    assert settings.action_queue is None
+    assert settings.rts_command_duration is None
+
+
+def test_with_rts_duration():
+    """RTS command duration can be set."""
+    settings = OverkizClientSettings(rts_command_duration=0)
+    assert settings.rts_command_duration == 0
+
+
+def test_with_action_queue_settings():
+    """Passing ActionQueueSettings stores it directly."""
+    qs = ActionQueueSettings(delay=1.0, max_actions=10)
+    settings = OverkizClientSettings(action_queue=qs)
+    assert settings.action_queue is qs