Rietveld Code Review Tool
Help | Bug tracker | Discussion group | Source code | Sign in
(77803)

Side by Side Diff: Doc/library/xmlrpc.client.rst

Issue 22417: PEP 476: verify HTTPS certificates by default
Patch Set: Created 4 years, 7 months ago
Left:
Right:
Use n/p to move between diff chunks; N/P to move between comments. Please Sign in to add in-line comments.
Jump to:
View unified diff | Download patch
OLDNEW
1 :mod:`xmlrpc.client` --- XML-RPC client access 1 :mod:`xmlrpc.client` --- XML-RPC client access
2 ============================================== 2 ==============================================
3 3
4 .. module:: xmlrpc.client 4 .. module:: xmlrpc.client
5 :synopsis: XML-RPC client access. 5 :synopsis: XML-RPC client access.
6 .. moduleauthor:: Fredrik Lundh <fredrik@pythonware.com> 6 .. moduleauthor:: Fredrik Lundh <fredrik@pythonware.com>
7 .. sectionauthor:: Eric S. Raymond <esr@snark.thyrsus.com> 7 .. sectionauthor:: Eric S. Raymond <esr@snark.thyrsus.com>
8 8
9 9
10 .. XXX Not everything is documented yet. It might be good to describe 10 .. XXX Not everything is documented yet. It might be good to describe
11 Marshaller, Unmarshaller, getparser and Transport. 11 Marshaller, Unmarshaller, getparser and Transport.
12 12
13 **Source code:** :source:`Lib/xmlrpc/client.py` 13 **Source code:** :source:`Lib/xmlrpc/client.py`
14 14
15 -------------- 15 --------------
16 16
17 XML-RPC is a Remote Procedure Call method that uses XML passed via HTTP as a 17 XML-RPC is a Remote Procedure Call method that uses XML passed via HTTP as a
18 transport. With it, a client can call methods with parameters on a remote 18 transport. With it, a client can call methods with parameters on a remote
19 server (the server is named by a URI) and get back structured data. This module 19 server (the server is named by a URI) and get back structured data. This module
20 supports writing XML-RPC client code; it handles all the details of translating 20 supports writing XML-RPC client code; it handles all the details of translating
21 between conformable Python objects and XML on the wire. 21 between conformable Python objects and XML on the wire.
22 22
23 23
24 .. warning:: 24 .. warning::
25 25
26 The :mod:`xmlrpc.client` module is not secure against maliciously 26 The :mod:`xmlrpc.client` module is not secure against maliciously
27 constructed data. If you need to parse untrusted or unauthenticated data see 27 constructed data. If you need to parse untrusted or unauthenticated data see
28 :ref:`xml-vulnerabilities`. 28 :ref:`xml-vulnerabilities`.
29
30 .. warning::
AntoinePitrou 2014/10/30 20:06:39 "versionchanged" here as well?
31
32 In the case of https URIs, :mod:`xmlrpc.client` does not do any verification
33 of the server's certificate.
34 29
35 30
36 .. class:: ServerProxy(uri, transport=None, encoding=None, verbose=False, \ 31 .. class:: ServerProxy(uri, transport=None, encoding=None, verbose=False, \
37 allow_none=False, use_datetime=False, \ 32 allow_none=False, use_datetime=False, \
38 use_builtin_types=False) 33 use_builtin_types=False)
39 34
40 .. versionchanged:: 3.3 35 .. versionchanged:: 3.3
41 The *use_builtin_types* flag was added. 36 The *use_builtin_types* flag was added.
42 37
43 A :class:`ServerProxy` instance is an object that manages communication with a 38 A :class:`ServerProxy` instance is an object that manages communication with a
(...skipping 526 matching lines...) Expand 10 before | Expand all | Expand 10 after
570 See :ref:`simplexmlrpcserver-example`. 565 See :ref:`simplexmlrpcserver-example`.
571 566
572 567
573 .. rubric:: Footnotes 568 .. rubric:: Footnotes
574 569
575 .. [#] This approach has been first presented in `a discussion on xmlrpc.com 570 .. [#] This approach has been first presented in `a discussion on xmlrpc.com
576 <http://web.archive.org/web/20060624230303/http://www.xmlrpc.com/discuss/msgR eader$1208?mode=topic>`_. 571 <http://web.archive.org/web/20060624230303/http://www.xmlrpc.com/discuss/msgR eader$1208?mode=topic>`_.
577 .. the link now points to webarchive since the one at 572 .. the link now points to webarchive since the one at
578 .. http://www.xmlrpc.com/discuss/msgReader%241208 is broken (and webadmin 573 .. http://www.xmlrpc.com/discuss/msgReader%241208 is broken (and webadmin
579 .. doesn't reply) 574 .. doesn't reply)
OLDNEW

RSS Feeds Recent Issues | This issue
This is Rietveld 894c83f36cb7+