Go stdlib net/rpc with context.Context support
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
internal/svc
.travis.yml
LICENSE
README.md Merge branch 'upstream' Sep 25, 2018
client.go
client_test.go
debug.go
go.mod
server.go
server_test.go

README.md

rpc Build Status

This is a fork of the stdlib net/rpc which is frozen. It adds support for context.Context on the client and server, including propagating cancellation.

The API is exactly the same, except Client.Call takes a context.Context, and Server methods are expected to take a context.Context as the first argument. Additionally the wire protocol is unchanged, so is backwards compatible with net/rpc clients.

DialHTTPPathTimeout function is also added. A future release of rpc may update all Dial functions to instead take a context.

Why use net/rpc

There are many alternatives for RPC in Go, the most popular being GRPC. However, net/rpc has the following nice properties:

  • Nice API
  • No need for IDL
  • Good performance

The nice API is subjective. However, the API is small, simple and composable. which makes it quite powerful. IDL tools are things like GRPC requiring protoc to generate go code from the protobuf files. net/rpc has no third party dependencies nor code generation step, simplify the use of it. A benchmark done on the 6 Sep 2016 indicated net/rpc was 4x faster than GRPC. This is an outdated benchmark, but is an indication at the surprisingly good performance net/rpc provides.

For more discussion on the pros and cons of net/rpc see the issue proposal: freeze net/rpc.

Details

Last forked from commit 08ab820 on 25 September 2018.

Cancellation implemented via the rpc call _goRPC_.Cancel.