#################################################################
#author: 陈月白
#_blogs: http://www.cnblogs.com/chenyuebai/
#################################################################
一、环境搭建
概览：win 7+ python 3.6 + pycharm + robotframework + IntelliBot + fireFox
1.安装相关的库
推荐使用pip安装，如 pip install robotframework(以及selenium2library)
研发环境没外网，采用离线安装，down包后解压--进入--python setup.py install
（1）WEB页面测试：
https://pypi.python.org/pypi/robotframework
https://pypi.python.org/pypi/selenium#downloads #依赖包
https://pypi.python.org/pypi/robotframework-seleniumlibrary #依赖包
https://pypi.python.org/pypi/robotframework-selenium2library
（2）接口测试：
在线：pip install requests
离线：
https://pypi.python.org/pypi/certifi #依赖包
https://pypi.python.org/pypi/urllib3#downloads #依赖包
https://pypi.python.org/pypi/idna#downloads #依赖包
https://pypi.python.org/pypi/chardet/#downloads #依赖包
https://pypi.python.org/pypi/requests#downloads
- - - -
若想安装RIDE（界面编辑工具）需安装：
1.six https://pypi.python.org/simple/six/ 1.6.0 wxPython安装依赖
2.wxPython： https://pypi.python.org/pypi/wxPython -- wxPython-4.0.0-cp36-cp36m-win_amd64.whl (md5, pgp)
3.发现RIRE不支持python3.X。。。打扰了
2.pycharm
开发IDE， 略
3.IntelliBot pycharm开发插件【语法高亮】
方法1：pycharm>File>setting>Plugins>Browse reponsitories
方法2：https://plugins.jetbrains.com/plugin/7386-intellibot 下载至本地
pycharm>File>setting>Plugins>install plugin from disk
4.pycharm配置执行器
File>setting>Tools>External tool，配置完成后即可在.robot文件中选择使用该执行器执行
Parameters：当前文件路径
Working directory：工作路径，日志、结果输出等，如下：
注：log.html 执行日志
output.xml 执行相关信息的xml，可用于后续二次解析
report.xml 执行结果报表
5.fireFox浏览器及对应驱动
（1）浏览器
https://www.mozilla.org/zh-CN/firefox/developer/
（2）驱动
https://github.com/mozilla/geckodriver/releases/download/v0.19.1/geckodriver-v0.19.1-win64.zip
解压（geckodriver.exe）拷贝至python安装目录
二、使用cmd执行
运行一条用例：
pybot --test test_case test_suit.robot
运行指定文件：
pybot test_suit.robot
运行当前目录下以.robot为后缀名的测试文件
pybot *.robot
运行当前testpath目录下的所有用例
pybot testpath
三、案例脚本（.robot文件）基本语法
1.基本语法
*** Settings ***
Library MyLib #导入自定义的库
Library SeleniumLibrary *** Test Cases ***
#第一行为固定格式，标识
#建议同python一致，使用tab缩进对齐(pycharm中设置tab=4空格)，否则可能报执行失败，报 "Test case contains no keywords"
case1 helloworld #案例名
log chenyuebai first rfw case #log 相当于python的print，可在生成的log.xml中查看 case 2 log #打异常日志，支持多种级别
log test line 2 ERROR case 3 varible
${myname} Set variable chen #定义变量
log my name is ${myname} #使用变量 #case 4 use varible #变量作用域为其定义所在的案例（case3），否则报"Variable '${myname}' not found."
# log ${myname} case 5 Catenate
${hi1} Catenate hello world #定义变量方式2 连接两个对象，支持自定义连接符
log ${hi1}
${hi2} Catenate SEPARATOR=---- hello world
log ${hi2} case 6 list
@{mylist} create list a b c #定义列表
log many @{mylist} #打印列表中的元素 case 7 get time
${currentTime} get time #获取当前时间 2018-01-02 18:05:47
log ${currentTime}
${currentYear} get time format=year #支持多种传参，详情看函数定义
log current year is ${currentYear} case 8 sleep
log get time
sleep 1 #睡眠，等同于python的time.sleep(5)
log get time case 9 if
${score} set variable 55
run keyword if ${score}>=90 log 优秀
... ELSE IF ${score}>=70 log 良好 #ELSE/ELSE IF要大写。。。语法很蛋疼。。为啥不直接套用python的语法。。
... ELSE log 很差 # ... 不知道基于什么考虑的。。看起来像是标识属于“run keyword if”这个判断逻辑；类似python的tab？ case 10 for #for循环，注意需要使用\来标识这个for循环范围，感觉和上面的...类似
:FOR ${i} IN RANGE 5 # for in in range(5):
\ log ${i} # print(i) case 11 allround the list
@{myList} create list 1 2 3 4 # myList = [1,2,3,4]
:FOR ${i} IN @{myList} # for i in myList:
\ log ${i} # print(i) case 12 Evauate #调用python中的方法，很强大
${randomNum} EVALUATE random.random() random #变量 关键字EVALUATE 调用python的方法 方法所在的库名
log ${randomNum} case 13 call my python #导入自定义库，下面有详细说明
${nowTime} get current time
log ${nowTime} case 14 Comment
log start
#line 1
comment line 2 #标明注释：使用关键字或者#均可
log end case 15 Selenium2Library #Selenium2Library库，操作浏览器，可作web界面自动化，待细化
open_browser http://www.baidu.com firefox
Input text id=kw 陈月白
click button id=su
sleep 3
close Browser
2.robot文件中调用自定义库
Selenium2Library提供了很多的方法，但在实际使用中仍有部分场景需要自行编写，robotFramework支持导入用户自定义的库。
需注意文件名、类名的对应关系，否则会导入库失败；
在...\python安装路径\Lib\site-packages下：
（1）自定义方法所在的文件：MyKeywords.py
import time
class MyKeywords():
def __init__(self):
pass #获取当前时间
def get_current_time(self):
current_time = time.strftime('%Y-%m-%d %H:%M:%S',time.localtime(time.time()))
return current_time
（2）创建__init__.py
"""
继承自定义库中的类，rfw会解析类中的函数作为关键词
"""
from .MyKeywords import * class MyRobotFwkLib(MyKeywords):
ROBOT_LIBRARY_SCOPE = "GLOBAL"
（3）.robot文件导入自定义类，即可使用类中的方法
*** Settings ***
Library MyRobotFwkLib #导入自定义的库 case 13 call my python
${nowTime} get current time
log ${nowTime}
四、使用SeleniumLibrary库进行web界面自动化测试
#todo
20180126
- - - -
SeleniumLibrary提供很多基础关键字，基本可以模拟完成浏览器上大部分操作；
另外还支持将基础关键字按业务逻辑封装为高级关键字（可以理解为一个函数，下面有例子）；
支持指定多种浏览器，按元素标识操作元素；
定位元素工具我用的火狐的插件：firePath、fireBug，很方便；
基础关键字（SeleniumLibrary自带） + 高级关键字（按实际业务对基础关键字封装） + 用户自定义库中的关键字（上面有配置实例），几乎可以满足大多数web应用各种业务场景；
ps：调试时发现许多关键字无法查看定义，不方便看用法及传参，但实际执行时又没问题；
看了下SeleniumLibrary库的__init__.py，确定是因为多数涉及的关键字库，都是在启动执行时，初始化继承过来的；
于是笨方法，直接全量引入，目前来看也没什么影响。
实现项目后台登录及校验：
*** Settings ***
#方便IDE调试，不添加无法找到关键字定义
Library browsermanagement
Library AlertKeywords
Library BrowserManagementKeywords
Library CookieKeywords
Library ElementKeywords
Library FormElementKeywords
Library FrameKeywords
Library JavaScriptKeywords
Library RunOnFailureKeywords
Library ScreenshotKeywords
Library SelectElementKeywords
Library TableElementKeywords
Library WaitingKeywords
Library WindowKeywords Library SeleniumLibrary #配置套件级别的Setup和Teardown
Suite Setup
... log now test start 1 #只执行一条 Suite Teardown Run Keywords
... close all browsers AND #执行多条
... log now end 4 #全局变量
*** Variables ***
${loginPageUrl} http://10.XX.XX.232:9XX0/admin/index.do?index=1
${validUsername} admin
${validloginPasswd} adminpasswd *** Test Cases ***
case 1 correct login test
#配置用例级别的Setup和Teardown
[setup] log setup log 2
[teardown] log teardown log 3 correctLoginTest ${validUsername} ${validloginPasswd} #使用基础关键字封装出的高级关键字 #使用基础关键字封装高级关键字，类似python的一个函数，支持入参出参，很灵活
*** Keywords ***
correctLoginTest
[Arguments] ${uasename} ${passwd}
open browser ${loginPageUrl} firefox
setBrowser
input text xpath=html/body/div[1]/form/input[1] ${uasename}
input text xpath=html/body/div[1]/form/input[2] ${passwd}
click element class=submit
sleep 5
# ${page1_title} get title #获取页面title，可后续校验页面是否到达
# ${width} ${height} get window size #获取浏览器窗口大小
# select window NEW #切换到新弹出窗口（视图焦点）
page should contain element xpath=//*[@id='topMenu4'] #系统管理菜单
sleep 2
close all browsers setBrowser
set window size 1024 768 #设置浏览器窗口大小
maximize browser window #浏览器窗口最大化
sleep 1
20180201
- - - -
2018.02.06
五、数据驱动测试
数据驱动测试，适合相同流程、相同预期结果下，不同输入组合的测试
比如测试异常登录流程，用户名、密码在错误（或空）各种组合下的异常验证
例子：
*** Settings ***
Library SeleniumLibrary
Test Template errorLoginTest #公共逻辑 *** Variables ***
${loginPageUrl} http://10.XX.XX.232:9XX0/admin/index.do?index=1
${validUsername} admin
${validloginPasswd} adminpasswd *** Test Cases *** username passwd
#异常登录测试
case 2:Invalid Username invalidname ${validloginPasswd} case 3:Invalid Password ${validUsername} invalidPasswd case 4:Invalid Both invalidName invalidPasswd case 5:Empty Username ${EMPTY} ${validloginPasswd} case 6:Empty Password ${validUsername} ${EMPTY} case 7:Empty Both ${EMPTY} ${EMPTY} *** Keywords ***
errorLoginTest
[Arguments] ${uasename} ${passwd}
open browser ${loginPageUrl} firefox
input text xpath=html/body/div[1]/form/input[1] ${uasename}
input text xpath=html/body/div[1]/form/input[2] ${passwd}
click element class=submit
sleep 5
page should contain element class=submit 5 error:预期应含登录元素未找到【即跳转失败】
sleep 5
close all browsers
执行结果：
