@chatie/grpc v0.11.42

GRPC

gRPC for Chatie

Usage

Node.js

@chatie/grpc@NPM

Python

chatie-grpc@PyPI

Go

github.com/wechaty/go-grpc

Build

./scripts/install-protoc.sh
npm install

https://github.com/google/protobuf/releases/latest

Generate Stubs

npm run generate

1. JS for Protocol Buffer

protoc \
  --js_out="import_style=commonjs,binary:${OUT_DIR}"

https://github.com/google/protobuf/releases/latest

2. JS for gRPC Stubs

protoc \
  --plugin="protoc-gen-grpc=`which grpc_tools_node_protoc_plugin`" \
  --grpc_out="${OUT_DIR}"

https://www.npmjs.com/package/grpc-tools

3. TypeScript Typing Definations for Protocol Buffer & gRPC Stubs

protoc \
  --plugin="protoc-gen-grpc=node_modules/grpc_tools_node_protoc_ts/bin/protoc-gen-ts" \
  --grpc_out="${OUT_DIR}"

https://github.com/agreatfool/grpc_tools_node_protoc_ts

4. JS & TS for gRPC Web

protoc \
  --plugin="protoc-gen-ts=node_modules/ts-protoc-gen/bin/protoc-gen-ts" \
  --ts_out="service=true:${OUT_DIR}"

https://github.com/improbable-eng/ts-protoc-gen

Development

gRPC CLI Debug

• A gRPC CLI interface for easy testing against gRPC servers with Node.js REPL

grpcc --proto ./service/myservice.proto --address 127.0.0.1:3466

Documentatoin

• Protocol Buffers Language Guide (proto3)
• Google Protocol Buffers Style Guide
• Protocol Buffers for TypeScript with Decorators
• Troubleshooting gRPC
• gRPC environment variables
• How to Interact With and Debug a gRPC Server

Resources

• 探讨gRPC的Node技术生态及实现工具
• gRPC Basics - Node.js
• Building a gRPC service with Node.js
• gRPC in 3 minutes (Node.js)
• Listen gRPC and HTTP requests on the same port
• gRPC to JSON proxy generator following the gRPC HTTP spec
• 如何在 Node.js 中更优雅地使用 gRPC：grpc-helper

Protocol Buffer

• Protocol Buffers for JavaScript (& TypeScript)
• Missing value/null support for scalar value types in proto 3
• How to Make a Nullable Field in Proto3 for a HTTP Response?

gRPC Web

• gRPC-Web: Moving past REST+JSON towards type-safe Web APIs
• Library for making gRPC-Web requests intended for TypeScript from either a browser or Node.js.

TypeScript Generator

• A Typescript definition file generator for gRPC services
• gRPC Web TypeScript Code Generation
• Protocol Buffers Compiler (protoc) plugin for TypeScript and gRPC-Web.

Zoo Keeper

• ZooKeeper - The King of Coordination

STUN

• How To TCP NAT Traversal using Node.js and a STUN Server
• chownat, allows two peers behind two separate NATs to directly communicate with each other.
• What is STUN & TURN Server
• NPM Search for: NAT Traversal
• NAT traversal by way of UPnP or NAT-PMP
• How To TCP NAT Traversal using Node.js and a STUN Server
• STUN, TURN, and ICE - AnyConnect pioneered the STUN, TURN, and ICE NAT Traversal protocols
• What are STUN, TURN, and ICE?
• Set Phasers to STUN/TURN: Getting Started with WebRTC using Node.js, Socket.io and Twilio’s NAT Traversal Service

TCP hole punching

Reverse Engineering

• A toolset for reverse engineering and fuzzing Protobuf-based apps

Python Stub

• gRPC typing stubs for Python

History

v0.11 (Apr 2020)

• Add Go Support (#50 by @dchaofei)
• Publish Go Module at <github.com/wechaty/go-grpc>

v0.6 (Feb 2020)

• Align gRPC Services with Wechaty Puppet Abstraction
• Add Unit Tests

v0.2 (Jul 2018)

• Automatic Generating gRPC Stubs
• Publish to NPM

v0.0.1 (May 2018)

Initial commiit

Author

Huan LI (李卓桓) zixia@zixia.net

Copyright & License

• Code & Docs © 2018-now Huan LI \zixia@zixia.net\
• Code released under the Apache-2.0 License
• Docs released under Creative Commons