Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/eventstore/eventstore-client-go
Go Client for Event Store version 20 and above.
https://github.com/eventstore/eventstore-client-go
client-libraries cqrs event-sourcing eventsourcing eventstore eventstoredb go golang grpc
Last synced: 1 day ago
JSON representation
Go Client for Event Store version 20 and above.
- Host: GitHub
- URL: https://github.com/eventstore/eventstore-client-go
- Owner: EventStore
- License: apache-2.0
- Created: 2019-11-20T14:38:34.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2025-01-07T09:58:45.000Z (about 1 month ago)
- Last Synced: 2025-02-05T17:05:01.482Z (1 day ago)
- Topics: client-libraries, cqrs, event-sourcing, eventsourcing, eventstore, eventstoredb, go, golang, grpc
- Language: Go
- Homepage:
- Size: 1.01 MB
- Stars: 107
- Watchers: 23
- Forks: 28
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# EventStoreDB Client SDK for Golang [](https://github.com/eventstore/EventStore-Client-Go/actions)
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][es] Client SDK written in Go.
## Developing
Integration tests run against a server using Docker, with the [EventStoreDB gRPC Client Test Container][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.
```bash
make build
```
To also regenerate protobuf and gRPC files while building
```bash
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:
```shell
export EVENTSTORE_DOCKER_TAG="21.10.0-focal"
make test
```
## Communities
- [Discuss](https://discuss.eventstore.com/)
- [Discord (Event Store)](https://discord.gg/Phn9pmCw3t)
## 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.
[container]: https://github.com/EventStore/EventStore-Client-gRPC-TestData
[docker]: https://www.docker.com/
[docker compose]: https://www.docker.com/
[es]: https://eventstore.com
[make]: https://www.gnu.org/software/make/