span-panel-api 2.6.1__tar.gz → 2.6.2__tar.gz

{span_panel_api-2.6.1 → span_panel_api-2.6.2}/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.6.2] - 04/2026
+
+### Changed
+
+- **Reconnect loop log noise reduced** — `SpanMqttClient._reconnect_loop` now splits the catch-all exception handler in two: expected transient failures (`OSError` family — refused connection, DNS miss, socket timeout, `ssl.SSLError`) log a one-line
+  WARNING with the exception repr, while unexpected exceptions retain the full traceback via `exc_info=True`. The common "panel offline" case no longer buries logs in paho/stdlib stack frames that add no diagnostic signal; genuinely unknown failures still
+  surface full tracebacks for support-ticket triage.
+
 ## [2.6.1] - 04/2026
 
 ### Changed

{span_panel_api-2.6.1 → span_panel_api-2.6.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: span-panel-api
-Version: 2.6.1
+Version: 2.6.2
 Summary: A client library for SPAN Panel API
 Project-URL: Homepage, https://github.com/SpanPanel/span-panel-api
 Project-URL: Issues, https://github.com/SpanPanel/span-panel-api/issues

{span_panel_api-2.6.1 → span_panel_api-2.6.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "span-panel-api"
-version = "2.6.1"
+version = "2.6.2"
 description = "A client library for SPAN Panel API"
 authors = [
     {name = "SpanPanel"}

{span_panel_api-2.6.1 → span_panel_api-2.6.2}/src/span_panel_api/mqtt/connection.py

@@ -407,10 +407,17 @@ class AsyncMqttBridge:
                     self._client.on_socket_open = self._on_socket_open_sync
                     self._client.on_socket_register_write = self._on_socket_register_write_sync
                     await self._loop.run_in_executor(None, self._client.reconnect)
+                except (OSError, TimeoutError) as exc:
+                    # Expected transient failures — panel offline, DNS miss, socket
+                    # timeout, refused connection. The exception type and errno are
+                    # the full diagnostic; paho/stdlib stack frames add no signal.
+                    # ssl.SSLError is an OSError subclass and falls in here too;
+                    # SSL misconfiguration would have failed at setup, so a
+                    # reconnect-time SSL error is handled as a transient failure.
+                    _LOGGER.warning("Reconnect failed (%s), retrying in %ss", exc, delay)
                 except Exception:  # pylint: disable=broad-exception-caught
-                    # paho can raise OSError, socket.gaierror, WebsocketConnectionError,
-                    # ssl.SSLError, and others depending on transport. Never let the
-                    # reconnect loop die — just log and keep backing off.
+                    # Unknown territory — keep the traceback so support tickets
+                    # are actionable. Never let the reconnect loop die.
                     _LOGGER.warning("Reconnect failed, retrying in %ss", delay, exc_info=True)
                 finally:
                     if self._client is not None:

{span_panel_api-2.6.1 → span_panel_api-2.6.2}/uv.lock

@@ -1310,7 +1310,7 @@ wheels = [
 
 [[package]]
 name = "span-panel-api"
-version = "2.6.1"
+version = "2.6.2"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },