gesclient

README

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

1. Install using go get -u github.com/jdextraze/go-gesclient.
2. Install govendor with go get -u github.com/kardianos/govendor.
3. 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

Documentation

Index

• func Create(settings *client.ConnectionSettings, uri *url.URL, name string) (client.Connection, error)
• func Debug()

Functions

func Create

func Create(settings *client.ConnectionSettings, uri *url.URL, name string) (client.Connection, error)

func Debug

func Debug()