-
Notifications
You must be signed in to change notification settings - Fork 580
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
0 parents
commit cbc4cd3
Showing
3 changed files
with
314 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,74 @@ | ||
| # Contributor Covenant Code of Conduct | ||
|
|
||
| ## Our Pledge | ||
|
|
||
| In the interest of fostering an open and welcoming environment, we as | ||
| contributors and maintainers pledge to making participation in our project and | ||
| our community a harassment-free experience for everyone, regardless of age, body | ||
| size, disability, ethnicity, gender identity and expression, level of experience, | ||
| nationality, personal appearance, race, religion, or sexual identity and | ||
| orientation. | ||
|
|
||
| ## Our Standards | ||
|
|
||
| Examples of behavior that contributes to creating a positive environment | ||
| include: | ||
|
|
||
| * Using welcoming and inclusive language | ||
| * Being respectful of differing viewpoints and experiences | ||
| * Gracefully accepting constructive criticism | ||
| * Focusing on what is best for the community | ||
| * Showing empathy towards other community members | ||
|
|
||
| Examples of unacceptable behavior by participants include: | ||
|
|
||
| * The use of sexualized language or imagery and unwelcome sexual attention or | ||
| advances | ||
| * Trolling, insulting/derogatory comments, and personal or political attacks | ||
| * Public or private harassment | ||
| * Publishing others' private information, such as a physical or electronic | ||
| address, without explicit permission | ||
| * Other conduct which could reasonably be considered inappropriate in a | ||
| professional setting | ||
|
|
||
| ## Our Responsibilities | ||
|
|
||
| Project maintainers are responsible for clarifying the standards of acceptable | ||
| behavior and are expected to take appropriate and fair corrective action in | ||
| response to any instances of unacceptable behavior. | ||
|
|
||
| Project maintainers have the right and responsibility to remove, edit, or | ||
| reject comments, commits, code, wiki edits, issues, and other contributions | ||
| that are not aligned to this Code of Conduct, or to ban temporarily or | ||
| permanently any contributor for other behaviors that they deem inappropriate, | ||
| threatening, offensive, or harmful. | ||
|
|
||
| ## Scope | ||
|
|
||
| This Code of Conduct applies both within project spaces and in public spaces | ||
| when an individual is representing the project or its community. Examples of | ||
| representing a project or community include using an official project e-mail | ||
| address, posting via an official social media account, or acting as an appointed | ||
| representative at an online or offline event. Representation of a project may be | ||
| further defined and clarified by project maintainers. | ||
|
|
||
| ## Enforcement | ||
|
|
||
| Instances of abusive, harassing, or otherwise unacceptable behavior may be | ||
| reported by contacting the project team at [email protected]. All | ||
| complaints will be reviewed and investigated and will result in a response that | ||
| is deemed necessary and appropriate to the circumstances. The project team is | ||
| obligated to maintain confidentiality with regard to the reporter of an incident. | ||
| Further details of specific enforcement policies may be posted separately. | ||
|
|
||
| Project maintainers who do not follow or enforce the Code of Conduct in good | ||
| faith may face temporary or permanent repercussions as determined by other | ||
| members of the project's leadership. | ||
|
|
||
| ## Attribution | ||
|
|
||
| This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, | ||
| available at [http://contributor-covenant.org/version/1/4][version] | ||
|
|
||
| [homepage]: http://contributor-covenant.org | ||
| [version]: http://contributor-covenant.org/version/1/4/ |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,25 @@ | ||
| # Contribution Guidelines | ||
|
|
||
| Please note that this project is released with a | ||
| [Contributor Code of Conduct](code-of-conduct.md). By participating in this | ||
| project you agree to abide by its terms. | ||
|
|
||
| --- | ||
|
|
||
| Ensure your pull request adheres to the following guidelines: | ||
|
|
||
| - Make sure you take care of this | ||
| - And this as well | ||
| - And don't forget to check this | ||
|
|
||
| Thank you for your suggestions! | ||
|
|
||
|
|
||
| ## Updating your PR | ||
|
|
||
| A lot of times, making a PR adhere to the standards above can be difficult. | ||
| If the maintainers notice anything that we'd like changed, we'll ask you to | ||
| edit your PR before we merge it. There's no need to open a new PR, just edit | ||
| the existing one. If you're not sure how to do that, | ||
| [here is a guide](https://github.com/RichardLitt/docs/blob/master/amending-a-commit-guide.md) | ||
| on the different ways you can update your PR so that we can merge it. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,215 @@ | ||
| # Awesome gRPC [](https://github.com/sindresorhus/awesome) | ||
|
|
||
| > A curated list of useful resources for gRPC | ||
|
|
||
| ## Contents | ||
|
|
||
| - [Documentation](#docsumentation) | ||
| - [Community](#community) | ||
| - [Official Libraries and Tools](#officiallibs) | ||
| - [Other](#other) | ||
| * [Tools](#other-tools) | ||
| * [Go](#other-go) | ||
| * [Node.js](#other-nodejs) | ||
| * [Java](#other-java) | ||
| * [Ruby](#other-ruby) | ||
| * [C#](#other-cs) | ||
| * [Rust](#other-rust) | ||
| * [Haskell](#other-hs) | ||
| * [Erlang](#other-erlang) | ||
| * [Elixir](#other-elixir) | ||
| * [Elm](#other-elm) | ||
| * [TypeScript](#other-ts) | ||
| - [Resources](#res) | ||
| * [Tutorials](#res-tuts) | ||
| * [Videos](#res-videos) | ||
| * [Slides](#res-slides) | ||
| * [Examples](#res-examples) | ||
| * [Miscellaneous](#res-misc) | ||
| - [Protocol Buffers](#proto) | ||
| * [Documentation](#proto-docs) | ||
| * [Tools](#proto-tools) | ||
|
|
||
| ## Documentation | ||
|
|
||
| - [Website](https://grpc.io/) - Official documentation, libraries, resources, samples and FAQ | ||
| - [gRPC status codes](https://github.com/grpc/grpc/blob/master/doc/statuscodes.md) - Status codes and their use in gRPC | ||
| - [gRPC status code mapping](https://github.com/grpc/grpc/blob/master/doc/statuscodes.md) - HTTP to gRPC Status Code Mapping | ||
|
|
||
| ## Community | ||
|
|
||
| - [Community links](https://grpc.io/community/) - Mailing list, Gitter, Twitter, Reddit | ||
|
|
||
| ## Official Libraries and Tools | ||
|
|
||
| - [gRPC Core](https://github.com/grpc/grpc) - C, C++, Ruby, Node.js, Python, PHP, C#, Objective-C | ||
| - [gRPC Java](https://github.com/grpc/grpc-java) | ||
| - [gRPC Go](https://github.com/grpc/grpc-go) | ||
| - [gRPC Swift](https://github.com/grpc/grpc-swift) | ||
| - [gRPC Ecosystem](https://github.com/grpc-ecosystem) - gRPC Ecosystem that complements gRPC | ||
| - [gRPC contrib](https://github.com/grpc/grpc-contrib) - Known useful contributions around github | ||
| - [Homebrew gRPC](https://github.com/grpc/homebrew-grpc) - gRPC formulae repo for Homebrew | ||
|
|
||
| ## Other | ||
|
|
||
| <a name="other-tools"></a> | ||
| ### Tools | ||
|
|
||
| - [letmegrpc](https://github.com/gogo/letmegrpc) - generate a web form gui from a grpc specification | ||
| - [grpcc](https://github.com/njpatel/grpcc) - Node.js grpc command-line client | ||
| - [gcall](https://github.com/bojand/gcall) - Simple Node.js gRPC command line interface | ||
| - [kafka-pixy](https://github.com/mwitkow/grpc-proxy) - gRPC/REST proxy for Kafka | ||
| - [ratelimit](https://github.com/lyft/ratelimit) - Go/gRPC service designed to enable generic rate limit scenarios from different types of applications | ||
|
|
||
| <a name="other-go"></a> | ||
| ### Go | ||
|
|
||
| - [go-GRPC Micro](https://github.com/micro/go-grpc) - [Micro](https://github.com/micro) based gRPC framework for microservices | ||
| - [go-kit gRPC](https://github.com/go-kit/kit/tree/master/transport/grpc) - [Go Kit](https://github.com/go-kit) with gRPC as transport | ||
| - [gRPC over NATS](https://github.com/rapidloop/nrpc) - nRPC is an RPC framework like gRPC, but for NATS. | ||
| - [grpcweb](https://github.com/improbable-eng/grpc-web) - gRPC Web implementation for Golang and TypeScript | ||
| - [rpcx](https://github.com/smallnest/rpcx) - A RPC service framework based on net/rpc like alibaba Dubbo and weibo Motan | ||
| - [grpclb](https://github.com/bsm/grpclb) - external Load Balancing Service solution for gRPC written in Go | ||
| - [grpc-proxy](https://github.com/mwitkow/grpc-proxy) - gRPC proxy is a Go reverse proxy that allows for rich routing of gRPC calls with minimum overhead | ||
| - [go-microservice-helpers](https://github.com/google/go-microservice-helpers) - A collection of handy snippets that simplify creation of GRPC servers and clients | ||
| - [lile](https://github.com/lileio/lile) - Easily create gRPC services in Go | ||
| - [proteus](https://github.com/src-d/proteus) - Generate .proto files from Go source code | ||
| - [protoc-gen-cobra](https://github.com/fiorix/protoc-gen-cobra) - [Cobra](https://github.com/spf13/cobra) command line tool generator for Go gRPC | ||
|
|
||
| <a name="other-nodejs"></a> | ||
| ### Node.js | ||
| - [Mali](https://github.com/malijs/mali) - A minimalistic gRPC microservice framework for Node.js | ||
| - [Condor Framework](https://github.com/devsu/condor-framework) - Framework for building GRPC services in Node JS | ||
| - [grpc-caller](https://github.com/bojand/grpc-caller) - An improved Node.js gRPC client | ||
| - [grpc-create-metadata](https://github.com/bojand/grpc-create-metadata) - Helper utility for creating gRPC `Metadata` | ||
| - [grpc-create-error](https://github.com/bojand/grpc-create-error) - Utility function for creating `Errors` for gRPC responses | ||
| - [grpc-error](https://github.com/bojand/grpc-error) - `GRPCError` class that wraps `create-grpc-error` | ||
| - [grpc-inspect](https://github.com/bojand/grpc-inspect) - gRPC protocol buffer inspection utility | ||
| - [Node.js gRPC status codes](https://grpc.io/grpc/node/grpc.html) - The Node.js grpc status codes | ||
| - [Node.js Proto Files](https://github.com/googleapis/nodejs-proto-files) - All of the Google API's protocol buffer files | ||
| - [grpc-bus](https://github.com/paralin/grpc-bus) - Call GRPC services (even streams!) from the browser over any two-way socket to Node and soon Go | ||
| - [grpc-errors](https://github.com/ortoo/grpc-errors) - A quick and easy way of generating errors for use with grpc | ||
|
|
||
| <a name="other-java"></a> | ||
| ### Java | ||
|
|
||
| - [gax-java](https://github.com/googleapis/gax-java) - Google API Extensions for Java | ||
| - [Armeria](https://github.com/line/armeria) - Asynchronous RPC/REST library built on top of Java 8, Netty, HTTP/2, Thrift and gRPC | ||
| - [grpc-spring-boot-starter](https://github.com/yidongnan/grpc-spring-boot-starter) - Spring Boot starter module for gRPC framework | ||
|
|
||
| <a name="other-ruby"></a> | ||
| ### Ruby | ||
|
|
||
| - [gruf](https://github.com/bigcommerce/gruf) - gRPC Ruby Framework | ||
|
|
||
| <a name="other-cs"></a> | ||
| ### C# | ||
|
|
||
| - [MagicOnion](https://github.com/neuecc/MagicOnion) - gRPC based HTTP/2 RPC Streaming Framework for .NET, .NET Core and Unity | ||
|
|
||
| <a name="other-rust"></a> | ||
| ### Rust | ||
|
|
||
| - [grpc-rs](https://github.com/https://github.com/pingcap/grpc-rs) - The gRPC library for Rust built on C Core library and futures | ||
| - [grpc-rust](https://github.com/stepancheg/grpc-rust) - Rust implementation of gRPC | ||
|
|
||
| <a name="other-hs"></a> | ||
| ### Haskell | ||
|
|
||
| - [grpc-haskell](https://github.com/grpc/grpc-haskell) - gRPC library binding for Haskell | ||
|
|
||
| <a name="other-erlang"></a> | ||
| ### Erlang | ||
|
|
||
| - [Erlang grpc](https://github.com/bluehouse-technology/grpc) - Erlang library for GRPC | ||
|
|
||
| <a name="other-elixir"></a> | ||
| ### Elixir | ||
|
|
||
| - [grpc-elixir](https://github.com/tony612/grpc-elixir) - The Elixir implementation of gRPC | ||
|
|
||
| <a name="other-elm"></a> | ||
| ### Elm | ||
|
|
||
| - [elm-protobuf](https://github.com/tiziano88/elm-protobuf) - protobuf plugin generating elm code from proto definitions | ||
|
|
||
| <a name="other-ts"></a> | ||
| ### TypeScript | ||
|
|
||
| - [ts-protoc-gen](https://github.com/improbable-eng/ts-protoc-gen) - Protoc Plugin for TypeScript Declarations | ||
|
|
||
| <a name="#res"></a> | ||
| ## Resources | ||
|
|
||
| <a name="#res-tuts"></a> | ||
| ### Tutorials | ||
|
|
||
| - [Building a gRPC service with Node.js](https://codelabs.developers.google.com/codelabs/cloud-grpc/index.html) - Google Clound Platform Codelab | ||
|
|
||
| <a name="#res-videos"></a> | ||
| ### Videos | ||
|
|
||
| - [gRPC: Google's high-performance, open-source RPC framework](https://www.youtube.com/watch?v=sZx3oZt7LVg) - GothamGo 2015 by Sameer Ajmani | ||
| - [Introduction to gRPC: A general RPC framework that puts mobile and HTTP/2 first](https://www.youtube.com/watch?v=kUz2zjkKxFg) - Devoxx by Mete Atamel | ||
| - [gRPC: The Story of Microservices at Square](https://www.youtube.com/watch?v=-2sWDr3Z0Wo) - apigee webcast | ||
| - [Scalable Realtime Microservices with Kubernetes and gRPC](https://www.youtube.com/watch?v=xb8u2s7cxzg) - Mark Mandel @ Google | ||
| - [Text to Speech server with gRPC and Kubernetes](https://www.youtube.com/watch?v=XaMr--wAuSI) - justforfunc #12 | ||
| - [GRPC Microservices 101](https://www.youtube.com/watch?v=-t57ZQZpjqs) - Google Developer Group Washington by Ray Tsang | ||
| - [Efficient Microservices w/ Binary Protocol - gRPC 101](https://www.youtube.com/watch?v=RqK-mwh3-aY) - by Ray Tsang | ||
| - [grpc: From Tutorial to Production](https://www.youtube.com/watch?v=7FZ6ZyzGex0) - GopherCon 2017 by Alan Shreve | ||
| - [Scalable Microservices with gRPC, Kubernetes, and Docker](https://www.youtube.com/watch?v=xsIwYL-N4vI) - Node Interactive 2016 by Sandeep Dinesh | ||
| - [Building Microservices w/gRPC & Kubernetes](https://www.youtube.com/watch?v=27swR9HACWU) - Philly ETE 2016 #49 by Kelsey Hightower | ||
| - [Building high performance microservices with Kubernetes, Go, and gRPC](https://www.youtube.com/watch?v=YiNt4kUnnIM) - Google Cloud Next '17 by Andrew Jessup | ||
|
|
||
| <a name="#res-slides"></a> | ||
| ### Slides | ||
|
|
||
| - [gRPC Overview](http://www.slideshare.net/VarunTalwar4/grpc-overview) - An overview at gRPC: Talk at Slack by | ||
| Varun Talwar | ||
| - [gRPC Design and Implementation](https://www.slideshare.net/VarunTalwar4/grpc-design-and-implementation) - April 2016 talk at Stanford by Varun Talwar | ||
| - [gRPC - boilerplate to high-performance scalable APIs](https://www.slideshare.net/AboutYouGmbH/robert-kubis-grpc-boilerplate-to-highperformance-scalable-apis-codetalks-2015) - code.talks 2015 by Robert Kubis | ||
| - [HTTP2 and gRPC](https://www.slideshare.net/GuoJing8/http2-and-grpc) - A simple introduction about HTTP2 and gRPC by Xin Gong Chang | ||
| - [gRPC and Microservices](https://www.slideshare.net/blinkingsquirrel/grpc-and-microservices) - Overview of Google's open source microservices framework - gRPC, based on HTTP2 and protocol buffers. Presented at Golang Melbourne, June 2016 by Jonathan Gomez | ||
| - [gRPC and Microservices](https://github.com/jonog/talks/blob/master/src/grpc/grpc-presentation.md) - Golang Melbourne - June 2016 Go Hack Night by Jonathan Gomez | ||
| - [Scalable Microservices with gRPC, Kubernetes, and Containers](https://speakerdeck.com/googlecloudplatform/scalable-microservices-with-grpc-kubernetes-and-containers-devfest-ukraine) - DevFest Ukraine | ||
|
|
||
| <a name="#res-examples"></a> | ||
| ### Examples | ||
|
|
||
| - [gifinator](https://github.com/GoogleCloudPlatform/gifinator) - A sample application demonstrating Kubernetes, gRPC, Go and cute Gophers demoed at Google GCP Next 2017 | ||
| - [Go Microservices Example](https://github.com/harlow/go-micro-services) - HTTP up front, Protobufs in the rear | ||
| - [Streaming RPC's using gRPC](https://github.com/ridha/grpc-streaming-demo) - A quick demo of bi-directional streaming RPC's using grpc, go and python | ||
| - [gRPC Java Demos](https://github.com/saturnism/grpc-java-demos) - A collection of Java gRPC examples | ||
|
|
||
| <a name="#res-misc"></a> | ||
| ### Miscellaneous | ||
|
|
||
| - [gRPC with Load Balancer or Proxy or on AWS](https://gist.github.com/bojand/6a604f7e369d7c7d8c39eb77878a42c2) | ||
|
|
||
| <a name="#proto"></a> | ||
| ## Protocol Buffers | ||
|
|
||
| <a name="#proto-doc"></a> | ||
| ### Documentation | ||
|
|
||
| - [Website](https://developers.google.com/protocol-buffers/) - Official website an documentation | ||
|
|
||
| <a name="#proto-tools"></a> | ||
| ### Tools | ||
|
|
||
| - [prototools](https://github.com/sourcegraph/prototools) - documentation generator & other tools for protobuf/gRPC | ||
| - [protoc-gen-doc](https://github.com/pseudomuto/protoc-gen-doc) - Documentation generator plugin for Google Protocol Buffers | ||
| - [openapi2proto](https://github.com/NYTimes/openapi2proto) - A tool for generating Protobuf v3 schemas and gRPC service definitions from OpenAPI specifications | ||
|
|
||
| ## Contribute | ||
|
|
||
| Contributions welcome! Read the [contribution guidelines](contributing.md) first. | ||
|
|
||
|
|
||
| ## License | ||
|
|
||
| [](http://creativecommons.org/publicdomain/zero/1.0) | ||
|
|
||
| To the extent possible under law, Bojan D. has waived all copyright and | ||
| related or neighboring rights to this work. |