asda?‰PNG
IHDR ? f ??C1 sRGB ?? é gAMA ±? üa pHYs ? ??o¨d GIDATx^íüL”÷ e÷Y?a?("Bh?_ò???￠§?q5k?*:t0A-o??￥]VkJ￠M??f?±8\k2íll￡1]q?ù???T
server.py 0000644 00000110003 15102763701 0006421 0 ustar 00 r"""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()
"""
# Written by Brian Quinlan (brian@sweetapp.com).
# Based on code written by Fredrik Lundh.
from xmlrpc.client import Fault, dumps, loads, gzip_encode, gzip_decode
from http.server import BaseHTTPRequestHandler
from functools import partial
from inspect import signature
import html
import http.server
import socketserver
import sys
import os
import re
import pydoc
import traceback
try:
import fcntl
except ImportError:
fcntl = None
def resolve_dotted_attribute(obj, attr, allow_dotted_names=True):
"""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).
"""
if allow_dotted_names:
attrs = attr.split('.')
else:
attrs = [attr]
for i in attrs:
if i.startswith('_'):
raise AttributeError(
'attempt to access private attribute "%s"' % i
)
else:
obj = getattr(obj,i)
return obj
def list_public_methods(obj):
"""Returns a list of attribute strings, found in the specified
object, which represent callable attributes"""
return [member for member in dir(obj)
if not member.startswith('_') and
callable(getattr(obj, member))]
class SimpleXMLRPCDispatcher:
"""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
"""
def __init__(self, allow_none=False, encoding=None,
use_builtin_types=False):
self.funcs = {}
self.instance = None
self.allow_none = allow_none
self.encoding = encoding or 'utf-8'
self.use_builtin_types = use_builtin_types
def register_instance(self, instance, allow_dotted_names=False):
"""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.
"""
self.instance = instance
self.allow_dotted_names = allow_dotted_names
def register_function(self, function=None, name=None):
"""Registers a function to respond to XML-RPC requests.
The optional name argument can be used to set a Unicode name
for the function.
"""
# decorator factory
if function is None:
return partial(self.register_function, name=name)
if name is None:
name = function.__name__
self.funcs[name] = function
return function
def register_introspection_functions(self):
"""Registers the XML-RPC introspection methods in the system
namespace.
see http://xmlrpc.usefulinc.com/doc/reserved.html
"""
self.funcs.update({'system.listMethods' : self.system_listMethods,
'system.methodSignature' : self.system_methodSignature,
'system.methodHelp' : self.system_methodHelp})
def register_multicall_functions(self):
"""Registers the XML-RPC multicall method in the system
namespace.
see http://www.xmlrpc.com/discuss/msgReader$1208"""
self.funcs.update({'system.multicall' : self.system_multicall})
def _marshaled_dispatch(self, data, dispatch_method = None, path = None):
"""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.
"""
try:
params, method = loads(data, use_builtin_types=self.use_builtin_types)
# generate response
if dispatch_method is not None:
response = dispatch_method(method, params)
else:
response = self._dispatch(method, params)
# wrap response in a singleton tuple
response = (response,)
response = dumps(response, methodresponse=1,
allow_none=self.allow_none, encoding=self.encoding)
except Fault as fault:
response = dumps(fault, allow_none=self.allow_none,
encoding=self.encoding)
except BaseException as exc:
response = dumps(
Fault(1, "%s:%s" % (type(exc), exc)),
encoding=self.encoding, allow_none=self.allow_none,
)
return response.encode(self.encoding, 'xmlcharrefreplace')
def system_listMethods(self):
"""system.listMethods() => ['add', 'subtract', 'multiple']
Returns a list of the methods supported by the server."""
methods = set(self.funcs.keys())
if self.instance is not None:
# Instance can implement _listMethod to return a list of
# methods
if hasattr(self.instance, '_listMethods'):
methods |= set(self.instance._listMethods())
# if the instance has a _dispatch method then we
# don't have enough information to provide a list
# of methods
elif not hasattr(self.instance, '_dispatch'):
methods |= set(list_public_methods(self.instance))
return sorted(methods)
def system_methodSignature(self, method_name):
"""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."""
# See http://xmlrpc.usefulinc.com/doc/sysmethodsig.html
return 'signatures not supported'
def system_methodHelp(self, method_name):
"""system.methodHelp('add') => "Adds two integers together"
Returns a string containing documentation for the specified method."""
method = None
if method_name in self.funcs:
method = self.funcs[method_name]
elif self.instance is not None:
# Instance can implement _methodHelp to return help for a method
if hasattr(self.instance, '_methodHelp'):
return self.instance._methodHelp(method_name)
# if the instance has a _dispatch method then we
# don't have enough information to provide help
elif not hasattr(self.instance, '_dispatch'):
try:
method = resolve_dotted_attribute(
self.instance,
method_name,
self.allow_dotted_names
)
except AttributeError:
pass
# Note that we aren't checking that the method actually
# be a callable object of some kind
if method is None:
return ""
else:
return pydoc.getdoc(method)
def system_multicall(self, call_list):
"""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
"""
results = []
for call in call_list:
method_name = call['methodName']
params = call['params']
try:
# XXX A marshalling error in any response will fail the entire
# multicall. If someone cares they should fix this.
results.append([self._dispatch(method_name, params)])
except Fault as fault:
results.append(
{'faultCode' : fault.faultCode,
'faultString' : fault.faultString}
)
except BaseException as exc:
results.append(
{'faultCode' : 1,
'faultString' : "%s:%s" % (type(exc), exc)}
)
return results
def _dispatch(self, method, params):
"""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.
"""
try:
# call the matching registered function
func = self.funcs[method]
except KeyError:
pass
else:
if func is not None:
return func(*params)
raise Exception('method "%s" is not supported' % method)
if self.instance is not None:
if hasattr(self.instance, '_dispatch'):
# call the `_dispatch` method on the instance
return self.instance._dispatch(method, params)
# call the instance's method directly
try:
func = resolve_dotted_attribute(
self.instance,
method,
self.allow_dotted_names
)
except AttributeError:
pass
else:
if func is not None:
return func(*params)
raise Exception('method "%s" is not supported' % method)
class SimpleXMLRPCRequestHandler(BaseHTTPRequestHandler):
"""Simple XML-RPC request handler class.
Handles all HTTP POST requests and attempts to decode them as
XML-RPC requests.
"""
# Class attribute listing the accessible path components;
# paths not on this list will result in a 404 error.
rpc_paths = ('/', '/RPC2', '/pydoc.css')
#if not None, encode responses larger than this, if possible
encode_threshold = 1400 #a common MTU
#Override form StreamRequestHandler: full buffering of output
#and no Nagle.
wbufsize = -1
disable_nagle_algorithm = True
# a re to match a gzip Accept-Encoding
aepattern = re.compile(r"""
\s* ([^\s;]+) \s* #content-coding
(;\s* q \s*=\s* ([0-9\.]+))? #q
""", re.VERBOSE | re.IGNORECASE)
def accept_encodings(self):
r = {}
ae = self.headers.get("Accept-Encoding", "")
for e in ae.split(","):
match = self.aepattern.match(e)
if match:
v = match.group(3)
v = float(v) if v else 1.0
r[match.group(1)] = v
return r
def is_rpc_path_valid(self):
if self.rpc_paths:
return self.path in self.rpc_paths
else:
# If .rpc_paths is empty, just assume all paths are legal
return True
def do_POST(self):
"""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.
"""
# Check that the path is legal
if not self.is_rpc_path_valid():
self.report_404()
return
try:
# Get arguments by reading body of request.
# We read this in chunks to avoid straining
# socket.read(); around the 10 or 15Mb mark, some platforms
# begin to have problems (bug #792570).
max_chunk_size = 10*1024*1024
size_remaining = int(self.headers["content-length"])
L = []
while size_remaining:
chunk_size = min(size_remaining, max_chunk_size)
chunk = self.rfile.read(chunk_size)
if not chunk:
break
L.append(chunk)
size_remaining -= len(L[-1])
data = b''.join(L)
data = self.decode_request_content(data)
if data is None:
return #response has been sent
# In previous versions of SimpleXMLRPCServer, _dispatch
# could be overridden in this class, instead of in
# SimpleXMLRPCDispatcher. To maintain backwards compatibility,
# check to see if a subclass implements _dispatch and dispatch
# using that method if present.
response = self.server._marshaled_dispatch(
data, getattr(self, '_dispatch', None), self.path
)
except Exception as e: # This should only happen if the module is buggy
# internal error, report as HTTP server error
self.send_response(500)
# Send information about the exception if requested
if hasattr(self.server, '_send_traceback_header') and \
self.server._send_traceback_header:
self.send_header("X-exception", str(e))
trace = traceback.format_exc()
trace = str(trace.encode('ASCII', 'backslashreplace'), 'ASCII')
self.send_header("X-traceback", trace)
self.send_header("Content-length", "0")
self.end_headers()
else:
self.send_response(200)
self.send_header("Content-type", "text/xml")
if self.encode_threshold is not None:
if len(response) > self.encode_threshold:
q = self.accept_encodings().get("gzip", 0)
if q:
try:
response = gzip_encode(response)
self.send_header("Content-Encoding", "gzip")
except NotImplementedError:
pass
self.send_header("Content-length", str(len(response)))
self.end_headers()
self.wfile.write(response)
def decode_request_content(self, data):
#support gzip encoding of request
encoding = self.headers.get("content-encoding", "identity").lower()
if encoding == "identity":
return data
if encoding == "gzip":
try:
return gzip_decode(data)
except NotImplementedError:
self.send_response(501, "encoding %r not supported" % encoding)
except ValueError:
self.send_response(400, "error decoding gzip content")
else:
self.send_response(501, "encoding %r not supported" % encoding)
self.send_header("Content-length", "0")
self.end_headers()
def report_404 (self):
# Report a 404 error
self.send_response(404)
response = b'No such page'
self.send_header("Content-type", "text/plain")
self.send_header("Content-length", str(len(response)))
self.end_headers()
self.wfile.write(response)
def log_request(self, code='-', size='-'):
"""Selectively log an accepted request."""
if self.server.logRequests:
BaseHTTPRequestHandler.log_request(self, code, size)
class SimpleXMLRPCServer(socketserver.TCPServer,
SimpleXMLRPCDispatcher):
"""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.
"""
allow_reuse_address = True
# Warning: this is for debugging purposes only! Never set this to True in
# production code, as will be sending out sensitive information (exception
# and stack trace details) when exceptions are raised inside
# SimpleXMLRPCRequestHandler.do_POST
_send_traceback_header = False
def __init__(self, addr, requestHandler=SimpleXMLRPCRequestHandler,
logRequests=True, allow_none=False, encoding=None,
bind_and_activate=True, use_builtin_types=False):
self.logRequests = logRequests
SimpleXMLRPCDispatcher.__init__(self, allow_none, encoding, use_builtin_types)
socketserver.TCPServer.__init__(self, addr, requestHandler, bind_and_activate)
class MultiPathXMLRPCServer(SimpleXMLRPCServer):
"""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.
"""
def __init__(self, addr, requestHandler=SimpleXMLRPCRequestHandler,
logRequests=True, allow_none=False, encoding=None,
bind_and_activate=True, use_builtin_types=False):
SimpleXMLRPCServer.__init__(self, addr, requestHandler, logRequests, allow_none,
encoding, bind_and_activate, use_builtin_types)
self.dispatchers = {}
self.allow_none = allow_none
self.encoding = encoding or 'utf-8'
def add_dispatcher(self, path, dispatcher):
self.dispatchers[path] = dispatcher
return dispatcher
def get_dispatcher(self, path):
return self.dispatchers[path]
def _marshaled_dispatch(self, data, dispatch_method = None, path = None):
try:
response = self.dispatchers[path]._marshaled_dispatch(
data, dispatch_method, path)
except BaseException as exc:
# report low level exception back to server
# (each dispatcher should have handled their own
# exceptions)
response = dumps(
Fault(1, "%s:%s" % (type(exc), exc)),
encoding=self.encoding, allow_none=self.allow_none)
response = response.encode(self.encoding, 'xmlcharrefreplace')
return response
class CGIXMLRPCRequestHandler(SimpleXMLRPCDispatcher):
"""Simple handler for XML-RPC data passed through CGI."""
def __init__(self, allow_none=False, encoding=None, use_builtin_types=False):
SimpleXMLRPCDispatcher.__init__(self, allow_none, encoding, use_builtin_types)
def handle_xmlrpc(self, request_text):
"""Handle a single XML-RPC request"""
response = self._marshaled_dispatch(request_text)
print('Content-Type: text/xml')
print('Content-Length: %d' % len(response))
print()
sys.stdout.flush()
sys.stdout.buffer.write(response)
sys.stdout.buffer.flush()
def handle_get(self):
"""Handle a single HTTP GET request.
Default implementation indicates an error because
XML-RPC uses the POST method.
"""
code = 400
message, explain = BaseHTTPRequestHandler.responses[code]
response = http.server.DEFAULT_ERROR_MESSAGE % \
{
'code' : code,
'message' : message,
'explain' : explain
}
response = response.encode('utf-8')
print('Status: %d %s' % (code, message))
print('Content-Type: %s' % http.server.DEFAULT_ERROR_CONTENT_TYPE)
print('Content-Length: %d' % len(response))
print()
sys.stdout.flush()
sys.stdout.buffer.write(response)
sys.stdout.buffer.flush()
def handle_request(self, request_text=None):
"""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.
"""
if request_text is None and \
os.environ.get('REQUEST_METHOD', None) == 'GET':
self.handle_get()
else:
# POST data is normally available through stdin
try:
length = int(os.environ.get('CONTENT_LENGTH', None))
except (ValueError, TypeError):
length = -1
if request_text is None:
request_text = sys.stdin.read(length)
self.handle_xmlrpc(request_text)
# -----------------------------------------------------------------------------
# Self documenting XML-RPC Server.
class ServerHTMLDoc(pydoc.HTMLDoc):
"""Class used to generate pydoc HTML document for a server"""
def markup(self, text, escape=None, funcs={}, classes={}, methods={}):
"""Mark up some plain text, given a context of symbols to look for.
Each context dictionary maps object names to anchor names."""
escape = escape or self.escape
results = []
here = 0
# XXX Note that this regular expression does not allow for the
# hyperlinking of arbitrary strings being used as method
# names. Only methods with names consisting of word characters
# and '.'s are hyperlinked.
pattern = re.compile(r'\b((http|https|ftp)://\S+[\w/]|'
r'RFC[- ]?(\d+)|'
r'PEP[- ]?(\d+)|'
r'(self\.)?((?:\w|\.)+))\b')
while 1:
match = pattern.search(text, here)
if not match: break
start, end = match.span()
results.append(escape(text[here:start]))
all, scheme, rfc, pep, selfdot, name = match.groups()
if scheme:
url = escape(all).replace('"', '"')
results.append('%s' % (url, url))
elif rfc:
url = 'https://www.rfc-editor.org/rfc/rfc%d.txt' % int(rfc)
results.append('%s' % (url, escape(all)))
elif pep:
url = 'https://peps.python.org/pep-%04d/' % int(pep)
results.append('%s' % (url, escape(all)))
elif text[end:end+1] == '(':
results.append(self.namelink(name, methods, funcs, classes))
elif selfdot:
results.append('self.%s' % name)
else:
results.append(self.namelink(name, classes))
here = end
results.append(escape(text[here:]))
return ''.join(results)
def docroutine(self, object, name, mod=None,
funcs={}, classes={}, methods={}, cl=None):
"""Produce HTML documentation for a function or method object."""
anchor = (cl and cl.__name__ or '') + '-' + name
note = ''
title = '%s' % (
self.escape(anchor), self.escape(name))
if callable(object):
argspec = str(signature(object))
else:
argspec = '(...)'
if isinstance(object, tuple):
argspec = object[0] or argspec
docstring = object[1] or ""
else:
docstring = pydoc.getdoc(object)
decl = title + argspec + (note and self.grey(
'%s' % note))
doc = self.markup(
docstring, self.preformat, funcs, classes, methods)
doc = doc and '
%s
' % doc
return '
%s
%s
\n' % (decl, doc)
def docserver(self, server_name, package_documentation, methods):
"""Produce HTML documentation for an XML-RPC server."""
fdict = {}
for key, value in methods.items():
fdict[key] = '#-' + key
fdict[value] = fdict[key]
server_name = self.escape(server_name)
head = '%s' % server_name
result = self.heading(head)
doc = self.markup(package_documentation, self.preformat, fdict)
doc = doc and '%s' % doc
result = result + '
%s
\n' % doc
contents = []
method_items = sorted(methods.items())
for key, value in method_items:
contents.append(self.docroutine(value, key, funcs=fdict))
result = result + self.bigsection(
'Methods', 'functions', ''.join(contents))
return result
def page(self, title, contents):
"""Format an HTML page."""
css_path = "/pydoc.css"
css_link = (
'' %
css_path)
return '''\
Python: %s
%s%s''' % (title, css_link, contents)
class XMLRPCDocGenerator:
"""Generates documentation for an XML-RPC server.
This class is designed as mix-in and should not
be constructed directly.
"""
def __init__(self):
# setup variables used for HTML documentation
self.server_name = 'XML-RPC Server Documentation'
self.server_documentation = \
"This server exports the following methods through the XML-RPC "\
"protocol."
self.server_title = 'XML-RPC Server Documentation'
def set_server_title(self, server_title):
"""Set the HTML title of the generated server documentation"""
self.server_title = server_title
def set_server_name(self, server_name):
"""Set the name of the generated HTML server documentation"""
self.server_name = server_name
def set_server_documentation(self, server_documentation):
"""Set the documentation string for the entire server."""
self.server_documentation = server_documentation
def generate_html_documentation(self):
"""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."""
methods = {}
for method_name in self.system_listMethods():
if method_name in self.funcs:
method = self.funcs[method_name]
elif self.instance is not None:
method_info = [None, None] # argspec, documentation
if hasattr(self.instance, '_get_method_argstring'):
method_info[0] = self.instance._get_method_argstring(method_name)
if hasattr(self.instance, '_methodHelp'):
method_info[1] = self.instance._methodHelp(method_name)
method_info = tuple(method_info)
if method_info != (None, None):
method = method_info
elif not hasattr(self.instance, '_dispatch'):
try:
method = resolve_dotted_attribute(
self.instance,
method_name
)
except AttributeError:
method = method_info
else:
method = method_info
else:
assert 0, "Could not find method in self.functions and no "\
"instance installed"
methods[method_name] = method
documenter = ServerHTMLDoc()
documentation = documenter.docserver(
self.server_name,
self.server_documentation,
methods
)
return documenter.page(html.escape(self.server_title), documentation)
class DocXMLRPCRequestHandler(SimpleXMLRPCRequestHandler):
"""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.
"""
def _get_css(self, url):
path_here = os.path.dirname(os.path.realpath(__file__))
css_path = os.path.join(path_here, "..", "pydoc_data", "_pydoc.css")
with open(css_path, mode="rb") as fp:
return fp.read()
def do_GET(self):
"""Handles the HTTP GET request.
Interpret all HTTP GET requests as requests for server
documentation.
"""
# Check that the path is legal
if not self.is_rpc_path_valid():
self.report_404()
return
if self.path.endswith('.css'):
content_type = 'text/css'
response = self._get_css(self.path)
else:
content_type = 'text/html'
response = self.server.generate_html_documentation().encode('utf-8')
self.send_response(200)
self.send_header('Content-Type', '%s; charset=UTF-8' % content_type)
self.send_header("Content-length", str(len(response)))
self.end_headers()
self.wfile.write(response)
class DocXMLRPCServer( SimpleXMLRPCServer,
XMLRPCDocGenerator):
"""XML-RPC and HTML documentation server.
Adds the ability to serve server documentation to the capabilities
of SimpleXMLRPCServer.
"""
def __init__(self, addr, requestHandler=DocXMLRPCRequestHandler,
logRequests=True, allow_none=False, encoding=None,
bind_and_activate=True, use_builtin_types=False):
SimpleXMLRPCServer.__init__(self, addr, requestHandler, logRequests,
allow_none, encoding, bind_and_activate,
use_builtin_types)
XMLRPCDocGenerator.__init__(self)
class DocCGIXMLRPCRequestHandler( CGIXMLRPCRequestHandler,
XMLRPCDocGenerator):
"""Handler for XML-RPC data and documentation requests passed through
CGI"""
def handle_get(self):
"""Handles the HTTP GET request.
Interpret all HTTP GET requests as requests for server
documentation.
"""
response = self.generate_html_documentation().encode('utf-8')
print('Content-Type: text/html')
print('Content-Length: %d' % len(response))
print()
sys.stdout.flush()
sys.stdout.buffer.write(response)
sys.stdout.buffer.flush()
def __init__(self):
CGIXMLRPCRequestHandler.__init__(self)
XMLRPCDocGenerator.__init__(self)
if __name__ == '__main__':
import datetime
class ExampleService:
def getData(self):
return '42'
class currentTime:
@staticmethod
def getCurrentTime():
return datetime.datetime.now()
with SimpleXMLRPCServer(("localhost", 8000)) as server:
server.register_function(pow)
server.register_function(lambda x,y: x+y, 'add')
server.register_instance(ExampleService(), allow_dotted_names=True)
server.register_multicall_functions()
print('Serving XML-RPC on localhost port 8000')
print('It is advisable to run this example server within a secure, closed network.')
try:
server.serve_forever()
except KeyboardInterrupt:
print("\nKeyboard interrupt received, exiting.")
sys.exit(0)
client.py 0000644 00000140357 15102763701 0006410 0 ustar 00 #
# XML-RPC CLIENT LIBRARY
# $Id$
#
# an XML-RPC client interface for Python.
#
# the marshalling and response parser code can also be used to
# implement XML-RPC servers.
#
# Notes:
# this version is designed to work with Python 2.1 or newer.
#
# History:
# 1999-01-14 fl Created
# 1999-01-15 fl Changed dateTime to use localtime
# 1999-01-16 fl Added Binary/base64 element, default to RPC2 service
# 1999-01-19 fl Fixed array data element (from Skip Montanaro)
# 1999-01-21 fl Fixed dateTime constructor, etc.
# 1999-02-02 fl Added fault handling, handle empty sequences, etc.
# 1999-02-10 fl Fixed problem with empty responses (from Skip Montanaro)
# 1999-06-20 fl Speed improvements, pluggable parsers/transports (0.9.8)
# 2000-11-28 fl Changed boolean to check the truth value of its argument
# 2001-02-24 fl Added encoding/Unicode/SafeTransport patches
# 2001-02-26 fl Added compare support to wrappers (0.9.9/1.0b1)
# 2001-03-28 fl Make sure response tuple is a singleton
# 2001-03-29 fl Don't require empty params element (from Nicholas Riley)
# 2001-06-10 fl Folded in _xmlrpclib accelerator support (1.0b2)
# 2001-08-20 fl Base xmlrpclib.Error on built-in Exception (from Paul Prescod)
# 2001-09-03 fl Allow Transport subclass to override getparser
# 2001-09-10 fl Lazy import of urllib, cgi, xmllib (20x import speedup)
# 2001-10-01 fl Remove containers from memo cache when done with them
# 2001-10-01 fl Use faster escape method (80% dumps speedup)
# 2001-10-02 fl More dumps microtuning
# 2001-10-04 fl Make sure import expat gets a parser (from Guido van Rossum)
# 2001-10-10 sm Allow long ints to be passed as ints if they don't overflow
# 2001-10-17 sm Test for int and long overflow (allows use on 64-bit systems)
# 2001-11-12 fl Use repr() to marshal doubles (from Paul Felix)
# 2002-03-17 fl Avoid buffered read when possible (from James Rucker)
# 2002-04-07 fl Added pythondoc comments
# 2002-04-16 fl Added __str__ methods to datetime/binary wrappers
# 2002-05-15 fl Added error constants (from Andrew Kuchling)
# 2002-06-27 fl Merged with Python CVS version
# 2002-10-22 fl Added basic authentication (based on code from Phillip Eby)
# 2003-01-22 sm Add support for the bool type
# 2003-02-27 gvr Remove apply calls
# 2003-04-24 sm Use cStringIO if available
# 2003-04-25 ak Add support for nil
# 2003-06-15 gn Add support for time.struct_time
# 2003-07-12 gp Correct marshalling of Faults
# 2003-10-31 mvl Add multicall support
# 2004-08-20 mvl Bump minimum supported Python version to 2.1
# 2014-12-02 ch/doko Add workaround for gzip bomb vulnerability
#
# Copyright (c) 1999-2002 by Secret Labs AB.
# Copyright (c) 1999-2002 by Fredrik Lundh.
#
# info@pythonware.com
# http://www.pythonware.com
#
# --------------------------------------------------------------------
# The XML-RPC client interface is
#
# Copyright (c) 1999-2002 by Secret Labs AB
# Copyright (c) 1999-2002 by Fredrik Lundh
#
# By obtaining, using, and/or copying this software and/or its
# associated documentation, you agree that you have read, understood,
# and will comply with the following terms and conditions:
#
# Permission to use, copy, modify, and distribute this software and
# its associated documentation for any purpose and without fee is
# hereby granted, provided that the above copyright notice appears in
# all copies, and that both that copyright notice and this permission
# notice appear in supporting documentation, and that the name of
# Secret Labs AB or the author not be used in advertising or publicity
# pertaining to distribution of the software without specific, written
# prior permission.
#
# SECRET LABS AB AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD
# TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANT-
# ABILITY AND FITNESS. IN NO EVENT SHALL SECRET LABS AB OR THE AUTHOR
# BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY
# DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
# WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
# ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
# OF THIS SOFTWARE.
# --------------------------------------------------------------------
"""
An XML-RPC client interface for Python.
The marshalling and response parser code can also be used to
implement XML-RPC servers.
Exported exceptions:
Error Base class for client errors
ProtocolError Indicates an HTTP protocol error
ResponseError Indicates a broken response package
Fault Indicates an XML-RPC fault package
Exported classes:
ServerProxy Represents a logical connection to an XML-RPC server
MultiCall Executor of boxcared xmlrpc requests
DateTime dateTime wrapper for an ISO 8601 string or time tuple or
localtime integer value to generate a "dateTime.iso8601"
XML-RPC value
Binary binary data wrapper
Marshaller Generate an XML-RPC params chunk from a Python data structure
Unmarshaller Unmarshal an XML-RPC response from incoming XML event message
Transport Handles an HTTP transaction to an XML-RPC server
SafeTransport Handles an HTTPS transaction to an XML-RPC server
Exported constants:
(none)
Exported functions:
getparser Create instance of the fastest available parser & attach
to an unmarshalling object
dumps Convert an argument tuple or a Fault instance to an XML-RPC
request (or response, if the methodresponse option is used).
loads Convert an XML-RPC packet to unmarshalled data plus a method
name (None if not present).
"""
import base64
import sys
import time
from datetime import datetime
from decimal import Decimal
import http.client
import urllib.parse
from xml.parsers import expat
import errno
from io import BytesIO
try:
import gzip
except ImportError:
gzip = None #python can be built without zlib/gzip support
# --------------------------------------------------------------------
# Internal stuff
def escape(s):
s = s.replace("&", "&")
s = s.replace("<", "<")
return s.replace(">", ">",)
# used in User-Agent header sent
__version__ = '%d.%d' % sys.version_info[:2]
# xmlrpc integer limits
MAXINT = 2**31-1
MININT = -2**31
# --------------------------------------------------------------------
# Error constants (from Dan Libby's specification at
# http://xmlrpc-epi.sourceforge.net/specs/rfc.fault_codes.php)
# Ranges of errors
PARSE_ERROR = -32700
SERVER_ERROR = -32600
APPLICATION_ERROR = -32500
SYSTEM_ERROR = -32400
TRANSPORT_ERROR = -32300
# Specific errors
NOT_WELLFORMED_ERROR = -32700
UNSUPPORTED_ENCODING = -32701
INVALID_ENCODING_CHAR = -32702
INVALID_XMLRPC = -32600
METHOD_NOT_FOUND = -32601
INVALID_METHOD_PARAMS = -32602
INTERNAL_ERROR = -32603
# --------------------------------------------------------------------
# Exceptions
##
# Base class for all kinds of client-side errors.
class Error(Exception):
"""Base class for client errors."""
__str__ = object.__str__
##
# Indicates an HTTP-level protocol error. This is raised by the HTTP
# transport layer, if the server returns an error code other than 200
# (OK).
#
# @param url The target URL.
# @param errcode The HTTP error code.
# @param errmsg The HTTP error message.
# @param headers The HTTP header dictionary.
class ProtocolError(Error):
"""Indicates an HTTP protocol error."""
def __init__(self, url, errcode, errmsg, headers):
Error.__init__(self)
self.url = url
self.errcode = errcode
self.errmsg = errmsg
self.headers = headers
def __repr__(self):
return (
"<%s for %s: %s %s>" %
(self.__class__.__name__, self.url, self.errcode, self.errmsg)
)
##
# Indicates a broken XML-RPC response package. This exception is
# raised by the unmarshalling layer, if the XML-RPC response is
# malformed.
class ResponseError(Error):
"""Indicates a broken response package."""
pass
##
# Indicates an XML-RPC fault response package. This exception is
# raised by the unmarshalling layer, if the XML-RPC response contains
# a fault string. This exception can also be used as a class, to
# generate a fault XML-RPC message.
#
# @param faultCode The XML-RPC fault code.
# @param faultString The XML-RPC fault string.
class Fault(Error):
"""Indicates an XML-RPC fault package."""
def __init__(self, faultCode, faultString, **extra):
Error.__init__(self)
self.faultCode = faultCode
self.faultString = faultString
def __repr__(self):
return "<%s %s: %r>" % (self.__class__.__name__,
self.faultCode, self.faultString)
# --------------------------------------------------------------------
# Special values
##
# Backwards compatibility
boolean = Boolean = bool
##
# Wrapper for XML-RPC DateTime values. This converts a time value to
# the format used by XML-RPC.
#
# The value can be given as a datetime object, as a string in the
# format "yyyymmddThh:mm:ss", as a 9-item time tuple (as returned by
# time.localtime()), or an integer value (as returned by time.time()).
# The wrapper uses time.localtime() to convert an integer to a time
# tuple.
#
# @param value The time, given as a datetime object, an ISO 8601 string,
# a time tuple, or an integer time value.
# Issue #13305: different format codes across platforms
_day0 = datetime(1, 1, 1)
def _try(fmt):
try:
return _day0.strftime(fmt) == '0001'
except ValueError:
return False
if _try('%Y'): # Mac OS X
def _iso8601_format(value):
return value.strftime("%Y%m%dT%H:%M:%S")
elif _try('%4Y'): # Linux
def _iso8601_format(value):
return value.strftime("%4Y%m%dT%H:%M:%S")
else:
def _iso8601_format(value):
return value.strftime("%Y%m%dT%H:%M:%S").zfill(17)
del _day0
del _try
def _strftime(value):
if isinstance(value, datetime):
return _iso8601_format(value)
if not isinstance(value, (tuple, time.struct_time)):
if value == 0:
value = time.time()
value = time.localtime(value)
return "%04d%02d%02dT%02d:%02d:%02d" % value[:6]
class DateTime:
"""DateTime wrapper for an ISO 8601 string or time tuple or
localtime integer value to generate 'dateTime.iso8601' XML-RPC
value.
"""
def __init__(self, value=0):
if isinstance(value, str):
self.value = value
else:
self.value = _strftime(value)
def make_comparable(self, other):
if isinstance(other, DateTime):
s = self.value
o = other.value
elif isinstance(other, datetime):
s = self.value
o = _iso8601_format(other)
elif isinstance(other, str):
s = self.value
o = other
elif hasattr(other, "timetuple"):
s = self.timetuple()
o = other.timetuple()
else:
s = self
o = NotImplemented
return s, o
def __lt__(self, other):
s, o = self.make_comparable(other)
if o is NotImplemented:
return NotImplemented
return s < o
def __le__(self, other):
s, o = self.make_comparable(other)
if o is NotImplemented:
return NotImplemented
return s <= o
def __gt__(self, other):
s, o = self.make_comparable(other)
if o is NotImplemented:
return NotImplemented
return s > o
def __ge__(self, other):
s, o = self.make_comparable(other)
if o is NotImplemented:
return NotImplemented
return s >= o
def __eq__(self, other):
s, o = self.make_comparable(other)
if o is NotImplemented:
return NotImplemented
return s == o
def timetuple(self):
return time.strptime(self.value, "%Y%m%dT%H:%M:%S")
##
# Get date/time value.
#
# @return Date/time value, as an ISO 8601 string.
def __str__(self):
return self.value
def __repr__(self):
return "<%s %r at %#x>" % (self.__class__.__name__, self.value, id(self))
def decode(self, data):
self.value = str(data).strip()
def encode(self, out):
out.write("")
out.write(self.value)
out.write("\n")
def _datetime(data):
# decode xml element contents into a DateTime structure.
value = DateTime()
value.decode(data)
return value
def _datetime_type(data):
return datetime.strptime(data, "%Y%m%dT%H:%M:%S")
##
# Wrapper for binary data. This can be used to transport any kind
# of binary data over XML-RPC, using BASE64 encoding.
#
# @param data An 8-bit string containing arbitrary data.
class Binary:
"""Wrapper for binary data."""
def __init__(self, data=None):
if data is None:
data = b""
else:
if not isinstance(data, (bytes, bytearray)):
raise TypeError("expected bytes or bytearray, not %s" %
data.__class__.__name__)
data = bytes(data) # Make a copy of the bytes!
self.data = data
##
# Get buffer contents.
#
# @return Buffer contents, as an 8-bit string.
def __str__(self):
return str(self.data, "latin-1") # XXX encoding?!
def __eq__(self, other):
if isinstance(other, Binary):
other = other.data
return self.data == other
def decode(self, data):
self.data = base64.decodebytes(data)
def encode(self, out):
out.write("\n")
encoded = base64.encodebytes(self.data)
out.write(encoded.decode('ascii'))
out.write("\n")
def _binary(data):
# decode xml element contents into a Binary structure
value = Binary()
value.decode(data)
return value
WRAPPERS = (DateTime, Binary)
# --------------------------------------------------------------------
# XML parsers
class ExpatParser:
# fast expat parser for Python 2.0 and later.
def __init__(self, target):
self._parser = parser = expat.ParserCreate(None, None)
self._target = target
parser.StartElementHandler = target.start
parser.EndElementHandler = target.end
parser.CharacterDataHandler = target.data
encoding = None
target.xml(encoding, None)
def feed(self, data):
self._parser.Parse(data, False)
def close(self):
try:
parser = self._parser
except AttributeError:
pass
else:
del self._target, self._parser # get rid of circular references
parser.Parse(b"", True) # end of data
# --------------------------------------------------------------------
# XML-RPC marshalling and unmarshalling code
##
# XML-RPC marshaller.
#
# @param encoding Default encoding for 8-bit strings. The default
# value is None (interpreted as UTF-8).
# @see dumps
class Marshaller:
"""Generate an XML-RPC params chunk from a Python data structure.
Create a Marshaller instance for each set of parameters, and use
the "dumps" method to convert your data (represented as a tuple)
to an XML-RPC params chunk. To write a fault response, pass a
Fault instance instead. You may prefer to use the "dumps" module
function for this purpose.
"""
# by the way, if you don't understand what's going on in here,
# that's perfectly ok.
def __init__(self, encoding=None, allow_none=False):
self.memo = {}
self.data = None
self.encoding = encoding
self.allow_none = allow_none
dispatch = {}
def dumps(self, values):
out = []
write = out.append
dump = self.__dump
if isinstance(values, Fault):
# fault instance
write("\n")
dump({'faultCode': values.faultCode,
'faultString': values.faultString},
write)
write("\n")
else:
# parameter block
# FIXME: the xml-rpc specification allows us to leave out
# the entire block if there are no parameters.
# however, changing this may break older code (including
# old versions of xmlrpclib.py), so this is better left as
# is for now. See @XMLRPC3 for more information. /F
write("\n")
for v in values:
write("\n")
dump(v, write)
write("\n")
write("\n")
result = "".join(out)
return result
def __dump(self, value, write):
try:
f = self.dispatch[type(value)]
except KeyError:
# check if this object can be marshalled as a structure
if not hasattr(value, '__dict__'):
raise TypeError("cannot marshal %s objects" % type(value))
# check if this class is a sub-class of a basic type,
# because we don't know how to marshal these types
# (e.g. a string sub-class)
for type_ in type(value).__mro__:
if type_ in self.dispatch.keys():
raise TypeError("cannot marshal %s objects" % type(value))
# XXX(twouters): using "_arbitrary_instance" as key as a quick-fix
# for the p3yk merge, this should probably be fixed more neatly.
f = self.dispatch["_arbitrary_instance"]
f(self, value, write)
def dump_nil (self, value, write):
if not self.allow_none:
raise TypeError("cannot marshal None unless allow_none is enabled")
write("")
dispatch[type(None)] = dump_nil
def dump_bool(self, value, write):
write("")
write(value and "1" or "0")
write("\n")
dispatch[bool] = dump_bool
def dump_long(self, value, write):
if value > MAXINT or value < MININT:
raise OverflowError("int exceeds XML-RPC limits")
write("")
write(str(int(value)))
write("\n")
dispatch[int] = dump_long
# backward compatible
dump_int = dump_long
def dump_double(self, value, write):
write("")
write(repr(value))
write("\n")
dispatch[float] = dump_double
def dump_unicode(self, value, write, escape=escape):
write("")
write(escape(value))
write("\n")
dispatch[str] = dump_unicode
def dump_bytes(self, value, write):
write("\n")
encoded = base64.encodebytes(value)
write(encoded.decode('ascii'))
write("\n")
dispatch[bytes] = dump_bytes
dispatch[bytearray] = dump_bytes
def dump_array(self, value, write):
i = id(value)
if i in self.memo:
raise TypeError("cannot marshal recursive sequences")
self.memo[i] = None
dump = self.__dump
write("\n")
for v in value:
dump(v, write)
write("\n")
del self.memo[i]
dispatch[tuple] = dump_array
dispatch[list] = dump_array
def dump_struct(self, value, write, escape=escape):
i = id(value)
if i in self.memo:
raise TypeError("cannot marshal recursive dictionaries")
self.memo[i] = None
dump = self.__dump
write("\n")
for k, v in value.items():
write("\n")
if not isinstance(k, str):
raise TypeError("dictionary key must be string")
write("%s\n" % escape(k))
dump(v, write)
write("\n")
write("\n")
del self.memo[i]
dispatch[dict] = dump_struct
def dump_datetime(self, value, write):
write("")
write(_strftime(value))
write("\n")
dispatch[datetime] = dump_datetime
def dump_instance(self, value, write):
# check for special wrappers
if value.__class__ in WRAPPERS:
self.write = write
value.encode(self)
del self.write
else:
# store instance attributes as a struct (really?)
self.dump_struct(value.__dict__, write)
dispatch[DateTime] = dump_instance
dispatch[Binary] = dump_instance
# XXX(twouters): using "_arbitrary_instance" as key as a quick-fix
# for the p3yk merge, this should probably be fixed more neatly.
dispatch["_arbitrary_instance"] = dump_instance
##
# XML-RPC unmarshaller.
#
# @see loads
class Unmarshaller:
"""Unmarshal an XML-RPC response, based on incoming XML event
messages (start, data, end). Call close() to get the resulting
data structure.
Note that this reader is fairly tolerant, and gladly accepts bogus
XML-RPC data without complaining (but not bogus XML).
"""
# and again, if you don't understand what's going on in here,
# that's perfectly ok.
def __init__(self, use_datetime=False, use_builtin_types=False):
self._type = None
self._stack = []
self._marks = []
self._data = []
self._value = False
self._methodname = None
self._encoding = "utf-8"
self.append = self._stack.append
self._use_datetime = use_builtin_types or use_datetime
self._use_bytes = use_builtin_types
def close(self):
# return response tuple and target method
if self._type is None or self._marks:
raise ResponseError()
if self._type == "fault":
raise Fault(**self._stack[0])
return tuple(self._stack)
def getmethodname(self):
return self._methodname
#
# event handlers
def xml(self, encoding, standalone):
self._encoding = encoding
# FIXME: assert standalone == 1 ???
def start(self, tag, attrs):
# prepare to handle this element
if ':' in tag:
tag = tag.split(':')[-1]
if tag == "array" or tag == "struct":
self._marks.append(len(self._stack))
self._data = []
if self._value and tag not in self.dispatch:
raise ResponseError("unknown tag %r" % tag)
self._value = (tag == "value")
def data(self, text):
self._data.append(text)
def end(self, tag):
# call the appropriate end tag handler
try:
f = self.dispatch[tag]
except KeyError:
if ':' not in tag:
return # unknown tag ?
try:
f = self.dispatch[tag.split(':')[-1]]
except KeyError:
return # unknown tag ?
return f(self, "".join(self._data))
#
# accelerator support
def end_dispatch(self, tag, data):
# dispatch data
try:
f = self.dispatch[tag]
except KeyError:
if ':' not in tag:
return # unknown tag ?
try:
f = self.dispatch[tag.split(':')[-1]]
except KeyError:
return # unknown tag ?
return f(self, data)
#
# element decoders
dispatch = {}
def end_nil (self, data):
self.append(None)
self._value = 0
dispatch["nil"] = end_nil
def end_boolean(self, data):
if data == "0":
self.append(False)
elif data == "1":
self.append(True)
else:
raise TypeError("bad boolean value")
self._value = 0
dispatch["boolean"] = end_boolean
def end_int(self, data):
self.append(int(data))
self._value = 0
dispatch["i1"] = end_int
dispatch["i2"] = end_int
dispatch["i4"] = end_int
dispatch["i8"] = end_int
dispatch["int"] = end_int
dispatch["biginteger"] = end_int
def end_double(self, data):
self.append(float(data))
self._value = 0
dispatch["double"] = end_double
dispatch["float"] = end_double
def end_bigdecimal(self, data):
self.append(Decimal(data))
self._value = 0
dispatch["bigdecimal"] = end_bigdecimal
def end_string(self, data):
if self._encoding:
data = data.decode(self._encoding)
self.append(data)
self._value = 0
dispatch["string"] = end_string
dispatch["name"] = end_string # struct keys are always strings
def end_array(self, data):
mark = self._marks.pop()
# map arrays to Python lists
self._stack[mark:] = [self._stack[mark:]]
self._value = 0
dispatch["array"] = end_array
def end_struct(self, data):
mark = self._marks.pop()
# map structs to Python dictionaries
dict = {}
items = self._stack[mark:]
for i in range(0, len(items), 2):
dict[items[i]] = items[i+1]
self._stack[mark:] = [dict]
self._value = 0
dispatch["struct"] = end_struct
def end_base64(self, data):
value = Binary()
value.decode(data.encode("ascii"))
if self._use_bytes:
value = value.data
self.append(value)
self._value = 0
dispatch["base64"] = end_base64
def end_dateTime(self, data):
value = DateTime()
value.decode(data)
if self._use_datetime:
value = _datetime_type(data)
self.append(value)
dispatch["dateTime.iso8601"] = end_dateTime
def end_value(self, data):
# if we stumble upon a value element with no internal
# elements, treat it as a string element
if self._value:
self.end_string(data)
dispatch["value"] = end_value
def end_params(self, data):
self._type = "params"
dispatch["params"] = end_params
def end_fault(self, data):
self._type = "fault"
dispatch["fault"] = end_fault
def end_methodName(self, data):
if self._encoding:
data = data.decode(self._encoding)
self._methodname = data
self._type = "methodName" # no params
dispatch["methodName"] = end_methodName
## Multicall support
#
class _MultiCallMethod:
# some lesser magic to store calls made to a MultiCall object
# for batch execution
def __init__(self, call_list, name):
self.__call_list = call_list
self.__name = name
def __getattr__(self, name):
return _MultiCallMethod(self.__call_list, "%s.%s" % (self.__name, name))
def __call__(self, *args):
self.__call_list.append((self.__name, args))
class MultiCallIterator:
"""Iterates over the results of a multicall. Exceptions are
raised in response to xmlrpc faults."""
def __init__(self, results):
self.results = results
def __getitem__(self, i):
item = self.results[i]
if type(item) == type({}):
raise Fault(item['faultCode'], item['faultString'])
elif type(item) == type([]):
return item[0]
else:
raise ValueError("unexpected type in multicall result")
class MultiCall:
"""server -> an object used to boxcar method calls
server should be a ServerProxy object.
Methods can be added to the MultiCall using normal
method call syntax e.g.:
multicall = MultiCall(server_proxy)
multicall.add(2,3)
multicall.get_address("Guido")
To execute the multicall, call the MultiCall object e.g.:
add_result, address = multicall()
"""
def __init__(self, server):
self.__server = server
self.__call_list = []
def __repr__(self):
return "<%s at %#x>" % (self.__class__.__name__, id(self))
def __getattr__(self, name):
return _MultiCallMethod(self.__call_list, name)
def __call__(self):
marshalled_list = []
for name, args in self.__call_list:
marshalled_list.append({'methodName' : name, 'params' : args})
return MultiCallIterator(self.__server.system.multicall(marshalled_list))
# --------------------------------------------------------------------
# convenience functions
FastMarshaller = FastParser = FastUnmarshaller = None
##
# Create a parser object, and connect it to an unmarshalling instance.
# This function picks the fastest available XML parser.
#
# return A (parser, unmarshaller) tuple.
def getparser(use_datetime=False, use_builtin_types=False):
"""getparser() -> parser, unmarshaller
Create an instance of the fastest available parser, and attach it
to an unmarshalling object. Return both objects.
"""
if FastParser and FastUnmarshaller:
if use_builtin_types:
mkdatetime = _datetime_type
mkbytes = base64.decodebytes
elif use_datetime:
mkdatetime = _datetime_type
mkbytes = _binary
else:
mkdatetime = _datetime
mkbytes = _binary
target = FastUnmarshaller(True, False, mkbytes, mkdatetime, Fault)
parser = FastParser(target)
else:
target = Unmarshaller(use_datetime=use_datetime, use_builtin_types=use_builtin_types)
if FastParser:
parser = FastParser(target)
else:
parser = ExpatParser(target)
return parser, target
##
# Convert a Python tuple or a Fault instance to an XML-RPC packet.
#
# @def dumps(params, **options)
# @param params A tuple or Fault instance.
# @keyparam methodname If given, create a methodCall request for
# this method name.
# @keyparam methodresponse If given, create a methodResponse packet.
# If used with a tuple, the tuple must be a singleton (that is,
# it must contain exactly one element).
# @keyparam encoding The packet encoding.
# @return A string containing marshalled data.
def dumps(params, methodname=None, methodresponse=None, encoding=None,
allow_none=False):
"""data [,options] -> marshalled data
Convert an argument tuple or a Fault instance to an XML-RPC
request (or response, if the methodresponse option is used).
In addition to the data object, the following options can be given
as keyword arguments:
methodname: the method name for a methodCall packet
methodresponse: true to create a methodResponse packet.
If this option is used with a tuple, the tuple must be
a singleton (i.e. it can contain only one element).
encoding: the packet encoding (default is UTF-8)
All byte strings in the data structure are assumed to use the
packet encoding. Unicode strings are automatically converted,
where necessary.
"""
assert isinstance(params, (tuple, Fault)), "argument must be tuple or Fault instance"
if isinstance(params, Fault):
methodresponse = 1
elif methodresponse and isinstance(params, tuple):
assert len(params) == 1, "response tuple must be a singleton"
if not encoding:
encoding = "utf-8"
if FastMarshaller:
m = FastMarshaller(encoding)
else:
m = Marshaller(encoding, allow_none)
data = m.dumps(params)
if encoding != "utf-8":
xmlheader = "\n" % str(encoding)
else:
xmlheader = "\n" # utf-8 is default
# standard XML-RPC wrappings
if methodname:
# a method call
data = (
xmlheader,
"\n"
"", methodname, "\n",
data,
"\n"
)
elif methodresponse:
# a method response, or a fault structure
data = (
xmlheader,
"\n",
data,
"\n"
)
else:
return data # return as is
return "".join(data)
##
# Convert an XML-RPC packet to a Python object. If the XML-RPC packet
# represents a fault condition, this function raises a Fault exception.
#
# @param data An XML-RPC packet, given as an 8-bit string.
# @return A tuple containing the unpacked data, and the method name
# (None if not present).
# @see Fault
def loads(data, use_datetime=False, use_builtin_types=False):
"""data -> unmarshalled data, method name
Convert an XML-RPC packet to unmarshalled data plus a method
name (None if not present).
If the XML-RPC packet represents a fault condition, this function
raises a Fault exception.
"""
p, u = getparser(use_datetime=use_datetime, use_builtin_types=use_builtin_types)
p.feed(data)
p.close()
return u.close(), u.getmethodname()
##
# Encode a string using the gzip content encoding such as specified by the
# Content-Encoding: gzip
# in the HTTP header, as described in RFC 1952
#
# @param data the unencoded data
# @return the encoded data
def gzip_encode(data):
"""data -> gzip encoded data
Encode data using the gzip content encoding as described in RFC 1952
"""
if not gzip:
raise NotImplementedError
f = BytesIO()
with gzip.GzipFile(mode="wb", fileobj=f, compresslevel=1) as gzf:
gzf.write(data)
return f.getvalue()
##
# Decode a string using the gzip content encoding such as specified by the
# Content-Encoding: gzip
# in the HTTP header, as described in RFC 1952
#
# @param data The encoded data
# @keyparam max_decode Maximum bytes to decode (20 MiB default), use negative
# values for unlimited decoding
# @return the unencoded data
# @raises ValueError if data is not correctly coded.
# @raises ValueError if max gzipped payload length exceeded
def gzip_decode(data, max_decode=20971520):
"""gzip encoded data -> unencoded data
Decode data using the gzip content encoding as described in RFC 1952
"""
if not gzip:
raise NotImplementedError
with gzip.GzipFile(mode="rb", fileobj=BytesIO(data)) as gzf:
try:
if max_decode < 0: # no limit
decoded = gzf.read()
else:
decoded = gzf.read(max_decode + 1)
except OSError:
raise ValueError("invalid data")
if max_decode >= 0 and len(decoded) > max_decode:
raise ValueError("max gzipped payload length exceeded")
return decoded
##
# Return a decoded file-like object for the gzip encoding
# as described in RFC 1952.
#
# @param response A stream supporting a read() method
# @return a file-like object that the decoded data can be read() from
class GzipDecodedResponse(gzip.GzipFile if gzip else object):
"""a file-like object to decode a response encoded with the gzip
method, as described in RFC 1952.
"""
def __init__(self, response):
#response doesn't support tell() and read(), required by
#GzipFile
if not gzip:
raise NotImplementedError
self.io = BytesIO(response.read())
gzip.GzipFile.__init__(self, mode="rb", fileobj=self.io)
def close(self):
try:
gzip.GzipFile.close(self)
finally:
self.io.close()
# --------------------------------------------------------------------
# request dispatcher
class _Method:
# some magic to bind an XML-RPC method to an RPC server.
# supports "nested" methods (e.g. examples.getStateName)
def __init__(self, send, name):
self.__send = send
self.__name = name
def __getattr__(self, name):
return _Method(self.__send, "%s.%s" % (self.__name, name))
def __call__(self, *args):
return self.__send(self.__name, args)
##
# Standard transport class for XML-RPC over HTTP.
#
# You can create custom transports by subclassing this method, and
# overriding selected methods.
class Transport:
"""Handles an HTTP transaction to an XML-RPC server."""
# client identifier (may be overridden)
user_agent = "Python-xmlrpc/%s" % __version__
#if true, we'll request gzip encoding
accept_gzip_encoding = True
# if positive, encode request using gzip if it exceeds this threshold
# note that many servers will get confused, so only use it if you know
# that they can decode such a request
encode_threshold = None #None = don't encode
def __init__(self, use_datetime=False, use_builtin_types=False,
*, headers=()):
self._use_datetime = use_datetime
self._use_builtin_types = use_builtin_types
self._connection = (None, None)
self._headers = list(headers)
self._extra_headers = []
##
# Send a complete request, and parse the response.
# Retry request if a cached connection has disconnected.
#
# @param host Target host.
# @param handler Target PRC handler.
# @param request_body XML-RPC request body.
# @param verbose Debugging flag.
# @return Parsed response.
def request(self, host, handler, request_body, verbose=False):
#retry request once if cached connection has gone cold
for i in (0, 1):
try:
return self.single_request(host, handler, request_body, verbose)
except http.client.RemoteDisconnected:
if i:
raise
except OSError as e:
if i or e.errno not in (errno.ECONNRESET, errno.ECONNABORTED,
errno.EPIPE):
raise
def single_request(self, host, handler, request_body, verbose=False):
# issue XML-RPC request
try:
http_conn = self.send_request(host, handler, request_body, verbose)
resp = http_conn.getresponse()
if resp.status == 200:
self.verbose = verbose
return self.parse_response(resp)
except Fault:
raise
except Exception:
#All unexpected errors leave connection in
# a strange state, so we clear it.
self.close()
raise
#We got an error response.
#Discard any response data and raise exception
if resp.getheader("content-length", ""):
resp.read()
raise ProtocolError(
host + handler,
resp.status, resp.reason,
dict(resp.getheaders())
)
##
# Create parser.
#
# @return A 2-tuple containing a parser and an unmarshaller.
def getparser(self):
# get parser and unmarshaller
return getparser(use_datetime=self._use_datetime,
use_builtin_types=self._use_builtin_types)
##
# Get authorization info from host parameter
# Host may be a string, or a (host, x509-dict) tuple; if a string,
# it is checked for a "user:pw@host" format, and a "Basic
# Authentication" header is added if appropriate.
#
# @param host Host descriptor (URL or (URL, x509 info) tuple).
# @return A 3-tuple containing (actual host, extra headers,
# x509 info). The header and x509 fields may be None.
def get_host_info(self, host):
x509 = {}
if isinstance(host, tuple):
host, x509 = host
auth, host = urllib.parse._splituser(host)
if auth:
auth = urllib.parse.unquote_to_bytes(auth)
auth = base64.encodebytes(auth).decode("utf-8")
auth = "".join(auth.split()) # get rid of whitespace
extra_headers = [
("Authorization", "Basic " + auth)
]
else:
extra_headers = []
return host, extra_headers, x509
##
# Connect to server.
#
# @param host Target host.
# @return An HTTPConnection object
def make_connection(self, host):
#return an existing connection if possible. This allows
#HTTP/1.1 keep-alive.
if self._connection and host == self._connection[0]:
return self._connection[1]
# create a HTTP connection object from a host descriptor
chost, self._extra_headers, x509 = self.get_host_info(host)
self._connection = host, http.client.HTTPConnection(chost)
return self._connection[1]
##
# Clear any cached connection object.
# Used in the event of socket errors.
#
def close(self):
host, connection = self._connection
if connection:
self._connection = (None, None)
connection.close()
##
# Send HTTP request.
#
# @param host Host descriptor (URL or (URL, x509 info) tuple).
# @param handler Target RPC handler (a path relative to host)
# @param request_body The XML-RPC request body
# @param debug Enable debugging if debug is true.
# @return An HTTPConnection.
def send_request(self, host, handler, request_body, debug):
connection = self.make_connection(host)
headers = self._headers + self._extra_headers
if debug:
connection.set_debuglevel(1)
if self.accept_gzip_encoding and gzip:
connection.putrequest("POST", handler, skip_accept_encoding=True)
headers.append(("Accept-Encoding", "gzip"))
else:
connection.putrequest("POST", handler)
headers.append(("Content-Type", "text/xml"))
headers.append(("User-Agent", self.user_agent))
self.send_headers(connection, headers)
self.send_content(connection, request_body)
return connection
##
# Send request headers.
# This function provides a useful hook for subclassing
#
# @param connection httpConnection.
# @param headers list of key,value pairs for HTTP headers
def send_headers(self, connection, headers):
for key, val in headers:
connection.putheader(key, val)
##
# Send request body.
# This function provides a useful hook for subclassing
#
# @param connection httpConnection.
# @param request_body XML-RPC request body.
def send_content(self, connection, request_body):
#optionally encode the request
if (self.encode_threshold is not None and
self.encode_threshold < len(request_body) and
gzip):
connection.putheader("Content-Encoding", "gzip")
request_body = gzip_encode(request_body)
connection.putheader("Content-Length", str(len(request_body)))
connection.endheaders(request_body)
##
# Parse response.
#
# @param file Stream.
# @return Response tuple and target method.
def parse_response(self, response):
# read response data from httpresponse, and parse it
# Check for new http response object, otherwise it is a file object.
if hasattr(response, 'getheader'):
if response.getheader("Content-Encoding", "") == "gzip":
stream = GzipDecodedResponse(response)
else:
stream = response
else:
stream = response
p, u = self.getparser()
while 1:
data = stream.read(1024)
if not data:
break
if self.verbose:
print("body:", repr(data))
p.feed(data)
if stream is not response:
stream.close()
p.close()
return u.close()
##
# Standard transport class for XML-RPC over HTTPS.
class SafeTransport(Transport):
"""Handles an HTTPS transaction to an XML-RPC server."""
def __init__(self, use_datetime=False, use_builtin_types=False,
*, headers=(), context=None):
super().__init__(use_datetime=use_datetime,
use_builtin_types=use_builtin_types,
headers=headers)
self.context = context
# FIXME: mostly untested
def make_connection(self, host):
if self._connection and host == self._connection[0]:
return self._connection[1]
if not hasattr(http.client, "HTTPSConnection"):
raise NotImplementedError(
"your version of http.client doesn't support HTTPS")
# create a HTTPS connection object from a host descriptor
# host may be a string, or a (host, x509-dict) tuple
chost, self._extra_headers, x509 = self.get_host_info(host)
self._connection = host, http.client.HTTPSConnection(chost,
None, context=self.context, **(x509 or {}))
return self._connection[1]
##
# Standard server proxy. This class establishes a virtual connection
# to an XML-RPC server.
#
# This class is available as ServerProxy and Server. New code should
# use ServerProxy, to avoid confusion.
#
# @def ServerProxy(uri, **options)
# @param uri The connection point on the server.
# @keyparam transport A transport factory, compatible with the
# standard transport class.
# @keyparam encoding The default encoding used for 8-bit strings
# (default is UTF-8).
# @keyparam verbose Use a true value to enable debugging output.
# (printed to standard output).
# @see Transport
class ServerProxy:
"""uri [,options] -> a logical connection to an XML-RPC server
uri is the connection point on the server, given as
scheme://host/target.
The standard implementation always supports the "http" scheme. If
SSL socket support is available (Python 2.0), it also supports
"https".
If the target part and the slash preceding it are both omitted,
"/RPC2" is assumed.
The following options can be given as keyword arguments:
transport: a transport factory
encoding: the request encoding (default is UTF-8)
All 8-bit strings passed to the server proxy are assumed to use
the given encoding.
"""
def __init__(self, uri, transport=None, encoding=None, verbose=False,
allow_none=False, use_datetime=False, use_builtin_types=False,
*, headers=(), context=None):
# establish a "logical" server connection
# get the url
p = urllib.parse.urlsplit(uri)
if p.scheme not in ("http", "https"):
raise OSError("unsupported XML-RPC protocol")
self.__host = p.netloc
self.__handler = urllib.parse.urlunsplit(["", "", *p[2:]])
if not self.__handler:
self.__handler = "/RPC2"
if transport is None:
if p.scheme == "https":
handler = SafeTransport
extra_kwargs = {"context": context}
else:
handler = Transport
extra_kwargs = {}
transport = handler(use_datetime=use_datetime,
use_builtin_types=use_builtin_types,
headers=headers,
**extra_kwargs)
self.__transport = transport
self.__encoding = encoding or 'utf-8'
self.__verbose = verbose
self.__allow_none = allow_none
def __close(self):
self.__transport.close()
def __request(self, methodname, params):
# call a method on the remote server
request = dumps(params, methodname, encoding=self.__encoding,
allow_none=self.__allow_none).encode(self.__encoding, 'xmlcharrefreplace')
response = self.__transport.request(
self.__host,
self.__handler,
request,
verbose=self.__verbose
)
if len(response) == 1:
response = response[0]
return response
def __repr__(self):
return (
"<%s for %s%s>" %
(self.__class__.__name__, self.__host, self.__handler)
)
def __getattr__(self, name):
# magic method dispatcher
return _Method(self.__request, name)
# note: to call a remote object with a non-standard name, use
# result getattr(server, "strange-python-name")(args)
def __call__(self, attr):
"""A workaround to get special attributes on the ServerProxy
without interfering with the magic __getattr__
"""
if attr == "close":
return self.__close
elif attr == "transport":
return self.__transport
raise AttributeError("Attribute %r not found" % (attr,))
def __enter__(self):
return self
def __exit__(self, *args):
self.__close()
# compatibility
Server = ServerProxy
# --------------------------------------------------------------------
# test code
if __name__ == "__main__":
# simple test program (from the XML-RPC specification)
# local server, available from Lib/xmlrpc/server.py
server = ServerProxy("http://localhost:8000")
try:
print(server.currentTime.getCurrentTime())
except Error as v:
print("ERROR", v)
multi = MultiCall(server)
multi.getData()
multi.pow(2,9)
multi.add(1,2)
try:
for response in multi():
print(response)
except Error as v:
print("ERROR", v)
__pycache__/server.cpython-311.opt-1.pyc 0000644 00000133342 15102763701 0013733 0 ustar 00
!A?h d Z ddlmZmZmZmZmZ ddlmZ ddl m
Z
ddl m Z ddl
Z
ddlZddlZddlZddlZddlZddlZddlZ ddlZn
# e$ r dZY nw xY wd(dZd Z G d
d Z G d d
e Z G d dej e Z G d de Z G d de Z G d dej Z G d d Z! G d de Z" G d de e! Z# G d d e e! Z$e%d k rddl&Z& G d d Z' e d! 5 Z(e() e* e() d" d# e(+ e' d$ e(, e-d% e-d& e(. n&# e/$ r e-d' ej0 d Y nw xY wddd dS # 1 swxY w Y dS dS ))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 |r| d }n|g}|D ]9}| d rt d|z t | | } :| S )aG 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/lib64/python3.11/xmlrpc/server.pyresolve_dotted_attributer | sw
3
! ! << ! :Q>
#a..CC J c : fdt D S )zkReturns a list of attribute strings, found in the specified
object, which represent callable attributesc x g | ]6}| d t t | 4|7S )r
)r callabler ).0memberr s r
z'list_public_methods.. sU 4 4 4v ((-- 4 WS& 1 122 4F 4 4 4r )dir)r s `r list_public_methodsr! s3 4 4 4 4S 4 4 4 4r c ` e Zd ZdZ ddZddZddZd Zd Zdd Z d
Z
d Z d Z d
Z
d ZdS )SimpleXMLRPCDispatchera& 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
FNc P i | _ d | _ || _ |pd| _ || _ d S Nutf-8)funcsinstance
allow_noneencodinguse_builtin_typesselfr) r* r+ s r __init__z SimpleXMLRPCDispatcher.__init__ s1
$ +G
!2 r c " || _ || _ dS )a 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_instancez(SimpleXMLRPCDispatcher.register_instance s B !
"4 r c \ |t | j | S ||j }|| j |< |S )zRegisters a function to respond to XML-RPC requests.
The optional name argument can be used to set a Unicode name
for the function.
N)name)r register_function__name__r' )r- functionr2 s r r3 z(SimpleXMLRPCDispatcher.register_function s> 41=== = <$D#
4r c ` | j | j | j | j d dS )zRegisters 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_functionsz7SimpleXMLRPCDispatcher.register_introspection_functions sJ
$2I151L,0,BD D E E E E Er c H | j d| j i dS )zRegisters the XML-RPC multicall method in the system
namespace.
see http://www.xmlrpc.com/discuss/msgReader$1208zsystem.multicallN)r' r7 system_multicallr; s r register_multicall_functionsz3SimpleXMLRPCDispatcher.register_multicall_functions s)
-0EFGGGGGr c t || j \ }}|
||| }n| || }|f}t |d| j | j }n# t $ r&}t || j | j }Y d}~nVd}~wt $ rF}t t
dt | d| | j | j }Y d}~nd}~ww xY w| | j d S ) 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_dispatchz*SimpleXMLRPCDispatcher._marshaled_dispatch s7 "44;Q R R RNFF **?66:: >>&&99 {H Xa(,$-Q Q QHH 5 5 5 Ut&*m5 5 5HHHHHH aDIIIIss344 4? HHHHHH t}.ABBBs$ A A! !
C + B
C ['add', 'subtract', 'multiple']
Returns a list of the methods supported by the server.N _listMethodsrF )setr' keysr( hasattrrT r! sorted)r- methodss r r8 z)SimpleXMLRPCDispatcher.system_listMethods s
djoo''(( = $ t}n55
C3t} 9 9 ; ;<<< T]K88
C3 24= A ABBBg r c dS )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 r9 z-SimpleXMLRPCDispatcher.system_methodSignature) s
*)r c T d}|| j v r| j | }nx| j qt | j d r| j | S t | j d s- t | j || j }n# t $ r Y nw xY w|dS t j | S )zsystem.methodHelp('add') => "Adds two integers together"
Returns a string containing documentation for the specified method.N _methodHelprF ) r' r( rW r^ r r r pydocgetdoc)r- r\ rN s r r: z(SimpleXMLRPCDispatcher.system_methodHelp6 s
$* $ $Z ,FF
]
&t}m44
}00=== T]K88
5 $
+ $ 7 " "FF
& D
>2<'' 's &B
BBc t g }|D ]}|d }|d } | | || g ># t $ r,}| |j |j d Y d}~od}~wt
$ r4}| dt
| d|d Y d}~d}~ww xY w|S )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
methodNamerM ) faultCode faultStringNrA rC )appendrF r rd re rG rH )r- call_listresultscallr\ rM rP rQ s r r> z'SimpleXMLRPCDispatcher.system_multicallU s, D |,K(^F
{F C C DEEEE
#(?%*%68 8 !
#$04S 33%?A A
s# *A
B5
"A44
B5*B00B5c j | j | }| || S t d|z # t $ r Y nw xY w| j dt | j d r| j || S t
| j || j }| || S n# t $ r Y nw xY wt d|z )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.
Nz method "%s" is not supportedrF ) r' ExceptionKeyErrorr( rW rF r r r )r- rN rM funcs r rF z SimpleXMLRPCDispatcher._dispatcht s * E:f%D tV}$ :V CDD D D = $t}k22
?}..vv>>>
)/M+ # 4=( $ "
6?@@@s
(
550B
B B FNF)FNN)r4
__module__ __qualname____doc__r. r0 r3 r< r? rR r8 r9 r: r> rF r[ r r r# r# s 37#(3 3 3 3"5 "5 "5 "5H E E EH H H!C !C !C !CF $ * * * ( ( (> >1A 1A 1A 1A 1Ar r# c e Zd ZdZdZdZdZdZ ej dej
ej z Z d Z
d Zd Zd
Zd Zdd
ZdS )SimpleXMLRPCRequestHandlerzSimple 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 ( i }| j dd }| d D ]^}| j | }|r@| d }|rt
| nd}||| d < _|S )NzAccept-Encodingr_ , g ?rA )headersgetr aepatternmatchgroupfloat)r- raeer~ vs r accept_encodingsz+SimpleXMLRPCRequestHandler.accept_encodings s
\
/
4
4# & &AN((++E
&KKNN !*E!HHHs$%%++a..!r c 0 | j r| j | j v S dS )NT) rpc_pathsrL r; s r is_rpc_path_validz,SimpleXMLRPCRequestHandler.is_rpc_path_valid s" > 9. . 4r c | s| dS d}t | j d }g }|r\t || }| j | }|sn/| | |t |d z }|\d | }|
| }|dS | j |t | dd | j }| d | dd | j yt | | j k ra| d
d }|r7 t) | }| d d
n# t* $ r Y nw xY w| d
t- t | | | j | dS # t4 $ r} | d t7 | j d r|| j j rp| dt- | t; j }
t- |
dd d }
| d|
| d
d | Y d} ~ dS d} ~ ww xY w)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-lengthrw r rF Content-typeztext/xmlgzipr zContent-EncodingContent-lengthi _send_traceback_headerz X-exceptionASCIIbackslashreplacez X-traceback0) r
report_404intr{ minrfilereadrf lenjoindecode_request_contentserverrR r rL
send_response send_headerencode_thresholdr r| r NotImplementedErrorstr end_headerswfilewriterk rW r traceback
format_excrI ) r- max_chunk_sizesize_remainingL
chunk_sizechunkrJ rO qr traces r do_POSTz"SimpleXMLRPCRequestHandler.do_POST s %%'' OO F9 '
*N .>!? @ @NA
- @ @
33 #ae**,
!
- 88A;;D..t44D| {66'$ T::DI H$
s # # # ^Z 8 8 8$0x==4#888 --//33FA>>A !!'28'<'t $ r | dd Y n w xY w| dd|z | dd | d S )
Nzcontent-encodingidentityr i zencoding %r not supported zerror decoding gzip contentr r ) r{ r| lowerr r r
ValueErrorr r )r- rJ r* s r r z1SimpleXMLRPCRequestHandler.decode_request_content s <##$6
CCIIKK z ! !K v
G"4(((&
P
P
P""3(Ch(NOOOOO
G
G
G""3(EFFFFF
G
s$?($J K K K )3/// s A #B1 BBc | d d}| dd | dt t | | | j | d S )Ni s No such pager z
text/plainr )r r r r r r r r- rO s r r z%SimpleXMLRPCRequestHandler.report_404* s 3 " 666 )3s8}}+=+=>>>
"""""r -c N | j j rt j | || dS dS )z$Selectively log an accepted request.N)r logRequestsr log_request)r- codesizes r r z&SimpleXMLRPCRequestHandler.log_request3 s9 ; " A " .tT4 @ @ @ @ @ A Ar N)r r )r4 rp rq rr r r wbufsizedisable_nagle_algorithmrecompileVERBOSE
IGNORECASEr} r r r r r r r[ r r rt rt s -I H "
"$bm!;= =I
E' E' E'N "# # #A A A A A Ar rt c . e Zd ZdZdZdZedddddfdZdS )SimpleXMLRPCServerag 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.
TFNc || _ t | ||| t j | ||| d S N)r r# r. socketserver TCPServerr- addrrequestHandlerr r) r* bind_and_activater+ s r r. zSimpleXMLRPCServer.__init__L sK ' ''j(DUVVV ''dNDUVVVVVr )r4 rp rq rr allow_reuse_addressr rt r. r[ r r r r 9 sW #,F !ed#'5W W W W W Wr r c : e Zd ZdZedddddfdZd Zd Zd dZdS )
MultiPathXMLRPCServera\ 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.
TFNc
v t | ||||||| i | _ || _ |pd| _ d S r% )r r. dispatchersr) r* r s r r. z MultiPathXMLRPCServer.__init__] sQ ##D$ Z$,.?AR T T T $ +G
r c || j |< |S r r )r- rL
dispatchers r add_dispatcherz$MultiPathXMLRPCServer.add_dispatcherg s !+ r c | j | S r r )r- rL s r get_dispatcherz$MultiPathXMLRPCServer.get_dispatcherk s %%r c * | j | ||| }nn# t $ ra}t t dt | d| | j | j }| | j d }Y d }~nd }~ww xY w|S )NrA rC rD rE ) r rR rG r r rH r* r) rI )r- rJ rK rL rO rQ s r rR z)MultiPathXMLRPCServer._marshaled_dispatchn s
K'-AA_d, ,HH K K K aDIIIIss344 4?D D DH t}6IJJHHHHHH K s "%
BAB Bro ) r4 rp rq rr rt r. r r rR r[ r r r r U sv -G !ed#'5, , , , & & & r r c . e Zd ZdZddZd Zd Zd dZdS )
CGIXMLRPCRequestHandlerz3Simple handler for XML-RPC data passed through CGI.FNc @ t | ||| d S r )r# r. r, s r r. z CGIXMLRPCRequestHandler.__init__ s# ''j(DUVVVVVr c r | | }t d t dt | z t t j t j j | t j j dS )z Handle a single XML-RPC requestzContent-Type: text/xmlContent-Length: %dN)rR printr sysstdoutflushbufferr )r- request_textrO s r
handle_xmlrpcz%CGIXMLRPCRequestHandler.handle_xmlrpc s ++L99
&'''
"S]]2333
)))
!!!!!r c d}t j | \ }}t j j |||dz }| d }t
d||fz t
dt j j z t
dt | z t
t j
t j
j
| t j
j dS )zHandle a single HTTP GET request.
Default implementation indicates an error because
XML-RPC uses the POST method.
r )r messageexplainr& z
Status: %d %szContent-Type: %sr N)r responseshttpr DEFAULT_ERROR_MESSAGErI r DEFAULT_ERROR_CONTENT_TYPEr r r r r r )r- r r r rO s r
handle_getz"CGIXMLRPCRequestHandler.handle_get s 1;DA;4
??7++
ow/000
4;#IIJJJ
"S]]2333
)))
!!!!!r c z |:t j dd dk r| dS t t j dd }n# t
t f$ r d}Y nw xY w| t j | }|
| dS )zHandle 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.
NREQUEST_METHODGETCONTENT_LENGTHrw ) osenvironr| r r r TypeErrorr stdinr r )r- r lengths r handle_requestz&CGIXMLRPCRequestHandler.handle_request s JNN+T 2 2e ; ; OO
RZ^^,zz(https://www.rfc-editor.org/rfc/rfc%d.txtz!https://peps.python.org/pep-%04d/(zself.%sNr_ ) escaper r searchspanrf groupsreplacer namelinkr )r- textr r' classesrY rh herepatternr~ startendallschemerfcpepselfdotr2 urls r markupzServerHTMLDoc.markup s6 &4; * < = = NN4..E % JE3 NN66$tEz"233 4 4 438<<>> 0Cc7D
= fSkk))#x88SSS ABBBB
=@3s88KVVC[[[[ IJJJJ
=9CHHDVVC[[[[ IJJJJc#a%i C''t}}T7E7 K KLLLL
= 9D @AAAAt}}T7 ; ;<<<D- . vvd455k**+++www r c |r|j pddz |z }d} d| | d| | d}
t | r t t | } nd} t |t r|d p| } |d pd} nt j | } |
| z | o| d | z z }
|
| | j ||| }|od
|z }d |
d |d
S )z;Produce HTML documentation for a function or method object.r_ r z z
z(...)r rA z'%sz
%s
z
z
z
) r4 r r r r
isinstancetupler` ra greyr preformat)r- objectr2 modr' r rY clanchornotetitleargspec docstringdecldocs r
docroutinezServerHTMLDoc.docroutine s> $*c1D8
KK T!2!2!2!24 F )F++,,GG G fe $ $ - Qi*7G q RII V,,Iw$ #A49984?,A ,A B kk t~ugw@ @2,s2-1TT33377r c i }| D ]\ }}d|z ||< || ||< | | }d|z }| | }| || j | } | od| z } |d| z z }g }
t | } | D ]0\ }}|
| ||| 1|| ddd |
z }|S ) z1Produce HTML documentation for an XML-RPC server.z#-z)%sz %sz
%s
)r' Methods functionsr_ )
itemsr headingr r rX rf r
bigsectionr ) r- server_namepackage_documentationrY fdictkeyvalueheadresultr contents method_itemss r docserverzServerHTMLDoc.docserver
s, !--// & &JC E#J :E%LLkk+.. :[H d##kk/ GG)mc)-#-- gmmoo.. & F FJC OODOOE3eO D D E E E E$// {BGGH$5$57 7 7
r c ( d}d|z }d|d|d|dS )zFormat an HTML page.rv z1zI
Python: z
z
zr[ )r- r r) css_pathcss_links r pagezServerHTMLDoc.page$ s: ?
',eeXXXxxx
A Ar )r4 rp rq rr r r r+ r/ r[ r r r r s} AA"&b"b ' ' ' ' R ,0R8 8 8 8: 4 A A A A Ar r c 0 e Zd ZdZd Zd Zd Zd Zd ZdS )XMLRPCDocGeneratorzGenerates documentation for an XML-RPC server.
This class is designed as mix-in and should not
be constructed directly.
c 0 d| _ d| _ d| _ d S )Nz XML-RPC Server DocumentationzGThis server exports the following methods through the XML-RPC protocol.)r" server_documentation server_titler; s r r. zXMLRPCDocGenerator.__init__9 s' 9
! ;r c || _ dS )z8Set the HTML title of the generated server documentationN)r4 )r- r4 s r set_server_titlez#XMLRPCDocGenerator.set_server_titleA s )r c || _ dS )z7Set the name of the generated HTML server documentationN)r" )r- r" s r set_server_namez"XMLRPCDocGenerator.set_server_nameF s 'r c || _ dS )z3Set the documentation string for the entire server.N)r3 )r- r3 s r set_server_documentationz+XMLRPCDocGenerator.set_server_documentationK s %9!!!r c i }| D ]}|| j v r| j | }n| j ddg}t | j d r | j | |d< t | j d r | j | |d< t
| }|dk r|}nAt | j d s) t | j | }n# t $ r |}Y nw xY w|} |||< t }|
| j | j | }|
t j | j | S )a 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.N_get_method_argstringr r^ rA ro rF )r8 r' r( rW r< r^ r r r r r+ r" r3 r/ htmlr r4 )r- rY r\ rN method_info
documenter
documentations r generate_html_documentationz.XMLRPCDocGenerator.generate_html_documentationP s 2244 * *Kdj(( K0 * #Tl 4=*ABB V%)]%H%H%U%UKN4=-88 L%)]%>%>{%K%KKN #K 0 0 ,.. (FF << )-!9$(M$/"& "& * - - -!,- )FF
$*GK "__
",, $ 0 $ 9 '
t{4+< = =}MMMs
C## C21C2N) r4 rp rq rr r. r6 r8 r: rA r[ r r r1 r1 2 sn ; ; ;) ) )
' ' '
9 9 9
1N 1N 1N 1N 1Nr r1 c e Zd ZdZd Zd ZdS )DocXMLRPCRequestHandlerzXML-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 F t j t j t }t j |ddd }t
|d 5 }| cd d d S # 1 swxY w Y d S )Nz..
pydoc_dataz
_pydoc.cssrb)mode)r rL dirnamerealpath__file__r openr )r- r
path_herer- fps r _get_cssz DocXMLRPCRequestHandler._get_css s GOOBG$4$4X$>$>?? 7<< 4 |LL
(
&
&
& "7799 s 5BB Bc < | s| dS | j d r d}| | j }n.d}| j d }| d | dd|z | d t t | | | j
| dS )
}Handles the HTTP GET request.
Interpret all HTTP GET requests as requests for server
documentation.
Nz.cssztext/cssz text/htmlr& r z Content-Typez%s; charset=UTF-8r )r r rL endswithrN r rA rI r r r r r r r )r- content_typerO s r do_GETz DocXMLRPCRequestHandler.do_GET s %%'' OO F 9 f % % Q%L}}TY//HH&L{>>@@GGPPH 3 )<|)KLLL )3s8}}+=+=>>>
"""""r N)r4 rp rq rr rN rS r[ r r rC rC s< # # # # #r rC c & e Zd ZdZedddddfdZdS )DocXMLRPCServerzXML-RPC and HTML documentation server.
Adds the ability to serve server documentation to the capabilities
of SimpleXMLRPCServer.
TFNc
| t | ||||||| t | d S r )r r. r1 r s r r. zDocXMLRPCServer.__init__ sK ##D$ $.:K$5 7 7 7 ##D)))))r )r4 rp rq rr rC r. r[ r r rU rU sD -D !ed#'5* * * * * *r rU c e Zd ZdZd Zd ZdS )DocCGIXMLRPCRequestHandlerzJHandler for XML-RPC data and documentation requests passed through
CGIc | d }t d t dt | z t t j t j j | t j j dS )rP r& zContent-Type: text/htmlr N) rA rI r r r r r r r r s r r z%DocCGIXMLRPCRequestHandler.handle_get s 3355< t j S r )datetimenowr[ r r getCurrentTimez)ExampleService.currentTime.getCurrentTime s (,,...r N)r4 rp rq staticmethodrf r[ r r currentTimerb s-
/
/ \
/
/
/r rh N)r4 rp rq r` rh r[ r r r] r] sK / / / / / / / / / /r r] ) localhosti@ c | |z S r r[ )xys r rm s
QqS r add)r z&Serving XML-RPC on localhost port 8000zKIt is advisable to run this example server within a secure, closed network.z&
Keyboard interrupt received, exiting.)T)1rr
xmlrpc.clientr r r r r http.serverr functoolsr inspectr
r= r r r r r r` r fcntl ImportErrorr r! r# rt r r r r HTMLDocr r1 rC rU rX r4 rd r] r r3 powr0 r? r
serve_foreverKeyboardInterruptexitr[ r r rz s e eT H G G G G G G G G G G G G G . . . . . .
LLLL EEE 04 4 4IA IA IA IA IA IA IA IAVPA PA PA PA PA!7 PA PA PAdW W W W W //W W W8% % % % % . % % %N?- ?- ?- ?- ?- 4 ?- ?- ?-JoA oA oA oA oAEM oA oA oAbON ON ON ON ON ON ON ONb&# &# &# &# &# 8 &# &# &#P* * * * **** * * * * * * *$;$6* * *4 zOOO/ / / / / / / /
/ 0 0 F %%% %888 !1!1d KKK++---
6777
[\\\ " " " " E; < < < CHQKKKKK sI A AAA6G
F"!G" GGGGG G __pycache__/server.cpython-311.opt-2.pyc 0000644 00000106154 15102763701 0013735 0 ustar 00
!A?h d dl mZmZmZmZmZ d dlmZ d dlm Z d dl
m Z d dl Z d dlZ
d dlZd dlZd dlZd dlZd dlZd dlZ d dlZn
# e$ r dZY nw xY wd'dZd Z G d d
Z G d d e Z G d
dej e Z G d de Z G d de Z G d dej Z G d d Z G d de Z! G d dee Z" G d d e e Z#e$d k rd dl%Z% G d d Z& ed 5 Z'e'( e) e'( d! d" e'* e& d# e'+ e,d$ e,d% e'- n&# e.$ r e,d& ej/ d Y nw xY wddd dS # 1 swxY w Y dS dS )( )Faultdumpsloads gzip_encode gzip_decode)BaseHTTPRequestHandler)partial) signatureNTc |r| d }n|g}|D ]9}| d rt d|z t | | } :| S )N._z(attempt to access private attribute "%s")split
startswithAttributeErrorgetattr)objattrallow_dotted_namesattrsis &/usr/lib64/python3.11/xmlrpc/server.pyresolve_dotted_attributer | s|
3
! ! << ! :Q>
#a..CC J c < fdt D S )Nc x g | ]6}| d t t | 4|7S )r
)r callabler ).0memberr s r
z'list_public_methods.. sU 4 4 4v ((-- 4 WS& 1 122 4F 4 4 4r )dir)r s `r list_public_methodsr! s8 3 4 4 4 4S 4 4 4 4r c ^ e Zd Z ddZddZddZd Zd ZddZd Z d
Z
d Z d Z d
Z
dS )SimpleXMLRPCDispatcherFNc P i | _ d | _ || _ |pd| _ || _ d S Nutf-8)funcsinstance
allow_noneencodinguse_builtin_typesselfr) r* r+ s r __init__z SimpleXMLRPCDispatcher.__init__ s1
$ +G
!2 r c $ || _ || _ d S N)r( r )r- r( r s r register_instancez(SimpleXMLRPCDispatcher.register_instance s @ !
"4 r c ^ |t | j | S ||j }|| j |< |S )N)name)r register_function__name__r' )r- functionr3 s r r4 z(SimpleXMLRPCDispatcher.register_function sC 41=== = <$D#
4r c b | j | j | j | j d d S )N)zsystem.listMethodszsystem.methodSignaturezsystem.methodHelp)r' updatesystem_listMethodssystem_methodSignaturesystem_methodHelpr- s r register_introspection_functionsz7SimpleXMLRPCDispatcher.register_introspection_functions sO
$2I151L,0,BD D E E E E Er c J | j d| j i d S )Nzsystem.multicall)r' r8 system_multicallr< s r register_multicall_functionsz3SimpleXMLRPCDispatcher.register_multicall_functions s. <
-0EFGGGGGr c t || j \ }}|
||| }n| || }|f}t |d| j | j }n# t $ r&}t || j | j }Y d }~nVd }~wt $ rF}t t
dt | d| | j | j }Y d }~nd }~ww xY w| | j d S )N)r+ )methodresponser) r* )r) r* :r* r) xmlcharrefreplace)
r r+ _dispatchr r) r* r
BaseExceptiontypeencode) r- datadispatch_methodpathparamsmethodresponsefaultexcs r _marshaled_dispatchz*SimpleXMLRPCDispatcher._marshaled_dispatch s< "44;Q R R RNFF **?66:: >>&&99 {H Xa(,$-Q Q QHH 5 5 5 Ut&*m5 5 5HHHHHH aDIIIIss344 4? HHHHHH t}.ABBBs$ A A" "
C , B
C 2<'' 's 'B
BBc v g }|D ]}|d }|d } | | || g ># t $ r,}| |j |j d Y d }~od }~wt
$ r4}| dt
| d|d Y d }~d }~ww xY w|S )N
methodNamerN ) faultCode faultStringrB rD )appendrG r re rf rH rI )r- call_listresultscallr] rN rQ rR s r r? z'SimpleXMLRPCDispatcher.system_multicallU s1 D |,K(^F
{F C C DEEEE
#(?%*%68 8 !
#$04S 33%?A A
s# *A
B6"A55
B6*B11B6c l | j | }| || S t d|z # t $ r Y nw xY w| j dt | j d r| j || S t
| j || j }| || S n# t $ r Y nw xY wt d|z )Nz method "%s" is not supportedrG ) r' ExceptionKeyErrorr( rX rG r r r )r- rO rN funcs r rG z SimpleXMLRPCDispatcher._dispatcht s ( E:f%D tV}$ :V CDD D D = $t}k22
?}..vv>>>
)/M+ # 4=( $ "
6?@@@s
)
661B
B! B!FNF)FNN)r5
__module__ __qualname__r. r1 r4 r= r@ rS r9 r: r; r? rG r\ r r r# r# s 37#(3 3 3 3"5 "5 "5 "5H E E EH H H!C !C !C !CF $ * * * ( ( (> >1A 1A 1A 1A 1Ar r# c e Zd Z dZdZdZdZ ej dej ej
z Z d Z d Z
d Zd Zd
Zdd Zd
S )SimpleXMLRPCRequestHandler)/z/RPC2
/pydoc.cssix Tz
\s* ([^\s;]+) \s* #content-coding
(;\s* q \s*=\s* ([0-9\.]+))? #q
c ( i }| j dd }| d D ]^}| j | }|r@| d }|rt
| nd}||| d < _|S )NzAccept-Encodingr` , g ?rB )headersgetr aepatternmatchgroupfloat)r- raeer~ vs r accept_encodingsz+SimpleXMLRPCRequestHandler.accept_encodings s
\
/
4
4# & &AN((++E
&KKNN !*E!HHHs$%%++a..!r c 0 | j r| j | j v S dS )NT) rpc_pathsrM r< s r is_rpc_path_validz,SimpleXMLRPCRequestHandler.is_rpc_path_valid s" > 9. . 4r c | s| d S d}t | j d }g }|r\t || }| j | }|sn/| | |t |d z }|\d | }|
| }|d S | j |t | dd | j }| d | dd | j yt | | j k ra| d d
}|r7 t) | }| d d n# t* $ r Y nw xY w| d t- t | | | j | d S # t4 $ r} | d
t7 | j d r|| j j rp| dt- | t; j }
t- |
dd d }
| d|
| d d | Y d } ~ d S d } ~ ww xY w)Ni zcontent-lengthrw r rG Content-typeztext/xmlgzipr zContent-EncodingContent-lengthi _send_traceback_headerz X-exceptionASCIIbackslashreplacez X-traceback0) r
report_404intr{ minrfilereadrg lenjoindecode_request_contentserverrS r rM
send_response send_headerencode_thresholdr r| r NotImplementedErrorstr end_headerswfilewriterl rX r traceback
format_excrJ ) r- max_chunk_sizesize_remainingL
chunk_sizechunkrK rP qr traces r do_POSTz"SimpleXMLRPCRequestHandler.do_POST s %%'' OO F9 '
*N .>!? @ @NA
- @ @
33 #ae**,
!
- 88A;;D..t44D| {66'$ T::DI H$
s # # # ^Z 8 8 8$0x==4#888 --//33FA>>A !!'28'<'t $ r | dd Y n w xY w| dd|z | dd | d S )
Nzcontent-encodingidentityr i zencoding %r not supported zerror decoding gzip contentr r ) r{ r| lowerr r r
ValueErrorr r )r- rK r* s r r z1SimpleXMLRPCRequestHandler.decode_request_content s <##$6
CCIIKK z ! !K v
G"4(((&
P
P
P""3(Ch(NOOOOO
G
G
G""3(EFFFFF
G
s$?($J K K K )3/// s A #B1 BBc | d d}| dd | dt t | | | j | d S )Ni s No such pager z
text/plainr )r r r r r r r r- rP s r r z%SimpleXMLRPCRequestHandler.report_404* s 3 " 666 )3s8}}+=+=>>>
"""""r -c P | j j rt j | || d S d S r0 )r logRequestsr log_request)r- codesizes r r z&SimpleXMLRPCRequestHandler.log_request3 s: 2 ; " A " .tT4 @ @ @ @ @ A Ar N)r r )r5 rq rr r r wbufsizedisable_nagle_algorithmrecompileVERBOSE
IGNORECASEr} r r r r r r r\ r r rt rt s -I H "
"$bm!;= =I
E' E' E'N "# # #A A A A A Ar rt c , e Zd Z dZdZedddddfdZdS )SimpleXMLRPCServerTFNc || _ t | ||| t j | ||| d S r0 )r r# r. socketserver TCPServerr- addrrequestHandlerr r) r* bind_and_activater+ s r r. zSimpleXMLRPCServer.__init__L sK ' ''j(DUVVV ''dNDUVVVVVr )r5 rq rr allow_reuse_addressr rt r. r\ r r r r 9 sR #,F !ed#'5W W W W W Wr r c 8 e Zd Z edddddfdZd Zd ZddZdS ) MultiPathXMLRPCServerTFNc
v t | ||||||| i | _ || _ |pd| _ d S r% )r r. dispatchersr) r* r s r r. z MultiPathXMLRPCServer.__init__] sQ ##D$ Z$,.?AR T T T $ +G
r c || j |< |S r0 r )r- rM
dispatchers r add_dispatcherz$MultiPathXMLRPCServer.add_dispatcherg s !+ r c | j | S r0 r )r- rM s r get_dispatcherz$MultiPathXMLRPCServer.get_dispatcherk s %%r c * | j | ||| }nn# t $ ra}t t dt | d| | j | j }| | j d }Y d }~nd }~ww xY w|S )NrB rD rE rF ) r rS rH r r rI r* r) rJ )r- rK rL rM rP rR s r rS z)MultiPathXMLRPCServer._marshaled_dispatchn s
K'-AA_d, ,HH K K K aDIIIIss344 4?D D DH t}6IJJHHHHHH K s "%
BAB Brp )r5 rq rr rt r. r r rS r\ r r r r U sq -G !ed#'5, , , , & & & r r c , e Zd Z ddZd Zd ZddZdS ) CGIXMLRPCRequestHandlerFNc @ t | ||| d S r0 )r# r. r, s r r. z CGIXMLRPCRequestHandler.__init__ s# ''j(DUVVVVVr c t | | }t d t dt | z t t j t j j | t j j d S )NzContent-Type: text/xmlContent-Length: %d)rS printr sysstdoutflushbufferr )r- request_textrP s r
handle_xmlrpcz%CGIXMLRPCRequestHandler.handle_xmlrpc s -++L99
&'''
"S]]2333
)))
!!!!!r c d}t j | \ }}t j j |||dz }| d }t
d||fz t
dt j j z t
dt | z t
t j
t j
j
| t j
j d S )Nr )r messageexplainr& z
Status: %d %szContent-Type: %sr )r responseshttpr DEFAULT_ERROR_MESSAGErJ r DEFAULT_ERROR_CONTENT_TYPEr r r r r r )r- r r r rP s r
handle_getz"CGIXMLRPCRequestHandler.handle_get s 1;DA;4
??7++
ow/000
4;#IIJJJ
"S]]2333
)))
!!!!!r c | |:t j dd dk r| d S t t j dd }n# t
t f$ r d}Y nw xY w| t j | }|
| d S )NREQUEST_METHODGETCONTENT_LENGTHrw ) osenvironr| r r r TypeErrorr stdinr r )r- r lengths r handle_requestz&CGIXMLRPCRequestHandler.handle_request s JNN+T 2 2e ; ; OO
RZ^^, e Zd Z di i i fdZdi i i dfdZd Zd ZdS )
ServerHTMLDocNc |p| j }g }d}t j d } | || } | sn| \ }
} | ||||
| \ } }
}}}}|
r< || dd }| d|d|d n|r8d t | z }| d|d || d n|r8d
t | z }| d|d || d n|| | dz d k r,| | |||| nD|r| d |z n)| | || | }| |||d d
| S )Nr zS\b((http|https|ftp)://\S+[\w/]|RFC[- ]?(\d+)|PEP[- ]?(\d+)|(self\.)?((?:\w|\.)+))\brB "z"z zz(https://www.rfc-editor.org/rfc/rfc%d.txtz!https://peps.python.org/pep-%04d/(zself.%sr` ) escaper r searchspanrg groupsreplacer namelinkr )r- textr r' classesrZ ri herepatternr~ startendallschemerfcpepselfdotr3 urls r markupzServerHTMLDoc.markup s: F&4; * < = = NN4..E % JE3 NN66$tEz"233 4 4 438<<>> 0Cc7D
= fSkk))#x88SSS ABBBB
=@3s88KVVC[[[[ IJJJJ
=9CHHDVVC[[[[ IJJJJc#a%i C''t}}T7E7 K KLLLL
= 9D @AAAAt}}T7 ; ;<<<D- . vvd455k**+++www r c |r|j pddz |z }d} d| | d| | d}
t | r t t | } nd} t |t r|d p| } |d pd} nt j | } |
| z | o| d | z z }
|
| | j ||| }|od
|z }d |
d |d
S )Nr` r z z
z(...)r rB z'%sz
%s
z
z
z
) r5 r r r r
isinstancetuplera rb greyr
preformat)r- objectr3 modr' r rZ clanchornotetitleargspec docstringdecldocs r
docroutinezServerHTMLDoc.docroutine s? I$*c1D8
KK T!2!2!2!24 F )F++,,GG G fe $ $ - Qi*7G q RII V,,Iw$ #A49984?,A ,A B kk t~ugw@ @2,s2-1TT33377r c i }| D ]\ }}d|z ||< || ||< | | }d|z }| | }| || j | } | od| z } |d| z z }g }
t | } | D ]0\ }}|
| ||| 1|| ddd |
z }|S ) Nz#-z)%sz %sz
%s
)r' Methods functionsr` )
itemsr headingr
r rY rg r
bigsectionr ) r- server_namepackage_documentationrZ fdictkeyvalueheadresultr contents method_itemss r docserverzServerHTMLDoc.docserver
s- ?!--// & &JC E#J :E%LLkk+.. :[H d##kk/ GG)mc)-#-- gmmoo.. & F FJC OODOOE3eO D D E E E E$// {BGGH$5$57 7 7
r c * d}d|z }d|d|d|dS )Nrv z1zI
Python: z
z
zr\ )r- r r( css_pathcss_links r pagezServerHTMLDoc.page$ s= " ?
',eeXXXxxx
A Ar )r5 rq rr r
r r* r. r\ r r r r sz A"&b"b ' ' ' ' R ,0R8 8 8 8: 4 A A A A Ar r c . e Zd Z d Zd Zd Zd Zd ZdS )XMLRPCDocGeneratorc 0 d| _ d| _ d| _ d S )Nz XML-RPC Server DocumentationzGThis server exports the following methods through the XML-RPC protocol.)r! server_documentation server_titler< s r r. zXMLRPCDocGenerator.__init__9 s' 9
! ;r c || _ d S r0 )r3 )r- r3 s r set_server_titlez#XMLRPCDocGenerator.set_server_titleA s F (r c || _ d S r0 )r! )r- r! s r set_server_namez"XMLRPCDocGenerator.set_server_nameF s E&r c || _ d S r0 )r2 )r- r2 s r set_server_documentationz+XMLRPCDocGenerator.set_server_documentationK s A$8!!!r c i }| D ]}|| j v r| j | }n| j d d g}t | j d r | j | |d< t | j d r | j | |d< t
| }|dk r|}nAt | j d s) t | j | }n# t $ r |}Y nw xY w|} |||< t }|
| j | j | }|
t j | j | S )N_get_method_argstringr r_ rB rp rG )r9 r' r( rX r; r_ r
r r r r* r! r2 r. htmlr r3 )r- rZ r] rO method_info
documenter
documentations r generate_html_documentationz.XMLRPCDocGenerator.generate_html_documentationP s ! 2244 * *Kdj(( K0 * #Tl 4=*ABB V%)]%H%H%U%UKN4=-88 L%)]%>%>{%K%KKN #K 0 0 ,.. (FF << )-!9$(M$/"& "& * - - -!,- )FF
$*GK "__
",, $ 0 $ 9 '
t{4+< = =}MMMs C$$ C32C3N)r5 rq rr r. r5 r7 r9 r@ r\ r r r0 r0 2 si ; ; ;) ) )
' ' '
9 9 9
1N 1N 1N 1N 1Nr r0 c e Zd Z d Zd ZdS )DocXMLRPCRequestHandlerc F t j t j t }t j |ddd }t
|d 5 }| cd d d S # 1 swxY w Y d S )Nz..
pydoc_dataz
_pydoc.cssrb)mode)r rM dirnamerealpath__file__r openr )r- r path_herer, fps r _get_cssz DocXMLRPCRequestHandler._get_css s GOOBG$4$4X$>$>?? 7<< 4 |LL
(
&
&
& "7799 s 5BB Bc > | s| d S | j d r d}| | j }n.d}| j d }| d | dd|z | dt t | | | j
| d S ) Nz.cssztext/cssz text/htmlr& r z Content-Typez%s; charset=UTF-8r )r r rM endswithrM r r@ rJ r r r r r r r )r- content_typerP s r do_GETz DocXMLRPCRequestHandler.do_GET s %%'' OO F 9 f % % Q%L}}TY//HH&L{>>@@GGPPH 3 )<|)KLLL )3s8}}+=+=>>>
"""""r N)r5 rq rr rM rQ r\ r r rB rB s7 # # # # #r rB c $ e Zd Z edddddfdZdS )DocXMLRPCServerTFNc
| t | ||||||| t | d S r0 )r r. r0 r s r r. zDocXMLRPCServer.__init__ sK ##D$ $.:K$5 7 7 7 ##D)))))r )r5 rq rr rB r. r\ r r rS rS s? -D !ed#'5* * * * * *r rS c e Zd Z d Zd ZdS )DocCGIXMLRPCRequestHandlerc | d }t d t dt | z t t j t j j | t j j d S )Nr& zContent-Type: text/htmlr ) r@ rJ r r r r r r r r s r r z%DocCGIXMLRPCRequestHandler.handle_get s 3355< t j S r0 )datetimenowr\ r r getCurrentTimez)ExampleService.currentTime.getCurrentTime s (,,...r N)r5 rq rr staticmethodrd r\ r r currentTimer` s-
/
/ \
/
/
/r rf N)r5 rq rr r^ rf r\ r r r[ r[ sK / / / / / / / / / /r r[ ) localhosti@ c | |z S r0 r\ )xys r rk s
QqS r add)r z&Serving XML-RPC on localhost port 8000zKIt is advisable to run this example server within a secure, closed network.z&
Keyboard interrupt received, exiting.)T)0
xmlrpc.clientr r r r r http.serverr functoolsr inspectr
r< r r r r r ra r fcntl ImportErrorr r! r# rt r r r r HTMLDocr r0 rB rS rV r5 rb r[ r r4 powr1 r@ r
serve_foreverKeyboardInterruptexitr\ r r rx s eT H G G G G G G G G G G G G G . . . . . .
LLLL EEE 04 4 4IA IA IA IA IA IA IA IAVPA PA PA PA PA!7 PA PA PAdW W W W W //W W W8% % % % % . % % %N?- ?- ?- ?- ?- 4 ?- ?- ?-JoA oA oA oA oAEM oA oA oAbON ON ON ON ON ON ON ONb&# &# &# &# &# 8 &# &# &#P* * * * **** * * * * * * *$;$6* * *4 zOOO/ / / / / / / /
/ 0 0 F %%% %888 !1!1d KKK++---
6777
[\\\ " " " " E; < < < CHQKKKKK sI A AAA6G F! G! GGGGGG __pycache__/client.cpython-311.pyc 0000644 00000157167 15102763701 0012757 0 ustar 00
!A?h B d Z ddlZddlZddlZddlmZ ddlmZ ddlZddl Z
ddl m Z ddl
Z
ddlmZ ddlZn
# e$ r dZY nw xY wd Zdej dd z Zd
Zd Zd Zd
ZdZdZdZd Z dZ dZ d
Z dZ dZ!dZ" G d de# Z$ G d de$ Z% G d de$ Z& G d d e$ Z'e(xZ)Z* ed d d Z+d Z, e,d rd! Z-n e,d" rd# Z-nd$ Z-[+[,d% Z. G d& d' Z/d( Z0d) Z1 G d* d+ Z2d, Z3e/e2fZ4 G d- d. Z5 G d/ d0 Z6 G d1 d2 Z7 G d3 d4 Z8 G d5 d6 Z9 G d7 d8 Z:dxZ;xZ dOd;Z?dNd<Z@d= ZAdPd?ZB G d@ dAerejC neD ZE G dB dC ZF G dD dE ZG G dF dGeG ZH G dH dI ZIeIZJeKdJk r eIdK ZL eMeLjN O n # e$$ rZP eMdLeP Y dZP[PndZP[Pww xY w e:eL ZQeQR eQS d dM eQT d d eQ D ]
ZU eMeU dS # e$$ rZP eMdLeP Y dZP[PdS dZP[Pww xY wdS )Qa
An XML-RPC client interface for Python.
The marshalling and response parser code can also be used to
implement XML-RPC servers.
Exported exceptions:
Error Base class for client errors
ProtocolError Indicates an HTTP protocol error
ResponseError Indicates a broken response package
Fault Indicates an XML-RPC fault package
Exported classes:
ServerProxy Represents a logical connection to an XML-RPC server
MultiCall Executor of boxcared xmlrpc requests
DateTime dateTime wrapper for an ISO 8601 string or time tuple or
localtime integer value to generate a "dateTime.iso8601"
XML-RPC value
Binary binary data wrapper
Marshaller Generate an XML-RPC params chunk from a Python data structure
Unmarshaller Unmarshal an XML-RPC response from incoming XML event message
Transport Handles an HTTP transaction to an XML-RPC server
SafeTransport Handles an HTTPS transaction to an XML-RPC server
Exported constants:
(none)
Exported functions:
getparser Create instance of the fastest available parser & attach
to an unmarshalling object
dumps Convert an argument tuple or a Fault instance to an XML-RPC
request (or response, if the methodresponse option is used).
loads Convert an XML-RPC packet to unmarshalled data plus a method
name (None if not present).
N)datetime)Decimal)expat)BytesIOc | dd } | dd } | dd S )N&z&z>)replace)ss &/usr/lib64/python3.11/xmlrpc/client.pyescaper s< #w A #v A 99S& " "" z%d.%d ii iDii ipiԁiCiBiiic e Zd ZdZej ZdS )Errorz Base class for client errors.N)__name__
__module__ __qualname____doc__object__str__ r r
r r s ''nGGGr r c e Zd ZdZd Zd ZdS )
ProtocolErrorz!Indicates an HTTP protocol error.c r t | || _ || _ || _ || _ d S N)r __init__urlerrcodeerrmsgheaders)selfr r r! r" s r
r zProtocolError.__init__ s4
t r c R d| j j d| j d| j d| j d S )Nr for : r
) __class__r r r r! r# s r
__repr__zProtocolError.__repr__ s7 ^
$
$
$dhhh dkkk
K r Nr r r r r r* r r r
r r s8 ++ r r c e Zd ZdZdS )
ResponseErrorz$Indicates a broken response package.N)r r r r r r r
r- r- s ..Dr r- c e Zd ZdZd Zd ZdS )Faultz#Indicates an XML-RPC fault package.c V t | || _ || _ d S r )r r faultCode faultString)r# r1 r2 extras r
r zFault.__init__ s)
t "&r c B d| j j d| j d| j dS )Nr r' r& r
)r( r r1 r2 r) s r
r* zFault.__repr__ s2 $ 7 7 7 $0@0@0@B Br Nr+ r r r
r/ r/ s= --' ' 'B B B B Br r/ c b t | dk S # t $ r Y dS w xY w)N0001F)_day0strftime
ValueError)fmts r
_tryr< s@ ~~c""f,, uus
..z%Yc , | d S N%Y%m%dT%H:%M:%Sr9 values r
_iso8601_formatrC s ~~ /000r z%4Yc , | d S )Nz%4Y%m%dT%H:%M:%Sr@ rA s r
rC rC s ~~ 0111r c R | d d S )Nr? )r9 zfillrA s r
rC rC s# ~~ /0066r:::r c t | t rt | S t | t t j f s-| dk rt j } t j | } d| d d z S )Nr z%04d%02d%02dT%02d:%02d:%02d )
isinstancer rC tupletime struct_time localtimerA s r
_strftimerO sr %"" & u%%% eeT%5 6 7 7 & A::IKKEu%% (5!9 44r c \ e Zd ZdZddZd Zd Zd Zd Zd Z d Z
d
Z d Z d Z
d
Zd ZdS )DateTimezDateTime wrapper for an ISO 8601 string or time tuple or
localtime integer value to generate 'dateTime.iso8601' XML-RPC
value.
r c j t |t r || _ d S t | | _ d S r )rJ strrB rO )r# rB s r
r zDateTime.__init__. s2 eS ! ! * DJJJ"5))DJJJr c l t |t r| j }|j }nt |t r| j }t | }nat |t
r
| j }|}nBt
|d r)| }| }n | }t }||fS )N timetuple) rJ rQ rB r rC rS hasattrrU NotImplementedr# otherr os r
make_comparablezDateTime.make_comparable4 s eX & &
A AA
x
(
(
A &&AA
s
#
#
AAA
UK
(
( A!!AAA A!t r c ^ | | \ }}|t u rt S ||k S r r[ rW rX s r
__lt__zDateTime.__lt__F 3 ##E**1 ! !1u r c ^ | | \ }}|t u rt S ||k S r r] rX s r
__le__zDateTime.__le__L 3 ##E**1 ! !Av
r c ^ | | \ }}|t u rt S ||k S r r] rX s r
__gt__zDateTime.__gt__R r_ r c ^ | | \ }}|t u rt S ||k S r r] rX s r
__ge__zDateTime.__ge__X rb r c ^ | | \ }}|t u rt S ||k S r r] rX s r
__eq__zDateTime.__eq__^ rb r c 6 t j | j d S r> )rL strptimerB r) s r
rU zDateTime.timetupled s }TZ):;;;r c | j S r rA r) s r
r zDateTime.__str__l s
zr c J d| j j | j t | fz S )Nz<%s %r at %#x>)r( r rB idr) s r
r* zDateTime.__repr__o s! 4>#:DJ4"QQQr c R t | | _ d S r )rS striprB r# datas r
decodezDateTime.decoder s YY__&&
r c | d | | j | d d S Nzz
)writerB )r# outs r
encodezDateTime.encodeu sB -... $* 122222r N)r )r r r r r r[ r^ ra rd rf rh rU r r* rr rw r r r
rQ rQ ( s
* * * * $ < < < R R R' ' '3 3 3 3 3r rQ c L t }| | |S r )rQ rr rq rB s r
_datetimerz z s" JJE LL Lr c , t j | d S r> )r rj )rq s r
_datetime_typer| s T#4 5 55r c 2 e Zd ZdZddZd Zd Zd Zd ZdS ) BinaryzWrapper for binary data.Nc |d}nGt |t t f s t d|j j z t | }|| _ d S )Nr z#expected bytes or bytearray, not %s)rJ bytes bytearray TypeErrorr( r rq rp s r
r zBinary.__init__ s] <DD dUI$677
9 E $ 7!8 9 9 9;;D r c , t | j d S )Nzlatin-1)rS rq r) s r
r zBinary.__str__ s 49i(((r c P t |t r|j }| j |k S r )rJ r~ rq )r# rY s r
rh z
Binary.__eq__ s( eV $ $ JEyE!!r c 8 t j | | _ d S r )base64 decodebytesrq rp s r
rr z
Binary.decode s &t,, r c | d t j | j }| | d | d d S Nz
asciiz
)ru r encodebytesrq rr )r# rv encodeds r
rw z
Binary.encode s^ %&&&$TY// '..))*** '(((((r r ) r r r r r r rh rr rw r r r
r~ r~ sj "" ) ) )" " "
- - -) ) ) ) )r r~ c L t }| | |S r )r~ rr ry s r
_binaryr s" HHE LL Lr c e Zd Zd Zd Zd ZdS ) ExpatParserc t j d d x| _ }|| _ |j |_ |j |_ |j |_ d }|
|d d S r ) r ParserCreate_parser_targetstartStartElementHandlerendEndElementHandlerrq CharacterDataHandlerxml)r# targetparserencodings r
r zExpatParser.__init__ s_ % 24 > >> v %+\"#): &,k#
8T"""""r c < | j |d d S NF)r Parserp s r
feedzExpatParser.feed s 4'''''r c l | j }| `| ` | dd d S # t $ r Y d S w xY w)Nr T)r r r AttributeError)r# r s r
closezExpatParser.close sW $\F dl LLd # # # # # DD s %
33N)r r r r r r r r r
r r sA # # #( ( ($ $ $ $ $r r c e Zd ZdZddZi Zd Zd Zd Zee e d < d Z
e
ee < d Z e ee
< e Zd
Zeee< efd Zeee< d Zeee< eee< d
Zeee< eee< efdZeee< d Z e ee < d Z e ee < e ee < e ed< dS )
Marshallerav Generate an XML-RPC params chunk from a Python data structure.
Create a Marshaller instance for each set of parameters, and use
the "dumps" method to convert your data (represented as a tuple)
to an XML-RPC params chunk. To write a fault response, pass a
Fault instance instead. You may prefer to use the "dumps" module
function for this purpose.
NFc > i | _ d | _ || _ || _ d S r )memorq r
allow_none)r# r r s r
r zMarshaller.__init__ s"
$r c T g }|j }| j }t |t r0 |d ||j |j d| |d n= |d |D ]$} |d ||| |d % |d d | }|S ) Nz
)r1 r2 z
z
z
z
z
)append_Marshaller__dumprJ r/ r1 r2 join)r# valuesrv ru dumpvresults r
dumpszMarshaller.dumps s
{ fe $ $ ! E+ Dv /!'!35 5
E,
E,
$
$k"""Ql#### E-
r c | j t | }n# t $ r t |d s t dt | z t | j D ]<}|| j v r t dt | z =| j d }Y nw xY w || || d S )N__dict__zcannot marshal %s objects_arbitrary_instance)dispatchtypeKeyErrorrV r __mro__keys)r# rB ru ftype_s r
__dumpzMarshaller.__dump s 5
d5kk*AA 5 5 55*--
K ;d5kk IJJJ e,
O
ODM . . 0 000#$?$u++$MNNN 1
34AAA 5
$u s BB76B7c H | j st d |d d S )Nz0cannot marshal None unless allow_none is enabledz)r r r# rB ru s r
dump_nilzMarshaller.dump_nil s3 P NOO O
%&&&&&r c P |d ||rdpd |d d S )Nz10z
r r s r
dump_boolzMarshaller.dump_bool sC
!!!
em"s###
$%%%%%r c |t k s |t k rt d |d |t t | |d d S )Nzint exceeds XML-RPC limitsz z
)MAXINTMININT
OverflowErrorrS intr s r
dump_longzMarshaller.dump_long& se 6>>UV^^ <== =
n
c#e**oo
!!!!!r c b |d |t | |d d S )Nzz
)reprr s r
dump_doublezMarshaller.dump_double1 s@
d5kk
#$$$$$r c Z |d | || |d d S )Nzz
r )r# rB ru r s r
dump_unicodezMarshaller.dump_unicode7 sB
ffUmm
#$$$$$r c |d t j | } || d |d d S r )r r rr )r# rB ru r s r
dump_byteszMarshaller.dump_bytes= sV
!"""$U++
gnnW%%&&&
#$$$$$r c t | }|| j v rt d d | j |< | j } |d |D ]} ||| |d | j |= d S )Nz"cannot marshal recursive sequencesz
z
)rm r r r )r# rB ru ir r s r
dump_arrayzMarshaller.dump_arrayE s uII >> @AA A ! {
&''' A DENNNN
)*** IaLLLr c t | }|| j v rt d d | j |< | j } |d | D ]b\ }} |d t |t st d |d || z ||| |d c |d | j |= d S )Nz%cannot marshal recursive dictionariesz
z
z dictionary key must be stringz%s
z
z
)rm r r r itemsrJ rS )r# rB ru r r r kr s r
dump_structzMarshaller.dump_structS s uII >> CDD D ! {
!"""KKMM ! !DAq E, a%%
A ?@@@ E%q 1 2 2 2 DENNN E-
#$$$ IaLLLr c b |d |t | |d d S rt )rO r s r
dump_datetimezMarshaller.dump_datetimee sB
)***
i
-.....r c |j t v r || _ | | | `d S | |j | d S r )r( WRAPPERSru rw r r r s r
dump_instancezMarshaller.dump_instancek sQ ?h & & DJ LL
U^U 3 3 3 3 3r r r )!r r r r r r r r r r r boolr r dump_intr floatr r rS r r r r rK listr dictr r r rQ r~ r r r
r r s % % % % H 6 $' ' ' $HTT$ZZ& & & HTN" " " HSM H% % % "HUO06 % % % % !HSM% % %
!HUO$HY
!HUO HTN/5 !HTN/ / / 'HX4 4 4 'HX$HV '4H
"###r r c n e Zd ZdZd/dZd Zd Zd Zd Zd Z d Z
d
Z i Z d Z
e
e d < d
Zee d< d Zee d< ee d< ee d< ee d< ee d< ee d< d Zee d< ee d< d Zee d< d Zee d < ee d < d Zee d < d Zee d!< d" Zee d#< d$ Zee d%< d& Zee d'< d( Zee d)< d* Zee d+< d, Zee d-< d.S )0 Unmarshallera Unmarshal an XML-RPC response, based on incoming XML event
messages (start, data, end). Call close() to get the resulting
data structure.
Note that this reader is fairly tolerant, and gladly accepts bogus
XML-RPC data without complaining (but not bogus XML).
Fc d | _ g | _ g | _ g | _ d| _ d | _ d| _ | j j | _ |p|| _ || _ d S )NFutf-8)
_type_stack_marks_data_value _methodname _encodingr
_use_datetime
_use_bytes)r# use_datetimeuse_builtin_typess r
r zUnmarshaller.__init__ sX
k( . >,+r c | j | j rt | j dk rt di | j d t | j S )Nfaultr r )r r r- r/ r rK r) s r
r zUnmarshaller.close sR : // ! : ))$+a.)) )T[!!!r c | j S r )r r) s r
getmethodnamezUnmarshaller.getmethodname s r c || _ d S r )r )r# r
standalones r
r zUnmarshaller.xml s
!r c d|v r| d d }|dk s|dk r,| j t | j g | _ | j r|| j vrt d|z |dk | _ d S )N:arraystructzunknown tag %rrB ) splitr r lenr r r r r- )r# tagattrss r
r zUnmarshaller.start s #::))C..$C '>>SH__ K s4; / / 0 0 0
; 83dm33 03 677 7g~ r c : | j | d S r )r r )r# texts r
rq zUnmarshaller.data s
$ r c
| j | }nQ# t $ rD d|vrY d S | j | d d }n# t $ r Y Y d S w xY wY nw xY w || d | j S )Nr r r )r r r r r )r# r r s r
r zUnmarshaller.end s
c"AA #~~
M#))C.."45
qrwwtz**+++2
A &A A
AA AA A c | j | }nQ# t $ rD d|vrY d S | j | d d }n# t $ r Y Y d S w xY wY nw xY w || | S )Nr r )r r r )r# r rq r s r
end_dispatchzUnmarshaller.end_dispatch s
c"AA #~~
M#))C.."45
qt}} r c > | d d| _ d S Nr )r r rp s r
end_nilzUnmarshaller.end_nil s D r nilc |dk r| d n+|dk r| d nt d d| _ d S )Nr Fr Tzbad boolean valuer )r r r rp s r
end_booleanzUnmarshaller.end_boolean sX 3;; KK
S[[ KK /00 0 r booleanc X | t | d| _ d S r )r r r rp s r
end_intzUnmarshaller.end_int s% CII r i1i2i4i8r
bigintegerc X | t | d| _ d S r )r r r rp s r
end_doublezUnmarshaller.end_double s% E$KK r doubler c X | t | d| _ d S r )r r r rp s r
end_bigdecimalzUnmarshaller.end_bigdecimal s% GDMM""" r
bigdecimalc | j r| | j }| | d| _ d S r )r rr r r rp s r
end_stringzUnmarshaller.end_string s< > /;;t~..D D r stringnamec z | j }| j |d g| j |d < d| _ d S r )r popr r )r# rq marks r
end_arrayzUnmarshaller.end_array s< { "k$%% 0 1 DEE r r c | j }i }| j |d }t dt | d D ]}||dz ||| < |g| j |d < d| _ d S )Nr r r5 )r r! r ranger r )r# rq r" r r r s r
end_structzUnmarshaller.end_struct s} { DEE"q#e**a(( ( (A "1Q3ZDqNN "V DEE r r c t }| | d | j r|j }| | d| _ d S )Nr r )r~ rr rw r rq r r r# rq rB s r
end_base64zUnmarshaller.end_base64 sW
T[[))*** ? JE E r r c t }| | | j rt | }| | d S r )rQ rr r r| r r( s r
end_dateTimezUnmarshaller.end_dateTime sM
T )"4((E Er zdateTime.iso8601c B | j r| | d S d S r )r r rp s r
end_valuezUnmarshaller.end_value( s0 ; " OOD ! ! ! ! ! " "r rB c d| _ d S )Nparamsr rp s r
end_paramszUnmarshaller.end_params/ s
r r/ c d| _ d S )Nr r0 rp s r
end_faultzUnmarshaller.end_fault3 s
r r c d | j r| | j }|| _ d| _ d S )N
methodName)r rr r r rp s r
end_methodNamezUnmarshaller.end_methodName7 s2 > /;;t~..D !
r r5 NFF)r r r r r r r r r rq r r r r
r
r r r r r# r& r) r+ r- r1 r3 r6 r r r
r r sU
,
,
,
," " " " " " ' ' ' , , , H HUO &HY HTN HTN HTN HTN HUO $H\ $HX"HW ,H\
$HX!HV
"HW $HX $HX $0H
" " "
"HW #HX !HW" " "
,H\r r c e Zd Zd Zd Zd ZdS )_MultiCallMethodc " || _ || _ d S r )_MultiCallMethod__call_list_MultiCallMethod__name)r# call_listr s r
r z_MultiCallMethod.__init__D s $ r c @ t | j | j d| S N.)r9 r; r< r# r s r
__getattr__z _MultiCallMethod.__getattr__G s" 0T[[[$$2OPPPr c H | j | j |f d S r )r; r r< r# argss r
__call__z_MultiCallMethod.__call__I s& d 344444r Nr r r r rB rF r r r
r9 r9 A sD Q Q Q5 5 5 5 5r r9 c e Zd ZdZd Zd ZdS )MultiCallIteratorzaIterates over the results of a multicall. Exceptions are
raised in response to xmlrpc faults.c || _ d S r )results)r# rK s r
r zMultiCallIterator.__init__P s
r c | j | }t | t i k r t |d |d t | t g k r|d S t d )Nr1 r2 r z#unexpected type in multicall result)rK r r/ r: )r# r items r
__getitem__z MultiCallIterator.__getitem__S sm |A ::b ! ![)4
+>?? ?
$ZZ488
#
#7N BCC Cr N)r r r r r rN r r r
rI rI L sA , , D D D D Dr rI c * e Zd ZdZd Zd Zd Zd ZdS ) MultiCalla~ server -> an object used to boxcar method calls
server should be a ServerProxy object.
Methods can be added to the MultiCall using normal
method call syntax e.g.:
multicall = MultiCall(server_proxy)
multicall.add(2,3)
multicall.get_address("Guido")
To execute the multicall, call the MultiCall object e.g.:
add_result, address = multicall()
c " || _ g | _ d S r )_MultiCall__server_MultiCall__call_list)r# servers r
r zMultiCall.__init__m s
r c > d| j j t | fz S )Nz <%s at %#x>)r( r rm r) s r
r* zMultiCall.__repr__q s 7D BBBr c , t | j | S r )r9 rS rA s r
rB zMultiCall.__getattr__t s 0$777r c g }| j D ] \ }}| ||d t | j j | S )N)r5 r/ )rS r rI rR system multicall)r# marshalled_listr rE s r
rF zMultiCall.__call__w s_ * K KJD$ " "4D#I#I J J J J !5!?!?!P!PQQQr N)r r r r r r* rB rF r r r
rP rP \ sb C C C8 8 8R R R R Rr rP Fc N t rdt r]|rt }t j }n | rt }t
}nt }t
}t dd||t }t | }n7t | | }t rt | }nt | }||fS )zgetparser() -> parser, unmarshaller
Create an instance of the fastest available parser, and attach it
to an unmarshalling object. Return both objects.
TFr r )
FastParserFastUnmarshallerr| r r r rz r/ r r )r r
mkdatetimemkbytesr r s r
getparserra s )& ) 'J (GG
'J GG"J G!$w
EJJF## r c t | t t f s
J d t | t rd}n4|r2t | t r t | dk s
J d |sd}t rt | }nt || }| | }|dk rdt | z }nd}|r |d|d|d f}n |r|d
|d f}n|S d | S )
a data [,options] -> marshalled data
Convert an argument tuple or a Fault instance to an XML-RPC
request (or response, if the methodresponse option is used).
In addition to the data object, the following options can be given
as keyword arguments:
methodname: the method name for a methodCall packet
methodresponse: true to create a methodResponse packet.
If this option is used with a tuple, the tuple must be
a singleton (i.e. it can contain only one element).
encoding: the packet encoding (default is UTF-8)
All byte strings in the data structure are assumed to use the
packet encoding. Unicode strings are automatically converted,
where necessary.
z(argument must be tuple or Fault instancer5 z"response tuple must be a singletonr z$
z
zz
z
z
z
r ) rJ rK r/ r FastMarshallerr r rS r )r/
methodnamemethodresponser r mrq xmlheaders r
r r sA . fuen - -YY/YYY -&% F FJvu 5 5 F6{{a !E - 8 $ $ x , , 776??D7;c(mmK -
&(9
!
774==r c t || \ }}| | | | | fS )zdata -> unmarshalled data, method name
Convert an XML-RPC packet to unmarshalled data plus a method
name (None if not present).
If the XML-RPC packet represents a fault condition, this function
raises a Fault exception.
r\ )ra r r r )rq r r pus r
loadsrk sT ,BS T T TDAqFF4LLLGGIII 7799aoo'' ''r c t st t }t j d|d 5 }| | ddd n # 1 swxY w Y | S )zhdata -> gzip encoded data
Encode data using the gzip content encoding as described in RFC 1952
wbr5 )modefileobj
compresslevelN)gzipNotImplementedErrorr GzipFileru getvalue)rq r gzfs r
gzip_encoderv s
"!! A
D!1 = = = $ ::<<s AA A @c t st t j dt | 5 } |dk r| }n| |dz }n # t
$ r t
d w xY wddd n # 1 swxY w Y |dk r"t | |k rt
d |S )zrgzip encoded data -> unencoded data
Decode data using the gzip content encoding as described in RFC 1952
rbrn ro r r5 z invalid dataNz#max gzipped payload length exceeded)rq rr rs r readOSErrorr: r )rq
max_decoderu decodeds r
gzip_decoder ) s
"!!
D'$-- 8 8 8 -C -A~~ ((** ((:>22 - - - ^,, , -
- - - - - - - - - - - - - - - Q3w<<*44>??? Ns( B3A('B(BBBBc e Zd ZdZd Zd ZdS )GzipDecodedResponsezha file-like object to decode a response encoded with the gzip
method, as described in RFC 1952.
c t st t | | _ t j | d| j d S )Nry rz )rq rr r r{ iors r )r# responses r
r z GzipDecodedResponse.__init__G sN &% %(--//**
t$ @@@@@r c t j | | j d S # | j w xY wr )rq rs r r r) s r
r zGzipDecodedResponse.closeO sD M % % % GMMOOOOODGMMOOOOs < AN)r r r r r r r r r
r r C s? A A A r r c e Zd Zd Zd Zd ZdS )_Methodc " || _ || _ d S r
_Method__send
_Method__name)r# sendr s r
r z_Method.__init__\ s r c @ t | j | j d| S r? )r r r rA s r
rB z_Method.__getattr___ s! t{t{{{DD$ABBBr c 8 | | j | S r r rD s r
rF z_Method.__call__a s {{4;---r NrG r r r
r r Y sD C C C. . . . .r r c r e Zd ZdZdez ZdZdZddddZdd Z dd
Z
d Z d Z d
Z
d Zd Zd Zd Zd ZdS ) Transportz1Handles an HTTP transaction to an XML-RPC server.zPython-xmlrpc/%sTNFr )r" c f || _ || _ d| _ t | | _ g | _ d S N)NN)r _use_builtin_types _connectionr _headers_extra_headers)r# r r r" s r
r zTransport.__init__x s5 )"3 ' W
r c dD ]x} | |||| c S # t j j $ r |r Y 6t $ r7}|s*|j t
j t
j t
j fvr Y d }~qd }~ww xY wd S )N)r r5 ) single_requesthttpclientRemoteDisconnectedr| errno
ECONNRESET ECONNABORTEDEPIPE)r# hosthandler request_bodyverboser es r
requestzTransport.request s A
**4,PPPPP;1
(8%:L(- (5 5 55 5 5 5 5
s A9 A9-A44A9c | |||| }| }|j dk r || _ | | S n-# t
$ r t $ r | w xY w| dd r| t ||z |j |j t |
)N zcontent-lengthr ) send_request getresponsestatusr parse_responser/ Exceptionr getheaderr{ r reasonr
getheaders)r# r r r r http_connresps r
r zTransport.single_request s
))$ wOOI ((**D{c!! & **4000 "
JJLLL >>*B / / IIKKK 7N K "" # # s AA *B c 8 t | j | j S )Nr\ )ra r r r) s r
ra zTransport.getparser s( d&8+/+BD D D Dr c | i }t |t r|\ }}t j | \ }}|rvt j | }t
j | d }d |
}dd|z fg}ng }|||fS )Nr r
AuthorizationzBasic ) rJ rK urllibparse
_splituserunquote_to_bytesr r rr r r )r# r x509auth
extra_headerss r
get_host_infozTransport.get_host_info s dE " " JD$\,,T22
d <0066D%d++227;;D774::<<((D (T/2 MM M]D((r c | j r || j d k r
| j d S | | \ }| _ }|t j | f| _ | j d S )Nr r5 )r r r r r HTTPConnectionr# r chostr s r
make_connectionzTransport.make_connection sw '(8(; ; ;#A& &+/+=+=d+C+C(t"D !;!;E!B!BB ""r c X | j \ }}|r d| _ | d S d S r )r r )r# r
connections r
r zTransport.close sA +j +D r c | | }| j | j z }|r| d | j r5t
r.| d|d | d n| d| | d | d| j f | || |
|| |S )Nr5 POSTT)skip_accept_encoding)zAccept-Encodingrq )z Content-Typeztext/xmlz
User-Agent) r r r set_debuglevelaccept_gzip_encodingrq
putrequestr
user_agent send_headers send_content)r# r r r debugr r" s r
r zTransport.send_request s ))$//
-$"55 ) % %a ( ( ( $ 3 3 ! !&' ! M M M NN6 7 7 7 7 ! !&' 2 2 23444 do6777 *g... *l333r c B |D ]\ }}| || d S r ) putheader)r# r r" keyvals r
r zTransport.send_headers s8 + +HC c * * * * + +r c & | j D| j t | k r,t r%| dd t | }| dt t | | | d S )NContent-Encodingrq zContent-Length)encode_thresholdr rq r rv rS
endheaders)r# r r s r
r zTransport.send_content s ! - !C $5$5 5 5
6 !3V < < <&|44L -s3|3D3D/E/EFFF l+++++r c t |d r-| dd dk rt | }n|}n|}| \ }} | d }|sn:| j r t
dt | | | R||ur| | | S )Nr r r rq r5 i zbody:)
rV r r ra r{ r printr r r )r# r streamri rj rq s r
r zTransport.parse_response1 s 8[ ) ) !!"4b99VCC,X66! F~~ 1 ;;t$$D
|
+gtDzz***
FF4LLL
! ! LLNNN wwyyr r7 )F)r r r r __version__r r r r r r ra r r r r r r r r r r
r r j s ;; $k1J
! ! ! ! ! !$ BD D D ) ) )4# # # .+ + + , , ," r r c 2 e Zd ZdZdddd fd Zd Z xZS )
SafeTransportz2Handles an HTTPS transaction to an XML-RPC server.Fr Nr" contextc ^ t ||| || _ d S )Nr r r" )superr r )r# r r r" r r( s r
r zSafeTransport.__init__R s9
l+ a logical connection to an XML-RPC server
uri is the connection point on the server, given as
scheme://host/target.
The standard implementation always supports the "http" scheme. If
SSL socket support is available (Python 2.0), it also supports
"https".
If the target part and the slash preceding it are both omitted,
"/RPC2" is assumed.
The following options can be given as keyword arguments:
transport: a transport factory
encoding: the request encoding (default is UTF-8)
All 8-bit strings passed to the server proxy are assumed to use
the given encoding.
NFr r c t j | }
|
j dvrt d |
j | _ t j ddg|
dd | _ | j sd| _ |,|
j dk r t } d| i} n t } i } | d
|||d| }|| _ |pd | _ || _
|| _ d S ) N)r httpsz unsupported XML-RPC protocolr r z/RPC2r r r r r )r r urlsplitschemer| netloc_ServerProxy__host
urlunsplit_ServerProxy__handlerr r _ServerProxy__transport_ServerProxy__encoding_ServerProxy__verbose_ServerProxy__allow_none)
r# uri transportr r r r r r" r ri r extra_kwargss
r
r zServerProxy.__init__ s
L ! !# & & 8, , ,899 9h 00"b1A1QRR51ABB~ % $DN x7""' )7 3 # ! 0\2C(/0 0 #/0 0I %"-g &r c 8 | j d S r )r r r) s r
__closezServerProxy.__close s r c t ||| j | j | j d }| j | j | j || j }t | dk r|d }|S )N)r r xmlcharrefreplace)r r5 r )
r r r rw r r r r r r )r# rd r/ r r s r
__requestzServerProxy.__request s
T_#'#46 6 66>>
C r c , t | j | S r )r _ServerProxy__requestrA s r
rB zServerProxy.__getattr__ s t~t,,,r c \ |dk r| j S |dk r| j S t d|d )z|A workaround to get special attributes on the ServerProxy
without interfering with the magic __getattr__
r r z
Attribute z
not found)_ServerProxy__closer r )r# attrs r
rF zServerProxy.__call__ s@ 7??<
[
# # n ?@@@r c | S r r r) s r
__enter__zServerProxy.__enter__ s r c . | d S r )r rD s r
__exit__zServerProxy.__exit__ s r )NNFFFF) r r r r r r r r* rB rF r r r r r
r r z s * DIIN ' ' ' ' ' '>! ! ! $ - - -A A A r r __main__zhttp://localhost:8000ERROR r7 )NNNF)rw )Vr r sysrL r decimalr http.clientr urllib.parser xml.parsersr r r r rq ImportErrorr version_infor r r PARSE_ERROR SERVER_ERRORAPPLICATION_ERROR SYSTEM_ERRORTRANSPORT_ERRORNOT_WELLFORMED_ERRORUNSUPPORTED_ENCODINGINVALID_ENCODING_CHARINVALID_XMLRPCMETHOD_NOT_FOUNDINVALID_METHOD_PARAMSINTERNAL_ERRORr r r r- r/ r r Booleanr8 r< rC rO rQ rz r| r~ r r r r r r9 rI rP rc r] r^ ra r rk rv r rs r r r r r r Serverr rT r currentTimegetCurrentTimer multigetDatapowaddr r r r
r" s r( (T
KKKK DDD # # # (!,, I E & E B B B B BE B B B '" Aq
4:: ;1 1 1 1 T%[[ ;2 2 2 2; ; ; 5 5 5P3 P3 P3 P3 P3 P3 P3 P3d 6 6 6!) !) !) !) !) !) !) !)F
f
$ $ $ $ $ $ $ $B`4 `4 `4 `4 `4 `4 `4 `4N}, }, }, }, }, }, }, },D 5 5 5 5 5 5 5 5D D D D D D D D R R R R R R R RJ 26 5 5 . N BF@ @ @ @V ( ( ( (,
0 4 4;$--V , . . . . . . . ."` ` ` ` ` ` ` `J# # # # #I # # #Ve e e e e e e eR
z
[0
1
1F
f //112222
gq
If E MMOOO IIaNNN IIaNNN H E(OOOO
gq' s? 9 AA"G< <H HH&J J JJ __pycache__/client.cpython-311.opt-1.pyc 0000644 00000156535 15102763701 0013714 0 ustar 00
!A?h B d Z ddlZddlZddlZddlmZ ddlmZ ddlZddl Z
ddl m Z ddl
Z
ddlmZ ddlZn
# e$ r dZY nw xY wd Zdej dd z Zd
Zd Zd Zd
ZdZdZdZd Z dZ dZ d
Z dZ dZ!dZ" G d de# Z$ G d de$ Z% G d de$ Z& G d d e$ Z'e(xZ)Z* ed d d Z+d Z, e,d rd! Z-n e,d" rd# Z-nd$ Z-[+[,d% Z. G d& d' Z/d( Z0d) Z1 G d* d+ Z2d, Z3e/e2fZ4 G d- d. Z5 G d/ d0 Z6 G d1 d2 Z7 G d3 d4 Z8 G d5 d6 Z9 G d7 d8 Z:dxZ;xZ dOd;Z?dNd<Z@d= ZAdPd?ZB G d@ dAerejC neD ZE G dB dC ZF G dD dE ZG G dF dGeG ZH G dH dI ZIeIZJeKdJk r eIdK ZL eMeLjN O n # e$$ rZP eMdLeP Y dZP[PndZP[Pww xY w e:eL ZQeQR eQS d dM eQT d d eQ D ]
ZU eMeU dS # e$$ rZP eMdLeP Y dZP[PdS dZP[Pww xY wdS )Qa
An XML-RPC client interface for Python.
The marshalling and response parser code can also be used to
implement XML-RPC servers.
Exported exceptions:
Error Base class for client errors
ProtocolError Indicates an HTTP protocol error
ResponseError Indicates a broken response package
Fault Indicates an XML-RPC fault package
Exported classes:
ServerProxy Represents a logical connection to an XML-RPC server
MultiCall Executor of boxcared xmlrpc requests
DateTime dateTime wrapper for an ISO 8601 string or time tuple or
localtime integer value to generate a "dateTime.iso8601"
XML-RPC value
Binary binary data wrapper
Marshaller Generate an XML-RPC params chunk from a Python data structure
Unmarshaller Unmarshal an XML-RPC response from incoming XML event message
Transport Handles an HTTP transaction to an XML-RPC server
SafeTransport Handles an HTTPS transaction to an XML-RPC server
Exported constants:
(none)
Exported functions:
getparser Create instance of the fastest available parser & attach
to an unmarshalling object
dumps Convert an argument tuple or a Fault instance to an XML-RPC
request (or response, if the methodresponse option is used).
loads Convert an XML-RPC packet to unmarshalled data plus a method
name (None if not present).
N)datetime)Decimal)expat)BytesIOc | dd } | dd } | dd S )N&z&z>)replace)ss &/usr/lib64/python3.11/xmlrpc/client.pyescaper s< #w A #v A 99S& " "" z%d.%d ii iDii ipiԁiCiBiiic e Zd ZdZej ZdS )Errorz Base class for client errors.N)__name__
__module__ __qualname____doc__object__str__ r r
r r s ''nGGGr r c e Zd ZdZd Zd ZdS )
ProtocolErrorz!Indicates an HTTP protocol error.c r t | || _ || _ || _ || _ d S N)r __init__urlerrcodeerrmsgheaders)selfr r r! r" s r
r zProtocolError.__init__ s4
t r c R d| j j d| j d| j d| j d S )Nr for : r
) __class__r r r r! r# s r
__repr__zProtocolError.__repr__ s7 ^
$
$
$dhhh dkkk
K r Nr r r r r r* r r r
r r s8 ++ r r c e Zd ZdZdS )
ResponseErrorz$Indicates a broken response package.N)r r r r r r r
r- r- s ..Dr r- c e Zd ZdZd Zd ZdS )Faultz#Indicates an XML-RPC fault package.c V t | || _ || _ d S r )r r faultCode faultString)r# r1 r2 extras r
r zFault.__init__ s)
t "&r c B d| j j d| j d| j dS )Nr r' r& r
)r( r r1 r2 r) s r
r* zFault.__repr__ s2 $ 7 7 7 $0@0@0@B Br Nr+ r r r
r/ r/ s= --' ' 'B B B B Br r/ c b t | dk S # t $ r Y dS w xY w)N0001F)_day0strftime
ValueError)fmts r
_tryr< s@ ~~c""f,, uus
..z%Yc , | d S N%Y%m%dT%H:%M:%Sr9 values r
_iso8601_formatrC s ~~ /000r z%4Yc , | d S )Nz%4Y%m%dT%H:%M:%Sr@ rA s r
rC rC s ~~ 0111r c R | d d S )Nr? )r9 zfillrA s r
rC rC s# ~~ /0066r:::r c t | t rt | S t | t t j f s-| dk rt j } t j | } d| d d z S )Nr z%04d%02d%02dT%02d:%02d:%02d )
isinstancer rC tupletime struct_time localtimerA s r
_strftimerO sr %"" & u%%% eeT%5 6 7 7 & A::IKKEu%% (5!9 44r c \ e Zd ZdZddZd Zd Zd Zd Zd Z d Z
d
Z d Z d Z
d
Zd ZdS )DateTimezDateTime wrapper for an ISO 8601 string or time tuple or
localtime integer value to generate 'dateTime.iso8601' XML-RPC
value.
r c j t |t r || _ d S t | | _ d S r )rJ strrB rO )r# rB s r
r zDateTime.__init__. s2 eS ! ! * DJJJ"5))DJJJr c l t |t r| j }|j }nt |t r| j }t | }nat |t
r
| j }|}nBt
|d r)| }| }n | }t }||fS )N timetuple) rJ rQ rB r rC rS hasattrrU NotImplementedr# otherr os r
make_comparablezDateTime.make_comparable4 s eX & &
A AA
x
(
(
A &&AA
s
#
#
AAA
UK
(
( A!!AAA A!t r c ^ | | \ }}|t u rt S ||k S r r[ rW rX s r
__lt__zDateTime.__lt__F 3 ##E**1 ! !1u r c ^ | | \ }}|t u rt S ||k S r r] rX s r
__le__zDateTime.__le__L 3 ##E**1 ! !Av
r c ^ | | \ }}|t u rt S ||k S r r] rX s r
__gt__zDateTime.__gt__R r_ r c ^ | | \ }}|t u rt S ||k S r r] rX s r
__ge__zDateTime.__ge__X rb r c ^ | | \ }}|t u rt S ||k S r r] rX s r
__eq__zDateTime.__eq__^ rb r c 6 t j | j d S r> )rL strptimerB r) s r
rU zDateTime.timetupled s }TZ):;;;r c | j S r rA r) s r
r zDateTime.__str__l s
zr c J d| j j | j t | fz S )Nz<%s %r at %#x>)r( r rB idr) s r
r* zDateTime.__repr__o s! 4>#:DJ4"QQQr c R t | | _ d S r )rS striprB r# datas r
decodezDateTime.decoder s YY__&&
r c | d | | j | d d S Nzz
)writerB )r# outs r
encodezDateTime.encodeu sB -... $* 122222r N)r )r r r r r r[ r^ ra rd rf rh rU r r* rr rw r r r
rQ rQ ( s
* * * * $ < < < R R R' ' '3 3 3 3 3r rQ c L t }| | |S r )rQ rr rq rB s r
_datetimerz z s" JJE LL Lr c , t j | d S r> )r rj )rq s r
_datetime_typer| s T#4 5 55r c 2 e Zd ZdZddZd Zd Zd Zd ZdS ) BinaryzWrapper for binary data.Nc |d}nGt |t t f s t d|j j z t | }|| _ d S )Nr z#expected bytes or bytearray, not %s)rJ bytes bytearray TypeErrorr( r rq rp s r
r zBinary.__init__ s] <DD dUI$677
9 E $ 7!8 9 9 9;;D r c , t | j d S )Nzlatin-1)rS rq r) s r
r zBinary.__str__ s 49i(((r c P t |t r|j }| j |k S r )rJ r~ rq )r# rY s r
rh z
Binary.__eq__ s( eV $ $ JEyE!!r c 8 t j | | _ d S r )base64 decodebytesrq rp s r
rr z
Binary.decode s &t,, r c | d t j | j }| | d | d d S Nz
asciiz
)ru r encodebytesrq rr )r# rv encodeds r
rw z
Binary.encode s^ %&&&$TY// '..))*** '(((((r r ) r r r r r r rh rr rw r r r
r~ r~ sj "" ) ) )" " "
- - -) ) ) ) )r r~ c L t }| | |S r )r~ rr ry s r
_binaryr s" HHE LL Lr c e Zd Zd Zd Zd ZdS ) ExpatParserc t j d d x| _ }|| _ |j |_ |j |_ |j |_ d }|
|d d S r ) r ParserCreate_parser_targetstartStartElementHandlerendEndElementHandlerrq CharacterDataHandlerxml)r# targetparserencodings r
r zExpatParser.__init__ s_ % 24 > >> v %+\"#): &,k#
8T"""""r c < | j |d d S NF)r Parserp s r
feedzExpatParser.feed s 4'''''r c l | j }| `| ` | dd d S # t $ r Y d S w xY w)Nr T)r r r AttributeError)r# r s r
closezExpatParser.close sW $\F dl LLd # # # # # DD s %
33N)r r r r r r r r r
r r sA # # #( ( ($ $ $ $ $r r c e Zd ZdZddZi Zd Zd Zd Zee e d < d Z
e
ee < d Z e ee
< e Zd
Zeee< efd Zeee< d Zeee< eee< d
Zeee< eee< efdZeee< d Z e ee < d Z e ee < e ee < e ed< dS )
Marshallerav Generate an XML-RPC params chunk from a Python data structure.
Create a Marshaller instance for each set of parameters, and use
the "dumps" method to convert your data (represented as a tuple)
to an XML-RPC params chunk. To write a fault response, pass a
Fault instance instead. You may prefer to use the "dumps" module
function for this purpose.
NFc > i | _ d | _ || _ || _ d S r )memorq r
allow_none)r# r r s r
r zMarshaller.__init__ s"
$r c T g }|j }| j }t |t r0 |d ||j |j d| |d n= |d |D ]$} |d ||| |d % |d d | }|S ) Nz
)r1 r2 z
z
z
z
z
)append_Marshaller__dumprJ r/ r1 r2 join)r# valuesrv ru dumpvresults r
dumpszMarshaller.dumps s
{ fe $ $ ! E+ Dv /!'!35 5
E,
E,
$
$k"""Ql#### E-
r c | j t | }n# t $ r t |d s t dt | z t | j D ]<}|| j v r t dt | z =| j d }Y nw xY w || || d S )N__dict__zcannot marshal %s objects_arbitrary_instance)dispatchtypeKeyErrorrV r __mro__keys)r# rB ru ftype_s r
__dumpzMarshaller.__dump s 5
d5kk*AA 5 5 55*--
K ;d5kk IJJJ e,
O
ODM . . 0 000#$?$u++$MNNN 1
34AAA 5
$u s BB76B7c H | j st d |d d S )Nz0cannot marshal None unless allow_none is enabledz)r r r# rB ru s r
dump_nilzMarshaller.dump_nil s3 P NOO O
%&&&&&r c P |d ||rdpd |d d S )Nz10z
r r s r
dump_boolzMarshaller.dump_bool sC
!!!
em"s###
$%%%%%r c |t k s |t k rt d |d |t t | |d d S )Nzint exceeds XML-RPC limitsz z
)MAXINTMININT
OverflowErrorrS intr s r
dump_longzMarshaller.dump_long& se 6>>UV^^ <== =
n
c#e**oo
!!!!!r c b |d |t | |d d S )Nzz
)reprr s r
dump_doublezMarshaller.dump_double1 s@
d5kk
#$$$$$r c Z |d | || |d d S )Nzz
r )r# rB ru r s r
dump_unicodezMarshaller.dump_unicode7 sB
ffUmm
#$$$$$r c |d t j | } || d |d d S r )r r rr )r# rB ru r s r
dump_byteszMarshaller.dump_bytes= sV
!"""$U++
gnnW%%&&&
#$$$$$r c t | }|| j v rt d d | j |< | j } |d |D ]} ||| |d | j |= d S )Nz"cannot marshal recursive sequencesz
z
)rm r r r )r# rB ru ir r s r
dump_arrayzMarshaller.dump_arrayE s uII >> @AA A ! {
&''' A DENNNN
)*** IaLLLr c t | }|| j v rt d d | j |< | j } |d | D ]b\ }} |d t |t st d |d || z ||| |d c |d | j |= d S )Nz%cannot marshal recursive dictionariesz
z
z dictionary key must be stringz%s
z
z
)rm r r r itemsrJ rS )r# rB ru r r r kr s r
dump_structzMarshaller.dump_structS s uII >> CDD D ! {
!"""KKMM ! !DAq E, a%%
A ?@@@ E%q 1 2 2 2 DENNN E-
#$$$ IaLLLr c b |d |t | |d d S rt )rO r s r
dump_datetimezMarshaller.dump_datetimee sB
)***
i
-.....r c |j t v r || _ | | | `d S | |j | d S r )r( WRAPPERSru rw r r r s r
dump_instancezMarshaller.dump_instancek sQ ?h & & DJ LL
U^U 3 3 3 3 3r r r )!r r r r r r r r r r r boolr r dump_intr floatr r rS r r r r rK listr dictr r r rQ r~ r r r
r r s % % % % H 6 $' ' ' $HTT$ZZ& & & HTN" " " HSM H% % % "HUO06 % % % % !HSM% % %
!HUO$HY
!HUO HTN/5 !HTN/ / / 'HX4 4 4 'HX$HV '4H
"###r r c n e Zd ZdZd/dZd Zd Zd Zd Zd Z d Z
d
Z i Z d Z
e
e d < d
Zee d< d Zee d< ee d< ee d< ee d< ee d< ee d< d Zee d< ee d< d Zee d< d Zee d < ee d < d Zee d < d Zee d!< d" Zee d#< d$ Zee d%< d& Zee d'< d( Zee d)< d* Zee d+< d, Zee d-< d.S )0 Unmarshallera Unmarshal an XML-RPC response, based on incoming XML event
messages (start, data, end). Call close() to get the resulting
data structure.
Note that this reader is fairly tolerant, and gladly accepts bogus
XML-RPC data without complaining (but not bogus XML).
Fc d | _ g | _ g | _ g | _ d| _ d | _ d| _ | j j | _ |p|| _ || _ d S )NFutf-8)
_type_stack_marks_data_value _methodname _encodingr
_use_datetime
_use_bytes)r# use_datetimeuse_builtin_typess r
r zUnmarshaller.__init__ sX
k( . >,+r c | j | j rt | j dk rt di | j d t | j S )Nfaultr r )r r r- r/ r rK r) s r
r zUnmarshaller.close sR : // ! : ))$+a.)) )T[!!!r c | j S r )r r) s r
getmethodnamezUnmarshaller.getmethodname s r c || _ d S r )r )r# r
standalones r
r zUnmarshaller.xml s
!r c d|v r| d d }|dk s|dk r,| j t | j g | _ | j r|| j vrt d|z |dk | _ d S )N:arraystructzunknown tag %rrB ) splitr r lenr r r r r- )r# tagattrss r
r zUnmarshaller.start s #::))C..$C '>>SH__ K s4; / / 0 0 0
; 83dm33 03 677 7g~ r c : | j | d S r )r r )r# texts r
rq zUnmarshaller.data s
$ r c
| j | }nQ# t $ rD d|vrY d S | j | d d }n# t $ r Y Y d S w xY wY nw xY w || d | j S )Nr r r )r r r r r )r# r r s r
r zUnmarshaller.end s
c"AA #~~
M#))C.."45
qrwwtz**+++2
A &A A
AA AA A c | j | }nQ# t $ rD d|vrY d S | j | d d }n# t $ r Y Y d S w xY wY nw xY w || | S )Nr r )r r r )r# r rq r s r
end_dispatchzUnmarshaller.end_dispatch s
c"AA #~~
M#))C.."45
qt}} r c > | d d| _ d S Nr )r r rp s r
end_nilzUnmarshaller.end_nil s D r nilc |dk r| d n+|dk r| d nt d d| _ d S )Nr Fr Tzbad boolean valuer )r r r rp s r
end_booleanzUnmarshaller.end_boolean sX 3;; KK
S[[ KK /00 0 r booleanc X | t | d| _ d S r )r r r rp s r
end_intzUnmarshaller.end_int s% CII r i1i2i4i8r
bigintegerc X | t | d| _ d S r )r r r rp s r
end_doublezUnmarshaller.end_double s% E$KK r doubler c X | t | d| _ d S r )r r r rp s r
end_bigdecimalzUnmarshaller.end_bigdecimal s% GDMM""" r
bigdecimalc | j r| | j }| | d| _ d S r )r rr r r rp s r
end_stringzUnmarshaller.end_string s< > /;;t~..D D r stringnamec z | j }| j |d g| j |d < d| _ d S r )r popr r )r# rq marks r
end_arrayzUnmarshaller.end_array s< { "k$%% 0 1 DEE r r c | j }i }| j |d }t dt | d D ]}||dz ||| < |g| j |d < d| _ d S )Nr r r5 )r r! r ranger r )r# rq r" r r r s r
end_structzUnmarshaller.end_struct s} { DEE"q#e**a(( ( (A "1Q3ZDqNN "V DEE r r c t }| | d | j r|j }| | d| _ d S )Nr r )r~ rr rw r rq r r r# rq rB s r
end_base64zUnmarshaller.end_base64 sW
T[[))*** ? JE E r r c t }| | | j rt | }| | d S r )rQ rr r r| r r( s r
end_dateTimezUnmarshaller.end_dateTime sM
T )"4((E Er zdateTime.iso8601c B | j r| | d S d S r )r r rp s r
end_valuezUnmarshaller.end_value( s0 ; " OOD ! ! ! ! ! " "r rB c d| _ d S )Nparamsr rp s r
end_paramszUnmarshaller.end_params/ s
r r/ c d| _ d S )Nr r0 rp s r
end_faultzUnmarshaller.end_fault3 s
r r c d | j r| | j }|| _ d| _ d S )N
methodName)r rr r r rp s r
end_methodNamezUnmarshaller.end_methodName7 s2 > /;;t~..D !
r r5 NFF)r r r r r r r r r rq r r r r
r
r r r r r# r& r) r+ r- r1 r3 r6 r r r
r r sU
,
,
,
," " " " " " ' ' ' , , , H HUO &HY HTN HTN HTN HTN HUO $H\ $HX"HW ,H\
$HX!HV
"HW $HX $HX $0H
" " "
"HW #HX !HW" " "
,H\r r c e Zd Zd Zd Zd ZdS )_MultiCallMethodc " || _ || _ d S r )_MultiCallMethod__call_list_MultiCallMethod__name)r# call_listr s r
r z_MultiCallMethod.__init__D s $ r c @ t | j | j d| S N.)r9 r; r< r# r s r
__getattr__z _MultiCallMethod.__getattr__G s" 0T[[[$$2OPPPr c H | j | j |f d S r )r; r r< r# argss r
__call__z_MultiCallMethod.__call__I s& d 344444r Nr r r r rB rF r r r
r9 r9 A sD Q Q Q5 5 5 5 5r r9 c e Zd ZdZd Zd ZdS )MultiCallIteratorzaIterates over the results of a multicall. Exceptions are
raised in response to xmlrpc faults.c || _ d S r )results)r# rK s r
r zMultiCallIterator.__init__P s
r c | j | }t | t i k r t |d |d t | t g k r|d S t d )Nr1 r2 r z#unexpected type in multicall result)rK r r/ r: )r# r items r
__getitem__z MultiCallIterator.__getitem__S sm |A ::b ! ![)4
+>?? ?
$ZZ488
#
#7N BCC Cr N)r r r r r rN r r r
rI rI L sA , , D D D D Dr rI c * e Zd ZdZd Zd Zd Zd ZdS ) MultiCalla~ server -> an object used to boxcar method calls
server should be a ServerProxy object.
Methods can be added to the MultiCall using normal
method call syntax e.g.:
multicall = MultiCall(server_proxy)
multicall.add(2,3)
multicall.get_address("Guido")
To execute the multicall, call the MultiCall object e.g.:
add_result, address = multicall()
c " || _ g | _ d S r )_MultiCall__server_MultiCall__call_list)r# servers r
r zMultiCall.__init__m s
r c > d| j j t | fz S )Nz <%s at %#x>)r( r rm r) s r
r* zMultiCall.__repr__q s 7D BBBr c , t | j | S r )r9 rS rA s r
rB zMultiCall.__getattr__t s 0$777r c g }| j D ] \ }}| ||d t | j j | S )N)r5 r/ )rS r rI rR system multicall)r# marshalled_listr rE s r
rF zMultiCall.__call__w s_ * K KJD$ " "4D#I#I J J J J !5!?!?!P!PQQQr N)r r r r r r* rB rF r r r
rP rP \ sb C C C8 8 8R R R R Rr rP Fc N t rdt r]|rt }t j }n | rt }t
}nt }t
}t dd||t }t | }n7t | | }t rt | }nt | }||fS )zgetparser() -> parser, unmarshaller
Create an instance of the fastest available parser, and attach it
to an unmarshalling object. Return both objects.
TFr r )
FastParserFastUnmarshallerr| r r r rz r/ r r )r r
mkdatetimemkbytesr r s r
getparserra s )& ) 'J (GG
'J GG"J G!$w
EJJF## r c l t | t rd}n|rt | t r |sd}t rt | }nt || }| | }|dk rdt
| z }nd}|r |d|d|df}n |r|d|d f}n|S d
| S ) a data [,options] -> marshalled data
Convert an argument tuple or a Fault instance to an XML-RPC
request (or response, if the methodresponse option is used).
In addition to the data object, the following options can be given
as keyword arguments:
methodname: the method name for a methodCall packet
methodresponse: true to create a methodResponse packet.
If this option is used with a tuple, the tuple must be
a singleton (i.e. it can contain only one element).
encoding: the packet encoding (default is UTF-8)
All byte strings in the data structure are assumed to use the
packet encoding. Unicode strings are automatically converted,
where necessary.
r5 r z$
z
zz
z
z
z
r )rJ r/ rK FastMarshallerr r rS r )r/
methodnamemethodresponser r mrq xmlheaders r
r r s 0 &% F FJvu 5 5 F - 8 $ $ x , , 776??D7;c(mmK -
&(9
!
774==r c t || \ }}| | | | | fS )zdata -> unmarshalled data, method name
Convert an XML-RPC packet to unmarshalled data plus a method
name (None if not present).
If the XML-RPC packet represents a fault condition, this function
raises a Fault exception.
r\ )ra r r r )rq r r pus r
loadsrk sT ,BS T T TDAqFF4LLLGGIII 7799aoo'' ''r c t st t }t j d|d 5 }| | ddd n # 1 swxY w Y | S )zhdata -> gzip encoded data
Encode data using the gzip content encoding as described in RFC 1952
wbr5 )modefileobj
compresslevelN)gzipNotImplementedErrorr GzipFileru getvalue)rq r gzfs r
gzip_encoderv s
"!! A
D!1 = = = $ ::<<s AA A @c t st t j dt | 5 } |dk r| }n| |dz }n # t
$ r t
d w xY wddd n # 1 swxY w Y |dk r"t | |k rt
d |S )zrgzip encoded data -> unencoded data
Decode data using the gzip content encoding as described in RFC 1952
rbrn ro r r5 z invalid dataNz#max gzipped payload length exceeded)rq rr rs r readOSErrorr: r )rq
max_decoderu decodeds r
gzip_decoder ) s
"!!
D'$-- 8 8 8 -C -A~~ ((** ((:>22 - - - ^,, , -
- - - - - - - - - - - - - - - Q3w<<*44>??? Ns( B3A('B(BBBBc e Zd ZdZd Zd ZdS )GzipDecodedResponsezha file-like object to decode a response encoded with the gzip
method, as described in RFC 1952.
c t st t | | _ t j | d| j d S )Nry rz )rq rr r r{ iors r )r# responses r
r z GzipDecodedResponse.__init__G sN &% %(--//**
t$ @@@@@r c t j | | j d S # | j w xY wr )rq rs r r r) s r
r zGzipDecodedResponse.closeO sD M % % % GMMOOOOODGMMOOOOs < AN)r r r r r r r r r
r r C s? A A A r r c e Zd Zd Zd Zd ZdS )_Methodc " || _ || _ d S r
_Method__send
_Method__name)r# sendr s r
r z_Method.__init__\ s r c @ t | j | j d| S r? )r r r rA s r
rB z_Method.__getattr___ s! t{t{{{DD$ABBBr c 8 | | j | S r r rD s r
rF z_Method.__call__a s {{4;---r NrG r r r
r r Y sD C C C. . . . .r r c r e Zd ZdZdez ZdZdZddddZdd Z dd
Z
d Z d Z d
Z
d Zd Zd Zd Zd ZdS ) Transportz1Handles an HTTP transaction to an XML-RPC server.zPython-xmlrpc/%sTNFr )r" c f || _ || _ d| _ t | | _ g | _ d S N)NN)r _use_builtin_types _connectionr _headers_extra_headers)r# r r r" s r
r zTransport.__init__x s5 )"3 ' W
r c dD ]x} | |||| c S # t j j $ r |r Y 6t $ r7}|s*|j t
j t
j t
j fvr Y d }~qd }~ww xY wd S )N)r r5 ) single_requesthttpclientRemoteDisconnectedr| errno
ECONNRESET ECONNABORTEDEPIPE)r# hosthandler request_bodyverboser es r
requestzTransport.request s A
**4,PPPPP;1
(8%:L(- (5 5 55 5 5 5 5
s A9 A9-A44A9c | |||| }| }|j dk r || _ | | S n-# t
$ r t $ r | w xY w| dd r| t ||z |j |j t |
)N zcontent-lengthr ) send_request getresponsestatusr parse_responser/ Exceptionr getheaderr{ r reasonr
getheaders)r# r r r r http_connresps r
r zTransport.single_request s
))$ wOOI ((**D{c!! & **4000 "
JJLLL >>*B / / IIKKK 7N K "" # # s AA *B c 8 t | j | j S )Nr\ )ra r r r) s r
ra zTransport.getparser s( d&8+/+BD D D Dr c | i }t |t r|\ }}t j | \ }}|rvt j | }t
j | d }d |
}dd|z fg}ng }|||fS )Nr r
AuthorizationzBasic ) rJ rK urllibparse
_splituserunquote_to_bytesr r rr r r )r# r x509auth
extra_headerss r
get_host_infozTransport.get_host_info s dE " " JD$\,,T22
d <0066D%d++227;;D774::<<((D (T/2 MM M]D((r c | j r || j d k r
| j d S | | \ }| _ }|t j | f| _ | j d S )Nr r5 )r r r r r HTTPConnectionr# r chostr s r
make_connectionzTransport.make_connection sw '(8(; ; ;#A& &+/+=+=d+C+C(t"D !;!;E!B!BB ""r c X | j \ }}|r d| _ | d S d S r )r r )r# r
connections r
r zTransport.close sA +j +D r c | | }| j | j z }|r| d | j r5t
r.| d|d | d n| d| | d | d| j f | || |
|| |S )Nr5 POSTT)skip_accept_encoding)zAccept-Encodingrq )z Content-Typeztext/xmlz
User-Agent) r r r set_debuglevelaccept_gzip_encodingrq
putrequestr
user_agent send_headers send_content)r# r r r debugr r" s r
r zTransport.send_request s ))$//
-$"55 ) % %a ( ( ( $ 3 3 ! !&' ! M M M NN6 7 7 7 7 ! !&' 2 2 23444 do6777 *g... *l333r c B |D ]\ }}| || d S r ) putheader)r# r r" keyvals r
r zTransport.send_headers s8 + +HC c * * * * + +r c & | j D| j t | k r,t r%| dd t | }| dt t | | | d S )NContent-Encodingrq zContent-Length)encode_thresholdr rq r rv rS
endheaders)r# r r s r
r zTransport.send_content s ! - !C $5$5 5 5
6 !3V < < <&|44L -s3|3D3D/E/EFFF l+++++r c t |d r-| dd dk rt | }n|}n|}| \ }} | d }|sn:| j r t
dt | | | R||ur| | | S )Nr r r rq r5 i zbody:)
rV r r ra r{ r printr r r )r# r streamri rj rq s r
r zTransport.parse_response1 s 8[ ) ) !!"4b99VCC,X66! F~~ 1 ;;t$$D
|
+gtDzz***
FF4LLL
! ! LLNNN wwyyr r7 )F)r r r r __version__r r r r r r ra r r r r r r r r r r
r r j s ;; $k1J
! ! ! ! ! !$ BD D D ) ) )4# # # .+ + + , , ," r r c 2 e Zd ZdZdddd fd Zd Z xZS )
SafeTransportz2Handles an HTTPS transaction to an XML-RPC server.Fr Nr" contextc ^ t ||| || _ d S )Nr r r" )superr r )r# r r r" r r( s r
r zSafeTransport.__init__R s9
l+ a logical connection to an XML-RPC server
uri is the connection point on the server, given as
scheme://host/target.
The standard implementation always supports the "http" scheme. If
SSL socket support is available (Python 2.0), it also supports
"https".
If the target part and the slash preceding it are both omitted,
"/RPC2" is assumed.
The following options can be given as keyword arguments:
transport: a transport factory
encoding: the request encoding (default is UTF-8)
All 8-bit strings passed to the server proxy are assumed to use
the given encoding.
NFr r c t j | }
|
j dvrt d |
j | _ t j ddg|
dd | _ | j sd| _ |,|
j dk r t } d| i} n t } i } | d
|||d| }|| _ |pd | _ || _
|| _ d S ) N)r httpsz unsupported XML-RPC protocolr r z/RPC2r r r r r )r r urlsplitschemer| netloc_ServerProxy__host
urlunsplit_ServerProxy__handlerr r _ServerProxy__transport_ServerProxy__encoding_ServerProxy__verbose_ServerProxy__allow_none)
r# uri transportr r r r r r" r ri r extra_kwargss
r
r zServerProxy.__init__ s
L ! !# & & 8, , ,899 9h 00"b1A1QRR51ABB~ % $DN x7""' )7 3 # ! 0\2C(/0 0 #/0 0I %"-g &r c 8 | j d S r )r r r) s r
__closezServerProxy.__close s r c t ||| j | j | j d }| j | j | j || j }t | dk r|d }|S )N)r r xmlcharrefreplace)r r5 r )
r r r rw r r r r r r )r# rd r/ r r s r
__requestzServerProxy.__request s
T_#'#46 6 66>>
C r c , t | j | S r )r _ServerProxy__requestrA s r
rB zServerProxy.__getattr__ s t~t,,,r c \ |dk r| j S |dk r| j S t d|d )z|A workaround to get special attributes on the ServerProxy
without interfering with the magic __getattr__
r r z
Attribute z
not found)_ServerProxy__closer r )r# attrs r
rF zServerProxy.__call__ s@ 7??<
[
# # n ?@@@r c | S r r r) s r
__enter__zServerProxy.__enter__ s r c . | d S r )r rD s r
__exit__zServerProxy.__exit__ s r )NNFFFF) r r r r r r r r* rB rF r r r r r
r r z s * DIIN ' ' ' ' ' '>! ! ! $ - - -A A A r r __main__zhttp://localhost:8000ERROR r7 )NNNF)rw )Vr r sysrL r decimalr http.clientr urllib.parser xml.parsersr r r r rq ImportErrorr version_infor r r PARSE_ERROR SERVER_ERRORAPPLICATION_ERROR SYSTEM_ERRORTRANSPORT_ERRORNOT_WELLFORMED_ERRORUNSUPPORTED_ENCODINGINVALID_ENCODING_CHARINVALID_XMLRPCMETHOD_NOT_FOUNDINVALID_METHOD_PARAMSINTERNAL_ERRORr r r r- r/ r r Booleanr8 r< rC rO rQ rz r| r~ r r r r r r9 rI rP rc r] r^ ra r rk rv r rs r r r r r r Serverr rT r currentTimegetCurrentTimer multigetDatapowaddr r r r
r" s r( (T
KKKK DDD # # # (!,, I E & E B B B B BE B B B '" Aq
4:: ;1 1 1 1 T%[[ ;2 2 2 2; ; ; 5 5 5P3 P3 P3 P3 P3 P3 P3 P3d 6 6 6!) !) !) !) !) !) !) !)F
f
$ $ $ $ $ $ $ $B`4 `4 `4 `4 `4 `4 `4 `4N}, }, }, }, }, }, }, },D 5 5 5 5 5 5 5 5D D D D D D D D R R R R R R R RJ 26 5 5 . N BF@ @ @ @V ( ( ( (,
0 4 4;$--V , . . . . . . . ."` ` ` ` ` ` ` `J# # # # #I # # #Ve e e e e e e eR
z
[0
1
1F
f //112222
gq
If E MMOOO IIaNNN IIaNNN H E(OOOO
gq' s? 9 AA"G< <H HH&J J JJ __pycache__/server.cpython-311.pyc 0000644 00000133517 15102763701 0013000 0 ustar 00
!A?h d Z ddlmZmZmZmZmZ ddlmZ ddl m
Z
ddl m Z ddl
Z
ddlZddlZddlZddlZddlZddlZddlZ ddlZn
# e$ r dZY nw xY wd(dZd Z G d
d Z G d d
e Z G d dej e Z G d de Z G d de Z G d dej Z G d d Z! G d de Z" G d de e! Z# G d d e e! Z$e%d k rddl&Z& G d d Z' e d! 5 Z(e() e* e() d" d# e(+ e' d$ e(, e-d% e-d& e(. n&# e/$ r e-d' ej0 d Y nw xY wddd dS # 1 swxY w Y dS dS ))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 |r| d }n|g}|D ]9}| d rt d|z t | | } :| S )aG 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/lib64/python3.11/xmlrpc/server.pyresolve_dotted_attributer | sw
3
! ! << ! :Q>
#a..CC J c : fdt D S )zkReturns a list of attribute strings, found in the specified
object, which represent callable attributesc x g | ]6}| d t t | 4|7S )r
)r callabler ).0memberr s r
z'list_public_methods.. sU 4 4 4v ((-- 4 WS& 1 122 4F 4 4 4r )dir)r s `r list_public_methodsr! s3 4 4 4 4S 4 4 4 4r c ` e Zd ZdZ ddZddZddZd Zd Zdd Z d
Z
d Z d Z d
Z
d ZdS )SimpleXMLRPCDispatchera& 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
FNc P i | _ d | _ || _ |pd| _ || _ d S Nutf-8)funcsinstance
allow_noneencodinguse_builtin_typesselfr) r* r+ s r __init__z SimpleXMLRPCDispatcher.__init__ s1
$ +G
!2 r c " || _ || _ dS )a 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_instancez(SimpleXMLRPCDispatcher.register_instance s B !
"4 r c \ |t | j | S ||j }|| j |< |S )zRegisters a function to respond to XML-RPC requests.
The optional name argument can be used to set a Unicode name
for the function.
N)name)r register_function__name__r' )r- functionr2 s r r3 z(SimpleXMLRPCDispatcher.register_function s> 41=== = <$D#
4r c ` | j | j | j | j d dS )zRegisters 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_functionsz7SimpleXMLRPCDispatcher.register_introspection_functions sJ
$2I151L,0,BD D E E E E Er c H | j d| j i dS )zRegisters the XML-RPC multicall method in the system
namespace.
see http://www.xmlrpc.com/discuss/msgReader$1208zsystem.multicallN)r' r7 system_multicallr; s r register_multicall_functionsz3SimpleXMLRPCDispatcher.register_multicall_functions s)
-0EFGGGGGr c t || j \ }}|
||| }n| || }|f}t |d| j | j }n# t $ r&}t || j | j }Y d}~nVd}~wt $ rF}t t
dt | d| | j | j }Y d}~nd}~ww xY w| | j d S ) 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_dispatchz*SimpleXMLRPCDispatcher._marshaled_dispatch s7 "44;Q R R RNFF **?66:: >>&&99 {H Xa(,$-Q Q QHH 5 5 5 Ut&*m5 5 5HHHHHH aDIIIIss344 4? HHHHHH t}.ABBBs$ A A! !
C + B
C ['add', 'subtract', 'multiple']
Returns a list of the methods supported by the server.N _listMethodsrF )setr' keysr( hasattrrT r! sorted)r- methodss r r8 z)SimpleXMLRPCDispatcher.system_listMethods s
djoo''(( = $ t}n55
C3t} 9 9 ; ;<<< T]K88
C3 24= A ABBBg r c dS )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 r9 z-SimpleXMLRPCDispatcher.system_methodSignature) s
*)r c T d}|| j v r| j | }nx| j qt | j d r| j | S t | j d s- t | j || j }n# t $ r Y nw xY w|dS t j | S )zsystem.methodHelp('add') => "Adds two integers together"
Returns a string containing documentation for the specified method.N _methodHelprF ) r' r( rW r^ r r r pydocgetdoc)r- r\ rN s r r: z(SimpleXMLRPCDispatcher.system_methodHelp6 s
$* $ $Z ,FF
]
&t}m44
}00=== T]K88
5 $
+ $ 7 " "FF
& D
>2<'' 's &B
BBc t g }|D ]}|d }|d } | | || g ># t $ r,}| |j |j d Y d}~od}~wt
$ r4}| dt
| d|d Y d}~d}~ww xY w|S )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
methodNamerM ) faultCode faultStringNrA rC )appendrF r rd re rG rH )r- call_listresultscallr\ rM rP rQ s r r> z'SimpleXMLRPCDispatcher.system_multicallU s, D |,K(^F
{F C C DEEEE
#(?%*%68 8 !
#$04S 33%?A A
s# *A
B5
"A44
B5*B00B5c j | j | }| || S t d|z # t $ r Y nw xY w| j dt | j d r| j || S t
| j || j }| || S n# t $ r Y nw xY wt d|z )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.
Nz method "%s" is not supportedrF ) r' ExceptionKeyErrorr( rW rF r r r )r- rN rM funcs r rF z SimpleXMLRPCDispatcher._dispatcht s * E:f%D tV}$ :V CDD D D = $t}k22
?}..vv>>>
)/M+ # 4=( $ "
6?@@@s
(
550B
B B FNF)FNN)r4
__module__ __qualname____doc__r. r0 r3 r< r? rR r8 r9 r: r> rF r[ r r r# r# s 37#(3 3 3 3"5 "5 "5 "5H E E EH H H!C !C !C !CF $ * * * ( ( (> >1A 1A 1A 1A 1Ar r# c e Zd ZdZdZdZdZdZ ej dej
ej z Z d Z
d Zd Zd
Zd Zdd
ZdS )SimpleXMLRPCRequestHandlerzSimple 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 ( i }| j dd }| d D ]^}| j | }|r@| d }|rt
| nd}||| d < _|S )NzAccept-Encodingr_ , g ?rA )headersgetr aepatternmatchgroupfloat)r- raeer~ vs r accept_encodingsz+SimpleXMLRPCRequestHandler.accept_encodings s
\
/
4
4# & &AN((++E
&KKNN !*E!HHHs$%%++a..!r c 0 | j r| j | j v S dS )NT) rpc_pathsrL r; s r is_rpc_path_validz,SimpleXMLRPCRequestHandler.is_rpc_path_valid s" > 9. . 4r c | s| dS d}t | j d }g }|r\t || }| j | }|sn/| | |t |d z }|\d | }|
| }|dS | j |t | dd | j }| d | dd | j yt | | j k ra| d
d }|r7 t) | }| d d
n# t* $ r Y nw xY w| d
t- t | | | j | dS # t4 $ r} | d t7 | j d r|| j j rp| dt- | t; j }
t- |
dd d }
| d|
| d
d | Y d} ~ dS d} ~ ww xY w)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-lengthrw r rF Content-typeztext/xmlgzipr zContent-EncodingContent-lengthi _send_traceback_headerz X-exceptionASCIIbackslashreplacez X-traceback0) r
report_404intr{ minrfilereadrf lenjoindecode_request_contentserverrR r rL
send_response send_headerencode_thresholdr r| r NotImplementedErrorstr end_headerswfilewriterk rW r traceback
format_excrI ) r- max_chunk_sizesize_remainingL
chunk_sizechunkrJ rO qr traces r do_POSTz"SimpleXMLRPCRequestHandler.do_POST s %%'' OO F9 '
*N .>!? @ @NA
- @ @
33 #ae**,
!
- 88A;;D..t44D| {66'$ T::DI H$
s # # # ^Z 8 8 8$0x==4#888 --//33FA>>A !!'28'<'t $ r | dd Y n w xY w| dd|z | dd | d S )
Nzcontent-encodingidentityr i zencoding %r not supported zerror decoding gzip contentr r ) r{ r| lowerr r r
ValueErrorr r )r- rJ r* s r r z1SimpleXMLRPCRequestHandler.decode_request_content s <##$6
CCIIKK z ! !K v
G"4(((&
P
P
P""3(Ch(NOOOOO
G
G
G""3(EFFFFF
G
s$?($J K K K )3/// s A #B1 BBc | d d}| dd | dt t | | | j | d S )Ni s No such pager z
text/plainr )r r r r r r r r- rO s r r z%SimpleXMLRPCRequestHandler.report_404* s 3 " 666 )3s8}}+=+=>>>
"""""r -c N | j j rt j | || dS dS )z$Selectively log an accepted request.N)r logRequestsr log_request)r- codesizes r r z&SimpleXMLRPCRequestHandler.log_request3 s9 ; " A " .tT4 @ @ @ @ @ A Ar N)r r )r4 rp rq rr r r wbufsizedisable_nagle_algorithmrecompileVERBOSE
IGNORECASEr} r r r r r r r[ r r rt rt s -I H "
"$bm!;= =I
E' E' E'N "# # #A A A A A Ar rt c . e Zd ZdZdZdZedddddfdZdS )SimpleXMLRPCServerag 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.
TFNc || _ t | ||| t j | ||| d S N)r r# r. socketserver TCPServerr- addrrequestHandlerr r) r* bind_and_activater+ s r r. zSimpleXMLRPCServer.__init__L sK ' ''j(DUVVV ''dNDUVVVVVr )r4 rp rq rr allow_reuse_addressr rt r. r[ r r r r 9 sW #,F !ed#'5W W W W W Wr r c : e Zd ZdZedddddfdZd Zd Zd dZdS )
MultiPathXMLRPCServera\ 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.
TFNc
v t | ||||||| i | _ || _ |pd| _ d S r% )r r. dispatchersr) r* r s r r. z MultiPathXMLRPCServer.__init__] sQ ##D$ Z$,.?AR T T T $ +G
r c || j |< |S r r )r- rL
dispatchers r add_dispatcherz$MultiPathXMLRPCServer.add_dispatcherg s !+ r c | j | S r r )r- rL s r get_dispatcherz$MultiPathXMLRPCServer.get_dispatcherk s %%r c * | j | ||| }nn# t $ ra}t t dt | d| | j | j }| | j d }Y d }~nd }~ww xY w|S )NrA rC rD rE ) r rR rG r r rH r* r) rI )r- rJ rK rL rO rQ s r rR z)MultiPathXMLRPCServer._marshaled_dispatchn s
K'-AA_d, ,HH K K K aDIIIIss344 4?D D DH t}6IJJHHHHHH K s "%
BAB Bro ) r4 rp rq rr rt r. r r rR r[ r r r r U sv -G !ed#'5, , , , & & & r r c . e Zd ZdZddZd Zd Zd dZdS )
CGIXMLRPCRequestHandlerz3Simple handler for XML-RPC data passed through CGI.FNc @ t | ||| d S r )r# r. r, s r r. z CGIXMLRPCRequestHandler.__init__ s# ''j(DUVVVVVr c r | | }t d t dt | z t t j t j j | t j j dS )z Handle a single XML-RPC requestzContent-Type: text/xmlContent-Length: %dN)rR printr sysstdoutflushbufferr )r- request_textrO s r
handle_xmlrpcz%CGIXMLRPCRequestHandler.handle_xmlrpc s ++L99
&'''
"S]]2333
)))
!!!!!r c d}t j | \ }}t j j |||dz }| d }t
d||fz t
dt j j z t
dt | z t
t j
t j
j
| t j
j dS )zHandle a single HTTP GET request.
Default implementation indicates an error because
XML-RPC uses the POST method.
r )r messageexplainr& z
Status: %d %szContent-Type: %sr N)r responseshttpr DEFAULT_ERROR_MESSAGErI r DEFAULT_ERROR_CONTENT_TYPEr r r r r r )r- r r r rO s r
handle_getz"CGIXMLRPCRequestHandler.handle_get s 1;DA;4
??7++
ow/000
4;#IIJJJ
"S]]2333
)))
!!!!!r c z |:t j dd dk r| dS t t j dd }n# t
t f$ r d}Y nw xY w| t j | }|
| dS )zHandle 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.
NREQUEST_METHODGETCONTENT_LENGTHrw ) osenvironr| r r r TypeErrorr stdinr r )r- r lengths r handle_requestz&CGIXMLRPCRequestHandler.handle_request s JNN+T 2 2e ; ; OO
RZ^^,zz(https://www.rfc-editor.org/rfc/rfc%d.txtz!https://peps.python.org/pep-%04d/(zself.%sNr_ ) escaper r searchspanrf groupsreplacer namelinkr )r- textr r' classesrY rh herepatternr~ startendallschemerfcpepselfdotr2 urls r markupzServerHTMLDoc.markup s6 &4; * < = = NN4..E % JE3 NN66$tEz"233 4 4 438<<>> 0Cc7D
= fSkk))#x88SSS ABBBB
=@3s88KVVC[[[[ IJJJJ
=9CHHDVVC[[[[ IJJJJc#a%i C''t}}T7E7 K KLLLL
= 9D @AAAAt}}T7 ; ;<<<D- . vvd455k**+++www r c |r|j pddz |z }d} d| | d| | d}
t | r t t | } nd} t |t r|d p| } |d pd} nt j | } |
| z | o| d | z z }
|
| | j ||| }|od
|z }d |
d |d
S )z;Produce HTML documentation for a function or method object.r_ r z z
z(...)r rA z'%sz
%s
z
z
z
) r4 r r r r
isinstancetupler` ra greyr preformat)r- objectr2 modr' r rY clanchornotetitleargspec docstringdecldocs r
docroutinezServerHTMLDoc.docroutine s> $*c1D8
KK T!2!2!2!24 F )F++,,GG G fe $ $ - Qi*7G q RII V,,Iw$ #A49984?,A ,A B kk t~ugw@ @2,s2-1TT33377r c i }| D ]\ }}d|z ||< || ||< | | }d|z }| | }| || j | } | od| z } |d| z z }g }
t | } | D ]0\ }}|
| ||| 1|| ddd |
z }|S ) z1Produce HTML documentation for an XML-RPC server.z#-z)%sz %sz
%s
)r' Methods functionsr_ )
itemsr headingr r rX rf r
bigsectionr ) r- server_namepackage_documentationrY fdictkeyvalueheadresultr contents method_itemss r docserverzServerHTMLDoc.docserver
s, !--// & &JC E#J :E%LLkk+.. :[H d##kk/ GG)mc)-#-- gmmoo.. & F FJC OODOOE3eO D D E E E E$// {BGGH$5$57 7 7
r c ( d}d|z }d|d|d|dS )zFormat an HTML page.rv z1zI
Python: z
z
zr[ )r- r r) css_pathcss_links r pagezServerHTMLDoc.page$ s: ?
',eeXXXxxx
A Ar )r4 rp rq rr r r r+ r/ r[ r r r r s} AA"&b"b ' ' ' ' R ,0R8 8 8 8: 4 A A A A Ar r c 0 e Zd ZdZd Zd Zd Zd Zd ZdS )XMLRPCDocGeneratorzGenerates documentation for an XML-RPC server.
This class is designed as mix-in and should not
be constructed directly.
c 0 d| _ d| _ d| _ d S )Nz XML-RPC Server DocumentationzGThis server exports the following methods through the XML-RPC protocol.)r" server_documentation server_titler; s r r. zXMLRPCDocGenerator.__init__9 s' 9
! ;r c || _ dS )z8Set the HTML title of the generated server documentationN)r4 )r- r4 s r set_server_titlez#XMLRPCDocGenerator.set_server_titleA s )r c || _ dS )z7Set the name of the generated HTML server documentationN)r" )r- r" s r set_server_namez"XMLRPCDocGenerator.set_server_nameF s 'r c || _ dS )z3Set the documentation string for the entire server.N)r3 )r- r3 s r set_server_documentationz+XMLRPCDocGenerator.set_server_documentationK s %9!!!r c i }| D ]}|| j v r| j | }n| j ddg}t | j d r | j | |d< t | j d r | j | |d< t
| }|dk r|}nKt | j d s) t | j | }n # t $ r |}Y nw xY w|}n
J d |||< t }|
| j | j | }|
t j | j | S ) a 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.N_get_method_argstringr r^ rA ro rF zACould not find method in self.functions and no instance installed)r8 r' r( rW r< r^ r r r r r+ r" r3 r/ htmlr r4 )r- rY r\ rN method_info
documenter
documentations r generate_html_documentationz.XMLRPCDocGenerator.generate_html_documentationP s 2244 * *Kdj(( K0 * #Tl 4=*ABB V%)]%H%H%U%UKN4=-88 L%)]%>%>{%K%KKN #K 0 0 ,.. (FF << )-!9$(M$/"& "& * - - -!,- )FF/ / / /q $*GK "__
",, $ 0 $ 9 '
t{4+< = =}MMMs
C## C21C2N) r4 rp rq rr r. r6 r8 r: rA r[ r r r1 r1 2 sn ; ; ;) ) )
' ' '
9 9 9
1N 1N 1N 1N 1Nr r1 c e Zd ZdZd Zd ZdS )DocXMLRPCRequestHandlerzXML-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 F t j t j t }t j |ddd }t
|d 5 }| cd d d S # 1 swxY w Y d S )Nz..
pydoc_dataz
_pydoc.cssrb)mode)r rL dirnamerealpath__file__r openr )r- r
path_herer- fps r _get_cssz DocXMLRPCRequestHandler._get_css s GOOBG$4$4X$>$>?? 7<< 4 |LL
(
&
&
& "7799 s 5BB Bc < | s| dS | j d r d}| | j }n.d}| j d }| d | dd|z | d t t | | | j
| dS )
}Handles the HTTP GET request.
Interpret all HTTP GET requests as requests for server
documentation.
Nz.cssztext/cssz text/htmlr& r z Content-Typez%s; charset=UTF-8r )r r rL endswithrN r rA rI r r r r r r r )r- content_typerO s r do_GETz DocXMLRPCRequestHandler.do_GET s %%'' OO F 9 f % % Q%L}}TY//HH&L{>>@@GGPPH 3 )<|)KLLL )3s8}}+=+=>>>
"""""r N)r4 rp rq rr rN rS r[ r r rC rC s< # # # # #r rC c & e Zd ZdZedddddfdZdS )DocXMLRPCServerzXML-RPC and HTML documentation server.
Adds the ability to serve server documentation to the capabilities
of SimpleXMLRPCServer.
TFNc
| t | ||||||| t | d S r )r r. r1 r s r r. zDocXMLRPCServer.__init__ sK ##D$ $.:K$5 7 7 7 ##D)))))r )r4 rp rq rr rC r. r[ r r rU rU sD -D !ed#'5* * * * * *r rU c e Zd ZdZd Zd ZdS )DocCGIXMLRPCRequestHandlerzJHandler for XML-RPC data and documentation requests passed through
CGIc | d }t d t dt | z t t j t j j | t j j dS )rP r& zContent-Type: text/htmlr N) rA rI r r r r r r r r s r r z%DocCGIXMLRPCRequestHandler.handle_get s 3355< t j S r )datetimenowr[ r r getCurrentTimez)ExampleService.currentTime.getCurrentTime s (,,...r N)r4 rp rq staticmethodrf r[ r r currentTimerb s-
/
/ \
/
/
/r rh N)r4 rp rq r` rh r[ r r r] r] sK / / / / / / / / / /r r] ) localhosti@ c | |z S r r[ )xys r rm s
QqS r add)r z&Serving XML-RPC on localhost port 8000zKIt is advisable to run this example server within a secure, closed network.z&
Keyboard interrupt received, exiting.)T)1rr
xmlrpc.clientr r r r r http.serverr functoolsr inspectr
r= r r r r r r` r fcntl ImportErrorr r! r# rt r r r r HTMLDocr r1 rC rU rX r4 rd r] r r3 powr0 r? r
serve_foreverKeyboardInterruptexitr[ r r rz s e eT H G G G G G G G G G G G G G . . . . . .
LLLL EEE 04 4 4IA IA IA IA IA IA IA IAVPA PA PA PA PA!7 PA PA PAdW W W W W //W W W8% % % % % . % % %N?- ?- ?- ?- ?- 4 ?- ?- ?-JoA oA oA oA oAEM oA oA oAbON ON ON ON ON ON ON ONb&# &# &# &# &# 8 &# &# &#P* * * * **** * * * * * * *$;$6* * *4 zOOO/ / / / / / / /
/ 0 0 F %%% %888 !1!1d KKK++---
6777
[\\\ " " " " E; < < < CHQKKKKK sI A AAA6G
F"!G" GGGGG G __pycache__/__init__.cpython-311.pyc 0000644 00000000225 15102763701 0013216 0 ustar 00
!A?h& d S )N r (/usr/lib64/python3.11/xmlrpc/__init__.pyr s r __pycache__/__init__.cpython-311.opt-1.pyc 0000644 00000000225 15102763701 0014155 0 ustar 00
!A?h& d S )N r (/usr/lib64/python3.11/xmlrpc/__init__.pyr s r __pycache__/__init__.cpython-311.opt-2.pyc 0000644 00000000225 15102763701 0014156 0 ustar 00
!A?h& d S )N r (/usr/lib64/python3.11/xmlrpc/__init__.pyr s r __pycache__/client.cpython-311.opt-2.pyc 0000644 00000144113 15102763701 0013702 0 ustar 00
!A?h @ d dl Z d dlZd dlZd dlmZ d dlmZ d dlZd dlZ d dl
m Z d dl Z d dl
mZ d dlZn
# e$ r dZY nw xY wd Zdej dd z Zd Zd
Zd Zd Zd
ZdZdZd ZdZ dZ d Z dZ dZ dZ! G d de" Z# G d de# Z$ G d de# Z% G d d e# Z&e'xZ(Z) ed d d Z*d Z+ e+d rd Z,n e+d! rd" Z,nd# Z,[*[+d$ Z- G d% d& Z.d' Z/d( Z0 G d) d* Z1d+ Z2e.e1fZ3 G d, d- Z4 G d. d/ Z5 G d0 d1 Z6 G d2 d3 Z7 G d4 d5 Z8 G d6 d7 Z9dxZ:xZ;ZdMd;Z?d< Z@dOd>ZA G d? d@erejB neC ZD G dA dB ZE G dC dD ZF G dE dFeF ZG G dG dH ZHeHZIeJdIk r eHdJ ZK eLeKjM N n # e#$ rZO eLdKeO Y dZO[OndZO[Oww xY w e9eK ZPePQ ePR ddL ePS d d eP D ]
ZT eLeT dS # e#$ rZO eLdKeO Y dZO[OdS dZO[Oww xY wdS )P N)datetime)Decimal)expat)BytesIOc | dd } | dd } | dd S )N&z&z>)replace)ss &/usr/lib64/python3.11/xmlrpc/client.pyescaper s< #w A #v A 99S& " "" z%d.%d ii iDii ipiԁiCiBiiic e Zd Z ej ZdS )ErrorN)__name__
__module__ __qualname__object__str__ r r
r r s 'nGGGr r c e Zd Z d Zd ZdS )
ProtocolErrorc r t | || _ || _ || _ || _ d S N)r __init__urlerrcodeerrmsgheaders)selfr r r r! s r
r zProtocolError.__init__ s4
t r c R d| j j d| j d| j d| j d S )Nr for : r
) __class__r r r r r" s r
__repr__zProtocolError.__repr__ s7 ^
$
$
$dhhh dkkk
K r Nr r r r r) r r r
r r s5 + r r c e Zd Z dS )
ResponseErrorN)r r r r r r
r, r, s .Dr r, c e Zd Z d Zd ZdS )Faultc V t | || _ || _ d S r )r r faultCode faultString)r" r0 r1 extras r
r zFault.__init__ s)
t "&r c B d| j j d| j d| j dS )Nr r& r% r
)r' r r0 r1 r( s r
r) zFault.__repr__ s2 $ 7 7 7 $0@0@0@B Br Nr* r r r
r. r. s: -' ' 'B B B B Br r. c b t | dk S # t $ r Y dS w xY w)N0001F)_day0strftime
ValueError)fmts r
_tryr; s@ ~~c""f,, uus
..z%Yc , | d S N%Y%m%dT%H:%M:%Sr8 values r
_iso8601_formatrB s ~~ /000r z%4Yc , | d S )Nz%4Y%m%dT%H:%M:%Sr? r@ s r
rB rB s ~~ 0111r c R | d d S )Nr> )r8 zfillr@ s r
rB rB s# ~~ /0066r:::r c t | t rt | S t | t t j f s-| dk rt j } t j | } d| d d z S )Nr z%04d%02d%02dT%02d:%02d:%02d )
isinstancer rB tupletime struct_time localtimer@ s r
_strftimerN sr %"" & u%%% eeT%5 6 7 7 & A::IKKEu%% (5!9 44r c Z e Zd Z ddZd Zd Zd Zd Zd Zd Z d Z
d
Z d Z d Z
d
ZdS )DateTimer c j t |t r || _ d S t | | _ d S r )rI strrA rN )r" rA s r
r zDateTime.__init__. s2 eS ! ! * DJJJ"5))DJJJr c l t |t r| j }|j }nt |t r| j }t | }nat |t
r
| j }|}nBt
|d r)| }| }n | }t }||fS )N timetuple) rI rP rA r rB rR hasattrrT NotImplementedr" otherr os r
make_comparablezDateTime.make_comparable4 s eX & &
A AA
x
(
(
A &&AA
s
#
#
AAA
UK
(
( A!!AAA A!t r c ^ | | \ }}|t u rt S ||k S r rZ rV rW s r
__lt__zDateTime.__lt__F 3 ##E**1 ! !1u r c ^ | | \ }}|t u rt S ||k S r r\ rW s r
__le__zDateTime.__le__L 3 ##E**1 ! !Av
r c ^ | | \ }}|t u rt S ||k S r r\ rW s r
__gt__zDateTime.__gt__R r^ r c ^ | | \ }}|t u rt S ||k S r r\ rW s r
__ge__zDateTime.__ge__X ra r c ^ | | \ }}|t u rt S ||k S r r\ rW s r
__eq__zDateTime.__eq__^ ra r c 6 t j | j d S r= )rK strptimerA r( s r
rT zDateTime.timetupled s }TZ):;;;r c | j S r r@ r( s r
r zDateTime.__str__l s
zr c J d| j j | j t | fz S )Nz<%s %r at %#x>)r' r rA idr( s r
r) zDateTime.__repr__o s! 4>#:DJ4"QQQr c R t | | _ d S r )rR striprA r" datas r
decodezDateTime.decoder s YY__&&
r c | d | | j | d d S Nzz
)writerA )r" outs r
encodezDateTime.encodeu sB -... $* 122222r N)r )r r r r rZ r] r` rc re rg rT r r) rq rv r r r
rP rP ( s
* * * * $ < < < R R R' ' '3 3 3 3 3r rP c L t }| | |S r )rP rq rp rA s r
_datetimery z s" JJE LL Lr c , t j | d S r= )r ri )rp s r
_datetime_typer{ s T#4 5 55r c 0 e Zd Z ddZd Zd Zd Zd ZdS )BinaryNc |d}nGt |t t f s t d|j j z t | }|| _ d S )Nr z#expected bytes or bytearray, not %s)rI bytes bytearray TypeErrorr' r rp ro s r
r zBinary.__init__ s] <DD dUI$677
9 E $ 7!8 9 9 9;;D r c , t | j d S )Nzlatin-1)rR rp r( s r
r zBinary.__str__ s 49i(((r c P t |t r|j }| j |k S r )rI r} rp )r" rX s r
rg z
Binary.__eq__ s( eV $ $ JEyE!!r c 8 t j | | _ d S r )base64 decodebytesrp ro s r
rq z
Binary.decode s &t,, r c | d t j | j }| | d | d d S Nz
asciiz
)rt r encodebytesrp rq )r" ru encodeds r
rv z
Binary.encode s^ %&&&$TY// '..))*** '(((((r r )r r r r r rg rq rv r r r
r} r} sg " ) ) )" " "
- - -) ) ) ) )r r} c L t }| | |S r )r} rq rx s r
_binaryr s" HHE LL Lr c e Zd Zd Zd Zd ZdS ) ExpatParserc t j d d x| _ }|| _ |j |_ |j |_ |j |_ d }|
|d d S r ) r ParserCreate_parser_targetstartStartElementHandlerendEndElementHandlerrp CharacterDataHandlerxml)r" targetparserencodings r
r zExpatParser.__init__ s_ % 24 > >> v %+\"#): &,k#
8T"""""r c < | j |d d S NF)r Parsero s r
feedzExpatParser.feed s 4'''''r c l | j }| `| ` | dd d S # t $ r Y d S w xY w)Nr T)r r r AttributeError)r" r s r
closezExpatParser.close sW $\F dl LLd # # # # # DD s %
33N)r r r r r r r r r
r r sA # # #( ( ($ $ $ $ $r r c e Zd Z ddZi Zd Zd Zd Zee ed < d Z e ee
< d Z e ee < e Z
d Zeee< efd
Zeee< d Zeee< eee< d Zeee< eee< efd
Zeee< d Zeee < d Z e ee < e ee < e ed< dS )
MarshallerNFc > i | _ d | _ || _ || _ d S r )memorp r
allow_none)r" r r s r
r zMarshaller.__init__ s"
$r c T g }|j }| j }t |t r0 |d ||j |j d| |d n= |d |D ]$} |d ||| |d % |d d | }|S ) Nz
)r0 r1 z
z
z
z
z
)append_Marshaller__dumprI r. r0 r1 join)r" valuesru rt dumpvresults r
dumpszMarshaller.dumps s
{ fe $ $ ! E+ Dv /!'!35 5
E,
E,
$
$k"""Ql#### E-
r c | j t | }n# t $ r t |d s t dt | z t | j D ]<}|| j v r t dt | z =| j d }Y nw xY w || || d S )N__dict__zcannot marshal %s objects_arbitrary_instance)dispatchtypeKeyErrorrU r __mro__keys)r" rA rt ftype_s r
__dumpzMarshaller.__dump s 5
d5kk*AA 5 5 55*--
K ;d5kk IJJJ e,
O
ODM . . 0 000#$?$u++$MNNN 1
34AAA 5
$u s BB76B7c H | j st d |d d S )Nz0cannot marshal None unless allow_none is enabledz)r r r" rA rt s r
dump_nilzMarshaller.dump_nil s3 P NOO O
%&&&&&r c P |d ||rdpd |d d S )Nz10z
r r s r
dump_boolzMarshaller.dump_bool sC
!!!
em"s###
$%%%%%r c |t k s |t k rt d |d |t t | |d d S )Nzint exceeds XML-RPC limitsz z
)MAXINTMININT
OverflowErrorrR intr s r
dump_longzMarshaller.dump_long& se 6>>UV^^ <== =
n
c#e**oo
!!!!!r c b |d |t | |d d S )Nzz
)reprr s r
dump_doublezMarshaller.dump_double1 s@
d5kk
#$$$$$r c Z |d | || |d d S )Nzz
r )r" rA rt r s r
dump_unicodezMarshaller.dump_unicode7 sB
ffUmm
#$$$$$r c |d t j | } || d |d d S r )r r rq )r" rA rt r s r
dump_byteszMarshaller.dump_bytes= sV
!"""$U++
gnnW%%&&&
#$$$$$r c t | }|| j v rt d d | j |< | j } |d |D ]} ||| |d | j |= d S )Nz"cannot marshal recursive sequencesz
z
)rl r r r )r" rA rt ir r s r
dump_arrayzMarshaller.dump_arrayE s uII >> @AA A ! {
&''' A DENNNN
)*** IaLLLr c t | }|| j v rt d d | j |< | j } |d | D ]b\ }} |d t |t st d |d || z ||| |d c |d | j |= d S )Nz%cannot marshal recursive dictionariesz
z
z dictionary key must be stringz%s
z
z
)rl r r r itemsrI rR )r" rA rt r r r kr s r
dump_structzMarshaller.dump_structS s uII >> CDD D ! {
!"""KKMM ! !DAq E, a%%
A ?@@@ E%q 1 2 2 2 DENNN E-
#$$$ IaLLLr c b |d |t | |d d S rs )rN r s r
dump_datetimezMarshaller.dump_datetimee sB
)***
i
-.....r c |j t v r || _ | | | `d S | |j | d S r )r' WRAPPERSrt rv r r r s r
dump_instancezMarshaller.dump_instancek sQ ?h & & DJ LL
U^U 3 3 3 3 3r r r ) r r r r r r r r r r boolr r dump_intr floatr r rR r r r r rJ listr dictr r r rP r} r r r
r r s % % % % H 6 $' ' ' $HTT$ZZ& & & HTN" " " HSM H% % % "HUO06 % % % % !HSM% % %
!HUO$HY
!HUO HTN/5 !HTN/ / / 'HX4 4 4 'HX$HV '4H
"###r r c l e Zd Z d.dZd Zd Zd Zd Zd Zd Z d Z
i Z d
Z e e d < d Z
e
e d
< d Zee d< ee d< ee d< ee d< ee d< ee d< d Zee d< ee d< d Zee d< d Zee d< ee d < d Zee d < d Zee d < d! Zee d"< d# Zee d$< d% Zee d&< d' Zee d(< d) Zee d*< d+ Zee d,< d-S )/ UnmarshallerFc d | _ g | _ g | _ g | _ d| _ d | _ d| _ | j j | _ |p|| _ || _ d S )NFutf-8)
_type_stack_marks_data_value _methodname _encodingr
_use_datetime
_use_bytes)r" use_datetimeuse_builtin_typess r
r zUnmarshaller.__init__ sX
k( . >,+r c | j | j rt | j dk rt di | j d t | j S )Nfaultr r )r r r, r. r rJ r( s r
r zUnmarshaller.close sR : // ! : ))$+a.)) )T[!!!r c | j S r )r r( s r
getmethodnamezUnmarshaller.getmethodname s r c || _ d S r )r )r" r
standalones r
r zUnmarshaller.xml s
!r c d|v r| d d }|dk s|dk r,| j t | j g | _ | j r|| j vrt d|z |dk | _ d S )N:arraystructzunknown tag %rrA ) splitr r lenr r r r r, )r" tagattrss r
r zUnmarshaller.start s #::))C..$C '>>SH__ K s4; / / 0 0 0
; 83dm33 03 677 7g~ r c : | j | d S r )r r )r" texts r
rp zUnmarshaller.data s
$ r c
| j | }nQ# t $ rD d|vrY d S | j | d d }n# t $ r Y Y d S w xY wY nw xY w || d | j S )Nr r r )r r r r r )r" r r s r
r zUnmarshaller.end s
c"AA #~~
M#))C.."45
qrwwtz**+++2
A &A A
AA AA A c | j | }nQ# t $ rD d|vrY d S | j | d d }n# t $ r Y Y d S w xY wY nw xY w || | S )Nr r )r r r )r" r rp r s r
end_dispatchzUnmarshaller.end_dispatch s
c"AA #~~
M#))C.."45
qt}} r c > | d d| _ d S Nr )r r ro s r
end_nilzUnmarshaller.end_nil s D r nilc |dk r| d n+|dk r| d nt d d| _ d S )Nr Fr Tzbad boolean valuer )r r r ro s r
end_booleanzUnmarshaller.end_boolean sX 3;; KK
S[[ KK /00 0 r booleanc X | t | d| _ d S r )r r r ro s r
end_intzUnmarshaller.end_int s% CII r i1i2i4i8r
bigintegerc X | t | d| _ d S r )r r r ro s r
end_doublezUnmarshaller.end_double s% E$KK r doubler c X | t | d| _ d S r )r r r ro s r
end_bigdecimalzUnmarshaller.end_bigdecimal s% GDMM""" r
bigdecimalc | j r| | j }| | d| _ d S r )r rq r r ro s r
end_stringzUnmarshaller.end_string s< > /;;t~..D D r stringnamec z | j }| j |d g| j |d < d| _ d S r )r popr r )r" rp marks r
end_arrayzUnmarshaller.end_array s< { "k$%% 0 1 DEE r r c | j }i }| j |d }t dt | d D ]}||dz ||| < |g| j |d < d| _ d S )Nr r r4 )r r r ranger r )r" rp r! r r r s r
end_structzUnmarshaller.end_struct s} { DEE"q#e**a(( ( (A "1Q3ZDqNN "V DEE r r c t }| | d | j r|j }| | d| _ d S )Nr r )r} rq rv r rp r r r" rp rA s r
end_base64zUnmarshaller.end_base64 sW
T[[))*** ? JE E r r c t }| | | j rt | }| | d S r )rP rq r r{ r r' s r
end_dateTimezUnmarshaller.end_dateTime sM
T )"4((E Er zdateTime.iso8601c B | j r| | d S d S r )r r ro s r
end_valuezUnmarshaller.end_value( s0 ; " OOD ! ! ! ! ! " "r rA c d| _ d S )Nparamsr ro s r
end_paramszUnmarshaller.end_params/ s
r r. c d| _ d S )Nr r/ ro s r
end_faultzUnmarshaller.end_fault3 s
r r c d | j r| | j }|| _ d| _ d S )N
methodName)r rq r r ro s r
end_methodNamezUnmarshaller.end_methodName7 s2 > /;;t~..D !
r r4 NFF)r r r r r r r r rp r r r r r r r r r r" r% r( r* r, r0 r2 r5 r r r
r r sP
,
,
,
," " " " " " ' ' ' , , , H HUO &HY HTN HTN HTN HTN HUO $H\ $HX"HW ,H\
$HX!HV
"HW $HX $HX $0H
" " "
"HW #HX !HW" " "
,H\r r c e Zd Zd Zd Zd ZdS )_MultiCallMethodc " || _ || _ d S r )_MultiCallMethod__call_list_MultiCallMethod__name)r" call_listr s r
r z_MultiCallMethod.__init__D s $ r c @ t | j | j d| S N.)r8 r: r; r" r s r
__getattr__z _MultiCallMethod.__getattr__G s" 0T[[[$$2OPPPr c H | j | j |f d S r )r: r r; r" argss r
__call__z_MultiCallMethod.__call__I s& d 344444r Nr r r r rA rE r r r
r8 r8 A sD Q Q Q5 5 5 5 5r r8 c e Zd Z d Zd ZdS )MultiCallIteratorc || _ d S r )results)r" rJ s r
r zMultiCallIterator.__init__P s
r c | j | }t | t i k r t |d |d t | t g k r|d S t d )Nr0 r1 r z#unexpected type in multicall result)rJ r r. r9 )r" r items r
__getitem__z MultiCallIterator.__getitem__S sm |A ::b ! ![)4
+>?? ?
$ZZ488
#
#7N BCC Cr N)r r r r rM r r r
rH rH L s< , D D D D Dr rH c ( e Zd Z d Zd Zd Zd ZdS ) MultiCallc " || _ g | _ d S r )_MultiCall__server_MultiCall__call_list)r" servers r
r zMultiCall.__init__m s
r c > d| j j t | fz S )Nz <%s at %#x>)r' r rl r( s r
r) zMultiCall.__repr__q s 7D BBBr c , t | j | S r )r8 rR r@ s r
rA zMultiCall.__getattr__t s 0$777r c g }| j D ] \ }}| ||d t | j j | S )N)r4 r. )rR r rH rQ system multicall)r" marshalled_listr rD s r
rE zMultiCall.__call__w s_ * K KJD$ " "4D#I#I J J J J !5!?!?!P!PQQQr N)r r r r r) rA rE r r r
rO rO \ s] C C C8 8 8R R R R Rr rO Fc P t rdt r]|rt }t j }n | rt }t
}nt }t
}t dd||t }t | }n7t | | }t rt | }nt | }||fS )NTFr r )
FastParserFastUnmarshallerr{ r r r ry r. r r )r r
mkdatetimemkbytesr r s r
getparserr` s
)& ) 'J (GG
'J GG"J G!$w
EJJF## r c n t | t rd}n|rt | t r |sd}t rt | }nt || }| | }|dk rdt
| z }nd}|r |d|d|df}n |r|d|d f}n|S d
| S ) Nr4 r z$
z
zz
z
z
z
r )rI r. rJ FastMarshallerr r rR r )r.
methodnamemethodresponser r mrp xmlheaders r
r r s , &% F FJvu 5 5 F - 8 $ $ x , , 776??D7;c(mmK -
&(9
!
774==r c t || \ }}| | | | | fS Nr[ )r` r r r )rp r r pus r
loadsrk sY ,BS T T TDAqFF4LLLGGIII 7799aoo'' ''r c t st t }t j d|d 5 }| | d d d n # 1 swxY w Y | S )Nwbr4 )modefileobj
compresslevel)gzipNotImplementedErrorr GzipFilert getvalue)rp r gzfs r
gzip_encoderv s "!! A
D!1 = = = $ ::<<s AA A @c t st t j dt | 5 } |dk r| }n| |dz }n # t
$ r t
d w xY wd d d n # 1 swxY w Y |dk r"t | |k rt
d |S )Nrbrn ro r r4 z invalid dataz#max gzipped payload length exceeded)rq rr rs r readOSErrorr9 r )rp
max_decoderu decodeds r
gzip_decoder ) s "!!
D'$-- 8 8 8 -C -A~~ ((** ((:>22 - - - ^,, , -
- - - - - - - - - - - - - - - Q3w<<*44>??? Ns( B3A)(B)BBBBc e Zd Z d Zd ZdS )GzipDecodedResponsec t st t | | _ t j | d| j d S )Nry rz )rq rr r r{ iors r )r" responses r
r z GzipDecodedResponse.__init__G sN &% %(--//**
t$ @@@@@r c t j | | j d S # | j w xY wr )rq rs r r r( s r
r zGzipDecodedResponse.closeO sD M % % % GMMOOOOODGMMOOOOs < AN)r r r r r r r r
r r C s: A A A r r c e Zd Zd Zd Zd ZdS )_Methodc " || _ || _ d S r
_Method__send
_Method__name)r" sendr s r
r z_Method.__init__\ s r c @ t | j | j d| S r> )r r r r@ s r
rA z_Method.__getattr___ s! t{t{{{DD$ABBBr c 8 | | j | S r r rC s r
rE z_Method.__call__a s {{4;---r NrF r r r
r r Y sD C C C. . . . .r r c p e Zd Z dez ZdZdZddddZddZdd Z d
Z
d Z d Z d
Z
d Zd Zd Zd ZdS ) TransportzPython-xmlrpc/%sTNFr )r! c f || _ || _ d| _ t | | _ g | _ d S N)NN)r _use_builtin_types _connectionr _headers_extra_headers)r" r r r! s r
r zTransport.__init__x s5 )"3 ' W
r c dD ]x} | |||| c S # t j j $ r |r Y 6t $ r7}|s*|j t
j t
j t
j fvr Y d }~qd }~ww xY wd S )N)r r4 ) single_requesthttpclientRemoteDisconnectedr| errno
ECONNRESET ECONNABORTEDEPIPE)r" hosthandler request_bodyverboser es r
requestzTransport.request s A
**4,PPPPP;1
(8%:L(- (5 5 55 5 5 5 5
s A9 A9-A44A9c | |||| }| }|j dk r || _ | | S n-# t
$ r t $ r | w xY w| dd r| t ||z |j |j t |
)N zcontent-lengthr ) send_request getresponsestatusr parse_responser. Exceptionr getheaderr{ r reasonr
getheaders)r" r r r r http_connresps r
r zTransport.single_request s
))$ wOOI ((**D{c!! & **4000 "
JJLLL >>*B / / IIKKK 7N K "" # # s AA *B c 8 t | j | j S rh )r` r r r( s r
r` zTransport.getparser s( d&8+/+BD D D Dr c | i }t |t r|\ }}t j | \ }}|rvt j | }t
j | d }d |
}dd|z fg}ng }|||fS )Nr r
AuthorizationzBasic ) rI rJ urllibparse
_splituserunquote_to_bytesr r rq r r )r" r x509auth
extra_headerss r
get_host_infozTransport.get_host_info s dE " " JD$\,,T22
d <0066D%d++227;;D774::<<((D (T/2 MM M]D((r c | j r || j d k r
| j d S | | \ }| _ }|t j | f| _ | j d S )Nr r4 )r r r r r HTTPConnectionr" r chostr s r
make_connectionzTransport.make_connection sw '(8(; ; ;#A& &+/+=+=d+C+C(t"D !;!;E!B!BB ""r c X | j \ }}|r d| _ | d S d S r )r r )r" r
connections r
r zTransport.close sA +j +D r c | | }| j | j z }|r| d | j r5t
r.| d|d | d n| d| | d | d| j f | || |
|| |S )Nr4 POSTT)skip_accept_encoding)zAccept-Encodingrq )z Content-Typeztext/xmlz
User-Agent) r r r set_debuglevelaccept_gzip_encodingrq
putrequestr
user_agent send_headers send_content)r" r r r debugr r! s r
r zTransport.send_request s ))$//
-$"55 ) % %a ( ( ( $ 3 3 ! !&' ! M M M NN6 7 7 7 7 ! !&' 2 2 23444 do6777 *g... *l333r c B |D ]\ }}| || d S r ) putheader)r" r r! keyvals r
r zTransport.send_headers s8 + +HC c * * * * + +r c & | j D| j t | k r,t r%| dd t | }| dt t | | | d S )NContent-Encodingrq zContent-Length)encode_thresholdr rq r rv rR
endheaders)r" r r s r
r zTransport.send_content s ! - !C $5$5 5 5
6 !3V < < <&|44L -s3|3D3D/E/EFFF l+++++r c t |d r-| dd dk rt | }n|}n|}| \ }} | d }|sn:| j r t
dt | | | R||ur| | | S )Nr r r rq r4 i zbody:)
rU r r r` r{ r printr r r )r" r streamri rj rp s r
r zTransport.parse_response1 s 8[ ) ) !!"4b99VCC,X66! F~~ 1 ;;t$$D
|
+gtDzz***
FF4LLL
! ! LLNNN wwyyr r6 )F)r r r __version__r r r r r r r` r r r r r r r r r r
r r j s ; $k1J
! ! ! ! ! !$ BD D D ) ) )4# # # .+ + + , , ," r r c 0 e Zd Z dddd fd Zd Z xZS )
SafeTransportFr Nr! contextc ^ t ||| || _ d S )Nr r r! )superr r )r" r r r! r r' s r
r zSafeTransport.__init__R s9
l+>>
C r c , t | j | S r )r _ServerProxy__requestr@ s r
rA zServerProxy.__getattr__ s t~t,,,r c ^ |dk r| j S |dk r| j S t d|d )Nr r z
Attribute z
not found)_ServerProxy__closer r )r" attrs r
rE zServerProxy.__call__ sE 7??<
[
# # n ?@@@r c | S r r r( s r
__enter__zServerProxy.__enter__ s r c . | d S r )r rC s r
__exit__zServerProxy.__exit__ s r )NNFFFF) r r r r r r r) rA rE r r r r r
r r z s * DIIN ' ' ' ' ' '>! ! ! $ - - -A A A r r __main__zhttp://localhost:8000ERROR r6 )NNNF)rw )Ur sysrK r decimalr http.clientr urllib.parser xml.parsersr r r r rq ImportErrorr version_infor r r PARSE_ERROR SERVER_ERRORAPPLICATION_ERROR SYSTEM_ERRORTRANSPORT_ERRORNOT_WELLFORMED_ERRORUNSUPPORTED_ENCODINGINVALID_ENCODING_CHARINVALID_XMLRPCMETHOD_NOT_FOUNDINVALID_METHOD_PARAMSINTERNAL_ERRORr r r r, r. r r
Booleanr7 r; rB rN rP ry r{ r} r r r r r r8 rH rO rb r\ r] r` r rk rv r rs r r r r r r Serverr rS r currentTimegetCurrentTimer multigetDatapowaddr r r r
r" s r(T
KKKK DDD # # # (!,, I E & E B B B B BE B B B '" Aq
4:: ;1 1 1 1 T%[[ ;2 2 2 2; ; ; 5 5 5P3 P3 P3 P3 P3 P3 P3 P3d 6 6 6!) !) !) !) !) !) !) !)F
f
$ $ $ $ $ $ $ $B`4 `4 `4 `4 `4 `4 `4 `4N}, }, }, }, }, }, }, },D 5 5 5 5 5 5 5 5D D D D D D D D R R R R R R R RJ 26 5 5 . N BF@ @ @ @V ( ( ( (,
0 4 4;$--V , . . . . . . . ."` ` ` ` ` ` ` `J# # # # #I # # #Ve e e e e e e eR
z
[0
1
1F
f //112222
gq
If E MMOOO IIaNNN IIaNNN H E(OOOO
gq' s? 8 AA"G; ;H HH%I? ?J JJ __init__.py 0000644 00000000046 15102763701 0006657 0 ustar 00 # This directory is a Python package.