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

xp/services/conbus/conbus_datapoint_queryall_service.py

@@ -1,4 +1,5 @@
-"""Conbus DataPoint Query All Service.
+"""
+Conbus DataPoint Query All Service.
 
 This module provides service for querying all datapoint types from a module.
 """
@@ -20,7 +21,8 @@ from xp.services.protocol.conbus_event_protocol import ConbusEventProtocol
 
 
 class ConbusDatapointQueryAllService:
-    """Utility service for querying all datapoints from a module.
+    """
+    Utility service for querying all datapoints from a module.
 
     This service orchestrates multiple ConbusDatapointService calls to query
     all available datapoint types sequentially.
@@ -40,7 +42,8 @@ class ConbusDatapointQueryAllService:
         conbus_protocol: ConbusEventProtocol,
         telegram_service: TelegramService,
     ) -> None:
-        """Initialize the query all service.
+        """
+        Initialize the query all service.
 
         Args:
             conbus_protocol: ConbusEventProtocol for protocol communication.
@@ -73,7 +76,8 @@ class ConbusDatapointQueryAllService:
         self.next_datapoint()
 
     def next_datapoint(self) -> bool:
-        """Query the next datapoint type.
+        """
+        Query the next datapoint type.
 
         Returns:
             True if there are more datapoints to query, False otherwise.
@@ -111,7 +115,8 @@ class ConbusDatapointQueryAllService:
             self.on_finish.emit(self.service_response)
 
     def telegram_sent(self, telegram_sent: str) -> None:
-        """Handle telegram sent event.
+        """
+        Handle telegram sent event.
 
         Args:
             telegram_sent: The telegram that was sent.
@@ -119,7 +124,8 @@ class ConbusDatapointQueryAllService:
         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.
@@ -152,7 +158,8 @@ class ConbusDatapointQueryAllService:
         self.on_progress.emit(datapoint_telegram)
 
     def failed(self, message: str) -> None:
-        """Handle failed connection event.
+        """
+        Handle failed connection event.
 
         Args:
             message: Failure message.
@@ -170,7 +177,8 @@ class ConbusDatapointQueryAllService:
         serial_number: str,
         timeout_seconds: Optional[float] = None,
     ) -> None:
-        """Query all datapoints from a module.
+        """
+        Query all datapoints from a module.
 
         Args:
             serial_number: 10-digit module serial number.
@@ -182,7 +190,8 @@ class ConbusDatapointQueryAllService:
         self.serial_number = serial_number
 
     def set_timeout(self, timeout_seconds: float) -> None:
-        """Set operation timeout.
+        """
+        Set operation timeout.
 
         Args:
             timeout_seconds: Timeout in seconds.

xp/services/conbus/conbus_datapoint_service.py

@@ -1,4 +1,5 @@
-"""Conbus Datapoint Service for querying module datapoints.
+"""
+Conbus Datapoint Service for querying module datapoints.
 
 This service handles datapoint query operations for modules through Conbus telegrams.
 """
@@ -20,7 +21,8 @@ from xp.services.telegram.telegram_service import TelegramService
 
 
 class ConbusDatapointService:
-    """Service for querying datapoints from Conbus modules.
+    """
+    Service for querying datapoints from Conbus modules.
 
     Uses ConbusEventProtocol to provide datapoint query functionality
     for reading sensor data and module information.
@@ -38,7 +40,8 @@ class ConbusDatapointService:
         conbus_protocol: ConbusEventProtocol,
         telegram_service: TelegramService,
     ) -> None:
-        """Initialize the Conbus datapoint service.
+        """
+        Initialize the Conbus datapoint service.
 
         Args:
             conbus_protocol: Protocol instance for Conbus communication.
@@ -81,7 +84,8 @@ class ConbusDatapointService:
         )
 
     def telegram_sent(self, telegram_sent: str) -> None:
-        """Handle telegram sent event.
+        """
+        Handle telegram sent event.
 
         Args:
             telegram_sent: The telegram that was sent.
@@ -89,7 +93,8 @@ class ConbusDatapointService:
         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.
@@ -124,7 +129,8 @@ class ConbusDatapointService:
         self.succeed(datapoint_telegram)
 
     def succeed(self, datapoint_telegram: ReplyTelegram) -> None:
