README.md

EventStoreDB Client SDK for Golang

EventStoreDB is the event-native database, where business events are immutably stored and streamed. Designed for event-sourced, event-driven, and microservices architectures.

This repository contains an EventStoreDB Client SDK written in Go.

Developing

Integration tests run against a server using Docker, with the EventStoreDB gRPC Client Test Container.

Setup dependencies

Testing requires Docker and Docker Compose to be installed.

Build the project

You need make to be installed (available on all OSes). On Windows, you need Powershell. The version that comes standard with Windows is enough. On a Unix system, any bash compatible shell should work.

make build

To also regenerate protobuf and gRPC files while building

make generate-protos-and-build

Run tests

make test

By default the tests use docker.eventstore.com/eventstore-ce:ci. To override this, set the EVENTSTORE_DOCKER_TAG environment variable to the tag you wish to use:

export EVENTSTORE_DOCKER_TAG="21.10.0-focal"
make test

Communities

• Discuss
• Discord (Event Store)

Security

If you find a vulnerability in our software, please contact us. You can find how to reach out us and report it at https://www.eventstore.com/security#security Thank you very much for supporting our software.

Contributing

All contributions to the SDK are made via GitHub Pull Requests, and must be licensed under the Apache 2.0 license.