nwp500-python 9.12.0__tar.gz → 9.12.1__tar.gz

{nwp500_python-9.12.0 → nwp500_python-9.12.1}/CHANGELOG.rst

@@ -2,6 +2,35 @@
 Changelog
 =========
 
+Version 9.12.1 (2026-10-23)
+===========================
+
+Fixed
+-----
+
+- **simulate run books the tank from Home Assistant.** Given the
+  sources' ``[home_assistant.heater]`` table and the new
+  ``draw_flow`` entity, the run walks from the tank's booked heat
+  (``HomeAssistantBook``), and "deliverable now" reads it: a tank with
+  its probes apart read 0 gal from the probes alone, the history
+  unused.
+
+Added
+-----
+
+- **simulate run's bath and showers.** The table gives the bath and
+  the whole showers the tank is ready for (``sim.time_to_ready``), and
+  when the heat pump has the bath ready; ``--bath`` and ``--shower``
+  give the volumes.
+
+Changed
+-------
+
+- **The package's metadata is in pyproject.toml.** Name, dependencies,
+  extras, classifiers and the ``nwp-cli`` entry point moved from
+  ``setup.cfg`` to the standard ``[project]`` table, and ``setup.py`` is
+  gone. The built package installs the same files and requirements.
+
 Version 9.12.0 (2026-10-23)
 ===========================
 

{nwp500_python-9.12.0 → nwp500_python-9.12.1}/CONTRIBUTING.rst

@@ -265,7 +265,7 @@ package:
    potentially in the root of your project.
 
 #. Sometimes |tox|_ misses out when new dependencies are added, especially to
-   ``setup.cfg`` and ``docs/requirements.txt``. If you find any problems with
+   ``pyproject.toml`` and ``docs/requirements.txt``. If you find any problems with
    missing dependencies when running a command with |tox|_, try to recreate the
    ``tox`` environment using the ``-r`` flag. For example, instead of::
 

{nwp500_python-9.12.0/src/nwp500_python.egg-info → nwp500_python-9.12.1}/PKG-INFO

@@ -1,15 +1,13 @@
 Metadata-Version: 2.4
 Name: nwp500-python
-Version: 9.12.0
+Version: 9.12.1
 Summary: A library for controlling Navien NWP500 Water Heaters via NaviLink
-Home-page: https://github.com/eman/nwp500-python
-Author: Emmanuel Levijarvi
-Author-email: emansl@gmail.com
-License: MIT
+Author-email: Emmanuel Levijarvi <emansl@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/eman/nwp500-python
 Project-URL: Documentation, https://nwp500-python.readthedocs.io/en/latest/
 Project-URL: Source, https://github.com/eman/nwp500-python
 Project-URL: Tracker, https://github.com/eman/nwp500-python/issues
-Platform: any
 Classifier: Development Status :: 4 - Beta
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
@@ -31,9 +29,7 @@ Requires-Dist: numpy>=1.24.0; extra == "sim"
 Requires-Dist: pandas>=2.0.0; extra == "sim"
 Requires-Dist: scipy>=1.11.0; extra == "sim"
 Provides-Extra: testing
-Requires-Dist: numpy>=1.24.0; extra == "testing"
-Requires-Dist: pandas>=2.0.0; extra == "testing"
-Requires-Dist: scipy>=1.11.0; extra == "testing"
+Requires-Dist: nwp500-python[sim]; extra == "testing"
 Requires-Dist: setuptools; extra == "testing"
 Requires-Dist: pytest; extra == "testing"
 Requires-Dist: pytest-cov; extra == "testing"
@@ -42,14 +38,7 @@ Requires-Dist: hypothesis; extra == "testing"
 Provides-Extra: dev
 Requires-Dist: ruff>=0.1.0; extra == "dev"
 Requires-Dist: pyright>=1.1.0; extra == "dev"
-Requires-Dist: numpy>=1.24.0; extra == "dev"
-Requires-Dist: pandas>=2.0.0; extra == "dev"
-Requires-Dist: scipy>=1.11.0; extra == "dev"
-Requires-Dist: setuptools; extra == "dev"
-Requires-Dist: pytest; extra == "dev"
-Requires-Dist: pytest-cov; extra == "dev"
-Requires-Dist: pytest-asyncio; extra == "dev"
-Requires-Dist: hypothesis; extra == "dev"
+Requires-Dist: nwp500-python[testing]; extra == "dev"
 Dynamic: license-file
 
 =============

{nwp500_python-9.12.0 → nwp500_python-9.12.1}/docs/conf.py

@@ -24,8 +24,7 @@ sys.path.insert(0, os.path.join(__location__, "../src"))
 # This hack is necessary since RTD does not issue `sphinx-apidoc` before running
 # `sphinx-build -b html . _build/html`. See Issue:
 # https://github.com/readthedocs/readthedocs.org/issues/1139
-# DON'T FORGET: Check the box "Install your project inside a virtualenv using
-# setup.py install" in the RTD Advanced Settings.
+# RTD installs the project itself (.readthedocs.yml, python.install).
 # Additionally it helps us to avoid running apidoc manually
 
 try:  # for Sphinx >= 1.7

{nwp500_python-9.12.0 → nwp500_python-9.12.1}/docs/how-to/simulate-heater.rst

@@ -141,6 +141,7 @@ pass it with ``--sources`` (or set ``NWP500_SOURCES``):
    demand = "binary_sensor.hot_water_demand"  # on while hot water is drawn
    circulation_speed = "sensor.circulation_pump_speed"
    weather = "weather.forecast_home"
+   draw_flow = "sensor.hot_water_draw_flow"  # the household's draws
 
    [home_assistant.heater]   # optional: the heater's own entities
    heard = "sensor.water_heater_last_status"
@@ -183,7 +184,25 @@ give:
   ``demand`` entity: a binary sensor that is on while the household
   draws hot water, with the circulation's water not among its draws. A
   circulation pump with no speed reading leaves no estimate, and a draw
