Differences between revisions 3 and 6 (spanning 3 versions)
Revision 3 as of 2004-07-21 01:00:10
Size: 2565
Editor: dsl254-010-130
Comment:
Revision 6 as of 2005-04-15 00:09:03
Size: 6050
Editor: LionKimbro
Comment:
Deletions are marked like this. Additions are marked like this.
Line 56: Line 56:

= Discussion =

I'd like a Python script where:

 * You stick the script in a directory and run it to start a DocXmlRpcServer.
   * command line options (OptParse) for host, port,...
 * Scans all modules in the directory for "XMLRPC_namespace='eggs'"
 * Publishes the functions in the modules that name their XML-RPC namespace.
 * Functions that start with an underscore, don't get published.

This way, you can just write:

{{{
#!python
XMLRPC_namespace = "eggs"

def spam():
    return ["eggs", "and", "spam"]
}}}

..., and, given the script, you have everything you need to make your service callable remotely.

I'll probably end up making this myself, and posting it here. It's not terribly complicated.
The only part I don't know well is the ModulesAsPlugins part-- automatically detecting modules, loading them, and looping through them.

-- LionKimbro [[DateTime(2005-04-14T20:45:05Z)]]

Here's the frame. If someone knows how to fill in the guts, I'd be much obliged.

{{{
#!python
"""Serve specially marked modules by XML-RPC.

  -Hhostname host name, default ""
  -Pportnum port number, default 8000

This script starts an XML-RPC server, and publishes auto-detected
modules from the working directory.

Functions within Modules that define the name "XMLRPC_namespace" are
published. Function names that begin with an underscore (ex: _eggs) are
not published. Functions are published within the XML-RPC namespace
designated by the XMLRPC_namespace value, or the base namespace if the
value is None.
"""

import time

import optparse
import DocXMLRPCServer


def find_modules():
    """Find modules that define XMLRPC_namespace.

    Modules are searched for in the current working directory.

    Modules can define the XMLRPC_namespace to be None, in which case,
    it's functions are placed in the XML-RPC server's base namespace.
    """
    return [] # How do I do this?


def functions_in_module(module):
    """Find all functions in a module."""
    functions = []
    for obj in module.__dict__.values():
        if isinstance(obj, types.FunctionType):
            functions.append(obj)
    return functions


if __name__ == "__main__":
    parser = optparse.OptionParser("usage: %prog [options]\n" + __doc__)
    parser.add_option("-H", "--host", dest="hostname",
                      default="127.0.0.1", type="string",
                      help="specify hostname to run on")
    parser.add_option("-p", "--port", dest="portnum", default=8000,
                      type="int", help="port number to run on")

    (options, args) = parser.parse_args()
    if len(args) != 0:
        parser.error("incorrect number of arguments")

    ServerClass = DocXMLRPCServer.DocXMLRPCServer
    server = ServerClass((options.hostname, options.portnum),
                         logRequests=0)

    for module in find_modules():
        for func in functions_in_module(module):
            full_name = func.__name__
            if module.XMLRPC_namespace is not None:
                full_name = full_name + ".%s" % module.XMLRPC_namespace
            server.register_function(func, full_name)

    server.set_server_title("xrserver")
    server.register_introspection_functions()

    print time.asctime(), 'Application Starting.'
    server.serve_forever()
    print time.asctime(), 'Application Finishing.'
}}}

-- LionKimbro [[DateTime(2005-04-14T21:27:45Z)]]

The page contents below were copied with permission of author (BrianDorsey) from [http://www.seapig.org/DocXMLRPCServer DocXMLRPCServer]. I'd like to rework the page to fit the form of WorkingWithTime, RssLibraries, etc.,. See also: XmlRpc -- LionKimbro DateTime(2004-04-28T05:58:27Z)

Here is a simple server which implements the above message procedure as well as a wait procedure. This server is based on the DocXMLRPCServer included with Python2.3; In Python2.2, use SimpleXMLRPCServer instead, and don't call server.register_introspection_functions().

   1 # ExampleServer.py
   2 import time
   3 import socket
   4 from DocXMLRPCServer import DocXMLRPCServer
   5 
   6 class SimpleShareServer:
   7     def message(self, msg):
   8         """message('Print me!') => True 
   9         
  10         Log everything passed to this function"""
  11         print time.asctime(), msg
  12         return True
  13 
  14     def wait(self, seconds):
  15         """wait(5) => 5 
  16         
  17         Wait for a certain number of seconds before returning.
  18         Returns the same number passed in."""
  19         print time.asctime(), "Waiting %s seconds" % seconds
  20         time.sleep(seconds)
  21         print time.asctime(), "Finished waiting %s seconds" % seconds
  22         return seconds
  23 
  24     
  25 if __name__ == '__main__':
  26     server = DocXMLRPCServer(("", 8000), logRequests=0)
  27     server.register_introspection_functions()
  28     server.register_instance(SimpleShareServer())
  29 
  30     print time.asctime(), 'Application Starting.'
  31     server.serve_forever()
  32     print time.asctime(), 'Application Finishing.'

The benefit of using DocXMLRPCServer is that it automatically creates documentation for your XML-RPC server, just open a browser and head to http://localhost:8000 after starting the server.

Writing a client to call the wait function is left as an exercise for the reader. :)

