conson-xp 1.46.0__py3-none-any.whl → 1.48.0__py3-none-any.whl

xp/services/conbus/conbus_output_service.py

@@ -1,7 +1,8 @@
-"""Conbus Output Service for sending action telegrams to Conbus modules.
+"""
+Conbus Output Service for sending action telegrams to Conbus modules.
 
-This service handles sending action telegrams (ON/OFF) to module outputs
-and processing ACK/NAK responses.
+This service handles sending action telegrams (ON/OFF) to module outputs and processing
+ACK/NAK responses.
 """
 
 import logging
@@ -49,7 +50,8 @@ class ConbusOutputService:
         conbus_protocol: ConbusEventProtocol,
         telegram_output_service: TelegramOutputService,
     ):
-        """Initialize the Conbus output service.
+        """
+        Initialize the Conbus output service.
 
         Args:
             conbus_protocol: ConbusEventProtocol for communication.
@@ -105,7 +107,8 @@ class ConbusOutputService:
         )
 
     def telegram_sent(self, telegram_sent: str) -> None:
-        """Handle telegram sent event.
+        """
+        Handle telegram sent event.
 
         Args:
             telegram_sent: The telegram that was sent.
@@ -113,7 +116,8 @@ class ConbusOutputService:
         self.service_response.sent_telegram = telegram_sent
 
     def telegram_received(self, telegram_received: TelegramReceivedEvent) -> None:
-        """Handle telegram received event.
+        """
+        Handle telegram received event.
 
         Args:
             telegram_received: The telegram received event.
@@ -149,7 +153,8 @@ class ConbusOutputService:
             )
 
     def succeed(self, output_telegram: OutputTelegram) -> None:
-        """Handle successful output action.
+        """
+        Handle successful output action.
 
         Args:
             output_telegram: The output telegram received as response.
@@ -169,7 +174,8 @@ class ConbusOutputService:
         self.failed("Timeout")
 
     def failed(self, message: str) -> None:
-        """Handle failed connection event.
+        """
+        Handle failed connection event.
 
         Args:
             message: Failure message.
@@ -190,7 +196,8 @@ class ConbusOutputService:
         action_type: ActionType,
         timeout_seconds: Optional[float] = None,
     ) -> None:
-        """Send an action telegram to a module output.
+        """
+        Send an action telegram to a module output.
 
         Args:
             serial_number: 10-digit module serial number.
@@ -206,7 +213,8 @@ class ConbusOutputService:
         self.action_type = action_type
 
     def set_timeout(self, timeout_seconds: float) -> None:
-        """Set operation timeout.
+        """
+        Set operation timeout.
 
         Args:
             timeout_seconds: Timeout in seconds.

xp/services/conbus/conbus_raw_service.py

@@ -1,4 +1,5 @@
-"""Conbus Raw Service for sending raw telegram sequences.
+"""
+Conbus Raw Service for sending raw telegram sequences.
 
 This service handles sending raw telegram strings without prior validation.
 """
@@ -35,7 +36,8 @@ class ConbusRawService:
         self,
         conbus_protocol: ConbusEventProtocol,
     ) -> None:
-        """Initialize the Conbus raw service.
+        """
+        Initialize the Conbus raw service.
 
         Args:
             conbus_protocol: ConbusEventProtocol instance.
@@ -62,7 +64,8 @@ class ConbusRawService:
         self.conbus_protocol.send_raw_telegram(self.raw_input)
 
     def telegram_sent(self, telegram_sent: str) -> None:
-        """Handle telegram sent event.
+        """
+        Handle telegram sent event.
 
         Args:
             telegram_sent: The telegram that was sent.
@@ -73,7 +76,8 @@ class ConbusRawService:
         self.service_response.received_telegrams = []
 
     def telegram_received(self, telegram_received: TelegramReceivedEvent) -> None:
-        """Handle telegram received event.
+        """
+        Handle telegram received event.
 
         Args:
             telegram_received: The telegram received event.
@@ -92,7 +96,8 @@ class ConbusRawService:
         self.on_finish.emit(self.service_response)
 
     def failed(self, message: str) -> None:
