vendor/google.golang.org/grpc/examples/README.md

   1 gRPC in 3 minutes (Go)
   2 ======================
   3
   4 BACKGROUND
   5 -------------
   6 For this sample, we've already generated the server and client stubs from [helloworld.proto](helloworld/helloworld/helloworld.proto).
   7
   8 PREREQUISITES
   9 -------------
  10
  11 - This requires Go 1.6 or later
  12 - Requires that [GOPATH is set](https://golang.org/doc/code.html#GOPATH)
  13
  14 ```
  15 $ go help gopath
  16 $ # ensure the PATH contains $GOPATH/bin
  17 $ export PATH=$PATH:$GOPATH/bin
  18 ```
  19
  20 INSTALL
  21 -------
  22
  23 ```
  24 $ go get -u google.golang.org/grpc/examples/helloworld/greeter_client
  25 $ go get -u google.golang.org/grpc/examples/helloworld/greeter_server
  26 ```
  27
  28 TRY IT!
  29 -------
  30
  31 - Run the server
  32
  33 ```
  34 $ greeter_server &
  35 ```
  36
  37 - Run the client
  38
  39 ```
  40 $ greeter_client
  41 ```
  42
  43 OPTIONAL - Rebuilding the generated code
  44 ----------------------------------------
  45
  46 1 First [install protoc](https://github.com/google/protobuf/blob/master/README.md)
  47   - For now, this needs to be installed from source
  48   - This is will change once proto3 is officially released
  49
  50 2 Install the protoc Go plugin.
  51
  52 ```
  53 $ go get -a github.com/golang/protobuf/protoc-gen-go
  54 ```
  55
  56 3 Rebuild the generated Go code.
  57
  58 ```
  59 $ go generate google.golang.org/grpc/examples/helloworld/...
  60 ```