Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/moul/grpcbin
httpbin like for gRPC
https://github.com/moul/grpcbin
grpc protobuf server stream testing
Last synced: 3 days ago
JSON representation
httpbin like for gRPC
- Host: GitHub
- URL: https://github.com/moul/grpcbin
- Owner: moul
- License: mit
- Created: 2017-12-18T12:46:45.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2025-01-23T19:30:36.000Z (10 days ago)
- Last Synced: 2025-01-24T03:34:41.963Z (10 days ago)
- Topics: grpc, protobuf, server, stream, testing
- Language: Go
- Homepage: https://grpcb.in/
- Size: 2.93 MB
- Stars: 161
- Watchers: 4
- Forks: 27
- Open Issues: 23
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Support: .github/SUPPORT.md
- Authors: AUTHORS
Awesome Lists containing this project
README
# grpcbin
httpbin like for gRPC
[](https://circleci.com/gh/moul/grpcbin)
[](https://hub.docker.com/r/moul/grpcbin/)
[](https://goreportcard.com/report/moul.io/grpcbin)
[](https://godoc.org/moul.io/grpcbin/handler)
[](https://github.com/moul/grpcbin/blob/master/LICENSE)
## Links
* Servers
* insecure gRPC (over HTTP, without TLS): grpc://grpcb.in:9000
* secure gRPC (with let's encrypt TLS): grpc://grpcb.in:443 and grpc://grpcb.in:9001
* webserver: https://grpcb.in
* Services
* [grpcbin.proto](https://github.com/moul/pb/blob/master/grpcbin/grpcbin.proto)
* [hello.proto](https://github.com/moul/pb/blob/master/hello/hello.proto)
* [addsvc.proto](https://github.com/moul/pb/blob/master/addsvc/addsvc.proto)
* Examples
* multiple languages: https://github.com/moul/grpcbin-example
* haskell: https://github.com/lucasdicioccio/http2-client-grpc-example/
## Run server locally
```console
$ docker run -it --rm -p 9000:9000 -p 9001:9001 moul/grpcbin
2017/12/18 14:48:01 listening on :9000 (insecure)
2017/12/18 14:48:01 listening on :9001 (secure)
```
## Example
See examples on a the dedicated repo: [grpcbin-example](https://github.com/moul/grpcbin-example)
---
#### Golang
```go
package main
import (
"fmt"
"log"
"golang.org/x/net/context"
"google.golang.org/grpc"
pb "github.com/moul/pb/grpcbin/go-grpc"
)
func main() {
// dial
conn, _ := grpc.Dial("grpcb.in:9000", grpc.WithInsecure())
defer conn.Close()
// create client and context
client := pb.NewGRPCBinClient(conn)
ctx := context.Background()
// call DummyUnary
res, err := client.DummyUnary(ctx, &pb.DummyMessage{
FString: "hello",
FInt32: 42,
})
if err != nil {
log.Fatalf("failed to call DummyUnary: %v", err)
}
fmt.Println(res)
}
```
---
Example with [grpcc](https://github.com/njpatel/grpcc):
```console
# fetch proto and install tool
$ wget -qN https://github.com/moul/pb/raw/master/grpcbin/grpcbin.proto
$ npm install -g grpcc
# interactive client
$ grpcc -i -p ./grpcbin.proto --address grpcb.in:9000
Connecting to grpcbin.GRPCBin on grpcb.in:9000. Available globals:
client - the client connection to GRPCBin
index (EmptyMessage, callback) returns IndexReply
dummyUnary (DummyMessage, callback) returns DummyMessage
dummyServerStream (DummyMessage, callback) returns DummyMessage
dummyClientStream (DummyMessage, callback) returns DummyMessage
dummyBidirectionalStreamStream (DummyMessage, callback) returns DummyMessage
printReply - function to easily print a unary call reply (alias: pr)
streamReply - function to easily print stream call replies (alias: sr)
createMetadata - convert JS objects into grpc metadata instances (alias: cm)
[email protected]:9000> ^C
# call index endpoint
$ grpcc -i -p ./grpcbin.proto --address grpcb.in:9000 --eval 'client.index({}, printReply)'
{
"description": "gRPC testing server",
"endpoints": [
{
"path": "index",
"description": "This endpoint."
},
{
"path": "dummyUnary",
"description": "Unary endpoint that replies a received DummyMessage."
},
[...]
]
}
# call dummyUnary with arguments
$ grpcc -i -p ./grpcbin.proto --address grpcb.in:9000 --eval 'client.dummyUnary({f_string:"hello",f_int32:42}, printReply)'
{
"f_string": "hello",
"f_strings": [],
"f_int32": 42,
"f_int32s": [],
"f_enum": "ENUM_0",
"f_enums": [],
"f_sub": null,
"f_subs": [],
"f_bool": false,
"f_bools": [],
"f_int64": "0",
"f_int64s": [],
"f_bytes": {
"type": "Buffer",
"data": []
},
"f_bytess": [],
"f_float": 0,
"f_floats": []
}
```