-        """Handle successful datapoint query.
+        """
+        Handle successful datapoint query.
 
         Args:
             datapoint_telegram: The parsed datapoint telegram.
@@ -147,7 +153,8 @@ class ConbusDatapointService:
         self.failed("Timeout")
 
     def failed(self, message: str) -> None:
-        """Handle failed connection event.
+        """
+        Handle failed connection event.
 
         Args:
             message: Failure message.
@@ -167,7 +174,8 @@ class ConbusDatapointService:
         datapoint_type: DataPointType,
         timeout_seconds: float = 1.0,
     ) -> None:
-        """Query a specific datapoint from a module.
+        """
+        Query a specific datapoint from a module.
 
         Args:
             serial_number: 10-digit module serial number.
@@ -181,7 +189,8 @@ class ConbusDatapointService:
         self.datapoint_type = datapoint_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_discover_service.py

@@ -1,7 +1,8 @@
-"""Conbus Discover Service for TCP communication with Conbus servers.
+"""
+Conbus Discover Service for TCP communication with Conbus servers.
 
-This service implements a TCP client that connects to Conbus servers and sends
-discover telegrams to find modules on the network.
+This service implements a TCP client that connects to Conbus servers and sends discover
+telegrams to find modules on the network.
 """
 
 import asyncio
@@ -40,7 +41,8 @@ class ConbusDiscoverService:
     on_device_discovered: Signal = Signal(ConbusDiscoverResponse)
 
     def __init__(self, conbus_protocol: ConbusEventProtocol) -> None:
-        """Initialize the Conbus discover service.
+        """
+        Initialize the Conbus discover service.
 
         Args:
             conbus_protocol: ConbusProtocol.
@@ -68,7 +70,8 @@ class ConbusDiscoverService:
         )
 
     def telegram_sent(self, telegram_sent: str) -> None:
-        """Handle telegram sent event.
+        """
+        Handle telegram sent event.
 
         Args:
             telegram_sent: The telegram that was sent.
@@ -77,7 +80,8 @@ class ConbusDiscoverService:
         self.discovered_device_result.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.
@@ -121,7 +125,8 @@ class ConbusDiscoverService:
             self.logger.debug("Not a discover or module type response")
 
     def handle_discovered_device(self, serial_number: str) -> None:
-        """Handle discovered device event.
+        """
+        Handle discovered device event.
 
         Args:
             serial_number: Serial number of the discovered device.
@@ -153,7 +158,8 @@ class ConbusDiscoverService:
     def handle_module_type_code_response(
         self, serial_number: str, module_type_code: str
     ) -> None:
-        """Handle module type code response and update discovered device.
+        """
+        Handle module type code response and update discovered device.
 
         Args:
             serial_number: Serial number of the device.
@@ -214,7 +220,8 @@ class ConbusDiscoverService:
         self.succeed()
 
     def handle_module_type_response(self, serial_number: str, module_type: str) -> None:
-        """Handle module type response and update discovered device.
+        """
+        Handle module type response and update discovered device.
 
         Args:
             serial_number: Serial number of the device.
@@ -249,7 +256,8 @@ class ConbusDiscoverService:
         self.on_finish.emit(self.discovered_device_result)
 
     def failed(self, message: str) -> None:
-        """Handle failed connection event.
+        """
+        Handle failed connection event.
 
         Args:
             message: Failure message.
@@ -267,7 +275,8 @@ class ConbusDiscoverService:
         self.on_finish.emit(self.discovered_device_result)
 
     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.
@@ -279,7 +288,8 @@ class ConbusDiscoverService:
         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.
@@ -296,7 +306,8 @@ class ConbusDiscoverService:
         self.conbus_protocol.stop_reactor()
 
     def __enter__(self) -> "ConbusDiscoverService":
-        """Enter context manager.
+        """
+        Enter context manager.
 
         Returns:
             Self for context manager protocol.

xp/services/conbus/conbus_event_list_service.py

@@ -1,7 +1,8 @@
-"""Conbus Event List Service for listing configured event telegrams.
+"""
+Conbus Event List Service for listing configured event telegrams.
 
-This service parses action tables from conson.yml and groups events
-by button configuration to show which modules are assigned to each event.
+This service parses action tables from conson.yml and groups events by button
+configuration to show which modules are assigned to each event.
 """
 
 import logging
