This repository contains the source code for the Eclipse Paho MQTT Go client library.
This code builds a library which enable applications to connect to an MQTT broker to publish messages, and to subscribe to topics and receive published messages.
This library supports a fully asynchronous mode of operation.
This client is designed to work with the standard Go tools, so installation is as easy as:
go get git.eclipse.org/gitroot/paho/org.eclipse.paho.mqtt.golang.git
The client depends on Google's websockets package, also easily installed with the command:
go get code.google.com/p/go.net/websocket
Detailed API documentation is available by using to godoc tool, or can be browsed online using the godoc.org service.
Make use of the library by importing it in your Go client source code. For example,
import MQTT "git.eclipse.org/gitroot/paho/org.eclipse.paho.mqtt.golang.git"
Samples are available in the /samples
directory for reference.
Tracing is enabled by using the SetTraceLevel
option when creating a ClientOptions struct. See the ClientOptions
documentation for more details.
Please report bugs under the "MQTT-Go" Component in Eclipse Bugzilla for the Paho Technology project. This is a very new library as of Q1 2014, so there are sure to be bugs.
Discussion of the Paho clients takes place on the Eclipse paho-dev mailing list.
General questions about the MQTT protocol are discussed in the MQTT Google Group.
There is much more information available via the MQTT community site.