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

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.

xp/services/homekit/homekit_conson_validator.py

@@ -1,4 +1,5 @@
-"""Conson Configuration Validator for HomeKit.
+"""
+Conson Configuration Validator for HomeKit.
 
 This module validates conson.yml configuration files for HomeKit integration.
 """
@@ -15,7 +16,8 @@ class ConsonConfigValidator:
     """Validates conson.yml configuration file for HomeKit integration."""
 
     def __init__(self, config: ConsonModuleListConfig):
-        """Initialize the Conson config validator.
+        """
+        Initialize the Conson config validator.
 
         Args:
             config: Conson module list configuration to validate.
@@ -23,7 +25,8 @@ class ConsonConfigValidator:
         self.config = config
 
     def validate_unique_names(self) -> List[str]:
-        """Validate that all module names are unique.
+        """
+        Validate that all module names are unique.
 
         Returns:
             List of validation error messages.
@@ -39,7 +42,8 @@ class ConsonConfigValidator:
         return errors
 
     def validate_unique_serial_numbers(self) -> List[str]:
-        """Validate that all serial numbers are unique.
+        """
+        Validate that all serial numbers are unique.
 
         Returns:
             List of validation error messages.
@@ -55,7 +59,8 @@ class ConsonConfigValidator:
         return errors
 
     def validate_module_type_codes(self) -> List[str]:
-        """Validate module type code ranges.
+        """
+        Validate module type code ranges.
 
         Returns:
             List of validation error messages.
@@ -69,7 +74,8 @@ class ConsonConfigValidator:
         return errors
 
     def validate_network_config(self) -> List[str]:
-        """Validate IP/port configuration.
+        """
+        Validate IP/port configuration.
 
         Returns:
             List of validation error messages.
@@ -83,7 +89,8 @@ class ConsonConfigValidator:
         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.
@@ -96,7 +103,8 @@ class ConsonConfigValidator:
         return all_errors
 
     def get_module_by_serial(self, serial_number: str) -> ConsonModuleConfig:
-        """Get module configuration by serial number.
+        """
+        Get module configuration by serial number.
 
         Args:
             serial_number: Serial number of the module to find.
@@ -113,7 +121,8 @@ class ConsonConfigValidator:
         raise ValueError(f"Module with serial number {serial_number} not found")
 
     def get_all_serial_numbers(self) -> Set[str]:
-        """Get all serial numbers from the configuration.
+        """
+        Get all serial numbers from the configuration.
 
         Returns:
             Set of all serial numbers in the configuration.

xp/services/homekit/homekit_dimminglight.py

@@ -1,4 +1,5 @@
-"""HomeKit Dimming Light Accessory.
+"""
+HomeKit Dimming Light Accessory.
 
 This module provides a dimming light accessory for HomeKit integration.
 """
@@ -21,7 +22,8 @@ from xp.models.protocol.conbus_protocol import (
 
 
 class DimmingLight(Accessory):
-    """HomeKit dimming light accessory.
+    """
+    HomeKit dimming light accessory.
 
     Attributes:
         category: HomeKit category (CATEGORY_LIGHTBULB).
@@ -46,7 +48,8 @@ class DimmingLight(Accessory):
         accessory: HomekitAccessoryConfig,
         event_bus: EventBus,
     ):
-        """Initialize the dimming light accessory.
+        """
+        Initialize the dimming light accessory.
 
         Args:
             driver: HAP accessory driver.
@@ -102,7 +105,8 @@ class DimmingLight(Accessory):
         )
 
     def set_on(self, value: bool) -> None:
-        """Set the on/off state of the dimming light.
+        """
+        Set the on/off state of the dimming light.
 
         Args:
             value: True to turn on, False to turn off.
@@ -124,7 +128,8 @@ class DimmingLight(Accessory):
             )
 
     def get_on(self) -> bool:
-        """Get the on/off state of the dimming light.
+        """
+        Get the on/off state of the dimming light.
 
         Returns:
             True if on, False if off.
@@ -144,7 +149,8 @@ class DimmingLight(Accessory):
         return self.is_on
 
     def set_brightness(self, value: int) -> None:
-        """Set the brightness level of the dimming light.
+        """
+        Set the brightness level of the dimming light.
 
         Args:
             value: Brightness level (0-100).
@@ -163,7 +169,8 @@ class DimmingLight(Accessory):
         )
 
     def get_brightness(self) -> int:
-        """Get the brightness level of the dimming light.
+        """
+        Get the brightness level of the dimming light.
 
         Returns:
             Current brightness level (0-100).

xp/services/homekit/homekit_dimminglight_service.py

