python-hilo 2025.2.1__tar.gz → 2025.2.2__tar.gz

{python_hilo-2025.2.1 → python_hilo-2025.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: python-hilo
-Version: 2025.2.1
+Version: 2025.2.2
 Summary: A Python3, async interface to the Hilo API
 License: MIT
 Author: David Vallee Delisle
@@ -29,7 +29,7 @@ Requires-Dist: backoff (>=1.11.1)
 Requires-Dist: python-dateutil (>=2.8.2)
 Requires-Dist: ruyaml (>=0.91.0)
 Requires-Dist: voluptuous (>=0.13.1)
-Requires-Dist: websockets (>=8.1,<15.0)
+Requires-Dist: websockets (>=8.1,<16.0)
 Project-URL: Repository, https://github.com/dvd-dev/python-hilo
 Description-Content-Type: text/markdown
 

{python_hilo-2025.2.1 → python_hilo-2025.2.2}/pyhilo/api.py

@@ -385,7 +385,7 @@ class API:
         # instantiate differently
         self.websocket_devices = WebsocketClient(self.websocket_manager.devicehub)
 
-        # For backward compatibility during the transition to challengehub websocket 
+        # For backward compatibility during the transition to challengehub websocket
         self.websocket = self.websocket_devices
         self.websocket_challenges = WebsocketClient(self.websocket_manager.challengehub)
 

{python_hilo-2025.2.1 → python_hilo-2025.2.2}/pyhilo/const.py

@@ -8,7 +8,7 @@ import homeassistant.core
 LOG: Final = logging.getLogger(__package__)
 DEFAULT_STATE_FILE: Final = "hilo_state.yaml"
 REQUEST_RETRY: Final = 9
-PYHILO_VERSION: Final = "2025.2.01"
+PYHILO_VERSION: Final = "2025.2.02"
 # TODO: Find a way to keep previous line in sync with pyproject.toml automatically
 
 CONTENT_TYPE_FORM: Final = "application/x-www-form-urlencoded"

{python_hilo-2025.2.1 → python_hilo-2025.2.2}/pyhilo/event.py

@@ -10,6 +10,7 @@ LOG = logging.getLogger(__package__)
 
 
 class Event:
+    """This class is used to populate the data of a Hilo Challenge Event, contains datetime info and consumption data"""
     setting_deadline: datetime
     pre_cold_start: datetime
     pre_cold_end: datetime
@@ -62,6 +63,20 @@ class Event:
             "last_update",
         ]
 
+    def update_wh(self, used_wH: float) -> None:
+        """This function is used to update the used_kWh attribute during a Hilo Challenge Event"""
+        LOG.debug(f"Updating Wh: {used_wH}")
+        self.used_kWh = round(used_wH / 1000, 2)
+        self.last_update = datetime.now(timezone.utc).astimezone()
+
+    def should_check_for_allowed_wh(self) -> bool:
+        """This function is used to authorize subscribing to a specific event in Hilo to receive the allowed_kWh
+        that is made available in the pre_heat phase"""
+        now = datetime.now(self.preheat_start.tzinfo)
+        time_since_preheat_start = (self.preheat_start - now).total_seconds()
+        already_has_allowed_wh = self.allowed_kWh > 0
+        return 1800 <= time_since_preheat_start <= 2700 and not already_has_allowed_wh
+
     def as_dict(self) -> dict[str, Any]:
         rep = {k: getattr(self, k) for k in self.dict_items}
         rep["phases"] = {k: getattr(self, k) for k in self.phases_list}
@@ -69,6 +84,7 @@ class Event:
         return rep
 
     def _convert_phases(self, phases: dict[str, Any]) -> None:
+        """Formats phase times for later use"""
         self.phases_list = []
         for key, value in phases.items():
             phase_match = re.match(r"(.*)(DateUTC|Utc)", key)
@@ -89,6 +105,7 @@ class Event:
     def _create_phases(
         self, hours: int, phase_name: str, parent_phase: str
     ) -> datetime:
+        """Creates optional "appreciation" and "pre_cold" phases according to Hilo phases datetimes"""
         parent_start = getattr(self, f"{parent_phase}_start")
         phase_start = f"{phase_name}_start"
         phase_end = f"{phase_name}_end"
@@ -128,6 +145,7 @@ class Event:
 
     @property
     def state(self) -> str:
+        """Defines state in the next_event attribute"""
         now = datetime.now(self.preheat_start.tzinfo)
         if self.pre_cold_start and self.pre_cold_start <= now < self.pre_cold_end:
             return "pre_cold"

{python_hilo-2025.2.1 → python_hilo-2025.2.2}/pyhilo/util/__init__.py

@@ -1,7 +1,6 @@
 """Define utility modules."""
 import asyncio
 from datetime import datetime, timedelta
-import logging
 import re
 from typing import Any, Callable
 
@@ -10,9 +9,6 @@ from dateutil.parser import parse
 
 from pyhilo.const import LOG  # noqa: F401
 
-LOG = logging.getLogger(__package__)
-
-
 CAMEL_REX_1 = re.compile("(.)([A-Z][a-z]+)")
 CAMEL_REX_2 = re.compile("([a-z0-9])([A-Z])")
 

{python_hilo-2025.2.1 → python_hilo-2025.2.2}/pyproject.toml

@@ -40,7 +40,7 @@ exclude = ".venv/.*"
 
 [tool.poetry]
 name = "python-hilo"
-version = "2025.2.1"
+version = "2025.2.2"
 description = "A Python3, async interface to the Hilo API"
 readme = "README.md"
 authors = ["David Vallee Delisle <me@dvd.dev>"]
@@ -74,7 +74,7 @@ python-dateutil = ">=2.8.2"
 ruyaml = ">=0.91.0"
 python = "^3.9.0"
 voluptuous = ">=0.13.1"
-websockets = ">=8.1,<15.0"
+websockets = ">=8.1,<16.0"
 
 [tool.poetry.dev-dependencies]
 Sphinx = "^7.1.2"