daybetter-services-python 1.0.0__py3-none-any.whl

daybetter_python/__init__.py

@@ -0,0 +1,7 @@
+"""DayBetter Python client library."""
+
+from .client import DayBetterClient
+from .exceptions import DayBetterError, AuthenticationError, APIError
+
+__version__ = "1.0.0"
+__all__ = ["DayBetterClient", "DayBetterError", "AuthenticationError", "APIError"]

daybetter_python/client.py

@@ -0,0 +1,260 @@
+"""DayBetter API client."""
+
+import aiohttp
+import logging
+from typing import Any, Dict, List, Optional, Tuple
+
+from .exceptions import DayBetterError, AuthenticationError, APIError
+
+_LOGGER = logging.getLogger(__name__)
+
+
+class DayBetterClient:
+    """DayBetter API client."""
+    
+    def __init__(
+        self, 
+        token: str, 
+        base_url: str = "https://a.dbiot.org/daybetter/hass/api/v1.0/"
+    ):
+        """Initialize the client.
+        
+        Args:
+            token: Authentication token
+            base_url: Base URL for the API
+        """
+        self.token = token
+        self.base_url = base_url
+        self._session: Optional[aiohttp.ClientSession] = None
+        self._auth_valid = True
+    
+    async def __aenter__(self):
+        """Async context manager entry."""
+        self._session = aiohttp.ClientSession()
+        return self
+    
+    async def __aexit__(self, exc_type, exc_val, exc_tb):
+        """Async context manager exit."""
+        if self._session:
+            await self._session.close()
+            self._session = None
+    
+    def _get_session(self) -> aiohttp.ClientSession:
+        """Get or create aiohttp session."""
+        if not self._session:
+            self._session = aiohttp.ClientSession()
+        return self._session
+    
+    def _get_headers(self) -> Dict[str, str]:
+        """Get request headers."""
+        return {"Authorization": f"Bearer {self.token}"}
+    
+    async def fetch_devices(self) -> List[Dict[str, Any]]:
+        """Fetch devices from API.
+        
+        Returns:
+            List of device dictionaries
+            
+        Raises:
+            AuthenticationError: If authentication fails
+            APIError: If API request fails
+        """
+        try:
+            session = self._get_session()
+            url = f"{self.base_url}hass/devices"
+            headers = self._get_headers()
+            
+            async with session.post(url, headers=headers) as resp:
+                if resp.status == 200:
+                    data = await resp.json()
+                    devices = data.get("data", [])
+                    _LOGGER.debug("Fetched devices: %s", devices)
+                    self._auth_valid = True
+                    return devices
+                elif resp.status == 401:
+                    _LOGGER.error("Authentication failed - token may be expired")
+                    self._auth_valid = False
+                    raise AuthenticationError("Authentication failed - token may be expired")
+                else:
+                    error_text = await resp.text()
+                    _LOGGER.error("Failed to fetch devices: %s", error_text)
+                    raise APIError(f"API error {resp.status}: {error_text}")
+        except aiohttp.ClientError as e:
+            _LOGGER.exception("Client error while fetching devices: %s", e)
+            raise APIError(f"Client error: {e}")
+        except Exception as e:
+            _LOGGER.exception("Exception while fetching devices: %s", e)
+            raise DayBetterError(f"Unexpected error: {e}")
+    
+    async def fetch_pids(self) -> Dict[str, Any]:
+        """Fetch device type PIDs.
+        
+        Returns:
+            Dictionary of device type PIDs
+            
+        Raises:
+            AuthenticationError: If authentication fails
+            APIError: If API request fails
+        """
+        try:
+            session = self._get_session()
+            url = f"{self.base_url}hass/pids"
+            headers = self._get_headers()
+            
+            async with session.post(url, headers=headers) as resp:
+                if resp.status == 200:
+                    data = await resp.json()
+                    self._auth_valid = True
+                    return data.get("data", {})
+                elif resp.status == 401:
+                    _LOGGER.error("Authentication failed - token may be expired")
+                    self._auth_valid = False
+                    raise AuthenticationError("Authentication failed - token may be expired")
+                else:
+                    error_text = await resp.text()
+                    _LOGGER.error("Failed to fetch PIDs: %s", error_text)
+                    raise APIError(f"API error {resp.status}: {error_text}")
+        except aiohttp.ClientError as e:
+            _LOGGER.exception("Client error while fetching PIDs: %s", e)
+            raise APIError(f"Client error: {e}")
+        except Exception as e:
+            _LOGGER.exception("Exception while fetching PIDs: %s", e)
+            raise DayBetterError(f"Unexpected error: {e}")
+    
+    async def control_device(
+        self,
+        device_name: str,
+        action: bool,
+        brightness: Optional[int] = None,
+        hs_color: Optional[Tuple[float, float]] = None,
+        color_temp: Optional[int] = None,
+    ) -> Dict[str, Any]:
+        """Control a device.
+        
+        Args:
+            device_name: Name of the device to control
+            action: Switch action (True/False)
+            brightness: Brightness value (0-255)
+            hs_color: Hue and saturation tuple (hue, saturation)
+            color_temp: Color temperature in mireds
+            
+        Returns:
+            Control result dictionary
+            
+        Raises:
+            AuthenticationError: If authentication fails
+            APIError: If API request fails
+        """
+        session = self._get_session()
+        url = f"{self.base_url}hass/control"
+        headers = self._get_headers()
+        
+        # Priority: color temperature > color > brightness > switch
+        if color_temp is not None:
+            # Convert mireds to Kelvin
+            kelvin = int(1000000 / color_temp)
+            payload = {
+                "deviceName": device_name,
+                "type": 4,  # Type 4 is color temperature control
+                "kelvin": kelvin,
+            }
+        elif hs_color is not None:
+            h, s = hs_color
+            v = (brightness / 255) if brightness is not None else 1.0
+            payload = {
+                "deviceName": device_name,
+                "type": 3,
+                "hue": h,
+                "saturation": s / 100,
+                "brightness": v,
+            }
+        elif brightness is not None:
+            payload = {
+                "deviceName": device_name, 
+                "type": 2, 
+                "brightness": brightness
+            }
+        else:
+            # Type 1 control switch is used by default
+            payload = {
+                "deviceName": device_name, 
+                "type": 1, 
+                "on": action
+            }
+        
+        try:
+            async with session.post(url, headers=headers, json=payload) as resp:
+                if resp.status == 200:
+                    self._auth_valid = True
+                    return await resp.json()
+                elif resp.status == 401:
+                    _LOGGER.error("Authentication failed - token may be expired")
+                    self._auth_valid = False
+                    raise AuthenticationError("Authentication failed - token may be expired")
+                else:
+                    error_text = await resp.text()
+                    _LOGGER.error(
+                        "Failed to control device %s: HTTP %d - %s", 
+                        device_name, resp.status, error_text
+                    )
+                    raise APIError(f"API error {resp.status}: {error_text}")
+        except aiohttp.ClientError as e:
+            _LOGGER.exception(
+                "Client error while controlling device %s: %s", device_name, e
+            )
+            raise APIError(f"Client error: {e}")
+        except Exception as e:
+            _LOGGER.exception(
+                "Exception while controlling device %s: %s", device_name, e
+            )
+            raise DayBetterError(f"Unexpected error: {e}")
+    
+    async def fetch_mqtt_config(self) -> Dict[str, Any]:
+        """Fetch MQTT connection configuration.
+        
+        Returns:
+            MQTT configuration dictionary
+            
+        Raises:
+            AuthenticationError: If authentication fails
+            APIError: If API request fails
+        """
+        session = self._get_session()
+        url = f"{self.base_url}hass/cert"
+        headers = self._get_headers()
+        _LOGGER.debug("Requesting MQTT configuration URL: %s", url)
+        
+        try:
+            async with session.post(url, headers=headers) as resp:
+                _LOGGER.debug("MQTT configuration API response status: %d", resp.status)
+                
+                if resp.status == 200:
+                    data = await resp.json()
+                    _LOGGER.debug("MQTT configuration API raw response: %s", data)
+                    self._auth_valid = True
+                    return data.get("data", {})
+                elif resp.status == 401:
+                    _LOGGER.error("Authentication failed - token may be expired")
+                    self._auth_valid = False
+                    raise AuthenticationError("Authentication failed - token may be expired")
+                else:
+                    error_text = await resp.text()
+                    _LOGGER.error("Failed to fetch MQTT config: %s", error_text)
+                    raise APIError(f"API error {resp.status}: {error_text}")
+        except aiohttp.ClientError as e:
+            _LOGGER.exception("Client error while fetching MQTT config: %s", e)
+            raise APIError(f"Client error: {e}")
+        except Exception as e:
+            _LOGGER.exception("Exception while fetching MQTT config: %s", e)
+            raise DayBetterError(f"Unexpected error: {e}")
+    
+    @property
+    def is_authenticated(self) -> bool:
+        """Check if the API client is authenticated."""
+        return self._auth_valid
+    
+    async def close(self):
+        """Close the client session."""
+        if self._session:
+            await self._session.close()
+            self._session = None

daybetter_python/exceptions.py

@@ -0,0 +1,13 @@
+"""DayBetter client exceptions."""
+
+
+class DayBetterError(Exception):
+    """Base exception for DayBetter client."""
+
+
+class AuthenticationError(DayBetterError):
+    """Authentication failed."""
+
+
+class APIError(DayBetterError):
+    """API request failed."""

daybetter_services_python-1.0.0.dist-info/METADATA

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: daybetter-services-python
+Version: 1.0.0
+Summary: Python client for DayBetter devices and services
+Home-page: https://github.com/THDayBetter/daybetter-python
+Author: THDayBetter
+Author-email: THDayBetter <chenp2368@163.com>
+Maintainer-email: THDayBetter <chenp2368@163.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/THDayBetter/daybetter-python
+Project-URL: Documentation, https://github.com/THDayBetter/daybetter-python#readme
+Project-URL: Repository, https://github.com/THDayBetter/daybetter-python.git
+Project-URL: Bug Tracker, https://github.com/THDayBetter/daybetter-python/issues
+Keywords: daybetter,iot,home automation,mqtt
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.8.0
+Provides-Extra: dev
+Requires-Dist: pytest>=6.0; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: isort; extra == "dev"
+Requires-Dist: flake8; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# DayBetter Python Client
+
+A Python client library for interacting with DayBetter devices and services.
+
+## Features
+
+- Device management and control
+- MQTT configuration retrieval
+- Authentication handling
+- Async/await support
+
+## Installation
+
+```bash
+pip install daybetter-services-python
+```
+
+## Usage
+
+```python
+import asyncio
+from daybetter_python import DayBetterClient
+
+async def main():
+    async with DayBetterClient(token="your_token") as client:
+        # Fetch devices
+        devices = await client.fetch_devices()
+        print(f"Found {len(devices)} devices")
+        
+        # Control a device
+        result = await client.control_device(
+            device_name="device_001",
+            action=True,
+            brightness=80
+        )
+        print(f"Control result: {result}")
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## API Reference
+
+### DayBetterClient
+
+#### Methods
+
+- `fetch_devices()`: Get list of devices
+- `fetch_pids()`: Get device type PIDs
+- `control_device(device_name, action, brightness, hs_color, color_temp)`: Control a device
+- `fetch_mqtt_config()`: Get MQTT configuration
+
+## License
+
+MIT License
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.

daybetter_services_python-1.0.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+daybetter_python/__init__.py,sha256=8LEDwEsef-VkjE4G2OT-AqYHgk3A3rwv-00Is7glG5I,252
+daybetter_python/client.py,sha256=49l-o-jQBZOIMG9-5pNfUXxKeKCs3h9JCRpATpFIJTk,9957
+daybetter_python/exceptions.py,sha256=G8pURDQVfvCvgsWVi6980CrKDpPwN2aYqQkS4zFpvYM,259
+daybetter_services_python-1.0.0.dist-info/licenses/LICENSE,sha256=DbDD4ZqrGs-Zj3ffqcf35iwo9gM2bBc4WSCYbohM1-M,1068
+daybetter_services_python-1.0.0.dist-info/METADATA,sha256=r3c_4VdJXBnkgCu-zeMT6lIofRkkwqEGenR5lFEefX8,2817
+daybetter_services_python-1.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+daybetter_services_python-1.0.0.dist-info/top_level.txt,sha256=cRqnqd_T8N2nPkR6x6fqB-DkUgXQ0baNqayVn6RdDFo,17
+daybetter_services_python-1.0.0.dist-info/RECORD,,

daybetter_services_python-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

daybetter_services_python-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 THDayBetter
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

daybetter_services_python-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+daybetter_python