wechaty-grpc

Wechaty is a Wechat Bot SDK for Personal Account that lets you create software to extend the functionality of the Wechat, writen in Node.js with TypeScript, Support all platforms including Linux, Windows, Darwin(OSX/Mac) and Docker.

License	Apache License, Version 2.0
Categories	gRPC Net Networking
GroupId	io.github.wechaty
ArtifactId	grpc
Last Version	0.16.1
Release Date	Jun 3, 2020
Type	jar
Description	wechaty-grpc Wechaty is a Wechat Bot SDK for Personal Account that lets you create software to extend the functionality of the Wechat, writen in Node.js with TypeScript, Support all platforms including Linux, Windows, Darwin(OSX/Mac) and Docker.
Project URL	https://github.com/Chatie/grpc
Source Code Management	https://github.com/Chatie/grpc

Download grpc

Filename	Size
grpc-0.16.1.pom
grpc-0.16.1.jar	1 MB
grpc-0.16.1-sources.jar	172 KB
grpc-0.16.1-javadoc.jar	2 MB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/io.github.wechaty/grpc/ -->
<dependency>
    <groupId>io.github.wechaty</groupId>
    <artifactId>grpc</artifactId>
    <version>0.16.1</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/io.github.wechaty/grpc/
implementation 'io.github.wechaty:grpc:0.16.1'

Gradle Kotlin

// https://jarcasting.com/artifacts/io.github.wechaty/grpc/
implementation ("io.github.wechaty:grpc:0.16.1")

Apache Buildr

'io.github.wechaty:grpc:jar:0.16.1'

Apache Ivy

<dependency org="io.github.wechaty" name="grpc" rev="0.16.1">
  <artifact name="grpc" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='io.github.wechaty', module='grpc', version='0.16.1')
)

Scala SBT

libraryDependencies += "io.github.wechaty" % "grpc" % "0.16.1"

Leiningen

[io.github.wechaty/grpc "0.16.1"]

Dependencies

compile (5)

Group / Artifact	Type	Version
com.google.protobuf : protobuf-java	jar	3.12.0
com.google.protobuf : protobuf-java-util	jar	3.12.0
io.grpc : grpc-netty-shaded	jar	1.29.0
io.grpc : grpc-protobuf	jar	1.29.0
io.grpc : grpc-stub	jar	1.29.0

provided (3)

Group / Artifact	Type	Version
io.grpc : grpc-kotlin-stub	jar	0.1.1
org.jetbrains.kotlin : kotlin-stdlib	jar	1.3.72
org.jetbrains.kotlinx : kotlinx-coroutines-core	jar	1.3.4

Project Modules

There are no modules declared in this project.

GRPC

gRPC for Chatie

USAGE

Node.js

@chatie/grpc@NPM

Maintainer:

• @huan - Huan LI (李卓桓)

Python

chatie-grpc@PyPI

Maintainer:

• @wj-Mcat - Jingjing WU (吴京京)

Go

github.com/wechaty/go-grpc

Maintainer:

• @dchaofei - Chaofei DING (丁超飞)

Java

https://mvnrepository.com/artifact/io.github.wechaty/grpc

Maven:

<dependency>
    <groupId>io.github.wechaty</groupId>
    <version>0.11.25</version>
    <artifactId>grpc</artifactId>
</dependency>

Gradle:

compile 'io.github.wechaty:grpc:0.11.25'

Maintainer:

• @diaozxin007 - Zhengxin DIAO (刁政欣)

PHP

github.com/wechaty/php-grpc

Maintainer:

• @zhangchunsheng - Chunsheng ZHANG (张春生)

Csharp

Wechaty.Grpc @ Nuget

Maintainer:

• @Darren - Darren (郑波)

DEVELOPMENT

Debug

• GUI Client for GRPC Services - BloomRPC aim to give the simplest and efficient developer experience for exploring and querying your GRPC services.(Inspired by Postman and GraphQL Playground)
• 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

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

RESOURCES

Documentation

• 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

Links

• 探讨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

csharp grpc

• An introduction to NuGet (microsoft)
• Create a gRPC client and server in ASP.NET Core (microsoft)
• ASP.NET Core 3.0 使用gRPC (晓晨Master)

HISTORY

v0.18 (Oct 15, 2020)

• Add new MessageFileStream and MessageImageStream to replace the MessageFile and MessageImage method to avoid blocking nodejs event loop when sending large files (#88) by @windmemory
• Add new MessageSendFileStream to replace the MessageSendFile method to avoid blocking nodejs event loop when sending large files (#89) by @windmemory

v0.17 (Aug 5, 2020)

• Add PHPH Support (#76 #78) by @zhangchunsheng
• Publish PHP Module at https://github.com/wechaty/php-grpc

v0.13 (Apr 19, 2020)

• Add Java Support (#52 #53 by @diaozxin007)
• Publish Java Module at Open Source Project Repository HostingOSSRH-56843 - Release the Chatie/grpc Java Client

v0.11 (Apr 10, 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

MAINTAINER

Huan LI (李卓桓), Google Developer Expert in Machine Learning (ML GDE), [email protected]

COPYRIGHT & LICENSE

• Code & Docs © 2018-now Huan LI <[email protected]>
• Code released under the Apache-2.0 License
• Docs released under Creative Commons

Chatie

Bot is not born, but made.

Versions

Version
0.16.1 Jun 3, 2020
0.11.25 May 8, 2020