

😮 A surprisingly easy API server and generator in gRPC and Go
Features
- You can develop and deploy API servers blazingly fast ⚡
- Easy code generator
- application (inspired by
rails new
and create-react-app
)
- gRPC services and their implementations (inspired by
rails g (scaffold_)controller
)
- User-friendly
protoc
wrapper (inspired by protoeasy)
- Provides gRPC and HTTP JSON API with single implementation by using grpc-gateway
- Generates codes based on google's API design guideline

Getting Started
Installation
For Homebrew users
$ brew install protobuf
$ brew install izumin5210/tools/grapi
Download built binary
You should install protoc
command from google/protobuf.
- Linux:
curl -Lo grapi https://github.com/izumin5210/grapi/releases/download/v0.2.2/grapi_linux_amd64 && chmod +x grapi && sudo mv grapi /usr/local/bin
- masOS:
curl -Lo grapi https://github.com/izumin5210/grapi/releases/download/v0.2.2/grapi_darwin_amd64 && chmod +x grapi && sudo mv grapi /usr/local/bin
Create a new application
$ grapi init awesome-app
Create a new service
$ grapi g service books
Or, if you need full standard methods, you can get them with following command:
$ grapi g scaffold-service books
And you should register generated services to the grapiserver.Engine
instance:
// app/run.go
// Run starts the grapiserver.
func Run() error {
s := grapiserver.New(
grapiserver.WithDefaultLogger(),
grapiserver.WithServers(
+ server.NewBookServiceServer(),
- // TODO
),
)
return s.Serve()
}
If you updated service definition, you can re-generate .pb.go
and .pb.gw.go
with following command:
$ grapi protoc
Start server
$ grapi server
User-defined commands
$ grapi g command import-books
$ vim cmd/import-books/run.go # implements the command
$ grapi import-books # run the command
Build commands (including server)
$ grapi build