Cheap and reliable Node.js hosting starts at $3/month, and $1/month static HTML hosting

Created with love in Canada, visit hostnodejs.com today

Feel like to post an Ad? Learn Details

All Projects → izumin5210 → Grapi

izumin5210 / Grapi

Licence: mit

😮 A surprisingly easy API server and generator in gRPC and Go

Programming Languages

31211 projects - #10 most used programming language

golang

3204 projects

Labels

api microservice grpc

Projects that are alternatives of or similar to Grapi

Go Grpc Http Rest Microservice Tutorial

Source code for tutorial "How to develop Go gRPC microservice with HTTP/REST endpoint, middleware, Kubernetes deployment, etc."

Stars: ✭ 250 (-31.32%)

Mutual labels: api, microservice, grpc

Jupiter

Jupiter是斗鱼开源的面向服务治理的Golang微服务框架

Stars: ✭ 3,455 (+849.18%)

Mutual labels: microservice, grpc

Lndhub

Wrapper for Lightning Network Daemon. It provides separate accounts and trust minimization for end users

Stars: ✭ 203 (-44.23%)

Mutual labels: api, microservice

Manba

HTTP API Gateway

Stars: ✭ 3,000 (+724.18%)

Mutual labels: api, microservice

Healthcheck

An simple, easily extensible and concurrent health-check library for Go services

Stars: ✭ 161 (-55.77%)

Mutual labels: api, microservice

Tenso

Tenso is an HTTP REST API framework

Stars: ✭ 167 (-54.12%)

Mutual labels: api, microservice

kubernetes-go-grpc

Microservices using Go, gRPC and Kubernates

Stars: ✭ 35 (-90.38%)

Mutual labels: microservice, grpc

Laravel5 Jsonapi

Laravel 5 JSON API Transformer Package

Stars: ✭ 313 (-14.01%)

Mutual labels: api, microservice

Joyrpc

high-performance, high-extensibility Java rpc framework.

Stars: ✭ 290 (-20.33%)

Mutual labels: microservice, grpc

Insomnia

The open-source, cross-platform API client for GraphQL, REST, and gRPC.

Stars: ✭ 18,969 (+5111.26%)

Mutual labels: api, grpc

Tree Gateway

This is a full featured and free API Gateway

Stars: ✭ 160 (-56.04%)

Mutual labels: api, microservice

Furan

Scale out Docker builds

Stars: ✭ 339 (-6.87%)

Mutual labels: microservice, grpc

Appkernel

API development made easy: a smart Python 3 API framework

Stars: ✭ 152 (-58.24%)

Mutual labels: api, microservice

Proteus

Lean, mean, and incredibly fast JVM framework for web and microservice development.

Stars: ✭ 178 (-51.1%)

Mutual labels: api, microservice

Symfony Jsonapi

JSON API Transformer Bundle for Symfony 2 and Symfony 3

Stars: ✭ 114 (-68.68%)

Mutual labels: api, microservice

Memo

The memo elastic and resilient key-value store.

Stars: ✭ 111 (-69.51%)

Mutual labels: api, grpc

Health Checks Api

Standardize the way services and applications expose their status in a distributed application

Stars: ✭ 78 (-78.57%)

Mutual labels: api, microservice

Phalapi

A PHP framework foucs on API fast development.接口，从简单开始！PhalApi简称π框架，一个轻量级PHP开源接口框架，专注于接口服务开发。

Stars: ✭ 1,365 (+275%)

Mutual labels: api, microservice

Turbo

A lightweight microservice tool, turn your grpc|thrift APIs into HTTP APIs!

Stars: ✭ 275 (-24.45%)

Mutual labels: microservice, grpc

Kanary

A minimalist web framework for building REST APIs in Kotlin/Java.

Stars: ✭ 319 (-12.36%)

Mutual labels: api, microservice

View All Similar Projects ➔

😮 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

⚠️ Migrate 0.4.x -> 0.5.x ⚠️

grapiserver will not handle os signals from v0.5.x. We recommend to use appctx.Global() if you want to handle them.

📝 How to migrate

