PyPlumIO 0.5.29__tar.gz → 0.5.31__tar.gz

{pyplumio-0.5.29 → pyplumio-0.5.31}/.github/workflows/ci.yml

@@ -1,15 +1,17 @@
 name: ci
 
 on:
-  - push
-  - pull_request
+  push:
+    branches:
+      - main
+  pull_request:
 
 jobs:
   build:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ["3.9", "3.10", "3.11", "3.12"]
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
 
     steps:
       - uses: actions/checkout@v4
@@ -33,7 +35,7 @@ jobs:
       - name: Test with tox
         run: tox
 
-      - if: github.event_name != 'pull_request'
+      - if: github.event_name == 'push'
         uses: paambaati/codeclimate-action@v5.0.0
         env:
           CC_TEST_REPORTER_ID: ${{ secrets.CC_TEST_REPORTER_ID }}

{pyplumio-0.5.29 → pyplumio-0.5.31}/.github/workflows/deploy.yml

@@ -22,8 +22,6 @@ jobs:
 
       - name: Set up Python
         uses: actions/setup-python@v5
-        with:
-          python-version: "3.9"
 
       - name: Install dependencies
         run: |
@@ -36,3 +34,5 @@ jobs:
 
       - name: Publish package distributions to PyPI
         uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          attestations: false

{pyplumio-0.5.29 → pyplumio-0.5.31}/.pre-commit-config.yaml

@@ -2,16 +2,16 @@
 # See https://pre-commit.com/hooks.html for more hooks
 repos:
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.6.3
+    rev: v0.9.3
     hooks:
       - id: ruff
         args:
           - --fix
   - repo: https://github.com/codespell-project/codespell
-    rev: v2.3.0
+    rev: v2.4.0
     hooks:
         - id: codespell
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.11.2
+    rev: v1.14.1
     hooks:
         - id: mypy

{pyplumio-0.5.29 → pyplumio-0.5.31}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: PyPlumIO
-Version: 0.5.29
+Version: 0.5.31
 Summary: PyPlumIO is a native ecoNET library for Plum ecoMAX controllers.
 Author-email: Denis Paavilainen <denpa@denpa.pro>
 License: MIT License
@@ -17,6 +17,7 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Home Automation
 Requires-Python: >=3.9
@@ -27,22 +28,22 @@ Requires-Dist: pyserial-asyncio==0.6
 Requires-Dist: typing-extensions==4.12.2
 Provides-Extra: test
 Requires-Dist: codespell==2.3.0; extra == "test"
-Requires-Dist: coverage==7.6.4; extra == "test"
-Requires-Dist: mypy==1.13.0; extra == "test"
+Requires-Dist: coverage==7.6.10; extra == "test"
+Requires-Dist: mypy==1.14.1; extra == "test"
 Requires-Dist: pyserial-asyncio-fast==0.14; extra == "test"
-Requires-Dist: pytest==8.3.3; extra == "test"
-Requires-Dist: pytest-asyncio==0.24.0; extra == "test"
-Requires-Dist: ruff==0.7.1; extra == "test"
+Requires-Dist: pytest==8.3.4; extra == "test"
+Requires-Dist: pytest-asyncio==0.25.2; extra == "test"
+Requires-Dist: ruff==0.9.2; extra == "test"
 Requires-Dist: tox==4.23.2; extra == "test"
-Requires-Dist: types-pyserial==3.5.0.20240826; extra == "test"
+Requires-Dist: types-pyserial==3.5.0.20241221; extra == "test"
 Provides-Extra: docs
 Requires-Dist: sphinx==8.1.3; extra == "docs"
-Requires-Dist: sphinx_rtd_theme==3.0.1; extra == "docs"
+Requires-Dist: sphinx_rtd_theme==3.0.2; extra == "docs"
 Requires-Dist: readthedocs-sphinx-search==0.3.2; extra == "docs"
 Provides-Extra: dev
 Requires-Dist: pyplumio[docs,test]; extra == "dev"
 Requires-Dist: pre-commit==4.0.1; extra == "dev"
