Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/storj/drpc

drpc is a lightweight, drop-in replacement for gRPC
https://github.com/storj/drpc

drpc go grpc microservices nanoservices proto rpc

Last synced: 7 days ago
JSON representation

drpc is a lightweight, drop-in replacement for gRPC

Host: GitHub
URL: https://github.com/storj/drpc
Owner: storj
License: mit
Created: 2019-08-26T22:24:10.000Z (about 5 years ago)
Default Branch: main
Last Pushed: 2024-07-26T17:47:31.000Z (3 months ago)
Last Synced: 2024-10-24T16:18:04.051Z (11 days ago)
Topics: drpc, go, grpc, microservices, nanoservices, proto, rpc
Language: Go
Homepage:
Size: 775 KB
Stars: 1,490
Watchers: 46
Forks: 50
Open Issues: 12
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

awesome-list - drpc - in replacement for gRPC | storj | 840 | (Go)
awesome-golang-repositories - drpc - in replacement for gRPC (Repositories)
best-of-crypto - GitHub - 27% open · ⏱️ 12.03.2024): (Web 3.0)

README

        # [![DRPC](logo.png)](https://storj.github.io/drpc/)

A drop-in, lightweight gRPC replacement.

[![Go Report Card](https://goreportcard.com/badge/storj.io/drpc)](https://goreportcard.com/report/storj.io/drpc)

[![Go Doc](https://img.shields.io/badge/godoc-reference-blue.svg?style=flat-square)](https://pkg.go.dev/storj.io/drpc)

![Beta](https://img.shields.io/badge/version-beta-green.svg)

[![Zulip Chat](https://img.shields.io/badge/zulip-join_chat-brightgreen.svg)](https://drpc.zulipchat.com)

## Links

 * [DRPC website](https://storj.github.io/drpc/)

 * [Examples](https://github.com/storj/drpc/tree/main/examples)

 * [Quickstart documentation](https://storj.github.io/drpc/docs.html)

 * [Launch blog post](https://www.storj.io/blog/introducing-drpc-our-replacement-for-grpc)

## Highlights

* Simple, at just a few thousand [lines of code](#lines-of-code).

* [Small dependencies](./blob/main/go.mod). Only 3 requirements in go.mod, and 9 lines of `go mod graph`!

* Compatible. Works for many gRPC use-cases as-is!

* [Fast](#benchmarks). DRPC has a lightning quick [wire format](https://github.com/storj/drpc/wiki/Docs:-Wire-protocol).

* [Extensible](#external-packages). DRPC is transport agnostic, supports middleware, and is designed around interfaces.

* Battle Tested. Already used in production for years across tens of thousands of servers.

## External Packages

 * [go.bryk.io/pkg/net/drpc](https://pkg.go.dev/go.bryk.io/pkg/net/drpc)

    - Simplified TLS setup (for client and server)

    - Server middleware, including basic components for logging, token-based auth, rate limit, panic recovery, etc

    - Client middleware, including basic components for logging, custom metadata, panic recovery, etc

    - Bi-directional streaming support over upgraded HTTP(S) connections using WebSockets

    - Concurrent RPCs via connection pool

* [go.elara.ws/drpc](https://pkg.go.dev/go.elara.ws/drpc)

    - Concurrent RPCs based on [yamux](https://pkg.go.dev/github.com/hashicorp/yamux)

    - Simple drop-in replacements for `drpcserver` and `drpcconn`

 * Open an issue or join the [Zulip chat](https://drpc.zulipchat.com) if you'd like to be featured here.

 ## Examples

  * [A basic drpc client and server](../../tree/main/examples/drpc)

  * [A basic drpc client and server that also serves a Twirp/grpc-web compatible http server on the same port](../../tree/main/examples/drpc)

  * [Serving gRPC and DRPC on the same port](../../tree/main/examples/grpc_and_drpc)

## Other Languages

DRPC can be made compatible with RPC clients generated from other languages. For example, [Twirp](https://github.com/twitchtv/twirp) clients and [grpc-web](https://github.com/grpc/grpc-web/) clients can be used against the [drpchttp](https://pkg.go.dev/storj.io/drpc/drpchttp) package.

Native implementations can have some advantages, and so some support for other languages are in progress, all in various states of completeness. Join the [Zulip chat](https://drpc.zulipchat.com) if you want more information or to help out with any!

| Language | Repository                          | Status     |

|----------|-------------------------------------|------------|

| C++      | https://github.com/storj/drpc-cpp   | Incomplete |

| Rust     | https://github.com/zeebo/drpc-rs    | Incomplete |

| Node     | https://github.com/mjpitz/drpc-node | Incomplete |

## Licensing

DRPC is licensed under the MIT/expat license. See the LICENSE file for more.

---

## Benchmarks

These microbenchmarks attempt to provide a comparison and come with some caveats. First, it does not send data over a network connection which is expected to be the bottleneck almost all of the time. Second, no attempt was made to do the benchmarks in a controlled environment (CPU scaling disabled, noiseless, etc.). Third, no tuning was done to ensure they're both performing optimally, so there is an inherent advantage for DRPC because the author is familiar with how it works.

    

        Measure

        Benchmark

        Small

        Medium

        Large

    

    

        gRPCDRPCdelta

        gRPCDRPCdelta

        gRPCDRPCdelta

    

    

    

        time/op

        Unitary

        29.7µs8.3µs-72.18%

        36.4µs11.3µs-68.92%

        1.70ms0.54ms-68.24%

    

    

        Input Stream

        1.56µs0.79µs-49.07%

        3.80µs2.04µs-46.28%

        784µs239µs-69.48%

    

    

        Output Stream

        1.51µs0.78µs-48.47%

        3.81µs2.02µs-47.06%

        691µs224µs-67.55%

    

    

        Bidir Stream

        8.79µs3.25µs-63.07%

        13.7µs5.0µs-63.73%

        1.73ms0.47ms-72.72%

    

    

    

        speed

        Unitary

        70.0kB/s240.0kB/s+242.86%

        56.3MB/s181.1MB/s+221.52%

        618MB/s1939MB/s+213.84%

    

    

        Input Stream

        1.28MB/s2.52MB/s+96.11%

        540MB/s1006MB/s+86.16%

        1.34GB/s4.38GB/s+226.51%

    

    

        Output Stream

        1.33MB/s2.57MB/s+93.88%

        538MB/s1017MB/s+89.14%

        1.52GB/s4.68GB/s+208.05%

    

    

        Bidir Stream

        230kB/s616kB/s+167.93%

        149MB/s412MB/s+175.73%

        610MB/s2215MB/s+262.96%

    

    

    

        mem/op

        Unitary

        9.42kB1.42kB-84.95%

        22.7kB7.8kB-65.61%

        6.42MB3.16MB-50.74%

    

    

        Input Stream

        465B80B-82.80%

        7.06kB2.13kB-69.87%

        3.20MB1.05MB-67.10%

    

    

        Output Stream

        360B80B-77.81%

        6.98kB2.13kB-69.52%

        3.20MB1.05MB-67.21%

    

    

        Bidir Stream

        1.09kB0.24kB-77.94%

        14.4kB4.3kB-69.90%

        6.42MB2.10MB-67.22%

    

    

    

        allocs/op

        Unitary

        1827-96.15%

        1849-95.11%

        2809-96.79%

    

    

        Input Stream

        111-90.91%

        122-83.33%

        39.22-94.90%

    

    

        Output Stream

        111-90.91%

        122-83.33%

        382-94.74%

    

    

        Bidir Stream

        433-93.02%

        465-89.13%

        1405-96.43%

    

## Lines of code

DRPC is proud to get as much done in as few lines of code as possible. It's the author's belief that this is only possible by having a clean, strong architecture and that it reduces the chances for bugs to exist (most studies show a linear corellation with number of bugs and lines of code). This table helps keep the library honest, and it would be nice if more libraries considered this.

| Package                              | Lines    |

| ---                                  | ---      |

| storj.io/drpc/drpcstream             | 486      |

| storj.io/drpc/drpchttp               | 478      |

| storj.io/drpc/cmd/protoc-gen-go-drpc | 428      |

| storj.io/drpc/drpcmanager            | 376      |

| storj.io/drpc/drpcwire               | 363      |

| storj.io/drpc/drpcpool               | 279      |

| storj.io/drpc/drpcmigrate            | 239      |

| storj.io/drpc/drpcserver             | 164      |

| storj.io/drpc/drpcconn               | 134      |

| storj.io/drpc/drpcsignal             | 133      |

| storj.io/drpc/drpcmetadata           | 115      |

| storj.io/drpc/drpcmux                | 95       |

| storj.io/drpc/drpccache              | 54       |

| storj.io/drpc                        | 47       |

| storj.io/drpc/drpctest               | 45       |

| storj.io/drpc/drpcerr                | 42       |

| storj.io/drpc/drpcctx                | 41       |

| storj.io/drpc/internal/drpcopts      | 30       |

| storj.io/drpc/drpcstats              | 25       |

| storj.io/drpc/drpcdebug              | 22       |

| storj.io/drpc/drpcenc                | 15       |

| **Total**                            | **3611** |