-        """Handle failed connection event.
+        """
+        Handle failed connection event.
 
         Args:
             message: Failure message.
@@ -108,7 +113,8 @@ class ConbusRawService:
         raw_input: str,
         timeout_seconds: Optional[float] = None,
     ) -> None:
-        """Send a raw telegram string to the Conbus server.
+        """
+        Send a raw telegram string to the Conbus server.
 
         Args:
             raw_input: Raw telegram string to send.
@@ -120,7 +126,8 @@ class ConbusRawService:
         self.raw_input = raw_input
 
     def set_timeout(self, timeout_seconds: float) -> None:
-        """Set operation timeout.
+        """
+        Set operation timeout.
 
         Args:
             timeout_seconds: Timeout in seconds.
@@ -136,7 +143,8 @@ class ConbusRawService:
         self.conbus_protocol.stop_reactor()
 
     def __enter__(self) -> "ConbusRawService":
-        """Enter context manager.
+        """
+        Enter context manager.
 
         Returns:
             Self for context manager protocol.

xp/services/conbus/conbus_receive_service.py

@@ -1,7 +1,8 @@
-"""Conbus Receive Service for receiving telegrams from Conbus servers.
+"""
+Conbus Receive Service for receiving telegrams from Conbus servers.
 
-This service uses ConbusEventProtocol to provide receive-only functionality,
-allowing clients to receive waiting event telegrams using empty telegram sends.
+This service uses ConbusEventProtocol to provide receive-only functionality, allowing
+clients to receive waiting event telegrams using empty telegram sends.
 """
 
 import asyncio
@@ -33,7 +34,8 @@ class ConbusReceiveService:
     on_finish: Signal = Signal(ConbusReceiveResponse)
 
     def __init__(self, conbus_protocol: ConbusEventProtocol) -> None:
-        """Initialize the Conbus receive service.
+        """
+        Initialize the Conbus receive service.
 
         Args:
             conbus_protocol: ConbusEventProtocol instance.
@@ -57,7 +59,8 @@ class ConbusReceiveService:
         self.logger.debug("Connection established, waiting for telegrams.")
 
     def telegram_sent(self, telegram_sent: str) -> None:
-        """Handle telegram sent event.
+        """
+        Handle telegram sent event.
 
         Args:
             telegram_sent: The telegram that was sent.
@@ -65,7 +68,8 @@ class ConbusReceiveService:
         pass
 
     def telegram_received(self, telegram_received: TelegramReceivedEvent) -> None:
-        """Handle telegram received event.
+        """
+        Handle telegram received event.
 
         Args:
             telegram_received: The telegram received event.
@@ -85,7 +89,8 @@ class ConbusReceiveService:
         self.on_finish.emit(self.receive_response)
 
     def failed(self, message: str) -> None:
-        """Handle failed connection event.
+        """
+        Handle failed connection event.
 
         Args:
             message: Failure message.
@@ -96,7 +101,8 @@ class ConbusReceiveService:
         self.on_finish.emit(self.receive_response)
 
     def set_timeout(self, timeout_seconds: float) -> None:
-        """Setup callbacks and timeout for receiving telegrams.
+        """
+        Setup callbacks and timeout for receiving telegrams.
 
         Args:
             timeout_seconds: Optional timeout in seconds.
@@ -108,7 +114,8 @@ class ConbusReceiveService:
         self,
         event_loop: asyncio.AbstractEventLoop,
     ) -> None:
-        """Setup callbacks and timeout for receiving telegrams.
+        """
+        Setup callbacks and timeout for receiving telegrams.
 
         Args:
             event_loop: Optional event loop to use for async operations.
@@ -125,7 +132,8 @@ class ConbusReceiveService:
         self.conbus_protocol.stop_reactor()
 
     def __enter__(self) -> "ConbusReceiveService":
-        """Enter context manager.
+        """
+        Enter context manager.
 
         Returns:
             Self for context manager protocol.

xp/services/conbus/conbus_scan_service.py

@@ -1,7 +1,8 @@
-"""Conbus Scan Service for TCP communication with Conbus servers.
+"""
+Conbus Scan Service for TCP communication with Conbus servers.
 
-This service implements a TCP client that scans Conbus servers and sends
-telegrams to scan modules for all datapoints by function code.
+This service implements a TCP client that scans Conbus servers and sends telegrams to
+scan modules for all datapoints by function code.
 """
 
 import logging
