Update of /cvsroot/python/python/dist/src/Doc/lib In directory sc8-pr-cvs1:/tmp/cvs-serv14689/Doc/lib Modified Files: libxmlrpclib.tex Log Message: Patch #531629: Add multicall support. Index: libxmlrpclib.tex =================================================================== RCS file: /cvsroot/python/python/dist/src/Doc/lib/libxmlrpclib.tex,v retrieving revision 1.14 retrieving revision 1.15 diff -C2 -d -r1.14 -r1.15 *** libxmlrpclib.tex 22 Oct 2003 14:12:03 -0000 1.14 --- libxmlrpclib.tex 31 Oct 2003 13:49:36 -0000 1.15 *************** *** 253,256 **** --- 253,285 ---- \end{memberdesc} + \subsection{MultiCall Objects} + + \versionadded{2.4} + + In \url{http://www.xmlrpc.com/discuss/msgReader\$1208}, an approach + is presented to encapsulate multiple calls to a remote server into + a single request. + + \begin{classdesc}{MultiCall}{server} + + Create an object used to boxcar method calls. \var{server} is the + eventual target of the call. Calls can be made to the result object, + but they will immediately return \var{None}, and only store the + call name and parameters in the \class{MultiCall} object. Calling + the object itself causes all stored calls to be transmitted as + a single \code{system.multicall} request. The result of this call + is a generator; iterating over this generator yields the individual + results. + + \end{classdesc} + + A usage example of this class is + + \begin{verbatim} + multicall = MultiCall(server_proxy) + multicall.add(2,3) + multicall.get_address("Guido") + add_result, address = multicall() + \end{verbatim} \subsection{Convenience Functions}