File: //opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyo
�
�A�[c @` s� d Z d d l m Z m Z m Z m Z d d l m Z m Z d d l m
Z
m Z m Z m
Z
m Z d d l m Z d d l j j j Z d d l m Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z y d d l Z Wn e k
r e Z n Xe d � Z! d � Z" d
e# f d � � YZ$ d e f d
� � YZ% d e j& e$ f d � � YZ' d e' f d � � YZ( d e$ f d � � YZ) d e j* f d � � YZ+ d e# f d � � YZ, d e% f d � � YZ- d e' e, f d � � YZ. d e) e, f d � � YZ/ e0 d k r�d d l1 Z1 d f d � � YZ2 e' d! d" f � Z e j3 e4 � e j3 d# � d$ � e j5 e2 � d% e �e j6 � e7 d& � e7 d' � y e j8 � Wn2 e9 k
r�e7 d( � e j: � e j; d � n Xn d S() uK
Ported using Python-Future from the Python 3.3 standard library.
XML-RPC Servers.
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.
The Doc* classes can be used to create XML-RPC servers that
serve pydoc-style documentation in response to HTTP
GET requests. This documentation is dynamically generated
based on the functions and methods registered with the
server.
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 sys functions available through sys.func_name
import sys
self.sys = sys
def _listMethods(self):
# implement this method so that system.listMethods
# knows to advertise the sys methods
return list_public_methods(self) + \
['sys.' + method for method in list_public_methods(self.sys)]
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 ValueError('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()
i ( t absolute_importt divisiont print_functiont unicode_literals( t intt str( t Faultt dumpst loadst gzip_encodet gzip_decode( t BaseHTTPRequestHandlerN( t socketserverc C` sg | r | j d � } n | g } x? | D]7 } | j d � rP t d | � � q( t | | � } q( W| S( uG 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 '_'.
If the optional allow_dotted_names argument is false, dots are not
supported and this function operates similar to getattr(obj, attr).
u .u _u( attempt to access private attribute "%s"( t splitt
startswitht AttributeErrort getattr( t objt attrt allow_dotted_namest attrst i( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyt resolve_dotted_attribute� s
c C` sB g t | � D]1 } | j d � r
t t | | � � r
| ^ q
S( uk Returns a list of attribute strings, found in the specified
object, which represent callable attributesu _( t dirR t callableR ( R t member( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyt list_public_methods� s t SimpleXMLRPCDispatcherc B` s� e Z d Z e d e d � Z e d � Z d d � Z d � Z d � Z d d d � Z
d � Z d � Z d � Z
d
� Z d � Z RS(
u& Mix-in class that dispatches XML-RPC requests.
This class is used to register XML-RPC method handlers
and then to dispatch them. This class doesn't need to be
instanced directly when used by SimpleXMLRPCServer but it
can be instanced when used by the MultiPathXMLRPCServer
c C` s7 i | _ d | _ | | _ | p$ d | _ | | _ d S( Nu utf-8( t funcst Nonet instancet
allow_nonet encodingt use_builtin_types( t selfR R R! ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyt __init__� s
c C` s | | _ | | _ d S( u 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
its 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.
If the optional allow_dotted_names argument is true and the
instance does not have a _dispatch method, method names
containing dots are supported and resolved, as long as none of
the name segments start with an '_'.
*** SECURITY WARNING: ***
Enabling the allow_dotted_names options allows intruders
to access your module's global variables and may allow
intruders to execute arbitrary code on your machine. Only
use this option on a secure, closed network.
N( R R ( R" R R ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyt register_instance� s ! c C` s) | d k r | j } n | | j | <d S( u� Registers a function to respond to XML-RPC requests.
The optional name argument can be used to set a Unicode name
for the function.
N( R t __name__R ( R" t functiont name( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyt register_function� s c C` s2 | j j i | j d 6| j d 6| j d 6� d S( u� Registers the XML-RPC introspection methods in the system
namespace.
see http://xmlrpc.usefulinc.com/doc/reserved.html
u system.listMethodsu system.methodSignatureu system.methodHelpN( R t updatet system_listMethodst system_methodSignaturet system_methodHelp( R" ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyt register_introspection_functions� s
c C` s | j j i | j d 6� d S( u� Registers the XML-RPC multicall method in the system
namespace.
see http://www.xmlrpc.com/discuss/msgReader$1208u system.multicallN( R R) t system_multicall( R" ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyt register_multicall_functions� s c C` s y| t | d | j �\ } } | d k r< | | | � } n | j | | � } | f } t | d d d | j d | j �} Wn} t k
r� } t | d | j d | j �} nM t j � \ } } }
t t d d | | f � d | j d | j �} n X| j
| j � S( u� Dispatches an XML-RPC method from marshalled (XML) data.
XML-RPC methods are dispatched from the marshalled (XML) data
using the _dispatch method and the result is returned as
marshalled data. For backwards compatibility, a dispatch
function can be provided as an argument (see comment in
SimpleXMLRPCRequestHandler.do_POST) but overriding the
existing method through subclassing is the preferred means
of changing method dispatch behavior.
R! t methodresponsei R R u %s:%sN( R R! R t _dispatchR R R R t syst exc_infot encode( R" t datat dispatch_methodt patht paramst methodt responset faultt exc_typet exc_valuet exc_tb( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyt _marshaled_dispatch� s" c C` s� t | j j � � } | j d k r� t | j d � rR | t | j j � � O} q� t | j d � s� | t t | j � � O} q� n t | � S( uw system.listMethods() => ['add', 'subtract', 'multiple']
Returns a list of the methods supported by the server.u _listMethodsu _dispatchN( t setR t keysR R t hasattrt _listMethodsR t sorted( R" t methods( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyR* s c C` s d S( u# system.methodSignature('add') => [double, int, int]
Returns a list describing the signature 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.u signatures not supported( ( R" t method_name( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyR+ * s c C` s� d } | | j k r% | j | } ny | j d k r� t | j d � rV | j j | � St | j d � s� y t | j | | j � } Wq� t k
r� q� Xq� n | d k r� d St j | � Sd S( u� system.methodHelp('add') => "Adds two integers together"
Returns a string containing documentation for the specified method.u _methodHelpu _dispatchu N(
R R R RB t _methodHelpR R R t pydoct getdoc( R" RF R9 ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyR, 7 s"
c
C` s� g } x� | D]� } | d } | d } y | j | j | | � g � Wq
t k
r} } | j i | j d 6| j d 6� q
t j � \ } } } | j i d d 6d | | f d 6� q
Xq
W| S( u� 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
u
methodNameu paramsu faultCodeu faultStringi u %s:%s( t appendR1 R t faultCodet faultStringR2 R3 (
R" t call_listt resultst callRF R8 R; R< R= R> ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyR. V s
c C` s� d } y | j | } Wnx t k
r� | j d k r� t | j d � r[ | j j | | � Sy t | j | | j � } Wq� t k
r� q� Xq� n X| d k r� | | � St d | � � d S( u� 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
its 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.
u _dispatchu method "%s" is not supportedN(
R R t KeyErrorR RB R1 R R R t Exception( R" R9 R8 t func( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyR1 v s"
N( R% t
__module__t __doc__t FalseR R# R$ R( R- R/ R? R* R+ R, R. R1 ( ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyR � s $ %
t SimpleXMLRPCRequestHandlerc B` s~ e Z d Z d
Z d Z d Z e Z e j d e j
e j B� Z d � Z
d � Z d � Z d � Z d
� Z d d d � Z RS( u� Simple XML-RPC request handler class.
Handles all HTTP POST requests and attempts to decode them as
XML-RPC requests.
u /u /RPC2ix i����u�
\s* ([^\s;]+) \s* #content-coding
(;\s* q \s*=\s* ([0-9\.]+))? #q
c C` s� i } | j j d d � } xl | j d � D][ } | j j | � } | r+ | j d � } | rj t | � n d } | | | j d � <q+ q+ W| S( Nu Accept-Encodingu u ,i g �?i ( t headerst getR
t aepatternt matcht groupt float( R" t rt aet eRZ t v( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyt accept_encodings� s c C` s! | j r | j | j k St Sd S( N( t rpc_pathsR7 t True( R" ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyt is_rpc_path_valid� s c C` sl | j � s | j � d Sy� d } t | j d � } g } xV | r� t | | � } | j j | � } | sp Pn | j | � | t | d � 8} q? Wd j | � } | j
| � } | d k r� d S| j j
| t | d d � | j � } Wn� t k
r�} | j d � t | j d � rx| j j rx| j d
t | � � t j � } t | j d d � d � } | j d
| � n | j d d � | j � n� X| j d � | j d d � | j d k r2t | � | j k r2| j � j d d � }
|
r/y t | � } | j d d � Wq,t k
r(q,Xq/q2n | j d t t | � � � | j � | j j | � d S( u� 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.
Ni
i u content-lengthi����t u _dispatchi� u _send_traceback_headeru X-exceptionu ASCIIu backslashreplaceu X-tracebacku Content-lengthu 0i� u Content-typeu text/xmlu gzipi u Content-Encodingi ( i � (! Rd t
report_404R RW t mint rfilet readRJ t lent joint decode_request_contentR t serverR? R R7 RQ t
send_responseRB t _send_traceback_headert send_headerR t tracebackt
format_excR4 t end_headerst encode_thresholdRa RX R t NotImplementedErrort wfilet write( R" t max_chunk_sizet size_remainingt Lt
chunk_sizet chunkR5 R: R_ t tracet q( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyt do_POST� sX
"
c C` s� | j j d d � j � } | d k r+ | S| d k r� y t | � SWq� t k
rl | j d d | � q� t k
r� | j d d � q� Xn | j d d | � | j d d � | j � d S(
Nu content-encodingu identityu gzipi� u encoding %r not supportedi� u error decoding gzip contentu Content-lengthu 0( RW RX t lowerR
Ru Rn t
ValueErrorRp Rs ( R" R5 R ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyRl s
c C` s] | j d � d } | j d d � | j d t t | � � � | j � | j j | � d S( Ni� s No such pageu Content-typeu
text/plainu Content-length( Rn Rp R Rj Rs Rv Rw ( R" R: ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyRf ' s
u -c C` s& | j j r" t j | | | � n d S( u$ Selectively log an accepted request.N( Rm t logRequestsR t log_request( R" t codet size( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyR� 0 s ( u /u /RPC2( R% RS RT Rb Rt t wbufsizeRc t disable_nagle_algorithmt ret compilet VERBOSEt
IGNORECASERY Ra Rd R Rl Rf R� ( ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyRV � s G t SimpleXMLRPCServerc B` s5 e Z d Z e Z e Z e e e d e e d � Z RS( ug Simple 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 inherited
from SimpleXMLRPCDispatcher to change this behavior.
c C` s� | | _ t j | | | | � t j j | | | | � t d k r� t t d � r� t j | j � t j � } | t j
O} t j | j � t j | � n d S( Nu
FD_CLOEXEC( R� R R# R t TCPServert fcntlR RB t filenot F_GETFDt
FD_CLOEXECt F_SETFD( R" t addrt requestHandlerR� R R t bind_and_activateR! t flags( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyR# I s
N(
R% RS RT Rc t allow_reuse_addressRU Ro RV R R# ( ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyR� 6 s t MultiPathXMLRPCServerc B` sJ e Z d Z e e e d e e d � Z d � Z d � Z d d d � Z
RS( u\ Multipath XML-RPC Server
This specialization of SimpleXMLRPCServer allows the user to create
multiple Dispatcher instances and assign them to different
HTTP request paths. This makes it possible to run two or more
'virtual XML-RPC servers' at the same port.
Make sure that the requestHandler accepts the paths in question.
c C` sG t j | | | | | | | | � i | _ | | _ | p= d | _ d S( Nu utf-8( R� R# t dispatchersR R ( R" R� R� R� R R R� R! ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyR# a s
c C` s | | j | <| S( N( R� ( R" R7 t
dispatcher( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyt add_dispatcherk s
c C` s | j | S( N( R� ( R" R7 ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyt get_dispatchero s c C` s� y | j | j | | | � } Wn` t j � d \ } } t t d d | | f � d | j d | j �} | j | j � } n X| S( Ni i u %s:%sR R ( R� R? R2 R3 R R R R R4 ( R" R5 R6 R7 R: R< R= ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyR? r s
N( R% RS RT RV Rc RU R R# R� R� R? ( ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyR� Y s t CGIXMLRPCRequestHandlerc B` s> e Z d Z e d e d � Z d � Z d � Z d d � Z RS( u3 Simple handler for XML-RPC data passed through CGI.c C` s t j | | | | � d S( N( R R# ( R" R R R! ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyR# � s c C` sh | j | � } t d � t d t | � � t � t j j � t j j j | � t j j j � d S( u Handle a single XML-RPC requestu Content-Type: text/xmlu Content-Length: %dN( R? t printRj R2 t stdoutt flusht bufferRw ( R" t request_textR: ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyt
handle_xmlrpc� s
c C` s� d } t j | \ } } t j i | d 6| d 6| d 6} | j d � } t d | | f � t d t j � t d t | � � t � t j j
� t j j j | � t j j j
� d S(
u� Handle a single HTTP GET request.
Default implementation indicates an error because
XML-RPC uses the POST method.
i� u codeu messageu explainu utf-8u
Status: %d %su Content-Type: %su Content-Length: %dN(
R t responsest http_servert DEFAULT_ERROR_MESSAGER4 R� t DEFAULT_ERROR_CONTENT_TYPERj R2 R� R� R� Rw ( R" R� t messaget explainR: ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyt
handle_get� s
c C` s� | d k r4 t j j d d � d k r4 | j � nm y t t j j d d � � } Wn t t f k
rr d } n X| d k r� t j j
| � } n | j | � d S( u� 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.
u REQUEST_METHODu GETu CONTENT_LENGTHi����N( R t ost environRX R� R R� t TypeErrorR2 t stdinRi R� ( R" R� t length( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyt handle_request� s
N( R% RS RT RU R R# R� R� R� ( ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyR� � s
t
ServerHTMLDocc B` sD e Z d Z d i i i d � Z d i i i d d � Z d � Z RS( u7 Class used to generate pydoc HTML document for a serverc C` s� | p | j } g } d } t j d � } x�| j | | � } | sI Pn | j � \ }
} | j | | | |
!� � | j � \ } }
} } } } |
r� | | � j d d � } | j d | | f � n� | rd t | � } | j d | | | � f � n� | r7d t | � } | j d | | | � f � nl | | | d !d k rp| j | j | | | | � � n3 | r�| j d
| � n | j | j | | � � | } q- W| j | | | � � d j
| � S( u� Mark up some plain text, given a context of symbols to look for.
Each context dictionary maps object names to anchor names.i uM \b((http|ftp)://\S+[\w/]|RFC[- ]?(\d+)|PEP[- ]?(\d+)|(self\.)?((?:\w|\.)+))\bu "u "u <a href="%s">%s</a>u' http://www.rfc-editor.org/rfc/rfc%d.txtu( http://www.python.org/dev/peps/pep-%04d/i u (u self.<strong>%s</strong>u ( t escapeR� R� t searcht spanRJ t groupst replaceR t namelinkRk ( R" t textR� R t classesRE RN t heret patternRZ t startt endt allt schemet rfct pept selfdotR' t url( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyt markup� s8 "
c C` s� | r | j p d d | } d } d | j | � | j | � f }
t j | � r� t j | � } t j | j d | j | j | j d | j
d | j �} n] t j | � r� t j | � } t j | j | j | j | j d | j
d | j �} n d } t
| t � r/| d p| } | d p)d }
n t j | � }
|
| | o[| j d | � } | j |
| j | | | � } | o�d
| } d | | f S( u; Produce HTML documentation for a function or method object.u u -u$ <a name="%s"><strong>%s</strong></a>i t annotationst formatvalueu (...)i u' <font face="helvetica, arial">%s</font>u <dd><tt>%s</tt></dd>u <dl><dt>%s</dt>%s</dl>
( R% R� t inspectt ismethodt getfullargspect
formatargspect argst varargst varkwt defaultsR� R� t
isfunctiont
isinstancet tupleRH RI t greyR� t preformat( R" t objectR' t modR R� RE t clt anchort notet titleR� t argspect docstringt declt doc( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyt
docroutine� s<
c C` s i } x6 | j � D]( \ } } d | | | <| | | | <q W| j | � } d | } | j | d d � } | j | | j | � } | o� d | } | d | } g }
t | j � � } x3 | D]+ \ } } |
j | j | | d | �� q� W| | j d d d d
j |
� � } | S( u1 Produce HTML documentation for an XML-RPC server.u #-u) <big><big><strong>%s</strong></big></big>u #ffffffu #7799eeu <tt>%s</tt>u
<p>%s</p>
R u Methodsu #eeaa77u (
t itemsR� t headingR� R� RD RJ R� t
bigsectionRk ( R" t server_namet package_documentationRE t fdictt keyt valuet headt resultR� t contentst method_items( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyt docserver s"
# N( R% RS RT R R� R� R� ( ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyR� � s
),t XMLRPCDocGeneratorc B` s; e Z d Z d � Z d � Z d � Z d � Z d � Z RS( u� Generates documentation for an XML-RPC server.
This class is designed as mix-in and should not
be constructed directly.
c C` s d | _ d | _ d | _ d S( Nu XML-RPC Server DocumentationuG This server exports the following methods through the XML-RPC protocol.( R� t server_documentationt server_title( R" ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyR# ? s c C` s
| | _ d S( u8 Set the HTML title of the generated server documentationN( R� ( R" R� ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyt set_server_titleG s c C` s
| | _ d S( u7 Set the name of the generated HTML server documentationN( R� ( R" R� ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyt set_server_nameL s c C` s
| | _ d S( u3 Set the documentation string for the entire server.N( R� ( R" R� ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyt set_server_documentationQ s c C` s] i } x | j � D]} | | j k r8 | j | } n� | j d k rd d g } t | j d � r~ | j j | � | d <n t | j d � r� | j j | � | d <n t | � } | d k r� | } qt | j d � sy t | j | � } Wqt k
r | } qXq| } n | | | <q Wt
� } | j | j | j
| � } | j | j | � S( u generate_html_documentation() => html documentation for the server
Generates HTML documentation for the server using introspection for
installed functions and instances that do not implement the
_dispatch method. Alternatively, instances can choose to implement
the _get_method_argstring(method_name) method to provide the
argument string used in the documentation and the
_methodHelp(method_name) method to provide the help text used
in the documentation.u _get_method_argstringi u _methodHelpi u _dispatchN( NN( R* R R R RB t _get_method_argstringRG R� R R R� R� R� R� t pageR� ( R" RE RF R9 t method_infot
documentert
documentation( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyt generate_html_documentationV s8
( R% RS RT R# R� R� R� R� ( ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyR� 8 s t DocXMLRPCRequestHandlerc B` s e Z d Z d � Z RS( u� XML-RPC and documentation request handler class.
Handles all HTTP POST requests and attempts to decode them as
XML-RPC requests.
Handles all HTTP GET requests and interprets them as requests
for documentation.
c C` s� | j � s | j � d S| j j � j d � } | j d � | j d d � | j d t t | � � � | j � | j
j | � d S( u} Handles the HTTP GET request.
Interpret all HTTP GET requests as requests for server
documentation.
Nu utf-8i� u Content-typeu text/htmlu Content-length( Rd Rf Rm R� R4 Rn Rp R Rj Rs Rv Rw ( R" R: ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyt do_GET� s
( R% RS RT R� ( ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyR� � s t DocXMLRPCServerc B` s) e Z d Z e e e d e e d � Z RS( u� XML-RPC and HTML documentation server.
Adds the ability to serve server documentation to the capabilities
of SimpleXMLRPCServer.
c C` s3 t j | | | | | | | | � t j | � d S( N( R� R# R� ( R" R� R� R� R R R� R! ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyR# � s N( R% RS RT R� Rc RU R R# ( ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyR� � s t DocCGIXMLRPCRequestHandlerc B` s e Z d Z d � Z d � Z RS( uJ Handler for XML-RPC data and documentation requests passed through
CGIc C` sn | j � j d � } t d � t d t | � � t � t j j � t j j j | � t j j j � d S( u} Handles the HTTP GET request.
Interpret all HTTP GET requests as requests for server
documentation.
u utf-8u Content-Type: text/htmlu Content-Length: %dN( R� R4 R� Rj R2 R� R� R� Rw ( R" R: ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyR� � s
c C` s t j | � t j | � d S( N( R� R# R� ( R" ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyR# � s
( R% RS RT R� R# ( ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyR� � s u __main__t ExampleServicec B` s$ e Z d � Z d d d � � YZ RS( c C` s d S( Nu 42( ( R" ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyt getData� s t currentTimec B` s e Z e d � � Z RS( c C` s
t j j � S( N( t datetimet now( ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyt getCurrentTime� s ( R% RS t staticmethodR ( ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyR� � s ( ( R% RS R� R� ( ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyR� � s u localhosti@ c C` s | | S( N( ( t xt y( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyt <lambda>� Re u addR u& Serving XML-RPC on localhost port 8000uK It is advisable to run this example server within a secure, closed network.u&
Keyboard interrupt received, exiting.(< RT t
__future__R R R R t future.builtinsR R t future.backports.xmlrpc.clientR R R R R
t future.backports.http.serverR t backportst httpRm R� t future.backportsR R2 R� R� RH R� Rq R� t ImportErrorR Rc R R R� R RV R� R� R� R� t HTMLDocR� R� R� R� R� R% R� R� R( t powR$ R/ R� t
serve_forevert KeyboardInterruptt server_closet exit( ( ( sO /opt/alt/python27/lib/python2.7/site-packages/future/backports/xmlrpc/server.pyt <module>i s` "(
� � "(ErQ