@flytio/protos

What are protocol buffers?

See https://developers.google.com/protocol-buffers/docs/overview

Installation

First you need to install google's proto buffers on your system and typescript

> brew install protobuf

> yarn install

Services

Documentation for each service

• Ordering
• Menu
• Checks
• Stock

How to update the proto definitions for TypeScript

Since there is no protobuf compiler support for TypeScript, we are maintaining the compiled version manually. We are aware that this is a pain, and we'll look to a way of add support to TypeScript, either as our own open source project, or improving the existing plugin (which, at the moment, is not working correctly).

So, when you update proto definitions, you have to:

• Update the TS definitions in the index.ts file.
• Update CHANGELOG.md
• Update the version in package.json.
• Open your PR for review.

After your PR is approved and merged to master:

• CircleCI will build typescript to js files and publish new version https://www.npmjs.com/package/@flytio/protos

Generating protobuf Go files

If you want to generate protos in go you have to:

• Install protobuf using brew: brew install protobuf

• Install golang support for protobufs from here: https://github.com/golang/protobuf

• Clone https://github.com/flypay/protos-go into the parent directory of this repo

• Run this command

> make golang

Troubleshooting

If make golang complains that it can not find executable protoc-gen-go execute the following command from the terminal:

go get -u github.com/golang/protobuf/{proto,protoc-gen-go}