python自动化RobotFramework中Collections字典关键字使用（五）

作者：科雷软件测试

前言介绍

安装好robotframework库后，跟之前文章介绍的BuiltIn库一样BuiltIn库使用介绍，在“python安装目录\Lib\site-packages\robot\libraries”中有一个常用库Collections.py，主要用于操作列表和字典。

打开客户端ride后，BuiltIn模块是默认导入，可直接使用，而其他模块或者第三方模块/包都需要import才能被使用。

我们可以在测试套件和resource文件中导入这些模块或者包，两者导入的方式是一样的。区别是在Suite中导入，该Suite内的测试用例可以直接使用导入的关键字；如果是在resource文件中导入，那么Suite需要再导入resource文件才能使用这些关键字。

该文章主要介绍在Suite中导入Collections模块的字典相关关键字的使用

在测试套件Suite中导入Collections

选中Suite（创建时选择Type为File类型；如果是Directory类型，导入库后用例不能使用导入的关键字），在右侧编辑区域可以看到有个按钮“Library”

点击“Library”按钮，在弹出的对话框中填入Collecitons（ride可以自动找到该库的目录），点击OK。

导入成功后选择“Tools->Search Keywords”，可以看到source为Collections的各类关键字。

2、字典类关键字介绍

关键字	描述
Convert To Dictionary	将传入的对象转换为字典，代码如dict(item)。这个关键字很少使用，因为对传入类型有特殊要求，并不是传入一个列表或者元组就能转换字典
Copy Dictionary	复制字典，如果参数deepcopy 为True，使用深拷贝模式copy.deepcopy(list)，新列表的修改不会影响到传入的列表
Dictionary Should Contain Sub Dictionary	检查字典1是否包含字典2的所有key:value组合，也就是字典2是不是字典1的子字典
Dictionary Should Contain Item	检查字典是否包含传入的key和value
Dictionary Should Contain Key	检查字典是否包含传入的key
Dictionary Should Contain Value	检查字典是否包含传入的value
Dictionaries Should Be Equal	检查两个字典是否相等
Dictionary Should Not Contain Key	检查字典是否不包含传入的key
Dictionary Should Not Contain Value	检查字典是否不包含传入的value
Get Dictionary Items	获取字典的所有kev,value，默认返回排序后的列表。配置参数sort_keys=False，则不排序。
Get Dictionary Keys	获取字典的所有keys， 代码如dictionary.keys()，默认返回排序后的列表。配置参数sort_keys=False，则不排序。
Get Dictionary Values	获取字典的所有values， 代码如dictionary.values()，默认返回排序后的列表。配置参数sort_keys=False，则不排序。
Get From Dictionary	获取字典中传入key对应的value值。
Keep In Dictionary	保留字典中给定范围的key，去掉不包含在内的key。
Log Dictionary	打印字典
Pop From Dictionary	删除传入的字典中的key，并返回移除的key对应的value值
Remove From Dictionary	删除传入的字典中的key
Set To Dictionary	在字典中添加key和value

以上面的几个关键字 我们举例介绍：

1. Convert To Dictionary

通过evaluate函数和zip函数实现将两个列表转为一个字典。

在TextEdit编辑区域如下，可直接拷贝使用。

*** Settings ***

Suite Setup log 测试套件开始执行

Suite Teardown log 测试套件结束执行

Test Setup log 测试用例开始执行

Test Teardown log 测试用例结束执行

Force Tags Suite

Library Collections

*** Test Cases ***

case2

    [Tags] Test2

    ${list1} create list apple banana peat

    ${list2} create list apple banana peat

    ${item} evaluate zip(${list1},${list1})

    ${Dict1} Convert To Dictionary ${item}

    log ${Dict1}

用例执行后，点击report看下报告如下

2、Keep In Dictionary

在Text Edit页签中内容如下：

*** Settings ***

Suite Setup log 测试套件开始执行

Suite Teardown log 测试套件结束执行

Test Setup log 测试用例开始执行

Test Teardown log 测试用例结束执行

Force Tags Suite

Library Collections

*** Test Cases ***

case2

    [Tags] Test2

    ${list1} create list apple banana pear

    ${list2} create list apple banana pear

    ${item} evaluate zip(${list1},${list1})

    ${Dict1} Convert To Dictionary ${item}

    log ${Dict1}

    Keep In Dictionary ${Dict1} apple banana orange

    log ${Dict1}

用例执行后，点击report看下报告如下：移除了不在范围的pear。

其他库

在robotframework库的安装目录/robot/libraries下，当然还有很对其他的一些库，只是没有默认加载，大家可以在使用时选择import导入这些库。

Dialogs：提供了暂停测试执行和从用户的输入方式

OperatingSystem：允许执行各种操作系统相关功能

Remote：远程库接口库，可实现调用其他机器上的关键字

Screenshot：提供关键字来捕获和存储桌面的截图

String：用于生成、修改和验证字符串的库

Telnet：支持连接到Telnet服务器的库

XML：用于生成、修改和验证XML文件的库

Process：系统中运行过程的库

DateTime：日期和时间转换的库，支持创建和验证日期和时间值以及它们之间的计算

总结：没有举例的关键字，请大家在线下多操作和练习，这样会更清楚这些列表相关的关键字的作用和实现，当然也就可以直接看python的代码实现。

共勉： 东汉·班固《汉书·枚乘传》：“泰山之管穿石，单极之绠断干。水非石之钻，索非木之锯，渐靡使之然也。”

-----指水滴不断地滴，可以滴穿石头；

-----比喻坚持不懈，集细微的力量也能最终成就难能的功劳。