pymiele 0.3.5__py3-none-any.whl → 0.4.0__py3-none-any.whl

pymiele/__init__.py

@@ -1,5 +1,6 @@
 """Library for Miele integration with Home Assistant."""
 
+from .code_enum import *  # noqa: F403
 from .const import *  # noqa: F403
 from .const import VERSION as __version__  # noqa: F401
 from .model import *  # noqa: F403

pymiele/code_enum.py

@@ -0,0 +1,52 @@
+"""Classes for code enums."""
+
+from enum import IntEnum
+import logging
+from typing import Any
+
+_LOGGER = logging.getLogger(__name__)
+completed_warnings: set[str] = set()
+
+
+class MieleEnum(IntEnum):
+    """Miele Enum for codes with int values."""
+
+    @property
+    def name(self) -> str:
+        """Force to lower case."""
+        return super().name.lower()
+
+    @classmethod
+    def _missing_(cls, value: object) -> Any | None:
+        if hasattr(cls, "unknown"):
+            warning = f"Missing {cls.__name__} code: {value} - defaulting to 'unknown'"
+            if warning not in completed_warnings:
+                completed_warnings.add(warning)
+                _LOGGER.warning(warning)
+            return cls.unknown
+        return None
+
+    @classmethod
+    def as_dict(cls) -> dict[str, int]:
+        """Return a dict of enum names and values."""
+        return {i.name: i.value for i in cls if i.name != "missing"}
+
+    @classmethod
+    def as_enum_dict(cls) -> dict[int, Any]:
+        """Return a dict of enum values and enum names."""
+        return {i.value: i for i in cls if i.name != "missing"}
+
+    @classmethod
+    def values(cls) -> list[int]:
+        """Return a list of enum values."""
+        return list(cls.as_dict().values())
+
+    @classmethod
+    def keys(cls) -> list[str]:
+        """Return a list of enum names."""
+        return list(cls.as_dict().keys())
+
+    @classmethod
+    def items(cls) -> Any:
+        """Return a list of enum items."""
+        return cls.as_dict().items()

pymiele/const.py

@@ -1,6 +1,6 @@
 """Constants for pymiele."""
 
-VERSION = "0.3.5"
+VERSION = "0.4.0"
 
 MIELE_API = "https://api.mcs3.miele.com/v1"
 OAUTH2_AUTHORIZE = "https://api.mcs3.miele.com/thirdparty/login"

pymiele/model.py

@@ -68,6 +68,29 @@ class MieleActionTargetTemperature:
         return self.raw_data["max"]
 
 
+class MielePlateStep:
+    """Model of plate step."""
+
+    def __init__(self, raw_data: dict) -> None:
+        """Initialize MielePlateStep."""
+        self.raw_data = raw_data
+
+    @property
+    def raw(self) -> dict:
+        """Return raw data."""
+        return self.raw_data
+
+    @property
+    def value_raw(self) -> int | None:
+        """Return raw value data."""
+        return self.raw_data["value_raw"]
+
+    @property
+    def value_localized(self) -> int | None:
+        """Return localized value."""
+        return self.raw_data["value_localized"]
+
+
 class MieleDevice:
     """Data for a single device from API."""
 
@@ -120,21 +143,41 @@ class MieleDevice:
         """Return the program ID of the device."""
         return self.raw_data["state"]["ProgramID"]["value_raw"]
 
+    @property
+    def state_program_id_localized(self) -> str:
+        """Return the program ID of the device."""
+        return self.raw_data["state"]["ProgramID"]["value_localized"]
+
     @property
     def state_status(self) -> int:
         """Return the status of the device."""
         return self.raw_data["state"]["status"]["value_raw"]
 
+    @property
+    def state_status_localized(self) -> str:
+        """Return the status of the device."""
+        return self.raw_data["state"]["status"]["value_localized"]
+
     @property
     def state_program_type(self) -> int:
         """Return the program type of the device."""
         return self.raw_data["state"]["programType"]["value_raw"]
 
+    @property
+    def state_program_type_localized(self) -> str:
+        """Return the program type of the device."""
+        return self.raw_data["state"]["programType"]["value_localized"]
+
     @property
     def state_program_phase(self) -> int:
         """Return the program phase of the device."""
         return self.raw_data["state"]["programPhase"]["value_raw"]
 
+    @property
+    def state_program_phase_localized(self) -> str:
+        """Return the program phase of the device."""
+        return self.raw_data["state"]["programPhase"]["value_localized"]
+
     @property
     def state_remaining_time(self) -> list[int]:
         """Return the remaining time of the device."""
@@ -154,11 +197,11 @@ class MieleDevice:
         ]
 
     @property
