ha(H1): pyfglair — cffi-ядро (очередь событий), wheel, CLI discover/monitor

- CMake: shared-таргет fgl-aircon-shared (FGL_BUILD_SHARED, PIC, SOVERSION)
- C-API: fgl_prop_raw_range + кольцевые очереди событий/логов
  (fgl_session_poll/wait_events, fgl_log_poll/wait_events): прямые колбэки
  из потоков ядра со стеком 8 КБ небезопасны для интерпретатора Python
- pyfglair: _corebuild (cmake->wheel), _cffi (ABI), Session (reader-поток ->
  loop.call_soon_threadsafe), templates (интроспекция C-таблиц), provision
  (aiohttp), CLI discover/monitor + esphome-secrets
- setup.py/pyproject: платформенный wheel py3-none-linux_x86_64 с .so
- tests/pyfglair: templates, provision (мок-облако), session + CLI против
  mock_ac.py; scripts/py-ci.sh; ci.sh запускает python-часть

tests/pyfglair/test_templates.py

@@ -0,0 +1,68 @@
+"""Интроспекция шаблонов/конверсий через cffi (сверка с C-таблицами)."""
+from __future__ import annotations
+
+from pyfglair import (
+    Prop,
+    Template,
+    ValueKind,
+    api_range,
+    convert_from_input,
+    convert_to_display,
+    detect,
+    template_info,
+)
+from pyfglair._cffi import ffi, lib
+
+
+def test_version():
+    assert ffi.string(lib.fgl_version()) == b"0.1.0"
+
+
+def test_detect():
+    assert detect("AP-WC1E") == Template.A
+    assert detect("AP-WB2E") == Template.B
+    assert detect("AP-WF3E") == Template.F
+    assert detect("UNKNOWN-MODEL") is None
+    assert detect(None) is None
+    assert detect("") is None
+
+
+def test_template_a_properties():
+    info = {p.prop: p for p in template_info(Template.A)}
+    assert info[Prop.OPERATION_MODE].name == "operation_mode"
+    assert info[Prop.OPERATION_MODE].kind == ValueKind.INT
+    assert info[Prop.OPERATION_MODE].read_only is False
+    assert info[Prop.OPERATION_MODE].raw_min == 0
+    assert info[Prop.OPERATION_MODE].raw_max == 6
+    assert info[Prop.DISPLAY_TEMPERATURE].read_only is True
+    assert info[Prop.DISPLAY_TEMPERATURE].base_type == "integer"
+    assert info[Prop.DEVICE_NAME].kind == ValueKind.STRING
+    assert info[Prop.ADJUST_TEMPERATURE].raw_min == -100
+    assert info[Prop.ADJUST_TEMPERATURE].raw_max == 450
+    assert Prop.AF_VERTICAL_MOVE_STEP1 not in info
+
+
+def test_template_b_and_f():
+    info_b = {p.prop: p for p in template_info(Template.B)}
+    assert Prop.AF_VERTICAL_MOVE_STEP1 in info_b
+    assert Prop.DISPLAY_TEMPERATURE not in info_b
+    info_f = {p.prop: p for p in template_info(Template.F)}
+    assert Prop.DISPLAY_TEMPERATURE in info_f
+    assert Prop.MONITOR1 in info_f
+    assert Prop.FILTER_SIGN_RESET in info_f
+    assert Prop.FILTER_SIGN_RESET_DISPLAY not in info_f
+
+
+def test_conversions():
+    assert convert_to_display(Template.A, Prop.DISPLAY_TEMPERATURE, 7000) == 200
+    assert convert_to_display(Template.A, Prop.DISPLAY_TEMPERATURE, 5000) == 0
+    assert convert_to_display(Template.A, Prop.ADJUST_TEMPERATURE, 250) == 250
+    assert convert_from_input(Template.A, Prop.DISPLAY_TEMPERATURE, 200) == 7000
+    assert convert_from_input(Template.A, Prop.ADJUST_TEMPERATURE, 220) == 220
+
+
+def test_api_range():
+    assert api_range(Template.A, Prop.DISPLAY_TEMPERATURE) == (-100, 450)
+    assert api_range(Template.A, Prop.OPERATION_MODE) == (0, 6)
+    assert api_range(Template.A, Prop.DEVICE_NAME) is None
+    assert api_range(Template.B, Prop.DISPLAY_TEMPERATURE) is None