添加用例使用说明举例
This commit is contained in:
jerrylizilong
parent
d2bda763d7
commit
2038774138
248
README.md
248
README.md
|
|
@ -1,20 +1,171 @@
|
|||
|
||||
参考链接：
|
||||
|
||||
https://testerhome.com/topics/15534
|
||||
https://testerhome.com/topics/15534 ： Python + flask+ selenium 自动化测试用例管理、执行平台
|
||||
|
||||
https://testerhome.com/topics/15897
|
||||
https://testerhome.com/topics/15897 ： UI 自动化测试用例整理举例-百度首页
|
||||
|
||||
https://testerhome.com/topics/16106
|
||||
https://testerhome.com/topics/16106 ： 使用 python 多进程模块 multiprocessing 并发执行测试用例
|
||||
|
||||
|
||||
# autotest_platform
|
||||
基于python+selenium的自动化测试管理、执行平台。
|
||||
|
||||
## 版本要求：
|
||||
python 3.4 以上
|
||||
selenium ： 建议使用 3.0 以上版本
|
||||
mysql : 建议 5.5 以上
|
||||
- python 3.4 以上
|
||||
- selenium ： 建议使用 3.0 以上版本
|
||||
- mysql : 建议 5.5 以上
|
||||
|
||||
## 使用说明：
|
||||
|
||||
### 1. 新建用例：
|
||||
|
||||
用例步骤说明：
|
||||
- 每个用例步骤中通过逗号进行分隔。
|
||||
- 单个步骤的格式： 步骤名称+分隔符（|）+参数列表（参数间按@@进行分隔）。如：填写|id@@kw@@selenium， 表示步骤为“填写”，参数列表为“id、kw、selenium”。
|
||||
- 默认的参数含义：1：通过什么属性定位目标元素（可使用id、name、class、text、xpath、css等多种定位方式进行定位） 2：目标元素对应的属性值（如id = kw） 3：其他。
|
||||
- 例如：填写|id@@kw@@selenium： 代表通过 id = kw 查找到输入框，并输入 selenium 。
|
||||
|
||||
#### 1.1 用例初始化：
|
||||
初始化可以有以下方式：
|
||||
|
||||
- 指定浏览器类型，如 Chrome、 Firefox。 需要对应的selenium server支持。
|
||||
- 指定模拟手机型号， 如 Chrome|iPhone 6。目前只有 chrome 浏览器支持模拟手机。
|
||||
- 调用其他已封装的公共方法，如 公共方法|登录。 具体的公共方法格式与正常用例一致，但需要指定用例类型为 公共用例。
|
||||
- 公共方法支持嵌套，即一个公共方法里调用另一个公共方法。
|
||||
|
||||
#### 用例说明：
|
||||
|
||||
#### 一. 使用chrome 浏览器进行测试：
|
||||
例子：在百度中输入selenium，并验证查询结果是否正确。
|
||||
```
|
||||
Chrome,前往|http://www.baidu.com,填写|id@@kw@@selenium,点击|id@@su,验证|Web Browser Automation,截图
|
||||
```
|
||||
步骤解析：
|
||||
```
|
||||
- Chrome： 调用 Chrome driver 进行测试。
|
||||
- 前往|http://www.baidu.com ： 前往目标页。
|
||||
- 填写|id@@kw@@selenium ： 在 id 为 kw 的元素中输入 selenium。
|
||||
- 点击|id@@su ： 点击 id 为 su 的元素。
|
||||
- 验证|Web Browser Automation ： 验证页面中是否出现 ‘Web Browser Automation’ 的文字。
|
||||
- 截图： 对当前页面进行截图并保存。
|
||||
```
|
||||
|
||||
|
||||
|
||||
#### 二. 使用chrome 浏览器模拟移动设备进行测试：
|
||||
例子：模拟iPhone 6 打开网页，在百度中输入selenium，并验证查询结果是否正确。
|
||||
```
|
||||
Chrome|iPhone 6,前往|http://www.baidu.com,填写|id@@kw@@selenium,点击|id@@su,验证|Web Browser Automation,截图
|
||||
```
|
||||
步骤解析：
|
||||
```
|
||||
- Chrome|iPhone 6： 调用 Chrome driver 进行测试，并设置页面大小为模拟 iPhone 6。
|
||||
```
|
||||
|
||||
|
||||
|
||||
### 2.公共用例
|
||||
|
||||
某些公共的步骤，可以封装为公共方法进行调用：
|
||||
- 公共方法添加：新建用例，选择用例类型为 公共用例， 所属模块为public。
|
||||
- 公共方法调用：步骤： 公共方法|公共方法名， 如 公共方法|登录；公共方法|查询订单。
|
||||
|
||||
|
||||
#### 三. 使用公共方法进行测试：
|
||||
例子：
|
||||
1. 添加公共方法： 打开 chrome 浏览器，并打开百度首页
|
||||
```
|
||||
// 添加公共方法： 注意需将用例类型设置为 ： 公共用例， 所属模块设置为： public， 用例名称： 打开百度首页
|
||||
Chrome,前往|http://www.baidu.com
|
||||
```
|
||||
2. 分别添加测试用例：在百度首页分别点击新闻、地图、视频，并验证跳转页面是否正确。
|
||||
|
||||
```
|
||||
公共方法|打开百度首页,点击|name@@tj_trnews,验证标题|百度新闻
|
||||
公共方法|打开百度首页,点击|name@@tj_trmap,验证标题|百度地图
|
||||
公共方法|打开百度首页,点击|name@@tj_trtieba,验证标题|百度贴吧
|
||||
```
|
||||
|
||||
步骤解析：
|
||||
```
|
||||
- 公共方法|打开百度首页： 根据所指定的用例名称，将公共用例的步骤拼接在当前用例之前执行。
|
||||
|
||||
```
|
||||
|
||||
效果等同于：
|
||||
|
||||
```
|
||||
Chrome,前往|http://www.baidu.com,点击|name@@tj_trnews,验证标题|百度新闻
|
||||
```
|
||||
|
||||
|
||||
3. 公共方法支持嵌套，如：
|
||||
|
||||
```
|
||||
// 公共方法1： 打开百度首页
|
||||
Chrome,前往|http://www.baidu.com
|
||||
|
||||
//公共方法2： 进入百度新闻
|
||||
公共方法|打开百度首页,点击|name@@tj_trnews,验证标题|百度新闻
|
||||
|
||||
// 用例： 进入百度新闻页后，点击贴吧
|
||||
公共方法|进入百度新闻,点击|name@@tj_trtieba,验证标题|百度贴吧
|
||||
```
|
||||
|
||||
效果等同于：
|
||||
|
||||
```
|
||||
Chrome,前往|http://www.baidu.com,点击|name@@tj_trnews,验证标题|百度新闻,点击|name@@tj_trtieba,验证标题|百度贴吧
|
||||
```
|
||||
|
||||
|
||||
|
||||
### 3.用例管理：
|
||||
|
||||
还可对用例进行如下管理：
|
||||
- 用例查询
|
||||
- 用例复制：新建用例时可考虑复制一条步骤类似的用例，再修改对应步骤。
|
||||
- 用例删除：逻辑删除，可在数据库对应表中恢复。
|
||||
- 用例执行：执行单条用例。可查看对应执行记录、截图、或重跑用例。
|
||||
|
||||
|
||||
### 4.用例集管理：
|
||||
|
||||
- 用例集（test suite）对应一个测试范围，可关联多个不同的用例。
|
||||
- 执行用例集时会根据设置的并发数进行并发执行，提高测试效率。
|
||||
- 用例集中的用例是从测试用例中复制而来，因此每个用例可以在多个不同的测试用例集中关联。
|
||||
- 用例集可重跑全部用例、重跑失败用例、重跑单条用例。 注意：重跑用例时，会自动从对应测试用例中加载最新的步骤。
|
||||
|
||||
|
||||
### 5.节点管理：
|
||||
- 节点：可加载多个selenium grid节点，系统根据当前可用节点的数量，分配用例进行执行。
|
||||
|
||||
### 6.步骤管理：
|
||||
- 步骤：现已对大部分常见步骤进行了封装。
|
||||
- 扩展封装：可根据需要进行扩展封装。
|
||||
- 可直接封装selenium的方法，请参考 刷新、前往、悬浮点击 等方法。
|
||||
- 可对selenium提供的方法进行二次封装，请参考 点击、填写、选择等方法。对应扩展代码可在 app/core/extend.py 文件中进行管理。
|
||||
|
||||
|
||||
——————————————————————————————————————————————————————————————————————————————————————
|
||||
# atx 部分说明
|
||||
## android 用例组织：
|
||||
样例：
|
||||
Android|com.your.packagename,点击|id@@com.your.packagename:id/btn_login,等待|2,点击|name@@GuestLogin,等待|5,截图,
|
||||
|
||||
## 已封装步骤：
|
||||
相关的步骤已封装在 app/core/atx_step.py 中，具体包括：
|
||||
|
||||
Android ： 打开指定已安装的app （通过包名）
|
||||
填写： type_text
|
||||
点击： click （by id/name/description/class）
|
||||
截图： take_screenshot
|
||||
|
||||
由于我测试的 app 功能较为简单，目前只封装了这几个方法，如果需要可增加封装对应的方法。
|
||||
|
||||
|
||||
|
||||
|
||||
## 1. 管理平台：
|
||||
基于flask进行开发，进行用例、用例集、步骤等的增删改查等功能。
|
||||
|
|
@ -157,91 +308,6 @@ docker run -e NODE_MAX_INSTANCES=10 -e NODE_MAX_SESSION=10 -d --net grid -e HUB_
|
|||
docker run -e NODE_MAX_INSTANCES=10 -e NODE_MAX_SESSION=10 -d --net grid -e HUB_HOST=selenium-hub selenium/node-chrome
|
||||
```
|
||||
|
||||
## 使用说明：
|
||||
|
||||
### 1. 新建用例：
|
||||
|
||||
用例步骤说明：
|
||||
- 每个用例步骤中通过逗号进行分隔。
|
||||
- 单个步骤的格式： 步骤名称+分隔符（|）+参数列表（参数间按@@进行分隔）。如：填写|id@@kw@@selenium， 表示步骤为“填写”，参数列表为“id、kw、selenium”。
|
||||
- 默认的参数含义：1：通过什么属性定位目标元素（可使用id、name、class、text、xpath、css等多种定位方式进行定位） 2：目标元素对应的属性值（如id = kw） 3：其他。
|
||||
- 例如：填写|id@@kw@@selenium： 代表通过 id = kw 查找到输入框，并输入 selenium 。
|
||||
|
||||
#### 1.1 用例初始化：
|
||||
初始化可以有以下方式：
|
||||
|
||||
- 指定浏览器类型，如 Chrome、 Firefox。 需要对应的selenium server支持。
|
||||
- 指定模拟手机型号， 如 Chrome|iPhone 6。目前只有 chrome 浏览器支持模拟手机。
|
||||
- 调用其他已封装的公共方法，如 公共方法|登录。 具体的公共方法格式与正常用例一致，但需要指定用例类型为 公共用例。
|
||||
- 公共方法支持嵌套，即一个公共方法里调用另一个公共方法。
|
||||
|
||||
##### 具体步骤说明请查看菜单：自动化测试-步骤说明。
|
||||
|
||||
#### 用例说明：
|
||||
例子：在百度中输入selenium，并验证查询结果是否正确。
|
||||
```
|
||||
Chrome,前往|http://www.baidu.com,填写|id@@kw@@selenium,点击|id@@su,验证|Web Browser Automation,截图
|
||||
```
|
||||
步骤解析：
|
||||
```
|
||||
- Chrome： 调用 Chrome driver 进行测试。
|
||||
- 前往|http://www.baidu.com ： 前往目标页。
|
||||
- 填写|id@@kw@@selenium ： 在 id 为 kw 的元素中输入 selenium。
|
||||
- 点击|id@@su ： 点击 id 为 su 的元素。
|
||||
- 验证|Web Browser Automation ： 验证页面中是否出现 ‘Web Browser Automation’ 的文字。
|
||||
- 截图： 对当前页面进行截图并保存。
|
||||
```
|
||||
|
||||
### 2.公共用例
|
||||
|
||||
某些公共的步骤，可以封装为公共方法进行调用：
|
||||
- 公共方法添加：新建用例，选择用例类型为 公共用例， 所属模块为public。
|
||||
- 公共方法调用：步骤： 公共方法|公共方法名， 如 公共方法|登录；公共方法|查询订单。
|
||||
|
||||
|
||||
### 3.用例管理：
|
||||
|
||||
还可对用例进行如下管理：
|
||||
- 用例查询
|
||||
- 用例复制：新建用例时可考虑复制一条步骤类似的用例，再修改对应步骤。
|
||||
- 用例删除：逻辑删除，可在数据库对应表中恢复。
|
||||
- 用例执行：执行单条用例。可查看对应执行记录、截图、或重跑用例。
|
||||
|
||||
|
||||
### 4.用例集管理：
|
||||
|
||||
- 用例集（test suite）对应一个测试范围，可关联多个不同的用例。
|
||||
- 执行用例集时会根据设置的并发数进行并发执行，提高测试效率。
|
||||
- 用例集中的用例是从测试用例中复制而来，因此每个用例可以在多个不同的测试用例集中关联。
|
||||
- 用例集可重跑全部用例、重跑失败用例、重跑单条用例。 注意：重跑用例时，会自动从对应测试用例中加载最新的步骤。
|
||||
|
||||
|
||||
### 5.节点管理：
|
||||
- 节点：可加载多个selenium grid节点，系统根据当前可用节点的数量，分配用例进行执行。
|
||||
|
||||
### 6.步骤管理：
|
||||
- 步骤：现已对大部分常见步骤进行了封装。
|
||||
- 扩展封装：可根据需要进行扩展封装。
|
||||
- 可直接封装selenium的方法，请参考 刷新、前往、悬浮点击 等方法。
|
||||
- 可对selenium提供的方法进行二次封装，请参考 点击、填写、选择等方法。对应扩展代码可在 app/core/extend.py 文件中进行管理。
|
||||
|
||||
|
||||
——————————————————————————————————————————————————————————————————————————————————————
|
||||
# atx 部分说明
|
||||
## android 用例组织：
|
||||
样例：
|
||||
Android|com.your.packagename,点击|id@@com.your.packagename:id/btn_login,等待|2,点击|name@@GuestLogin,等待|5,截图,
|
||||
|
||||
## 已封装步骤：
|
||||
相关的步骤已封装在 app/core/atx_step.py 中，具体包括：
|
||||
|
||||
Android ： 打开指定已安装的app （通过包名）
|
||||
填写： type_text
|
||||
点击： click （by id/name/description/class）
|
||||
截图： take_screenshot
|
||||
|
||||
由于我测试的 app 功能较为简单，目前只封装了这几个方法，如果需要可增加封装对应的方法。
|
||||
|
||||
|
||||
# 常见问题：
|
||||
### 1：没有可用的节点
|
||||
|
|
|
|||
Loading…
Reference in New Issue