Skip to content

NFIBrokerage/event_store_db_gpb_protobufs

Repository files navigation

event_store_db_gpb_protobufs

gpb generated protobuf definitions for EventStoreDB 20+

This repo is a hex package that uses the rebar3_gpb_plugin to generate Erlang :gpb files on-the-fly for EventStoreDB's gRPC interface.

How to publish new protobufs

  1. clone this repo
  2. initialize the submodule on EventStore
    git submodule init
    git submodule update
    
  3. checkout a tag in the EventStore submodule
  4. add the new tag and commit hash information to the CHANGELOG.md
  5. change the version and commit_hash functions in src/event_store_db_gpb_protobufs.erl
  6. change the library version in src/event_store_db_gpb_protobufs.app.src
  7. run rebar3 compile
  8. publish the package rebar3 hex publish

Seeing diffs between EventStore versions

The CHANGELOG.md contains a log of the commit hashes. You can compare the protobuf definitions between any two EventStore commit hashes aaaaaaa and bbbbbbb like so:

git clone [email protected]:EventStore/EventStore.git
cd EventStore/
git diff aaaaaaa..bbbbbbb src/Protos/Grpc/

# for example:
git diff bc30009b8397fc590cdb8d013f5b5d8bfc8acded..1f713a407019b8f441aaa29110b57a7d4cd35c10 src/Protos/Grpc/