nwp500-python 9.4.0__tar.gz → 9.4.1__tar.gz

{nwp500_python-9.4.0 → nwp500_python-9.4.1}/CHANGELOG.rst

@@ -5,6 +5,20 @@ Changelog
 Unreleased
 ==========
 
+Version 9.4.1 (2026-09-17)
+==========================
+
+Fixed
+-----
+- **The reconnect attempt counter never reset after a successful quick or
+  deep reconnect.** Both build a new connection, so the SDK never calls
+  ``on_connection_resumed``, the only place the counter was reset. Each
+  later interruption started where the last one stopped: its first delay
+  was longer and it reached the deep-reconnect threshold sooner. A
+  long-running client saw the first delay grow from about 1 s to 12 s
+  over five daily AWS IoT disconnects. The counter now resets whenever the
+  backoff loop ends connected.
+
 Version 9.4.0 (2026-09-12)
 ==========================
 

{nwp500_python-9.4.0/src/nwp500_python.egg-info → nwp500_python-9.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nwp500-python
-Version: 9.4.0
+Version: 9.4.1
 Summary: A library for controlling Navien NWP500 Water Heaters via NaviLink
 Home-page: https://github.com/eman/nwp500-python
 Author: Emmanuel Levijarvi

{nwp500_python-9.4.0 → nwp500_python-9.4.1}/docs/explanation/tank-energy.rst

@@ -3,7 +3,7 @@ Tank Energy
 ===========
 
 The NWP500 reports two energy figures, ``totalEnergyCapacity`` and
-``availableEnergyCapacity``. Both names mislead, and before v10.0 this
+``availableEnergyCapacity``. Both names mislead, and before v9.3.0 this
 library also scaled them wrongly. This page explains what they
 actually measure and shows the evidence for the correction.
 
@@ -33,7 +33,7 @@ The short version
        whenever the setpoint moves.
 
 Both are raw counts of 4 Wh each, not Watt-hours. Library versions before
-10.0 multiplied by 10, overstating tank energy by 2.5x.
+9.3.0 multiplied by 10, overstating tank energy by 2.5x.
 
 Both are also measured **from the setpoint**, so both describe potential
 rather than content: move the setpoint and both change while the water in
@@ -226,7 +226,7 @@ coefficient of performance:
    * - 4 Wh/count (corrected)
      - 2.89
      - Normal for a heat pump water heater
-   * - 10 Wh/count (pre-10.0)
+   * - 10 Wh/count (pre-9.3.0)
      - 7.02
      - Physically impossible
 
@@ -236,7 +236,7 @@ A heat pump water heater in a 72 degF room runs at a COP of roughly 2 to
 This argument is worth stating separately because it needs no tank
 volume, specific heat or stratification model - only the device's own
 reported energy and its own reported power. It cannot tell you what the
-quantum *is*, but it rules out the pre-10.0 value regardless of anything
+quantum *is*, but it rules out the pre-9.3.0 value regardless of anything
 assumed elsewhere on this page.
 
 .. _two branches:
@@ -403,8 +403,8 @@ the heat capacity is 156 Wh per degF:
    drawable_Wh = 156 * (tank_mean_temperature - your_floor_degF)
 
 
-Migrating from before v10.0
-===========================
+Migrating from before v9.3.0
+============================
 
 .. list-table::
    :header-rows: 1
@@ -429,7 +429,7 @@ rename that is missed fails immediately with ``AttributeError`` instead
 of silently returning a number 2.5x too large.
 
 If you logged these values historically, the stored series needs
-rescaling by 0.4 to be comparable with values from v10.0 onward.
+rescaling by 0.4 to be comparable with values from v9.3.0 onward.
 
 
 See also

{nwp500_python-9.4.0 → nwp500_python-9.4.1}/docs/reference/protocol/data_conversions.rst

@@ -367,7 +367,7 @@ Power and Energy Fields
    candidate implying a water volume below the nameplate. Two further
    checks agree -- 183 heating recoveries give 4.11 Wh/count by a
    noisier route, and the same recoveries imply a heat-pump COP of 2.89.
-   The library uses 4.0. Versions before 10.0 used 10, which overstated
+   The library uses 4.0. Versions before 9.3.0 used 10, which overstated
    reported tank energy by 2.5x and implied a physically impossible COP
    of 7.0. See :doc:`../../explanation/tank-energy`.
 

{nwp500_python-9.4.0 → nwp500_python-9.4.1}/docs/reference/python_api/models.rst

@@ -263,7 +263,7 @@ Complete real-time device status with 100+ fields.
 
    .. warning::
       These replace ``total_energy_capacity`` and
-      ``available_energy_capacity``, which were **removed** in v10.0. The
+      ``available_energy_capacity``, which were **removed** in v9.3.0. The
       old names were misleading -- ``available_energy_capacity`` is the
       energy *needed*, not the energy available -- and both were scaled
       2.5x too large. For energy you can actually draw, see

{nwp500_python-9.4.0 → nwp500_python-9.4.1}/src/nwp500/converters.py

@@ -45,7 +45,7 @@ __all__ = [
 #:   p90 4.45), agreeing to within 2% by a noisier route
 #: * the same recoveries imply a heat pump COP of 2.89 at 4 Wh/count
 #:
-#: Library versions before 10.0 used 10 Wh/count, which overstated reported
+#: Library versions before 9.3.0 used 10 Wh/count, which overstated reported
 #: tank energy by 2.5x and implied a physically impossible COP of 7.0.
 #:
 #: See ``docs/explanation/tank-energy.rst`` for the full derivation.

{nwp500_python-9.4.0 → nwp500_python-9.4.1}/src/nwp500/mqtt/reconnection.py

@@ -347,6 +347,13 @@ class MqttReconnectionHandler:
                     f"Error during reconnection attempt: {e}", exc_info=True
                 )
 
+        # A successful quick or deep reconnect builds a new connection, so
+        # the SDK never calls on_connection_resumed for it. Reset the
+        # counter here, or every later interruption starts with a longer
+        # backoff and an earlier deep reconnect than the first one did.
+        if self._is_connected_func():
+            self._reconnect_attempts = 0
+
         # Check final state: report failure when retries are exhausted
         # (limited mode) or a fatal error stopped the loop.
         attempts_exhausted = (

{nwp500_python-9.4.0 → nwp500_python-9.4.1/src/nwp500_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nwp500-python
-Version: 9.4.0
+Version: 9.4.1
 Summary: A library for controlling Navien NWP500 Water Heaters via NaviLink
 Home-page: https://github.com/eman/nwp500-python
 Author: Emmanuel Levijarvi

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

@@ -0,0 +1,8 @@
+{
+  "tag": "9.4.1",
+  "distance": 0,
+  "node": "g36a97ba8f8ce20912973b352fe380686a4f46ad1",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-09-17"
+}

{nwp500_python-9.4.0 → nwp500_python-9.4.1}/tests/test_mqtt_reliability.py

@@ -231,6 +231,45 @@ class TestReconnectLoopExceptionHandling:
         assert all(d <= config.max_reconnect_delay for d in sleeps)
         assert all(d > 0 for d in sleeps)
 
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize("deep", [False, True])
+    async def test_successful_reconnect_resets_attempt_count(self, deep):
+        """Regression: a quick or deep reconnect makes a new connection, so
+        on_connection_resumed never fires and the counter kept growing
+        across interruptions, lengthening each later backoff."""
+        connected = False
+        attempts = []
+
+        async def reconnect():
+            nonlocal connected
+            attempts.append(1)
+            # Fail the first try of each interruption, then succeed.
+            if len(attempts) % 2 == 0:
+                connected = True
+                return
+            raise MqttNotConnectedError("down")
+
+        kwargs = {"deep_reconnect_func": reconnect} if deep else {}
+        config = _fast_config(
+            max_reconnect_attempts=-1,
+            deep_reconnect_threshold=1,
+        )
+        handler = _make_handler(
+            config,
+            lambda: connected,
+            reconnect,
+            **kwargs,
+        )
+        handler.enable()
+
+        for _ in range(3):
+            connected = False
+            await handler._reconnect_with_backoff()
+            assert connected
+            assert handler.attempt_count == 0
+
+        assert len(attempts) == 6
+
 
 class TestDisconnectDuringInterruption:
     """disconnect() must fully shut down even when not connected."""

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

@@ -1,8 +0,0 @@
-{
-  "tag": "9.4.0",
-  "distance": 0,
-  "node": "g14ff7fc4c8672df4b22b6ec222f49a67fcf78a50",
-  "dirty": false,
-  "branch": "HEAD",
-  "node_date": "2026-09-13"
-}