{"id":13776432,"url":"https://github.com/randomsync/robotframework-mqttlibrary","last_synced_at":"2025-12-30T01:14:51.651Z","repository":{"id":38206698,"uuid":"30955383","full_name":"randomsync/robotframework-mqttlibrary","owner":"randomsync","description":"MQTT Keyword Library for Robot Framework","archived":false,"fork":false,"pushed_at":"2024-05-29T06:32:34.000Z","size":252,"stargazers_count":28,"open_issues_count":14,"forks_count":30,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-18T13:20:58.476Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"RobotFramework","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/randomsync.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-02-18T06:52:41.000Z","updated_at":"2025-04-13T21:07:39.000Z","dependencies_parsed_at":"2024-06-21T02:13:35.510Z","dependency_job_id":"cae0c70a-84e8-4b7b-9d34-723fc1d7bc63","html_url":"https://github.com/randomsync/robotframework-mqttlibrary","commit_stats":{"total_commits":42,"total_committers":6,"mean_commits":7.0,"dds":"0.26190476190476186","last_synced_commit":"a32dd8c67716487ea9ce904509f7f61af67b05af"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/randomsync%2Frobotframework-mqttlibrary","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/randomsync%2Frobotframework-mqttlibrary/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/randomsync%2Frobotframework-mqttlibrary/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/randomsync%2Frobotframework-mqttlibrary/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/randomsync","download_url":"https://codeload.github.com/randomsync/robotframework-mqttlibrary/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253551553,"owners_count":21926314,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-03T18:00:25.678Z","updated_at":"2025-12-30T01:14:51.608Z","avatar_url":"https://github.com/randomsync.png","language":"RobotFramework","funding_links":[],"categories":["Libraries"],"sub_categories":["Messaging/Communication"],"readme":"MQTTLibrary for Robot Framework\n===============================\n\n.. image:: https://travis-ci.org/randomsync/robotframework-mqttlibrary.svg?branch=master\n    :target: https://travis-ci.org/randomsync/robotframework-mqttlibrary\n\n.. image:: https://badge.fury.io/py/robotframework-mqttlibrary.svg\n    :target: https://badge.fury.io/py/robotframework-mqttlibrary\n\nMQTTLibrary is a `Robot Framework`_ library that provides keywords for testing on MQTT brokers. MQTT_ is a lightweight protocol for machine-to-machine communication, typically used for IoT messaging. This library uses the paho_ client library published by eclipse project.\n\n.. _Robot Framework: http://robotframework.org\n.. _MQTT: http://mqtt.org/\n.. _paho: https://eclipse.org/paho/\n\nInstallation\n------------\n\nMQTTLibrary can be installed using `pip \u003chttp://pip-installer.org\u003e`__::\n\n    pip install robotframework-mqttlibrary\n\nYou can also install it from the source distribution by running::\n\n    python setup.py install\n\nYou may need to run the above command with administrator privileges.\n\nUsage\n-------\n\nImport the library:\n\n.. code-block:: robotframework\n\n    *** Settings ***\n    Library          MQTTLibrary\n\nConnect to the broker, publish and disconnect:\n\n.. code-block:: robotframework\n\n    *** Test Cases ***\n    Publish\n        Connect     127.0.0.1\n        Publish     topic=test/mqtt_test    message=test message\n        [Teardown]  Disconnect\n\nConnect to the broker, subscribe and validate that a message is received:\n\n.. code-block:: robotframework\n\n    *** Test Cases ***\n    Subscribe and Validate\n        Connect                 127.0.0.1\n        Subscribe and Validate  topic=test/mqtt_test    qos=1   payload=test\n        [Teardown]              Disconnect\n\n\nKeyword documentation is available at: http://randomsync.github.io/robotframework-mqttlibrary.\n\nAlso look at ``tests`` folder for examples.\n\nFor general information about using test libraries with Robot Framework, see\n`Robot Framework User Guide`__.\n\n__ http://robotframework.org/robotframework/latest/RobotFrameworkUserGuide.html#using-test-libraries\n\nContributing\n------------\n\nThe keywords in this library are based on some of the methods available in eclipse paho client library. If you'd like to add keywords, see instructions_ on creating/updating libraries for Robot Framework.\n\nThe tests are in ``tests`` folder and make use of Robot Framework itself. They are run automatically through travis when code is pushed to a branch. When run locally, these tests rely on locally running mqtt brokers. We need 2 running brokers, one without auth that is used by most of the tests, and the other one with auth (configuration file is provided). You'll need to start them before running the tests. You can then run the tests locally::\n\n    docker pull eclipse-mosquitto\n    docker run -d -p 1883:1883 eclipse-mosquitto\n    docker run -d -p 11883:1883 -p 9001:9001 -v $(pwd)/mosquitto:/mosquitto/config eclipse-mosquitto\n    robot -P src tests\n\n\nMake sure to stop the docker container when it is no longer needed.\n\n.. _instructions: http://robotframework.org/robotframework/latest/RobotFrameworkUserGuide.html#creating-test-libraries\n\nLicense\n-------\nMQTTLibrary is open source software provided under the `Apache License 2.0`__.\n\n__ http://apache.org/licenses/LICENSE-2.0","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frandomsync%2Frobotframework-mqttlibrary","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frandomsync%2Frobotframework-mqttlibrary","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frandomsync%2Frobotframework-mqttlibrary/lists"}