iorpc is a Go library for serving and accessing io interfaces across
net/rpc connections. It currently allows serving and accessing both io.Reader
and io.Writer implementations.
This library is useful if you're serving a single io.Reader or
io.Writer to multiple clients. If you're serving a single reader/writer
to only a single client, you should instead just create a TCP listener
and a TCP client and stream the data through using io.Copy which will
adhere to buffers properly.
Standard go get:
$ go get github.com/mitchellh/iorpc
For the most up-to-date examples and usage information, you should always access the documentation. However, for a quick look at what using this library looks like, this basic example is shown below:
// On the server side, you just register your reader onto an RPC
// server, and serve it as usual.
server := rpc.NewServer()
reader := new(bytes.Buffer) // This can be any io.Reader
iorpc.RegisterReader(server, reader)
// On the client side, you connect to an RPC server like usual,
// the use the iorpc client to read it.
client, _ := rpc.Dial("tcp", "127.0.0.1:1234")
reader := iorpc.NewReader(client)
// "reader" is now a valid io.Reader to use that will read data from
// the remote io.Reader