socketry 0.2.1__tar.gz → 0.2.2__tar.gz

{socketry-0.2.1 → socketry-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: socketry
-Version: 0.2.1
+Version: 0.2.2
 Summary: Python API and CLI for controlling Jackery portable power stations
 Author: Jesus Lopez
 Author-email: Jesus Lopez <jesus@jesusla.com>

{socketry-0.2.1 → socketry-0.2.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "socketry"
-version = "0.2.1"
+version = "0.2.2"
 description = "Python API and CLI for controlling Jackery portable power stations"
 readme = "README.md"
 authors = [

{socketry-0.2.1 → socketry-0.2.2}/src/socketry/__init__.py

@@ -1,6 +1,13 @@
 """Python API and CLI for controlling Jackery portable power stations."""
 
-from socketry.client import AuthenticationError, Client, Device, MqttError, Subscription
+from socketry.client import (
+    AuthenticationError,
+    Client,
+    Device,
+    MqttError,
+    SocketryError,
+    Subscription,
+)
 from socketry.properties import MODEL_NAMES, PROPERTIES, Setting
 
 __all__ = [
@@ -11,5 +18,6 @@ __all__ = [
     "MqttError",
     "PROPERTIES",
     "Setting",
+    "SocketryError",
     "Subscription",
 ]

{socketry-0.2.1 → socketry-0.2.2}/src/socketry/client.py

@@ -55,11 +55,15 @@ from socketry.properties import Setting, resolve
 _TOKEN_EXPIRY_BUFFER = 3600  # seconds before expiry to trigger proactive refresh
 
 
-class TokenExpiredError(RuntimeError):
+class SocketryError(Exception):
+    """Base exception for all socketry errors."""
+
+
+class TokenExpiredError(SocketryError):
     """Raised when the Jackery API returns error code 10402 (token expired)."""
 
 
-class AuthenticationError(Exception):
+class AuthenticationError(SocketryError):
     """Raised when login fails after an automatic re-authentication attempt.
 
     Triggered when the Jackery API returns an auth error (session invalidated
@@ -68,7 +72,7 @@ class AuthenticationError(Exception):
     """
 
 
-class _SessionInvalidatedError(RuntimeError):
+class _SessionInvalidatedError(SocketryError):
     """Internal sentinel: API returned a non-token-expiry auth/API error.
 
     Raised by HTTP helpers to signal that the current session is rejected by
@@ -77,7 +81,7 @@ class _SessionInvalidatedError(RuntimeError):
     """
 
 
-class MqttError(ConnectionError):
+class MqttError(SocketryError, ConnectionError):
     """Raised when an MQTT operation fails.
 
     Wraps :class:`aiomqtt.MqttError` so callers do not need to import
@@ -854,7 +858,7 @@ async def _http_login(
 
         if body.get("code") != 0:
             msg = body.get("msg", "unknown error")
-            raise RuntimeError(f"Login failed: {msg}")
+            raise AuthenticationError(f"Login failed: {msg}")
 
         data = body["data"]
         token = body["token"]