mqtt关键字库robot框架
robotframework-mqttlibrar的Python项目详细描述
mqtt library是一个Robot Framework库,它提供用于在mqtt代理上测试的关键字。MQTT是一种用于机器到机器通信的轻量级协议,通常用于物联网消息传递。这个库使用eclipse项目发布的paho客户机库。
安装
mqttlibrary可以使用pip:
pip install robotframework-mqttlibrary
您也可以通过运行:
python setup.py install
您可能需要以管理员权限运行上述命令。
用法
导入库:
*** Settings ***LibraryMQTTLibrary
连接到代理,发布并断开连接:
*** Test Cases ***PublishConnect127.0.0.1Publishtopic=test/mqtt_testmessage=test message [Teardown] Disconnect
连接到代理,订阅并验证是否接收到消息:
*** Test Cases ***Subscribe and ValidateConnect127.0.0.1Subscribe and Validatetopic=test/mqtt_testqos=1payload=test [Teardown] Disconnect
关键字文档位于:http://randomsync.github.io/robotframework-mqttlibrary。
还可以查看tests文件夹中的示例。
有关在Robot框架中使用测试库的一般信息,请参见 Robot Framework User Guide。
贡献
这个库中的关键字基于eclipse paho客户机库中的一些可用方法。如果要添加关键字,请参见instructions关于为robot framework创建/更新库的内容。
测试位于tests文件夹中,并使用robot框架本身。当代码被推送到分支时,它们会自动通过travis运行。大多数测试依赖于iot.eclipse.org上的公共mqtt代理,但是一些验证身份验证的测试依赖于本地代理。您可以使用提供的配置启动本地代理。然后您可以在本地运行测试:
docker pull eclipse-mosquitto docker run -d -p 1883:1883 -p 9001:9001 -v $(pwd)/mosquitto:/mosquitto/config eclipse-mosquitto pybot -P src tests
当不再需要Docker容器时,请确保将其停止。
许可证
mqttlibrary是在Apache License 2.0下提供的开源软件。