@@ -1,4 +1,5 @@
-"""HomeKit Dimming Light Service.
+"""
+HomeKit Dimming Light Service.
 
 This module provides service implementation for dimming light accessories.
 """
@@ -19,7 +20,8 @@ from xp.models.telegram.datapoint_type import DataPointType
 
 
 class HomeKitDimmingLightService:
-    """Dimming light service for HomeKit.
+    """
+    Dimming light service for HomeKit.
 
     Attributes:
         event_bus: Event bus for inter-service communication.
@@ -29,7 +31,8 @@ class HomeKitDimmingLightService:
     event_bus: EventBus
 
     def __init__(self, event_bus: EventBus) -> None:
-        """Initialize the dimming light service.
+        """
+        Initialize the dimming light service.
 
         Args:
             event_bus: Event bus instance.
@@ -48,7 +51,8 @@ class HomeKitDimmingLightService:
         )
 
     def handle_dimminglight_get_on(self, event: DimmingLightGetOnEvent) -> None:
-        """Handle dimming light get on event.
+        """
+        Handle dimming light get on event.
 
         Args:
             event: Dimming light get on event.
@@ -67,7 +71,8 @@ class HomeKitDimmingLightService:
         self.logger.debug(f"Dispatched ReadDatapointEvent for {event.serial_number}")
 
     def handle_dimminglight_set_on(self, event: DimmingLightSetOnEvent) -> None:
-        """Handle dimming light set on event.
+        """
+        Handle dimming light set on event.
 
         Args:
             event: Dimming light set on event.
@@ -98,7 +103,8 @@ class HomeKitDimmingLightService:
     def handle_dimminglight_set_brightness(
         self, event: DimmingLightSetBrightnessEvent
     ) -> None:
-        """Handle dimming light set brightness event.
+        """
+        Handle dimming light set brightness event.
 
         Args:
             event: Dimming light set brightness event.
@@ -126,7 +132,8 @@ class HomeKitDimmingLightService:
     def handle_dimminglight_get_brightness(
         self, event: DimmingLightGetBrightnessEvent
     ) -> None:
-        """Handle dimming light get brightness event.
+        """
+        Handle dimming light get brightness event.
 
         Args:
             event: Dimming light get brightness event.

xp/services/homekit/homekit_hap_service.py

@@ -1,4 +1,5 @@
-"""HomeKit HAP Service for Apple HomeKit integration.
+"""
+HomeKit HAP Service for Apple HomeKit integration.
 
 This module provides the main HAP (HomeKit Accessory Protocol) service.
 """
@@ -35,7 +36,8 @@ from xp.services.homekit.homekit_outlet import Outlet
 
 
 class HomekitHapService:
-    """HomeKit HAP service.
+    """
+    HomeKit HAP service.
 
     Manages HAP accessory protocol, handles bridge and accessory setup,
     and processes HomeKit events for device state synchronization.
@@ -59,7 +61,8 @@ class HomekitHapService:
         module_service: HomekitModuleService,
         event_bus: EventBus,
     ):
-        """Initialize the HomeKit HAP service.
+        """
+        Initialize the HomeKit HAP service.
 
         Args:
             homekit_config: HomeKit configuration.
@@ -122,7 +125,8 @@ class HomekitHapService:
             self.logger.error(f"HAP-python driver error: {e}", exc_info=True)
 
     def handle_output_state_received(self, event: OutputStateReceivedEvent) -> str:
-        """Handle output state received event.
+        """
+        Handle output state received event.
 
         Args:
             event: Output state received event.
@@ -152,7 +156,8 @@ class HomekitHapService:
         return event.data_value
 
     def handle_light_level_received(self, event: LightLevelReceivedEvent) -> str:
-        """Handle light level received event.
+        """
+        Handle light level received event.
 
         Args:
             event: Light level received event.
@@ -206,7 +211,8 @@ class HomekitHapService:
         self.driver.add_accessory(accessory=bridge)
 
     def add_room(self, bridge: Bridge, room: RoomConfig) -> None:
-        """Add a room with its accessories to the bridge.
+        """
+        Add a room with its accessories to the bridge.
 
         Args:
             bridge: HAP bridge instance.
@@ -239,7 +245,8 @@ class HomekitHapService:
     def get_accessory(
         self, homekit_accessory: HomekitAccessoryConfig
     ) -> Union[LightBulb, Outlet, DimmingLight, None]:
-        """Get an accessory instance from configuration.
+        """
+        Get an accessory instance from configuration.
 
         Args:
             homekit_accessory: HomeKit accessory configuration.
@@ -282,7 +289,8 @@ class HomekitHapService:
         return None
 
     def get_accessory_by_name(self, name: str) -> Optional[HomekitAccessoryConfig]:
-        """Get an accessory configuration by name.
+        """
+        Get an accessory configuration by name.
 
         Args:
             name: Name of the accessory to find.
@@ -295,7 +303,8 @@ class HomekitHapService:
         )
 
     def handle_module_state_changed(self, event: ModuleStateChangedEvent) -> None:
-        """Handle module state change by refreshing affected accessories.
+        """
+        Handle module state change by refreshing affected accessories.
 
         Args:
             event: Module state changed event.