README

   1        tokkee's Go and gRPC talks
   2       ============================
   3
   4   Supporting material for tokkee's talks 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 Presentation slides
  50 -------------------
  51
  52   The 'tex' subdirectory includes the LaTeX code for the presentation slides.
  53
  54   Generate PDF documents:
  55
  56     $ cd $GOPATH/src/tokkee.org/go-talk
  57     $ git submodule update --init
  58     $ cd tex; make
  59
  60 Author
  61 ------
  62
  63   Sebastian 'tokkee' Harl <sh@tokkee.org>
  64
  65   Licensed under the 2-clause BSD license. See LICENSE for details.
  66
  67   For license conditions of subpackages, see the respective LICENSE files in
  68   the subdirectories.