Files
ledgrab/server/src/wled_controller/storage/output_target.py
T
alexei.dolgolyov cb9289f01f
Lint & Test / test (push) Has been cancelled
feat: HA light output targets — cast LED colors to Home Assistant lights
New output target type `ha_light` that sends averaged LED colors to HA
light entities via WebSocket service calls (light.turn_on/turn_off):

Backend:
- HARuntime.call_service(): fire-and-forget WS service calls
- HALightOutputTarget: data model with light mappings, update rate, transition
- HALightTargetProcessor: processing loop with delta detection, rate limiting
- ProcessorManager.add_ha_light_target(): registration
- API schemas/routes updated for ha_light target type

Frontend:
- HA Light Targets section in Targets tab tree nav
- Modal editor: HA source picker, CSS source picker, light entity mappings
- Target cards with start/stop/clone/edit actions
- i18n keys for all new UI strings
2026-03-28 00:08:49 +03:00

84 lines
2.7 KiB
Python

"""Output target base data model."""
from dataclasses import dataclass, field
from datetime import datetime
from typing import List, Optional
@dataclass
class OutputTarget:
"""Base class for output targets."""
id: str
name: str
target_type: str # "wled", "key_colors", ...
created_at: datetime
updated_at: datetime
description: Optional[str] = None
tags: List[str] = field(default_factory=list)
def register_with_manager(self, manager) -> None:
"""Register this target with the processor manager. Subclasses override."""
pass
def sync_with_manager(
self, manager, *, settings_changed: bool, source_changed: bool, device_changed: bool
) -> None:
"""Push changed fields to a running processor. Subclasses override."""
pass
def update_fields(
self,
*,
name=None,
device_id=None,
picture_source_id=None,
settings=None,
key_colors_settings=None,
description=None,
tags: Optional[List[str]] = None,
**_kwargs,
) -> None:
"""Apply mutable field updates. Base handles common fields; subclasses handle type-specific ones."""
if name is not None:
self.name = name
if description is not None:
self.description = description
if tags is not None:
self.tags = tags
@property
def has_picture_source(self) -> bool:
"""Whether this target type uses a picture source."""
return False
def to_dict(self) -> dict:
"""Convert to dictionary."""
return {
"id": self.id,
"name": self.name,
"target_type": self.target_type,
"description": self.description,
"tags": self.tags,
"created_at": self.created_at.isoformat(),
"updated_at": self.updated_at.isoformat(),
}
@classmethod
def from_dict(cls, data: dict) -> "OutputTarget":
"""Create from dictionary, dispatching to the correct subclass."""
target_type = data.get("target_type", "led")
if target_type == "led":
from wled_controller.storage.wled_output_target import WledOutputTarget
return WledOutputTarget.from_dict(data)
if target_type == "key_colors":
from wled_controller.storage.key_colors_output_target import KeyColorsOutputTarget
return KeyColorsOutputTarget.from_dict(data)
if target_type == "ha_light":
from wled_controller.storage.ha_light_output_target import HALightOutputTarget
return HALightOutputTarget.from_dict(data)
raise ValueError(f"Unknown target type: {target_type}")