-    def state_core_target_temperature(self) -> list[dict]:
+    def state_core_target_temperature(self) -> list[MieleTemperature]:
         """Return the core target temperature of the device."""
         return [
             MieleTemperature(temp)
-            for temp in self.raw_data["state"]["coretargetTemperature"]
+            for temp in self.raw_data["state"]["coreTargetTemperature"]
         ]
 
     @property
@@ -257,9 +300,9 @@ class MieleDevice:
         self.raw_data["state"]["ventilationStep"]["value_raw"] = new_value
 
     @property
-    def state_plate_step(self) -> list[dict]:
+    def state_plate_step(self) -> list[MielePlateStep]:
         """Return the plate step of the device."""
-        return self.raw_data["state"]["plateStep"]
+        return [MielePlateStep(plate) for plate in self.raw_data["state"]["plateStep"]]
 
     @property
     def state_eco_feedback(self) -> dict | None:
@@ -362,7 +405,7 @@ class MieleAction:
         return list(self.raw_data["runOnTime"])
 
     @property
-    def target_temperature(self) -> list[dict]:
+    def target_temperature(self) -> list[MieleActionTargetTemperature]:
         """Return list of target temperature actions."""
         return [
             MieleActionTargetTemperature(temp)

{pymiele-0.3.5.dist-info → pymiele-0.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pymiele
-Version: 0.3.5
+Version: 0.4.0
 Summary: Python library for Miele integration with Home Assistant
 Author-email: Ake Strandberg <ake@strandberg.eu>
 License: MIT

pymiele-0.4.0.dist-info/RECORD

@@ -0,0 +1,11 @@
+pymiele/__init__.py,sha256=yaR_pvVA5HfAxQ9oHCk8CsoHfEkskdZLmxbY1QgrMBE,260
+pymiele/code_enum.py,sha256=AAtxgSyNtX96SlfdrFZs1DVwqTDR0jG2KfmOFoAkjI4,1511
+pymiele/const.py,sha256=9Lx35sUTeS1Vg7ISdkD9Yknfd8H7TAfNUIs8vCXPgFM,237
+pymiele/model.py,sha256=xJ8-J2fRlNHCO6g2_8mzpv0IKroHB3-VllzfGyjs-s4,16355
+pymiele/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pymiele/pymiele.py,sha256=M5P_rW61XZV06aelw5i9-qzJ9exabMYgLcehzuKd7-Y,8723
+pymiele-0.4.0.dist-info/licenses/LICENSE,sha256=scGm4_U2pd-rsGa6Edf6zsXFebrMT4RoyQz7-904_Wg,1072
+pymiele-0.4.0.dist-info/METADATA,sha256=1E8syZTDYz-xkxh8HYppilAD2mjqYA1QWINZoCwYnIY,747
+pymiele-0.4.0.dist-info/WHEEL,sha256=ck4Vq1_RXyvS4Jt6SI0Vz6fyVs4GWg7AINwpsaGEgPE,91
+pymiele-0.4.0.dist-info/top_level.txt,sha256=BwkHrSO2w_Bfxh6s8Ikcao5enEuQOpQhJ3SwUXBqY10,8
+pymiele-0.4.0.dist-info/RECORD,,

{pymiele-0.3.5.dist-info → pymiele-0.4.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (78.1.1)
+Generator: setuptools (80.0.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

pymiele-0.3.5.dist-info/RECORD

@@ -1,10 +0,0 @@
-pymiele/__init__.py,sha256=w_JvyaBHVGM7eo-FFwIWFbQUeAowoA_fbnAfCWJFGek,221
-pymiele/const.py,sha256=k5GfQFlwWb_PMu3F4DDAJTvJYJ3JS4snMpNWgs8TNJE,237
-pymiele/model.py,sha256=kqI9h3e3uqD1swxMtKCfFjkw2T2x5FoZagLEwwRkbhs,14969
-pymiele/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pymiele/pymiele.py,sha256=M5P_rW61XZV06aelw5i9-qzJ9exabMYgLcehzuKd7-Y,8723
-pymiele-0.3.5.dist-info/licenses/LICENSE,sha256=scGm4_U2pd-rsGa6Edf6zsXFebrMT4RoyQz7-904_Wg,1072
-pymiele-0.3.5.dist-info/METADATA,sha256=ssFKRrQHP3ds2dhlyAPqWTmzLVW5vScv_TL7m9OyYVw,747
-pymiele-0.3.5.dist-info/WHEEL,sha256=lTU6B6eIfYoiQJTZNc-fyaR6BpL6ehTzU3xGYxn2n8k,91
-pymiele-0.3.5.dist-info/top_level.txt,sha256=BwkHrSO2w_Bfxh6s8Ikcao5enEuQOpQhJ3SwUXBqY10,8
-pymiele-0.3.5.dist-info/RECORD,,