@@ -14,7 +15,8 @@ from xp.services.actiontable.actiontable_serializer import ActionTableSerializer
 
 
 class ConbusEventListService:
-    """Service for listing configured event telegrams from action tables.
+    """
+    Service for listing configured event telegrams from action tables.
 
     Parses action tables from conson.yml configuration and groups modules
     by their event keys to identify common button configurations.
@@ -25,7 +27,8 @@ class ConbusEventListService:
     """
 
     def __init__(self, conson_config: ConsonModuleListConfig) -> None:
-        """Initialize the Conbus event list service.
+        """
+        Initialize the Conbus event list service.
 
         Args:
             conson_config: ConsonModuleListConfig instance with module action tables.
@@ -34,7 +37,8 @@ class ConbusEventListService:
         self.logger = logging.getLogger(__name__)
 
     def list_events(self) -> ConbusEventListResponse:
-        """List all configured events from module action tables.
+        """
+        List all configured events from module action tables.
 
         Parses action tables, extracts event information (module_type, link, input),
         groups modules by event key, and sorts by usage count.
@@ -56,7 +60,7 @@ class ConbusEventListService:
             for action in module.action_table:
                 try:
                     # Use existing ActionTableSerializer to parse action
-                    entry = ActionTableSerializer.parse_action_string(action)
+                    entry = ActionTableSerializer._parse_action_string(action)
 
                     # Extract event data from parsed entry
                     module_type_name = entry.module_type.name

xp/services/conbus/conbus_event_raw_service.py

@@ -1,7 +1,8 @@
-"""Conbus Event Raw Service for sending raw event telegrams.
+"""
+Conbus Event Raw Service for sending raw event telegrams.
 
-This service implements a TCP client that connects to Conbus servers and sends
-raw event telegrams to simulate button presses on Conbus modules.
+This service implements a TCP client that connects to Conbus servers and sends raw event
+telegrams to simulate button presses on Conbus modules.
 """
 
 import logging
@@ -15,7 +16,8 @@ from xp.services.protocol.conbus_event_protocol import ConbusEventProtocol
 
 
 class ConbusEventRawService:
-    """Service for sending raw event telegrams to Conbus servers.
+    """
+    Service for sending raw event telegrams to Conbus servers.
 
     Uses ConbusEventProtocol to send MAKE/BREAK event sequences to
     simulate button presses on Conbus modules.
@@ -27,7 +29,8 @@ class ConbusEventRawService:
     conbus_protocol: ConbusEventProtocol
 
     def __init__(self, conbus_protocol: ConbusEventProtocol) -> None:
-        """Initialize the Conbus event raw service.
+        """
+        Initialize the Conbus event raw service.
 
         Args:
             conbus_protocol: ConbusEventProtocol instance.
@@ -79,7 +82,8 @@ class ConbusEventRawService:
         self.conbus_protocol.call_later(0.0, self.conbus_protocol.start_queue_manager)
 
     def telegram_sent(self, telegram_sent: str) -> None:
-        """Handle telegram sent event.
+        """
+        Handle telegram sent event.
 
         Args:
             telegram_sent: The telegram that was sent.
@@ -90,7 +94,8 @@ class ConbusEventRawService:
         self.event_result.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.
@@ -105,7 +110,8 @@ class ConbusEventRawService:
             self.progress_callback(telegram_received.frame)
 
     def timeout(self) -> None:
