python-duco-connectivity 0.4.0__tar.gz → 0.6.0__tar.gz

{python_duco_connectivity-0.4.0 → python_duco_connectivity-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-duco-connectivity
-Version: 0.4.0
+Version: 0.6.0
 Summary: Async HTTP client for the local Duco Connectivity API
 Author: Ronald van der Meer
 License-Expression: MIT
@@ -27,7 +27,7 @@ Requires-Dist: pip-audit>=2.7; extra == "dev"
 Requires-Dist: pytest>=8.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
 Requires-Dist: pytest-cov>=5.0; extra == "dev"
-Requires-Dist: ruff>=0.11; extra == "dev"
+Requires-Dist: ruff>=0.15.14; extra == "dev"
 Dynamic: license-file
 
 # python-duco-connectivity
@@ -62,9 +62,14 @@ in the development examples below.
 
 - HTTP only
 - asynchronous communication via `aiohttp`
+- typed stable config families for the documented `/config` branches
 - typed models that stay close to the API response shape
 - preserved `raw_payload` data on typed response models for forward compatibility
 
+Diagnostic subsystem reads now keep raw component and status strings from
+`Diag.SubSystems`, so future subsystem names or status values remain available
+to downstream consumers without parse fallbacks or product-specific filtering.
+
 ## Getting started
 
 ```python
@@ -102,16 +107,19 @@ public client methods, exports, compatibility aliases, and construction rules.
   captures
 - `docs/actions.md` for action discovery and execution
 - `docs/nodes.md` for node models and node information readers
+- `docs/public-api-boundaries.md` for the typed-model contract and raw escape
+  hatch boundaries
 - `docs/zones.md` for zone and group info and config readers
 - `docs/ventilation-states.md` for ventilation enum values and compatibility
   members
 - `docs/payload-preservation.md` for raw payload preservation and raw endpoint
   access
 
-The public surface keeps a split between stable typed readers and broader raw
-escape hatches. Use the typed methods when the model already matches the data
-you need, and use the raw helpers when you need endpoint coverage that has not
-been typed yet.
+The public surface keeps a deliberate split between stable typed readers and
+broader raw escape hatches. Use the typed methods when the model already
+matches the data you need, and use the raw helpers when you need endpoint
+coverage, selector flexibility, or payload fields that have not been typed yet.
+See `docs/public-api-boundaries.md` for the full contract.
 
 ## Testing strategy
 

{python_duco_connectivity-0.4.0 → python_duco_connectivity-0.6.0}/README.md

@@ -30,9 +30,14 @@ in the development examples below.
 
 - HTTP only
 - asynchronous communication via `aiohttp`
+- typed stable config families for the documented `/config` branches
 - typed models that stay close to the API response shape
 - preserved `raw_payload` data on typed response models for forward compatibility
 
+Diagnostic subsystem reads now keep raw component and status strings from
+`Diag.SubSystems`, so future subsystem names or status values remain available
+to downstream consumers without parse fallbacks or product-specific filtering.
+
 ## Getting started
 
 ```python
@@ -70,16 +75,19 @@ public client methods, exports, compatibility aliases, and construction rules.
   captures
 - `docs/actions.md` for action discovery and execution
 - `docs/nodes.md` for node models and node information readers
+- `docs/public-api-boundaries.md` for the typed-model contract and raw escape
+  hatch boundaries
 - `docs/zones.md` for zone and group info and config readers
 - `docs/ventilation-states.md` for ventilation enum values and compatibility
   members
 - `docs/payload-preservation.md` for raw payload preservation and raw endpoint
   access
 
-The public surface keeps a split between stable typed readers and broader raw
-escape hatches. Use the typed methods when the model already matches the data
-you need, and use the raw helpers when you need endpoint coverage that has not
-been typed yet.
+The public surface keeps a deliberate split between stable typed readers and
+broader raw escape hatches. Use the typed methods when the model already
+matches the data you need, and use the raw helpers when you need endpoint
+coverage, selector flexibility, or payload fields that have not been typed yet.
+See `docs/public-api-boundaries.md` for the full contract.
 
 ## Testing strategy
 

{python_duco_connectivity-0.4.0 → python_duco_connectivity-0.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-duco-connectivity"
-version = "0.4.0"
+version = "0.6.0"
 description = "Async HTTP client for the local Duco Connectivity API"
 readme = "README.md"
 license = "MIT"
@@ -38,7 +38,7 @@ dev = [
     "pytest>=8.0",
     "pytest-asyncio>=0.23",
     "pytest-cov>=5.0",
-    "ruff>=0.11",
+    "ruff>=0.15.14",
 ]
 
 [project.urls]
@@ -80,9 +80,10 @@ exclude_lines = [
 [tool.ruff]
 line-length = 100
 target-version = "py312"
+required-version = ">=0.15.14"
 
 [tool.ruff.lint]
-select = ["E", "F", "I", "UP"]
+select = ["B", "E", "F", "I", "RUF", "UP"]
 
 [tool.mypy]
 python_version = "3.12"

python_duco_connectivity-0.6.0/src/duco_connectivity/__init__.py

@@ -0,0 +1,235 @@
+"""Public package exports for python-duco-connectivity."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+from .client import DucoClient
+from .exceptions import (
+    DucoConnectionError,
+    DucoError,
+    DucoRateLimitError,
+    DucoResponseError,
+    DucoWriteLimitError,
+)
+from .models import (
+    Action,
+    ActionEnumValue,
+    ActionItem,
+    ActionItemList,
+    ActionName,
+    ActionNode,
+    ActionResult,
+    ActionResultStatus,
+    ActionValueType,
+    ApiEndpoint,
+    ApiEndpointInfo,
+    ApiInfo,
+    BoardInfo,
+    BoardName,
+    Config,
+    ConfigAutoRebootComm,
+    ConfigGeneral,
+    ConfigGeneralSubmoduleSelector,
+    ConfigGroup,
+    ConfigGroupStruct,
+    ConfigHeatRecovery,
+    ConfigHeatRecoveryBypass,
+    ConfigHeatRecoverySubmoduleSelector,
+    ConfigLan,
+    ConfigModbus,
+    ConfigModuleSelector,
+    ConfigNode,
+    ConfigNodeOverview,
+    ConfigNodeStruct,
+    ConfigSection,
+    ConfigTime,
+    ConfigValue,
+    ConfigValueOptions,
+    ConfigValueString,
+    ConfigZone,
+    ConfigZonesOverview,
+    ConfigZoneStruct,
+    ConfigZoneWithGroupStruct,
+    DeviceGroupConfigSubmoduleSelector,
+    DiagComponent,
+    DiagInfo,
+    DucoSerialNumber,
+    DucoVersion,
+    HostName,
+    InfoGeneralSubmoduleSelector,
+    InfoGroup,
+    InfoGroupStruct,
+    InfoModuleSelector,
+    InfoZone,
+    InfoZoneGroup,
+    InfoZonesOverview,
+    InfoZoneStruct,
+    IpAddress,
+    KnownActionName,
+    KnownBoardName,
+    KnownLanMode,
+    LanInfo,
+    LanMode,
+    MacAddress,
+    NetworkType,
+    Node,
+    NodeActionItemList,
+    NodeAirQualityIndex,
+    NodeAssociationId,
+    NodeCo2Ppm,
+    NodeGeneralInfo,
+    NodeIdentify,
+    NodeInfoModuleSelector,
+    NodeListActionItemList,
+    NodeMotorDeviceType,
+    NodeMotorPosition,
+    NodeMotorRequest,
+    NodeMotorStateInfo,
+    NodeName,
+    NodeOverview,
+    NodeParentId,
+    NodeRelativeHumidity,
+    NodeSensorInfo,
+    NodeSubtype,
+    NodeTemperature,
+    NodeType,
+    NodeVentilationInfo,
+    PatchConfig,
+    PatchConfigAutoRebootComm,
+    PatchConfigGeneral,
+    PatchConfigHeatRecovery,
+    PatchConfigHeatRecoveryBypass,
+    PatchConfigLan,
+    PatchConfigModbus,
+    PatchConfigModel,
+    PatchConfigNodeStruct,
+    PatchConfigNodeValue,
+    PatchConfigTime,
+    PatchConfigValue,
+    PatchConfigZoneDeviceGroupConfig,
+    PatchConfigZoneGeneral,
+    PatchConfigZoneStruct,
+    VentilationFlowLevelTarget,
+    VentilationMode,
+    VentilationState,
+    VentilationTimeEnd,
+    VentilationTimeRemaining,
+    ZoneModuleSelector,
+)
+
+try:
+    __version__ = version("python-duco-connectivity")
+except PackageNotFoundError:
+    __version__ = "0.0.0"
+
+__all__ = [
+    "Action",
+    "ActionEnumValue",
+    "ActionItem",
+    "ActionItemList",
+    "ActionName",
+    "ActionNode",
+    "ActionResult",
+    "ActionResultStatus",
+    "ActionValueType",
+    "ApiEndpoint",
+    "ApiEndpointInfo",
+    "ApiInfo",
+    "BoardInfo",
+    "BoardName",
+    "Config",
+    "ConfigAutoRebootComm",
+    "ConfigGeneral",
+    "ConfigGeneralSubmoduleSelector",
+    "ConfigGroup",
+    "ConfigGroupStruct",
+    "ConfigHeatRecovery",
+    "ConfigHeatRecoveryBypass",
+    "ConfigHeatRecoverySubmoduleSelector",
+    "ConfigLan",
+    "ConfigModbus",
+    "ConfigModuleSelector",
+    "ConfigNode",
+    "ConfigNodeOverview",
+    "ConfigNodeStruct",
+    "ConfigSection",
+    "ConfigTime",
+    "ConfigValue",
+    "ConfigValueOptions",
+    "ConfigValueString",
+    "ConfigZone",
+    "ConfigZoneStruct",
+    "ConfigZoneWithGroupStruct",
+    "ConfigZonesOverview",
+    "DeviceGroupConfigSubmoduleSelector",
+    "DiagComponent",
+    "DiagInfo",
+    "DucoClient",
+    "DucoConnectionError",
+    "DucoError",
+    "DucoRateLimitError",
+    "DucoResponseError",
+    "DucoSerialNumber",
+    "DucoVersion",
+    "DucoWriteLimitError",
+    "HostName",
+    "InfoGeneralSubmoduleSelector",
+    "InfoGroup",
+    "InfoGroupStruct",
+    "InfoModuleSelector",
+    "InfoZone",
+    "InfoZoneGroup",
+    "InfoZoneStruct",
+    "InfoZonesOverview",
+    "IpAddress",
+    "KnownActionName",
+    "KnownBoardName",
+    "KnownLanMode",
+    "LanInfo",
+    "LanMode",
+    "MacAddress",
+    "NetworkType",
+    "Node",
+    "NodeActionItemList",
+    "NodeAirQualityIndex",
+    "NodeAssociationId",
+    "NodeCo2Ppm",
+    "NodeGeneralInfo",
+    "NodeIdentify",
+    "NodeInfoModuleSelector",
+    "NodeListActionItemList",
+    "NodeMotorDeviceType",
+    "NodeMotorPosition",
+    "NodeMotorRequest",
+    "NodeMotorStateInfo",
+    "NodeName",
+    "NodeOverview",
+    "NodeParentId",
+    "NodeRelativeHumidity",
+    "NodeSensorInfo",
+    "NodeSubtype",
+    "NodeTemperature",
+    "NodeType",
+    "NodeVentilationInfo",
+    "PatchConfig",
+    "PatchConfigAutoRebootComm",
+    "PatchConfigGeneral",
+    "PatchConfigHeatRecovery",
+    "PatchConfigHeatRecoveryBypass",
+    "PatchConfigLan",
+    "PatchConfigModbus",
+    "PatchConfigModel",
+    "PatchConfigNodeStruct",
+    "PatchConfigNodeValue",
+    "PatchConfigTime",
+    "PatchConfigValue",
+    "PatchConfigZoneDeviceGroupConfig",
+    "PatchConfigZoneGeneral",
+    "PatchConfigZoneStruct",
+    "VentilationFlowLevelTarget",
+    "VentilationMode",
+    "VentilationState",
+    "VentilationTimeEnd",
+    "VentilationTimeRemaining",
+    "ZoneModuleSelector",
+    "__version__",
+]

{python_duco_connectivity-0.4.0 → python_duco_connectivity-0.6.0}/src/duco_connectivity/cli.py

@@ -77,6 +77,9 @@ METHOD_SPECS: dict[str, MethodSpec] = {
     ),
     "async_get_board_info": MethodSpec(description="Return board identity details."),
     "async_get_lan_info": MethodSpec(description="Return LAN settings."),
+    "async_get_diagnostics_info": MethodSpec(
+        description="Return the typed diagnostics response from /info?module=Diag."
+    ),
     "async_get_diagnostics": MethodSpec(description="Return diagnostic subsystem states."),
     "async_get_nodes": MethodSpec(description="Return full node information."),
     "async_get_zones_info": MethodSpec(description="Return zone information."),