{"id":13514172,"url":"https://github.com/looplab/eventhorizon","last_synced_at":"2025-05-14T02:02:56.182Z","repository":{"id":37561590,"uuid":"26747350","full_name":"looplab/eventhorizon","owner":"looplab","description":"Event Sourcing for Go!","archived":false,"fork":false,"pushed_at":"2025-01-06T09:06:16.000Z","size":2263,"stargazers_count":1609,"open_issues_count":53,"forks_count":197,"subscribers_count":47,"default_branch":"main","last_synced_at":"2025-04-12T15:56:19.813Z","etag":null,"topics":["aws","cqrs","ddd","domain-driven-design","entity","event-horizon","event-sourcing","eventsourcing","go","google-cloud","jetstream","kafka","mongodb","nats","opentracing","redis"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/looplab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2014-11-17T08:32:26.000Z","updated_at":"2025-04-03T11:41:01.000Z","dependencies_parsed_at":"2024-01-13T19:24:36.453Z","dependency_job_id":"6b5bf872-220b-4000-8d15-4e86b2b104dc","html_url":"https://github.com/looplab/eventhorizon","commit_stats":{"total_commits":612,"total_committers":43,"mean_commits":"14.232558139534884","dds":"0.18627450980392157","last_synced_commit":"599169c1c4a89dc57954d5b871cd482b4c4ad02c"},"previous_names":[],"tags_count":34,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/looplab%2Feventhorizon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/looplab%2Feventhorizon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/looplab%2Feventhorizon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/looplab%2Feventhorizon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/looplab","download_url":"https://codeload.github.com/looplab/eventhorizon/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254052658,"owners_count":22006716,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws","cqrs","ddd","domain-driven-design","entity","event-horizon","event-sourcing","eventsourcing","go","google-cloud","jetstream","kafka","mongodb","nats","opentracing","redis"],"created_at":"2024-08-01T05:00:48.570Z","updated_at":"2025-05-14T02:02:56.137Z","avatar_url":"https://github.com/looplab.png","language":"Go","funding_links":[],"categories":["Go","Repositories","Uncategorized"],"sub_categories":["Uncategorized"],"readme":"[![PkgGoDev](https://pkg.go.dev/badge/github.com/looplab/eventhorizon)](https://pkg.go.dev/github.com/looplab/eventhorizon)\n![Build Status](https://github.com/looplab/eventhorizon/actions/workflows/test.yml/badge.svg)\n[![Coverage Status](https://img.shields.io/coveralls/looplab/eventhorizon.svg)](https://coveralls.io/r/looplab/eventhorizon)\n[![Go Report Card](https://goreportcard.com/badge/looplab/eventhorizon)](https://goreportcard.com/report/looplab/eventhorizon)\n\n# Event Horizon\n\nEvent Horizon is a CQRS/ES toolkit for Go.\n\n**NOTE: Event Horizon is used in production systems but the API is not final!**\n\nCQRS stands for Command Query Responsibility Segregation and is a technique where object access (the Query part) and modification (the Command part) are separated from each other. This helps in designing complex data models where the actions can be totally independent from the data output.\n\nES stands for Event Sourcing and is a technique where all events that have happened in a system are recorded, and all future actions are based on the events instead of a single data model. The main benefit of adding Event Sourcing is traceability of changes which can be used for example in audit logging. Additionally, \"incorrect\" events that happened in the past (for example due to a bug) can be compensated for with an event which will make the current data \"correct\", as that is based on the events.\n\nRead more about CQRS/ES from one of the major authors/contributors on the subject: http://codebetter.com/gregyoung/2010/02/16/cqrs-task-based-uis-event-sourcing-agh/\n\nOther material on CQRS/ES:\n\n- http://martinfowler.com/bliki/CQRS.html\n- http://cqrs.nu\n- https://groups.google.com/forum/#!forum/dddcqrs\n\nInspired by the following libraries/examples:\n\n- https://github.com/edumentab/cqrs-starter-kit\n- https://github.com/pjvds/go-cqrs\n- http://www.codeproject.com/Articles/555855/Introduction-to-CQRS\n- https://github.com/qandidate-labs/broadway\n\nSuggestions are welcome!\n\n# Usage\n\nSee the example folder for a few examples to get you started.\n\n# Get Involved\n\n- Join our [slack channel](https://gophers.slack.com/messages/eventhorizon/) (sign up [here](https://invite.slack.golangbridge.org/))\n- Check out the [contribution guidelines](CONTRIBUTING.md)\n\n# Event Store Implementations\n\n### Official\n\n- Memory - Useful for testing and experimentation.\n- MongoDB - One document per aggregate with events as an array. Beware of the 16MB document size limit that can affect large aggregates.\n- MongoDB v2 - One document per event with an additional document per aggregate. This event store is also capable of keeping track of the global event position, in addition to the aggregate version.\n- Recorder - An event recorder (middleware) that can be used in tests to capture some events.\n- Tracing - Adds distributed tracing support to event store operations with OpenTracing.\n\n### Contributions / 3rd party\n\n- AWS DynamoDB: https://github.com/seedboxtech/eh-dynamo\n- Postgress: https://github.com/giautm/eh-pg\n- Redis: https://github.com/TerraSkye/eh-redis\n- ScyllaDB: https://github.com/datdao/eh-scylla\n\n# Event Bus Implementations\n\n### Official\n\n- GCP Cloud Pub/Sub - Using one topic with multiple subscribers.\n- NATS - Using Jetstream features.\n- Kafka - Using one topic with multiple consumer groups.\n- Local - Useful for testing and experimentation.\n- Redis - Using Redis streams.\n- Tracing - Adds distributed tracing support to event publishing and handling with OpenTracing.\n\n### Contributions / 3rd party\n\n- Kafka: https://github.com/Kistler-Group/eh-kafka\n- NATS Streaming: https://github.com/v0id3r/eh-nats\n\n# Repo Implementations\n\n### Official\n\n- Memory - Useful for testing and experimentation.\n- MongoDB - One document per projected entity.\n- Version - Adds support for reading a specific version of an entity from an underlying repo.\n- Cache - Adds support for in-memory caching of entities from an underlying repo.\n- Tracing - Adds distributed tracing support to an repo operations with OpenTracing.\n\n# Development\n\nTo develop Event Horizon you need to have Docker and Docker Compose installed.\n\nTo run all unit tests:\n\n```bash\nmake test\n```\n\nTo run and stop services for integration tests:\n\n```bash\nmake run\nmake stop\n```\n\nTo run all integration tests:\n\n```bash\nmake test_integration\n```\n\nTesting can also be done in docker:\n\n```bash\nmake test_docker\nmake test_integration_docker\n```\n\n# License\n\nEvent Horizon is licensed under Apache License 2.0\n\nhttp://www.apache.org/licenses/LICENSE-2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flooplab%2Feventhorizon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flooplab%2Feventhorizon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flooplab%2Feventhorizon/lists"}