TIBCO Usage of the Eclipse Paho MQTT Go client

This fork of the Eclipse Paho MQTT Go client code is maintained as a mirror of the upstream project to document our actual usage.

This code has been modified by TIBCO for use in its MQTT applications.

Any modifications from the upstream should be considered temporary, as they will be submitted as pull requests to the upstream project. A process that generally involves subsequent modifications to the original request to make it more usable by a broader audience.

MQTT Go client users are encouraged to work directly with the primary project : Eclipse Paho

In addition to the standard upstream branches, this repo contains a tibco-release branch maintained to document TIBCO releases.

Eclipse Paho MQTT Go client

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.

Installation and Build

This client is designed to work with the standard Go tools, so installation is as easy as:

go get github.com/eclipse/paho.mqtt.golang

The client depends on Google's websockets and proxy package, also easily installed with the commands:

go get golang.org/x/net/websocket
go get golang.org/x/net/proxy

Usage and API

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 "github.com/eclipse/paho.mqtt.golang"

Samples are available in the cmd directory for reference.

Runtime tracing

Tracing is enabled by assigning logs (from the Go log package) to the logging endpoints, ERROR, CRITICAL, WARN and DEBUG

Reporting bugs

Please report bugs by raising issues for this project in github https://github.com/eclipse/paho.mqtt.golang/issues

More information

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.