mirror of
https://github.com/python-kasa/python-kasa.git
synced 2025-08-09 20:24:02 +00:00
Rename descriptor to feature
This commit is contained in:
@@ -18,11 +18,11 @@ import logging
|
||||
from datetime import datetime, timedelta
|
||||
from typing import Any, Dict, List, Optional, Sequence, Set
|
||||
|
||||
from ..descriptors import Descriptor
|
||||
from ..device import Device, WifiNetwork
|
||||
from ..deviceconfig import DeviceConfig
|
||||
from ..emeterstatus import EmeterStatus
|
||||
from ..exceptions import SmartDeviceException
|
||||
from ..feature import Feature
|
||||
from ..protocol import BaseProtocol
|
||||
from .modules import Emeter, IotModule
|
||||
|
||||
@@ -185,9 +185,9 @@ class IotDevice(Device):
|
||||
super().__init__(host=host, config=config, protocol=protocol)
|
||||
|
||||
self._sys_info: Any = None # TODO: this is here to avoid changing tests
|
||||
self._features: Set[str] = set()
|
||||
self._children: Sequence["IotDevice"] = []
|
||||
self._supported_modules: Optional[Dict[str, IotModule]] = None
|
||||
self._legacy_features: Set[str] = set()
|
||||
|
||||
@property
|
||||
def children(self) -> Sequence["IotDevice"]:
|
||||
@@ -262,7 +262,7 @@ class IotDevice(Device):
|
||||
|
||||
@property # type: ignore
|
||||
@requires_update
|
||||
def features(self) -> Set[str]:
|
||||
def features(self) -> Dict[str, Feature]:
|
||||
"""Return a set of features that the device supports."""
|
||||
return self._features
|
||||
|
||||
@@ -278,7 +278,7 @@ class IotDevice(Device):
|
||||
@requires_update
|
||||
def has_emeter(self) -> bool:
|
||||
"""Return True if device has an energy meter."""
|
||||
return "ENE" in self.features
|
||||
return "ENE" in self._legacy_features
|
||||
|
||||
async def get_sys_info(self) -> Dict[str, Any]:
|
||||
"""Retrieve system information."""
|
||||
@@ -301,26 +301,26 @@ class IotDevice(Device):
|
||||
self._last_update = response
|
||||
self._set_sys_info(response["system"]["get_sysinfo"])
|
||||
|
||||
if not self._descriptors:
|
||||
if not self._features:
|
||||
await self._initialize_descriptors()
|
||||
|
||||
await self._modular_update(req)
|
||||
self._set_sys_info(self._last_update["system"]["get_sysinfo"])
|
||||
|
||||
async def _initialize_descriptors(self):
|
||||
self.add_descriptor(
|
||||
Descriptor(
|
||||
self.add_feature(
|
||||
Feature(
|
||||
device=self, name="RSSI", attribute_getter="rssi", icon="mdi:signal"
|
||||
)
|
||||
)
|
||||
self.add_descriptor(
|
||||
Descriptor(
|
||||
self.add_feature(
|
||||
Feature(
|
||||
device=self, name="Time", attribute_getter="time", show_in_hass=False
|
||||
)
|
||||
)
|
||||
if "on_time" in self._sys_info:
|
||||
self.add_descriptor(
|
||||
Descriptor(
|
||||
self.add_feature(
|
||||
Feature(
|
||||
device=self,
|
||||
name="On since",
|
||||
attribute_getter="on_since",
|
||||
@@ -343,8 +343,8 @@ class IotDevice(Device):
|
||||
for module in self.modules.values():
|
||||
if module.is_supported:
|
||||
supported[module._module] = module
|
||||
for _, module_desc in module._module_descriptors.items():
|
||||
self.add_descriptor(module_desc)
|
||||
for module_feat in module._module_features.values():
|
||||
self.add_feature(module_feat)
|
||||
|
||||
self._supported_modules = supported
|
||||
|
||||
@@ -395,9 +395,7 @@ class IotDevice(Device):
|
||||
"""Set sys_info."""
|
||||
self._sys_info = sys_info
|
||||
if features := sys_info.get("feature"):
|
||||
self._features = _parse_features(features)
|
||||
else:
|
||||
self._features = set()
|
||||
self._legacy_features = _parse_features(features)
|
||||
|
||||
@property # type: ignore
|
||||
@requires_update
|
||||
|
@@ -2,9 +2,9 @@
|
||||
import logging
|
||||
from typing import Any, Dict, Optional
|
||||
|
||||
from ..descriptors import Descriptor, DescriptorCategory, DescriptorType
|
||||
from ..device_type import DeviceType
|
||||
from ..deviceconfig import DeviceConfig
|
||||
from ..feature import Feature, FeatureCategory, FeatureType
|
||||
from ..protocol import BaseProtocol
|
||||
from .iotdevice import IotDevice, requires_update
|
||||
from .modules import Antitheft, Cloud, Schedule, Time, Usage
|
||||
@@ -57,15 +57,15 @@ class IotPlug(IotDevice):
|
||||
self.add_module("time", Time(self, "time"))
|
||||
self.add_module("cloud", Cloud(self, "cnCloud"))
|
||||
|
||||
self.add_descriptor(
|
||||
Descriptor(
|
||||
self.add_feature(
|
||||
Feature(
|
||||
device=self,
|
||||
name="LED",
|
||||
icon="mdi:led-{state}",
|
||||
attribute_getter="led",
|
||||
attribute_setter="set_led",
|
||||
category=DescriptorCategory.Config,
|
||||
type=DescriptorType.Switch,
|
||||
category=FeatureCategory.Config,
|
||||
type=FeatureType.Switch,
|
||||
)
|
||||
)
|
||||
|
||||
|
@@ -4,7 +4,7 @@ try:
|
||||
except ImportError:
|
||||
from pydantic import BaseModel
|
||||
|
||||
from ...descriptors import Descriptor, DescriptorType
|
||||
from ...feature import Feature, FeatureType
|
||||
from .module import IotModule
|
||||
|
||||
|
||||
@@ -28,13 +28,14 @@ class Cloud(IotModule):
|
||||
|
||||
def __init__(self, device, module):
|
||||
super().__init__(device, module)
|
||||
self.add_descriptor(
|
||||
Descriptor(
|
||||
device=self,
|
||||
name="Cloud Connection",
|
||||
self.add_feature(
|
||||
Feature(
|
||||
device=device,
|
||||
container=self,
|
||||
name="Cloud connection",
|
||||
icon="mdi:cloud",
|
||||
attribute_getter="is_connected",
|
||||
type=DescriptorType.BinarySensor,
|
||||
type=FeatureType.BinarySensor,
|
||||
)
|
||||
)
|
||||
|
||||
|
@@ -4,8 +4,8 @@ import logging
|
||||
from abc import ABC, abstractmethod
|
||||
from typing import TYPE_CHECKING, Dict
|
||||
|
||||
from ...descriptors import Descriptor
|
||||
from ...exceptions import SmartDeviceException
|
||||
from ...feature import Feature
|
||||
|
||||
if TYPE_CHECKING:
|
||||
from kasa.iot import IotDevice
|
||||
@@ -35,14 +35,14 @@ class IotModule(ABC):
|
||||
def __init__(self, device: "IotDevice", module: str):
|
||||
self._device = device
|
||||
self._module = module
|
||||
self._module_descriptors: Dict[str, Descriptor] = {}
|
||||
self._module_features: Dict[str, Feature] = {}
|
||||
|
||||
def add_descriptor(self, desc):
|
||||
def add_feature(self, feature: Feature):
|
||||
"""Add module descriptor."""
|
||||
module_desc_name = f"{self._module}_{desc.name}"
|
||||
if module_desc_name in self._module_descriptors:
|
||||
raise Exception("Duplicate name detected %s" % module_desc_name)
|
||||
self._module_descriptors[module_desc_name] = desc
|
||||
feature_name = f"{self._module}_{feature.name}"
|
||||
if feature_name in self._module_features:
|
||||
raise SmartDeviceException("Duplicate name detected %s" % feature_name)
|
||||
self._module_features[feature_name] = feature
|
||||
|
||||
@abstractmethod
|
||||
def query(self):
|
||||
|
Reference in New Issue
Block a user