# Hairtest
Airtest 并行测试工具 - 支持多设备并行执行测试用例
## 特性
- 🚀 **多设备并行执行** - 支持多台Android设备同时运行测试
- 📱 **智能负载均衡** - 自动分配测试任务到可用设备
- 📝 **多种用例格式** - 支持单文件、目录、YAML用例集
- 🔄 **失败重试机制** - 支持断点续跑和失败用例重试
- 📊 **详细测试报告** - 生成JSON格式的测试结果报告
- 🛠️ **简单易用** - 一条命令即可开始测试
## 构建包
```bash
python setup.py sdist bdist_wheel
# 上传到 PyPI 需要apitoken
twine upload dist/*
```
## 开发
```bash
cd hairtest
python cli.py Tests/TmapiClient/testsuites/core.yml
python cli.py Tests/TmapiClient/testsuites/core.yml --devices device1 --mode
```
## 安装
```bash
pip install hairtest
# 国内镜像可能没有，指定官网
pip install --index-url https://pypi.org/simple/ hairtest
# 开发模式安装
pip install -e .
```
## 快速开始
### 基本使用
```bash
# 执行单个测试文件
hairtest Tests/TmapiClient/testAICase/ai_test.py
# 执行测试目录（自动扫描所有 *_test.py 文件）
hairtest Tests/TmapiClient/testAICase/
# 执行 YAML 用例集
hairtest Tests/TmapiClient/testsuites/core.yml
```
### 高级使用
```bash
# 指定设备执行
hairtest core.yml --devices MDX0220918025508
# 多设备并行
hairtest core.yml --devices MDX0220918025508 YWT0222A10000129
# 兼容模式（每个设备执行所有用例）
hairtest core.yml --mode
# 失败重试（基于之前的测试数据）
hairtest core.yml --retry-data 1753498757687_data.json
# 组合使用
hairtest core.yml --devices MDX0220918025508 YWT0222A10000129 --mode --retry-data data.json
```
## 参数说明
| 参数 | 简写 | 说明 |
|------|------|------|
| `test_path` | - | 测试用例路径（必需） |
| `--devices` | `-d` | 指定设备列表，多个设备用空格分隔 |
| `--mode` | `-m` | 兼容模式：多台设备并行，单设备脚本串行 |
| `--retry-data` | `-r` | 失败重试：指定已运行的测试数据文件 |
| `--version` | `-v` | 显示版本信息 |
| `--help` | `-h` | 显示帮助信息 |
## 支持的文件类型
### 1. 单个测试文件
文件名必须以 `_test.py` 结尾：
```
ai_login_test.py
hotel_search_test.py
```
### 2. 测试目录
自动扫描目录下所有 `*_test.py` 文件：
```
Tests/
├── login_test.py
├── search_test.py
└── booking_test.py
```
### 3. YAML 用例集
支持自定义测试用例配置：
```yaml
config:
author: 王彦青
create_time: '2022-05-25'
testcases:
登录测试:
testcase: Tests/TmapiClient/testAICase/ai_login_test.py
搜索测试:
testcase: Tests/TmapiClient/testAICase/ai_search_test.py
预订测试:
testcase: Tests/TmapiClient/testAICase/ai_booking_test.py
```
## 运行模式
### 负载均衡模式（默认）
测试用例平均分配到各个设备，每个用例只执行一次：
```
设备A: test1.py, test3.py
设备B: test2.py, test4.py
```
### 兼容模式（--mode）
每个设备都执行所有测试用例：
```
设备A: test1.py, test2.py, test3.py, test4.py
设备B: test1.py, test2.py, test3.py, test4.py
```
## 测试报告
执行完成后会在 `reports/` 目录生成：
- `{timestamp}_data.json` - 详细的测试结果数据
- `{timestamp}_logs/` - 各设备的测试日志
## 开发
```bash
# 克隆项目
git clone https://github.com/yourusername/hairtest.git
cd hairtest
# 开发模式安装
pip install -e .
# 运行测试
hairtest Tests/TmapiClient/testsuites/core.yml
```
## 依赖
- Python >= 3.7
- airtest >= 1.3.0
- gevent
- pyyaml
- jinja2
- requests
## 许可证
MIT License
## 贡献
欢迎提交 Issue 和 Pull Request！
## 更新日志
### v1.0.0
- 初始版本发布
- 支持多设备并行测试
- 支持多种用例格式
- 支持失败重试机制
Raw data
{
"_id": null,
"home_page": "https://github.com/yourusername/hairtest",
"name": "hairtest",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "airtest automation testing parallel mobile",
"author": "\u738b\u5f66\u9752",
"author_email": "your.email@example.com",
"download_url": "https://files.pythonhosted.org/packages/1a/05/b3e50d06733cd0bf4c37ca5267ecdb5aaff0688721f04683a27ed8213eaf/hairtest-1.0.2.tar.gz",
"platform": null,
"description": "# Hairtest\n\nAirtest \u5e76\u884c\u6d4b\u8bd5\u5de5\u5177 - \u652f\u6301\u591a\u8bbe\u5907\u5e76\u884c\u6267\u884c\u6d4b\u8bd5\u7528\u4f8b\n\n## \u7279\u6027\n\n- \ud83d\ude80 **\u591a\u8bbe\u5907\u5e76\u884c\u6267\u884c** - \u652f\u6301\u591a\u53f0Android\u8bbe\u5907\u540c\u65f6\u8fd0\u884c\u6d4b\u8bd5\n- \ud83d\udcf1 **\u667a\u80fd\u8d1f\u8f7d\u5747\u8861** - \u81ea\u52a8\u5206\u914d\u6d4b\u8bd5\u4efb\u52a1\u5230\u53ef\u7528\u8bbe\u5907\n- \ud83d\udcdd **\u591a\u79cd\u7528\u4f8b\u683c\u5f0f** - \u652f\u6301\u5355\u6587\u4ef6\u3001\u76ee\u5f55\u3001YAML\u7528\u4f8b\u96c6\n- \ud83d\udd04 **\u5931\u8d25\u91cd\u8bd5\u673a\u5236** - \u652f\u6301\u65ad\u70b9\u7eed\u8dd1\u548c\u5931\u8d25\u7528\u4f8b\u91cd\u8bd5\n- \ud83d\udcca **\u8be6\u7ec6\u6d4b\u8bd5\u62a5\u544a** - \u751f\u6210JSON\u683c\u5f0f\u7684\u6d4b\u8bd5\u7ed3\u679c\u62a5\u544a\n- \ud83d\udee0\ufe0f **\u7b80\u5355\u6613\u7528** - \u4e00\u6761\u547d\u4ee4\u5373\u53ef\u5f00\u59cb\u6d4b\u8bd5\n## \u6784\u5efa\u5305\n```bash\npython setup.py sdist bdist_wheel\n\n# \u4e0a\u4f20\u5230 PyPI \u9700\u8981apitoken\ntwine upload dist/*\n\n```\n\n## \u5f00\u53d1\n```bash\ncd hairtest\npython cli.py Tests/TmapiClient/testsuites/core.yml\npython cli.py Tests/TmapiClient/testsuites/core.yml --devices device1 --mode\n```\n## \u5b89\u88c5\n\n```bash\npip install hairtest\n# \u56fd\u5185\u955c\u50cf\u53ef\u80fd\u6ca1\u6709\uff0c\u6307\u5b9a\u5b98\u7f51\npip install --index-url https://pypi.org/simple/ hairtest\n\n# \u5f00\u53d1\u6a21\u5f0f\u5b89\u88c5\npip install -e .\n```\n\n## \u5feb\u901f\u5f00\u59cb\n\n### \u57fa\u672c\u4f7f\u7528\n\n```bash\n# \u6267\u884c\u5355\u4e2a\u6d4b\u8bd5\u6587\u4ef6\nhairtest Tests/TmapiClient/testAICase/ai_test.py\n\n# \u6267\u884c\u6d4b\u8bd5\u76ee\u5f55\uff08\u81ea\u52a8\u626b\u63cf\u6240\u6709 *_test.py \u6587\u4ef6\uff09\nhairtest Tests/TmapiClient/testAICase/\n\n# \u6267\u884c YAML \u7528\u4f8b\u96c6\nhairtest Tests/TmapiClient/testsuites/core.yml\n```\n\n### \u9ad8\u7ea7\u4f7f\u7528\n\n```bash\n# \u6307\u5b9a\u8bbe\u5907\u6267\u884c\nhairtest core.yml --devices MDX0220918025508\n\n# \u591a\u8bbe\u5907\u5e76\u884c\nhairtest core.yml --devices MDX0220918025508 YWT0222A10000129\n\n# \u517c\u5bb9\u6a21\u5f0f\uff08\u6bcf\u4e2a\u8bbe\u5907\u6267\u884c\u6240\u6709\u7528\u4f8b\uff09\nhairtest core.yml --mode\n\n# \u5931\u8d25\u91cd\u8bd5\uff08\u57fa\u4e8e\u4e4b\u524d\u7684\u6d4b\u8bd5\u6570\u636e\uff09\nhairtest core.yml --retry-data 1753498757687_data.json\n\n# \u7ec4\u5408\u4f7f\u7528\nhairtest core.yml --devices MDX0220918025508 YWT0222A10000129 --mode --retry-data data.json\n```\n\n## \u53c2\u6570\u8bf4\u660e\n\n| \u53c2\u6570 | \u7b80\u5199 | \u8bf4\u660e |\n|------|------|------|\n| `test_path` | - | \u6d4b\u8bd5\u7528\u4f8b\u8def\u5f84\uff08\u5fc5\u9700\uff09 |\n| `--devices` | `-d` | \u6307\u5b9a\u8bbe\u5907\u5217\u8868\uff0c\u591a\u4e2a\u8bbe\u5907\u7528\u7a7a\u683c\u5206\u9694 |\n| `--mode` | `-m` | \u517c\u5bb9\u6a21\u5f0f\uff1a\u591a\u53f0\u8bbe\u5907\u5e76\u884c\uff0c\u5355\u8bbe\u5907\u811a\u672c\u4e32\u884c |\n| `--retry-data` | `-r` | \u5931\u8d25\u91cd\u8bd5\uff1a\u6307\u5b9a\u5df2\u8fd0\u884c\u7684\u6d4b\u8bd5\u6570\u636e\u6587\u4ef6 |\n| `--version` | `-v` | \u663e\u793a\u7248\u672c\u4fe1\u606f |\n| `--help` | `-h` | \u663e\u793a\u5e2e\u52a9\u4fe1\u606f |\n\n## \u652f\u6301\u7684\u6587\u4ef6\u7c7b\u578b\n\n### 1. \u5355\u4e2a\u6d4b\u8bd5\u6587\u4ef6\n\u6587\u4ef6\u540d\u5fc5\u987b\u4ee5 `_test.py` \u7ed3\u5c3e\uff1a\n```\nai_login_test.py\nhotel_search_test.py\n```\n\n### 2. \u6d4b\u8bd5\u76ee\u5f55\n\u81ea\u52a8\u626b\u63cf\u76ee\u5f55\u4e0b\u6240\u6709 `*_test.py` \u6587\u4ef6\uff1a\n```\nTests/\n\u251c\u2500\u2500 login_test.py\n\u251c\u2500\u2500 search_test.py\n\u2514\u2500\u2500 booking_test.py\n```\n\n### 3. YAML \u7528\u4f8b\u96c6\n\u652f\u6301\u81ea\u5b9a\u4e49\u6d4b\u8bd5\u7528\u4f8b\u914d\u7f6e\uff1a\n```yaml\nconfig:\n author: \u738b\u5f66\u9752\n create_time: '2022-05-25'\ntestcases:\n \u767b\u5f55\u6d4b\u8bd5:\n testcase: Tests/TmapiClient/testAICase/ai_login_test.py\n \u641c\u7d22\u6d4b\u8bd5:\n testcase: Tests/TmapiClient/testAICase/ai_search_test.py\n \u9884\u8ba2\u6d4b\u8bd5:\n testcase: Tests/TmapiClient/testAICase/ai_booking_test.py\n```\n\n## \u8fd0\u884c\u6a21\u5f0f\n\n### \u8d1f\u8f7d\u5747\u8861\u6a21\u5f0f\uff08\u9ed8\u8ba4\uff09\n\u6d4b\u8bd5\u7528\u4f8b\u5e73\u5747\u5206\u914d\u5230\u5404\u4e2a\u8bbe\u5907\uff0c\u6bcf\u4e2a\u7528\u4f8b\u53ea\u6267\u884c\u4e00\u6b21\uff1a\n```\n\u8bbe\u5907A: test1.py, test3.py\n\u8bbe\u5907B: test2.py, test4.py\n```\n\n### \u517c\u5bb9\u6a21\u5f0f\uff08--mode\uff09\n\u6bcf\u4e2a\u8bbe\u5907\u90fd\u6267\u884c\u6240\u6709\u6d4b\u8bd5\u7528\u4f8b\uff1a\n```\n\u8bbe\u5907A: test1.py, test2.py, test3.py, test4.py\n\u8bbe\u5907B: test1.py, test2.py, test3.py, test4.py\n```\n\n## \u6d4b\u8bd5\u62a5\u544a\n\n\u6267\u884c\u5b8c\u6210\u540e\u4f1a\u5728 `reports/` \u76ee\u5f55\u751f\u6210\uff1a\n- `{timestamp}_data.json` - \u8be6\u7ec6\u7684\u6d4b\u8bd5\u7ed3\u679c\u6570\u636e\n- `{timestamp}_logs/` - \u5404\u8bbe\u5907\u7684\u6d4b\u8bd5\u65e5\u5fd7\n\n## \u5f00\u53d1\n\n```bash\n# \u514b\u9686\u9879\u76ee\ngit clone https://github.com/yourusername/hairtest.git\ncd hairtest\n\n# \u5f00\u53d1\u6a21\u5f0f\u5b89\u88c5\npip install -e .\n# \u8fd0\u884c\u6d4b\u8bd5\nhairtest Tests/TmapiClient/testsuites/core.yml\n```\n\n## \u4f9d\u8d56\n\n- Python >= 3.7\n- airtest >= 1.3.0\n- gevent\n- pyyaml\n- jinja2\n- requests\n\n## \u8bb8\u53ef\u8bc1\n\nMIT License\n\n## \u8d21\u732e\n\n\u6b22\u8fce\u63d0\u4ea4 Issue \u548c Pull Request\uff01\n\n## \u66f4\u65b0\u65e5\u5fd7\n\n### v1.0.0\n- \u521d\u59cb\u7248\u672c\u53d1\u5e03\n- \u652f\u6301\u591a\u8bbe\u5907\u5e76\u884c\u6d4b\u8bd5\n- \u652f\u6301\u591a\u79cd\u7528\u4f8b\u683c\u5f0f\n- \u652f\u6301\u5931\u8d25\u91cd\u8bd5\u673a\u5236\n",
"bugtrack_url": null,
"license": null,
"summary": "Airtest \u5e76\u884c\u6d4b\u8bd5\u5de5\u5177",
"version": "1.0.2",
"project_urls": {
"Homepage": "https://github.com/yourusername/hairtest"
},
"split_keywords": [
"airtest",
"automation",
"testing",
"parallel",
"mobile"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "f326aa50980c04bc2f44f5f76115184f0736233f9e7c601b084661b6eeab15dd",
"md5": "b18c4c10871918d5db9230b2dcb2126d",
"sha256": "64d7518cc3af7916d34d0c04d338966c5f4b88c64c5a730ce9987f91c1fe2982"
},
"downloads": -1,
"filename": "hairtest-1.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b18c4c10871918d5db9230b2dcb2126d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 15235,
"upload_time": "2025-07-30T08:09:43",
"upload_time_iso_8601": "2025-07-30T08:09:43.939705Z",
"url": "https://files.pythonhosted.org/packages/f3/26/aa50980c04bc2f44f5f76115184f0736233f9e7c601b084661b6eeab15dd/hairtest-1.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "1a05b3e50d06733cd0bf4c37ca5267ecdb5aaff0688721f04683a27ed8213eaf",
"md5": "f0e48edac2fc2cc31d16576b4323a6b4",
"sha256": "62c1d55942d120fa81491c36f7b6f44e28170fce9015726d7393224ef00d1701"
},
"downloads": -1,
"filename": "hairtest-1.0.2.tar.gz",
"has_sig": false,
"md5_digest": "f0e48edac2fc2cc31d16576b4323a6b4",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 15107,
"upload_time": "2025-07-30T08:09:44",
"upload_time_iso_8601": "2025-07-30T08:09:44.916077Z",
"url": "https://files.pythonhosted.org/packages/1a/05/b3e50d06733cd0bf4c37ca5267ecdb5aaff0688721f04683a27ed8213eaf/hairtest-1.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-30 08:09:44",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "yourusername",
"github_project": "hairtest",
"github_not_found": true,
"lcname": "hairtest"
}
JSON
