VPP测试框架简单分析

逃离我推掉我的手 2022-06-05 10:26 696阅读 0赞

vpp的测试框架是在unittest的基础上编写的。只是重写unittest的一些类，然后测试用例在继承 测试框架类。

## **framework.py** ##

这个是测试框架类，主要包含 所有测试用例都要继承的类VppTestCase，setUpClass、  
setUp、tearDownClass tearDown等方法和 一些 对VPP操作比如 发包创建流等等

**VppTestCase**  
继承了 unittest的 TestCase。之后编写的测试用例类都是继承自他

![这里写图片描述][SouthEast]

在原有的 TestCase的基础上做了哪些增加：

之后所有的测试用例中 等等需要对unittest方法重写的都进行了重写。  
测试用例写的时候就写少部分，大部分共有的都抽出来放到 VppTestCase中  
都是对VPP功能的操作。

**setUpClass**

在运行testcase之前执行类设置  
删除共享内存文件，启动vpp并连接vpp -api  
创建临时文件夹存储日志  
配置VPP根据设置的系统参数进行运行  
连接 vpp-api

**setUp**  
每个测试用例执行前清除之前测试执行VPP产生的东西  
清理环境

**tearDownClass**

输出到日志文件

## VppTestRunner ##

VppTestRunner继承自 unittest.TextTestRunner类  
属性 resultclass 用于返回测试结果 VppTestResult  
调用了父类 TextTestRunner的构造方法

**run**  
一个套件将测试用例添加进去。  
这个就是执行加入测试套件里的测试用例  
super(VppTestRunner, self).run(filtered)

然后 run\_test执行传入参数 suite

![这里写图片描述][SouthEast 1]

简单分析下测试用例

**test\_ping.py**

![这里写图片描述][SouthEast 2]

配置执行测试用例前的配置等，先调用VppTestCase类的 setUpClass方法。再创建两个接口，启动，配置

![这里写图片描述][SouthEast 3]

对接口开启捕获，开始包生成器，创建 ping命令

获取包的信息 断言判断是否包的信息与预期的符合

pg\_enable\_capture 等方法是从框架模块 framework中的 VppTestCase类中的

![这里写图片描述][SouthEast 4]

之后删除之前的配置恢复环境

**test\_ip4.py**

同样是先进行配置

![这里写图片描述][SouthEast 5]

**test\_fib**

![这里写图片描述][SouthEast 6]

大致流程都是如上  
创建流，包，添加到接口。启用捕获，发包，验证包的信息  
`create_stream`创建流的方法 就在 test\_ip4里面

创建一个 报文 源目的 数据等

在接口开启捕获

self.pg_enable_capture(self.pg_interfaces)
            self.pg_start()

然后获取包，

获取数据包并验证

pkts = self.pg0.get_capture()
            self.verify_capture(self.pg0, pkts)

验证方法也在 test\_ip4中

![这里写图片描述][SouthEast 7]

## **test\_1\_add\_routes及 VPP-API流程** ##

增加100个路由

配置路由进去

![这里写图片描述][SouthEast 8]

config\_fib\_many\_to\_one方法里面是使用的 vpp-api来操作

![这里写图片描述][SouthEast 9]

self.vapi.ip_add_del_route(
                        dest_addr, dest_addr_len, next_hop_address)

![这里写图片描述][SouthEast 10]

在 框架中 framework 中

cls.vapi = VppPapiProvider(cls.shm_prefix, cls.shm_prefix, cls)

![这里写图片描述][SouthEast 11]

而 VppPapiProvider 是从 vpp\_papi\_provider 导入  
![这里写图片描述][SouthEast 12]

这个是提供 vpp-api的

其中导入了 vpp-api模块

![这里写图片描述][SouthEast 13]  
一些对 vpp-api的使用可以查看 vpp\_papi\_provider

调用的方法 ip\_add\_del\_route 在 vpp\_papi\_provider中

![这里写图片描述][SouthEast 14]

封装了很多方法

![这里写图片描述][SouthEast 15]

## **如何编写一个新的测试用例** ##

增加的测试用例要以 test\_开头才可以，且里面的类要继承 VppTestCase

默认参考文档写的测试用例只能使用 make test /retest等部分或者全部运行才能一起运行

要让其测试用例可以单独执行，可以增加

导入 unittest

from framework import VppTestCase, VppTestRunner

然后在下面

if __name__ == '__main__':
        unittest.main(testRunner=VppTestRunner)

既可使用 make test-shell命令进行单独执行或者直接执行

![这里写图片描述][SouthEast 16]

具体编写主要参考测试用例编写文档

[https://docs.fd.io/vpp/17.04/vpp\_make\_test/html/overview.html\#example-how-to-add-a-new-test][https_docs.fd.io_vpp_17.04_vpp_make_test_html_overview.html_example-how-to-add-a-new-test]

而且所有的测试用例都可以按照 unittest的方法执行，  
测试用例的执行需要很多环境变量需要去Makefile文件中查看。make 参数命令可以，不使用的话就要自己去配置环境变量。

[SouthEast]: /images/20220605/9ed2ff5f8bd34d5eb39761a31c6521f9.png
[SouthEast 1]: /images/20220605/53c5cb741c7b49e8a9208f78bdc9365e.png
[SouthEast 2]: /images/20220605/a939491220364e5cafd8f6c50bfcb362.png
[SouthEast 3]: /images/20220605/acb20b135d454e83866b21a0ac36a891.png
[SouthEast 4]: /images/20220605/6b5cbc2742c84f3ca3d4206f3e123e90.png
[SouthEast 5]: /images/20220605/36a15271b91c4c37b391e07a8c9f0cea.png
[SouthEast 6]: /images/20220605/2e97d3554594441e9e61466c1078753b.png
[SouthEast 7]: /images/20220605/88e3ec3ea1ef43f48973fd7aebee55ce.png
[SouthEast 8]: /images/20220605/5f6a27e3088f4fd9b7b682622cca0d49.png
[SouthEast 9]: /images/20220605/d1f718a97805479084cfe7d767a9ad57.png
[SouthEast 10]: /images/20220605/0d7dbc9d72f1403e9153898114bedc44.png
[SouthEast 11]: /images/20220605/8e3f2565e85a4a8b93948f4b8520b651.png
[SouthEast 12]: /images/20220605/3f9d1c31d59a48e8a3bad1879d004a3a.png
[SouthEast 13]: /images/20220605/9a8d0c08c99e473ebfd2ddefb5668a1c.png
[SouthEast 14]: /images/20220605/981f58506d204bfbbcffcfdc657ebaa9.png
[SouthEast 15]: /images/20220605/cbb3fddf132346c4856bc567f7dd1341.png
[SouthEast 16]: /images/20220605/a26cdd54b6b941d8964ab38ede090259.png
[https_docs.fd.io_vpp_17.04_vpp_make_test_html_overview.html_example-how-to-add-a-new-test]: https://docs.fd.io/vpp/17.04/vpp_make_test/html/overview.html#example-how-to-add-a-new-test