-        """Handle timeout event.
+        """
+        Handle timeout event.
 
         Timeout is the normal/expected way to finish this service.
         """
@@ -119,7 +125,8 @@ class ConbusEventRawService:
         self.stop_reactor()
 
     def failed(self, message: str) -> None:
-        """Handle failed connection event.
+        """
+        Handle failed connection event.
 
         Args:
             message: Failure message.
@@ -155,7 +162,8 @@ class ConbusEventRawService:
         finish_callback: Callable[[ConbusEventRawResponse], None],
         timeout_seconds: int = 5,
     ) -> None:
-        """Run reactor in dedicated thread with its own event loop.
+        """
+        Run reactor in dedicated thread with its own event loop.
 
         Args:
             module_type_code: Module type code (numeric, e.g., 2 for CP20, 33 for XP33).

xp/services/conbus/conbus_export_service.py

@@ -23,7 +23,8 @@ from xp.services.telegram.telegram_service import TelegramService
 
 
 class ConbusExportService:
-    """Service for exporting Conbus device configurations.
+    """
+    Service for exporting Conbus device configurations.
 
     Discovers all devices on the Conbus network and queries their configuration
     datapoints to generate a structured export file compatible with conson.yml format.
@@ -57,7 +58,8 @@ class ConbusExportService:
     ]
 
     def __init__(self, conbus_protocol: ConbusEventProtocol) -> None:
-        """Initialize the Conbus export service.
+        """
+        Initialize the Conbus export service.
 
         Args:
             conbus_protocol: Protocol for Conbus communication.
@@ -93,7 +95,8 @@ class ConbusExportService:
         )
 
     def telegram_sent(self, telegram: str) -> None:
-        """Handle telegram sent event.
+        """
+        Handle telegram sent event.
 
         Args:
             telegram: Telegram that was sent.
@@ -101,7 +104,8 @@ class ConbusExportService:
         self.export_result.sent_telegrams.append(telegram)
 
     def telegram_received(self, event: TelegramReceivedEvent) -> None:
-        """Handle telegram received event.
+        """
+        Handle telegram received event.
 
         Args:
             event: Telegram received event.
@@ -133,7 +137,8 @@ class ConbusExportService:
                 )
 
     def _handle_discovery_response(self, serial_number: str) -> None:
-        """Handle discovery response and query all datapoints.
+        """
+        Handle discovery response and query all datapoints.
 
         Args:
             serial_number: Serial number of discovered device.
@@ -175,7 +180,8 @@ class ConbusExportService:
     def _handle_datapoint_response(
         self, serial_number: str, datapoint_code: str, value: str
     ) -> None:
-        """Handle datapoint response and store value.
+        """
+        Handle datapoint response and store value.
 
         Args:
             serial_number: Serial number of device.
@@ -201,7 +207,8 @@ class ConbusExportService:
     def _store_datapoint_value(
         self, serial_number: str, datapoint: DataPointType, value: str
     ) -> None:
-        """Store datapoint value in device config.
+        """
+        Store datapoint value in device config.
 
         Args:
             serial_number: Serial number of device.
@@ -231,7 +238,8 @@ class ConbusExportService:
             self.logger.warning(f"Invalid value '{value}' for {datapoint.name}: {e}")
 
     def _is_device_complete(self, serial_number: str) -> bool:
-        """Check if a device has all required datapoints.
+        """
+        Check if a device has all required datapoints.
 
         Args:
             serial_number: Serial number of device.
@@ -253,7 +261,8 @@ class ConbusExportService:
         )
 
     def _check_device_complete(self, serial_number: str) -> None:
-        """Check if device has all datapoints and emit completion signal.
+        """
+        Check if device has all datapoints and emit completion signal.
 
         Args:
             serial_number: Serial number of device.
@@ -313,7 +322,8 @@ class ConbusExportService:
             self.on_finish.emit(self.export_result)
 
     def _write_export_file(self, path: str) -> None:
-        """Write export to YAML file.
+        """
+        Write export to YAML file.
 
         Args:
             path: Output file path.
@@ -385,7 +395,8 @@ class ConbusExportService:
         self._finalize_export()
 
     def failed(self, message: str) -> None:
-        """Handle connection failure event.
+        """
+        Handle connection failure event.
 
         Args:
             message: Failure message.
@@ -398,7 +409,8 @@ class ConbusExportService:
         self.on_finish.emit(self.export_result)
 
     def set_timeout(self, timeout_seconds: float) -> None:
-        """Set timeout for export operation.
+        """
+        Set timeout for export operation.
 
         Args:
             timeout_seconds: Timeout in seconds.
@@ -407,7 +419,8 @@ class ConbusExportService:
         self.conbus_protocol.timeout_seconds = timeout_seconds
 
     def set_event_loop(self, event_loop: asyncio.AbstractEventLoop) -> None:
-        """Set event loop for async operations.
+        """
+        Set event loop for async operations.
 
         Args:
             event_loop: Event loop to use.
@@ -424,7 +437,8 @@ class ConbusExportService:
         self.conbus_protocol.stop_reactor()
 
     def __enter__(self) -> "ConbusExportService":
-        """Enter context manager.
+        """
+        Enter context manager.
 
         Returns:
             Self for context manager protocol.

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.