介绍
sweetest 是一款 Web 自动化测试框架，或者说是解决方案，名字取 Selenium, Web UI, Excel, Element, Test 含义。
特点:
- 简单快速，轻松上手
- 无需编码能力
- 在 Excel 中以文本编写测试用例
- 维护成本低
- 支持千、万级别的用例规模
- 拥抱变化，支持敏捷
背景
目前，Web 自动化测试基本上是以 Selenium 为接口来编写测试代码，但效果往往不是很好，普遍遇到如下问题：
- 用例设计人员的编码能力很弱，测试代码编写和维护成本高，效果差；
- 测试代码量大，测试意图不直观，无法支撑千、万级别的用例规模；
- Web 页面元素的定位非常繁琐，且页面结构经常变动，导致用例失效。
我们知道，传统的测试用例一般是在 Excel 中用文本编写的，如果自动化测试用例也这么写，是不是就可以解决问题1和2？
对于问题3，我想是时候对开发提出一些要求了，同时我们的元素定位也要优化，让页面自由的去变化，而我们的定位只做最小适用。
实现思路
- Selenium 为底层接口；
- 在 Excel 中用文本编写测试用例；
- 元素定位表格化，且优先使用“板块通用定位法”；
- 要求开发提供必要的、统一的元素属性；
- 框架负责解析测试用例，执行用例，记录日志，输出测试结果。
方案
- 开发语言：Python
- 底层接口：Selenium
- 用例工具：Excel
测试用例如下图：
安装
环境要求
- 系统要求：Windows
- Python 版本：3.6+
- Selenium
- 浏览器：Chrome
- Chrome 驱动: chromedriver
安装 sweetest
pip install sweetest
快速体验
打开 cmd 命令窗口，切换到某个目录，如：D:Autotest
sweetest
cd sweetest_sample
python start.py
OK，如果一切顺利的话，sweetest 已经跑起来了
目录结构
| 目录 | 说明 |
|---|---|
| element\ | 页面元素表目录 |
| Baidu-Elements.xlsx | 页面元素表，名称格式：project_name + “-Elements.xlsx” |
| junit\ | junit格式测试结果目录 |
| log\ | 自动化测试运行日志目录 |
| report\ | Excel 格式测试结果目录 |
| snapshot\ | 错误截图目录 |
| testcase\ | 测试用例目录 |
| Baidu-TestCase.xlsx | 测试用例，名称格式：project_name + “-TestCase.xlsx” |
| start.py | 启动脚本，test = Autotest(project_name, sheet_name) |
备注：以上3处的 project_name 必须一致
页面元素表
页面元素表的作用主要是把元素定位独立出来，一是方便维护定位信息，二是测试用例中用元素名称书写，可读性更高。
| 目录 | 注释 |
|---|---|
| page | element 所在的页面，在所有页面都可用的 element 放在“通用”下面，如 title |
| frame | element 所在的 frame id，如果是顶层 frame，可为空。 |
| name | element 名称，在不同的 page 下面可以同名 |
| by | Selenium 定义方式 |
| value | Selenium 定义的值 |
| 备注 | 注释作用 |
元素定位
id, link_text, partial_link_text, xpath, class_name
如：
page name by value 百度搜索页面 搜索框 id kw 则自动化运行时会以
find_element_by_id('kw')来定位带变量的定位方式
如示例中：
page name by value 百度搜索页面 搜索结果# xpath //*[@id=”#”]/h3/a 写用例时，需要在 搜索结果# 后面带上变量，如： 搜索结果#1
操作 页面 元素 点击 百度搜索页面 搜索结果#1 则自动化运行时会以
find_element_by_xpath('//*[@id="1"]/h3/a')来定位已定义好的常用变量定位方式：
- id#
- link#
- *link#
- xpath#
- class#
- name#
- url#
如：
url#www.baidu.com当然，如果#后面的变量不够直观的话，不建议太多使用这几个变量方式。
- 页面标题
页面的 title
页面URL
页面的 url
一般来讲，导航栏在所有页面都存在，应该把导航栏放在“通用”下面，做成变量定位方式，如示例中的：
page name by value 通用 搜索页导航栏# xpath //*[@class=”s_tab”]//a[text()=”#”] 用例中的写法：
操作 页面 元素 点击 通用 搜索页导航栏#新闻
测试用例
下拉菜单配置
操作、页面、元素这些列其实都是选项列表，利用 Excel 的下拉菜单功能，能够让书写用例更方便，且不易笔误。
下图是测试用例文件中的 ElementsMap 页面：
我们可以通过 Excel 的菜单栏“公式-名称管理器”来配置这些菜单，同时在用例页面通过“数据-数据有效性”配置好“操作”的下拉菜单，以及“页面-元素”的二级联动下拉菜单。
用例字段
必填字段：
- 用例编号
- 步骤编号
- 操作
- 页面
- 元素
前置条件：
- BASE： 整个测试套件的基础，必须通过才会执行下一步，如：登录；如果有的话应该为第一个测试用例。
- SETUP：每个测试用例执行前需要执行的用例，只有 SETUP 执行成功才会执行该用例，如：返回首页。
- MAIN：一组用例的第一用例，和 SUB 一起使用，一个 MAIN 后面可以带多个连续的 SUB 用例。此用例需要先执行 SETUP 用例。
- SUB：和 MAIN 一起使用，当前一个用例(MAIN or SUB)执行结果为通过时才会执行，否则测试结果置为 Blocked；且执行此用例前不会执行 SETUP 用例。
- SNIPPET：用例片段，运行到此用例时不会立即执行，需要在其他用例中使用“执行”关键字调用此“用例片段”，才会执行；配合“执行”关键字的变量赋值功能，可以实现用例复用。
注意事项：
- 一般必须有 SETUP 用例。当执行 SETUP 失败，会尝试执行一次 BASE->SETUP 作为 SETUP 的执行结果。
- BASE 用例可以有 0 到多个，但作为 SETUP 中 BASE->SETUP 的 BASE 只有最后一个 BASE 用例。
- SETUP 用例只能有 1 条，如果写了多条，只有最后一条起作用。
操作(关键字)及对应的测试数据
- 打开
即
get方法，打开一个链接。打开操作，一般要在测试数据中指定新窗口名称，如：新窗口=百度搜索窗口。
检查
取页面元素的值、属性和预期结果对比。
测试数据中如果没有写“k=v”的方式，则默认是取元素的 text。
- 检查 text：
操作 页面 元素 测试数据 检查 百度搜索页面 搜索按钮 百度一下 等价于
操作 页面 元素 测试数据 检查 百度搜索页面 搜索按钮 text=百度一下 - 检查属性：
操作 页面 元素 测试数据 检查 百度搜索页面 搜索框 name=wd - “页面标题”和“页面URL”直接在测试数据中写预期结果即可。
操作 页面 元素 测试数据 检查 百度搜索页面 页面标题 百度一下，你就知道 注意：测试数据中，由于逗号(，or ,)是多个“k=v”的分隔符，所以如果 v 中有逗号，要用反斜杠(\)转义；但等号(=)无需转义。
- 输入
在输入框中输入文本。
测试数据列为要输入的内容。
点击
点击按钮或者链接等(一切可点击操作的)元素。此关键字支持在同一个页面上顺序点击多个元素，在元素列以竖杠(|)分割即可，如：
操作 页面 元素 点击 百度搜索页面 搜索按钮|搜索结果#1 - 移动到
有些页面元素，当鼠标移动到上面时，会弹出下拉菜单等。此操作同关键字“点击”类似。
执行
即执行测试用例片段，支持在测试数据中给变量赋值，如我们有用例片段 SNIPPET_001，则测试用例 BAIDU_002 中，步骤1如下：
操作 页面 元素 测试数据 执行 用例片段 SNIPPET_001 keywords=搜狗 把变量 keyswords 赋值为“搜狗”，此步骤会执行用例片段 SNIPPET_001，其搜索的关键字为“搜狗”。
检查
把检查结果反向，此关键字暂时未完整实现。
测试数据：
测试数据支持模糊匹配，如下：
| 操作 | 页面 | 元素 | 测试数据 |
|---|---|---|---|
| 检查 | 通用 | 页面标题 | *知乎 |
则，页面标题中含有“知乎”即为通过。注意星号(*)要写在开头。
输出数据：
在运行时，把元素的值或属性赋值给变量，此变量可以在之后的步骤中使用”<>”引用变量名。
| 操作 | 页面 | 元素 | 测试数据 | 输出数据 |
|---|---|---|---|---|
| 点击 | 百度搜索页面 | 搜索结果#1 | title=text | |
| 检查 | 通用 | 页面标题 | <title> | |
步骤编号：
除了控制语句符号外，步骤编号必须为数字，建议在 Excel 中设置为文本格式。
控制语句：
if then else
步骤编号 操作 页面 元素 测试数据 ^3 检查 通用 页面标题 *知乎 >4 点击 通用 link#登录 <5 点击 通用 link#注册机构号 ^ 表示 if 语句
> 表示 then 语句
< 表示 else 语句
if(^) 语句为真时，执行 then(>) 语句，为否时执行 else(<) 语句。无论后面有没有 then 或者 else 语句，不影响后续步骤执行。
then 语句 或者 else 语句，当不被执行时，测试结果为 ‘-‘，不影响测试用例结果和后续步骤执行。当执行时，和正常步骤一样，成功则继续，失败则该用例失败。
进阶
元素管理
测试用例中元素是以 page + name 为唯一标识，来页面元素表中查找定位信息的。因此，不同 page 下的元素 name 可以相同，但不能和“通用”下的相同。
测试用例中，如果 page 不为“通用”，当 <page> + name 查找不到，会继续以 “通用” + name 为标识符来查找。
“通用”是方便我们写页面元素表的，写用例时我们建议还是用 <page> 来代替“通用”，甚至有时候我们必须这么做。
窗口管理(页面，frame)
在浏览器中，有可能会打开多个标签页，我们叫它为窗口。当你新打开一个标签页时，你可以在测试数据中给它起个名字，格式为：新窗口=<window_name>, 如：
| 操作 | 页面 | 元素 | 测试数据 |
|---|---|---|---|
| 打开 | 通用 | 百度搜索链接 | 新窗口=百度搜索窗口 |
| 检查 | 百度搜索页面 | 页面标题 | 百度一下，你就知道 |
当你给新的标签页起了窗口名字，它之后步骤的页面(“通用”除外)就会绑定到这个窗口。如上面第 2 步，“百度搜索页面”会绑定到“百度搜索窗口”。那么之后的步骤或用例中，即使打开了多个标签页，只要页面是“百度搜索页面”，就会切换到“百度搜索窗口”这个标签页上操作。
注意：“通用”是不绑定到任何窗口的，也不做窗口切换，它直接在“当前窗口”操作。
“当前窗口”规则为：
- 执行到某个步骤时，“当前窗口”是浏览器焦点所在的窗口，也就是上个步骤执行操作的窗口。
- 如果此步骤的页面已绑定到其他窗口，则“当前窗口”会切换过去。
- 如果此步骤的页面尚未捆定任何窗口，则会捆定到“当前窗口”。
- 上个步骤如果是新打开的窗口，则“当前窗口”是新打开的窗口。
注意：
- 如果打开了 2 个或以上窗口，没有起名字的窗口，在执行到切换窗口的步骤时，会自动被关掉。
- 起了名字的窗口不会被关掉。
- 但如果起了同样的名字，则原先的那个窗口会被关掉，绑定在其上面的页面也会被注销。
测试执行
python start.py
测试报告
见 report 目录
QQ交流群：158755338 (验证码：python)
