mijiaAPI 3.0.1__tar.gz → 3.0.3__tar.gz

{mijiaapi-3.0.1 → mijiaapi-3.0.3}/CHANGELOG.md

@@ -2,14 +2,26 @@
 
 本文档记录了项目的v1.3.7以来的重要变更。
 
-## [3.0.1](https://github.com/Do1e/mijia-api/compare/v3.0.0...v3.0.1) - 2025-12.09
+## [3.0.3](https://github.com/Do1e/mijia-api/compare/v3.0.2...v3.0.3) - 2026-01-02
+### new feature
+* 新增 `MIJIA_LOG_LEVEL` 环境变量支持，用于配置 CLI 日志级别
+### bugfix
+* 修复错误代码 "-10020" 描述中的错误拼写
+
+## [3.0.2](https://github.com/Do1e/mijia-api/compare/v3.0.1...v3.0.2) - 2026-01-01
+### new feature
+* 为`available`属性添加了缓存机制，减少频繁调用带来的性能损耗
+### chore
+* 日志信息显示毫秒
+
+## [3.0.1](https://github.com/Do1e/mijia-api/compare/v3.0.0...v3.0.1) - 2025-12-09
 ### new feature
 * 新增 API `mijiaAPI.get_shared_devices_list()`，用于获取共享设备列表
 ### bugfix
 * 修复了 alpine 下 `locale` 无法正常获取，默认使用 `zh_CN` 解决，如果需要在 alpine 下使用其他位置，请自行设置环境变量 `LC_ALL` 和 `LANG`。
 * 修复了共享家庭中无权限的问题，确保传递正确的 `owner_id`。
 
-## [3.0.0](https://github.com/Do1e/mijia-api/compare/v2.0.2...v3.0.0) - 2025-11.28
+## [3.0.0](https://github.com/Do1e/mijia-api/compare/v2.0.2...v3.0.0) - 2025-11-28
 ### new feature
 * 使用最新的米家API接口，从 https://api.io.mi.com/app 切换到 https://api.mijia.tech/app
 * `mijiaAPI` 类的初始化参数变更，请传递用于保存认证数据的路径 `auth_data_path` 而不是认证数据

{mijiaapi-3.0.1/mijiaAPI.egg-info → mijiaapi-3.0.3}/PKG-INFO

@@ -1,13 +1,12 @@
 Metadata-Version: 2.4
 Name: mijiaAPI
-Version: 3.0.1
+Version: 3.0.3
 Summary: A Python API for Xiaomi Mijia
 Author-email: Do1e <i@do1e.cn>
-License: GPL-3.0-or-later
+License-Expression: GPL-3.0-or-later
 Project-URL: Homepage, https://github.com/Do1e/mijia-api
 Project-URL: Repository, https://github.com/Do1e/mijia-api
 Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
 Classifier: Operating System :: OS Independent
 Requires-Python: <4.0,>=3.9
 Description-Content-Type: text/markdown
@@ -342,6 +341,25 @@ except APIError as e:
 mijiaAPI --help
 ```
 
+#### 环境变量
+
+支持以下环境变量来配置 CLI 的行为：
+
+| 环境变量 | 默认值 | 说明 |
+|---------|--------|------|
+| `MIJIA_LOG_LEVEL` | `INFO` | 日志级别，可选值：`DEBUG`, `INFO`, `WARNING`, `ERROR`, `CRITICAL` |
+
+##### 示例
+
+```bash
+# 设置为 DEBUG 级别查看详细日志
+export MIJIA_LOG_LEVEL=DEBUG
+mijiaAPI --list_devices
+
+# 或直接在命令前指定
+MIJIA_LOG_LEVEL=WARNING mijiaAPI get --dev_name "卧室台灯" --prop_name "brightness"
+```
+
 完整的命令行参数说明：
 
 ```
@@ -556,6 +574,9 @@ api.login()
 
 本项目采用 [GPL-3.0](LICENSE) 开源许可证。
 
+**请注意：GPL-3.0 是具有“强传染性”的开源许可证。**  
+如果您在您的项目中使用、修改或分发本项目的代码（包括作为库依赖），您的整个项目也**必须**以 GPL-3.0 或兼容许可证开源发布。
+
 ## 免责声明
 
 * 本项目仅供学习交流使用，不得用于商业用途，如有侵权请联系删除

mijiaapi-3.0.1/PKG-INFO → mijiaapi-3.0.3/README.md

