README

   1        tokkee's Go and gRPC talk
   2       ===========================
   3
   4   Supporting material for a talk about Go and gRPC.
   5
   6 Setup
   7 -----
   8
   9   Set up the Go workspace in a directory of your choice (<...>):
  10
  11     $ export GOPATH=<...>
  12     $ export PATH=$GOPATH/bin:$PATH
  13
  14   Get the source:
  15
  16     $ go get -u tokkee.org/go-talk/grpc/...
  17
  18   Install the program binaries:
  19
  20     $ go install tokkee.org/go-talk/grpc/server
  21     $ go install tokkee.org/go-talk/grpc/client
  22     $ go install tokkee.org/go-talk/grpc/ui
  23
  24 Testing
  25 -------
  26
  27   The programs come with a set of sample integration tests which will spin up
  28   test instances of the respective tools and run queries against them.
  29
  30   Run all tests:
  31
  32     $ go test tokkee.org/go-talk/grpc/integration/...
  33
  34 Rebuilding the generated proto / gRPC code
  35 ------------------------------------------
  36
  37   Install protoc from https://github.com/google/protobuf/. We need version 3.
  38
  39   Install the Go gRPC generator plugin:
  40
  41     $ go get github.com/golang/protobuf/protoc-gen-go
  42
  43   Rebuild the code:
  44
  45     $ cd $GOPATH
  46     $ protoc src/tokkee.org/go-talk/grpc/proto/backend/backend.proto \
  47           --go_out=plugins=grpc:.
  48
  49 Author
  50 ------
  51
  52   Sebastian 'tokkee' Harl <sh@tokkee.org>
  53
  54   Licensed under the 2-clause BSD license. See LICENSE for details.