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

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

@@ -2,6 +2,20 @@
 
 ## [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
+- `RST_STREAM with error code 0` (HTTP/2 `NO_ERROR`, a normal server-side graceful reset) is now logged at `DEBUG` instead of `WARNING` to reduce log noise
+- `CANCELLED` (server closed the stream normally, e.g. keepalive timeout or server rotation) is now logged at `INFO` instead of `WARNING`
+- `UNAUTHENTICATED` reconnects handled by the automatic token refresh are now logged at `INFO` instead of `WARNING`
+
 ## [0.3.0] - 2026-05-12
 
 ### Added

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quilt-hp-python
-Version: 0.3.0
+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
@@ -63,9 +63,9 @@ Requires-Dist: mkdocs>=1.6; extra == 'docs'
 Requires-Dist: mkdocstrings[python]>=0.29; extra == 'docs'
 Description-Content-Type: text/markdown
 
-# quilt-hp-python
+# Quilt Python Client
 
-Async Python client library for [Quilt](https://www.quilt.com/) mini-split HVAC systems.
+Python client library for [Quilt](https://www.quilt.com/) mini-split HVAC systems.
 
 Communicates with the Quilt cloud API via gRPC to control spaces (rooms), indoor units,
 comfort presets, schedules, and stream real-time updates.

{quilt_hp_python-0.3.0 → quilt_hp_python-0.3.2}/README.md

@@ -1,6 +1,6 @@
-# quilt-hp-python
+# Quilt Python Client
 
-Async Python client library for [Quilt](https://www.quilt.com/) mini-split HVAC systems.
+Python client library for [Quilt](https://www.quilt.com/) mini-split HVAC systems.
 
 Communicates with the Quilt cloud API via gRPC to control spaces (rooms), indoor units,
 comfort presets, schedules, and stream real-time updates.

{quilt_hp_python-0.3.0 → quilt_hp_python-0.3.2}/docs/reference/client.md

@@ -69,7 +69,7 @@ Raised when a requested resource does not exist (gRPC `NOT_FOUND`).
 ### `__version__`
 
 ```python
-__version__: str  # e.g. "0.3.0"
+__version__: str  # e.g. "0.3.1"
 ```
 
 ---

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

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "quilt-hp-python"
-version = "0.3.0"
+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.0 → quilt_hp_python-0.3.2}/src/quilt_hp/__init__.py

@@ -10,7 +10,7 @@ from quilt_hp.exceptions import (
     QuiltStreamError,
 )
 
-__version__ = "0.3.0"
+__version__ = "0.3.1"
 
 __all__ = [
     "Environment",

{quilt_hp_python-0.3.0 → 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]

{quilt_hp_python-0.3.0 → quilt_hp_python-0.3.2}/src/quilt_hp/services/streaming.py

@@ -612,7 +612,9 @@ class NotifierStream:
 
                 if is_unauth and self._authenticate is not None and can_retry:
                     self._stream_state = "reconnecting"
-                    logger.warning(
+                    # Token expiry is handled automatically — INFO to confirm it
+                    # happened without alarming the user.
+                    logger.info(
                         "Stream got UNAUTHENTICATED; refreshing token (attempt %d)",
                         attempt + 1,
                     )
@@ -630,10 +632,25 @@ class NotifierStream:
                         break
                 elif can_retry:
                     self._stream_state = "reconnecting"
-                    logger.warning(
+                    details = exc.details() or ""
+                    # Classify the error to pick the right log level:
+                    #   DEBUG  — HTTP/2 NO_ERROR RST_STREAM: server gracefully
+                    #            recycled the connection (load balancer, keepalive).
+                    #   INFO   — CANCELLED: server closed the stream normally
+                    #            (keepalive timeout, server rotation, etc.).
+                    #   WARNING — anything else is unexpected.
+                    is_graceful_reset = "RST_STREAM with error code 0" in details
+                    is_server_cancel = exc.code() == grpc.StatusCode.CANCELLED
+                    if is_graceful_reset:
+                        log = logger.debug
+                    elif is_server_cancel:
+                        log = logger.info
+                    else:
+                        log = logger.warning
+                    log(
                         "Stream error %s: %s; reconnecting in %.1fs (attempt %d)",
                         exc.code(),
-                        exc.details(),
+                        details,
                         delay,
                         attempt + 1,
                     )

{quilt_hp_python-0.3.0 → quilt_hp_python-0.3.2}/tests/test_cli_surfaces_extra.py

@@ -16,7 +16,7 @@ runner = CliRunner()
 def test_version_option_outputs_package_version() -> None:
     result = runner.invoke(cli_main.app, ["--version"])
     assert result.exit_code == 0
-    assert result.stdout.strip() == "0.3.0"
+    assert result.stdout.strip() == "0.3.1"
 
 
 class _FakeClient: