daybetter-services-python 1.0.0__tar.gz

daybetter_services_python-1.0.0/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/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,59 @@
+# 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/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_services_python-1.0.0/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_services_python-1.0.0/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/daybetter_services_python.egg-info/PKG-INFO

@@ -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/daybetter_services_python.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+setup.py
+daybetter_python/__init__.py
+daybetter_python/client.py
+daybetter_python/exceptions.py
+daybetter_services_python.egg-info/PKG-INFO
+daybetter_services_python.egg-info/SOURCES.txt
+daybetter_services_python.egg-info/dependency_links.txt
+daybetter_services_python.egg-info/requires.txt
+daybetter_services_python.egg-info/top_level.txt

daybetter_services_python-1.0.0/daybetter_services_python.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

daybetter_services_python-1.0.0/daybetter_services_python.egg-info/requires.txt

@@ -0,0 +1,9 @@
+aiohttp>=3.8.0
+
+[dev]
+pytest>=6.0
+pytest-asyncio
+black
+isort
+flake8
+mypy

daybetter_services_python-1.0.0/daybetter_services_python.egg-info/top_level.txt

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

daybetter_services_python-1.0.0/pyproject.toml

@@ -0,0 +1,57 @@
+[build-system]
+requires = ["setuptools>=45", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "daybetter-services-python"
+version = "1.0.0"
+description = "Python client for DayBetter devices and services"
+readme = "README.md"
+license = "MIT"
+authors = [
+    {name = "THDayBetter", email = "chenp2368@163.com"}
+]
+maintainers = [
+    {name = "THDayBetter", email = "chenp2368@163.com"}
+]
+keywords = ["daybetter", "iot", "home automation", "mqtt"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+requires-python = ">=3.8"
+dependencies = [
+    "aiohttp>=3.8.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/THDayBetter/daybetter-python"
+Documentation = "https://github.com/THDayBetter/daybetter-python#readme"
+Repository = "https://github.com/THDayBetter/daybetter-python.git"
+"Bug Tracker" = "https://github.com/THDayBetter/daybetter-python/issues"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=6.0",
+    "pytest-asyncio",
+    "black",
+    "isort",
+    "flake8",
+    "mypy",
+]
+
+
+[tool.black]
+line-length = 88
+target-version = ['py38']
+
+[tool.isort]
+profile = "black"
+line_length = 88

daybetter_services_python-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

daybetter_services_python-1.0.0/setup.py

@@ -0,0 +1,34 @@
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="daybetter-services-python",
+    version="1.0.0",
+    author="THDayBetter",
+    author_email="chenp2368@163.com",
+    description="Python client for DayBetter devices and services",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/THDayBetter/daybetter-python",
+    packages=find_packages(),
+    classifiers=[
+        "Development Status :: 4 - Beta",
+        "Intended Audience :: Developers",
+        "Operating System :: OS Independent",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+    ],
+    python_requires=">=3.8",
+    install_requires=["aiohttp>=3.8.0"],
+    keywords="daybetter, iot, home automation, mqtt",
+    project_urls={
+        "Bug Reports": "https://github.com/THDayBetter/daybetter-python/issues",
+        "Source": "https://github.com/THDayBetter/daybetter-python",
+    },
+)