Event Store Go Client

A Go port of the .Net client for Event Store.

License

Ported code is released under the MIT license.

Original code is released under the Event Store License.

Status

This project is considered ready for production.

Implemented

Writing to a stream
Reading a single event
Reading a stream forwards
Reading a stream backwards
Reading all events forwards
Reading all events backwards
Volatile subscriptions
Persistent subscription
Deleting stream
Cluster connection
Global authentication
Get/Set stream metadata
Set system settings
Transaction
SSL connection
Projections Management

Missing

64bit event number support

Need Improvements

Documentation
Unit and integration tests
Benchmarks

Known issues

None at the moment

Getting started

Requirements

Go 1.4+

Install

Install using go get -u github.com/jdextraze/go-gesclient.
Install govendor with go get -u github.com/kardianos/govendor.
Install vendor packages with govendor sync

Optional Tools

Robo (go get github.com/tj/robo)
Docker

Running EventStore on local machine

See https://eventstore.org/docs/introduction/4.1.0/

Running EventStore with docker

docker run --rm --name eventstore -d -p 1113:1113 -p 2113:2113 eventstore/eventstore:release-4.1.0

or if you installed robo

Start a node: robo start_es 4.1.0
Start a node with SSL: robo start_es 3.9.3 ssl
Stop the node: robo stop_es
Start a cluster: robo start_es_cluster 3.9.3
Stop the cluster: robo stop_es_cluster

Examples

For examples, look into the examples folder. All examples connect to tcp://localhost:1113 by default.

Building

To build all examples, use robo build.

Using SSL

To use SSL in examples, add -ssl-host localhost -ssl-skip-verify to the command line.

You can also add the example certificates to your local store by running robo install_certificate. Then you don't need to add -ssl-skip-verify.

Other languages client

.Net (Official)
Java / Scala (Official)
Node.JS

tyronegroves/go-gesclient