span-panel-api-schema-0 1.1.2__tar.gz → 1.2.0__tar.gz

{span_panel_api_schema_0-1.1.2 → span_panel_api_schema_0-1.2.0}/CHANGELOG.md

@@ -9,6 +9,15 @@ rather than by this version number. A release here means this parser changed, ne
 
 Pre-releases are not listed separately. A beta is a step towards the next public version, so its changes are folded into that version's entry as they land and are described against the last public release, never against the beta before it.
 
+## [1.2.0]
+
+The panel's one inverter is reported through `pv_inverters` as well as `pv`. Requires `span-panel-api` **3.6.0 or newer**.
+
+### Added
+
+- **`pv_inverters` holds the panel's one inverter** under the key `span-panel-api-schema-1` gives it, so a consumer can read every panel through that field.
+- **`pv.device_id` and `pv.node_id`** give the inverter's flat node id and its `pv_inverters` key.
+
 ## [1.1.2]
 
 The reference schema document this parser is tested against now ships in the wheel.

{span_panel_api_schema_0-1.1.2 → span_panel_api_schema_0-1.2.0}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.5
 Name: span-panel-api-schema-0
-Version: 1.1.2
+Version: 1.2.0
 Summary: Flat-schema (data-model-version absent) parser for span-panel-api
 Project-URL: Homepage, https://github.com/SpanPanel/span-panel-api
 Project-URL: Issues, https://github.com/SpanPanel/span-panel-api/issues
 Author: SpanPanel
 License-Expression: MIT
 Requires-Python: <4.0,>=3.14
-Requires-Dist: span-panel-api<4.0,>=3.1.0
+Requires-Dist: span-panel-api<4.0,>=3.6.0
 Description-Content-Type: text/markdown
 
 # span-panel-api-schema-0

{span_panel_api_schema_0-1.1.2 → span_panel_api_schema_0-1.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "span-panel-api-schema-0"
-version = "1.1.2"
+version = "1.2.0"
 description = "Flat-schema (data-model-version absent) parser for span-panel-api"
 authors = [
     {name = "SpanPanel"}
@@ -16,7 +16,10 @@ dependencies = [
     # for `set_*_target` instead of `set_*_topic`. Against 3.0.x this wheel is
     # rejected at discovery for carrying names that bootstrap does not require —
     # so the floor moves with the rename rather than trailing it.
-    "span-panel-api>=3.1.0,<4.0",
+    # Raised to 3.6.0, the first bootstrap whose snapshot carries `pv_inverters`
+    # and the inverter's `device_id` and `node_id`, which this parser fills.
+    # Against an earlier one, building a snapshot fails on those arguments.
+    "span-panel-api>=3.6.0,<4.0",
 ]
 
 [project.urls]

{span_panel_api_schema_0-1.1.2 → span_panel_api_schema_0-1.2.0}/src/span_panel_api_schema_0/consumer.py

@@ -423,13 +423,18 @@ class HomieDeviceConsumer:
         feed = self._acc.get_prop(pv_node, "feed")
         rel_pos = self._acc.get_prop(pv_node, "relative-position")
 
+        feed_circuit_id = normalize_circuit_id(feed) if feed else None
         return SpanPVSnapshot(
             vendor_name=vn if vn else None,
             model=pn if pn else None,
             software_version=sw if sw else None,
             nameplate_capacity_w=_parse_float(nc) if nc else None,
-            feed_circuit_id=normalize_circuit_id(feed) if feed else None,
+            feed_circuit_id=feed_circuit_id,
             relative_position=rel_pos.upper() if rel_pos else None,
+            device_id=pv_node,
+            # The same key schema_1 gives this inverter, so a consumer's handle
+            # for it survives the panel's upgrade to the parent/child schema.
+            node_id=feed_circuit_id or pv_node,
         )
 
     def _build_evse_devices(self) -> dict[str, SpanEvseSnapshot]:
@@ -726,5 +731,8 @@ class HomieDeviceConsumer:
             circuits=circuits,
             battery=battery,
             pv=pv,
+            # Flat publishes one inverter at most, so this is `pv` again, keyed
+            # as schema_1 keys each of its inverters.
+            pv_inverters={pv.node_id: pv} if pv.node_id is not None else {},
             evse=evse,
         )