-  before its first reading is skipped.
+  before its first reading is skipped;
+- **the heat book:** with the ``[home_assistant.heater]`` table and a
+  ``draw_flow`` entity (the household's hot water draw flow, the
+  circulation's water not in it), the tank's heat booked from the last
+  72 hours of the heater's readings and the draws
+  (``sim_home_assistant.HomeAssistantBook``). The run walks from it,
+  and "deliverable now" reads it (``energy``), whatever the gap between
+  the two probes. Without it, the probes alone answer only a full tank,
+  and a tank with the probes apart reads 0 (``probes``). With no full
+  tank in the 72 hours, or a scenario that doesn't start now, the run
+  walks without the book, and a warning says why.
+
+Under "deliverable now", the table gives the bath and the showers the
+tank is ready for (``sim.time_to_ready``): the bath ready with its
+margin, or how short it is and when the heat pump has it ready; and the
+whole showers, as a shower the tank can't finish isn't counted. Both are
+delivered volumes, past the mixing valve. ``--bath`` and ``--shower``
+give them in the preferred unit; without them, the parameters'
+(``ReadinessParams.bath_gal``, 28.7 gal, and ``shower_gal``, 12 gal).
 
 A reading's age is from when Home Assistant last heard the sensor
 report (``last_reported``). Over the REST API, Home Assistant serves

{nwp500_python-9.12.0 → nwp500_python-9.12.1}/docs/requirements.txt

@@ -1,6 +1,6 @@
 # Requirements file for ReadTheDocs, check .readthedocs.yml.
 # To build the module reference correctly, make sure every external package
-# under `install_requires` in `setup.cfg` is also listed here!
+# under `dependencies` in `pyproject.toml` is also listed here!
 sphinx>=3.2.1
 # sphinx_rtd_theme
 sphinxcontrib-openapi>=0.8.0

{nwp500_python-9.12.0 → nwp500_python-9.12.1}/pyproject.toml

@@ -1,8 +1,78 @@
 [build-system]
-# AVOID CHANGING REQUIRES: IT WILL BE UPDATED BY PYSCAFFOLD!
-requires = ["setuptools>=46.1.0", "setuptools_scm[toml]>=5"]
+requires = ["setuptools>=77", "setuptools_scm>=8"]
 build-backend = "setuptools.build_meta"
 
+[project]
+name = "nwp500-python"
+description = "A library for controlling Navien NWP500 Water Heaters via NaviLink"
+readme = { file = "README.rst", content-type = "text/x-rst; charset=UTF-8" }
+authors = [{ name = "Emmanuel Levijarvi", email = "emansl@gmail.com" }]
+license = "MIT"
+license-files = ["LICENSE.txt"]
+requires-python = ">=3.14"
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3 :: Only",
+]
+# The version comes from the git tag (setuptools_scm).
+dynamic = ["version"]
+dependencies = [
+    "aiohttp>=3.13.5",
+    "awsiotsdk>=1.29.0",
+    "pydantic>=2.0.0",
+]
+
+[project.optional-dependencies]
+# Command line interface with optional rich formatting
+cli = [
+    "click>=8.3.0",
+    "rich>=14.3.0",
+]
+# Bluetooth LE access to the heater's controller (installer data)
+ble = [
+    "bleak>=0.22.0",
+]
+# The optional heater simulator (nwp500.sim)
+sim = [
+    "numpy>=1.24.0",
+    "pandas>=2.0.0",
+    "scipy>=1.11.0",
+]
+testing = [
+    "nwp500-python[sim]",
+    "setuptools",
+    "pytest",
+    "pytest-cov",
+    "pytest-asyncio",
+    "hypothesis",
+]
+dev = [
+    "ruff>=0.1.0",
+    "pyright>=1.1.0",
+    "nwp500-python[testing]",
+]
+
+[project.scripts]
+nwp-cli = "nwp500.cli.__main__:run"
+
+[project.urls]
+Homepage = "https://github.com/eman/nwp500-python"
+Documentation = "https://nwp500-python.readthedocs.io/en/latest/"
+Source = "https://github.com/eman/nwp500-python"
+Tracker = "https://github.com/eman/nwp500-python/issues"
+
+[tool.setuptools]
+zip-safe = false
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+exclude = ["tests"]
+namespaces = true
+
 [tool.setuptools_scm]
 # For smarter version schemes and other configuration options,
 # check out https://github.com/pypa/setuptools_scm

{nwp500_python-9.12.0 → nwp500_python-9.12.1}/scripts/README.md

@@ -49,7 +49,7 @@ python3 scripts/validate_version.py
 **Checks:**
 - Verifies `setup.cfg` `[pyscaffold]` version hasn't been modified (should be 4.6)
 - Ensures no hardcoded `__version__` strings in source code
-- Confirms `setup.py` uses `setuptools_scm`
+- Confirms `pyproject.toml` takes the version from `setuptools_scm`
 
 **When to run:**
 - Before creating a release

{nwp500_python-9.12.0 → nwp500_python-9.12.1}/scripts/validate_version.py

@@ -5,13 +5,15 @@ Version validation script for nwp500-python.
 This script checks for common version-related mistakes:
 1. Verifies that setup.cfg [pyscaffold] version hasn't been changed
 2. Ensures no hardcoded version strings exist in source code
