gxnualbert / pyse

WebUI automation testing framework based on Selenium

pyse

WebUI automation testing framework based on Selenium

介绍： pyse基于selenium（webdriver）进行了简单的二次封装，比selenium所提供的方法操作更简洁。

特点：

• 所有方法只提供css定位，webdriver提供了8种定位方法（id\name\class name\tag name\link text\partial link text\xpath\css selector）但其实，我们使用xpath或css完全可以替代id\name\class name\tag name 等方法，本框架所提供的click_text()方法可以替代link text方法，在最版本中用css替换掉了xpath，原因是css语法更简洁。统一元素定位方法使代码看起来更具有一致性，当看到一个元素时不用再犹豫选择哪种定位方法，直接使用css就好了。
• 本框架只是对selenium（webdriver）原方法的简单封装，精简为30个方法，这些方法基本能够胜任于我们的web自动化测试。
• 基于nose单元测试框架，所以测试文件与测试方法遵循nose的命名规范。
• 集成了html测试报告生成。

安装及前提条件：

• Python2.7+ :https://www.python.org/
• selenium :https://pypi.python.org/pypi/selenium
• nose :https://pypi.python.org/pypi/nose
• nose-html-reporting:https://pypi.python.org/pypi/nose-html-reporting
• 安装pyse ,将其克隆到本地，将pyse目录放到..\Python27\Lib\site-packages\目录下即可

例子： 请查看demo目录

===================================================== # coding=utf-8 import pyse from time import sleep

def test_baidu():
  ''' baidu search key : pyse '''
  driver = pyse.Pyse("chrome")
  driver.open("http://www.baidu.com")
  driver.type("#kw","pyse")
  driver.click("#su")
  sleep(1)
  title = driver.get_title()
  assert title=="pyse_百度搜索"
  driver.quit()

if __name__ == '__main__':
  test_pro = pyse.TestRunner()
  test_pro.run()

========================================================== 运行测试用例说明：

• TestRunner() 默认匹配当前目录下"test*.py"的文件并执行。当然也可以指定测试目录，例如： TestRunner(r"D:/test_project/test_case")
• 执行run()方法运行测试用例

支持的浏览器及驱动：

Firefox:

driver = Pyse("firefox")  

或：

driver = Pyse("ff")

Chrome:

driver = Pyse("chrome")  

IE:

driver = Pyse("internet explorer")

或：

driver = Pyse("ie")

Opera:

driver = Pyse("opere")

PhantomJS:

driver = Pyse("phantomjs")

Chromedriver:https://sites.google.com/a/chromium.org/chromedriver/home

IEDriverServer:http://selenium-release.storage.googleapis.com/index.html

operadriver:https://github.com/operasoftware/operachromiumdriver/releases

phantomjs:http://phantomjs.org

==========================================================

元素定位：

关于元素的定位，经过权衡，抛弃了之前采用的xpath，而选择css，主要是因为css的语法写起来更简洁。

<form id="form" class="fm" action="/s" name="f">
  <span class="bg s_ipt_wr quickdelete-wrap">
    <input id="kw" class="s_ipt" autocomplete="off" maxlength="255" value="" name="wd">

==========================================================

id定位:

driver.type("#kw", "pyse")

==========================================================

class定位:

driver.type(".s_ipt", u"pyse")

==========================================================

name定位:

driver.type("[name=wd]", "pyse")
driver.type("[name='wd']", "pyse")

==========================================================

tag name定位:

driver.type("input", "pyse")
driver.type("span>input", "pyse")
driver.type("form>span>input", "pyse")

==========================================================

link text定位： click_text()方法可以做到这一点，例如，点击百度首页上的"新闻"链接。

driver.click_text("新闻")

==========================================================

css更封复杂的更定写法：

driver.type("span.bg s_ipt_wr>input.s_ipt","pyse")
driver.type("span.bg s_btn_wr>input#su","pyse")

==========================================================

css选择器参考手册： http://www.w3school.com.cn/cssref/css_selectors.asp nose基本用法： http://pythontesting.net/framework/nose/nose-introduction/