Run
我一直在想 Robot Framework 不要 RIDE 可不可以。对于编写测试用例来说,只要掌握 Robot
Framework 的语法规则,随便在一个你顺手的编辑器下编写也没问题,甚至效率更高。为什么要填写那个该死的“表格”。
直到运行案例的时候我才意识到 RIDE 的好处。在 RIDE 中运行测试用例,就是勾选想要运行的用例,然后点击按钮即可。想想我们在做单元测试的时候可不会这么方便,调用 addTest()方法将一个个想要运行的测试方法添加到测试套件中,或者一行行的注释掉不添加到测试套件的测试用例的addTest()方法,这是个极其痛苦的过程。
Run 标签
下面是 Run 标签的截图:
第一眼看上去,Run 标签提供了丰富的操作和日志。按照截图我们依次来说明 Run 标签上的按钮和输入框的作用:
1)Execution Profile:选择运行方式,里面有 pybot、jybot 和 custom script。其中我们默认是用 pybot 来运行案例,pybot 的运行 Python 编译器完成。jybot 需要安装 Jython 的支持。custom script 是选择自定义的脚本来运行。
2)Start 和 Stop:用例的运行和停止。
3)Report 和 Log:报告和日志,要运行之后才能点击。他们之间的区别:报告更多是结果上的展示, 日志更多是过程的记录,在测试用例调试的过程中更多使用日志来查看执行错误。当只想知道测试用例的最终执行情况时用报告。
4)Autosave:自动保存,如果不勾选,在修改了用例之后如果没有保存的话,运行案例时会提示是否保存。勾选则在运行时自动保存了。
5)Arguments:pybot 的参数(或者 jybot 等),可以在这里输入 pybot 的命令完成相应的操作。
6)Only Run Tests with these Tags:只运行这些标记的测试案例。
7)Skip Tests with these Tags: 跳过这些标记的测试案例。
下面的两个区域,中间区域记录用例的执行过程,底部的区域输出用例的执行结果。
command: pybot.bat --argumentfile c:\users\fnngj\appdata\local\temp\RIDEg0ek6m.d\argfile.txt --listener
C:\Python27\lib\site-packages\robotide\contrib\testrunner\TestRunnerAgent.py: 63009:False D:\robot\测试项目
=================================================================
测试项目
=================================================================
测试项目.测试套件
=================================================================
test case | PASS |
-----------------------------------------------------------------
test case2 | PASS |
-----------------------------------------------------------------
test case3 | PASS |
-----------------------------------------------------------------
测试项目.测试套件 | PASS |
3critical tests, 3 passed, 0 failed
3 tests total, 3 passed, 0 failed
=================================================================
测试项目 | PASS |
3 critical tests, 3 passed, 0 failed
3 tests total, 3 passed, 0 failed
=================================================================
Output: c:\users\fnngj\appdata\local\temp\RIDEg0ek6m.d\output.xml Log:c:\users\fnngj\appdata\local\temp\RIDEg0ek6m.d\log.html Report: c:\users\fnngj\appdata\local\temp\RIDEg0ek6m.d\report.html
test finished 20150304 16:33:22
Starting test: 测试项目.测试套件.test case
20150304 16:33:22.639 :INFO : test1
Ending test:测试项目.测试套件.test case
Starting test: 测试项目.测试套件.test case2
20150304 16:33:22.643 :INFO : 小明 欢迎你第一次使用 Robot Framework。它的强大性和易用性相信会让你的测试工作变得更加简单可靠。
20150304 16:33:22.645 :INFO : 小红 欢迎你第一次使用 Robot Framework。它的强大性和易用性相信会让你的测试工作变得更加简单可靠。
Ending test:测试项目.测试套件.test case2
Starting test: 测试项目.测试套件.test case3 20150304 16:33:22.649 :INFO : 小明
20150304 16:33:22.652 :INFO : 小红
20150304 16:33:22.654 :INFO : 小华
20150304 16:33:22.657 :INFO : 小刚
Ending test:测试项目.测试套件.test case3
运行与停止
在 Run 标签页提供了运行与停止的按钮,使用很简单。可是你知道到点击“运行”按钮的时候,Robot
Framework 是怎么执行“测试套件.txt”文件的么?点击“停止”按钮的时候,Robot Framework 又做了什么操作来终止用例的执行的?带着这样的疑问,我们来简单的读一下 RIDE 的 run 代码。
首先打开 C:\Python27\Lib\site-packages\robotide\run 目录下的 process.py 文件。
import os import time import tempfile
import subprocess
class Process(object):
……
def start(self):
self._out_fd, self._out_path = \
tempfile.mkstemp(prefix='rfproc_', suffix='.txt', text=True)
self._out_file = open(self._out_path) if not self._command:
self._error = 'The command is missing from this run configuration.' return
try:
self._process = subprocess.Popen(self._command, stdout=self._out_fd,
stderr=subprocess.STDOUT)
except OSError, err: self._error = str(err)
……
def stop(self): try:
self._process.kill() except AttributeError:
raise AttributeError('Stopping process is possible only with ' 'Python 2.6 or newer')
……
def get_output(self, wait_until_finished=False): """Returns the output produced by the process.
If ``wait_until_finished`` is True, blocks until the process is finished and returns all output. Otherwise the currently available output is returned immediately.
Currently available output depends on buffering and might not include everything that has been written by the process.
"""
if self._error: self._close_outputs() return self._error
if wait_until_finished: self._process.wait()
output = self._out_file.read() if self.is_finished():
self._close_outputs() return output
def _close_outputs(self): self._out_file.close() os.close(self._out_fd) self._remove_tempfile()
以上为 process.py 文件的部分代码。看有标蓝的代码即可。
首先看 start()方法,通过 tempfile 模块的 mkstemp()方法找到“txt”文件,也就是“测试套件.txt”文这类件。接着通过 open()方法打开。
在 get_output()方法中通过 read()方法来读取“txt”文件。最后把读取的文件的赋值给变量 output 并返
回。
在_close_outputs()方法中通过 close()关闭打开的“txt”文件。
停止测试用例的执行非常单间,由 stop()方法实现,通过调用 kill()将用例的执行进程杀死。
代码读到这里只是开始,get_output()方法读到的文件返回给谁了呢?或者谁会调用 get_output()方法呢?继续打开 C:\Python27\Lib\site-packages\robotide\run 目录下的 ui.py 文件
……
from robotide.run.process import Process
……
class Runner(wx.EvtHandler):
def init (self, config, notebook): wx.EvtHandler. init (self) self.Bind(wx.EVT_TIMER, self.OnTimer) self.name = config.name
self._timer = wx.Timer(self) self._config = config
self._window = self._get_output_window(notebook)
def _get_output_window(self, notebook): return _OutputWindow(notebook, self)
def run(self):
self._process = Process(self._config.command) self._process.start()
self._timer.Start(500)
def OnTimer(self, event=None):
finished = self._process.is_finished() self._window.update_output(self._process.get_output(), finished) if finished:
self._timer.Stop()
def stop(self): try:
self._process.stop() except Exception, err:
wx.MessageBox(str(err), style=wx.ICON_ERROR)
……
ui.py 文件调用 process.py 文件的方法来运行测试用例。如果读者精通于 Python 语言的话可以顺着这条线继续读下去,看看哪个方法会调用 Runer 类。因为本文档的重点的不是分析 Robot Framework 代码,所以不在再继续。但这里想传达的思路是知其然,一定要知其所以然;用工具而不要受制于工具。