-3. Validates that version is derived from git tags only
+3. Validates that pyproject.toml takes the version from git tags
+   (setuptools_scm)
 
 Run this as part of CI/CD or pre-commit hooks.
 """
 
 import re
 import sys
+import tomllib
 from pathlib import Path
 
 
@@ -120,21 +122,27 @@ def check_hardcoded_versions() -> bool:
     return True
 
 
-def check_setup_py() -> bool:
-    """Verify setup.py uses setuptools_scm correctly."""
-    setup_py = Path("setup.py")
+def check_scm_version() -> bool:
+    """Verify pyproject.toml takes the version from setuptools_scm."""
+    pyproject = Path("pyproject.toml")
 
-    if not setup_py.exists():
-        print("Warning: setup.py not found", file=sys.stderr)
-        return True
+    if not pyproject.exists():
+        print("Error: pyproject.toml not found", file=sys.stderr)
+        return False
 
-    content = setup_py.read_text()
+    config = tomllib.loads(pyproject.read_text())
+    project = config.get("project", {})
 
-    if "use_scm_version" not in content:
-        print("setup.py does not use setuptools_scm", file=sys.stderr)
-        print("", file=sys.stderr)
+    if "version" in project:
+        print("pyproject.toml hardcodes [project] version", file=sys.stderr)
+        return False
+
+    if "version" not in project.get("dynamic", []) or (
+        "setuptools_scm" not in config.get("tool", {})
+    ):
         print(
-            "setup.py should contain: setup(use_scm_version={...})",
+            "pyproject.toml should list version in [project] dynamic and "
+            "have a [tool.setuptools_scm] table",
             file=sys.stderr,
         )
         return False
@@ -150,7 +158,7 @@ def main() -> int:
     all_checks = [
         ("PyScaffold version", check_pyscaffold_version),
         ("Hardcoded versions", check_hardcoded_versions),
-        ("setup.py configuration", check_setup_py),
+        ("setuptools_scm configuration", check_scm_version),
     ]
 
     results = []

{nwp500_python-9.12.0 → nwp500_python-9.12.1}/setup.cfg

@@ -1,68 +1,3 @@
-[metadata]
-name = nwp500-python
-description = A library for controlling Navien NWP500 Water Heaters via NaviLink
-author = Emmanuel Levijarvi
-author_email = emansl@gmail.com
-license = MIT
-license_files = LICENSE.txt
-long_description = file: README.rst
-long_description_content_type = text/x-rst; charset=UTF-8
-url = https://github.com/eman/nwp500-python
-project_urls = 
-	Documentation = https://nwp500-python.readthedocs.io/en/latest/
-	Source = https://github.com/eman/nwp500-python
-	Tracker = https://github.com/eman/nwp500-python/issues
-platforms = any
-classifiers = 
-	Development Status :: 4 - Beta
-	Programming Language :: Python
-	Programming Language :: Python :: 3
-	Programming Language :: Python :: 3.14
-	Programming Language :: Python :: 3 :: Only
-
-[options]
-zip_safe = False
-packages = find_namespace:
-include_package_data = True
-package_dir = 
-	=src
-python_requires = >=3.14
-install_requires = 
-	aiohttp>=3.13.5
-	awsiotsdk>=1.29.0
-	pydantic>=2.0.0
-
-[options.packages.find]
-where = src
-exclude = 
-	tests
-
-[options.extras_require]
-cli = 
-	click>=8.3.0
-	rich>=14.3.0
-ble = 
-	bleak>=0.22.0
-sim = 
-	numpy>=1.24.0
-	pandas>=2.0.0
-	scipy>=1.11.0
-testing = 
-	%(sim)s
-	setuptools
-	pytest
-	pytest-cov
-	pytest-asyncio
-	hypothesis
-dev = 
-	ruff>=0.1.0
-	pyright>=1.1.0
-	%(testing)s
-
-[options.entry_points]
-console_scripts = 
-	nwp-cli = nwp500.cli.__main__:run
-
 [tool:pytest]
 addopts = 
 	--cov nwp500 --cov-report term-missing

{nwp500_python-9.12.0 → nwp500_python-9.12.1}/src/nwp500/cli/__main__.py

@@ -1132,6 +1132,18 @@ _tz_option = click.option(
     help="A HeaterParams document (default the tank size's defaults)",
 )
 @_sources_option
+@click.option(
+    "--bath",
+    type=float,
+    help="The bath readiness is judged against, delivered, preferred unit "
+    "(default the parameters', 28.7 gal)",
+)
+@click.option(
+    "--shower",
+    type=float,
+    help="A shower, delivered, preferred unit (default the parameters', "
+    "12 gal)",
+)
 @click.option(
     "--format",
     "output_format",
@@ -1146,9 +1158,9 @@ def simulate_run(ctx: click.Context, output_format: str, **given: Any) -> None:
     inputs = _read_inputs(sim_cli, **given)
     now = datetime.now(UTC)
 
-    def walk(live: Any) -> None:
+    def walk(live: Any, keeper: Any = None) -> None:
         try:
-            sim_cli.run(inputs, live, now, output_format)
+            sim_cli.run(inputs, live, now, output_format, keeper=keeper)
         except sim_cli.InputError as e:
             raise click.UsageError(str(e)) from None
 
@@ -1163,9 +1175,10 @@ def simulate_run(ctx: click.Context, output_format: str, **given: Any) -> None:
             live = await sim_cli.compose_live(
                 mqtt, ctx.obj["api"], device, inputs, now
             )
+            keeper = await sim_cli.read_book(inputs, now)
         except sim_cli.InputError as e:
             raise click.UsageError(str(e)) from None
-        walk(live)
+        walk(live, keeper)
 
     ctx.exit(asyncio.run(_with_device(ctx, command)))
 

{nwp500_python-9.12.0 → nwp500_python-9.12.1}/src/nwp500/cli/simulate.py

@@ -11,6 +11,7 @@ This module needs the ``sim`` extra; ``__main__`` imports it only when a
 """
 
 import csv
