Skip to content

pubnub/go

Folders and files

NameName
Last commit message
Last commit date
Mar 21, 2025
Nov 27, 2023
Jul 8, 2022
May 24, 2018
Dec 10, 2024
Oct 16, 2023
Oct 16, 2023
Nov 29, 2021
Mar 21, 2025
Mar 21, 2025
Jun 15, 2018
Sep 19, 2019
Sep 21, 2019
Nov 7, 2023
Sep 18, 2019
Jul 8, 2022
Oct 13, 2021
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Sep 26, 2018
Oct 16, 2023
Jul 24, 2020
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Dec 16, 2021
Dec 12, 2019
Nov 27, 2023
Jan 3, 2023
Nov 29, 2021
Nov 29, 2021
Jan 3, 2023
Jan 3, 2023
Oct 16, 2023
Jan 3, 2023
Jan 13, 2022
Jan 3, 2023
Jan 3, 2023
Dec 10, 2024
Dec 10, 2024
Oct 16, 2023
Oct 16, 2023
Oct 16, 2023
Jan 3, 2023
Jan 3, 2023
Mar 6, 2025
Mar 6, 2025
Aug 9, 2022
Aug 9, 2022
Jan 3, 2023
Jan 3, 2023
Mar 6, 2023
Jan 3, 2023
Nov 25, 2019
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Dec 10, 2024
Dec 10, 2024
Jul 8, 2022
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Dec 10, 2024
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jun 10, 2020
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Oct 16, 2023
Jan 3, 2023
Jan 3, 2023
Dec 13, 2019
Dec 10, 2024
Dec 10, 2024
Mar 21, 2025
Oct 16, 2023
Jun 15, 2018
Jul 8, 2022
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Mar 19, 2018
Mar 19, 2018
Jul 24, 2020
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Jan 3, 2023
Dec 10, 2024
Dec 10, 2024
Mar 5, 2018
Jun 15, 2018
Dec 12, 2018
Mar 19, 2018
May 11, 2023
Jan 3, 2023
Dec 10, 2024
Dec 10, 2024
Dec 16, 2021
Jun 13, 2018
Jan 3, 2023
Jul 8, 2022
Jan 13, 2022
Oct 15, 2018
Dec 10, 2024
Jan 3, 2023
Jan 3, 2023

Repository files navigation

PubNub Go SDK

GoDoc Build Status codecov.io Go Report Card

This is the official PubNub Go SDK repository.

PubNub takes care of the infrastructure and APIs needed for the realtime communication layer of your application. Work on your app's logic and let PubNub handle sending and receiving data across the world in less than 100ms.

Requirements

  • Go (1.9+)

Get keys

You will need the publish and subscribe keys to authenticate your app. Get your keys from the Admin Portal.

Configure PubNub

  1. Integrate PubNub into your project using the go command:

    go get github.com/pubnub/go

    If you encounter dependency issues, use the dep ensure command to resolve them.

  2. Create a new file and add the following code:

    func main() {
        config := pubnub.NewConfigWithUserId("userId")
        config.SubscribeKey = "mySubscribeKey"
        config.PublishKey = "myPublishKey"
    
        pn := pubnub.NewPubNub(config)
    }

Add event listeners

listener := pubnub.NewListener()
doneConnect := make(chan bool)
donePublish := make(chan bool)

msg := map[string]interface{}{
    "msg": "Hello world",
}
go func() {
    for {
        select {
        case status := <-listener.Status:
            switch status.Category {
            case pubnub.PNDisconnectedCategory:
                // This event happens when radio / connectivity is lost
            case pubnub.PNConnectedCategory:
                // Connect event. You can do stuff like publish, and know you'll get it.
                // Or just use the connected event to confirm you are subscribed for
                // UI / internal notifications, etc
                doneConnect <- true
            case pubnub.PNReconnectedCategory:
                // Happens as part of our regular operation. This event happens when
                // radio / connectivity is lost, then regained.
            }
        case message := <-listener.Message:
            // Handle new message stored in message.message
            if message.Channel != "" {
                // Message has been received on channel group stored in
                // message.Channel
            } else {
                // Message has been received on channel stored in
                // message.Subscription
            }
            if msg, ok := message.Message.(map[string]interface{}); ok {
                fmt.Println(msg["msg"])
            }
            /*
                log the following items with your favorite logger
                    - message.Message
                    - message.Subscription
                    - message.Timetoken
            */

            donePublish <- true
        case <-listener.Presence:
            // handle presence
        }
    }
}()

pn.AddListener(listener)

Publish and subscribe

In this code, publishing a message is triggered when the subscribe call is finished successfully. The Publish() method uses the msg variable that is used in the following code.

msg := map[string]interface{}{
        "msg": "Hello world!"
}

pn.Subscribe().
    Channels([]string{"hello_world"}).
    Execute()

<-doneConnect

response, status, err := pn.Publish().
    Channel("hello_world").Message(msg).Execute()

if err != nil {
     // Request processing failed.
     // Handle message publish error
}

Documentation

API reference for Go

Support

If you need help or have a general question, contact [email protected].