switchbot-api 2.12.0__tar.gz → 2.13.1__tar.gz

{switchbot_api-2.12.0 → switchbot_api-2.13.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: switchbot_api
-Version: 2.12.0
+Version: 2.13.1
 Summary: An asynchronous library to use Switchbot API
 License: MIT
 License-File: LICENSE
@@ -14,6 +14,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Requires-Dist: aiohttp (>=3.0.0)
 Requires-Dist: pycryptodome (>=3.23.0,<4.0.0)
 Project-URL: Repository, https://github.com/SeraphicCorp/py-switchbot-api

{switchbot_api-2.12.0 → switchbot_api-2.13.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "switchbot_api"
-version = "2.12.0"
+version = "2.13.1"
 description = "An asynchronous library to use Switchbot API"
 authors = ["Ravaka Razafimanantsoa <contact@ravaka.dev>"]
 license = "MIT"

{switchbot_api-2.12.0 → switchbot_api-2.13.1}/switchbot_api/__init__.py

@@ -33,6 +33,7 @@ from switchbot_api.commands import (
     FanCommands,
     HumidifierCommands,
     HumidifierV2Commands,
+    KataFriendsCommands,
     KeyPadCommands,
     LightCommands,
     LockCommands,
@@ -57,14 +58,24 @@ from switchbot_api.exceptions import (
     SwitchBotAuthenticationError,
     SwitchBotConnectionError,
     SwitchBotDeviceOfflineError,
+    SwitchBotDeviceRequestError,
+    SwitchBotError,
 )
 from switchbot_api.models import (
     AirPurifierFanGear,
     AirPurifierMode,
+    AirPurifierModeV2,
+    BatteryCirculatorFan2ProMode,
     BatteryCirculatorFanMode,
     BatteryLevel,
+    Humidifier2Mode,
+    KataFriendsHospitalizedStatus,
+    KataFriendsMode,
+    KataFriendsWorkStatus,
     PowerState,
     SmartRadiatorThermostatMode,
+    Switch,
+    SwitchbotCloudDeviceLockState,
     VacuumCleanMode,
     VacuumFanSpeed,
     VacuumFanSpeedV2,
@@ -75,7 +86,9 @@ __all__ = [
     "AirPurifierCommands",
     "AirPurifierFanGear",
     "AirPurifierMode",
+    "AirPurifierModeV2",
     "ArtFrameCommands",
+    "BatteryCirculatorFan2ProMode",
     "BatteryCirculatorFanCommands",
     "BatteryCirculatorFanMode",
     "BatteryLevel",
@@ -89,8 +102,13 @@ __all__ = [
     "Device",
     "DoorBellCommands",
     "FanCommands",
+    "Humidifier2Mode",
     "HumidifierCommands",
     "HumidifierV2Commands",
+    "KataFriendsCommands",
+    "KataFriendsHospitalizedStatus",
+    "KataFriendsMode",
+    "KataFriendsWorkStatus",
     "KeyPadCommands",
     "LightCommands",
     "LockCommands",
@@ -106,9 +124,16 @@ __all__ = [
     "SmartRadiatorThermostatCommands",
     "SmartRadiatorThermostatMode",
     "SpeakerCommands",
+    "Switch",
     "Switch2PMCommands",
     "SwitchBotAPI",
+    "SwitchBotAuthenticationError",
+    "SwitchBotConnectionError",
+    "SwitchBotDeviceOfflineError",
+    "SwitchBotDeviceRequestError",
+    "SwitchBotError",
     "SwitchCommands",
+    "SwitchbotCloudDeviceLockState",
     "T",
     "TVCommands",
     "VacuumCleanMode",
@@ -214,9 +239,11 @@ class SwitchBotAPI:
         except (
             ClientError,
             ClientResponseError,
-            socket.gaierror,
         ) as exception:
-            msg = "Error occurred while communicating with the SwitchBot API"
+            msg = f"Error occurred while communicating, Status Code: {exception}"
+            raise SwitchBotConnectionError(msg) from exception
+        except socket.gaierror as exception:
+            msg = "DNS resolution failed."
             raise SwitchBotConnectionError(msg) from exception
         if response.status == 403:
             raise SwitchBotAuthenticationError

{switchbot_api-2.12.0 → switchbot_api-2.13.1}/switchbot_api/commands.py

@@ -241,6 +241,7 @@ class RGBWWLightCommands(Commands):
             "RGBICWW Floor Lamp",
             "RGBICWW Strip Light",
             "Permanent Outdoor Lights",
+            "RGBICWW Light Bars",
         ]
 
 
@@ -295,7 +296,7 @@ class ArtFrameCommands(Commands):
     @classmethod
     def get_supported_devices(cls) -> list[str]:
         """Get supported devices."""
-        return ["AI Art Frame"]
+        return ["AI Art Frame", "AI Art Frame Luma"]
 
 
 class DoorBellCommands(Commands):
@@ -480,4 +481,20 @@ class KeyPadCommands(Commands):
         return ["Keypad", "Keypad Touch", "Keypad Vision", "Keypad Vision Pro"]
 
 
+class KataFriendsCommands(Commands):
+    """Kata Friends commands."""
+
+    MODE = "mode"
+    BACK_HOME = "backHome"
+    SNAPSHOTS = "snapshots"
+    CHILD_LOCK = "childLock"
+    PICTURE_TAKING = "pictureTaking"
+    TALK = "talk"
+
+    @classmethod
+    def get_supported_devices(cls) -> list[str]:
+        """Get supported devices."""
+        return ["Kata Friends"]
+
+
 T = TypeVar("T", bound=CommonCommands)

{switchbot_api-2.12.0 → switchbot_api-2.13.1}/switchbot_api/models.py

@@ -21,6 +21,16 @@ class BatteryCirculatorFanMode(StrEnum):
     BABY = "baby"
 
 
+class BatteryCirculatorFan2ProMode(StrEnum):
+    """Fan mode types [Battery Circulator Fan2 Pro] API."""
+
+    DIRECT = "direct"
+    NATURAL = "natural"
+    SLEEP = "sleep"
+    BABY = "baby"
+    HURRICANE = "hurricane"
+
+
 class AirPurifierMode(Enum):
     """mode types [Air Purifier] API."""
 
@@ -30,6 +40,20 @@ class AirPurifierMode(Enum):
     PET = 4
 
 
+class AirPurifierModeV2(Enum):
+    """Air Purifier Modes."""
+
+    NORMAL = 1
+    AUTO = 2
+    SLEEP = 3
+    PET = 4
+
+    @classmethod
+    def get_modes(cls) -> list[str]:
+        """Return a list of available air purifier modes as lowercase strings."""
+        return [mode.name.lower() for mode in cls]
+
+
 class AirPurifierFanGear(Enum):
     """Air Purifier Fan Gear."""
 
@@ -108,3 +132,78 @@ class BatteryLevel(Enum):
         if 10 > value >= 0:
             return cls.Critical
         return cls.Unknown
+
+
+class Switch(Enum):
+    """Switch parameter."""
+
+    ON = "on"
+    OFF = "off"
+
+
+class KataFriendsMode(Enum):
+    """Kata Friends Mode."""
+
+    NORMAL = "Normal"
+    STANDBY = "Standby"
+    SLEEP = "Sleep"
+
+
+class KataFriendsWorkStatus(Enum):
+    """Kata Friends Work Status."""
+
+    STROLLING = "Strolling"
+    WELCOMING_HOME = "Welcoming Home"
+    WAKE_UP_CALL = "Wake-up Call"
+    SLEEPING = "Sleeping"
+    PLAYING = "Playing"
+    RETURNING = "Returning"
+
+
+class KataFriendsHospitalizedStatus(Enum):
+    """Kata Friends Hospitalized Status."""
+
+    NORMAL = 0
+    REPAIR = 1
+    MAINTAIN = 2
+    CLEAN = 3
+
+
+class Humidifier2Mode(Enum):
+    """Enumerates the available modes for a SwitchBot humidifier2."""
+
+    HIGH = 1
+    MEDIUM = 2
+    LOW = 3
+    QUIET = 4
+    TARGET_HUMIDITY = 5
+    SLEEP = 6
+    AUTO = 7
+    DRYING_FILTER = 8
+
+    @classmethod
+    def get_modes(cls) -> list[str]:
+        """Return a list of available humidifier2 modes as lowercase strings."""
+        return [mode.name.lower() for mode in cls]
+
+
+class SwitchbotCloudDeviceLockState(Enum):
+    """Lock State."""
+
+    LOCKED = "locked"
+    UNLOCKED = "unlocked"
+    LOCKING = "locking"
+    UNLOCKING = "unlocking"
+    JAMMED = "jammed"
+    LATCH_BOLT_LOCKED = "latchBoltLocked"
+    HALF_LOCKED = "halfLocked"
+
+    @classmethod
+    def get_states(cls) -> list[SwitchbotCloudDeviceLockState]:
+        """Get lock states."""
+        return list(cls)
+
+    @classmethod
+    def get_values(cls) -> list[str]:
+        """Get lock value."""
+        return [mode.value for mode in cls]