+import dataclasses
 import json
 import logging
 import os
@@ -42,6 +43,7 @@ if TYPE_CHECKING:
     from nwp500.api_client import NavienAPIClient
     from nwp500.models import Device
     from nwp500.mqtt import NavienMqttClient
+    from nwp500.sim_home_assistant import HomeAssistantBook
 
 __author__ = "Emmanuel Levijarvi"
 __copyright__ = "Emmanuel Levijarvi"
@@ -128,12 +130,20 @@ class Inputs:
     #: Where the air, its humidity and the inlet are read live
     #: (``sim_home_assistant.Sources``), when the heater is.
     sources: Any = None
+    #: The bath and the shower readiness is judged against, delivered,
+    #: in the preferred unit; None: the parameters'.
+    bath: float | None = None
+    shower: float | None = None
 
     def __post_init__(self) -> None:
         if self.ambient is not None and self.environment is not None:
             raise InputError("give --ambient or --environment, not both")
         if self.start is not None and self.start.tzinfo is None:
             raise InputError("--start needs its UTC offset")
+        for name in ("bath", "shower"):
+            value = getattr(self, name)
+            if value is not None and not value > 0.0:
+                raise InputError(f"--{name} must be a positive volume")
         if self.tz is not None:
             zone_name(self.tz)
         if self.scenario is not None:
