topfreegames / go-gcm

GCM library for Go.

GCM Library for Go

Provides the following functionality for Google Cloud Messaging:

1. Sending messages via HTTP or XMPP.
2. Receiving messages from XMPP.

Documentation: see godoc

Installation

$ go get github.com/topfreegames/go-gcm

Status

This is a rework of go-gcm library. It has the following improvements:

• code refactored, HTTP and XMPP clients separated
• monitors XMPP connection with pings, redials when ping fails
• handles CONNECTION_DRAINING properly
• graceful close
• exponential backoff when sending a message
• circuit breaker for each provider
• improved logging with logrus
• ginkgo tests
• various govet/golint fixes
• automatic builds with Travis and coverage with Codecov

This library is in Beta. We will make an effort to support the library, but we reserve the right to make incompatible changes when necessary.

Feedback

Please read CONTRIBUTING and raise issues here in Github.

Limitations

Note that GCM limitations are not enforced by the library. Instead, all valid requests are sent to the server and a corresponding error is returned (Message Too Big, Device Message Rate Exceeded, etc).