自动化测试 RobotFramework-ride使用相关总结-牛翰网

自动化测试 RobotFramework-ride使用相关总结

开发环境

win11 家庭中文版

Python 3.9.13

robotframework6.1.1

说明:为了方便的使用robot命令,安装好robotframwork后,修改系统环境,添加robot.exe(PYTHON_HOME/Scripts/robot.exe)所在路径到系统环境变量path

安装参考连接:https://github.com/robotframework/robotframework/blob/master/INSTALL.rst

说明:实践过程中有安装过更robotframework7.0.1,发现导入自定义库候,RIDE运行用例套件时会报类似如下错误:

[ ERROR ] Calling method 'log_message' of listener 'D:\Program Files (x86)\Python39\lib\site-packages\robotide\contrib\testrunner\TestRunnerAgent.py' failed: AttributeError: 'Output' object has no attribute '_xmllogger'

docutils-0.21.2-py3-none-any.whl

pip install docutils==0.21.2

robotframework-ride 2.0.8.1

依赖包:

numpy               2.0.0
pillow              10.3.0
Pygments            2.18.0
Pypubsub            4.0.3
pywin32             306
six                 1.16.0
wxPython            4.2.1

使用总结

安装ride

pip install robotframework-ride

运行ride

首次运行,可以通过执行以下命令开启RIDE GUI

cd %PYTHON_HOME%\Scripts
python ride.py

开启后,菜单 Tools -> Create RIDE Desktop Shortcut 创建桌面快捷方式,下次运行即可通过双击中快捷方式启动RIDE。

添加自定义类库

新建测试用例集

菜单File -> New Project,创建项目

右键上述创建的项目 -> New Suite 创建测试套件

右键上述创建的套件 -> New Test Case 创建测试用例

添加自定义类库

实践用到的Python项目工程根目录路径:D:\PyProjects\CustomLibrary

基于模块

项目工程代码组织结构如下:

CustomLibrary
    MyTestLib.py
    __init__.py

CustomLibrary/MyTestLib.py代码内容如下:

# -*- coding:utf-8 -*-

def example_keyword():
    print('example_keyword')

def key_word_func():
    print('key word function')

点击项目->Library -> Browse,选择模块脚本所在路径

说明:也可以不点击Browse按钮,直接在上图的Name输入框直接输入目标类库名称、路径

注意实践时发现,类库导入要在测试用例套件节点上设置,否则不起作用。类似的,资源导入也是如此

最终有效测试套件文本化编辑结果(TestSuite.robot文件内容)如下:

*** Settings ***
Library           ../CustomLibrary/MyTestLib.py

*** Test Cases ***
测试用例1
    example keyword
    key word func

问题:上图的Name输入框能不能简化为直接输入一个类库名称呢?

最终要实现的文本编辑效果如下:

*** Settings ***
Library           MyTestLib

答案是:可以的。

具体实现方法有3种:

  1. 方法1:编辑%PYTHON_HOME%\Lib\site-packages\pywin32.pth,在文件末尾添加类库模块所在目录路径(例中为D:\PyProjects\CustomLibrary),保存即可(不需要重启RIDE)。注意,pywin32这个文件中不能有中文,否则会导致python无法正常运行
  2. 方法2:编辑系统环境变量,新建PYTHONPATH环境变量,设置变量值为类库模块所在目录路径,保存即可(需要重启RIDE)。
  3. 方法3:RIDE -> Tools -> Preferences -> Importing, 设置Pythonpath输入框的值为类库模块所在目录路径(不需要重启RIDE)

基于类

项目工程代码组织结构如下:

CustomLibrary
    MyTestLib.py
    __init__.py

CustomLibrary/MyTestLib.py代码内容如下:

# -*- coding:utf-8 -*-

class MyLib():
    def example_keyword(self):
        print('example_keyword')
    
    def key_word_func(self):
        print('key word function')

最终有效测试套件文本化编辑结果(TestSuite.robot文件内容)如下:

*** Settings ***
Library           MyTestLib.MyLib

*** Test Cases ***
测试用例1
    example keyword
    key word func

注意:

  1. 本例已将MyTestLib.py所在目录路径添加到pywin32.pth
  2. 当类和模块名称不一致时,必须通过module_name.class_name的方式指定类库

修改CustomLibrary/MyTestLib.py代码内容如下:

# -*- coding:utf-8 -*-

