logo资料库

robotframework中文.pdf

第1页 / 共174页
第2页 / 共174页
第3页 / 共174页
第4页 / 共174页
第5页 / 共174页
第6页 / 共174页
第7页 / 共174页
第8页 / 共174页
资料共174页,剩余部分请下载后查看
1 开始
1.1 简介
1.2 版权与许可证
1.3 安装和卸载
1.4 示例
2 创建测试文件
2.1 测试文件语法
2.2 创建测试用例
2.3 创建测试集
2.4 使用测试库
2.5 变量
2.6 创建用户关键字
2.7 资源和变量文件
2.8 高级特性
3 执行测试用例
3.1 基本应用
3.2 测试用例执行
3.3 后处理输出文件
3.4 配置测试用例执行
3.5 产生输出文件
4 扩展Robot Framework
4.1 创建测试库
4.2 远程库接口
4.3 使用监听器接口
4.4 使用内部 API
4.5 通过Java 使用 Robot Framework
5 附录
5.1 测试数据的变量设置
5.2 命令行选项
5.3 测试数据模板
5.4 支持工具
5.5 文档格式
5.6 时间格式
Robot Framework V2.5.3 用户指南 Robot Framework 用户指南 用户指南 用户指南 用户指南 Version 2.5.3 ········整理整理整理整理········ 耿立直耿立直耿立直耿立直 ········翻译翻译翻译翻译········ ········校对校对校对校对········ 黄志中黄志中黄志中黄志中 任星伟任星伟任星伟任星伟 黎守秀黎守秀黎守秀黎守秀 耿立直耿立直耿立直耿立直 国庆波国庆波国庆波国庆波 张晓红张晓红张晓红张晓红 黎守秀黎守秀黎守秀黎守秀 代锦秀代锦秀代锦秀代锦秀 耿立直耿立直耿立直耿立直 任星伟任星伟任星伟任星伟 ····译者注译者注译者注译者注···· 由于译者水平有限且有可能对Robot Framework理解不够深入,因此不能保证译文准确无误,敬 请各位读者谅解。如果您发现了译文中有错漏之处,也请您指出,哪怕是错别字也好,请将错漏之处 发送至huangzz_8011@163.com,谢谢。 2010 年年年年 12 月月月月 29 日日日日 第 1 / 174 页
目录目录目录目录 Robot Framework V2.5.3 用户指南 1.4 2.2 1.2 1.3 2.1 1.1 Robot Framework 用户指南 ....................................................................................................................................... 1 1 开始 ..................................................................................................................................................................... 6 简介 ..................................................................................................................................................... 6 1.1.1 为什么使用 Robot Framework.................................................................................................... 6 1.1.2 高层的架构 ................................................................................................................................. 7 1.1.3 屏幕截图 ..................................................................................................................................... 7 1.1.4 获取更多信息 ............................................................................................................................. 8 版权与许可证 ..................................................................................................................................... 9 安装和卸载 ......................................................................................................................................... 9 1.3.1 简介 ............................................................................................................................................. 9 1.3.2 安装必备条件 ........................................................................................................................... 10 1.3.3 安装 ........................................................................................................................................... 12 1.3.4 卸载 ........................................................................................................................................... 16 1.3.5 升级 ........................................................................................................................................... 16 范例 ................................................................................................................................................... 17 2 创建测试文件 ................................................................................................................................................... 17 测试文件语法 ................................................................................................................................... 17 2.1.1 文件和目录 ............................................................................................................................... 17 2.1.2 支持的文件格式 ....................................................................................................................... 18 2.1.3 测试数据表格 ........................................................................................................................... 25 2.1.4 解析测试数据的规则 ............................................................................................................... 25 创建测试用例 ................................................................................................................................... 29 2.2.1 测试用例语法 ........................................................................................................................... 29 2.2.2 变量使用 ................................................................................................................................... 31 2.2.3 测试用例的名称和文档注释 ................................................................................................... 34 2.2.4 给测试用例打标签 ................................................................................................................... 34 2.2.5 测试用例的 setup 和 teardown ............................................................................................... 36 2.2.6 测试模板 ................................................................................................................................... 37 2.2.7 不同的测试用例模式 ............................................................................................................... 39 创建测试集 ....................................................................................................................................... 41 2.3.1 测试用例文件 ........................................................................................................................... 41 2.3.2 测试集目录 ............................................................................................................................... 41 2.3.3 测试集的名称和文档注释 ....................................................................................................... 43 2.3.4 自由的测试集元数据 ............................................................................................................... 44 2.3.5 测试集的 setup 和 teardown .................................................................................................... 44 使用测试库 ....................................................................................................................................... 45 2.4.1 引入测试库 ............................................................................................................................... 45 2.4.2 给测试库定制名称 ................................................................................................................... 46 2.4.3 标准库 ....................................................................................................................................... 47 2.4.4 扩展库 ....................................................................................................................................... 50 第 2 / 174 页 2.3 2.4
Robot Framework V2.5.3 用户指南 2.5 2.7 2.8 2.6 变量 ................................................................................................................................................... 50 2.5.1 介绍 ........................................................................................................................................... 50 2.5.2 变量类型 ................................................................................................................................... 51 2.5.3 创建变量 ................................................................................................................................... 55 2.5.4 内建变量 ................................................................................................................................... 58 2.5.5 变量的优先级和范围 ............................................................................................................... 61 2.5.6 高级变量特性 ........................................................................................................................... 63 创建用户关键字 ............................................................................................................................... 66 2.6.1 使用关键字的语法 ................................................................................................................... 66 2.6.2 用户关键字名称和注释 ........................................................................................................... 67 2.6.3 用户关键字参数 ....................................................................................................................... 67 2.6.4 关键字名称嵌入参数 ............................................................................................................... 69 2.6.5 用户自定义关键字返回值 ....................................................................................................... 71 资源和变量文件 ............................................................................................................................... 71 2.7.1 资源文件 ................................................................................................................................... 72 2.7.2 变量文件 ................................................................................................................................... 73 高级特性 ........................................................................................................................................... 78 2.8.1 处理同名关键字 ....................................................................................................................... 78 2.8.2 超时 ........................................................................................................................................... 79 2.8.3 循环 ........................................................................................................................................... 82 2.8.4 条件执行 ................................................................................................................................... 86 2.8.5 多个关键字的并行执行 ........................................................................................................... 86 3 执行测试用例 ................................................................................................................................................... 87 基本应用 ........................................................................................................................................... 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.1.8 调试 ........................................................................................................................................... 95 测试用例执行 ................................................................................................................................... 96 3.2.1 执行流程 ................................................................................................................................... 96 3.2.2 失败继续执行 ........................................................................................................................... 98 3.2.3 停止测试执行 ........................................................................................................................... 99 后处理输出文件 ............................................................................................................................. 100 3.3.1 使用 rebot 工具....................................................................................................................... 100 3.3.2 产生不同的报告和日志文件 ................................................................................................. 100 3.3.3 合并输出文件 ......................................................................................................................... 101 配置测试用例执行 ......................................................................................................................... 101 3.4.1 选择测试用例 ......................................................................................................................... 101 3.4.2 设置关键级别 ......................................................................................................................... 103 3.4.3 设置元数据 ............................................................................................................................. 104 3.2 3.1 3.3 3.4 第 3 / 174 页
Robot Framework V2.5.3 用户指南 4.1 3.4.4 设置库的搜索路径 ................................................................................................................. 104 3.4.5 设置变量 ................................................................................................................................. 105 3.4.6 静态检查(Dry Run) ............................................................................................................ 106 3.4.7 随机顺序执行 ......................................................................................................................... 106 3.4.8 控制显示器输出 ..................................................................................................................... 106 3.4.9 设置监听 ................................................................................................................................. 107 产生输出文件 ................................................................................................................................. 107 3.5.1 不同的输出文件 ..................................................................................................................... 107 3.5.2 日志级别 .................................................................................................................................. 112 3.5.3 分割输出文件 .......................................................................................................................... 113 3.5.4 配置统计数据 .......................................................................................................................... 116 4 扩展 Robot Framework ................................................................................................................................... 120 创建测试库 ..................................................................................................................................... 120 4.1.1 介绍 ......................................................................................................................................... 120 4.1.2 创建测试库 Class 或者 Module ............................................................................................. 121 4.1.3 创建静态关键字 ..................................................................................................................... 125 4.1.4 与 Robot Framework 通信 ...................................................................................................... 132 4.1.5 发布测试库 ............................................................................................................................. 136 4.1.6 动态库 API .............................................................................................................................. 139 4.1.7 混合库 API .............................................................................................................................. 143 4.1.8 使用 Robot Framework 内部模块 .......................................................................................... 145 4.1.9 扩展已存在的测试库 ............................................................................................................. 146 远程库接口 ..................................................................................................................................... 148 4.2.1 介绍 ......................................................................................................................................... 148 4.2.2 使用远程库 ............................................................................................................................. 149 4.2.3 支持的参数和返回值的类型 ................................................................................................. 150 4.2.4 使用远程 Server ...................................................................................................................... 150 Remote 协议 ............................................................................................................................ 152 4.2.5 使用监听器接口 ............................................................................................................................. 153 4.3.1 使用监听器 ............................................................................................................................. 153 4.3.2 可用的监听器接口方法 ......................................................................................................... 154 4.3.3 监听器例子 ............................................................................................................................. 157 使用内部 API .................................................................................................................................. 160 4.4.1 运行测试数据 ......................................................................................................................... 160 4.4.2 测试执行 ................................................................................................................................. 161 4.4.3 解析测试数据 ......................................................................................................................... 161 4.4.4 可运行的测试数据 ................................................................................................................. 162 4.4.5 配置日志 ................................................................................................................................. 162 通过 Java 使用 Robot Framework .................................................................................................. 162 4.5.1 通过 API 运行测试 ................................................................................................................. 162 5 附录 ................................................................................................................................................................. 163 测试数据的变量设置 ..................................................................................................................... 163 5.1.1 初始化设置表 ......................................................................................................................... 163 5.1.2 测试用例表 ............................................................................................................................. 164 4.2 4.3 3.5 4.4 4.5 5.1 第 4 / 174 页
Robot Framework V2.5.3 用户指南 5.2 5.3 5.4 5.5 5.6 5.1.3 关键字表 ................................................................................................................................. 164 命令行选项 ..................................................................................................................................... 164 5.2.1 用例执行的命令行选项 ......................................................................................................... 164 5.2.2 后处理输出结果时的命令行选项.......................................................................................... 167 测试数据模板 ................................................................................................................................. 169 支持工具 ......................................................................................................................................... 170 5.4.1 内部工具 ................................................................................................................................. 170 5.4.2 扩展工具 ................................................................................................................................. 171 文档格式 ......................................................................................................................................... 171 5.5.1 换行 ......................................................................................................................................... 171 5.5.2 粗体和斜体 ............................................................................................................................. 172 5.5.3 URLs ........................................................................................................................................ 172 5.5.4 表格 ......................................................................................................................................... 173 5.5.5 水平标尺 ................................................................................................................................. 173 时间格式 ......................................................................................................................................... 173 5.6.1 数字格式的时间 ..................................................................................................................... 173 5.6.2 文本格式的时间 ..................................................................................................................... 173 第 5 / 174 页
Robot Framework V2.5.3 用户指南 1 开始开始开始开始 1.1 简介简介简介简介 Robot Framework 是一种基于 Python 的可扩展关键字驱动自动化测试框架,通常用于端到端的可接收测试和 可接收测试驱动的开发。可以用于测试声明涉及到多种技术和接口的分布式的,异构的应用系统。 1.1.1 为什么使用 为什么使用 Robot Framework 为什么使用 为什么使用  易于使用:它采用一种表格式的语法,易于创建统一格式的测试用例。  重用性好:可以重复利用已经存在的关键字来创建高层次关键字。  结果报告和日志采用 HTML 格式,易于阅读。  平台与被测系统应用程序相互独立。  提供了简单的库函数 API 用于创建用户自定义的基于 Python 或者 Java 的测试库,这些测试库可以被应 用于本地应用。  为已经存在的构建设施(持续集成系统)提供了命令行接口和基于 XML 的输出文件。  为 Selenium 提供支持用户 WEB 测试,Java GUI 测试,启动进程,终端,SSH 等等。  支持创建基于数据驱动的测试用例。  Built-in 支持不同环境下的特殊变量。  提供标签以分类和选择将被执行的测试用例。  源文件易于集成:测试集就是指可以被产品代码描述的文件和路径。  提供测试用例和测试集级别的 setup 和 teardown。  模块化的结构甚至支持为有多种接口的应用程序创建测试数据。 第 6 / 174 页
1.1.2 高层的架构 高层的架构 高层的架构 高层的架构 Robot Framework 是一种通用的,应用和技术相互独立的框架。是一种如下图所示的模块化结构。 Robot Framework V2.5.3 用户指南 Robot Framework architecture 测试数据以一种简单易于编辑的表格格式。当 Robot Framework 启动的时候,启动测试数据,执行测试用例 并且生成日志和报告。核心框架不知道任何关于被测目标系统的细节,核心框架句柄与被测系统通过测试 库进行交互。测试库能够直接使用应用程序接口或者使用更低层次的测试工具作为驱动。 1.1.3 屏幕截屏幕截屏幕截屏幕截图图图图 以下屏幕截图展示了测试数据和创建的报告和日志的例子。 测试用例文件 第 7 / 174 页
Robot Framework V2.5.3 用户指南 报告和日志 1.1.4 获取更多 获取更多信息信息信息信息 获取更多 获取更多 工程页面 工程页面 工程页面工程页面 获取更多关于 Robot Framework 信息的网址 http://robotframework.org. 用户指导手册当然能够在哪里获取,你也可以找到更多的文档,一个版本跟踪器,下载,源代码和其他相 关工程的一些链接。Robot Framework 被托管于为开源项目提供优秀免费服务的谷歌代码。 邮件列表 邮件列表 邮件列表邮件列表 这里有大量你可以获取更多关于 Robot Framework 信息的邮件列表。邮件列表档案对每个人都开放(包括搜 索引擎)并且每个人都可以免费加入这个列表中。只有列表中的成员能够发送邮件,然而为了阻止垃圾邮 件,新用户注册比较缓慢,这就意味着在你的第一条消息通过之前会花一定的时间。不要害怕发送问题到 邮箱列表中,但是记住怎么用一种巧妙的方式咨询问题。 Robot Framework-用户 通常讨论关于 Robot Framework 相关的问题。疑问和难题都可以发送到这个邮件列表。所有用户将分享这些 信息。 Robot Framework-公告 一个只读公告邮件列表仅有管理员能够发送消息。所有公告被发送到 Robot Framework 的用户邮件列表当 中,所有没必要同时加入两个列表中。 第 8 / 174 页
分享到:
收藏