Files
localthings/samsung_appliance/registry/discovery.py
T

51 lines
1.6 KiB
Python

"""Runtime discovery: device resources -> bound entities.
A device advertises a set of OCF resources, each carrying one or more `rt`
values. For every rt present in the registry, emit the capability's entities
bound to that resource href. Unknown rt is a coverage gap, logged and skipped.
"""
from __future__ import annotations
from dataclasses import dataclass
from typing import Callable, Optional
from .capability import Capability
from .entities import SamsungEntityDescription
@dataclass
class BoundEntity:
href: str
capability: Capability
desc: SamsungEntityDescription
instance: str = ''
def instance_suffix(href: str) -> str:
"""'' for the index-0 instance, else '_<n>' from the trailing segment."""
tail = href.rstrip('/').rsplit('/', 1)[-1]
if tail.isdigit() and tail != '0':
return f'_{tail}'
return ''
def discover(resources: dict[str, dict],
registry: dict[str, Capability],
log: Optional[Callable[[str], None]] = None) -> list[BoundEntity]:
out: list[BoundEntity] = []
for href, rep in resources.items():
if not isinstance(rep, dict):
continue
rts = rep.get('rt') or []
for rt in rts:
cap = registry.get(rt)
if cap is None:
if log is not None:
log(f"unknown capability {rt} at {href}")
continue
inst = instance_suffix(href)
for desc in cap.entities:
out.append(BoundEntity(href=href, capability=cap,
desc=desc, instance=inst))
return out