perfdog-service-cli 1.0.1__tar.gz

perfdog_service_cli-1.0.1/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: perfdog-service-cli
+Version: 1.0.1
+Summary: PerfDog Service CLI - 命令行性能测试工具（供 AI/自动化脚本使用）
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.1.0
+Requires-Dist: grpcio>=1.60.0
+Requires-Dist: protobuf>=4.25.0
+Requires-Dist: pyyaml>=6.0.2
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+
+# perfdog-service-cli
+
+PerfDog Service 命令行性能测试工具 — 供 AI Agent / 自动化脚本使用。
+
+## 安装
+
+```bash
+pip install perfdog-service-cli --extra-index-url https://<username>:<token>@mirrors.tencent.com/repository/pypi/tencent_pypi/simple
+```
+
+## 快速开始
+
+```bash
+# 连接 PerfDog Service
+perfdog-service connect --token YOUR_TOKEN
+
+# 查看设备列表
+perfdog-service devices
+
+# 一键测试应用
+perfdog-service test-app -d DEVICE_ID -p com.example.app --duration 60
+
+# 手动控制测试流程（供 AI 编排）
+perfdog-service start -d DEVICE_ID --package com.example.app
+perfdog-service label -d DEVICE_ID -n "场景1"
+perfdog-service stop -d DEVICE_ID
+perfdog-service save -d DEVICE_ID --case-name "v1.0测试"
+```
+
+## 命令列表
+
+| 类别 | 命令 | 说明 |
+|------|------|------|
+| 连接 | `connect` | 连接 PerfDog Service |
+| 设备 | `devices` | 获取设备列表 |
+| | `init-device` | 初始化设备 |
+| | `status` | 获取设备状态 |
+| | `device-info` | 获取设备详细信息 |
+| | `cpu-info` | 获取 CPU 信息 |
+| 应用 | `apps` | 获取应用列表 |
+| | `processes` | 获取系统进程列表 |
+| 一键测试 | `test-app` | 一键测试应用 |
+| | `test-windows` | 一键测试 Windows 进程 |
+| | `test-console` | 一键测试游戏主机 |
+| | `test-network` | 弱网测试 |
+| 手动控制 | `start` | 开始测试 |
+| | `stop` | 停止测试 |
+| | `save` | 保存数据 |
+| | `label` | 添加标签 |
+| | `note` | 添加注释 |
+| | `update-label` | 修改标签 |
+| | `remove-note` | 删除注释 |
+| 配置 | `preferences` | 设置偏好（APK 安装等） |
+| | `available-types` | 查看支持的数据类型 |
+| | `enabled-types` | 查看已启用的类型 |
+| | `set-screenshot-interval` | 设置截图间隔 |
+| | `set-memory-freq` | 设置内存采样频率 |
+| 弱网 | `network-templates` | 查看网络模板 |
+| | `change-network-template` | 切换网络模板 |
+| | `submit-network-template` | 创建网络模板 |
+| | `delete-network-template` | 删除网络模板 |
+| 高级 | `add-console` | 添加主机设备 |
+| | `refresh-remote` | 刷新远程设备 |
+| | `check-occupied` | 检查设备占用 |
+| | `render-resolution` | 获取渲染分辨率 |
+| | `unreal-report` | Unreal 内存报告 |
+| | `launch-remote-collector` | 启动远程收集器 |
+| | `set-upload-server` | 设置数据上传服务器 |
+| | `clear-upload-server` | 清除数据上传服务器 |
+| 管理 | `create-task` | 创建任务 |
+| | `archive-case` | 归档用例 |
+| | `share-case` | 分享用例 |
+| | `kill` | 关闭 Service |
+
+## 架构
+
+```
+perfdog_service_cli/
+├── cli/              # Click 命令定义
+│   ├── main.py       # 36 个原子命令
+│   └── output.py     # 终端格式化
+├── service/          # gRPC 通信层
+│   ├── service_client.py   # gRPC 客户端
+│   ├── service_ops.py      # 原子操作（序列化边界）
+│   ├── perfdog_pb2.py      # protobuf
+│   └── perfdog_pb2_grpc.py # gRPC stub
+└── common/           # 配置 + 日志
+    ├── config.py
+    └── log.py
+```

perfdog_service_cli-1.0.1/README.md

