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

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.

xp/services/homekit/homekit_lightbulb.py

@@ -1,4 +1,5 @@
-"""HomeKit Light Bulb Accessory.
+"""
+HomeKit Light Bulb Accessory.
 
 This module provides a light bulb accessory for HomeKit integration.
 """
@@ -19,7 +20,8 @@ from xp.models.protocol.conbus_protocol import (
 
 
 class LightBulb(Accessory):
-    """HomeKit light bulb accessory.
+    """
+    HomeKit light bulb accessory.
 
     Attributes:
         category: HomeKit category (CATEGORY_LIGHTBULB).
@@ -42,7 +44,8 @@ class LightBulb(Accessory):
         accessory: HomekitAccessoryConfig,
         event_bus: EventBus,
     ):
-        """Initialize the light bulb accessory.
+        """
+        Initialize the light bulb accessory.
 
         Args:
             driver: HAP accessory driver.
@@ -80,7 +83,8 @@ class LightBulb(Accessory):
         )
 
     def set_on(self, value: bool) -> None:
-        """Set the on/off state of the light bulb.
+        """
+        Set the on/off state of the light bulb.
 
         Args:
             value: True to turn on, False to turn off.
@@ -100,7 +104,8 @@ class LightBulb(Accessory):
             )
 
     def get_on(self) -> bool:
-        """Get the on/off state of the light bulb.
+        """
+        Get the on/off state of the light bulb.
 
         Returns:
             True if on, False if off.

xp/services/homekit/homekit_lightbulb_service.py

@@ -1,4 +1,5 @@
-"""HomeKit Light Bulb Service.
+"""
+HomeKit Light Bulb Service.
 
 This module provides service implementation for light bulb accessories.
 """
@@ -17,7 +18,8 @@ from xp.models.telegram.datapoint_type import DataPointType
 
 
 class HomeKitLightbulbService:
-    """Lightbulb service for HomeKit.
+    """
+    Lightbulb service for HomeKit.
 
     Attributes:
         event_bus: Event bus for inter-service communication.
@@ -27,7 +29,8 @@ class HomeKitLightbulbService:
     event_bus: EventBus
 
     def __init__(self, event_bus: EventBus):
-        """Initialize the lightbulb service.
+        """
+        Initialize the lightbulb service.
 
         Args:
             event_bus: Event bus instance.
@@ -40,7 +43,8 @@ class HomeKitLightbulbService:
         self.event_bus.on(LightBulbSetOnEvent, self.handle_lightbulb_set_on)
 
     def handle_lightbulb_get_on(self, event: LightBulbGetOnEvent) -> None:
-        """Handle lightbulb get on event.
+        """
+        Handle lightbulb get on event.
 
         Args:
             event: Lightbulb get on event.
@@ -60,7 +64,8 @@ class HomeKitLightbulbService:
         self.logger.debug(f"Dispatched ReadDatapointEvent for {event.serial_number}")
 
     def handle_lightbulb_set_on(self, event: LightBulbSetOnEvent) -> None:
-        """Handle lightbulb set on event.
+        """
+        Handle lightbulb set on event.
 
         Args:
             event: Lightbulb set on event.

xp/services/homekit/homekit_module_service.py

@@ -1,4 +1,5 @@
-"""HomeKit Module Service.
+"""
+HomeKit Module Service.
 
 This module provides service implementation for HomeKit module management.
 """
@@ -13,7 +14,8 @@ from xp.models.config.conson_module_config import (
 
 
 class HomekitModuleService:
-    """Service for managing HomeKit module configurations.
+    """
+    Service for managing HomeKit module configurations.
 
     Attributes:
         logger: Logger instance.
@@ -24,7 +26,8 @@ class HomekitModuleService:
         self,
         conson_modules_config: ConsonModuleListConfig,
     ):
-        """Initialize the HomeKit module service.
+        """
+        Initialize the HomeKit module service.
 
         Args:
             conson_modules_config: Conson module list configuration.
@@ -34,7 +37,8 @@ class HomekitModuleService:
         self.conson_modules_config = conson_modules_config
 
     def get_module_by_serial(self, serial_number: str) -> Optional[ConsonModuleConfig]:
-        """Get a module by its serial number.
+        """
+        Get a module by its serial number.
 
         Args:
             serial_number: Serial number of the module to find.

xp/services/homekit/homekit_outlet.py

@@ -1,4 +1,5 @@
-"""HomeKit Outlet Accessory.
+"""
+HomeKit Outlet Accessory.
 
 This module provides an outlet accessory for HomeKit integration.
 """
@@ -21,7 +22,8 @@ from xp.models.protocol.conbus_protocol import (
 
 
 class Outlet(Accessory):
-    """HomeKit outlet accessory.
+    """
+    HomeKit outlet accessory.
 
     Attributes:
         category: HomeKit category (CATEGORY_OUTLET).
@@ -46,7 +48,8 @@ class Outlet(Accessory):
         accessory: HomekitAccessoryConfig,
         event_bus: EventBus,
     ):
-        """Initialize the outlet accessory.
+        """
+        Initialize the outlet accessory.
 
         Args:
             driver: HAP accessory driver.
@@ -88,7 +91,8 @@ class Outlet(Accessory):
         )
 
     def set_outlet_in_use(self, value: bool) -> None:
-        """Set the in-use state of the outlet.
+        """
+        Set the in-use state of the outlet.
 
         Args:
             value: True if in use, False otherwise.
@@ -108,7 +112,8 @@ class Outlet(Accessory):
         self.logger.debug(f"set_outlet_in_use {value} end")
 
     def get_outlet_in_use(self) -> bool:
-        """Get the in-use state of the outlet.
+        """
+        Get the in-use state of the outlet.
 
         Returns:
             True if in use, False otherwise.
@@ -128,7 +133,8 @@ class Outlet(Accessory):
         return self.is_in_use
 
     def set_on(self, value: bool) -> None:
-        """Set the on/off state of the outlet.
+        """
+        Set the on/off state of the outlet.
 
         Args:
             value: True to turn on, False to turn off.
@@ -148,7 +154,8 @@ class Outlet(Accessory):
         )
 
     def get_on(self) -> bool:
-        """Get the on/off state of the outlet.
+        """
+        Get the on/off state of the outlet.
 
         Returns:
             True if on, False if off.