@@ -35,7 +36,8 @@ class ConbusScanService:
         self,
         conbus_protocol: ConbusEventProtocol,
     ) -> None:
-        """Initialize the Conbus scan service.
+        """
+        Initialize the Conbus scan service.
 
         Args:
             conbus_protocol: ConbusEventProtocol instance.
@@ -66,7 +68,8 @@ class ConbusScanService:
         self.scan_next_datacode()
 
     def scan_next_datacode(self) -> bool:
-        """Scan the next data code.
+        """
+        Scan the next data code.
 
         Returns:
             True if scanning should continue, False if complete.
@@ -83,7 +86,8 @@ class ConbusScanService:
         return True
 
     def telegram_sent(self, telegram_sent: str) -> None:
-        """Handle telegram sent event.
+        """
+        Handle telegram sent event.
 
         Args:
             telegram_sent: The telegram that was sent.
@@ -92,7 +96,8 @@ class ConbusScanService:
         self.service_response.sent_telegrams.append(telegram_sent)
 
     def telegram_received(self, telegram_received: TelegramReceivedEvent) -> None:
-        """Handle telegram received event.
+        """
+        Handle telegram received event.
 
         Args:
             telegram_received: The telegram received event.
@@ -111,7 +116,8 @@ class ConbusScanService:
         self.scan_next_datacode()
 
     def failed(self, message: str) -> None:
-        """Handle failed connection event.
+        """
+        Handle failed connection event.
 
         Args:
             message: Failure message.
@@ -128,7 +134,8 @@ class ConbusScanService:
         function_code: str,
         timeout_seconds: float = 0.25,
     ) -> None:
-        """Scan a module for all datapoints by function code.
+        """
+        Scan a module for all datapoints by function code.
 
         Args:
             serial_number: 10-digit module serial number.
@@ -143,7 +150,8 @@ class ConbusScanService:
         self.function_code = function_code
 
     def set_timeout(self, timeout_seconds: float) -> None:
-        """Set operation timeout.
+        """
+        Set operation timeout.
 
         Args:
             timeout_seconds: Timeout in seconds.

xp/services/conbus/msactiontable/msactiontable_upload_service.py

@@ -29,7 +29,8 @@ class MsActionTableUploadError(Exception):
 
 
 class MsActionTableUploadService:
-    """TCP client service for uploading MS action tables to Conbus modules.
+    """
+    TCP client service for uploading MS action tables to Conbus modules.
 
     Manages TCP socket connections, handles telegram generation and transmission,
     and processes server responses for MS action table uploads.
@@ -53,7 +54,8 @@ class MsActionTableUploadService:
         telegram_service: TelegramService,
         conson_config: ConsonModuleListConfig,
     ) -> None:
-        """Initialize the MS action table upload service.
+        """
+        Initialize the MS action table upload service.
 
         Args:
             conbus_protocol: ConbusEventProtocol for communication.
@@ -104,7 +106,8 @@ class MsActionTableUploadService:
         )
 
     def telegram_sent(self, telegram_sent: str) -> None:
-        """Handle telegram sent event.
+        """
+        Handle telegram sent event.
 
         Args:
             telegram_sent: The telegram that was sent.
@@ -112,7 +115,8 @@ class MsActionTableUploadService:
         self.logger.debug(f"Telegram sent: {telegram_sent}")
 
     def telegram_received(self, telegram_received: TelegramReceivedEvent) -> None:
-        """Handle telegram received event.
+        """
+        Handle telegram received event.
 
         Args:
             telegram_received: The telegram received event.
@@ -133,7 +137,8 @@ class MsActionTableUploadService:
         self._handle_upload_response(reply_telegram)
 
     def _handle_upload_response(self, reply_telegram: Any) -> None:
-        """Handle telegram responses during upload.
+        """
+        Handle telegram responses during upload.
 
         Args:
             reply_telegram: Parsed reply telegram.
@@ -174,7 +179,8 @@ class MsActionTableUploadService:
         self.failed("Upload timeout")
 
     def failed(self, message: str) -> None:
