python-hotspring 1.1.0__tar.gz → 1.2.0__tar.gz

{python_hotspring-1.1.0 → python_hotspring-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-hotspring
-Version: 1.1.0
+Version: 1.2.0
 Summary: Asynchronous Python client for Hot Spring Connected Spa Kit 2.
 License: MIT
 License-File: LICENSE

{python_hotspring-1.1.0 → python_hotspring-1.2.0}/pyproject.toml

@@ -22,7 +22,7 @@ packages = [
 ]
 readme = "README.md"
 repository = "https://github.com/Moustachauve/python-hotspring"
-version = "1.1.0"
+version = "1.2.0"
 
 [tool.poetry.dependencies]
 aiohttp = ">=3.0.0"

{python_hotspring-1.1.0 → python_hotspring-1.2.0}/src/hotspring/models.py

@@ -202,6 +202,32 @@ class SpaInfo:
             volume=int(model_status.get("volume") or 0),
         )
 
+    @property
+    def mac_address(self) -> str:
+        """Derive the MAC address from root_topic.
+
+        The HNA firmware builds root_topic as ``mySpa%02X%02X%02X%02X%02X%02X``
+        using the device's 6-byte WiFi MAC, so the 12 hex characters after the
+        ``mySpa`` prefix are the full MAC address.
+
+        Returns
+        -------
+            Colon-separated uppercase MAC (e.g. ``"AA:BB:CC:11:22:33"``),
+            or ``""`` if root_topic does not match the expected format.
+
+        """
+        prefix = "mySpa"
+        if not self.root_topic.startswith(prefix):
+            return ""
+        mac_hex = self.root_topic[len(prefix) :]
+        try:
+            mac_bytes = bytes.fromhex(mac_hex)
+        except ValueError:
+            return ""
+        if len(mac_bytes) != 6:
+            return ""
+        return ":".join(f"{b:02X}" for b in mac_bytes)
+
 
 @dataclass
 class Heater:  # pylint: disable=too-many-instance-attributes