Home

Awesome

go-sse

Build Status Coverage Status Go Report Card Go Reference MIT License

This package attempts to provide a robust and reliable implementation of server-sent events. One might use this package if they were writing an application that needed to connect to an SSE server endpoint and read events in a continuous stream or provide events to a front-end service.

Features

Here's what you get with this package:

go-sse requires a minimum of Go 1.18.

Basic Usage

To use the package in your application, begin by importing it:

import "github.com/lampctl/go-sse"

Use as a Client

Create a client using:

c, err := sse.NewClientFromURL("http://example.com/sse")
if err != nil {
    // ...
}

You can now read events directly from the c.Events channel as they are received:

for e := range c.Events {
    fmt.Println("Event received!")
    fmt.Println(e.Data)
}

Note that if the connection is closed or interrupted, the client will attempt to reconnect as per the spec and continue returning events from where it was interrupted. This is all handled behind the scenes and won't affect the status of the event channel.

When you are done receiving events, close the client:

c.Close()

Use as a Server

The server component is provided via Handler, which implements http.Handler:

h := sse.NewHandler(nil)

// ...or if you want to customize initialization:
h := sse.NewHandler(&sse.HandlerConfig{
    NumEventsToKeep:   10,
    ChannelBufferSize: 4,
})

To send an event, simply use the Send() method:

h.Send(&sse.Event{
    Type: "alert",
    Data: "The aliens are invading!",
    ID:   "12345",
})

When you are done, use the Close() method:

h.Close()