RPC Client

RPCClient instances are high-level handlers for making remote procedure calls to servers. Other than RPCProxy objects, they are what most user applications interact with.

Clients needs to be instantiated with a protocol and a transport to function. Proxies are syntactic sugar for using clients.

class tinyrpc.client.RPCClient(protocol, transport)

Bases: object

Client for making RPC calls to connected servers.

Parameters

  • protocol – An RPCProtocol instance.

  • transport – A ClientTransport instance.

batch_call(calls)

Experimental, use at your own peril.

call(method, args, kwargs, one_way=False)

Calls the requested method and returns the result.

If an error occured, an RPCError instance is raised.

Parameters

  • method – Name of the method to call.

  • args – Arguments to pass to the method.

  • kwargs – Keyword arguments to pass to the method.

  • one_way – Whether or not a reply is desired.

call_all(requests)

Calls the methods in the request in parallel.

When the gevent module is already loaded it is assumed to be correctly initialized, including monkey patching if necessary. In that case the RPC calls defined by requests is performed in parallel otherwise the methods are called sequentially.

Parameters

requests – A listof either RPCCall or RPCCallTo elements. When RPCCallTo is used each element defines a transport. Otherwise the default transport set when RPCClient is created is used.

Returns

A list with replies matching the order of the requests.

get_proxy(prefix='', one_way=False)

Convenience method for creating a proxy.

Parameters

  • prefix – Passed on to RPCProxy.

  • one_way – Passed on to RPCProxy.

Returns

RPCProxy instance.

class tinyrpc.client.RPCProxy(client, prefix='', one_way=False)

Bases: object

Create a new remote proxy object.

Proxies allow calling of methods through a simpler interface. See the documentation for an example.

Parameters

  • client – An RPCClient instance.

  • prefix – Prefix to prepend to every method name.

  • one_way – Passed to every call of call().

class tinyrpc.client.RPCCall(method, args, kwargs)

Bases: tuple

Defines the elements of a RPC call.

RPCCall is used with call_all() to provide the list of requests to be processed. Each request contains the elements defined in this tuple.

property args

Alias for field number 1

property kwargs

Alias for field number 2

property method

Alias for field number 0

class tinyrpc.client.RPCCallTo(transport, method, args, kwargs)

Bases: tuple

Defines the elements of a RPC call directed to multiple transports.

RPCCallTo is used with call_all() to provide the list of requests to be processed.

property args

Alias for field number 2

property kwargs

Alias for field number 3

property method

Alias for field number 1

property transport

Alias for field number 0