ÿØÿà JFIF ÿÛ „ ( %!1!%*+... 983,7(-.-
ÿØÿà JFIF ÿÛ „ ( %!1!%*+... 983,7(-.-
F\h֏ T S r SSKJrJrJrJrJr SSKJr SSK J
r
SSK J r SSK
r
SSKrSSKrSSKrSSKrSSKrSSKrSSKr SSKrS(S jrS r " S
S 5 r " S S
\5 r " S S\R6 \5 r " S S\ 5 r " S S\5 r " S S\R> 5 r " S S5 r! " S S\5 r" " S S\ \!5 r# " S S \ \!5 r$\%S :X a SSK&r& " S S 5 r'\ " S!5 r(\(RS \*5 \(RS S" S#5 \(RW \'" 5 SS$9 \(RY 5 \-" S%5 \-" S&5 \(R] 5 SSS5 gg! \ a Sr GN'f = f! \/ a \-" S'5 \R` " S5 N;f = f! , ( d f g= f))a 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()
)Faultdumpsloads gzip_encode gzip_decode)BaseHTTPRequestHandler)partial) signatureNTc U( a UR S5 nOU/nU H2 nUR S5 ( a [ SU- 5 e[ X5 n M4 U $ )a3 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).
._z(attempt to access private attribute "%s")split
startswithAttributeErrorgetattr)objattrallow_dotted_namesattrsis $/usr/lib/python3.13/xmlrpc/server.pyresolve_dotted_attributer | s[
3
<< :Q>
#.C
J c [ U 5 Vs/ s H8 nUR S5 ( a M [ [ X5 5 ( d M6 UPM: sn$ s snf )zgReturns a list of attribute strings, found in the specified
object, which represent callable attributesr
)dirr callabler )r members r list_public_methodsr sK "%S 4v ((-
WS 12
4 4 4s AAAc n \ rS rSrSr SS jrSS jrSS jrS rS r SS jr
S
r S r S r
S
rS rSrg)SimpleXMLRPCDispatcher a 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
Nc X 0 U l S U l Xl U=( d SU l X0l g Nutf-8)funcsinstance
allow_noneencodinguse_builtin_typesselfr' r( r) s r __init__ SimpleXMLRPCDispatcher.__init__ s'
$ +G
!2 r c Xl X l g)an 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 an 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 s r register_instance(SimpleXMLRPCDispatcher.register_instance s B !
"4 r c n Uc [ U R US9$ Uc UR nXR U' U$ )zRegisters a function to respond to XML-RPC requests.
The optional name argument can be used to set a Unicode name
for the function.
)name)r register_function__name__r% )r+ functionr2 s r r3 (SimpleXMLRPCDispatcher.register_function s> 411= = <$$D#
4r c ~ U R R U R U R U R S.5 g)zxRegisters the XML-RPC introspection methods in the system
namespace.
see http://xmlrpc.usefulinc.com/doc/reserved.html
)zsystem.listMethodszsystem.methodSignaturezsystem.methodHelpN)r% updatesystem_listMethodssystem_methodSignaturesystem_methodHelpr+ s r register_introspection_functions7SimpleXMLRPCDispatcher.register_introspection_functions s7
$2I2I151L1L,0,B,BD Er c R U R R SU R 05 g)zqRegisters the XML-RPC multicall method in the system
namespace.
see http://www.xmlrpc.com/discuss/msgReader$1208zsystem.multicallN)r% r8 system_multicallr< s r register_multicall_functions3SimpleXMLRPCDispatcher.register_multicall_functions s"
-0E0EFGr c [ XR S9u pEUb U" XT5 nOU R XT5 nU4n[ USU R U R
S9nUR U R
S5 $ ! [ a( n[ XpR U R
S9n SnANISnAf[ aC n[ [
S[ U5 < SU< 35 U R
U R S9n SnANSnAff = f) a 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) N )methodresponser' r( )r' r( :r( r' xmlcharrefreplace)
r r) _dispatchr r' r( r
BaseExceptiontypeencode) r+ datadispatch_methodpathparamsmethodresponsefaultexcs r _marshaled_dispatch*SimpleXMLRPCDispatcher._marshaled_dispatch s "4;Q;Q RNF **6: >>&9 {H Xa(,$--QH t}}.ABB 5 U&*mm5H aDIs34 4??H s$ AA3 3
C0= B
C0-9C++C0c t [ U R R 5 5 nU R b~ [ U R S5 ( a' U[ U R R 5 5 - nO<[ U R S5 ( d! U[ [
U R 5 5 - n[ U5 $ )zosystem.listMethods() => ['add', 'subtract', 'multiple']
Returns a list of the methods supported by the server. _listMethodsrI )setr% keysr& hasattrrX r sorted)r+ methodss r r9 )SimpleXMLRPCDispatcher.system_listMethods s
djjoo'( == $ t}}n553t}} 9 9 ;<< T]]K883 24== ABBg r c g)a 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.zsignatures not supported )r+ method_names r r: -SimpleXMLRPCDispatcher.system_methodSignature) s *r c SnXR ; a U R U nOU R bs [ U R S5 ( a U R R U5 $ [ U R S5 ( d" [ U R UU R
5 nUc g[ R " U5 $ ! [ a N&f = f)z}system.methodHelp('add') => "Adds two integers together"
Returns a string containing documentation for the specified method.N _methodHelprI ) r% r& r[ rd r r r pydocgetdoc)r+ ra rQ s r r; (SimpleXMLRPCDispatcher.system_methodHelp6 s
** $ZZ ,F
]]
&t}}m44}}00== T]]K88 5 $
+ $ 7 7 "F ><<' ' & s !B< <
C C c b / nU H/ nUS nUS n UR U R XE5 /5 M1 U$ ! [ a3 nUR UR UR S.5 SnAMm SnAf[
a/ nUR S[
U5 < SU< 3S.5 SnAM SnAff = f)zsystem.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
methodNamerP ) faultCode faultStringNrD rF )appendrI r rk rl rJ rK )r+ call_listresultscallra rP rS rT s r r@ 'SimpleXMLRPCDispatcher.system_multicallU s D |,K(^F
{ C DE $
#(??%*%6%68 !
#$04S 3%?A
s! !:
B.(A22
B.?$B))B.c U R U nUb U" U6 $ [ SU- 5 e! [ a Of = fU R bq [ U R S5 ( a U R R X5 $ [
U R UU R 5 nUb U" U6 $ O! [ a Of = f[ SU- 5 e)a 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.
z method "%s" is not supportedrI ) r% ExceptionKeyErrorr& r[ rI r r r )r+ rQ rP funcs r rI SimpleXMLRPCDispatcher._dispatcht s * E::f%D V}$ :V CD D == $t}}k22}}..v>>
)/MM++ # =( $ "
6?@@s '
44;!B% %
B21B2)r r' r( r% r& r) FNF)FNN)r4
__module__ __qualname____firstlineno____doc__r, r/ r3 r= rA rU r9 r: r; r@ rI __static_attributes__r` r r r r sL 37#(3"5H EH!CF $ * (> >1Ar r c \ rS rSrSrSrSrSrSr\ R " S\ R \ R - 5 r
S rS rS
rS rS rSS
jrSrg)SimpleXMLRPCRequestHandleri zwSimple XML-RPC request handler class.
Handles all HTTP POST requests and attempts to decode them as
XML-RPC requests.
)/z/RPC2
/pydoc.cssix Tz
\s* ([^\s;]+) \s* #content-coding
(;\s* q \s*=\s* ([0-9\.]+))? #q
c * 0 nU R R SS5 nUR S5 H_ nU R R U5 nU( d M' UR S5 nU( a [
U5 OSnXQUR S5 ' Ma U$ )NzAccept-Encodingre , g ?rD )headersgetr aepatternmatchgroupfloat)r+ raeer vs r accept_encodings+SimpleXMLRPCRequestHandler.accept_encodings sz
\\
/
4# ANN((+EuKKN !E!Hs$%%++a.! r c X U R ( a U R U R ; $ g)NT) rpc_pathsrO r< s r is_rpc_path_valid,SimpleXMLRPCRequestHandler.is_rpc_path_valid s! >>99. . r c U R 5 ( d U R 5 g Sn[ U R S 5 n/ nU( aY [ X!5 nU R
R
U5 nU( d O+UR U5 U[ US 5 - nU( a MY SR U5 nU R U5 nUc gU R R U[ U SS5 U R 5 nU R S5 U R! SS 5 U R" b^ [ U5 U R" : aE U R% 5 R' S
S 5 nU( a [) U5 nU R! S S
5 U R! S
[- [ U5 5 5 U R/ 5 U R0 R3 U5 g! [* a N\f = f! [4 a n U R S5 [7 U R S5 ( ay U R R8 ( a^ U R! S[- U 5 5 [: R< " 5 n
[- U
R? SS5 S5 n
U R! SU
5 U R! S
S5 U R/ 5 Sn A gSn A ff = f)zHandles 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 zcontent-lengthr r rI Content-typeztext/xmlgzipr zContent-EncodingContent-lengthi _send_traceback_headerz X-exceptionASCIIbackslashreplacez X-traceback0) r
report_404intr minrfilereadrm lenjoindecode_request_contentserverrU r rO
send_response send_headerencode_thresholdr r r NotImplementedErrorstr end_headerswfilewriters r[ r traceback
format_excrL ) r+ max_chunk_sizesize_remainingL
chunk_sizechunkrM rR qr traces r do_POST"SimpleXMLRPCRequestHandler.do_POST sS %%'' OO 9 '
*N .>!? @NA @
3 #ae*,
!. 88A;D..t4D| {{66'$ T:DIIH$
s # ^Z 8$$0x=4#8#88 --/33FA>A!'28'%s
)r% Methods functionsre ) itemsr headingr% r+ r\ rm r6 bigsectionr ) r+ server_namepackage_documentationr] fdictkeyvalueheadresultr5 contents method_itemss r docserverServerHTMLDoc.docserver s !--/JC EJ :EL * kk+. :[H d#kk/ G)mc)-#-- gmmo. &JC OODOOEeO D E '// {BGGH$57 7 r c . SnSU- nSU< SU< SU< S3$ )zFormat an HTML page.r z1zI