daybetter-services-python 1.0.6__tar.gz → 1.0.8__tar.gz

daybetter_services_python-1.0.8/PKG-INFO

@@ -0,0 +1,127 @@
+Metadata-Version: 2.4
+Name: daybetter-services-python
+Version: 1.0.8
+Summary: Python client for DayBetter devices and services
+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
+Classifier: Typing :: Typed
+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: license-file
+
+# DayBetter Services Python Client
+
+[![PyPI](https://img.shields.io/pypi/v/daybetter-services-python.svg)](https://pypi.org/project/daybetter-services-python/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/daybetter-services-python.svg)](https://pypi.org/project/daybetter-services-python/)
+[![License](https://img.shields.io/pypi/l/daybetter-services-python.svg)](LICENSE)
+
+Asynchronous client library used by the [Home Assistant DayBetter Services integration](https://github.com/home-assistant/core/pull/154677).  
+It handles authentication, device discovery, status polling, PID metadata and device control against the DayBetter cloud API.
+
+## Features
+
+- Fully async `DayBetterClient` with context-manager support
+- Automatic environment selection (test/prod) based on `hass_code`
+- Convenience helpers for common API endpoints (devices, statuses, MQTT config)
+- Sensor-focused workflow `fetch_sensor_data()` that merges devices, statuses and PID filters
+- Type hints + `py.typed` for first-class editor / mypy support
+- Published on PyPI for Home Assistant and other integrations
+
+## Installation
+
+```bash
+pip install daybetter-services-python
+```
+
+## Quick Start
+
+```python
+import asyncio
+from daybetter_python import DayBetterClient
+
+async def main() -> None:
+    async with DayBetterClient(token="YOUR_TOKEN", hass_code="db-xxxx") as client:
+        # Fetch merged sensor payloads (used by Home Assistant)
+        sensors = await client.fetch_sensor_data()
+        for item in sensors:
+            print(item["deviceName"], item.get("temp"), item.get("humi"))
+
+        # Control a device (brightness example)
+        await client.control_device(
+            device_name="device_001",
+            action=True,
+            brightness=180,
+        )
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## Home Assistant Integration
+
+The official integration PR can be followed here: [home-assistant/core#154677](https://github.com/home-assistant/core/pull/154677).  
+The integration imports this library and simply calls `client.fetch_sensor_data()` inside a data coordinator, so all business logic lives in this package.
+
+See `docs/homeassistant.md` for:
+- Installation instructions (pip, custom component)
+- How to obtain the DayBetter token and `hass_code`
+- Sample `configuration.yaml` snippets
+- Known limitations and future roadmap
+
+## Development
+
+```bash
+git clone https://github.com/THDayBetter/daybetter-services-python.git
+cd daybetter-services-python
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -e .[dev]
+
+# Quality checks
+flake8 daybetter_python
+mypy daybetter_python
+pytest
+```
+
+Pull requests are welcome! Please open an issue if you encounter problems with the DayBetter cloud API.
+
+## Release Process
+
+1. Update `pyproject.toml` and `daybetter_python/__init__.py` with the new version.
+2. Document changes in `CHANGELOG.md`.
+3. Build and upload:
+   ```bash
+   rm -rf dist build *.egg-info
+   python -m build
+   twine check dist/*
+   twine upload dist/*
+   ```
+4. Create a Git tag (e.g., `git tag v1.0.7 && git push origin v1.0.7`).
+
+## License
+
+This project is licensed under the [MIT License](LICENSE).

daybetter_services_python-1.0.8/README.md

@@ -0,0 +1,92 @@
+# DayBetter Services Python Client
+
+[![PyPI](https://img.shields.io/pypi/v/daybetter-services-python.svg)](https://pypi.org/project/daybetter-services-python/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/daybetter-services-python.svg)](https://pypi.org/project/daybetter-services-python/)
+[![License](https://img.shields.io/pypi/l/daybetter-services-python.svg)](LICENSE)
+
+Asynchronous client library used by the [Home Assistant DayBetter Services integration](https://github.com/home-assistant/core/pull/154677).  
+It handles authentication, device discovery, status polling, PID metadata and device control against the DayBetter cloud API.
+
+## Features
+
+- Fully async `DayBetterClient` with context-manager support
+- Automatic environment selection (test/prod) based on `hass_code`
+- Convenience helpers for common API endpoints (devices, statuses, MQTT config)
+- Sensor-focused workflow `fetch_sensor_data()` that merges devices, statuses and PID filters
+- Type hints + `py.typed` for first-class editor / mypy support
+- Published on PyPI for Home Assistant and other integrations
+
+## Installation
+
+```bash
+pip install daybetter-services-python
+```
+
+## Quick Start
+
+```python
+import asyncio
+from daybetter_python import DayBetterClient
+
+async def main() -> None:
+    async with DayBetterClient(token="YOUR_TOKEN", hass_code="db-xxxx") as client:
+        # Fetch merged sensor payloads (used by Home Assistant)
+        sensors = await client.fetch_sensor_data()
+        for item in sensors:
+            print(item["deviceName"], item.get("temp"), item.get("humi"))
+
+        # Control a device (brightness example)
+        await client.control_device(
+            device_name="device_001",
+            action=True,
+            brightness=180,
+        )
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## Home Assistant Integration
+
+The official integration PR can be followed here: [home-assistant/core#154677](https://github.com/home-assistant/core/pull/154677).  
+The integration imports this library and simply calls `client.fetch_sensor_data()` inside a data coordinator, so all business logic lives in this package.
+
+See `docs/homeassistant.md` for:
+- Installation instructions (pip, custom component)
+- How to obtain the DayBetter token and `hass_code`
+- Sample `configuration.yaml` snippets
+- Known limitations and future roadmap
+
+## Development
+
+```bash
+git clone https://github.com/THDayBetter/daybetter-services-python.git
+cd daybetter-services-python
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -e .[dev]
+
+# Quality checks
+flake8 daybetter_python
+mypy daybetter_python
+pytest
+```
+
+Pull requests are welcome! Please open an issue if you encounter problems with the DayBetter cloud API.
+
+## Release Process
+
+1. Update `pyproject.toml` and `daybetter_python/__init__.py` with the new version.
+2. Document changes in `CHANGELOG.md`.
+3. Build and upload:
+   ```bash
+   rm -rf dist build *.egg-info
+   python -m build
+   twine check dist/*
+   twine upload dist/*
+   ```
+4. Create a Git tag (e.g., `git tag v1.0.7 && git push origin v1.0.7`).
+
+## License
+
+This project is licensed under the [MIT License](LICENSE).

{daybetter_services_python-1.0.6 → daybetter_services_python-1.0.8}/daybetter_python/__init__.py

@@ -3,5 +3,5 @@
 from .client import DayBetterClient
 from .exceptions import DayBetterError, AuthenticationError, APIError
 
-__version__ = "1.0.6"
+__version__ = "1.0.8"
 __all__ = ["DayBetterClient", "DayBetterError", "AuthenticationError", "APIError"]

{daybetter_services_python-1.0.6 → daybetter_services_python-1.0.8}/daybetter_python/client.py

@@ -1,83 +1,88 @@
 """DayBetter API client."""
 
-import aiohttp
 import logging
-from typing import Any, Dict, List, Optional, Tuple
+from typing import Any, Dict, List, Optional, Tuple, Type
+
+import aiohttp
 
-from .exceptions import DayBetterError, AuthenticationError, APIError
+from .exceptions import APIError, AuthenticationError, DayBetterError
 
 _LOGGER = logging.getLogger(__name__)
 
 
 class DayBetterClient:
     """DayBetter API client."""
-    
-    # 测试环境URL
+
     TEST_BASE_URL = "https://cloud.v2.dbiot.link/daybetter/hass/api/v1.0/"
-    # 正式环境URL
     PROD_BASE_URL = "https://a.dbiot.org/daybetter/hass/api/v1.0/"
-    
+
     def __init__(
-        self, 
-        token: str, 
+        self,
+        token: str,
         base_url: Optional[str] = None,
-        hass_code: Optional[str] = None
+        hass_code: Optional[str] = None,
+        session: Optional[aiohttp.ClientSession] = None,
     ):
         """Initialize the client.
-        
+
         Args:
             token: Authentication token
-            base_url: Base URL for the API (optional, will be determined by hass_code if not provided)
-            hass_code: Home Assistant integration code (optional, if provided and starts with "db-", 
-                      will use production environment)
+            base_url: Base URL for the API (optional, determined by hass_code if not provided)
+            hass_code: Home Assistant integration code (optional, if provided and starts
+                with "db-", will use production environment)
+            session: Optional aiohttp ClientSession. If provided, the client will use it
+                and will not close it when close() is called (caller owns the session).
         """
         self.token = token
-        
-        # 根据 hass_code 或 base_url 确定使用的环境
+
         if base_url is not None:
-            # 如果明确指定了 base_url，使用指定的 URL
             self.base_url = base_url
         elif hass_code is not None and hass_code.startswith("db-"):
-            # 如果 hass_code 以 "db-" 开头，使用正式环境
             self.base_url = self.PROD_BASE_URL
             _LOGGER.debug("Using production environment based on hass_code")
         else:
-            # 默认使用测试环境
             self.base_url = self.TEST_BASE_URL
             _LOGGER.debug("Using test environment")
-        
-        self._session: Optional[aiohttp.ClientSession] = None
+
+        self._session: Optional[aiohttp.ClientSession] = session
+        self._own_session: bool = session is None
         self._auth_valid = True
         self._devices: List[Dict[str, Any]] = []
         self._pids: Dict[str, Any] = {}
-    
+
     async def __aenter__(self):
         """Async context manager entry."""
-        self._session = aiohttp.ClientSession()
+        if self._session is None:
+            self._session = aiohttp.ClientSession()
         return self
-    
-    async def __aexit__(self, exc_type, exc_val, exc_tb):
+
+    async def __aexit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc_val: Optional[BaseException],
+        exc_tb: Optional[Any],
+    ) -> None:
         """Async context manager exit."""
-        if self._session:
+        if self._own_session and self._session is not None:
             await self._session.close()
             self._session = None
-    
+
     def _get_session(self) -> aiohttp.ClientSession:
         """Get or create aiohttp session."""
-        if not self._session:
+        if self._session is None:
             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
@@ -86,7 +91,7 @@ class DayBetterClient:
             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()
@@ -108,13 +113,13 @@ class DayBetterClient:
         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
@@ -123,7 +128,7 @@ class DayBetterClient:
             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()
@@ -143,7 +148,7 @@ class DayBetterClient:
         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,
@@ -153,17 +158,17 @@ class DayBetterClient:
         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
@@ -171,10 +176,8 @@ class DayBetterClient:
         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,
@@ -193,18 +196,17 @@ class DayBetterClient:
             }
         elif brightness is not None:
             payload = {
-                "deviceName": device_name, 
-                "type": 2, 
+                "deviceName": device_name,
+                "type": 2,
                 "brightness": brightness
             }
         else:
-            # Type 1 control switch is used by default
             payload = {
-                "deviceName": device_name, 
-                "type": 1, 
+                "deviceName": device_name,
+                "type": 1,
                 "on": action
             }
-        
+
         try:
             async with session.post(url, headers=headers, json=payload) as resp:
                 if resp.status == 200:
@@ -217,7 +219,7 @@ class DayBetterClient:
                 else:
                     error_text = await resp.text()
                     _LOGGER.error(
-                        "Failed to control device %s: HTTP %d - %s", 
+                        "Failed to control device %s: HTTP %d - %s",
                         device_name, resp.status, error_text
                     )
                     raise APIError(f"API error {resp.status}: {error_text}")
@@ -231,13 +233,13 @@ class DayBetterClient:
                 "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
@@ -246,11 +248,11 @@ class DayBetterClient:
         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)
@@ -270,10 +272,10 @@ class DayBetterClient:
         except Exception as e:
             _LOGGER.exception("Exception while fetching MQTT config: %s", e)
             raise DayBetterError(f"Unexpected error: {e}")
-    
+
     async def fetch_device_statuses(self) -> List[Dict[str, Any]]:
         """Fetch statuses for all devices.
-        
+
         Returns:
             List of device status dictionaries. Example item:
             {
@@ -284,7 +286,7 @@ class DayBetterClient:
                 "humi": int,
                 "bettery": int
             }
-        
+
         Raises:
             AuthenticationError: If authentication fails
             APIError: If API request fails
@@ -293,12 +295,11 @@ class DayBetterClient:
             session = self._get_session()
             url = f"{self.base_url}hass/status"
             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
-                    # API expected to return { "data": [...] }
                     return data.get("data", [])
                 elif resp.status == 401:
                     _LOGGER.error("Authentication failed - token may be expired")
@@ -314,21 +315,19 @@ class DayBetterClient:
         except Exception as e:
             _LOGGER.exception("Exception while fetching device statuses: %s", e)
             raise DayBetterError(f"Unexpected error: {e}")
-    
+
     async def integrate(self, hass_code: str) -> Dict[str, Any]:
         """Integrate with Home Assistant using hassCode.
-        
+
         Args:
             hass_code: Home Assistant integration code from APP
-            
+
         Returns:
             Integration result dictionary
-            
+
         Raises:
             APIError: If API request fails
         """
-        # 根据 hass_code 动态更新 base_url（如果之前没有明确指定）
-        # 如果 hass_code 以 "db-" 开头，切换到正式环境
         if hass_code.startswith("db-") and self.base_url != self.PROD_BASE_URL:
             old_url = self.base_url
             self.base_url = self.PROD_BASE_URL
@@ -337,19 +336,18 @@ class DayBetterClient:
                 "URL changed from %s to %s", old_url, self.base_url
             )
         elif not hass_code.startswith("db-") and self.base_url != self.TEST_BASE_URL:
-            # 如果 hass_code 不以 "db-" 开头，且当前不是测试环境，切换到测试环境
             old_url = self.base_url
             self.base_url = self.TEST_BASE_URL
             _LOGGER.info(
                 "Switching to test environment based on hass_code. "
                 "URL changed from %s to %s", old_url, self.base_url
             )
-        
+
         try:
             session = self._get_session()
             url = f"{self.base_url}hass/integrate"
             payload = {"hassCode": hass_code}
-            
+
             async with session.post(url, json=payload) as resp:
                 if resp.status == 200:
                     data = await resp.json()
@@ -365,23 +363,23 @@ class DayBetterClient:
         except Exception as e:
             _LOGGER.exception("Exception while integrating: %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
-    
+
     def filter_sensor_devices(
         self,
         devices: List[Dict[str, Any]],
         pids: Dict[str, Any],
     ) -> List[Dict[str, Any]]:
         """Filter devices to only include sensors based on PID.
-        
+
         Args:
             devices: List of all devices
             pids: Dictionary containing device type PIDs
-            
+
         Returns:
             List of sensor devices only
         """
@@ -396,18 +394,18 @@ class DayBetterClient:
             for device in devices
             if device.get("deviceMoldPid", "") in sensor_pids
         ]
-    
+
     def merge_device_status(
         self,
         devices: List[Dict[str, Any]],
         statuses: List[Dict[str, Any]],
     ) -> List[Dict[str, Any]]:
         """Merge device info with status info.
-        
+
         Args:
             devices: List of device info dictionaries
             statuses: List of device status dictionaries
-            
+
         Returns:
             List of merged device dictionaries
         """
@@ -424,38 +422,34 @@ class DayBetterClient:
             merged.append(merged_device)
 
         return merged
-    
+
     async def fetch_sensor_data(self) -> List[Dict[str, Any]]:
         """Fetch and process sensor data in one call.
-        
+
         This method fetches device statuses, devices list, and PIDs,
         filters for sensor devices, and merges the data.
-        
+
         Returns:
             List of sensor devices with merged status data
-            
+
         Raises:
             AuthenticationError: If authentication fails
             APIError: If API request fails
         """
-        # Fetch current statuses
         statuses = await self.fetch_device_statuses()
-        
-        # Fetch devices and PIDs if not cached
+
         if not self._devices or not self._pids:
             self._devices = await self.fetch_devices()
             self._pids = await self.fetch_pids()
-        
-        # Filter to sensor devices only
+
         sensor_devices = self.filter_sensor_devices(self._devices, self._pids)
-        
-        # Merge with current status
+
         merged = self.merge_device_status(sensor_devices, statuses)
         _LOGGER.debug("Fetched %d sensor devices", len(merged))
         return merged
-    
-    async def close(self):
-        """Close the client session."""
-        if self._session:
+
+    async def close(self) -> None:
+        """Close the client session if this client created it."""
+        if self._own_session and self._session is not None:
             await self._session.close()
             self._session = None

daybetter_services_python-1.0.8/daybetter_python/exceptions.py

@@ -0,0 +1,38 @@
+"""DayBetter client exceptions."""
+
+
+class DayBetterError(Exception):
+    """Base exception for DayBetter client."""
+
+    def __init__(self, message: str) -> None:
+        """Initialize the exception.
+
+        Args:
+            message: Error message
+        """
+        super().__init__(message)
+        self.message = message
+
+
+class AuthenticationError(DayBetterError):
+    """Authentication failed."""
+
+    def __init__(self, message: str = "Authentication failed") -> None:
+        """Initialize the authentication error.
+
+        Args:
+            message: Error message
+        """
+        super().__init__(message)
+
+
+class APIError(DayBetterError):
+    """API request failed."""
+
+    def __init__(self, message: str) -> None:
+        """Initialize the API error.
+
+        Args:
+            message: Error message
+        """
+        super().__init__(message)

daybetter_services_python-1.0.8/daybetter_services_python.egg-info/PKG-INFO

@@ -0,0 +1,127 @@
+Metadata-Version: 2.4
+Name: daybetter-services-python
+Version: 1.0.8
+Summary: Python client for DayBetter devices and services
+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
+Classifier: Typing :: Typed
+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: license-file
+
+# DayBetter Services Python Client
+
+[![PyPI](https://img.shields.io/pypi/v/daybetter-services-python.svg)](https://pypi.org/project/daybetter-services-python/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/daybetter-services-python.svg)](https://pypi.org/project/daybetter-services-python/)
+[![License](https://img.shields.io/pypi/l/daybetter-services-python.svg)](LICENSE)
+
+Asynchronous client library used by the [Home Assistant DayBetter Services integration](https://github.com/home-assistant/core/pull/154677).  
+It handles authentication, device discovery, status polling, PID metadata and device control against the DayBetter cloud API.
+
+## Features
+
+- Fully async `DayBetterClient` with context-manager support
+- Automatic environment selection (test/prod) based on `hass_code`
+- Convenience helpers for common API endpoints (devices, statuses, MQTT config)
+- Sensor-focused workflow `fetch_sensor_data()` that merges devices, statuses and PID filters
+- Type hints + `py.typed` for first-class editor / mypy support
+- Published on PyPI for Home Assistant and other integrations
+
+## Installation
+
+```bash
+pip install daybetter-services-python
+```
+
+## Quick Start
+
+```python
+import asyncio
+from daybetter_python import DayBetterClient
+
+async def main() -> None:
+    async with DayBetterClient(token="YOUR_TOKEN", hass_code="db-xxxx") as client:
+        # Fetch merged sensor payloads (used by Home Assistant)
+        sensors = await client.fetch_sensor_data()
+        for item in sensors:
+            print(item["deviceName"], item.get("temp"), item.get("humi"))
+
+        # Control a device (brightness example)
+        await client.control_device(
+            device_name="device_001",
+            action=True,
+            brightness=180,
+        )
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## Home Assistant Integration
+
+The official integration PR can be followed here: [home-assistant/core#154677](https://github.com/home-assistant/core/pull/154677).  
+The integration imports this library and simply calls `client.fetch_sensor_data()` inside a data coordinator, so all business logic lives in this package.
+
+See `docs/homeassistant.md` for:
+- Installation instructions (pip, custom component)
+- How to obtain the DayBetter token and `hass_code`
+- Sample `configuration.yaml` snippets
+- Known limitations and future roadmap
+
+## Development
+
+```bash
+git clone https://github.com/THDayBetter/daybetter-services-python.git
+cd daybetter-services-python
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -e .[dev]
+
+# Quality checks
+flake8 daybetter_python
+mypy daybetter_python
+pytest
+```
+
+Pull requests are welcome! Please open an issue if you encounter problems with the DayBetter cloud API.
+
+## Release Process
+
+1. Update `pyproject.toml` and `daybetter_python/__init__.py` with the new version.
+2. Document changes in `CHANGELOG.md`.
+3. Build and upload:
+   ```bash
+   rm -rf dist build *.egg-info
+   python -m build
+   twine check dist/*
+   twine upload dist/*
+   ```
+4. Create a Git tag (e.g., `git tag v1.0.7 && git push origin v1.0.7`).
+
+## License
+
+This project is licensed under the [MIT License](LICENSE).

{daybetter_services_python-1.0.6 → daybetter_services_python-1.0.8}/daybetter_services_python.egg-info/SOURCES.txt

@@ -1,12 +1,13 @@
 LICENSE
 README.md
 pyproject.toml
-setup.py
 daybetter_python/__init__.py
 daybetter_python/client.py
 daybetter_python/exceptions.py
+daybetter_python/py.typed
 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.egg-info/top_level.txt
+tests/test_placeholder.py

{daybetter_services_python-1.0.6 → daybetter_services_python-1.0.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "daybetter-services-python"
-version = "1.0.6"
+version = "1.0.8"
 description = "Python client for DayBetter devices and services"
 readme = "README.md"
 license = "MIT"
@@ -25,6 +25,7 @@ classifiers = [
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Typing :: Typed",
 ]
 requires-python = ">=3.8"
 dependencies = [
@@ -55,3 +56,10 @@ target-version = ['py38']
 [tool.isort]
 profile = "black"
 line_length = 88
+
+[tool.flake8]
+max-line-length = 100
+extend-ignore = ["W503"]
+
+[tool.setuptools.package-data]
+daybetter_python = ["py.typed"]

daybetter_services_python-1.0.8/tests/test_placeholder.py

@@ -0,0 +1,7 @@
+from daybetter_python import DayBetterClient
+
+
+def test_client_attributes() -> None:
+    client = DayBetterClient(token="abc123")
+    assert client.token == "abc123"
+

daybetter_services_python-1.0.6/PKG-INFO

@@ -1,98 +0,0 @@
-Metadata-Version: 2.4
-Name: daybetter-services-python
-Version: 1.0.6
-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.6/README.md

@@ -1,59 +0,0 @@
-# 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.6/daybetter_python/exceptions.py

@@ -1,13 +0,0 @@
-"""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.6/daybetter_services_python.egg-info/PKG-INFO

@@ -1,98 +0,0 @@
-Metadata-Version: 2.4
-Name: daybetter-services-python
-Version: 1.0.6
-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.6/setup.py

@@ -1,34 +0,0 @@
-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.6",
-    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",
-    },
-)