quilt-hp-python 0.3.1__tar.gz → 0.3.2__tar.gz

{quilt_hp_python-0.3.1 → quilt_hp_python-0.3.2}/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## [Unreleased]
 
+## [0.3.2] - 2026-05-19
+
+### Added
+- `LouverAngle.label` property and `__str__` with human-readable position names:
+  `ANGLE1` → `"Horizontal"`, `ANGLE2` → `"Slightly Down"`, `ANGLE3` → `"Down"`,
+  `ANGLE4` → `"Mostly Down"`, `ANGLE5` → `"Straight Down"`
+
 ## [0.3.1] - 2026-05-14
 
 ### Fixed

{quilt_hp_python-0.3.1 → quilt_hp_python-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quilt-hp-python
-Version: 0.3.1
+Version: 0.3.2
 Summary: Async Python client for Quilt mini-split HVAC systems
 Project-URL: Repository, https://github.com/eman/quilt-hp-python
 Project-URL: Issues, https://github.com/eman/quilt-hp-python/issues

{quilt_hp_python-0.3.1 → quilt_hp_python-0.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "quilt-hp-python"
-version = "0.3.1"
+version = "0.3.2"
 description = "Async Python client for Quilt mini-split HVAC systems"
 readme = "README.md"
 license = { file = "LICENSE" }

{quilt_hp_python-0.3.1 → quilt_hp_python-0.3.2}/src/quilt_hp/models/enums.py

@@ -94,8 +94,20 @@ class LouverMode(IntEnum):
         return self.name
 
 
+_LOUVER_ANGLE_LABELS: dict[int, str] = {
+    1: "Horizontal",
+    2: "Slightly Down",
+    3: "Down",
+    4: "Mostly Down",
+    5: "Straight Down",
+}
+
+
 class LouverAngle(IntEnum):
-    """Discrete louver angle positions (when mode=FIXED)."""
+    """Discrete louver angle positions (when mode=FIXED).
+
+    Positions run from most horizontal (ANGLE1) to most downward (ANGLE5).
+    """
 
     ANGLE1 = 1
     ANGLE2 = 2
@@ -103,6 +115,14 @@ class LouverAngle(IntEnum):
     ANGLE4 = 4
     ANGLE5 = 5
 
+    @property
+    def label(self) -> str:
+        """Human-readable position name."""
+        return _LOUVER_ANGLE_LABELS[self.value]
+
+    def __str__(self) -> str:
+        return self.label
+
     def to_wire(self) -> float:
         """Return the louver_fixed_position float for the wire."""
         return {1: 0.20, 2: 0.40, 3: 0.60, 4: 0.80, 5: 1.00}[self.value]