tags

Модуль tags предоставляет следующие функции:

1def root() -> Tag:
2  """
3  Получение корневого тега
4  """
5
6def get(tag_id: int) -> Tag:
7  """
8  Получение тега по его id
9  """
10
11def get_child_by_name(tag_id: int, name: str) -> Tag:
12  """
13  Получение потомка с именем name у тега с id = tag_id
14  """
15
16def select_by_type(tag_type: TagTypeEnum) -> Iterator[Tag]:
17  """
18  Выборка тегов по типу
19  """

Модуль также содержит классы ошибок, которые могут возникнуть при получении тегов:

1class TagNotFoundError(Exception):
2    pass
3
4class BadParamsError(Exception):
5    pass
6
7class UnknownError(Exception):
8    pass

Пример работы с этими функциями:

1from coiiot_sdk import tags
2
3root_tag = tags.root() # получение корневого тега
4
5tag = None
6tag_id = 100
7try:
8  tag = tags.get(tag_id) # получение тега с id=100
9except tags.TagNotFoundError:
10  pass
11
12if tag is not None:
13  # получение потомка с именем imchild у тега с id = 100
14  child_tag = tags.get_child_by_name(tag_id, "imchild")