-        """Handle failed connection event.
+        """
+        Handle failed connection event.
 
         Args:
             message: Failure message.
@@ -188,7 +194,8 @@ class MsActionTableUploadService:
         xpmoduletype: str,
         timeout_seconds: Optional[float] = None,
     ) -> None:
-        """Upload MS action table to module.
+        """
+        Upload MS action table to module.
 
         Uploads the MS action table configuration to the specified module.
 
@@ -272,15 +279,16 @@ class MsActionTableUploadService:
             self.failed(f"Invalid msactiontable format: {e}")
             return
 
-        # Serialize to telegram data (68 characters: AAAA + 64 data chars)
-        self.upload_data = self.serializer.to_data(msactiontable)  # type: ignore[arg-type]
+        # Serialize to telegram data (64 characters: AAAA + 64 data chars)
+        self.upload_data = "AAAA" + self.serializer.to_encoded_string(msactiontable)  # type: ignore[arg-type]
 
         self.logger.debug(
             f"Upload data encoded: {len(self.upload_data)} chars (single chunk)"
         )
 
     def set_timeout(self, timeout_seconds: float) -> None:
-        """Set operation timeout.
+        """
+        Set operation timeout.
 
         Args:
             timeout_seconds: Timeout in seconds.

xp/services/conbus/write_config_service.py

@@ -1,4 +1,5 @@
-"""Conbus Link Number Service for setting module link numbers.
+"""
+Conbus Link Number Service for setting module link numbers.
 
 This service handles setting link numbers for modules through Conbus telegrams.
 """
@@ -19,7 +20,8 @@ from xp.services.telegram.telegram_service import TelegramService
 
 
 class WriteConfigService:
-    """Service for writing module settings via Conbus telegrams.
+    """
+    Service for writing module settings via Conbus telegrams.
 
     Handles setting assignment by sending F04DXX telegrams and processing
     ACK/NAK responses from modules.
@@ -37,7 +39,8 @@ class WriteConfigService:
         conbus_protocol: ConbusEventProtocol,
         telegram_service: TelegramService,
     ) -> None:
-        """Initialize the Conbus link number set service.
+        """
+        Initialize the Conbus link number set service.
 
         Args:
             conbus_protocol: Protocol for Conbus communication.
@@ -94,7 +97,8 @@ class WriteConfigService:
         )
 
     def telegram_sent(self, telegram_sent: str) -> None:
-        """Handle telegram sent event.
+        """
+        Handle telegram sent event.
 
         Args:
             telegram_sent: The telegram that was sent.
@@ -102,7 +106,8 @@ class WriteConfigService:
         self.write_config_response.sent_telegram = telegram_sent
 
     def telegram_received(self, telegram_received: TelegramReceivedEvent) -> None:
-        """Handle telegram received event.
+        """
+        Handle telegram received event.
 
         Args:
             telegram_received: The telegram received event.
@@ -146,7 +151,8 @@ class WriteConfigService:
         self.finished(succeed_or_failed=False, message="Timeout")
 
     def failed(self, message: str) -> None:
-        """Handle telegram failed event.
+        """
+        Handle telegram failed event.
 
         Args:
             message: The error message.
@@ -160,7 +166,8 @@ class WriteConfigService:
         message: Optional[str] = None,
         system_function: Optional[SystemFunction] = None,
     ) -> None:
-        """Handle successful link number set operation.
+        """
+        Handle successful link number set operation.
 
         Args:
             succeed_or_failed: succeed true, failed false.
@@ -186,7 +193,8 @@ class WriteConfigService:
         data_value: str,
         timeout_seconds: Optional[float] = None,
     ) -> None:
-        """Write config to a specific module.
+        """
+        Write config to a specific module.
 
         Args:
             serial_number: 10-digit module serial number.
@@ -202,7 +210,8 @@ class WriteConfigService:
         self.data_value = data_value
 
     def set_timeout(self, timeout_seconds: float) -> None:
-        """Set operation timeout.
+        """
+        Set operation timeout.
 
         Args:
             timeout_seconds: Timeout in seconds.

xp/services/homekit/homekit_cache_service.py

@@ -22,7 +22,8 @@ CACHE_FILE = CACHE_DIR / "homekit_cache.json"
 
 
 class CacheEntry(TypedDict):
-    """Cache entry type definition.
+    """
+    Cache entry type definition.
 
     Attributes:
         event: The cached event (OutputStateReceivedEvent or LightLevelReceivedEvent).
@@ -44,7 +45,8 @@ class HomeKitCacheService:
     """
 
     def __init__(self, event_bus: EventBus, enable_persistence: bool = True):