Bump grapi version
- `go get -u github.com/izuimn5210/[email protected]'

Update cmd/server/run.go

 	// Application context
-	ctx := context.Background()
+	ctx := appctx.Global()

-	return s.ServeContext(ctx)
+	return s.Serve(ctx)

⚠️ Migrate 0.3.x -> 0.4.x ⚠️

Some tools that are depended by grapi are updated. If you have a grapi project <=v0.3.x, you should migrate it.

📝 How to migrate

Bump grapi version

If you use dep, update Gopkg.toml

 [[constraint]]
   name = "github.com/izumin5210/grapi"
-  version = "0.3.0"
+  version = "0.4.0"

and run dep ensure

Update gex and tools.go

go get -u github.com/izumin5210/gex/cmd/gex
gex --regen

Initialize Go Modules
- ```
go mod init
go mod tidy
```

Update grapi.toml

package = "yourcompany.yourappname"

[grapi]
server_dir = "./app/server"

[protoc]
protos_dir = "./api/protos"
out_dir = "./api"
import_dirs = [
  "./api/protos",
-  "./vendor/github.com/grpc-ecosystem/grpc-gateway",
-  "./vendor/github.com/grpc-ecosystem/grpc-gateway/third_party/googleapis",
+  '{{ module "github.com/grpc-ecosystem/grpc-gateway" }}',
+  '{{ module "github.com/grpc-ecosystem/grpc-gateway" }}/third_party/googleapis',
]

  [[protoc.plugins]]
  name = "go"
  args = { plugins = "grpc", paths = "source_relative" }

  [[protoc.plugins]]
  name = "grpc-gateway"
  args = { logtostderr = true, paths = "source_relative" }

  [[protoc.plugins]]
  name = "swagger"
  args = { logtostderr = true }

Drop dep
- ```
rm Gopkg.*
```

⚠️ Migrate 0.2.x -> 0.3.x ⚠️

grapi v0.3.0 has some breaking changes. If you have a grapi project <=v0.2.x, you should migrate it.

📝 How to migrate

Bump grapi version

If you use dep, update Gopkg.toml

 [[constraint]]
   name = "github.com/izumin5210/grapi"
-  version = "0.2.2"
+  version = "0.3.0"

and run dep ensure

Introduce gex

go get github.com/izumin5210/gex/cmd/gex

Add defualt generator plugins:

gex \
  --add github.com/izumin5210/grapi/cmd/grapi \
  --add github.com/izumin5210/grapi/cmd/grapi-gen-command \
  --add github.com/izumin5210/grapi/cmd/grapi-gen-service \
  --add github.com/izumin5210/grapi/cmd/grapi-gen-scaffold-service \
  --add github.com/izumin5210/grapi/cmd/grapi-gen-type

Add protoc plugins via gex

gex \
  --add github.com/golang/protobuf/protoc-gen-go \
  --add github.com/grpc-ecosystem/grpc-gateway/protoc-gen-grpc-gateway \
  --add github.com/grpc-ecosystem/grpc-gateway/protoc-gen-swagger

Remove protoc plugins from Gopkg.toml

-required = [
-  "github.com/golang/protobuf/protoc-gen-go",
-  "github.com/grpc-ecosystem/grpc-gateway/protoc-gen-grpc-gateway",
-  "github.com/grpc-ecosystem/grpc-gateway/protoc-gen-swagger",
-]

Update grapi.toml

+package = "yourcompany.yourappname"
+
 [grapi]
 server_dir = "./app/server"

 [protoc]
 protos_dir = "./api/protos"
 out_dir = "./api"
 import_dirs = [
+  "./api/protos",
   "./vendor/github.com/grpc-ecosystem/grpc-gateway",
   "./vendor/github.com/grpc-ecosystem/grpc-gateway/third_party/googleapis",
 ]

   [[protoc.plugins]]
-  path = "./vendor/github.com/golang/protobuf/protoc-gen-go"
   name = "go"
   args = { plugins = "grpc", paths = "source_relative" }

   [[protoc.plugins]]
-  path = "./vendor/github.com/grpc-ecosystem/grpc-gateway/protoc-gen-grpc-gateway"
   name = "grpc-gateway"
-  args = { logtostderr = true }
+  args = { logtostderr = true, paths = "source_relative" }

   [[protoc.plugins]]
-  path = "./vendor/github.com/grpc-ecosystem/grpc-gateway/protoc-gen-swagger"
   name = "swagger"
   args = { logtostderr = true }

Getting Started

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

Installation

grapi
- 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
- macOS
  - brew install izumin5210/tools/grapi
- others
  - go get github.com/izumin5210/grapi/cmd/grapi
dep or Modules
- dep
  - macOS
    - brew install dep
  - others
    - See Installation · dep
    - curl https://raw.githubusercontent.com/golang/dep/master/install.sh | sh
- Modules (experimental)
  - Use Go 1.11 and set GO111MODULE=on your env vars
protoc
- macOS
  - brew install protobuf
- others
  - Download and install from google/protobuf

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].

Stars: ✭ 364

Visit Git Page 🔗Visit User Page 🔗Visit Issues Page (30) 🔗