Resources

Discussion

I'd like a Python script where:

  • You stick the script in a directory and run it to start a DocXmlRpcServer.

    • command line options (OptParse) for host, port,...

  • Scans all modules in the directory for "XMLRPC_namespace='eggs'"
  • Publishes the functions in the modules that name their XML-RPC namespace.
  • Functions that start with an underscore, don't get published.

This way, you can just write:

   1 XMLRPC_namespace = "eggs"
   2 
   3 def spam():
   4     return ["eggs", "and", "spam"]

..., and, given the script, you have everything you need to make your service callable remotely.

I'll probably end up making this myself, and posting it here. It's not terribly complicated. The only part I don't know well is the ModulesAsPlugins part-- automatically detecting modules, loading them, and looping through them.

-- LionKimbro DateTime(2005-04-14T20:45:05Z)

Here's the frame. If someone knows how to fill in the guts, I'd be much obliged.

   1 """Serve specially marked modules by XML-RPC.
   2 
   3   -Hhostname   host name, default ""
   4   -Pportnum    port number, default 8000
   5 
   6 This script starts an XML-RPC server, and publishes auto-detected
   7 modules from the working directory.
   8 
   9 Functions within Modules that define the name "XMLRPC_namespace" are
  10 published. Function names that begin with an underscore (ex: _eggs) are
  11 not published. Functions are published within the XML-RPC namespace
  12 designated by the XMLRPC_namespace value, or the base namespace if the
  13 value is None.
  14 """
  15 
  16 import time
  17 
  18 import optparse
  19 import DocXMLRPCServer
  20 
  21 
  22 def find_modules():
  23     """Find modules that define XMLRPC_namespace.
  24 
  25     Modules are searched for in the current working directory.
  26 
  27     Modules can define the XMLRPC_namespace to be None, in which case,
  28     it's functions are placed in the XML-RPC server's base namespace.
  29     """
  30     return []  # How do I do this?
  31 
  32 
  33 def functions_in_module(module):
  34     """Find all functions in a module."""
  35     functions = []
  36     for obj in module.__dict__.values():
  37         if isinstance(obj, types.FunctionType):
  38             functions.append(obj)
  39     return functions
  40 
  41 
  42 if __name__ == "__main__":
  43     parser = optparse.OptionParser("usage: %prog [options]\n" + __doc__)
  44     parser.add_option("-H", "--host", dest="hostname",
  45                       default="127.0.0.1", type="string",
  46                       help="specify hostname to run on")
  47     parser.add_option("-p", "--port", dest="portnum", default=8000,
  48                       type="int", help="port number to run on")
  49 
  50     (options, args) = parser.parse_args()
  51     if len(args) != 0:
  52         parser.error("incorrect number of arguments")
  53 
  54     ServerClass = DocXMLRPCServer.DocXMLRPCServer
  55     server = ServerClass((options.hostname, options.portnum),
  56                          logRequests=0)
  57 
  58     for module in find_modules():
  59         for func in functions_in_module(module):
  60             full_name = func.__name__
  61             if module.XMLRPC_namespace is not None:
  62                 full_name = full_name + ".%s" % module.XMLRPC_namespace
  63             server.register_function(func, full_name)
  64 
  65     server.set_server_title("xrserver")
  66     server.register_introspection_functions()
  67 
  68     print time.asctime(), 'Application Starting.'
  69     server.serve_forever()
  70     print time.asctime(), 'Application Finishing.'

-- LionKimbro DateTime(2005-04-14T21:27:45Z)

DocXmlRpcServer (last edited 2008-11-15 14:00:01 by localhost)

Unable to edit the page? See the FrontPage for instructions.