@@ -0,0 +1,90 @@
+# perfdog-service-cli
+
+PerfDog Service 命令行性能测试工具 — 供 AI Agent / 自动化脚本使用。
+
+## 安装
+
+```bash
+pip install perfdog-service-cli --extra-index-url https://<username>:<token>@mirrors.tencent.com/repository/pypi/tencent_pypi/simple
+```
+
+## 快速开始
+
+```bash
+# 连接 PerfDog Service
+perfdog-service connect --token YOUR_TOKEN
+
+# 查看设备列表
+perfdog-service devices
+
+# 一键测试应用
+perfdog-service test-app -d DEVICE_ID -p com.example.app --duration 60
+
+# 手动控制测试流程（供 AI 编排）
+perfdog-service start -d DEVICE_ID --package com.example.app
+perfdog-service label -d DEVICE_ID -n "场景1"
+perfdog-service stop -d DEVICE_ID
+perfdog-service save -d DEVICE_ID --case-name "v1.0测试"
+```
+
+## 命令列表
+
+| 类别 | 命令 | 说明 |
+|------|------|------|
+| 连接 | `connect` | 连接 PerfDog Service |
+| 设备 | `devices` | 获取设备列表 |
+| | `init-device` | 初始化设备 |
+| | `status` | 获取设备状态 |
+| | `device-info` | 获取设备详细信息 |
+| | `cpu-info` | 获取 CPU 信息 |
+| 应用 | `apps` | 获取应用列表 |
+| | `processes` | 获取系统进程列表 |
+| 一键测试 | `test-app` | 一键测试应用 |
+| | `test-windows` | 一键测试 Windows 进程 |
+| | `test-console` | 一键测试游戏主机 |
+| | `test-network` | 弱网测试 |
+| 手动控制 | `start` | 开始测试 |
+| | `stop` | 停止测试 |
+| | `save` | 保存数据 |
+| | `label` | 添加标签 |
+| | `note` | 添加注释 |
+| | `update-label` | 修改标签 |
+| | `remove-note` | 删除注释 |
+| 配置 | `preferences` | 设置偏好（APK 安装等） |
+| | `available-types` | 查看支持的数据类型 |
+| | `enabled-types` | 查看已启用的类型 |
+| | `set-screenshot-interval` | 设置截图间隔 |
+| | `set-memory-freq` | 设置内存采样频率 |
+| 弱网 | `network-templates` | 查看网络模板 |
+| | `change-network-template` | 切换网络模板 |
+| | `submit-network-template` | 创建网络模板 |
+| | `delete-network-template` | 删除网络模板 |
+| 高级 | `add-console` | 添加主机设备 |
+| | `refresh-remote` | 刷新远程设备 |
+| | `check-occupied` | 检查设备占用 |
+| | `render-resolution` | 获取渲染分辨率 |
+| | `unreal-report` | Unreal 内存报告 |
+| | `launch-remote-collector` | 启动远程收集器 |
+| | `set-upload-server` | 设置数据上传服务器 |
+| | `clear-upload-server` | 清除数据上传服务器 |
+| 管理 | `create-task` | 创建任务 |
+| | `archive-case` | 归档用例 |
+| | `share-case` | 分享用例 |
+| | `kill` | 关闭 Service |
+
+## 架构
+
+```
+perfdog_service_cli/
+├── cli/              # Click 命令定义
+│   ├── main.py       # 36 个原子命令
+│   └── output.py     # 终端格式化
+├── service/          # gRPC 通信层
+│   ├── service_client.py   # gRPC 客户端
+│   ├── service_ops.py      # 原子操作（序列化边界）
+│   ├── perfdog_pb2.py      # protobuf
+│   └── perfdog_pb2_grpc.py # gRPC stub
+└── common/           # 配置 + 日志
+    ├── config.py
+    └── log.py
+```

perfdog_service_cli-1.0.1/pyproject.toml

@@ -0,0 +1,57 @@
+[project]
+name = "perfdog-service-cli"
+version = "1.0.1"
+description = "PerfDog Service CLI - 命令行性能测试工具（供 AI/自动化脚本使用）"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "click>=8.1.0",
+    "grpcio>=1.60.0",
+    "protobuf>=4.25.0",
+    "pyyaml>=6.0.2",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-cov>=4.0",
+]
+
+[build-system]
+requires = ["setuptools>=42", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[project.scripts]
+perfdog-service = "perfdog_service_cli.cli.main:main"
+
+[[tool.uv.index]]
+url = "https://mirrors.cloud.tencent.com/pypi/simple/"
+default = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = "-v --tb=short -m 'not integration and not e2e'"
+markers = [
+    "integration: 集成测试，需要本机运行 PerfDog Service（PERFDOG_SERVICE_TOKEN）",
+    "e2e: 端到端测试，需要真实设备（PERFDOG_E2E_DEVICE_ID + PERFDOG_E2E_PACKAGE）",
+]
+
+[tool.ruff]
+line-length = 120
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I"]
+
+[tool.ruff.lint.isort]
+known-first-party = ["perfdog_service_cli"]
+
+[tool.ruff.format]
+indent-style = "space"
+line-ending = "lf"

perfdog_service_cli-1.0.1/setup.cfg

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

perfdog_service_cli-1.0.1/src/perfdog_service_cli/__init__.py

@@ -0,0 +1,8 @@
+# coding: utf-8
+"""PerfDog Service CLI - 命令行性能测试工具
+
+通过 PerfDog Service gRPC 接口进行设备管理、性能测试、数据采集。
+供 AI Agent / 自动化脚本组合原子命令使用。
+"""
+
+__version__ = "0.1.0"

perfdog_service_cli-1.0.1/src/perfdog_service_cli/__main__.py

@@ -0,0 +1,6 @@
+# coding: utf-8
+"""支持 python -m perfdog_service_cli 运行"""
+from perfdog_service_cli.cli.main import main
+
+if __name__ == "__main__":
+    main()

perfdog_service_cli-1.0.1/src/perfdog_service_cli/cli/__init__.py

@@ -0,0 +1,2 @@
+# coding: utf-8
+"""PerfDog Service CLI - 命令行工具"""

perfdog_service_cli-1.0.1/src/perfdog_service_cli/cli/__main__.py

@@ -0,0 +1,6 @@
+# coding: utf-8
+"""支持 python -m perfdog_service_cli 运行"""
+from perfdog_service_cli.cli.main import main
+
+if __name__ == "__main__":
+    main()