# Copyright (C) 2001-2018, Python Software Foundation # For licence information, see README file. # msgid "" msgstr "" "Project-Id-Version: Python 3\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2023-01-15 22:33+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: FRENCH \n" "Language: fr\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #: library/xmlrpc.client.rst:2 msgid ":mod:`xmlrpc.client` --- XML-RPC client access" msgstr "" #: library/xmlrpc.client.rst:10 msgid "**Source code:** :source:`Lib/xmlrpc/client.py`" msgstr "**Source code:** :source:`Lib/xmlrpc/client.py`" #: library/xmlrpc.client.rst:17 msgid "" "XML-RPC is a Remote Procedure Call method that uses XML passed via HTTP(S) " "as a transport. With it, a client can call methods with parameters on a " "remote server (the server is named by a URI) and get back structured data. " "This module supports writing XML-RPC client code; it handles all the details " "of translating between conformable Python objects and XML on the wire." msgstr "" #: library/xmlrpc.client.rst:26 #, fuzzy msgid "" "The :mod:`xmlrpc.client` module is not secure against maliciously " "constructed data. If you need to parse untrusted or unauthenticated data " "see :ref:`xml-vulnerabilities`." msgstr "" "Le module :mod:`xml.sax` n'est pas sécurisé contre les données construites " "de façon malveillante. Si vous avez besoin d'analyser des données non " "sécurisées ou non authentifiées, voir :ref:`xml-vulnerabilities`." #: library/xmlrpc.client.rst:32 msgid "" "For HTTPS URIs, :mod:`xmlrpc.client` now performs all the necessary " "certificate and hostname checks by default." msgstr "" #: includes/wasm-notavail.rst:None msgid ":ref:`Availability `: not Emscripten, not WASI." msgstr "" #: includes/wasm-notavail.rst:5 msgid "" "This module does not work or is not available on WebAssembly platforms " "``wasm32-emscripten`` and ``wasm32-wasi``. See :ref:`wasm-availability` for " "more information." msgstr "" #: library/xmlrpc.client.rst:41 msgid "" "A :class:`ServerProxy` instance is an object that manages communication with " "a remote XML-RPC server. The required first argument is a URI (Uniform " "Resource Indicator), and will normally be the URL of the server. The " "optional second argument is a transport factory instance; by default it is " "an internal :class:`SafeTransport` instance for https: URLs and an internal " "HTTP :class:`Transport` instance otherwise. The optional third argument is " "an encoding, by default UTF-8. The optional fourth argument is a debugging " "flag." msgstr "" #: library/xmlrpc.client.rst:49 msgid "" "The following parameters govern the use of the returned proxy instance. If " "*allow_none* is true, the Python constant ``None`` will be translated into " "XML; the default behaviour is for ``None`` to raise a :exc:`TypeError`. This " "is a commonly used extension to the XML-RPC specification, but isn't " "supported by all clients and servers; see `http://ontosys.com/xml-rpc/" "extensions.php `_ for a description. The *use_builtin_types* " "flag can be used to cause date/time values to be presented as :class:" "`datetime.datetime` objects and binary data to be presented as :class:" "`bytes` objects; this flag is false by default. :class:`datetime.datetime`, :" "class:`bytes` and :class:`bytearray` objects may be passed to calls. The " "*headers* parameter is an optional sequence of HTTP headers to send with " "each request, expressed as a sequence of 2-tuples representing the header " "name and value. (e.g. ``[('Header-Name', 'value')]``). The obsolete " "*use_datetime* flag is similar to *use_builtin_types* but it applies only to " "date/time values." msgstr "" #: library/xmlrpc.client.rst:548 msgid "The *use_builtin_types* flag was added." msgstr "" #: library/xmlrpc.client.rst:70 msgid "The *headers* parameter was added." msgstr "" #: library/xmlrpc.client.rst:73 msgid "" "Both the HTTP and HTTPS transports support the URL syntax extension for HTTP " "Basic Authentication: ``http://user:pass@host:port/path``. The ``user:" "pass`` portion will be base64-encoded as an HTTP 'Authorization' header, and " "sent to the remote server as part of the connection process when invoking an " "XML-RPC method. You only need to use this if the remote server requires a " "Basic Authentication user and password. If an HTTPS URL is provided, " "*context* may be :class:`ssl.SSLContext` and configures the SSL settings of " "the underlying HTTPS connection." msgstr "" #: library/xmlrpc.client.rst:82 msgid "" "The returned instance is a proxy object with methods that can be used to " "invoke corresponding RPC calls on the remote server. If the remote server " "supports the introspection API, the proxy can also be used to query the " "remote server for the methods it supports (service discovery) and fetch " "other server-associated metadata." msgstr "" #: library/xmlrpc.client.rst:88 msgid "" "Types that are conformable (e.g. that can be marshalled through XML), " "include the following (and except where noted, they are unmarshalled as the " "same Python type):" msgstr "" #: library/xmlrpc.client.rst:95 msgid "XML-RPC type" msgstr "" #: library/xmlrpc.client.rst:95 msgid "Python type" msgstr "Type Python" #: library/xmlrpc.client.rst:97 msgid "``boolean``" msgstr "``boolean``" #: library/xmlrpc.client.rst:97 #, fuzzy msgid ":class:`bool`" msgstr ":class:`c_bool`" #: library/xmlrpc.client.rst:99 msgid "``int``, ``i1``, ``i2``, ``i4``, ``i8`` or ``biginteger``" msgstr "" #: library/xmlrpc.client.rst:99 msgid "" ":class:`int` in range from -2147483648 to 2147483647. Values get the " "```` tag." msgstr "" #: library/xmlrpc.client.rst:104 msgid "``double`` or ``float``" msgstr "" #: library/xmlrpc.client.rst:104 msgid ":class:`float`. Values get the ```` tag." msgstr "" #: library/xmlrpc.client.rst:107 msgid "``string``" msgstr "" #: library/xmlrpc.client.rst:107 msgid ":class:`str`" msgstr ":class:`str`" #: library/xmlrpc.client.rst:109 msgid "``array``" msgstr "" #: library/xmlrpc.client.rst:109 msgid "" ":class:`list` or :class:`tuple` containing conformable elements. Arrays are " "returned as :class:`lists `." msgstr "" #: library/xmlrpc.client.rst:113 msgid "``struct``" msgstr "" #: library/xmlrpc.client.rst:113 msgid "" ":class:`dict`. Keys must be strings, values may be any conformable type. " "Objects of user-defined classes can be passed in; only their :attr:`~object." "__dict__` attribute is transmitted." msgstr "" #: library/xmlrpc.client.rst:118 msgid "``dateTime.iso8601``" msgstr "" #: library/xmlrpc.client.rst:118 msgid "" ":class:`DateTime` or :class:`datetime.datetime`. Returned type depends on " "values of *use_builtin_types* and *use_datetime* flags." msgstr "" #: library/xmlrpc.client.rst:122 msgid "``base64``" msgstr "" #: library/xmlrpc.client.rst:122 msgid "" ":class:`Binary`, :class:`bytes` or :class:`bytearray`. Returned type " "depends on the value of the *use_builtin_types* flag." msgstr "" #: library/xmlrpc.client.rst:126 msgid "``nil``" msgstr "" #: library/xmlrpc.client.rst:126 msgid "" "The ``None`` constant. Passing is allowed only if *allow_none* is true." msgstr "" #: library/xmlrpc.client.rst:129 msgid "``bigdecimal``" msgstr "" #: library/xmlrpc.client.rst:129 msgid ":class:`decimal.Decimal`. Returned type only." msgstr "" #: library/xmlrpc.client.rst:132 msgid "" "This is the full set of data types supported by XML-RPC. Method calls may " "also raise a special :exc:`Fault` instance, used to signal XML-RPC server " "errors, or :exc:`ProtocolError` used to signal an error in the HTTP/HTTPS " "transport layer. Both :exc:`Fault` and :exc:`ProtocolError` derive from a " "base class called :exc:`Error`. Note that the xmlrpc client module " "currently does not marshal instances of subclasses of built-in types." msgstr "" #: library/xmlrpc.client.rst:139 msgid "" "When passing strings, characters special to XML such as ``<``, ``>``, and " "``&`` will be automatically escaped. However, it's the caller's " "responsibility to ensure that the string is free of characters that aren't " "allowed in XML, such as the control characters with ASCII values between 0 " "and 31 (except, of course, tab, newline and carriage return); failing to do " "this will result in an XML-RPC request that isn't well-formed XML. If you " "have to pass arbitrary bytes via XML-RPC, use :class:`bytes` or :class:" "`bytearray` classes or the :class:`Binary` wrapper class described below." msgstr "" #: library/xmlrpc.client.rst:148 msgid "" ":class:`Server` is retained as an alias for :class:`ServerProxy` for " "backwards compatibility. New code should use :class:`ServerProxy`." msgstr "" #: library/xmlrpc.client.rst:151 msgid "Added the *context* argument." msgstr "" #: library/xmlrpc.client.rst:154 msgid "" "Added support of type tags with prefixes (e.g. ``ex:nil``). Added support of " "unmarshalling additional types used by Apache XML-RPC implementation for " "numerics: ``i1``, ``i2``, ``i8``, ``biginteger``, ``float`` and " "``bigdecimal``. See https://ws.apache.org/xmlrpc/types.html for a " "description." msgstr "" #: library/xmlrpc.client.rst:166 msgid "`XML-RPC HOWTO `_" msgstr "" #: library/xmlrpc.client.rst:165 msgid "" "A good description of XML-RPC operation and client software in several " "languages. Contains pretty much everything an XML-RPC client developer needs " "to know." msgstr "" #: library/xmlrpc.client.rst:169 msgid "" "`XML-RPC Introspection `_" msgstr "" #: library/xmlrpc.client.rst:169 msgid "Describes the XML-RPC protocol extension for introspection." msgstr "" #: library/xmlrpc.client.rst:171 msgid "`XML-RPC Specification `_" msgstr "" #: library/xmlrpc.client.rst:172 msgid "The official specification." msgstr "" #: library/xmlrpc.client.rst:177 msgid "ServerProxy Objects" msgstr "" #: library/xmlrpc.client.rst:179 msgid "" "A :class:`ServerProxy` instance has a method corresponding to each remote " "procedure call accepted by the XML-RPC server. Calling the method performs " "an RPC, dispatched by both name and argument signature (e.g. the same method " "name can be overloaded with multiple argument signatures). The RPC finishes " "by returning a value, which may be either returned data in a conformant type " "or a :class:`Fault` or :class:`ProtocolError` object indicating an error." msgstr "" #: library/xmlrpc.client.rst:186 msgid "" "Servers that support the XML introspection API support some common methods " "grouped under the reserved :attr:`~ServerProxy.system` attribute:" msgstr "" #: library/xmlrpc.client.rst:192 msgid "" "This method returns a list of strings, one for each (non-system) method " "supported by the XML-RPC server." msgstr "" #: library/xmlrpc.client.rst:198 msgid "" "This method takes one parameter, the name of a method implemented by the XML-" "RPC server. It returns an array of possible signatures for this method. A " "signature is an array of types. The first of these types is the return type " "of the method, the rest are parameters." msgstr "" #: library/xmlrpc.client.rst:203 msgid "" "Because multiple signatures (ie. overloading) is permitted, this method " "returns a list of signatures rather than a singleton." msgstr "" #: library/xmlrpc.client.rst:206 msgid "" "Signatures themselves are restricted to the top level parameters expected by " "a method. For instance if a method expects one array of structs as a " "parameter, and it returns a string, its signature is simply \"string, " "array\". If it expects three integers and returns a string, its signature is " "\"string, int, int, int\"." msgstr "" #: library/xmlrpc.client.rst:211 msgid "" "If no signature is defined for the method, a non-array value is returned. In " "Python this means that the type of the returned value will be something " "other than list." msgstr "" #: library/xmlrpc.client.rst:218 msgid "" "This method takes one parameter, the name of a method implemented by the XML-" "RPC server. It returns a documentation string describing the use of that " "method. If no such string is available, an empty string is returned. The " "documentation string may contain HTML markup." msgstr "" #: library/xmlrpc.client.rst:225 msgid "" "Instances of :class:`ServerProxy` support the :term:`context manager` " "protocol for closing the underlying transport." msgstr "" #: library/xmlrpc.client.rst:275 msgid "A working example follows. The server code::" msgstr "" #: library/xmlrpc.client.rst:290 library/xmlrpc.client.rst:506 msgid "The client code for the preceding server::" msgstr "" #: library/xmlrpc.client.rst:252 msgid "DateTime Objects" msgstr "Objets DateTime" #: library/xmlrpc.client.rst:256 msgid "" "This class may be initialized with seconds since the epoch, a time tuple, an " "ISO 8601 time/date string, or a :class:`datetime.datetime` instance. It has " "the following methods, supported mainly for internal use by the marshalling/" "unmarshalling code:" msgstr "" #: library/xmlrpc.client.rst:264 msgid "Accept a string as the instance's new time value." msgstr "" #: library/xmlrpc.client.rst:269 msgid "" "Write the XML-RPC encoding of this :class:`DateTime` item to the *out* " "stream object." msgstr "" #: library/xmlrpc.client.rst:272 msgid "" "It also supports certain of Python's built-in operators through rich " "comparison and :meth:`__repr__` methods." msgstr "" #: library/xmlrpc.client.rst:305 msgid "Binary Objects" msgstr "" #: library/xmlrpc.client.rst:309 msgid "" "This class may be initialized from bytes data (which may include NULs). The " "primary access to the content of a :class:`Binary` object is provided by an " "attribute:" msgstr "" #: library/xmlrpc.client.rst:316 msgid "" "The binary data encapsulated by the :class:`Binary` instance. The data is " "provided as a :class:`bytes` object." msgstr "" #: library/xmlrpc.client.rst:319 msgid "" ":class:`Binary` objects have the following methods, supported mainly for " "internal use by the marshalling/unmarshalling code:" msgstr "" #: library/xmlrpc.client.rst:325 msgid "" "Accept a base64 :class:`bytes` object and decode it as the instance's new " "data." msgstr "" #: library/xmlrpc.client.rst:330 msgid "" "Write the XML-RPC base 64 encoding of this binary item to the *out* stream " "object." msgstr "" #: library/xmlrpc.client.rst:332 msgid "" "The encoded data will have newlines every 76 characters as per :rfc:`RFC " "2045 section 6.8 <2045#section-6.8>`, which was the de facto standard base64 " "specification when the XML-RPC spec was written." msgstr "" #: library/xmlrpc.client.rst:337 msgid "" "It also supports certain of Python's built-in operators through :meth:" "`__eq__` and :meth:`__ne__` methods." msgstr "" #: library/xmlrpc.client.rst:340 msgid "" "Example usage of the binary objects. We're going to transfer an image over " "XMLRPC::" msgstr "" #: library/xmlrpc.client.rst:356 msgid "The client gets the image and saves it to a file::" msgstr "" #: library/xmlrpc.client.rst:367 msgid "Fault Objects" msgstr "" #: library/xmlrpc.client.rst:371 msgid "" "A :class:`Fault` object encapsulates the content of an XML-RPC fault tag. " "Fault objects have the following attributes:" msgstr "" #: library/xmlrpc.client.rst:377 msgid "An int indicating the fault type." msgstr "" #: library/xmlrpc.client.rst:382 msgid "A string containing a diagnostic message associated with the fault." msgstr "" #: library/xmlrpc.client.rst:384 msgid "" "In the following example we're going to intentionally cause a :exc:`Fault` " "by returning a complex type object. The server code::" msgstr "" #: library/xmlrpc.client.rst:417 msgid "ProtocolError Objects" msgstr "" #: library/xmlrpc.client.rst:421 msgid "" "A :class:`ProtocolError` object describes a protocol error in the underlying " "transport layer (such as a 404 'not found' error if the server named by the " "URI does not exist). It has the following attributes:" msgstr "" #: library/xmlrpc.client.rst:428 msgid "The URI or URL that triggered the error." msgstr "" #: library/xmlrpc.client.rst:433 msgid "The error code." msgstr "" #: library/xmlrpc.client.rst:438 msgid "The error message or diagnostic string." msgstr "" #: library/xmlrpc.client.rst:443 msgid "" "A dict containing the headers of the HTTP/HTTPS request that triggered the " "error." msgstr "" #: library/xmlrpc.client.rst:446 msgid "" "In the following example we're going to intentionally cause a :exc:" "`ProtocolError` by providing an invalid URI::" msgstr "" #: library/xmlrpc.client.rst:464 msgid "MultiCall Objects" msgstr "" #: library/xmlrpc.client.rst:466 msgid "" "The :class:`MultiCall` object provides a way to encapsulate multiple calls " "to a remote server into a single request [#]_." msgstr "" #: library/xmlrpc.client.rst:472 msgid "" "Create an object used to boxcar method calls. *server* is the eventual " "target of the call. Calls can be made to the result object, but they will " "immediately return ``None``, and only store the call name and parameters in " "the :class:`MultiCall` object. Calling the object itself causes all stored " "calls to be transmitted as a single ``system.multicall`` request. The result " "of this call is a :term:`generator`; iterating over this generator yields " "the individual results." msgstr "" #: library/xmlrpc.client.rst:480 msgid "A usage example of this class follows. The server code::" msgstr "" #: library/xmlrpc.client.rst:522 msgid "Convenience Functions" msgstr "" #: library/xmlrpc.client.rst:526 msgid "" "Convert *params* into an XML-RPC request. or into a response if " "*methodresponse* is true. *params* can be either a tuple of arguments or an " "instance of the :exc:`Fault` exception class. If *methodresponse* is true, " "only a single value can be returned, meaning that *params* must be of length " "1. *encoding*, if supplied, is the encoding to use in the generated XML; the " "default is UTF-8. Python's :const:`None` value cannot be used in standard " "XML-RPC; to allow using it via an extension, provide a true value for " "*allow_none*." msgstr "" #: library/xmlrpc.client.rst:537 msgid "" "Convert an XML-RPC request or response into Python objects, a ``(params, " "methodname)``. *params* is a tuple of argument; *methodname* is a string, " "or ``None`` if no method name is present in the packet. If the XML-RPC " "packet represents a fault condition, this function will raise a :exc:`Fault` " "exception. The *use_builtin_types* flag can be used to cause date/time " "values to be presented as :class:`datetime.datetime` objects and binary data " "to be presented as :class:`bytes` objects; this flag is false by default." msgstr "" #: library/xmlrpc.client.rst:545 msgid "" "The obsolete *use_datetime* flag is similar to *use_builtin_types* but it " "applies only to date/time values." msgstr "" #: library/xmlrpc.client.rst:555 msgid "Example of Client Usage" msgstr "" #: library/xmlrpc.client.rst:572 msgid "" "To access an XML-RPC server through a HTTP proxy, you need to define a " "custom transport. The following example shows how::" msgstr "" #: library/xmlrpc.client.rst:597 msgid "Example of Client and Server Usage" msgstr "" #: library/xmlrpc.client.rst:599 msgid "See :ref:`simplexmlrpcserver-example`." msgstr "" #: library/xmlrpc.client.rst:603 msgid "Footnotes" msgstr "Notes" #: library/xmlrpc.client.rst:604 msgid "" "This approach has been first presented in `a discussion on xmlrpc.com " "`_." msgstr ""