A simple library service (server and client).
- Service defined in Protocol Buffer v3 (proto3).
- Programming language The Go Programming Langauge (golang).
- RPC framework gRPC.
- Build tool Bazel.
The following instructions are tested on Ubuntu 16.04 (LTS).
-
Install Bazel
Bazel is our build tool. It is written in Java. Install Java and then Bazel.
$ sudo apt-get install bazel
-
Install Git
Git is our version control system. It is used by Bazel to download some of our external dependencies (like Protocol Buffers, gRPC, and Bazel's Go rules.
$ sudo apt-get install git
-
(Optional) Install Go
Go is a programming language and is very good at writting large-scale distributed systems. Our service and client are written in Go.
$ sudo apt-get install golang-go
-
(Optional) Install Gazelle
Gazelle is a helper tool that automatically generates Bazel BUILD files for Go and makes your life easier.
$ go get -u github.com/bazelbuild/bazel-gazelle/cmd/gazelle
-
(Optional) Install Buildifier
Bazel Buildtools are helpers tools for Bazel. Buildifier cleans up and formats Bazel build files.
$ go get github.com/bazelbuild/buildifier/buildifier
$ git clone git@github.com:ghasemloo/libraryservice.git
$ cd libraryservice
$ bazel build ...
$ bazel test ...In one terminal run the server:
$ bazel run server/server -- --logtostderrIn another terminal run the client to send requests to the server:
$ bazel run client/client -- --logtostderr- Bazel: http://bazel.build
- Go: https://golang.org
- Google API Style Guide: https://cloud.google.com/apis/design/
- Proto3: https://developers.google.com/protocol-buffers/
- gRPC: https://www.grpc.io/
- Google RPC Status and Canonical Error Codes
macOS instructions are similar to the instructions above for Ubuntu but follow the installation instructions on each linked site for macOS.