@@ -1,24 +1,3 @@
-Metadata-Version: 2.4
-Name: mijiaAPI
-Version: 3.0.1
-Summary: A Python API for Xiaomi Mijia
-Author-email: Do1e <i@do1e.cn>
-License: GPL-3.0-or-later
-Project-URL: Homepage, https://github.com/Do1e/mijia-api
-Project-URL: Repository, https://github.com/Do1e/mijia-api
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
-Classifier: Operating System :: OS Independent
-Requires-Python: <4.0,>=3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: pillow>=11.3.0
-Requires-Dist: pycryptodome>=3.23.0
-Requires-Dist: qrcode>=8.2
-Requires-Dist: requests>=2.32.5
-Requires-Dist: tzlocal>=5.3.1
-Dynamic: license-file
-
 # mijiaAPI
 
 小米米家设备的API，可以使用代码直接控制米家设备。
@@ -342,6 +321,25 @@ except APIError as e:
 mijiaAPI --help
 ```
 
+#### 环境变量
+
+支持以下环境变量来配置 CLI 的行为：
+
+| 环境变量 | 默认值 | 说明 |
+|---------|--------|------|
+| `MIJIA_LOG_LEVEL` | `INFO` | 日志级别，可选值：`DEBUG`, `INFO`, `WARNING`, `ERROR`, `CRITICAL` |
+
+##### 示例
+
+```bash
+# 设置为 DEBUG 级别查看详细日志
+export MIJIA_LOG_LEVEL=DEBUG
+mijiaAPI --list_devices
+
+# 或直接在命令前指定
+MIJIA_LOG_LEVEL=WARNING mijiaAPI get --dev_name "卧室台灯" --prop_name "brightness"
+```
+
 完整的命令行参数说明：
 
 ```
@@ -556,6 +554,9 @@ api.login()
 
 本项目采用 [GPL-3.0](LICENSE) 开源许可证。
 
+**请注意：GPL-3.0 是具有“强传染性”的开源许可证。**  
+如果您在您的项目中使用、修改或分发本项目的代码（包括作为库依赖），您的整个项目也**必须**以 GPL-3.0 或兼容许可证开源发布。
+
 ## 免责声明
 
 * 本项目仅供学习交流使用，不得用于商业用途，如有侵权请联系删除

{mijiaapi-3.0.1 → mijiaapi-3.0.3}/mijiaAPI/__main__.py

@@ -1,6 +1,7 @@
 import argparse
 import json
 import logging
+import os
 import sys
 import time
 from pathlib import Path
@@ -11,7 +12,11 @@ from .devices import get_device_info, mijiaDevice
 from .version import version
 
 
-logging.getLogger("mijiaAPI").setLevel(logging.INFO)
+log_level_name = os.getenv('MIJIA_LOG_LEVEL', 'INFO').upper()
+if log_level_name not in ['DEBUG', 'INFO', 'WARNING', 'ERROR', 'CRITICAL']:
+    raise ValueError(f"无效的日志级别: {log_level_name}, 可选值为 DEBUG, INFO, WARNING, ERROR, CRITICAL")
+log_level = getattr(logging, log_level_name, logging.INFO)
+logging.getLogger("mijiaAPI").setLevel(log_level)
 
 def parse_args(args):
     parser = argparse.ArgumentParser(description=f"Mijia API CLI (v{version})")

{mijiaapi-3.0.1 → mijiaapi-3.0.3}/mijiaAPI/apis.py

@@ -37,6 +37,9 @@ class mijiaAPI():
         else:
             self.auth_data_path = Path(auth_data_path)
 
+        self._available_cache = None
+        self._available_cache_time = 0
+
         if self.auth_data_path.exists():
             with open(self.auth_data_path, "r") as f:
                 self.auth_data = json.load(f)
@@ -72,10 +75,21 @@ class mijiaAPI():
             return False
         if any(key not in self.auth_data for key in ["ua", "ssecurity", "userId", "cUserId", "serviceToken"]):
             return False
+
+        current_time = int(time.time())
+        if current_time - self._available_cache_time < 60:
+            logger.debug(f"使用缓存的available结果: {self._available_cache}")
+            return self._available_cache
+
         try:
             self.check_new_msg(refresh_token=False)
         except Exception:
+            self._available_cache = False
+            self._available_cache_time = current_time
             return False
+
+        self._available_cache = True
+        self._available_cache_time = current_time
         return True
 
     @property

{mijiaapi-3.0.1 → mijiaapi-3.0.3}/mijiaAPI/errors.py

