nwp500-python 7.4.6__tar.gz → 7.4.7__tar.gz

{nwp500_python-7.4.6 → nwp500_python-7.4.7}/.github/workflows/ci.yml

@@ -39,13 +39,13 @@ jobs:
         with:
           python-version: '3.13'
       
-      - name: Install tox
+      - name: Install ruff
         run: |
           python -m pip install --upgrade pip
-          python -m pip install tox
+          python -m pip install ruff
 
-      - name: Run bandit
-        run: tox -e bandit
+      - name: Run security checks (ruff bandit)
+        run: ruff check --select S src/
 
   test:
     name: Test on Python ${{ matrix.python-version }}

{nwp500_python-7.4.6 → nwp500_python-7.4.7}/.gitignore

@@ -62,3 +62,9 @@ venv*/
 .secrets
 reference/*
 resources/*
+
+# Tool caches
+.mypy_cache/
+.ruff_cache/
+.bandit
+.agent/

{nwp500_python-7.4.6 → nwp500_python-7.4.7}/CHANGELOG.rst

@@ -2,6 +2,32 @@
 Changelog
 =========
 
+Version 7.4.7 (2026-02-17)
+==========================
+
+Added
+-----
+- **OpenEI Client Module**: New ``OpenEIClient`` async client (``nwp500.openei``) for browsing utility rate plans from the OpenEI API by zip code. Supports listing utilities, filtering rate plans, and fetching plan details. API key read from ``OPENEI_API_KEY`` environment variable.
+- **Convert TOU API**: ``NavienAPIClient.convert_tou()`` sends raw OpenEI rate data to the Navien backend for server-side conversion into device-ready TOU schedules with season/week bitfields and scaled pricing.
+- **Update TOU API**: ``NavienAPIClient.update_tou()`` applies a converted TOU rate plan to a device, matching the mobile app's ``PUT /device/tou`` endpoint.
+- **ConvertedTOUPlan Model**: New Pydantic model for parsed ``convert_tou()`` results (utility, name, schedule).
+- **CLI ``tou rates``**: Browse utilities and rate plans for a zip code (``nwp500 tou rates 94903``).
+- **CLI ``tou plan``**: View converted rate plan details with decoded pricing (``nwp500 tou plan 94903 "EV Rate A"``).
+- **CLI ``tou apply``**: Apply a rate plan to the water heater with optional ``--enable`` flag to activate TOU via MQTT.
+- **CLI Reservations Table Output**: ``nwp-cli reservations get`` now displays reservations as a formatted table by default with global status indicator (ENABLED/DISABLED). Use ``--json`` flag for JSON output.
+- **CLI ``anti-legionella set-period``**: New subcommand to change the Anti-Legionella cycle period (1-30 days) without toggling the feature. Use ``nwp-cli anti-legionella set-period 7`` to update cycle period.
+
+Changed
+-------
+- **``examples/advanced/tou_openei.py``**: Rewritten to use the new ``OpenEIClient`` and ``convert_tou()``/``update_tou()`` library methods instead of inline OpenEI API calls and client-side conversion.
+
+Fixed
+-----
+- **Week Bitfield Encoding (CRITICAL)**: Fixed MGPP week bitfield encoding to match NaviLink APK protocol. Sunday is now correctly bit 7 (128), Monday bit 6 (64), ..., Saturday bit 1 (2); bit 0 is unused. Affects all reservation and TOU schedule operations. Verified against reference captures.
+- **Enable/Disable Convention**: Fixed reservation and TOU enable/disable flags to use standard device boolean convention (1=OFF, 2=ON) instead of inverted logic. This aligns with other device binary sensors and matches app behavior. Global reservation status now correctly shows DISABLED when ``reservationUse=1``.
+- **Reservation Set Command Timeout**: Fixed ``reservations set`` subscription pattern that had extra wildcards preventing response matching. Command now receives confirmations correctly.
+- **Intermittent Fetch Bug**: Tightened MQTT topic filter for reservation fetch from ``/res/`` to ``/res/rsv/`` with content validation to prevent false matches on unrelated response messages.
+
 Version 7.4.6 (2026-02-13)
 ==========================
 

{nwp500_python-7.4.6/src/nwp500_python.egg-info → nwp500_python-7.4.7}/PKG-INFO

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

{nwp500_python-7.4.6 → nwp500_python-7.4.7}/docs/api/nwp500.rst

@@ -133,6 +133,14 @@ nwp500.mqtt\_events module
    :show-inheritance:
    :undoc-members:
 
+nwp500.openei module
+--------------------
+
+.. automodule:: nwp500.openei
+   :members:
+   :show-inheritance:
+   :undoc-members:
+
 nwp500.temperature module
 -------------------------
 

{nwp500_python-7.4.6 → nwp500_python-7.4.7}/docs/guides/advanced_features_explained.rst

@@ -499,5 +499,5 @@ See Also
 
 * :doc:`../protocol/data_conversions` - Temperature field conversions (HalfCelsiusToF, DeciCelsiusToF)
 * :doc:`../protocol/device_status` - Complete device status field reference
-* :doc:`scheduling_features` - Reservation and TOU integration points
+* :doc:`scheduling` - Scheduling and automation guide
 * :doc:`../python_api/models` - DeviceStatus model field definitions