2016-10-30 09:46:26 +00:00
|
|
|
|
# SOME DESCRIPTIVE TITLE.
|
|
|
|
|
|
# Copyright (C) 2001-2016, Python Software Foundation
|
|
|
|
|
|
# This file is distributed under the same license as the Python package.
|
|
|
|
|
|
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
|
|
|
|
|
|
#
|
|
|
|
|
|
#, fuzzy
|
|
|
|
|
|
msgid ""
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
"Project-Id-Version: Python 3.6\n"
|
|
|
|
|
|
"Report-Msgid-Bugs-To: \n"
|
2017-04-02 20:14:06 +00:00
|
|
|
|
"POT-Creation-Date: 2017-04-02 22:11+0200\n"
|
2016-10-30 09:46:26 +00:00
|
|
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|
|
|
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
|
|
|
|
|
"Language-Team: LANGUAGE <LL@li.org>\n"
|
2017-04-02 20:14:06 +00:00
|
|
|
|
"Language: \n"
|
2016-10-30 09:46:26 +00:00
|
|
|
|
"MIME-Version: 1.0\n"
|
|
|
|
|
|
"Content-Type: text/plain; charset=UTF-8\n"
|
|
|
|
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:2
|
|
|
|
|
|
msgid ":mod:`xmlrpc.server` --- Basic XML-RPC servers"
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:10
|
|
|
|
|
|
msgid "**Source code:** :source:`Lib/xmlrpc/server.py`"
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:14
|
|
|
|
|
|
msgid ""
|
|
|
|
|
|
"The :mod:`xmlrpc.server` module provides a basic server framework for XML-"
|
|
|
|
|
|
"RPC servers written in Python. Servers can either be free standing, using :"
|
|
|
|
|
|
"class:`SimpleXMLRPCServer`, or embedded in a CGI environment, using :class:"
|
|
|
|
|
|
"`CGIXMLRPCRequestHandler`."
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:22
|
|
|
|
|
|
msgid ""
|
|
|
|
|
|
"The :mod:`xmlrpc.server` module is not secure against maliciously "
|
|
|
|
|
|
"constructed data. If you need to parse untrusted or unauthenticated data "
|
|
|
|
|
|
"see :ref:`xml-vulnerabilities`."
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:31
|
|
|
|
|
|
msgid ""
|
|
|
|
|
|
"Create a new server instance. This class provides methods for registration "
|
|
|
|
|
|
"of functions that can be called by the XML-RPC protocol. The "
|
|
|
|
|
|
"*requestHandler* parameter should be a factory for request handler "
|
|
|
|
|
|
"instances; it defaults to :class:`SimpleXMLRPCRequestHandler`. The *addr* "
|
|
|
|
|
|
"and *requestHandler* parameters are passed to the :class:`socketserver."
|
|
|
|
|
|
"TCPServer` constructor. If *logRequests* is true (the default), requests "
|
|
|
|
|
|
"will be logged; setting this parameter to false will turn off logging. The "
|
|
|
|
|
|
"*allow_none* and *encoding* parameters are passed on to :mod:`xmlrpc.client` "
|
|
|
|
|
|
"and control the XML-RPC responses that will be returned from the server. The "
|
|
|
|
|
|
"*bind_and_activate* parameter controls whether :meth:`server_bind` and :meth:"
|
|
|
|
|
|
"`server_activate` are called immediately by the constructor; it defaults to "
|
|
|
|
|
|
"true. Setting it to false allows code to manipulate the "
|
|
|
|
|
|
"*allow_reuse_address* class variable before the address is bound. The "
|
|
|
|
|
|
"*use_builtin_types* parameter is passed to the :func:`~xmlrpc.client.loads` "
|
|
|
|
|
|
"function and controls which types are processed when date/times values or "
|
|
|
|
|
|
"binary data are received; it defaults to false."
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:47 ../Doc/library/xmlrpc.server.rst:61
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:330
|
|
|
|
|
|
msgid "The *use_builtin_types* flag was added."
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:54
|
|
|
|
|
|
msgid ""
|
|
|
|
|
|
"Create a new instance to handle XML-RPC requests in a CGI environment. The "
|
|
|
|
|
|
"*allow_none* and *encoding* parameters are passed on to :mod:`xmlrpc.client` "
|
|
|
|
|
|
"and control the XML-RPC responses that will be returned from the server. The "
|
|
|
|
|
|
"*use_builtin_types* parameter is passed to the :func:`~xmlrpc.client.loads` "
|
|
|
|
|
|
"function and controls which types are processed when date/times values or "
|
|
|
|
|
|
"binary data are received; it defaults to false."
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:67
|
|
|
|
|
|
msgid ""
|
|
|
|
|
|
"Create a new request handler instance. This request handler supports "
|
|
|
|
|
|
"``POST`` requests and modifies logging so that the *logRequests* parameter "
|
|
|
|
|
|
"to the :class:`SimpleXMLRPCServer` constructor parameter is honored."
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:75
|
|
|
|
|
|
msgid "SimpleXMLRPCServer Objects"
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:77
|
|
|
|
|
|
msgid ""
|
|
|
|
|
|
"The :class:`SimpleXMLRPCServer` class is based on :class:`socketserver."
|
|
|
|
|
|
"TCPServer` and provides a means of creating simple, stand alone XML-RPC "
|
|
|
|
|
|
"servers."
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:84
|
|
|
|
|
|
msgid ""
|
|
|
|
|
|
"Register a function that can respond to XML-RPC requests. If *name* is "
|
|
|
|
|
|
"given, it will be the method name associated with *function*, otherwise "
|
|
|
|
|
|
"``function.__name__`` will be used. *name* can be either a normal or "
|
|
|
|
|
|
"Unicode string, and may contain characters not legal in Python identifiers, "
|
|
|
|
|
|
"including the period character."
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:93
|
|
|
|
|
|
msgid ""
|
|
|
|
|
|
"Register an object which is used to expose method names which have not been "
|
|
|
|
|
|
"registered using :meth:`register_function`. If *instance* contains a :meth:"
|
|
|
|
|
|
"`_dispatch` method, it is called with the requested method name and the "
|
|
|
|
|
|
"parameters from the request. Its API is ``def _dispatch(self, method, "
|
|
|
|
|
|
"params)`` (note that *params* does not represent a variable argument list). "
|
|
|
|
|
|
"If it calls an underlying function to perform its task, that function is "
|
|
|
|
|
|
"called as ``func(*params)``, expanding the parameter list. The return value "
|
|
|
|
|
|
"from :meth:`_dispatch` is returned to the client as the result. If "
|
|
|
|
|
|
"*instance* does not have a :meth:`_dispatch` method, it is searched for an "
|
|
|
|
|
|
"attribute matching the name of the requested method."
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:104
|
|
|
|
|
|
msgid ""
|
|
|
|
|
|
"If the optional *allow_dotted_names* argument is true and the instance does "
|
|
|
|
|
|
"not have a :meth:`_dispatch` method, then if the requested method name "
|
|
|
|
|
|
"contains periods, each component of the method name is searched for "
|
|
|
|
|
|
"individually, with the effect that a simple hierarchical search is "
|
|
|
|
|
|
"performed. The value found from this search is then called with the "
|
|
|
|
|
|
"parameters from the request, and the return value is passed back to the "
|
|
|
|
|
|
"client."
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:113
|
|
|
|
|
|
msgid ""
|
|
|
|
|
|
"Enabling the *allow_dotted_names* option 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."
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:120
|
|
|
|
|
|
msgid ""
|
|
|
|
|
|
"Registers the XML-RPC introspection functions ``system.listMethods``, "
|
|
|
|
|
|
"``system.methodHelp`` and ``system.methodSignature``."
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:126
|
|
|
|
|
|
msgid "Registers the XML-RPC multicall function system.multicall."
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:131
|
|
|
|
|
|
msgid ""
|
|
|
|
|
|
"An attribute value that must be a tuple listing valid path portions of the "
|
|
|
|
|
|
"URL for receiving XML-RPC requests. Requests posted to other paths will "
|
|
|
|
|
|
"result in a 404 \"no such page\" HTTP error. If this tuple is empty, all "
|
|
|
|
|
|
"paths will be considered valid. The default value is ``('/', '/RPC2')``."
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:140
|
|
|
|
|
|
msgid "SimpleXMLRPCServer Example"
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:141
|
|
|
|
|
|
msgid "Server code::"
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:175
|
|
|
|
|
|
msgid ""
|
|
|
|
|
|
"The following client code will call the methods made available by the "
|
|
|
|
|
|
"preceding server::"
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:188
|
|
|
|
|
|
msgid ""
|
|
|
|
|
|
"The following example included in the :file:`Lib/xmlrpc/server.py` module "
|
|
|
|
|
|
"shows a server allowing dotted names and registering a multicall function."
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:193
|
|
|
|
|
|
msgid ""
|
|
|
|
|
|
"Enabling the *allow_dotted_names* option allows intruders to access your "
|
|
|
|
|
|
"module's global variables and may allow intruders to execute arbitrary code "
|
|
|
|
|
|
"on your machine. Only use this example only within a secure, closed network."
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:222
|
|
|
|
|
|
msgid "This ExampleService demo can be invoked from the command line::"
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:227
|
|
|
|
|
|
msgid ""
|
|
|
|
|
|
"The client that interacts with the above server is included in `Lib/xmlrpc/"
|
|
|
|
|
|
"client.py`::"
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:247
|
|
|
|
|
|
msgid ""
|
|
|
|
|
|
"This client which interacts with the demo XMLRPC server can be invoked as::"
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:253
|
|
|
|
|
|
msgid "CGIXMLRPCRequestHandler"
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:255
|
|
|
|
|
|
msgid ""
|
|
|
|
|
|
"The :class:`CGIXMLRPCRequestHandler` class can be used to handle XML-RPC "
|
|
|
|
|
|
"requests sent to Python CGI scripts."
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:261
|
|
|
|
|
|
msgid ""
|
|
|
|
|
|
"Register a function that can respond to XML-RPC requests. If *name* is "
|
|
|
|
|
|
"given, it will be the method name associated with function, otherwise "
|
|
|
|
|
|
"*function.__name__* will be used. *name* can be either a normal or Unicode "
|
|
|
|
|
|
"string, and may contain characters not legal in Python identifiers, "
|
|
|
|
|
|
"including the period character."
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:270
|
|
|
|
|
|
msgid ""
|
|
|
|
|
|
"Register an object which is used to expose method names which have not been "
|
|
|
|
|
|
"registered using :meth:`register_function`. If instance contains a :meth:"
|
|
|
|
|
|
"`_dispatch` method, it is called with the requested method name and the "
|
|
|
|
|
|
"parameters from the request; the return value is returned to the client as "
|
|
|
|
|
|
"the result. If instance does not have a :meth:`_dispatch` method, it is "
|
|
|
|
|
|
"searched for an attribute matching the name of the requested method; if the "
|
|
|
|
|
|
"requested method name contains periods, each component of the method name "
|
|
|
|
|
|
"is searched for individually, with the effect that a simple hierarchical "
|
|
|
|
|
|
"search is performed. The value found from this search is then called with "
|
|
|
|
|
|
"the parameters from the request, and the return value is passed back to "
|
|
|
|
|
|
"the client."
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:284
|
|
|
|
|
|
msgid ""
|
|
|
|
|
|
"Register the XML-RPC introspection functions ``system.listMethods``, "
|
|
|
|
|
|
"``system.methodHelp`` and ``system.methodSignature``."
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:290
|
|
|
|
|
|
msgid "Register the XML-RPC multicall function ``system.multicall``."
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:295
|
|
|
|
|
|
msgid ""
|
|
|
|
|
|
"Handle an XML-RPC request. If *request_text* is given, it should be the POST "
|
|
|
|
|
|
"data provided by the HTTP server, otherwise the contents of stdin will be "
|
|
|
|
|
|
"used."
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:298
|
|
|
|
|
|
msgid "Example::"
|
|
|
|
|
|
msgstr "Exemples ::"
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:314
|
|
|
|
|
|
msgid "Documenting XMLRPC server"
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:316
|
|
|
|
|
|
msgid ""
|
|
|
|
|
|
"These classes extend the above classes to serve HTML documentation in "
|
|
|
|
|
|
"response to HTTP GET requests. Servers can either be free standing, using :"
|
|
|
|
|
|
"class:`DocXMLRPCServer`, or embedded in a CGI environment, using :class:"
|
|
|
|
|
|
"`DocCGIXMLRPCRequestHandler`."
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:326
|
|
|
|
|
|
msgid ""
|
|
|
|
|
|
"Create a new server instance. All parameters have the same meaning as for :"
|
|
|
|
|
|
"class:`SimpleXMLRPCServer`; *requestHandler* defaults to :class:"
|
|
|
|
|
|
"`DocXMLRPCRequestHandler`."
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:336
|
|
|
|
|
|
msgid "Create a new instance to handle XML-RPC requests in a CGI environment."
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:341
|
|
|
|
|
|
msgid ""
|
|
|
|
|
|
"Create a new request handler instance. This request handler supports XML-RPC "
|
|
|
|
|
|
"POST requests, documentation GET requests, and modifies logging so that the "
|
|
|
|
|
|
"*logRequests* parameter to the :class:`DocXMLRPCServer` constructor "
|
|
|
|
|
|
"parameter is honored."
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:350
|
|
|
|
|
|
msgid "DocXMLRPCServer Objects"
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:352
|
|
|
|
|
|
msgid ""
|
|
|
|
|
|
"The :class:`DocXMLRPCServer` class is derived from :class:"
|
|
|
|
|
|
"`SimpleXMLRPCServer` and provides a means of creating self-documenting, "
|
|
|
|
|
|
"stand alone XML-RPC servers. HTTP POST requests are handled as XML-RPC "
|
|
|
|
|
|
"method calls. HTTP GET requests are handled by generating pydoc-style HTML "
|
|
|
|
|
|
"documentation. This allows a server to provide its own web-based "
|
|
|
|
|
|
"documentation."
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:361 ../Doc/library/xmlrpc.server.rst:389
|
|
|
|
|
|
msgid ""
|
|
|
|
|
|
"Set the title used in the generated HTML documentation. This title will be "
|
|
|
|
|
|
"used inside the HTML \"title\" element."
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:367 ../Doc/library/xmlrpc.server.rst:395
|
|
|
|
|
|
msgid ""
|
|
|
|
|
|
"Set the name used in the generated HTML documentation. This name will appear "
|
|
|
|
|
|
"at the top of the generated documentation inside a \"h1\" element."
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:373 ../Doc/library/xmlrpc.server.rst:401
|
|
|
|
|
|
msgid ""
|
|
|
|
|
|
"Set the description used in the generated HTML documentation. This "
|
|
|
|
|
|
"description will appear as a paragraph, below the server name, in the "
|
|
|
|
|
|
"documentation."
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:378
|
|
|
|
|
|
msgid "DocCGIXMLRPCRequestHandler"
|
|
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
|
|
|
|
#: ../Doc/library/xmlrpc.server.rst:380
|
|
|
|
|
|
msgid ""
|
|
|
|
|
|
"The :class:`DocCGIXMLRPCRequestHandler` class is derived from :class:"
|
|
|
|
|
|
"`CGIXMLRPCRequestHandler` and provides a means of creating self-documenting, "
|
|
|
|
|
|
"XML-RPC CGI scripts. HTTP POST requests are handled as XML-RPC method calls. "
|
|
|
|
|
|
"HTTP GET requests are handled by generating pydoc-style HTML documentation. "
|
|
|
|
|
|
"This allows a server to provide its own web-based documentation."
|
|
|
|
|
|
msgstr ""
|