-Requires-Dist: tomli==2.0.2; extra == "dev"
+Requires-Dist: tomli==2.2.1; extra == "dev"
 
 # PyPlumIO is a native ecoNET library for Plum ecoMAX controllers.
 [![PyPI version](https://badge.fury.io/py/PyPlumIO.svg)](https://badge.fury.io/py/PyPlumIO)

{pyplumio-0.5.29 → pyplumio-0.5.31}/PyPlumIO.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: PyPlumIO
-Version: 0.5.29
+Version: 0.5.31
 Summary: PyPlumIO is a native ecoNET library for Plum ecoMAX controllers.
 Author-email: Denis Paavilainen <denpa@denpa.pro>
 License: MIT License
@@ -17,6 +17,7 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Home Automation
 Requires-Python: >=3.9
@@ -27,22 +28,22 @@ Requires-Dist: pyserial-asyncio==0.6
 Requires-Dist: typing-extensions==4.12.2
 Provides-Extra: test
 Requires-Dist: codespell==2.3.0; extra == "test"
-Requires-Dist: coverage==7.6.4; extra == "test"
-Requires-Dist: mypy==1.13.0; extra == "test"
+Requires-Dist: coverage==7.6.10; extra == "test"
+Requires-Dist: mypy==1.14.1; extra == "test"
 Requires-Dist: pyserial-asyncio-fast==0.14; extra == "test"
-Requires-Dist: pytest==8.3.3; extra == "test"
-Requires-Dist: pytest-asyncio==0.24.0; extra == "test"
-Requires-Dist: ruff==0.7.1; extra == "test"
+Requires-Dist: pytest==8.3.4; extra == "test"
+Requires-Dist: pytest-asyncio==0.25.2; extra == "test"
+Requires-Dist: ruff==0.9.2; extra == "test"
 Requires-Dist: tox==4.23.2; extra == "test"
-Requires-Dist: types-pyserial==3.5.0.20240826; extra == "test"
+Requires-Dist: types-pyserial==3.5.0.20241221; extra == "test"
 Provides-Extra: docs
 Requires-Dist: sphinx==8.1.3; extra == "docs"
-Requires-Dist: sphinx_rtd_theme==3.0.1; extra == "docs"
+Requires-Dist: sphinx_rtd_theme==3.0.2; extra == "docs"
 Requires-Dist: readthedocs-sphinx-search==0.3.2; extra == "docs"
 Provides-Extra: dev
 Requires-Dist: pyplumio[docs,test]; extra == "dev"
 Requires-Dist: pre-commit==4.0.1; extra == "dev"
-Requires-Dist: tomli==2.0.2; extra == "dev"
+Requires-Dist: tomli==2.2.1; extra == "dev"
 
 # PyPlumIO is a native ecoNET library for Plum ecoMAX controllers.
 [![PyPI version](https://badge.fury.io/py/PyPlumIO.svg)](https://badge.fury.io/py/PyPlumIO)

{pyplumio-0.5.29 → pyplumio-0.5.31}/PyPlumIO.egg-info/requires.txt

@@ -5,20 +5,20 @@ typing-extensions==4.12.2
 [dev]
 pyplumio[docs,test]
 pre-commit==4.0.1
-tomli==2.0.2
+tomli==2.2.1
 
 [docs]
 sphinx==8.1.3
-sphinx_rtd_theme==3.0.1
+sphinx_rtd_theme==3.0.2
 readthedocs-sphinx-search==0.3.2
 
 [test]
 codespell==2.3.0
-coverage==7.6.4
-mypy==1.13.0
+coverage==7.6.10
+mypy==1.14.1
 pyserial-asyncio-fast==0.14
-pytest==8.3.3
-pytest-asyncio==0.24.0
-ruff==0.7.1
+pytest==8.3.4
+pytest-asyncio==0.25.2
+ruff==0.9.2
 tox==4.23.2
-types-pyserial==3.5.0.20240826
+types-pyserial==3.5.0.20241221

{pyplumio-0.5.29 → pyplumio-0.5.31}/docs/source/callbacks.rst

@@ -23,7 +23,7 @@ Subscribing to events
 .. autofunction:: pyplumio.devices.Device.subscribe_once
 
 To remove the previously registered callback, use the
-``unsubcribe()`` method.
+``unsubscribe()`` method.
 
 .. autofunction:: pyplumio.devices.Device.unsubscribe
 
@@ -48,6 +48,17 @@ then calls the callback with the sum of values collected.
     # Await the callback with the fuel burned during 30 seconds.
     ecomax.subscribe("fuel_burned", aggregate(my_callback, seconds=30))
 
+.. autofunction:: pyplumio.filters.clamp
+
+This filter clamps value between specified boundaries.
+It can be used to filter out outliers and corrupted data.
+
+.. code-block:: python
+
+    from pyplumio.filters import clamp
+
+    # Await the callback with value clamped between 0 and 100.
+    ecomax.subscribe("load", clamp(my_callback, min_value=0, max_value=100))
 
 .. autofunction:: pyplumio.filters.on_change
 

{pyplumio-0.5.29 → pyplumio-0.5.31}/docs/source/connecting.rst

@@ -69,18 +69,22 @@ working with device classes and queues.
     async def main():
         """Open a connection and request alerts."""
         async with pyplumio.open_tcp_connection(
-            host="localhost", port=8899, protocol=pyplumio.DummyProtocol
+            host="localhost", port=8899, protocol=pyplumio.DummyProtocol()
         ) as connection:
             await connection.writer.write(
                 requests.AlertsRequest(recipient=DeviceType.ECOMAX, start=0, count=5)
             )
 
             while connection.connected:
-                if isinstance(
-                    (frame := await connection.reader.read()), responses.AlertsResponse
-                ):
-                    print(frame.data)
-                    break
+                try:
+                    if isinstance(
+                        (frame := await connection.reader.read()), responses.AlertsResponse
+                    ):
+                        print(frame.data)
+                        break
+                except pyplumio.ProtocolError:
+                    # Skip protocol errors and read the next frame.
+                    pass
 
 
     asyncio.run(main())

{pyplumio-0.5.29 → pyplumio-0.5.31}/docs/source/mixers_thermostats.rst

@@ -52,7 +52,7 @@ get it's current_temp property and set it's target temperature to
 Thermostat Examples
 -------------------
 
-In the following example, we'll get single thermostat by it's index,
+In the following example, we'll get a single thermostat by it's index,
 get current room temperature and set daytime target temperature to 20
 degrees Celsius.
 

{pyplumio-0.5.29 → pyplumio-0.5.31}/docs/source/reading.rst

@@ -78,8 +78,8 @@ available and print it out.
 
 Regulator Data
 --------------
-Regulator Data messages are broadcasted by the ecoMAX controller
-once per second and allow access to some device-specific
+Regulator Data message is broadcasted by the ecoMAX controller
+once per second and allows access to some device-specific
 information that isn't available elsewhere.
 
 .. note::
@@ -87,9 +87,8 @@ information that isn't available elsewhere.
     RegData is device-specific. Each ecoMAX controller has different
     keys and their associated meanings.
 
-It's represented by a dictionary mapped with numerical keys.
-
-RegData can be accessed via the **regdata** property.
+Regulator data is represented by a dictionary mapped with numerical
+keys, and can be accessed via the **regdata** property.
 
 .. code-block:: python
 
@@ -103,8 +102,8 @@ RegData can be accessed via the **regdata** property.
 Reading Examples
 ----------------
 
-The following example make uses of all available methods to get
-heating current and target temperatures and device state and outputs it
+The following example makes use of all available methods to get
+current and target heating temperatures and device state and outputs it
 to the terminal.
 
 .. code-block:: python
@@ -122,14 +121,14 @@ to the terminal.
             # Get the ecoMAX device.
             ecomax = await conn.get("ecomax")
 
-            # Get the heating temperature if it is available, or return
-            # default value (65).
+            # Get heating temperature, if it's available otherwise
+            # return the default value (65).
             heating_temp = ecomax.get_nowait("heating_temp", default=65)
 
-            # Wait for the heating temperature and get it's value.
+            # Wait for heating temperature and get it's value.
             heating_target_temp = await ecomax.get("heating_target_temp")
 
-            # Wait until regulator data is available, and grab key 1792.
+            # Wait until regulator data is available then grab key 1792.
             await ecomax.wait_for("regdata")
             status = ecomax.regdata[1792]
 

{pyplumio-0.5.29 → pyplumio-0.5.31}/docs/source/writing.rst

@@ -6,9 +6,8 @@ Setters
 
 .. autofunction:: pyplumio.devices.Device.set
 
-When using blocking setter, you will get the result
-represented by the boolean value. `True` if write was successful,
-`False` otherwise.
+When using blocking setter, you'll get the result represented by a
+boolean value. `True` if write was successful, `False` otherwise.
 
 .. code-block:: python
 
@@ -20,9 +19,9 @@ represented by the boolean value. `True` if write was successful,
 
 .. autofunction:: pyplumio.devices.Device.set_nowait
 
-You can't access result, when using non-blocking setter as task is done
-in the background. You will, however, still get error message in the log
-in case of failure.
+When using non-blocking setter, you can't access the result as task is
+done in background. However, you'll still get error log message in case
+of a failure.
 
 .. code-block:: python
 
@@ -31,13 +30,13 @@ in case of failure.
 Parameters
 ----------
 
-It's possible to get the ``Parameter`` object and then modify it using
-it's own setter methods.
+For the parameters, it's possible to retrieve the ``Parameter`` object
+and then modify it via it's own setter method.
 
 .. autoclass:: pyplumio.helpers.parameter.Parameter
 
-When using the parameter object, you don't
-need to pass the parameter name.
+When using the parameter object directly, you don't need to pass the
+parameter name to the setter method.
 
 Numbers
 ^^^^^^^
@@ -52,12 +51,13 @@ Numbers are parameters that have numerical value associated with them.
     heating_target: Number = ecomax.get("heating_target_temp")
     result = heating_target.set(65)
 
-Each number has a range of allowed values.
+Each number has an unique range of allowed values.
 PyPlumIO will raise ``ValueError`` if value isn't within acceptable
 range.
 
-You can check allowed range by reading ``min_value`` and ``max_value``
-properties of the parameter object. Both values are **inclusive**.
+You can check allowed range boundaries by reading ``min_value`` and
+``max_value`` properties of the parameter object.
+Please note, that both values are **inclusive**.
 
 .. code-block:: python
 
@@ -73,7 +73,7 @@ Switches
 
 Switches are parameters that could only have two possible states: on or off.
 
-Thus, for switches, you can use boolean `True` or `False`,
+Thus, for switches, you can use Python's boolean keywords `True` or `False`,
 string literals "on" or "off" or special ``turn_on()`` and
 ``turn_off()`` methods.
 
@@ -82,15 +82,15 @@ string literals "on" or "off" or special ``turn_on()`` and
 .. autofunction:: pyplumio.helpers.parameter.Switch.turn_off
 .. autofunction:: pyplumio.helpers.parameter.Switch.turn_off_nowait
 
-One such switch is "ecomax_control" that allows you to switch
-the ecoMAX on or off.
+Good example of a switch is "ecomax_control" that allows you to switch
+the ecoMAX controller on or off.
 
 .. code-block:: python
 
     # Set an ecomax_control parameter value to "on".
     result = await ecomax.set("ecomax_control", "on")
 
-If you want to use **turn_on()** method, you must first get a parameter
+If you want to use **turn_on()** method, you must first get the parameter
 object.
 
 .. code-block:: python
@@ -101,8 +101,8 @@ object.
     ecomax_control: Switch = await ecomax.get("ecomax_control")
     result = await ecomax_control.turn_on()
 
-If you simply want to turn on or off the ecoMAX controller itself,
-there's a handy shortcut built in the controller handler.
+If you simply want to switch the ecoMAX controller on or off,
+there's a handy built-in way to do that.
 
 .. code-block:: python
     
@@ -115,9 +115,9 @@ there's a handy shortcut built in the controller handler.
 Writing Examples
 ----------------
 
-The following example opens the connection, enables the controller
-without waiting for result and tries to set a target temperature,
-outputting result to the terminal.
+The following example opens a connection, enables the controller
+without waiting for the result and tries to set a target temperature,
+outputting the result to the terminal.
 
 .. code-block:: python
 

{pyplumio-0.5.29 → pyplumio-0.5.31}/pyplumio/_version.py

@@ -12,5 +12,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '0.5.29'
-__version_tuple__ = version_tuple = (0, 5, 29)
+__version__ = version = '0.5.31'
+__version_tuple__ = version_tuple = (0, 5, 31)

{pyplumio-0.5.29 → pyplumio-0.5.31}/pyplumio/devices/__init__.py

@@ -5,17 +5,21 @@ from __future__ import annotations
 from abc import ABC
 import asyncio
 from functools import cache
+import logging
 from typing import Any, ClassVar
 
 from pyplumio.const import ATTR_FRAME_ERRORS, ATTR_LOADED, DeviceType, FrameType
 from pyplumio.exceptions import UnknownDeviceError
-from pyplumio.frames import DataFrameDescription, Frame, Request
+from pyplumio.frames import DataFrameDescription, Frame, Request, is_known_frame_type
 from pyplumio.helpers.event_manager import EventManager
 from pyplumio.helpers.factory import create_instance
 from pyplumio.helpers.parameter import Parameter, ParameterValue
+from pyplumio.structures.frame_versions import ATTR_FRAME_VERSIONS
 from pyplumio.structures.network_info import NetworkInfo
 from pyplumio.utils import to_camelcase
 
+_LOGGER = logging.getLogger(__name__)
+
 
 @cache
 def is_known_device_type(device_type: int) -> bool:
@@ -103,9 +107,6 @@ class Device(ABC, EventManager):
             this value is used to determine failure when
             retrying and doesn't block, defaults to `None`
         :type timeout: float, optional
-        :return: `True` if parameter was successfully set, `False`
-            otherwise.
-        :rtype: bool
         """
         self.create_task(self.set(name, value, retries, timeout))
 
@@ -125,11 +126,44 @@ class PhysicalDevice(Device, ABC):
     address: ClassVar[int]
     _network: NetworkInfo
     _setup_frames: tuple[DataFrameDescription, ...]
+    _frame_versions: dict[int, int]
 
     def __init__(self, queue: asyncio.Queue[Frame], network: NetworkInfo) -> None:
         """Initialize a new physical device."""
         super().__init__(queue)
         self._network = network
+        self._frame_versions = {}
+
+        async def update_frame_versions(versions: dict[int, int]) -> None:
+            """Check frame versions and update outdated frames."""
+            for frame_type, version in versions.items():
+                if (
+                    is_known_frame_type(frame_type)
+                    and self.supports_frame_type(frame_type)
+                    and not self.has_frame_version(frame_type, version)
+                ):
+                    _LOGGER.debug(
+                        "Updating frame %s to version %i", repr(frame_type), version
+                    )
+                    request = await Request.create(frame_type, recipient=self.address)
+                    self.queue.put_nowait(request)
+                    self._frame_versions[frame_type] = version
+
+        self.subscribe(ATTR_FRAME_VERSIONS, update_frame_versions)
+
+    def has_frame_version(self, frame_type: int, version: int | None = None) -> bool:
+        """Return True if frame data is up to date, False otherwise."""
+        if frame_type not in self._frame_versions:
+            return False
+
+        if version is None or self._frame_versions[frame_type] == version:
+            return True
+
+        return False
+
+    def supports_frame_type(self, frame_type: int) -> bool:
+        """Check if frame type is supported by the device."""
+        return frame_type not in self.data.get(ATTR_FRAME_ERRORS, [])
 
     def handle_frame(self, frame: Frame) -> None:
         """Handle frame received from the device."""

{pyplumio-0.5.29 → pyplumio-0.5.31}/pyplumio/devices/ecomax.py

@@ -9,7 +9,6 @@ import time
 from typing import Any, Final
 
 from pyplumio.const import (
-    ATTR_FRAME_ERRORS,
     ATTR_PASSWORD,
     ATTR_SENSORS,
     ATTR_STATE,
@@ -21,7 +20,7 @@ from pyplumio.devices import PhysicalDevice
 from pyplumio.devices.mixer import Mixer
 from pyplumio.devices.thermostat import Thermostat
 from pyplumio.filters import on_change
-from pyplumio.frames import DataFrameDescription, Frame, Request, is_known_frame_type
+from pyplumio.frames import DataFrameDescription, Frame, Request
 from pyplumio.helpers.parameter import ParameterValues
 from pyplumio.helpers.schedule import Schedule, ScheduleDay
 from pyplumio.structures.alerts import ATTR_TOTAL_ALERTS
@@ -35,7 +34,6 @@ from pyplumio.structures.ecomax_parameters import (
     EcomaxSwitch,
     EcomaxSwitchDescription,
 )
-from pyplumio.structures.frame_versions import ATTR_FRAME_VERSIONS
 from pyplumio.structures.fuel_consumption import ATTR_FUEL_CONSUMPTION
 from pyplumio.structures.mixer_parameters import ATTR_MIXER_PARAMETERS
 from pyplumio.structures.mixer_sensors import ATTR_MIXER_SENSORS
@@ -106,17 +104,14 @@ class EcoMAX(PhysicalDevice):
 
     address = DeviceType.ECOMAX
 
-    _frame_versions: dict[int, int]
     _fuel_burned_timestamp_ns: int
     _setup_frames = SETUP_FRAME_TYPES
 
     def __init__(self, queue: asyncio.Queue[Frame], network: NetworkInfo) -> None:
         """Initialize a new ecoMAX controller."""
         super().__init__(queue, network)
-        self._frame_versions = {}
         self._fuel_burned_timestamp_ns = time.perf_counter_ns()
         self.subscribe(ATTR_ECOMAX_PARAMETERS, self._handle_ecomax_parameters)
-        self.subscribe(ATTR_FRAME_VERSIONS, self._update_frame_versions)
         self.subscribe(ATTR_FUEL_CONSUMPTION, self._add_burned_fuel_counter)
         self.subscribe(ATTR_MIXER_PARAMETERS, self._handle_mixer_parameters)
         self.subscribe(ATTR_MIXER_SENSORS, self._handle_mixer_sensors)
@@ -142,17 +137,6 @@ class EcoMAX(PhysicalDevice):
 
         super().handle_frame(frame)
 
-    def _has_frame_version(self, frame_type: FrameType | int, version: int) -> bool:
-        """Check if ecoMAX controller has this version of the frame."""
-        return (
-            frame_type in self._frame_versions
-            and self._frame_versions[frame_type] == version
-        )
-
-    def _frame_is_supported(self, frame_type: FrameType | int) -> bool:
-        """Check if frame is supported by the device."""
-        return frame_type not in self.data.get(ATTR_FRAME_ERRORS, [])
-
     def _mixers(self, indexes: Iterable[int]) -> Generator[Mixer, None, None]:
         """Iterate through the mixer indexes.
 
@@ -224,19 +208,6 @@ class EcoMAX(PhysicalDevice):
         await asyncio.gather(*_ecomax_parameter_events())
         return True
 
-    async def _update_frame_versions(self, versions: dict[int, int]) -> None:
-        """Check frame versions and update outdated frames."""
-        for frame_type, version in versions.items():
-            if (
-                is_known_frame_type(frame_type)
-                and self._frame_is_supported(frame_type)
-                and not self._has_frame_version(frame_type, version)
-            ):
-                # We don't have this frame or it's version has changed.
-                request = await Request.create(frame_type, recipient=self.address)
-                self.queue.put_nowait(request)
-                self._frame_versions[frame_type] = version
-
     async def _add_burned_fuel_counter(self, fuel_consumption: float) -> None:
         """Calculate fuel burned since last sensor's data message."""
         current_timestamp_ns = time.perf_counter_ns()