nwp500-python 9.5.0__tar.gz → 9.5.1__tar.gz

{nwp500_python-9.5.0 → nwp500_python-9.5.1}/CHANGELOG.rst

@@ -2,6 +2,20 @@
 Changelog
 =========
 
+Version 9.5.1 (2026-10-21)
+==========================
+
+Fixed
+-----
+- **A steady Home Assistant sensor no longer goes stale in the
+  simulator** (#174). ``sim_home_assistant.parse_state`` dated a state by
+  ``last_updated``, which moves only when the value or its attributes
+  change. An air sensor holding the same value for over an hour failed
+  ``fresh()``, and the simulation fell back to the default air
+  temperature. A state is now dated by ``last_reported`` (Home Assistant
+  2024.3 and later), then ``last_updated``, then ``last_changed``. The
+  history parsers still date each change row by its change.
+
 Version 9.5.0 (2026-10-20)
 ==========================
 

{nwp500_python-9.5.0/src/nwp500_python.egg-info → nwp500_python-9.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nwp500-python
-Version: 9.5.0
+Version: 9.5.1
 Summary: A library for controlling Navien NWP500 Water Heaters via NaviLink
 Home-page: https://github.com/eman/nwp500-python
 Author: Emmanuel Levijarvi
@@ -72,9 +72,7 @@ Features
 * **Monitoring:** Real-time tracking of temperature, power usage, tank charge, and component status.
 * **Control:** Remote control of target temperatures, operation modes, and vacation settings.
 * **Scheduling:** Reservations, time-of-use (TOU) schedules and anti-legionella cycles.
-* **Typed models:** Pydantic models with validation and unit handling.
-* **Async:** Built on asyncio.
-* **Simulator (optional):** A physics model of the heater, ``nwp500.sim``, that answers "when will the tank be hot?", "how much hot water is there?" and "what would this change do?", and calibrates from a heater's own history. ``nwp-cli simulate`` runs it on the heater as it is now or on a scenario file. Install it with ``pip install nwp500-python[sim]``.
+* **Simulator (optional):** ``nwp500.sim``, a physics model of the heater. It estimates recovery time and available hot water, projects the effect of a change to the schedule or settings, and calibrates against a heater's own history. ``nwp-cli simulate`` runs it against the live heater or a scenario file. Install with ``pip install nwp500-python[sim]``.
 
 Getting Started
 ===============

{nwp500_python-9.5.0 → nwp500_python-9.5.1}/README.rst

@@ -18,9 +18,7 @@ Features
 * **Monitoring:** Real-time tracking of temperature, power usage, tank charge, and component status.
 * **Control:** Remote control of target temperatures, operation modes, and vacation settings.
 * **Scheduling:** Reservations, time-of-use (TOU) schedules and anti-legionella cycles.
-* **Typed models:** Pydantic models with validation and unit handling.
-* **Async:** Built on asyncio.
-* **Simulator (optional):** A physics model of the heater, ``nwp500.sim``, that answers "when will the tank be hot?", "how much hot water is there?" and "what would this change do?", and calibrates from a heater's own history. ``nwp-cli simulate`` runs it on the heater as it is now or on a scenario file. Install it with ``pip install nwp500-python[sim]``.
+* **Simulator (optional):** ``nwp500.sim``, a physics model of the heater. It estimates recovery time and available hot water, projects the effect of a change to the schedule or settings, and calibrates against a heater's own history. ``nwp-cli simulate`` runs it against the live heater or a scenario file. Install with ``pip install nwp500-python[sim]``.
 
 Getting Started
 ===============

{nwp500_python-9.5.0 → nwp500_python-9.5.1}/src/nwp500/sim_home_assistant.py

@@ -222,9 +222,11 @@ class State:
 
 
 def parse_state(doc: Any) -> State:
-    """``/api/states/<entity>``'s answer. ``at`` is the entity's last
-    state or attribute change (``last_updated``), as the reference
-    implementation's change rows date a reading."""
+    """``/api/states/<entity>``'s answer. ``at`` is when the entity
+    last reported (``last_reported``), so a sensor that keeps reporting
+    the same value stays fresh. Home Assistant before 2024.3 has no
+    ``last_reported``; then ``at`` is the last state or attribute change
+    (``last_updated``, else ``last_changed``)."""
     if not isinstance(doc, Mapping) or "state" not in doc:
         raise HomeAssistantError("not an entity state")
     d = cast(Mapping[str, Any], doc)
@@ -233,7 +235,9 @@ def parse_state(doc: Any) -> State:
     if isinstance(attributes, Mapping):
         u = cast(Mapping[str, Any], attributes).get("unit_of_measurement")
         unit = u if isinstance(u, str) else None
-    stamp = d.get("last_updated") or d.get("last_changed")
+    stamp = (
+        d.get("last_reported") or d.get("last_updated") or d.get("last_changed")
+    )
     return State(
         entity=str(d.get("entity_id", "")),
         value=_number(d.get("state")),

{nwp500_python-9.5.0 → nwp500_python-9.5.1/src/nwp500_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nwp500-python
-Version: 9.5.0
+Version: 9.5.1
 Summary: A library for controlling Navien NWP500 Water Heaters via NaviLink
 Home-page: https://github.com/eman/nwp500-python
 Author: Emmanuel Levijarvi
@@ -72,9 +72,7 @@ Features
 * **Monitoring:** Real-time tracking of temperature, power usage, tank charge, and component status.
 * **Control:** Remote control of target temperatures, operation modes, and vacation settings.
 * **Scheduling:** Reservations, time-of-use (TOU) schedules and anti-legionella cycles.
-* **Typed models:** Pydantic models with validation and unit handling.
-* **Async:** Built on asyncio.
-* **Simulator (optional):** A physics model of the heater, ``nwp500.sim``, that answers "when will the tank be hot?", "how much hot water is there?" and "what would this change do?", and calibrates from a heater's own history. ``nwp-cli simulate`` runs it on the heater as it is now or on a scenario file. Install it with ``pip install nwp500-python[sim]``.
+* **Simulator (optional):** ``nwp500.sim``, a physics model of the heater. It estimates recovery time and available hot water, projects the effect of a change to the schedule or settings, and calibrates against a heater's own history. ``nwp-cli simulate`` runs it against the live heater or a scenario file. Install with ``pip install nwp500-python[sim]``.
 
 Getting Started
 ===============

nwp500_python-9.5.1/src/nwp500_python.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "9.5.1",
+  "distance": 0,
+  "node": "gc7449be88920257c7be8f54c853a2586a5eb93b9",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-10-21"
+}

{nwp500_python-9.5.0 → nwp500_python-9.5.1}/tests/test_sim_home_assistant.py

@@ -46,15 +46,27 @@ class TestParsing:
     def test_no_value_is_none(self, value: str) -> None:
         assert ha.parse_state(_state("sensor.air", value, "°F")).value is None
 
-    def test_freshness_is_the_last_update(self) -> None:
+    def test_freshness_is_the_last_report(self) -> None:
+        # A steady sensor: its value last changed 2 h ago, but it
+        # reported just now.
+        doc = _state("sensor.air", "61.5", "°F", timedelta(hours=2)) | {
+            "last_reported": NOW.isoformat(),
+        }
+        s = ha.parse_state(doc)
+        assert s.at == NOW
+        assert ha.fresh(s, NOW)
+
+    def test_without_a_report_the_last_update_then_change(self) -> None:
+        # Home Assistant before 2024.3 sends no last_reported.
         doc = _state("sensor.air", "61.5", "°F") | {
+            "last_changed": (NOW - timedelta(hours=3)).isoformat(),
             "last_updated": (NOW - timedelta(hours=2)).isoformat(),
-            "last_reported": NOW.isoformat(),
         }
         s = ha.parse_state(doc)
         assert s.at == NOW - timedelta(hours=2)
         assert not ha.fresh(s, NOW)
-        assert ha.fresh(ha.parse_state(_state("sensor.air", 1, "°F")), NOW)
+        del doc["last_updated"]
+        assert ha.parse_state(doc).at == NOW - timedelta(hours=3)
 
     def test_not_a_state(self) -> None:
         with pytest.raises(ha.HomeAssistantError):

nwp500_python-9.5.0/src/nwp500_python.egg-info/scm_version.json

@@ -1,8 +0,0 @@
-{
-  "tag": "9.5.0",
-  "distance": 0,
-  "node": "g6cedb29424f8b893710077157a5ba6539796ee3e",
-  "dirty": false,
-  "branch": "HEAD",
-  "node_date": "2026-10-20"
-}