@@ -8,7 +8,7 @@ ERROR_CODE = {
     "-10005": "权限不足",
     "-10006": "执行超时",
     "-10007": "设备离线或者不存在",
-    "-10020": "未授权OAuth2）",
+    "-10020": "未授权OAuth2",
     "-10030": "无效的token（HTTP）",
     "-10040": "无效的消息格式",
     "-10050": "无效的证书",

{mijiaapi-3.0.1 → mijiaapi-3.0.3}/mijiaAPI/logger.py

@@ -38,7 +38,7 @@ def get_logger(name: str) -> logging.Logger:
     console_handler = logging.StreamHandler()
 
     formatter = ColorFormatter(
-        "%(asctime)s - %(name)s - %(levelname)s: %(message)s",
+        "%(asctime)s.%(msecs)03d - %(name)s - %(levelname)s: %(message)s",
         datefmt="%Y-%m-%d %H:%M:%S",
     )
     console_handler.setFormatter(formatter)

mijiaapi-3.0.3/mijiaAPI/version.py

@@ -0,0 +1 @@
+version = "3.0.3"

mijiaapi-3.0.1/README.md → mijiaapi-3.0.3/mijiaAPI.egg-info/PKG-INFO

@@ -1,3 +1,23 @@
+Metadata-Version: 2.4
+Name: mijiaAPI
+Version: 3.0.3
+Summary: A Python API for Xiaomi Mijia
+Author-email: Do1e <i@do1e.cn>
+License-Expression: GPL-3.0-or-later
+Project-URL: Homepage, https://github.com/Do1e/mijia-api
+Project-URL: Repository, https://github.com/Do1e/mijia-api
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: <4.0,>=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pillow>=11.3.0
+Requires-Dist: pycryptodome>=3.23.0
+Requires-Dist: qrcode>=8.2
+Requires-Dist: requests>=2.32.5
+Requires-Dist: tzlocal>=5.3.1
+Dynamic: license-file
+
 # mijiaAPI
 
 小米米家设备的API，可以使用代码直接控制米家设备。
@@ -321,6 +341,25 @@ except APIError as e:
 mijiaAPI --help
 ```
 
+#### 环境变量
+
+支持以下环境变量来配置 CLI 的行为：
+
+| 环境变量 | 默认值 | 说明 |
+|---------|--------|------|
+| `MIJIA_LOG_LEVEL` | `INFO` | 日志级别，可选值：`DEBUG`, `INFO`, `WARNING`, `ERROR`, `CRITICAL` |
+
+##### 示例
+
+```bash
+# 设置为 DEBUG 级别查看详细日志
+export MIJIA_LOG_LEVEL=DEBUG
+mijiaAPI --list_devices
+
+# 或直接在命令前指定
+MIJIA_LOG_LEVEL=WARNING mijiaAPI get --dev_name "卧室台灯" --prop_name "brightness"
+```
+
 完整的命令行参数说明：
 
 ```
@@ -535,6 +574,9 @@ api.login()
 
 本项目采用 [GPL-3.0](LICENSE) 开源许可证。
 
+**请注意：GPL-3.0 是具有“强传染性”的开源许可证。**  
+如果您在您的项目中使用、修改或分发本项目的代码（包括作为库依赖），您的整个项目也**必须**以 GPL-3.0 或兼容许可证开源发布。
+
 ## 免责声明
 
 * 本项目仅供学习交流使用，不得用于商业用途，如有侵权请联系删除

{mijiaapi-3.0.1 → mijiaapi-3.0.3}/pyproject.toml

@@ -5,7 +5,8 @@ description = "A Python API for Xiaomi Mijia"
 authors = [{ name = "Do1e", email = "i@do1e.cn" }]
 readme = "README.md"
 requires-python = ">=3.9,<4.0"
-license = { text = "GPL-3.0-or-later" }
+license = "GPL-3.0-or-later"
+license-files = ["LICENSE"]
 dependencies = [
     "pillow>=11.3.0",
     "pycryptodome>=3.23.0",
@@ -15,7 +16,6 @@ dependencies = [
 ]
 classifiers = [
     "Programming Language :: Python :: 3",
-    "License :: OSI Approved :: GNU General Public License v3 (GPLv3)",
     "Operating System :: OS Independent",
 ]
 

mijiaapi-3.0.1/mijiaAPI/version.py

@@ -1 +0,0 @@
-version = "3.0.1"