tinyrpc: A modular RPC library¶
tinyrpc is a framework for constructing remote procedure call (RPC) services in Python.
tinyrpc all components (transport, protocol and dispatcher) that together make an
RPC service are independently replacable.
Although its initial scope is handling jsonrpc it is easy to add further protocols or add additional transports (one such example is msgpackrpc, which is now fully supported). If so desired it is even possible to replace the default method dispatcher.
Table of contents¶
- Quickstart examples
- Structure of tinyrpc
- The protocol layer
- The JSON-RPC protocol
- The MSGPACK-RPC protocol
- RPC Client
- Server implementations
- The Exceptions hierarchy
pip install tinyrpc
tinyrpc with its default dependencies.
Depending on the protocols and transports you want to use additional dependencies are required. You can instruct pip to install these dependencies by specifying extras to the basic install command.
pip install tinyrpc[httpclient, wsgi]
tinyrpc with dependencies for the httpclient and wsgi transports.
Available extras are:
|Option||Needed to use objects of class|
|gevent||optional in RPCClient, required by RPCServerGreenlets|
|jsonext||optional in JSONRPCProtocol|
|msgpack||required by MSGPACKRPCProtocol|
Marc Brinkmann: https://github.com/mbr
In the end, all these libraries have their own dispatching interfaces and a custom implementation of handling jsonrpc.
tinyrpcaims to do better by dividing the problem into cleanly interchangeable parts that allow easy addition of new transport methods, RPC protocols or dispatchers.
Leo Noordergraaf: https://github.com/lnoor
Looking for a Python jsonrpc library I found
tinyrpc. I was immediately taken by its modular concept and construction.
After creating a couple transports and trying to get them integrated in tinyrpc, I learned that Marc got involved with other projects and that maintaining
tinyrpcbecame too much a burden. I then volunteered to become its maintainer.