class MyTestLib():
    ROBOT_LIBRARY_SCOPE = 'GLOBAL' # 设置类库作用域为全局--在整个测试执行过程中只创建一个实例,它由所有测试用例和测试套件共享
    def example_keyword(self):
        print('example_keyword')

    def key_word_func(self):
        print('key word function')

最终有效测试套件文本化编辑结果(TestSuite.robot文件内容)如下:

*** Settings ***
Library           MyTestLib

*** Test Cases ***
测试用例1
    example keyword
    key word func

说明:当类和模块名称一致时,可以省略类名

通过类继承实现由多个类组成的类库
实现方式1

项目工程代码组织结构如下:

CustomLibrary
│  MyTestLib.py
│  __init__.py
│
├─host
│      host_operations.py
│      __init__.py
│
├─monitor
│      monitor_operations.py
│      __init__.py
│
└─printer
        printer_operations.py
        __init__.py

CustomLibrary/host/host_operations.py代码内容如下:

# -*- coding:utf-8 -*-


class HostTestHelper():
    cpu_type = 'x86'
    def __init__(self):
        pass

    @classmethod
    def set_cpu_type(cls, cpu_type):
        print(f'set cpu type {cpu_type}')
        cls.cpu_type = cpu_type

CustomLibrary/monitor/monitor_operations.py代码内容如下:

# -*- coding:utf-8 -*-

class MonitorTestHelper():

    def __init__(self):
        pass

    def get_monitor_resolution_ratio(self):
        print('get monitor ratio')
        return '1600 x 900'

CustomLibrary/printer/printer_operations.py代码内容如下:

# -*- coding:utf-8 -*-

from host.host_operations import HostTestHelper
class PrinterTestHelper():

    def __init__(self):
        self.driver_type = ''

    def set_printer_driver(self):
        if HostTestHelper.cpu_type == 'x86':
            self.driver_type = 'SANXIN'
        elif HostTestHelper.cpu_type == 'x64':
            self.driver_type = 'HP'

        print(f'set printer driver {self.driver_type}')

    def get_printer_driver(self):
        print(f'get printer driver')

CustomLibrary/__init__.py代码内容如下:

# -*- coding:utf-8 -*-


# 注意,使用RIDE运行测试套件时,这里导入时必须包含项目根目录包,否则会导致类库失败,
# from host.host_operations import HostTestHelper  # 会报错,提示类似错误:ModuleNotFoundError: No module named 'host'
from CustomLibrary.host.host_operations import HostTestHelper
from CustomLibrary.monitor.monitor_operations import MonitorTestHelper
from CustomLibrary.printer.printer_operations import PrinterTestHelper

class CustomLibrary(HostTestHelper, MonitorTestHelper, PrinterTestHelper):
    ROBOT_LIBRARY_SCOPE = 'GLOBAL'
    def __init__(self):
        super().__init__()

pywin32.pth修改成如下配置

# .....
D:\PyProjects\CustomLibrary
D:\PyProjects

注意:文件如果去掉D:\PyProjects\CustomLibrary这行内容,会导致上面例中的MyTestLib类库导入失败,如果去掉 D:\PyProjects 这行内容则会导致CustomLibrary类库导入失败。

最终测试套件文本化编辑结果如下

*** Settings ***
Library           MyTestLib
Library           CustomLibrary

*** Test Cases ***
测试用例1
    example keyword
    key word func
    set_cpu_type    x64
    set_printer_driver
    get_printer_driver
    get monitor resolution ratio
实现方式2

在场景1的基础上,做以下修改,其它不变

1、删除 CustomLibrary/__init__.py代码,即还原__init__.py为新建状态

2、修改CustomLibrary/MyTestLib.py,修改后的代码内容如下:

# -*- coding:utf-8 -*-


# from CustomLibrary.host.host_operations import HostTestHelper # 这样也可以
from host.host_operations import HostTestHelper
from monitor.monitor_operations import MonitorTestHelper
from printer.printer_operations import PrinterTestHelper

class MyTestLib(HostTestHelper, MonitorTestHelper, PrinterTestHelper):
    ROBOT_LIBRARY_SCOPE = 'GLOBAL'
    def __init__(self):
        super().__init__()

最终有效测试套件文本化编辑结果(TestSuite.robot文件内容)如下:

*** Settings ***
Library           MyTestLib
Library           CustomLibrary

*** Test Cases ***
测试用例1
    set_cpu_type    x64
    set_printer_driver
    get_printer_driver
    get monitor resolution ratio
请登录后发表评论

    没有回复内容