Robot Framework 2.5.3 用户指南中文版

Robot Framework 用户指南 ....................................................................................................................................... 1

1 开始 ..................................................................................................................................................................... 6

1.1.1 为什么使用 Robot Framework.................................................................................................... 6

1.1.2 高层的架构 ................................................................................................................................. 7

1.1.3 屏幕截图 ..................................................................................................................................... 7

1.1.4 获取更多信息 ............................................................................................................................. 8

1.3.5 升级 ........................................................................................................................................... 16

2 创建测试文件 ................................................................................................................................................... 17

2.1.1 文件和目录 ............................................................................................................................... 17

2.1.2 支持的文件格式 ....................................................................................................................... 18

2.1.3 测试数据表格 ........................................................................................................................... 25

2.1.4 解析测试数据的规则 ............................................................................................................... 25

2.2.1 测试用例语法 ........................................................................................................................... 29

2.3.1 测试用例文件 ........................................................................................................................... 41

2.3.2 测试集目录 ............................................................................................................................... 41

2.3.3 测试集的名称和文档注释 ....................................................................................................... 43

2.3.4 自由的测试集元数据 ............................................................................................................... 44

2.3.5 测试集的 setup 和 teardown .................................................................................................... 44

2.4.1 引入测试库 ............................................................................................................................... 45

2.4.2 给测试库定制名称 ................................................................................................................... 46

2.4.3 标准库 ....................................................................................................................................... 47

2.5.5 变量的优先级和范围 ............................................................................................................... 61

2.5.6 高级变量特性 ........................................................................................................................... 63

2.6.1 使用关键字的语法 ................................................................................................................... 66

2.6.2 用户关键字名称和注释 ........................................................................................................... 67

2.6.3 用户关键字参数 ....................................................................................................................... 67

2.6.4 关键字名称嵌入参数 ............................................................................................................... 69

2.6.5 用户自定义关键字返回值 ....................................................................................................... 71

2.7.1 资源文件 ................................................................................................................................... 72

2.8.5 多个关键字的并行执行 ........................................................................................................... 86

3 执行测试用例 ................................................................................................................................................... 87

3.1.1 启动测试用例执行 ................................................................................................................... 87

3.1.2 命令行参数 ............................................................................................................................... 88

3.1.3 测试结果 ................................................................................................................................... 89

3.1.4 转义复杂字符 ........................................................................................................................... 91

3.1.5 参数文件 ................................................................................................................................... 92

3.1.6 获得帮助和版本信息 ............................................................................................................... 93

3.1.7 编写启动脚本 ........................................................................................................................... 93

3.3.1 使用 rebot 工具....................................................................................................................... 100

3.3.2 产生不同的报告和日志文件 ................................................................................................. 100

3.3.3 合并输出文件 ......................................................................................................................... 101

3.4.1 选择测试用例 ......................................................................................................................... 101

3.4.2 设置关键级别 ......................................................................................................................... 103

3.4.3 设置元数据 ............................................................................................................................. 104

3.4.9 设置监听 ................................................................................................................................. 107

3.5.1 不同的输出文件 ..................................................................................................................... 107

3.5.2 日志级别 .................................................................................................................................. 112

3.5.3 分割输出文件 .......................................................................................................................... 113

3.5.4 配置统计数据 .......................................................................................................................... 116

4 扩展 Robot Framework ................................................................................................................................... 120

4.1.1 介绍 ......................................................................................................................................... 120

4.1.2 创建测试库 Class 或者 Module ............................................................................................. 121

4.1.9 扩展已存在的测试库 ............................................................................................................. 146

4.2.1 介绍 ......................................................................................................................................... 148

4.2.2 使用远程库 ............................................................................................................................. 149

4.2.3 支持的参数和返回值的类型 ................................................................................................. 150

4.2.4 使用远程 Server ...................................................................................................................... 150

4.2.5 Remote 协议 ............................................................................................................................ 152

4.3.1 使用监听器 ............................................................................................................................. 153

4.3.2 可用的监听器接口方法 ......................................................................................................... 154

4.4.5 配置日志 ................................................................................................................................. 162

4.5.1 通过 API 运行测试 ................................................................................................................. 162

5 附录 ................................................................................................................................................................. 163

5.1.1 初始化设置表 ......................................................................................................................... 163

5.1.2 测试用例表 ............................................................................................................................. 164

5.4.1 内部工具 ................................................................................................................................. 170

5.4.2 扩展工具 ................................................................................................................................. 171

5.5.1 换行 ......................................................................................................................................... 171

5.5.2 粗体和斜体 ............................................................................................................................. 172

5.5.3 URLs ........................................................................................................................................ 172

5.5.4 表格 ......................................................................................................................................... 173

5.5.5 水平标尺 ................................................................................................................................. 173