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

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.
 
@@ -273,14 +280,15 @@ class MsActionTableUploadService:
             return
 
         # Serialize to telegram data (68 characters: AAAA + 64 data chars)
-        self.upload_data = self.serializer.to_data(msactiontable)  # type: ignore[arg-type]
+        self.upload_data = 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.

xp/services/homekit/homekit_config_validator.py

@@ -1,4 +1,5 @@
-"""HomeKit Configuration Validator.
+"""
+HomeKit Configuration Validator.
 
 This module validates HomeKit configuration files for correctness and consistency.
 """
@@ -14,7 +15,8 @@ class HomekitConfigValidator:
     """Validates homekit.yml configuration file for HomeKit integration."""
 
     def __init__(self, config: HomekitConfig):
-        """Initialize the HomeKit config validator.
+        """
+        Initialize the HomeKit config validator.
 
         Args:
             config: HomeKit configuration to validate.
@@ -22,7 +24,8 @@ class HomekitConfigValidator:
         self.config = config
 
     def validate_unique_accessory_names(self) -> List[str]:
-        """Validate that all accessory names are unique.
+        """
+        Validate that all accessory names are unique.
 
         Returns:
             List of validation error messages.
@@ -38,7 +41,8 @@ class HomekitConfigValidator:
         return errors
 
     def validate_service_types(self) -> List[str]:
-        """Validate that service types are valid.
+        """
+        Validate that service types are valid.
 
         Returns:
             List of validation error messages.
@@ -58,7 +62,8 @@ class HomekitConfigValidator:
         return errors
 
     def validate_output_numbers(self) -> List[str]:
-        """Validate that output numbers are positive integers.
+        """
+        Validate that output numbers are positive integers.
 
         Returns:
             List of validation error messages.
@@ -72,7 +77,8 @@ class HomekitConfigValidator:
         return errors
 
     def validate_unique_room_names(self) -> List[str]:
-        """Validate that all room names are unique.
+        """
+        Validate that all room names are unique.
 
         Returns:
             List of validation error messages.
@@ -88,7 +94,8 @@ class HomekitConfigValidator:
         return errors
 
     def validate_room_accessory_references(self) -> List[str]:
-        """Validate that all room accessories exist in accessories section.
+        """
+        Validate that all room accessories exist in accessories section.
 
         Returns:
             List of validation error messages.
@@ -106,7 +113,8 @@ class HomekitConfigValidator:
         return errors
 
     def validate_no_orphaned_accessories(self) -> List[str]:
-        """Validate that all accessories are assigned to at least one room.
+        """
+        Validate that all accessories are assigned to at least one room.
 
         Returns:
             List of validation error messages.
@@ -124,7 +132,8 @@ class HomekitConfigValidator:
         return errors
 
     def validate_no_duplicate_accessory_assignments(self) -> List[str]:
-        """Validate that accessories are not assigned to multiple rooms.
+        """
+        Validate that accessories are not assigned to multiple rooms.
 
         Returns:
             List of validation error messages.
@@ -143,7 +152,8 @@ class HomekitConfigValidator:
         return errors
 
     def validate_all(self) -> List[str]:
-        """Run all validations and return combined errors.
+        """
+        Run all validations and return combined errors.
 
         Returns:
             List of all validation error messages.
@@ -167,7 +177,8 @@ class CrossReferenceValidator:
         conson_validator: ConsonConfigValidator,
         homekit_validator: HomekitConfigValidator,
     ):
-        """Initialize the cross-reference validator.
+        """
+        Initialize the cross-reference validator.
 
         Args:
             conson_validator: Conson configuration validator.
@@ -177,7 +188,8 @@ class CrossReferenceValidator:
         self.homekit_validator = homekit_validator
 
     def validate_serial_number_references(self) -> List[str]:
-        """Validate that all accessory serial numbers exist in conson configuration.
+        """
+        Validate that all accessory serial numbers exist in conson configuration.
 
         Returns:
             List of validation error messages.
@@ -192,7 +204,8 @@ class CrossReferenceValidator:
         return errors
 
     def validate_output_capabilities(self) -> List[str]:
-        """Validate that output numbers are within module capabilities.
+        """
+        Validate that output numbers are within module capabilities.
 
         Returns:
             List of validation error messages.
@@ -232,7 +245,8 @@ class CrossReferenceValidator:
         return errors
 
     def validate_all(self) -> List[str]:
-        """Run all cross-reference validations and return combined errors.
+        """
+        Run all cross-reference validations and return combined errors.
 
         Returns:
             List of all cross-reference validation error messages.
@@ -247,7 +261,8 @@ class ConfigValidationService:
     """Main service for validating HomeKit configuration coherence."""
 
     def __init__(self, conson_config_path: str, homekit_config_path: str):
-        """Initialize the config validation service.
+        """
+        Initialize the config validation service.
 
         Args:
             conson_config_path: Path to conson.yml configuration file.
@@ -266,7 +281,8 @@ class ConfigValidationService:
         )
 
     def validate_all(self) -> dict:
-        """Run all validations and return organized results.
+        """
+        Run all validations and return organized results.
 
         Returns:
             Dictionary containing validation results and error counts.
@@ -287,7 +303,8 @@ class ConfigValidationService:
         }
 
     def print_config_summary(self) -> str:
-        """Generate a summary of the configuration.
+        """
+        Generate a summary of the configuration.
 
         Returns:
             String containing configuration summary.