pyh0n/pyhon/appliance.py

328 lines
10 KiB
Python
Raw Normal View History

2023-03-05 23:16:51 +05:30
import importlib
2023-05-11 04:13:48 +05:30
import json
2023-04-23 23:44:52 +05:30
import logging
from contextlib import suppress
2023-05-07 03:58:24 +05:30
from datetime import datetime, timedelta
2023-05-11 04:13:48 +05:30
from pathlib import Path
2023-04-15 19:25:22 +05:30
from typing import Optional, Dict, Any
from typing import TYPE_CHECKING
2023-03-05 23:16:51 +05:30
2023-05-11 04:13:48 +05:30
from pyhon import helper
2023-02-13 08:06:09 +05:30
from pyhon.commands import HonCommand
2023-05-08 05:53:48 +05:30
from pyhon.parameter.base import HonParameter
2023-04-16 05:13:37 +05:30
from pyhon.parameter.fixed import HonParameterFixed
2023-02-13 06:11:38 +05:30
2023-04-15 19:25:22 +05:30
if TYPE_CHECKING:
from pyhon import HonAPI
2023-04-23 23:44:52 +05:30
_LOGGER = logging.getLogger(__name__)
2023-04-09 21:43:50 +05:30
class HonAppliance:
2023-05-07 03:58:24 +05:30
_MINIMAL_UPDATE_INTERVAL = 5 # seconds
2023-04-15 19:25:22 +05:30
def __init__(
self, api: Optional["HonAPI"], info: Dict[str, Any], zone: int = 0
) -> None:
2023-04-10 00:20:28 +05:30
if attributes := info.get("attributes"):
info["attributes"] = {v["parName"]: v["parValue"] for v in attributes}
2023-04-15 19:25:22 +05:30
self._info: Dict = info
self._api: Optional[HonAPI] = api
self._appliance_model: Dict = {}
2023-02-13 06:11:38 +05:30
2023-04-15 19:25:22 +05:30
self._commands: Dict = {}
self._statistics: Dict = {}
self._attributes: Dict = {}
2023-04-16 01:55:34 +05:30
self._zone: int = zone
2023-05-06 23:30:13 +05:30
self._additional_data: Dict[str, Any] = {}
2023-05-07 03:58:24 +05:30
self._last_update = None
2023-05-08 05:53:48 +05:30
self._default_setting = HonParameter("", {}, "")
2023-02-13 06:11:38 +05:30
2023-03-08 05:28:25 +05:30
try:
2023-04-10 00:25:36 +05:30
self._extra = importlib.import_module(
f"pyhon.appliances.{self.appliance_type.lower()}"
2023-04-24 01:12:44 +05:30
).Appliance(self)
2023-03-08 05:28:25 +05:30
except ModuleNotFoundError:
self._extra = None
def __getitem__(self, item):
2023-04-15 07:42:38 +05:30
if self._zone:
item += f"Z{self._zone}"
2023-03-08 05:28:25 +05:30
if "." in item:
result = self.data
for key in item.split("."):
2023-04-15 07:42:38 +05:30
if all(k in "0123456789" for k in key) and isinstance(result, list):
2023-03-08 05:28:25 +05:30
result = result[int(key)]
else:
result = result[key]
return result
2023-04-15 07:42:38 +05:30
if item in self.data:
return self.data[item]
if item in self.attributes["parameters"]:
return self.attributes["parameters"].get(item)
return self.info[item]
2023-02-13 06:11:38 +05:30
2023-03-09 02:23:53 +05:30
def get(self, item, default=None):
try:
return self[item]
2023-03-09 02:48:44 +05:30
except (KeyError, IndexError):
2023-03-09 02:23:53 +05:30
return default
2023-04-15 07:42:38 +05:30
def _check_name_zone(self, name: str, frontend: bool = True) -> str:
middle = " Z" if frontend else "_z"
if (attribute := self._info.get(name, "")) and self._zone:
return f"{attribute}{middle}{self._zone}"
return attribute
2023-02-13 06:11:38 +05:30
@property
2023-04-15 07:42:38 +05:30
def appliance_model_id(self) -> str:
2023-04-15 19:25:22 +05:30
return self._info.get("applianceModelId", "")
2023-02-13 06:11:38 +05:30
@property
2023-04-15 07:42:38 +05:30
def appliance_type(self) -> str:
2023-04-15 19:25:22 +05:30
return self._info.get("applianceTypeName", "")
2023-02-13 06:11:38 +05:30
@property
2023-04-15 07:42:38 +05:30
def mac_address(self) -> str:
2023-04-16 01:28:20 +05:30
return self.info.get("macAddress", "")
@property
def unique_id(self) -> str:
2023-04-15 07:42:38 +05:30
return self._check_name_zone("macAddress", frontend=False)
2023-02-13 06:11:38 +05:30
@property
2023-04-15 07:42:38 +05:30
def model_name(self) -> str:
return self._check_name_zone("modelName")
2023-02-13 06:11:38 +05:30
@property
2023-04-15 07:42:38 +05:30
def nick_name(self) -> str:
return self._check_name_zone("nickName")
2023-02-13 06:11:38 +05:30
2023-05-20 16:54:24 +05:30
@property
def code(self) -> str:
if code := self.info.get("code"):
return code
serial_number = self.info.get("serialNumber", "")
return serial_number[:8] if len(serial_number) < 18 else serial_number[:11]
2023-02-13 06:11:38 +05:30
@property
2023-05-21 05:55:43 +05:30
def options(self):
return self._appliance_model.get("options", {})
2023-02-13 06:11:38 +05:30
@property
def commands(self):
return self._commands
@property
def attributes(self):
2023-03-05 01:57:10 +05:30
return self._attributes
2023-02-13 06:11:38 +05:30
@property
def statistics(self):
return self._statistics
2023-03-05 23:16:51 +05:30
@property
2023-04-10 00:20:28 +05:30
def info(self):
return self._info
2023-03-05 23:16:51 +05:30
2023-05-06 19:37:28 +05:30
@property
def additional_data(self):
return self._additional_data
2023-04-16 01:55:34 +05:30
@property
def zone(self) -> int:
return self._zone
2023-05-06 23:30:13 +05:30
@property
2023-05-11 04:13:48 +05:30
def api(self) -> Optional["HonAPI"]:
2023-05-06 23:30:13 +05:30
return self._api
2023-05-06 19:37:28 +05:30
async def _recover_last_command_states(self):
2023-05-06 23:30:13 +05:30
command_history = await self.api.command_history(self)
2023-05-06 19:37:28 +05:30
for name, command in self._commands.items():
2023-04-10 00:25:36 +05:30
last = next(
(
index
for (index, d) in enumerate(command_history)
if d.get("command", {}).get("commandName") == name
),
None,
)
2023-03-11 07:01:56 +05:30
if last is None:
continue
parameters = command_history[last].get("command", {}).get("parameters", {})
2023-05-07 21:09:22 +05:30
if command.categories and (
parameters.get("program") or parameters.get("category")
):
2023-05-07 04:17:08 +05:30
if parameters.get("program"):
command.category = parameters.pop("program").split(".")[-1].lower()
else:
command.category = parameters.pop("category")
2023-03-11 07:01:56 +05:30
command = self.commands[name]
for key, data in command.settings.items():
2023-04-10 00:25:36 +05:30
if (
not isinstance(data, HonParameterFixed)
and parameters.get(key) is not None
):
with suppress(ValueError):
data.value = parameters.get(key)
2023-03-11 07:01:56 +05:30
2023-05-06 19:37:28 +05:30
def _get_categories(self, command, data):
categories = {}
for category, value in data.items():
result = self._get_command(value, command, category, categories)
if result:
if "PROGRAM" in category:
category = category.split(".")[-1].lower()
categories[category] = result[0]
if categories:
2023-05-15 22:59:42 +05:30
if "setParameters" in categories:
return [categories["setParameters"]]
return [list(categories.values())[0]]
2023-05-06 19:37:28 +05:30
return []
def _get_commands(self, data):
commands = []
for command, value in data.items():
commands += self._get_command(value, command, "")
return {c.name: c for c in commands}
def _get_command(self, data, command="", category="", categories=None):
commands = []
if isinstance(data, dict):
if data.get("description") and data.get("protocolType", None):
commands += [
HonCommand(
2023-04-16 03:41:50 +05:30
command,
2023-05-06 19:37:28 +05:30
data,
2023-04-16 03:41:50 +05:30
self,
2023-05-06 19:37:28 +05:30
category_name=category,
categories=categories,
2023-04-16 03:41:50 +05:30
)
2023-05-06 19:37:28 +05:30
]
else:
commands += self._get_categories(command, data)
2023-05-06 23:30:13 +05:30
elif category:
self._additional_data.setdefault(command, {})[category] = data
2023-05-06 19:37:28 +05:30
else:
self._additional_data[command] = data
return commands
2023-02-20 00:13:41 +05:30
2023-05-06 19:37:28 +05:30
async def load_commands(self):
2023-05-06 23:30:13 +05:30
raw = await self.api.load_commands(self)
2023-05-06 19:37:28 +05:30
self._appliance_model = raw.pop("applianceModel")
2023-05-08 03:33:29 +05:30
raw.pop("dictionaryId", None)
2023-05-06 19:37:28 +05:30
self._commands = self._get_commands(raw)
await self._recover_last_command_states()
2023-02-19 02:55:51 +05:30
2023-02-13 06:11:38 +05:30
async def load_attributes(self):
2023-05-06 23:30:13 +05:30
self._attributes = await self.api.load_attributes(self)
2023-04-24 08:03:00 +05:30
for name, values in self._attributes.pop("shadow").get("parameters").items():
2023-03-08 05:28:25 +05:30
self._attributes.setdefault("parameters", {})[name] = values["parNewVal"]
2023-02-13 06:11:38 +05:30
async def load_statistics(self):
2023-05-06 23:30:13 +05:30
self._statistics = await self.api.load_statistics(self)
2023-05-13 03:46:52 +05:30
self._statistics |= await self.api.load_maintenance(self)
2023-02-13 08:06:09 +05:30
async def update(self):
2023-05-07 03:58:24 +05:30
now = datetime.now()
if not self._last_update or self._last_update < now - timedelta(
seconds=self._MINIMAL_UPDATE_INTERVAL
):
self._last_update = now
await self.load_attributes()
2023-03-03 22:54:19 +05:30
2023-05-06 19:37:28 +05:30
@property
2023-05-06 23:30:13 +05:30
def command_parameters(self):
return {n: c.parameter_value for n, c in self._commands.items()}
2023-05-06 19:37:28 +05:30
@property
def settings(self):
result = {}
for name, command in self._commands.items():
for key in command.setting_keys:
2023-05-08 05:53:48 +05:30
setting = command.settings.get(key, self._default_setting)
2023-05-06 19:37:28 +05:30
result[f"{name}.{key}"] = setting
if self._extra:
return self._extra.settings(result)
return result
2023-05-07 03:58:24 +05:30
@property
def available_settings(self):
result = []
for name, command in self._commands.items():
for key in command.setting_keys:
result.append(f"{name}.{key}")
return result
2023-03-03 22:54:19 +05:30
@property
def data(self):
2023-04-10 00:25:36 +05:30
result = {
"attributes": self.attributes,
"appliance": self.info,
"statistics": self.statistics,
2023-05-06 19:37:28 +05:30
"additional_data": self._additional_data,
2023-05-06 23:30:13 +05:30
**self.command_parameters,
2023-04-10 00:25:36 +05:30
}
2023-03-08 05:28:25 +05:30
if self._extra:
2023-04-08 07:36:36 +05:30
return self._extra.data(result)
2023-03-08 05:28:25 +05:30
return result
2023-04-12 01:44:36 +05:30
2023-05-13 03:46:52 +05:30
def diagnose(self, whitespace=" ", command_only=False):
2023-05-06 23:30:13 +05:30
data = {
"attributes": self.attributes.copy(),
"appliance": self.info,
2023-05-13 03:46:52 +05:30
"statistics": self.statistics,
2023-05-06 23:30:13 +05:30
"additional_data": self._additional_data,
}
2023-05-08 03:33:29 +05:30
if command_only:
data.pop("attributes")
data.pop("appliance")
2023-05-13 03:46:52 +05:30
data.pop("statistics")
2023-05-06 23:30:13 +05:30
data |= {n: c.parameter_groups for n, c in self._commands.items()}
extra = {n: c.data for n, c in self._commands.items() if c.data}
if extra:
data |= {"extra_command_data": extra}
2023-05-19 04:18:08 +05:30
for sensible in ["PK", "SK", "serialNumber", "coords", "device"]:
2023-05-08 03:33:29 +05:30
data.get("appliance", {}).pop(sensible, None)
2023-05-06 23:30:13 +05:30
result = helper.pretty_print({"data": data}, whitespace=whitespace)
2023-04-12 01:44:36 +05:30
result += helper.pretty_print(
2023-05-21 05:55:43 +05:30
{
"commands": helper.create_command(self.commands),
"rules": helper.create_rules(self.commands),
},
2023-05-06 23:30:13 +05:30
whitespace=whitespace,
2023-04-12 01:44:36 +05:30
)
2023-04-24 08:03:00 +05:30
return result.replace(self.mac_address, "xx-xx-xx-xx-xx-xx")
2023-05-11 04:13:48 +05:30
class HonApplianceTest(HonAppliance):
def __init__(self, name):
super().__init__(None, {})
self._name = name
self.load_commands()
self._info = self._appliance_model
def load_commands(self):
device = Path(__file__).parent / "test_data" / f"{self._name}.json"
with open(str(device)) as f:
raw = json.loads(f.read())
self._appliance_model = raw.pop("applianceModel")
raw.pop("dictionaryId", None)
self._commands = self._get_commands(raw)
async def update(self):
return
@property
def nick_name(self) -> str:
return self._name
@property
def unique_id(self) -> str:
return self._name
@property
def mac_address(self) -> str:
return "xx-xx-xx-xx-xx-xx"