;ò ëŒü?c@sdZdkZdklZdkZdkZdkZdkZdkZd„Zd„Z d„Z dfd„ƒYZ dei fd „ƒYZ d eie fd „ƒYZd e fd „ƒYZedjo@eddfƒZeieƒeid„dƒeiƒndS(s9 Simple XML-RPC Server. This module can be used to create simple XML-RPC servers by creating a server and either installing functions, a class instance, or by extending the SimpleXMLRPCServer class. It can also be used to handle XML-RPC requests in a CGI environment using CGIXMLRPCRequestHandler. A list of possible usage patterns follows: 1. Install functions: server = SimpleXMLRPCServer(("localhost", 8000)) server.register_function(pow) server.register_function(lambda x,y: x+y, 'add') server.serve_forever() 2. Install an instance: class MyFuncs: def __init__(self): # make all of the string functions available through # string.func_name import string self.string = string def _listMethods(self): # implement this method so that system.listMethods # knows to advertise the strings methods return list_public_methods(self) + ['string.' + method for method in list_public_methods(self.string)] def pow(self, x, y): return pow(x, y) def add(self, x, y) : return x + y server = SimpleXMLRPCServer(("localhost", 8000)) server.register_introspection_functions() server.register_instance(MyFuncs()) server.serve_forever() 3. Install an instance with custom dispatch method: class Math: def _listMethods(self): # this method must be present for system.listMethods # to work return ['add', 'pow'] def _methodHelp(self, method): # this method must be present for system.methodHelp # to work if method == 'add': return "add(2,3) => 5" elif method == 'pow': return "pow(x, y[, z]) => number" else: # By convention, return empty # string if no help is available return "" def _dispatch(self, method, params): if method == 'pow': return pow(*params) elif method == 'add': return params[0] + params[1] else: raise 'bad method' server = SimpleXMLRPCServer(("localhost", 8000)) server.register_introspection_functions() server.register_instance(Math()) server.serve_forever() 4. Subclass SimpleXMLRPCServer: class MathServer(SimpleXMLRPCServer): def _dispatch(self, method, params): try: # We are forcing the 'export_' prefix on methods that are # callable through XML-RPC to prevent potential security # problems func = getattr(self, 'export_' + method) except AttributeError: raise Exception('method "%s" is not supported' % method) else: return func(*params) def export_add(self, x, y): return x + y server = MathServer(("localhost", 8000)) server.serve_forever() 5. CGI script: server = CGIXMLRPCRequestHandler() server.register_function(pow) server.handle_request() N(sFaultcCsUxJ|idƒD]9}|idƒotd|ƒ‚qt||ƒ}qW|SdS(s·resolve_dotted_attribute(a, 'b.c.d') => a.b.c.d Resolves a dotted attribute name to an object. Raises an AttributeError if any attribute in the chain starts with a '_'. s.s_s(attempt to access private attribute "%s"N(sattrssplitsis startswithsAttributeErrorsgetattrsobj(sobjsattrsi((s//mit/python/lib/python2.3/SimpleXMLRPCServer.pysresolve_dotted_attributenscCsZgi}t|ƒD];}|idƒ ott||ƒƒo||ƒqq~SdS(skReturns a list of attribute strings, found in the specified object, which represent callable attributess_N(sappends_[1]sdirsobjsmembers startswithscallablesgetattr(sobjsmembers_[1]((s//mit/python/lib/python2.3/SimpleXMLRPCServer.pyslist_public_methods~scCs/h}x|D]}d|| [3,1,2] Returns a copy of a list without duplicates. Every list item must be hashable and the order of the items in the resulting list is not defined. iN(suslstsxskeys(slstsxsu((s//mit/python/lib/python2.3/SimpleXMLRPCServer.pysremove_duplicates†s sSimpleXMLRPCDispatchercBswtZdZd„Zd„Zed„Zd„Zd„Zed„Z d„Z d„Z d „Z d „Z d „ZRS( s×Mix-in class that dispatches XML-RPC requests. This class is used to register XML-RPC method handlers and then to dispatch them. There should never be any reason to instantiate this class directly. cCsh|_t|_dS(N(sselfsfuncssNonesinstance(sself((s//mit/python/lib/python2.3/SimpleXMLRPCServer.pys__init__›s cCs ||_dS(sôRegisters an instance to respond to XML-RPC requests. Only one instance can be installed at a time. If the registered instance has a _dispatch method then that method will be called with the name of the XML-RPC method and it's parameters as a tuple e.g. instance._dispatch('add',(2,3)) If the registered instance does not have a _dispatch method then the instance will be searched to find a matching method and, if found, will be called. Methods beginning with an '_' are considered private and will not be called by SimpleXMLRPCServer. If a registered function matches a XML-RPC request, then it will be called instead of the registered instance. N(sinstancesself(sselfsinstance((s//mit/python/lib/python2.3/SimpleXMLRPCServer.pysregister_instanceŸscCs+|tjo |i}n||i| ['add', 'subtract', 'multiple'] Returns a list of the methods supported by the server.s _listMethodss _dispatchN( sselfsfuncsskeyssmethodssinstancesNoneshasattrsremove_duplicatess _listMethodsslist_public_methodsssort(sselfsmethods((s//mit/python/lib/python2.3/SimpleXMLRPCServer.pyssystem_listMethodsôs! cCsdSdS(s#system.methodSignature('add') => [double, int, int] Returns a list describing the signiture of the method. In the above example, the add method takes two integers as arguments and returns a double result. This server does NOT support system.methodSignature.ssignatures not supportedN((sselfs method_name((s//mit/python/lib/python2.3/SimpleXMLRPCServer.pyssystem_methodSignature scCsØt}|ii|ƒo|i|}n€|itj oot|idƒo|ii|ƒSq©t|idƒ o0yt |i|ƒ}Wq¥t j oq¥Xq©n|tjodSndk }|i |ƒSdS(s…system.methodHelp('add') => "Adds two integers together" Returns a string containing documentation for the specified method.s _methodHelps _dispatchsN( sNonesmethodsselfsfuncsshas_keys method_namesinstanceshasattrs _methodHelpsresolve_dotted_attributesAttributeErrorspydocsgetdoc(sselfs method_namespydocsmethod((s//mit/python/lib/python2.3/SimpleXMLRPCServer.pyssystem_methodHelps"     cCsÅg}x´|D]¬}|d}|d}y |i|i||ƒgƒWq tj o.}|ihd|i <d|i <ƒq |ihdd<ddt i t if<ƒq Xq W|SdS(sísystem.multicall([{'methodName': 'add', 'params': [2, 2]}, ...]) => [[4], ...] Allows the caller to package multiple XML-RPC calls into a single request. See http://www.xmlrpc.com/discuss/msgReader$1208 s methodNamesparamss faultCodes faultStringis%s:%sN(sresultss call_listscalls method_namesparamssappendsselfs _dispatchsFaultsfaults faultCodes faultStringssyssexc_types exc_value(sselfs call_listsfaultsresultss method_namesparamsscall((s//mit/python/lib/python2.3/SimpleXMLRPCServer.pyssystem_multicall7s   )7cCsÆt}y|i|}Wn}tj oq|itj oZt|idƒo|ii||ƒSq’yt |i|ƒ}Wq’t j oq’Xq—nX|tj o||ŒSnt d|ƒ‚dS(sôDispatches the XML-RPC method. XML-RPC calls are forwarded to a registered function that matches the called XML-RPC method name. If no such function exists then the call is forwarded to the registered instance, if available. If the registered instance has a _dispatch method then that method will be called with the name of the XML-RPC method and it's parameters as a tuple e.g. instance._dispatch('add',(2,3)) If the registered instance does not have a _dispatch method then the instance will be searched to find a matching method and, if found, will be called. Methods beginning with an '_' are considered private and will not be called. s _dispatchsmethod "%s" is not supportedN( sNonesfuncsselfsfuncssmethodsKeyErrorsinstanceshasattrs _dispatchsparamssresolve_dotted_attributesAttributeErrors Exception(sselfsmethodsparamssfunc((s//mit/python/lib/python2.3/SimpleXMLRPCServer.pys _dispatchVs    (s__name__s __module__s__doc__s__init__sregister_instancesNonesregister_functions register_introspection_functionssregister_multicall_functionss_marshaled_dispatchssystem_listMethodsssystem_methodSignaturessystem_methodHelpssystem_multicalls _dispatch(((s//mit/python/lib/python2.3/SimpleXMLRPCServer.pysSimpleXMLRPCDispatcher“s     !   sSimpleXMLRPCRequestHandlercBs&tZdZd„Zddd„ZRS(sƒSimple XML-RPC request handler class. Handles all HTTP POST requests and attempts to decode them as XML-RPC requests. cCsÙyD|iit|idƒƒ}|ii|t|dt ƒƒ}Wn|i dƒ|i ƒnqX|i dƒ|i ddƒ|i dtt|ƒƒƒ|i ƒ|ii|ƒ|iiƒ|iidƒd S( sºHandles the HTTP POST request. Attempts to interpret all HTTP POST requests as XML-RPC calls, which are forwarded to the server's _dispatch method for handling. scontent-lengths _dispatchiôiÈs Content-typestext/xmlsContent-lengthiN(sselfsrfilesreadsintsheaderssdatasservers_marshaled_dispatchsgetattrsNonesresponses send_responses end_headerss send_headersstrslenswfileswritesflushs connectionsshutdown(sselfsdatasresponse((s//mit/python/lib/python2.3/SimpleXMLRPCServer.pysdo_POSTŠs%    s-cCs+|iiotii|||ƒndS(s$Selectively log an accepted request.N(sselfsservers logRequestssBaseHTTPServersBaseHTTPRequestHandlers log_requestscodessize(sselfscodessize((s//mit/python/lib/python2.3/SimpleXMLRPCServer.pys log_request¬s (s__name__s __module__s__doc__sdo_POSTs log_request(((s//mit/python/lib/python2.3/SimpleXMLRPCServer.pysSimpleXMLRPCRequestHandlerƒs  "sSimpleXMLRPCServercBstZdZedd„ZRS(sgSimple XML-RPC server. Simple XML-RPC server that allows functions and a single instance to be installed to handle requests. The default implementation attempts to dispatch XML-RPC calls to the functions or instance installed in the server. Override the _dispatch method inhereted from SimpleXMLRPCDispatcher to change this behavior. icCs0||_ti|ƒtii|||ƒdS(N(s logRequestssselfsSimpleXMLRPCDispatchers__init__s SocketServers TCPServersaddrsrequestHandler(sselfsaddrsrequestHandlers logRequests((s//mit/python/lib/python2.3/SimpleXMLRPCServer.pys__init__½s  (s__name__s __module__s__doc__sSimpleXMLRPCRequestHandlers__init__(((s//mit/python/lib/python2.3/SimpleXMLRPCServer.pysSimpleXMLRPCServer²s sCGIXMLRPCRequestHandlercBs5tZdZd„Zd„Zd„Zed„ZRS(s3Simple handler for XML-RPC data passed through CGI.cCsti|ƒdS(N(sSimpleXMLRPCDispatchers__init__sself(sself((s//mit/python/lib/python2.3/SimpleXMLRPCServer.pys__init__ÇscCs8|i|ƒ}dGHdt|ƒGHHtii|ƒdS(sHandle a single XML-RPC requestsContent-Type: text/xmlsContent-Length: %dN(sselfs_marshaled_dispatchs request_textsresponseslenssyssstdoutswrite(sselfs request_textsresponse((s//mit/python/lib/python2.3/SimpleXMLRPCServer.pys handle_xmlrpcÊs cCs|d}tii|\}}tihd|<d|<d|<}d||fGHdGHdt|ƒGHHt i i |ƒdS( s‹Handle a single HTTP GET request. Default implementation indicates an error because XML-RPC uses the POST method. iscodesmessagesexplains Status: %d %ssContent-Type: text/htmlsContent-Length: %dN( scodesBaseHTTPServersBaseHTTPRequestHandlers responsessmessagesexplainsDEFAULT_ERROR_MESSAGEsresponseslenssyssstdoutswrite(sselfscodesexplainsresponsesmessage((s//mit/python/lib/python2.3/SimpleXMLRPCServer.pys handle_getÔs(cCsh|tjotiidtƒdjo|iƒn.|tjotii ƒ}n|i |ƒdS(sðHandle a single XML-RPC request passed through a CGI post method. If no XML data is given then it is read from stdin. The resulting XML-RPC response is printed to stdout along with the correct HTTP headers. sREQUEST_METHODsGETN( s request_textsNonesossenvironsgetsselfs handle_getssyssstdinsreads handle_xmlrpc(sselfs request_text((s//mit/python/lib/python2.3/SimpleXMLRPCServer.pyshandle_requestës ) (s__name__s __module__s__doc__s__init__s handle_xmlrpcs handle_getsNoneshandle_request(((s//mit/python/lib/python2.3/SimpleXMLRPCServer.pysCGIXMLRPCRequestHandlerÄs   s__main__s localhosti@cCs||S(N(sxsy(sxsy((s//mit/python/lib/python2.3/SimpleXMLRPCServer.pysssadd(s__doc__s xmlrpclibsFaults SocketServersBaseHTTPServerssysstypessossresolve_dotted_attributeslist_public_methodssremove_duplicatessSimpleXMLRPCDispatchersBaseHTTPRequestHandlersSimpleXMLRPCRequestHandlers TCPServersSimpleXMLRPCServersCGIXMLRPCRequestHandlers__name__sserversregister_functionspows serve_forever(sremove_duplicatess SocketServersSimpleXMLRPCRequestHandlersFaults xmlrpclibsSimpleXMLRPCServersCGIXMLRPCRequestHandlerssysslist_public_methodssSimpleXMLRPCDispatchersBaseHTTPServersresolve_dotted_attributesserversosstypes((s//mit/python/lib/python2.3/SimpleXMLRPCServer.pys?as&          ð/9