soichisumi/grpc-template

a template repository of gRPC API server with grpc-gateway. grpc-go + grpc-gateway

grpc-custom-error-sample

a template repository of grpc-go + grpc-gateway

Features

• manage external proto files by protodep
• additional samples
  • Customizing Error Response
  • Handling request parameter in an interceptor by using grpc-middleware/tags
  • Authentication in an interceptor

Requirements

• go 1.12 or above
  • brew install go
• Protocol Buffers compiler
  • brew install protobuf
• grpc-go
  • go get -u google.golang.org/grpc
• go protocol buffers plugin
  • go get -u github.com/golang/protobuf/protoc-gen-go
• grpc-gateway protocol buffers plugin
  • go get -u github.com/grpc-ecosystem/grpc-gateway/protoc-gen-grpc-gateway
• protodep
  • go get -u github.com/stormcat24/protodep

Usage

Build

• make proto-build
• make go-build

Run

• launch cmd/api/api and cmd/gw/gw

Request example

• curl localhost:8080/data?param=true

Repository layout

• cmd
  • main applications
• proto
  • proto files
• app
  • internal packages