-        """Initialize the HomeKit cache service.
+        """
+        Initialize the HomeKit cache service.
 
         Args:
             event_bus: Event bus for inter-service communication.
@@ -203,7 +205,8 @@ class HomeKitCacheService:
         return None
 
     def handle_read_datapoint_event(self, event: ReadDatapointEvent) -> None:
-        """Handle ReadDatapointEvent by checking cache or refresh flag.
+        """
+        Handle ReadDatapointEvent by checking cache or refresh flag.
 
         On refresh_cache=True: invalidate cache and force protocol query
         On cache hit: dispatch cached response event
@@ -263,7 +266,8 @@ class HomeKitCacheService:
     def handle_output_state_received_event(
         self, event: OutputStateReceivedEvent
     ) -> None:
-        """Cache OutputStateReceivedEvent for future queries.
+        """
+        Cache OutputStateReceivedEvent for future queries.
 
         Args:
             event: Output state received event to cache.
@@ -277,7 +281,8 @@ class HomeKitCacheService:
         self._cache_event(event)
 
     def handle_light_level_received_event(self, event: LightLevelReceivedEvent) -> None:
-        """Cache LightLevelReceivedEvent for future queries.
+        """
+        Cache LightLevelReceivedEvent for future queries.
 
         Args:
             event: Light level received event to cache.
@@ -297,7 +302,8 @@ class HomeKitCacheService:
         self._save_cache()
 
     def get_cache_stats(self) -> dict[str, int]:
-        """Get cache statistics.
+        """
+        Get cache statistics.
 
         Returns:
             Dictionary with cache statistics including total_entries.

xp/services/homekit/homekit_conbus_service.py

@@ -1,4 +1,5 @@
-"""HomeKit Conbus Service for protocol communication.
+"""
+HomeKit Conbus Service for protocol communication.
 
 This module bridges HomeKit events with the Conbus protocol for device control.
 """
@@ -18,7 +19,8 @@ from xp.services.protocol.telegram_protocol import TelegramProtocol
 
 
 class HomeKitConbusService:
-    """Service for bridging HomeKit events with Conbus protocol.
+    """
+    Service for bridging HomeKit events with Conbus protocol.
 
     Attributes:
         event_bus: Event bus for inter-service communication.
@@ -29,7 +31,8 @@ class HomeKitConbusService:
     event_bus: EventBus
 
     def __init__(self, event_bus: EventBus, telegram_protocol: TelegramProtocol):
-        """Initialize the HomeKit Conbus service.
+        """
+        Initialize the HomeKit Conbus service.
 
         Args:
             event_bus: Event bus instance.
@@ -49,7 +52,8 @@ class HomeKitConbusService:
     def handle_read_datapoint_request(
         self, event: ReadDatapointFromProtocolEvent
     ) -> None:
-        """Handle request to read datapoint from protocol.
+        """
+        Handle request to read datapoint from protocol.
 
         Args:
             event: Read datapoint event with serial number and datapoint type.
@@ -62,7 +66,8 @@ class HomeKitConbusService:
         self.telegram_protocol.sendFrame(telegram.encode())
 
     def handle_send_write_config_event(self, event: SendWriteConfigEvent) -> None:
-        """Handle send write config event.
+        """
+        Handle send write config event.
 
         Args:
             event: Write config event with configuration data.
@@ -79,7 +84,8 @@ class HomeKitConbusService:
         self.telegram_protocol.sendFrame(telegram.encode())
 
     def handle_send_action_event(self, event: SendActionEvent) -> None:
-        """Handle send action event.
+        """
+        Handle send action event.
 
         Args:
             event: Send action event with action data.