@@ -268,6 +278,54 @@ async def compose_live(
     return composed
 
 
+async def read_book(inputs: Inputs, now: datetime) -> HomeAssistantBook | None:
+    """The heat book's keeper (``sim_home_assistant.HomeAssistantBook``)
+    with the history read to ``now``, when the sources name the heater's
+    entities and the draw flow; None otherwise. Its ``book`` makes no
+    request, so it books after the client is closed."""
+    src = inputs.sources
+    if src is None or src.heater is None or src.entities.draw_flow is None:
+        return None
+    from nwp500 import sim_home_assistant as ha
+
+    async with ha.HomeAssistantClient(src.url, src.token) as client:
+        keeper = ha.HomeAssistantBook(
+            client, src.heater, src.entities.draw_flow, src.entities
+        )
+        await keeper.read(now)
+    return keeper
+
+
+def booked(
+    keeper: HomeAssistantBook | None, built: Built, now: datetime
+) -> sim.Booked | None:
+    """The tank's booked heat at the scenario's start, from ``keeper``
+    (``read_book``): only for a scenario that starts ``now``, whose
+    state is the heater's now. Its gallons convert at the scenario's
+    inlet where one is given, as the walk takes it. Its notes are
+    logged."""
+    if keeper is None:
+        return None
+    start = built.scenario.start
+    if start != now:
+        _logger.warning(
+            "book: the scenario starts at %s, not now: walked without "
+            "the heat book",
+            start.isoformat(),
+        )
+        return None
+    answer = keeper.book(now, built.params)
+    for note in answer.notes:
+        if answer.booked is None:
+            _logger.warning(note)
+        else:
+            _logger.info(note)
+    inlet = built.scenario.environment.inlet_f
+    if answer.booked is None or inlet is None:
+        return answer.booked
+    return dataclasses.replace(answer.booked, inlet_f=inlet)
+
+
 def window(inputs: Inputs, now: datetime) -> tuple[datetime, timedelta]:
     """The start and horizon ``build`` will give the scenario: a flag,
     then the scenario document's, then ``now`` and ``DEFAULT_HOURS``.
@@ -349,20 +407,66 @@ def energy_totals(
     return compressor, element
 
 
+def hot_water_lines(
+    built: Built,
+    book: sim.Booked | None,
+    bath_gal: float | None = None,
+    shower_gal: float | None = None,
+) -> list[str]:
+    """The bath and the showers the tank is ready for now
+    (``sim.time_to_ready``): the bath's margin, or when the heat pump
+    has it ready; the whole showers. Volumes in gallons, None for the
+    parameters'."""
+    try:
+        r = sim.time_to_ready(
+            built.scenario,
+            built.params,
+            book=book,
+            bath_gal=bath_gal,
+            shower_gal=shower_gal,
+        )
+    except SimulationError as e:
+        return [f"Bath and showers: not computed ({e})"]
+    bath = r.bath
+    if bath.ready:
+        state = f"ready, {_volume(bath.margin_gal)} to spare"
+    elif bath.ready_at is not None:
+        state = (
+            f"not ready, {_volume(-bath.margin_gal)} short; the heat pump "
+            f"has it ready at {_local(bath.ready_at, built.scenario.tz)}"
+        )
+    else:
+        state = f"not ready, {_volume(-bath.margin_gal)} short"
+    showers = r.showers
+    return [
+        f"Bath ({_volume(bath.volume_gal)}): {state}",
+        f"Showers ({_volume(showers.volume_gal)}): "
+        f"{showers.ready_for_whole} ready",
+    ]
+
+
 def print_table(
-    built: Built, result: sim.SimulationResult, console: Console
+    built: Built,
+    result: sim.SimulationResult,
+    console: Console,
+    book: sim.Booked | None = None,
+    bath_gal: float | None = None,
+    shower_gal: float | None = None,
 ) -> None:
-    """The heating intervals, the energy by source, the readiness, the
-    draw windows (and which ran cold), the reasons and the defaults."""
+    """The heating intervals, the energy by source, the readiness (from
+    ``book`` when given) with the bath and the showers, the draw windows
+    (and which ran cold), the reasons and the defaults."""
     s = built.scenario
     tz = s.tz
-    ready = sim.readiness(s.state, s.settings, built.params)
+    ready = sim.readiness(s.state, s.settings, built.params, book=book)
     console.print(
         f"[bold]{_local(s.start, tz)} to {_local(s.until, tz)}[/bold] ({tz}): "
         f"tank {_temp(s.state.upper_f)} upper, {_temp(s.state.lower_f)} "
         f"lower, setpoint {_temp(s.settings.setpoint_f)}; "
         f"{_volume(ready.gal)} deliverable now ({ready.basis})"
     )
+    for line in hot_water_lines(built, book, bath_gal, shower_gal):
+        console.print(line)
 
     heating = Table(title="Heating")
     for col in ("Start", "End", "Source", "Why", "Target", "Stop", "Wh"):
@@ -457,13 +561,16 @@ def run(
     now: datetime,
     output_format: str,
     out: TextIO | None = None,
+    keeper: HomeAssistantBook | None = None,
 ) -> sim.SimulationResult:
-    """Build the scenario, walk it and print the result."""
+    """Build the scenario, walk it and print the result: from the tank's
+    booked heat when ``keeper`` (``read_book``) books one."""
     built = build(inputs, live, now)
     for note in built.notes:
         _logger.warning(note)
+    book = booked(keeper, built, now)
     try:
-        result = sim.simulate(built.scenario, built.params)
+        result = sim.simulate(built.scenario, built.params, book=book)
     except SimulationError as e:
         raise InputError(f"the scenario cannot be simulated: {e}") from None
     stream = out or sys.stdout
@@ -473,5 +580,12 @@ def run(
     elif output_format == "csv":
         write_csv(result, stream)
     else:
-        print_table(built, result, Console(file=stream))
+        print_table(
+            built,
+            result,
+            Console(file=stream),
+            book,
+            None if inputs.bath is None else sa.to_sim_volume(inputs.bath),
+            None if inputs.shower is None else sa.to_sim_volume(inputs.shower),
+        )
     return result

{nwp500_python-9.12.0 → nwp500_python-9.12.1}/src/nwp500/sim_home_assistant.py

@@ -137,6 +137,10 @@ class Entities:
     #: A weather entity with an hourly forecast, its ``temperature``
     #: attribute the outdoor air.
     weather: str | None = None
+    #: The household's hot water draw flow, the circulation's water not
+    #: in it, such as a draw detector's (``HomeAssistantBook``'s
+    #: ``flow``): with the heater's entities, the heat book.
+    draw_flow: str | None = None
 
 
 @dataclass(frozen=True)
@@ -169,6 +173,7 @@ def sources_from(doc: Mapping[str, Any], environ: Mapping[str, str]) -> Sources:
         demand = "binary_sensor.hot_water_demand"
         circulation_speed = "sensor.circulation_pump_speed"
         weather = "weather.forecast_home"
+        draw_flow = "sensor.hot_water_draw_flow"
 
         [home_assistant.heater]         # optional: the heater's own
         heard = "sensor.water_heater_last_status"

{nwp500_python-9.12.0 → nwp500_python-9.12.1/src/nwp500_python.egg-info}/PKG-INFO

@@ -1,15 +1,13 @@
 Metadata-Version: 2.4
 Name: nwp500-python
-Version: 9.12.0
+Version: 9.12.1
 Summary: A library for controlling Navien NWP500 Water Heaters via NaviLink
-Home-page: https://github.com/eman/nwp500-python
-Author: Emmanuel Levijarvi
-Author-email: emansl@gmail.com
-License: MIT
+Author-email: Emmanuel Levijarvi <emansl@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/eman/nwp500-python
 Project-URL: Documentation, https://nwp500-python.readthedocs.io/en/latest/
 Project-URL: Source, https://github.com/eman/nwp500-python
 Project-URL: Tracker, https://github.com/eman/nwp500-python/issues
-Platform: any
 Classifier: Development Status :: 4 - Beta
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
@@ -31,9 +29,7 @@ Requires-Dist: numpy>=1.24.0; extra == "sim"
 Requires-Dist: pandas>=2.0.0; extra == "sim"
 Requires-Dist: scipy>=1.11.0; extra == "sim"
 Provides-Extra: testing
-Requires-Dist: numpy>=1.24.0; extra == "testing"
-Requires-Dist: pandas>=2.0.0; extra == "testing"
-Requires-Dist: scipy>=1.11.0; extra == "testing"
+Requires-Dist: nwp500-python[sim]; extra == "testing"
 Requires-Dist: setuptools; extra == "testing"
 Requires-Dist: pytest; extra == "testing"
 Requires-Dist: pytest-cov; extra == "testing"
@@ -42,14 +38,7 @@ Requires-Dist: hypothesis; extra == "testing"
 Provides-Extra: dev
 Requires-Dist: ruff>=0.1.0; extra == "dev"
 Requires-Dist: pyright>=1.1.0; extra == "dev"
-Requires-Dist: numpy>=1.24.0; extra == "dev"
-Requires-Dist: pandas>=2.0.0; extra == "dev"
-Requires-Dist: scipy>=1.11.0; extra == "dev"
-Requires-Dist: setuptools; extra == "dev"
-Requires-Dist: pytest; extra == "dev"
-Requires-Dist: pytest-cov; extra == "dev"
-Requires-Dist: pytest-asyncio; extra == "dev"
-Requires-Dist: hypothesis; extra == "dev"
+Requires-Dist: nwp500-python[testing]; extra == "dev"
 Dynamic: license-file
 
 =============