mijiaAPI 1.3.12__tar.gz → 1.3.14__tar.gz

mijiaapi-1.3.14/PKG-INFO

@@ -0,0 +1,172 @@
+Metadata-Version: 2.3
+Name: mijiaAPI
+Version: 1.3.14
+Summary: A Python API for Xiaomi Mijia
+License: GPLv3
+Author: Do1e
+Author-email: dpj.email@qq.com
+Requires-Python: >=3.9,<4.0
+Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+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: Programming Language :: Python :: 3.13
+Requires-Dist: pillow (>=11.0.0,<12.0.0)
+Requires-Dist: qrcode (>=8.0,<9.0)
+Requires-Dist: requests (>=2.32.3,<3.0.0)
+Project-URL: Homepage, https://github.com/Do1e/mijia-api
+Project-URL: Repository, https://github.com/Do1e/mijia-api
+Description-Content-Type: text/markdown
+
+# mijiaAPI
+
+小米米家设备的API，可以使用代码直接控制米家设备。
+
+[![GitHub](https://img.shields.io/badge/GitHub-Do1e%2Fmijia--api-blue)](https://github.com/Do1e/mijia-api)
+[![PyPI](https://img.shields.io/badge/PyPI-mijiaAPI-blue)](https://pypi.org/project/mijiaAPI/)
+[![License: GPL-3.0](https://img.shields.io/badge/License-GPL--3.0-green.svg)](https://opensource.org/licenses/GPL-3.0)
+
+## 安装
+
+### 从 PyPI 安装（推荐）
+
+```bash
+pip install mijiaAPI
+```
+
+### 从源码安装
+
+```bash
+git clone https://github.com/Do1e/mijia-api.git
+cd mijia-api
+pip install .
+# Or `pip install -e .` for editable mode
+```
+
+或者使用 poetry：
+
+```bash
+poetry install
+```
+
+## 使用
+
+使用实例可以参考 `demos` 文件夹下的示例代码，以下是基本使用说明。
+
+### 登录
+
+`mijiaLogin`：登录小米账号，获取控制设备必须的 `userId`, `ssecurity`, `deviceId`, `serviceToken` 等信息。
+
+#### 登录方法：
+
+* `QRlogin() -> dict`：扫描二维码登录（推荐）
+  - 在支持 tty 的终端直接显示二维码
+  - 或在当前目录查看生成的 `qr.png` 文件
+  
+* `login(username: str, password: str) -> dict`：账号密码登录
+  - **注意：此方法大概率需要手机验证码验证，建议优先使用二维码登录**
+
+
+### API
+
+`mijiaAPI`：核心API实现，使用 `mijiaLogin` 登录后返回的信息进行初始化。
+
+#### 初始化与状态检查：
+
+* `__init__(auth_data: dict)`：初始化 API 对象
+  - `auth_data` 必须包含 `userId`, `deviceId`, `ssecurity`, `serviceToken` 四个字段
+
+* `available -> bool`：检查传入的 `auth_data` 是否有效，根据 `auth_data` 中的 `expireTime` 字段判断
+
+#### 设备与场景获取与控制：
+
+* `get_devices_list() -> list`：获取设备列表
+* `get_homes_list() -> list`：获取家庭列表（包含房间信息）
+* `get_scenes_list(home_id: str) -> list`：获取手动场景列表
+  - 在米家 App 中通过 **米家→添加→手动控制** 设置
+* `run_scene(scene_id: str) -> bool`：运行指定场景
+* `get_consumable_items(home_id: str) -> list`：获取设备的耗材信息
+* `get_devices_prop(data: list) -> list`：获取设备属性
+* `set_devices_prop(data: list) -> list`：设置设备属性
+* `run_action(data: dict) -> dict`：执行设备的特定动作
+
+设备属性和动作的相关参数（`siid`, `piid`, `aiid`）可以从 [米家产品库](https://home.miot-spec.com) 查询：
+* 访问 `https://home.miot-spec.com/spec/{model}`（`model` 在设备列表中获取）
+* 例如：[米家台灯 1S](https://home.miot-spec.com/spec/yeelink.light.lamp4)
+
+**注意**：并非所有米家产品库中列出的方法都可用，需要自行测试验证。
+
+### 设备控制封装
+
+`mijiaDevices`：基于 `mijiaAPI` 的高级封装，提供更简便的设备控制方式。
+
+#### 初始化：
+
+```python
+mijiaDevices(api: mijiaAPI, dev_info: dict = None, dev_name: str = None, did: str = None, sleep_time: float = 0.5)
+```
+
+* `api`：已初始化的 `mijiaAPI` 对象
+* `dev_info`：设备属性字典（可选）
+* `dev_name`：设备名称，用于自动查找设备（可选）
+* `did`：设备ID，便于直接通过属性名访问（可选）
+* `sleep_time`：属性操作间隔时间，单位秒（默认0.5秒）
+  - **重要**：设置属性后立即获取可能不符合预期，需设置适当延迟
+
+#### 使用方法控制：
+
+* `set(name: str, did: str, value: Union[bool, int]) -> bool`：设置设备属性
+* `get(name: str, did: str) -> Union[bool, int, float, str]`：获取设备属性
+* `run_action(name: str, did: str = None, value: Any = None, **kwargs) -> bool`：执行设备动作
+
+#### 属性样式访问：
+
+需在初始化时提供 `did` 或者使用 `dev_name` 初始化
+
+```python
+# 示例：控制台灯
+device = mijiaDevices(api, dev_name='台灯')
+device.on = True                 # 打开灯
+device.brightness = 60           # 设置亮度
+current_temp = device.color_temperature  # 获取色温
+```
+
+属性名规则：使用下划线替代连字符（如 `color-temperature` 变为 `color_temperature`）
+
+#### 示例：
+
+* 使用自然语言让小爱音箱执行：[demos/test_devices_wifispeaker.py](demos/test_devices_wifispeaker.py)
+* 通过属性直接控制台灯：[demos/test_devices_v2_light.py](demos/test_devices_v2_light.py)
+
+### 设备信息获取
+
+使用 `get_device_info()` 函数可从米家规格平台在线获取设备属性字典：
+
+```python
+from mijiaAPI import get_device_info
+
+# 获取设备规格信息
+device_info = get_device_info('yeelink.light.lamp4')  # 米家台灯 1S 的 model
+```
+
+详细示例：[demos/test_get_device_info.py](demos/test_get_device_info.py)
+
+
+## 致谢
+
+* [janzlan/mijia-api](https://gitee.com/janzlan/mijia-api/tree/master)
+
+## 开源许可
+
+本项目采用 [GPL-3.0](LICENSE) 开源许可证。
+
+## 免责声明
+
+* 本项目仅供学习交流使用，不得用于商业用途，如有侵权请联系删除
+* 用户使用本项目所产生的任何后果，需自行承担风险
+* 开发者不对使用本项目产生的任何直接或间接损失负责
+

mijiaapi-1.3.14/README.md

@@ -0,0 +1,147 @@
+# mijiaAPI
+
+小米米家设备的API，可以使用代码直接控制米家设备。
+
+[![GitHub](https://img.shields.io/badge/GitHub-Do1e%2Fmijia--api-blue)](https://github.com/Do1e/mijia-api)
+[![PyPI](https://img.shields.io/badge/PyPI-mijiaAPI-blue)](https://pypi.org/project/mijiaAPI/)
+[![License: GPL-3.0](https://img.shields.io/badge/License-GPL--3.0-green.svg)](https://opensource.org/licenses/GPL-3.0)
+
+## 安装
+
+### 从 PyPI 安装（推荐）
+
+```bash
+pip install mijiaAPI
+```
+
+### 从源码安装
+
+```bash
+git clone https://github.com/Do1e/mijia-api.git
+cd mijia-api
+pip install .
+# Or `pip install -e .` for editable mode
+```
+
+或者使用 poetry：
+
+```bash
+poetry install
+```
+
+## 使用
+
+使用实例可以参考 `demos` 文件夹下的示例代码，以下是基本使用说明。
+
+### 登录
+
+`mijiaLogin`：登录小米账号，获取控制设备必须的 `userId`, `ssecurity`, `deviceId`, `serviceToken` 等信息。
+
+#### 登录方法：
+
+* `QRlogin() -> dict`：扫描二维码登录（推荐）
+  - 在支持 tty 的终端直接显示二维码
+  - 或在当前目录查看生成的 `qr.png` 文件
+  
+* `login(username: str, password: str) -> dict`：账号密码登录
+  - **注意：此方法大概率需要手机验证码验证，建议优先使用二维码登录**
+
+
+### API
+
+`mijiaAPI`：核心API实现，使用 `mijiaLogin` 登录后返回的信息进行初始化。
+
+#### 初始化与状态检查：
+
+* `__init__(auth_data: dict)`：初始化 API 对象
+  - `auth_data` 必须包含 `userId`, `deviceId`, `ssecurity`, `serviceToken` 四个字段
+
+* `available -> bool`：检查传入的 `auth_data` 是否有效，根据 `auth_data` 中的 `expireTime` 字段判断
+
+#### 设备与场景获取与控制：
+
+* `get_devices_list() -> list`：获取设备列表
+* `get_homes_list() -> list`：获取家庭列表（包含房间信息）
+* `get_scenes_list(home_id: str) -> list`：获取手动场景列表
+  - 在米家 App 中通过 **米家→添加→手动控制** 设置
+* `run_scene(scene_id: str) -> bool`：运行指定场景
+* `get_consumable_items(home_id: str) -> list`：获取设备的耗材信息
+* `get_devices_prop(data: list) -> list`：获取设备属性
+* `set_devices_prop(data: list) -> list`：设置设备属性
+* `run_action(data: dict) -> dict`：执行设备的特定动作
+
+设备属性和动作的相关参数（`siid`, `piid`, `aiid`）可以从 [米家产品库](https://home.miot-spec.com) 查询：
+* 访问 `https://home.miot-spec.com/spec/{model}`（`model` 在设备列表中获取）
+* 例如：[米家台灯 1S](https://home.miot-spec.com/spec/yeelink.light.lamp4)
+
+**注意**：并非所有米家产品库中列出的方法都可用，需要自行测试验证。
+
+### 设备控制封装
+
+`mijiaDevices`：基于 `mijiaAPI` 的高级封装，提供更简便的设备控制方式。
+
+#### 初始化：
+
+```python
+mijiaDevices(api: mijiaAPI, dev_info: dict = None, dev_name: str = None, did: str = None, sleep_time: float = 0.5)
+```
+
+* `api`：已初始化的 `mijiaAPI` 对象
+* `dev_info`：设备属性字典（可选）
+* `dev_name`：设备名称，用于自动查找设备（可选）
+* `did`：设备ID，便于直接通过属性名访问（可选）
+* `sleep_time`：属性操作间隔时间，单位秒（默认0.5秒）
+  - **重要**：设置属性后立即获取可能不符合预期，需设置适当延迟
+
+#### 使用方法控制：
+
+* `set(name: str, did: str, value: Union[bool, int]) -> bool`：设置设备属性
+* `get(name: str, did: str) -> Union[bool, int, float, str]`：获取设备属性
+* `run_action(name: str, did: str = None, value: Any = None, **kwargs) -> bool`：执行设备动作
+
+#### 属性样式访问：
+
+需在初始化时提供 `did` 或者使用 `dev_name` 初始化
+
+```python
+# 示例：控制台灯
+device = mijiaDevices(api, dev_name='台灯')
+device.on = True                 # 打开灯
+device.brightness = 60           # 设置亮度
+current_temp = device.color_temperature  # 获取色温
+```
+
+属性名规则：使用下划线替代连字符（如 `color-temperature` 变为 `color_temperature`）
+
+#### 示例：
+
+* 使用自然语言让小爱音箱执行：[demos/test_devices_wifispeaker.py](demos/test_devices_wifispeaker.py)
+* 通过属性直接控制台灯：[demos/test_devices_v2_light.py](demos/test_devices_v2_light.py)
+
+### 设备信息获取
+
+使用 `get_device_info()` 函数可从米家规格平台在线获取设备属性字典：
+
+```python
+from mijiaAPI import get_device_info
+
+# 获取设备规格信息
+device_info = get_device_info('yeelink.light.lamp4')  # 米家台灯 1S 的 model
+```
+
+详细示例：[demos/test_get_device_info.py](demos/test_get_device_info.py)
+
+
+## 致谢
+
+* [janzlan/mijia-api](https://gitee.com/janzlan/mijia-api/tree/master)
+
+## 开源许可
+
+本项目采用 [GPL-3.0](LICENSE) 开源许可证。
+
+## 免责声明
+
+* 本项目仅供学习交流使用，不得用于商业用途，如有侵权请联系删除
+* 用户使用本项目所产生的任何后果，需自行承担风险
+* 开发者不对使用本项目产生的任何直接或间接损失负责

{mijiaapi-1.3.12 → mijiaapi-1.3.14}/mijiaAPI/apis.py

@@ -1,4 +1,6 @@
+from datetime import datetime
 from typing import Union
+
 import requests
 import requests.cookies
 
@@ -21,6 +23,7 @@ class mijiaAPI(object):
         self.userId = auth_data['userId']
         self.ssecurity = auth_data['ssecurity']
         self.session = requests.Session()
+        self.expireTime = auth_data.get('expireTime', None)
         self.session.headers.update({
             'User-Agent': defaultUA,
             'x-xiaomi-protocal-flag-cli': 'PROTOCAL-HTTP2',
@@ -43,13 +46,12 @@ class mijiaAPI(object):
         Returns:
             bool: API可用返回True，否则返回False。
         """
-        uri = '/home/device_list'
-        data = {"getVirtualModel": False, "getHuamiDevices": 0}
-        try:
-            post_data(self.session, self.ssecurity, uri, data)
+        if self.expireTime:
+            expire_time = datetime.strptime(self.expireTime, '%Y-%m-%d %H:%M:%S')
+            if expire_time < datetime.now():
+                return False
             return True
-        except PostDataError:
-            return False
+        return False
 
     def get_devices_list(self) -> dict:
         """

{mijiaapi-1.3.12 → mijiaapi-1.3.14}/mijiaAPI/login.py

@@ -1,18 +1,20 @@
-from typing import Optional
 import hashlib
 import json
 import os
 import random
+import re
 import string
 import time
+from datetime import datetime, timedelta
+from typing import Optional
 from urllib import parse
 
-from qrcode import QRCode
 import requests
+from qrcode import QRCode
 
+from .logger import logger
 from .urls import msgURL, loginURL, qrURL, accountURL
 from .utils import defaultUA
-from .logger import logger
 
 
 class LoginError(Exception):
@@ -94,6 +96,34 @@ class mijiaLogin(object):
         }
         return data
 
+    @staticmethod
+    def extract_latest_gmt_datetime(data: dict) -> datetime:
+        """
+        提取过期时间并转换为中国时区。
+
+        Args:
+            data (dict): 用户凭证数据，包含GMT时间的键值对。
+
+        Returns:
+            datetime: 转换后的中国时区时间。
+
+        Raises:
+            LoginError: 如果没有找到GMT时间键或解析失败，抛出登录错误。
+        """
+
+        gmt_time_keys = [
+            k for k in data.keys() if
+            isinstance(k, str) and re.match(r'\d{2}-[A-Za-z]{3}-\d{4} \d{2}:\d{2}:\d{2} GMT', k)
+        ]
+
+        if not gmt_time_keys:
+            raise LoginError(-1, 'No GMT time keys found in the data')
+        parsed_times = [datetime.strptime(k, '%d-%b-%Y %H:%M:%S GMT') for k in gmt_time_keys]
+        latest_utc_time = max(parsed_times)
+        china_time = latest_utc_time + timedelta(hours=8)
+
+        return china_time
+
     def _save_auth(self) -> None:
         """
         保存认证数据到文件。
@@ -127,7 +157,8 @@ class mijiaLogin(object):
         Raises:
             LoginError: 登录失败时抛出。
         """
-        logger.warning('There is a high probability of verification code with account and password. Please try other login methods')
+        logger.warning(
+            'There is a high probability of verification code with account and password. Please try other login methods')
         data = self._get_index()
         post_data = {
             'qs': data['qs'],
@@ -148,21 +179,22 @@ class mijiaLogin(object):
             raise LoginError(-1, 'Failed to get location')
         if 'notificationUrl' in ret_data:
             raise LoginError(-1, 'Verification code required, please try other login methods')
-        auth_data = {
-            'userId': ret_data['userId'],
-            'ssecurity': ret_data['ssecurity'],
-            'deviceId': data['deviceId'],
-        }
         ret = self.session.get(ret_data['location'])
         if ret.status_code != 200:
             raise LoginError(ret.status_code, f'Failed to get location, {ret.text}')
         cookies = self.session.cookies.get_dict()
-        auth_data['serviceToken'] = cookies['serviceToken']
-        self.auth_data = auth_data
-        self.auth_data.update(self._get_account(auth_data['userId']))
+
+        self.auth_data = {
+            'userId': ret_data['userId'],
+            'ssecurity': ret_data['ssecurity'],
+            'deviceId': data['deviceId'],
+            'serviceToken': cookies['serviceToken'],
+            'expireTime': self.extract_latest_gmt_datetime(cookies).strftime('%Y-%m-%d %H:%M:%S'),
+            **self._get_account(ret_data['userId'])
+        }
 
         self._save_auth()
-        return auth_data
+        return self.auth_data
 
     @staticmethod
     def _print_qr(loginurl: str, box_size: int = 10) -> None:
@@ -232,21 +264,22 @@ class mijiaLogin(object):
         ret_data = json.loads(ret.text[11:])
         if ret_data['code'] != 0:
             raise LoginError(ret_data['code'], ret_data['desc'])
-        auth_data = {
-            'userId': ret_data['userId'],
-            'ssecurity': ret_data['ssecurity'],
-            'deviceId': data['deviceId'],
-        }
         ret = self.session.get(ret_data['location'])
         if ret.status_code != 200:
             raise LoginError(ret.status_code, f'Failed to get location, {ret.text}')
         cookies = self.session.cookies.get_dict()
-        auth_data['serviceToken'] = cookies['serviceToken']
-        self.auth_data = auth_data
-        self.auth_data.update(self._get_account(auth_data['userId']))
+
+        self.auth_data = {
+            'userId': ret_data['userId'],
+            'ssecurity': ret_data['ssecurity'],
+            'deviceId': data['deviceId'],
+            'serviceToken': cookies['serviceToken'],
+            'expireTime': self.extract_latest_gmt_datetime(cookies).strftime('%Y-%m-%d %H:%M:%S'),
+            **self._get_account(ret_data['userId'])
+        }
 
         self._save_auth()
-        return auth_data
+        return self.auth_data
 
     def __del__(self):
         """

{mijiaapi-1.3.12 → mijiaapi-1.3.14}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mijiaAPI"
-version = "1.3.12"
+version = "1.3.14"
 description = "A Python API for Xiaomi Mijia"
 readme = "README.md"
 requires-python = ">=3.9,<4.0"
@@ -12,7 +12,7 @@ dependencies = [
 
 [tool.poetry]
 name = "mijiaAPI"
-version = "1.3.12"
+version = "1.3.14"
 description = "A Python API for Xiaomi Mijia"
 authors = ["Do1e <dpj.email@qq.com>"]
 license = "GPLv3"

mijiaapi-1.3.12/PKG-INFO

@@ -1,81 +0,0 @@
-Metadata-Version: 2.3
-Name: mijiaAPI
-Version: 1.3.12
-Summary: A Python API for Xiaomi Mijia
-License: GPLv3
-Author: Do1e
-Author-email: dpj.email@qq.com
-Requires-Python: >=3.9,<4.0
-Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
-Classifier: License :: Other/Proprietary License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-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: Programming Language :: Python :: 3.13
-Requires-Dist: pillow (>=11.0.0,<12.0.0)
-Requires-Dist: qrcode (>=8.0,<9.0)
-Requires-Dist: requests (>=2.32.3,<3.0.0)
-Project-URL: Homepage, https://github.com/Do1e/mijia-api
-Project-URL: Repository, https://github.com/Do1e/mijia-api
-Description-Content-Type: text/markdown
-
-# mijiaAPI
-小米米家设备的api，可以使用代码直接控制米家设备的功能，[Github link](https://github.com/Do1e/mijia-api)，[PyPI link](https://pypi.org/project/mijiaAPI/)。
-
-## 安装
-```bash
-poetry install
-```
-或者
-```bash
-pip install mijiaAPI
-```
-
-## 使用
-使用实例可以参考`demos`文件夹下的示例代码，以下是简单的使用说明
-
-### 登录
-
-`mijiaLogin`：登录小米账号，获取控制设备必须的`userId`, `ssecurity`, `deviceId`, `serviceToken`，方法列表：
-* `login(username: str, password: str) -> dict`：账号密码登录，返回上述信息。**注意，目前这一方法大概率遇到手机验证码，请尽可能使用`QRlogin`。**
-* `QRlogin() -> dict`：扫描二维码登录，返回上述信息（会在支持tty的终端打印二维码，若打印识别可查看当前文件夹下的`qr.png`）
-
-
-### API
-
-`mijiaAPI`：API的实现，使用`mijiaLogin`登录后返回的信息进行初始化
-* `__init__(auth_data: dict)`：初始化
-* `available -> bool`：传入的`auth_data`是否有效
-* `get_devices_list() -> list`：获取设备列表
-* `get_homes_list() -> list`：获取家庭列表，家庭字典中包含房间列表
-* `get_scenes_list(home_id: str) -> list`：获取手动场景列表，在 *米家->添加->手动控制* 中设置
-* `run_scene(scene_id: str) -> bool`：运行手动场景
-* `get_consumable_items(home_id: str) -> list`：获取设备的耗材信息
-* `get_devices_prop(data: list) -> list`：获取设备的属性
-* `set_devices_prop(data: list) -> list`：设置设备的属性
-  * `data`为一个字典的列表，字典需要包含`did`, `siid`, `piid`，后面两个键可从 *https://home.miot-spec.com/spec/{model}* 中获取，其中`model`为设备的model，在设备列表中获取，如[米家台灯 1S](https://home.miot-spec.com/spec/yeelink.light.lamp4)。
-  * 网站上的方法并非全部可用，需要自行测试
-* `run_action(data: dict) -> dict`：执行设备的action
-  * `data`为一个字典，需要包含`did`, `siid`, `aiid`，获取方法同上
-
-### 针对设备的封装
-
-最简单的使用方法是直接使用自然语言调用小爱音箱，参见[demos/test_devices_wifispeaker.py](demos/test_devices_wifispeaker.py)
-
-`mijiaDevices`：使用`mijiaAPI`和设备属性字典初始化，以便更方便地调用设备属性
-* `__init__(api: mijiaAPI, dev_info: dict. did: str = None, sleep_time: float = 0.5)`：初始化，`dev_info`为设备属性，参考[demos/dev_info_example](demos/dev_info_example)，`sleep_time`为每次调用设备属性的间隔时间（注：设置属性后立刻获取属性会不符合预期，需要延迟一段时间）
-* `set(name: str, did: str, value: Union[bool, int]) -> Union[bool, int]`：设置设备属性
-* `get(name: str, did: str) -> Union[bool, int]`：获取设备属性
-* v1.2.0 新增直接通过名称设置/获取属性，需要在初始化时传入`did`，详见[demos/test_devices_v2_light.py](demos/test_devices_v2_light.py)。名称中包含`-`的属性需要替换为`_`。
-* 可以调用`get_device_info(device_model: str) -> dict`函数从[米家设备列表](https://home.miot-spec.com/)在线获取设备属性字典，详见[demos/test_get_device_info.py](demos/test_get_device_info.py)
-
-## 致谢
-* [janzlan/mijia-api](https://gitee.com/janzlan/mijia-api/tree/master)
-
-## 声明
-* 本项目仅供学习交流使用，不得用于商业用途，如有侵权请联系删除。
-* 本项目作者不对使用本项目产生的任何后果负责，请用户自行承担使用本项目的风险。
-

mijiaapi-1.3.12/README.md

@@ -1,56 +0,0 @@
-# mijiaAPI
-小米米家设备的api，可以使用代码直接控制米家设备的功能，[Github link](https://github.com/Do1e/mijia-api)，[PyPI link](https://pypi.org/project/mijiaAPI/)。
-
-## 安装
-```bash
-poetry install
-```
-或者
-```bash
-pip install mijiaAPI
-```
-
-## 使用
-使用实例可以参考`demos`文件夹下的示例代码，以下是简单的使用说明
-
-### 登录
-
-`mijiaLogin`：登录小米账号，获取控制设备必须的`userId`, `ssecurity`, `deviceId`, `serviceToken`，方法列表：
-* `login(username: str, password: str) -> dict`：账号密码登录，返回上述信息。**注意，目前这一方法大概率遇到手机验证码，请尽可能使用`QRlogin`。**
-* `QRlogin() -> dict`：扫描二维码登录，返回上述信息（会在支持tty的终端打印二维码，若打印识别可查看当前文件夹下的`qr.png`）
-
-
-### API
-
-`mijiaAPI`：API的实现，使用`mijiaLogin`登录后返回的信息进行初始化
-* `__init__(auth_data: dict)`：初始化
-* `available -> bool`：传入的`auth_data`是否有效
-* `get_devices_list() -> list`：获取设备列表
-* `get_homes_list() -> list`：获取家庭列表，家庭字典中包含房间列表
-* `get_scenes_list(home_id: str) -> list`：获取手动场景列表，在 *米家->添加->手动控制* 中设置
-* `run_scene(scene_id: str) -> bool`：运行手动场景
-* `get_consumable_items(home_id: str) -> list`：获取设备的耗材信息
-* `get_devices_prop(data: list) -> list`：获取设备的属性
-* `set_devices_prop(data: list) -> list`：设置设备的属性
-  * `data`为一个字典的列表，字典需要包含`did`, `siid`, `piid`，后面两个键可从 *https://home.miot-spec.com/spec/{model}* 中获取，其中`model`为设备的model，在设备列表中获取，如[米家台灯 1S](https://home.miot-spec.com/spec/yeelink.light.lamp4)。
-  * 网站上的方法并非全部可用，需要自行测试
-* `run_action(data: dict) -> dict`：执行设备的action
-  * `data`为一个字典，需要包含`did`, `siid`, `aiid`，获取方法同上
-
-### 针对设备的封装
-
-最简单的使用方法是直接使用自然语言调用小爱音箱，参见[demos/test_devices_wifispeaker.py](demos/test_devices_wifispeaker.py)
-
-`mijiaDevices`：使用`mijiaAPI`和设备属性字典初始化，以便更方便地调用设备属性
-* `__init__(api: mijiaAPI, dev_info: dict. did: str = None, sleep_time: float = 0.5)`：初始化，`dev_info`为设备属性，参考[demos/dev_info_example](demos/dev_info_example)，`sleep_time`为每次调用设备属性的间隔时间（注：设置属性后立刻获取属性会不符合预期，需要延迟一段时间）
-* `set(name: str, did: str, value: Union[bool, int]) -> Union[bool, int]`：设置设备属性
-* `get(name: str, did: str) -> Union[bool, int]`：获取设备属性
-* v1.2.0 新增直接通过名称设置/获取属性，需要在初始化时传入`did`，详见[demos/test_devices_v2_light.py](demos/test_devices_v2_light.py)。名称中包含`-`的属性需要替换为`_`。
-* 可以调用`get_device_info(device_model: str) -> dict`函数从[米家设备列表](https://home.miot-spec.com/)在线获取设备属性字典，详见[demos/test_get_device_info.py](demos/test_get_device_info.py)
-
-## 致谢
-* [janzlan/mijia-api](https://gitee.com/janzlan/mijia-api/tree/master)
-
-## 声明
-* 本项目仅供学习交流使用，不得用于商业用途，如有侵权请联系删除。
-* 本项目作者不对使用本项目产生的任何后果负责，请用户自行承担使用本项目的风险。

mijiaapi-1.3.12/mijiaAPI/__main__.py

@@ -1,27 +0,0 @@
-import argparse
-import sys
-
-from .login import mijiaLogin
-
-def parse_args(args):
-    parser = argparse.ArgumentParser(description="Mijia API CLI")
-    parser.add_argument(
-        '-i', '--login',
-        action='store_true',
-        help="Login by QR code and save cookies to file",
-    )
-    parser.add_argument(
-        '-c', '--cookie_path',
-        type=str,
-        help="Path to the cookies file",
-    )
-    return parser.parse_args(args)
-
-def main(args):
-    args = parse_args(args)
-    if args.login:
-        api = mijiaLogin(save_path=args.cookie_path)
-        auth = api.QRlogin()
-
-if __name__ == "__main__":
-    main(sys.argv[1:])