mijiaAPI 1.4.0__tar.gz → 1.4.1__tar.gz

{mijiaapi-1.4.0 → mijiaapi-1.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: mijiaAPI
-Version: 1.4.0
+Version: 1.4.1
 Summary: A Python API for Xiaomi Mijia
 License: GPLv3
 Author: Do1e
@@ -167,9 +167,10 @@ current_temp = device.color_temperature  # 获取色温
 ```
 > python -m mijiaAPI --help
 > mijiaAPI --help
-usage: __main__.py [-h] [-p AUTH_PATH] [-l] [--list_homes] [--list_scenes] [--list_consumable_items]
-                   [--run_scene SCENE_ID/SCENE_NAME [SCENE_ID/SCENE_NAME ...]] [--get_device_info DEVICE_MODEL]
-                   {get,set} ...
+usage: mijiaAPI [-h] [-p AUTH_PATH] [-l] [--list_homes] [--list_scenes] [--list_consumable_items]
+                [--run_scene SCENE_ID/SCENE_NAME [SCENE_ID/SCENE_NAME ...]] [--get_device_info DEVICE_MODEL] [--run PROMPT]
+                [--wifispeaker_name WIFISPEAKER_NAME] [--quiet]
+                {get,set} ...
 
 Mijia API CLI
 
@@ -191,6 +192,10 @@ options:
                         运行场景，指定场景ID或名称
   --get_device_info DEVICE_MODEL
                         获取设备信息，指定设备model，先使用 --list_devices 获取
+  --run PROMPT          使用自然语言描述你的需求，如果你有小爱音箱的话
+  --wifispeaker_name WIFISPEAKER_NAME
+                        指定小爱音箱名称，默认是获取到的第一个小爱音箱
+  --quiet               小爱音箱静默执行
 ```
 
 ```
@@ -222,6 +227,27 @@ options:
   --value VALUE         需要设定的属性值
 ```
 
+或者直接使用`uvx`忽略安装步骤：
+
+```bash
+uvx mijiaAPI --help
+```
+
+#### 示例：
+
+```bash
+mijiaAPI -l # 列出所有米家设备
+mijiaAPI --list_homes # 列出家庭列表
+mijiaAPI --list_scenes # 列出场景列表
+mijiaAPI --list_consumable_items # 列出耗材列表
+mijiaAPI --run_scene SCENE_ID/SCENE_NAME # 运行场景，指定场景ID或名称
+mijiaAPI --get_device_info DEVICE_MODEL # 获取设备信息，指定设备model，先使用 --list_devices 获取
+mijiaAPI get --dev_name DEV_NAME --prop_name PROP_NAME # 获取设备属性
+mijiaAPI set --dev_name DEV_NAME --prop_name PROP_NAME --value VALUE # 设置设备属性
+mijiaAPI --run 明天天气如何
+mijiaAPI --run 打开台灯并将亮度调至最大 --quiet
+```
+
 ## 致谢
 
 * [janzlan/mijia-api](https://gitee.com/janzlan/mijia-api/tree/master)

{mijiaapi-1.4.0 → mijiaapi-1.4.1}/README.md

@@ -143,9 +143,10 @@ current_temp = device.color_temperature  # 获取色温
 ```
 > python -m mijiaAPI --help
 > mijiaAPI --help
-usage: __main__.py [-h] [-p AUTH_PATH] [-l] [--list_homes] [--list_scenes] [--list_consumable_items]
-                   [--run_scene SCENE_ID/SCENE_NAME [SCENE_ID/SCENE_NAME ...]] [--get_device_info DEVICE_MODEL]
-                   {get,set} ...
+usage: mijiaAPI [-h] [-p AUTH_PATH] [-l] [--list_homes] [--list_scenes] [--list_consumable_items]
+                [--run_scene SCENE_ID/SCENE_NAME [SCENE_ID/SCENE_NAME ...]] [--get_device_info DEVICE_MODEL] [--run PROMPT]
+                [--wifispeaker_name WIFISPEAKER_NAME] [--quiet]
+                {get,set} ...
 
 Mijia API CLI
 
@@ -167,6 +168,10 @@ options:
                         运行场景，指定场景ID或名称
   --get_device_info DEVICE_MODEL
                         获取设备信息，指定设备model，先使用 --list_devices 获取
+  --run PROMPT          使用自然语言描述你的需求，如果你有小爱音箱的话
+  --wifispeaker_name WIFISPEAKER_NAME
+                        指定小爱音箱名称，默认是获取到的第一个小爱音箱
+  --quiet               小爱音箱静默执行
 ```
 
 ```
@@ -198,6 +203,27 @@ options:
   --value VALUE         需要设定的属性值
 ```
 
+或者直接使用`uvx`忽略安装步骤：
+
+```bash
+uvx mijiaAPI --help
+```
+
+#### 示例：
+
+```bash
+mijiaAPI -l # 列出所有米家设备
+mijiaAPI --list_homes # 列出家庭列表
+mijiaAPI --list_scenes # 列出场景列表
+mijiaAPI --list_consumable_items # 列出耗材列表
+mijiaAPI --run_scene SCENE_ID/SCENE_NAME # 运行场景，指定场景ID或名称
+mijiaAPI --get_device_info DEVICE_MODEL # 获取设备信息，指定设备model，先使用 --list_devices 获取
+mijiaAPI get --dev_name DEV_NAME --prop_name PROP_NAME # 获取设备属性
+mijiaAPI set --dev_name DEV_NAME --prop_name PROP_NAME --value VALUE # 设置设备属性
+mijiaAPI --run 明天天气如何
+mijiaAPI --run 打开台灯并将亮度调至最大 --quiet
+```
+
 ## 致谢
 
 * [janzlan/mijia-api](https://gitee.com/janzlan/mijia-api/tree/master)

{mijiaapi-1.4.0 → mijiaapi-1.4.1}/mijiaAPI/__main__.py

@@ -51,6 +51,23 @@ def parse_args(args):
         help="获取设备信息，指定设备model，先使用 --list_devices 获取",
         metavar='DEVICE_MODEL',
     )
+    parser.add_argument(
+        '--run',
+        type=str,
+        help="使用自然语言描述你的需求，如果你有小爱音箱的话",
+        metavar='PROMPT',
+    )
+    parser.add_argument(
+        '--wifispeaker_name',
+        type=str,
+        help="指定小爱音箱名称，默认是获取到的第一个小爱音箱",
+        default=None,
+    )
+    parser.add_argument(
+        '--quiet',
+        action='store_true',
+        help="小爱音箱静默执行",
+    )
 
     get = subparsers.add_parser(
         'get',
@@ -273,6 +290,20 @@ def main(args):
     if args.get_device_info:
         device_info = get_device_info(args.get_device_info)
         print(json.dumps(device_info, indent=2, ensure_ascii=False))
+    if args.run:
+        if device_mapping is None:
+            device_mapping = get_devices_list(api, verbose=False)
+        if args.wifispeaker_name is None:
+            wifispeaker = None
+            for device in device_mapping.values():
+                if 'xiaomi.wifispeaker' in device['model']:
+                    wifispeaker = mijiaDevices(api, dev_name=device['name'])
+                    break
+            if wifispeaker is None:
+                raise ValueError("No wifispeaker found")
+        else:
+            wifispeaker = mijiaDevices(api, dev_name=args.wifispeaker_name)
+        wifispeaker.run_action('execute-text-directive', _in=[args.run, args.quiet])
     if hasattr(args, 'func') and args.func is not None:
         if args.func == 'get':
             get(args)

{mijiaapi-1.4.0 → mijiaapi-1.4.1}/pyproject.toml

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