forked from AFPy/python-docs-fr
1089 lines
36 KiB
Plaintext
1089 lines
36 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
|
# Copyright (C) 1990-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 2.7\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2016-10-30 10:44+0100\n"
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
|
"Language-Team: LANGUAGE <LL@li.org>\n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=UTF-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
|
|
#: ../Doc/library/urllib2.rst:2
|
|
msgid ":mod:`urllib2` --- extensible library for opening URLs"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:11
|
|
msgid ""
|
|
"The :mod:`urllib2` module has been split across several modules in Python 3 "
|
|
"named :mod:`urllib.request` and :mod:`urllib.error`. The :term:`2to3` tool "
|
|
"will automatically adapt imports when converting your sources to Python 3."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:17
|
|
msgid ""
|
|
"The :mod:`urllib2` module defines functions and classes which help in "
|
|
"opening URLs (mostly HTTP) in a complex world --- basic and digest "
|
|
"authentication, redirections, cookies and more."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:23
|
|
msgid ""
|
|
"The `Requests package <http://requests.readthedocs.org/>`_ is recommended "
|
|
"for a higher-level HTTP client interface."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:27
|
|
msgid "The :mod:`urllib2` module defines the following functions:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:32
|
|
msgid ""
|
|
"Open the URL *url*, which can be either a string or a :class:`Request` "
|
|
"object."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:34
|
|
msgid ""
|
|
"*data* may be a string specifying additional data to send to the server, or "
|
|
"``None`` if no such data is needed. Currently HTTP requests are the only "
|
|
"ones that use *data*; the HTTP request will be a POST instead of a GET when "
|
|
"the *data* parameter is provided. *data* should be a buffer in the "
|
|
"standard :mimetype:`application/x-www-form-urlencoded` format. The :func:"
|
|
"`urllib.urlencode` function takes a mapping or sequence of 2-tuples and "
|
|
"returns a string in this format. urllib2 module sends HTTP/1.1 requests with "
|
|
"``Connection:close`` header included."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:43
|
|
msgid ""
|
|
"The optional *timeout* parameter specifies a timeout in seconds for blocking "
|
|
"operations like the connection attempt (if not specified, the global default "
|
|
"timeout setting will be used). This actually only works for HTTP, HTTPS and "
|
|
"FTP connections."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:48
|
|
msgid ""
|
|
"If *context* is specified, it must be a :class:`ssl.SSLContext` instance "
|
|
"describing the various SSL options. See :class:`~httplib.HTTPSConnection` "
|
|
"for more details."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:52
|
|
msgid ""
|
|
"The optional *cafile* and *capath* parameters specify a set of trusted CA "
|
|
"certificates for HTTPS requests. *cafile* should point to a single file "
|
|
"containing a bundle of CA certificates, whereas *capath* should point to a "
|
|
"directory of hashed certificate files. More information can be found in :"
|
|
"meth:`ssl.SSLContext.load_verify_locations`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:58
|
|
msgid "The *cadefault* parameter is ignored."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:60
|
|
msgid "This function returns a file-like object with three additional methods:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:62
|
|
msgid ""
|
|
":meth:`geturl` --- return the URL of the resource retrieved, commonly used "
|
|
"to determine if a redirect was followed"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:65
|
|
msgid ""
|
|
":meth:`info` --- return the meta-information of the page, such as headers, "
|
|
"in the form of an :class:`mimetools.Message` instance (see `Quick Reference "
|
|
"to HTTP Headers <https://www.cs.tut.fi/~jkorpela/http.html>`_)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:69
|
|
msgid ":meth:`getcode` --- return the HTTP status code of the response."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:71
|
|
msgid "Raises :exc:`URLError` on errors."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:73
|
|
msgid ""
|
|
"Note that ``None`` may be returned if no handler handles the request (though "
|
|
"the default installed global :class:`OpenerDirector` uses :class:"
|
|
"`UnknownHandler` to ensure this never happens)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:77
|
|
msgid ""
|
|
"In addition, if proxy settings are detected (for example, when a ``*_proxy`` "
|
|
"environment variable like :envvar:`http_proxy` is set), :class:"
|
|
"`ProxyHandler` is default installed and makes sure the requests are handled "
|
|
"through the proxy."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:82 ../Doc/library/urllib2.rst:488
|
|
msgid "*timeout* was added."
|
|
msgstr "Ajout de *timeout*."
|
|
|
|
#: ../Doc/library/urllib2.rst:85
|
|
msgid "*cafile*, *capath*, *cadefault*, and *context* were added."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:91
|
|
msgid ""
|
|
"Install an :class:`OpenerDirector` instance as the default global opener. "
|
|
"Installing an opener is only necessary if you want urlopen to use that "
|
|
"opener; otherwise, simply call :meth:`OpenerDirector.open` instead of :func:"
|
|
"`urlopen`. The code does not check for a real :class:`OpenerDirector`, and "
|
|
"any class with the appropriate interface will work."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:100
|
|
msgid ""
|
|
"Return an :class:`OpenerDirector` instance, which chains the handlers in the "
|
|
"order given. *handler*\\s can be either instances of :class:`BaseHandler`, "
|
|
"or subclasses of :class:`BaseHandler` (in which case it must be possible to "
|
|
"call the constructor without any parameters). Instances of the following "
|
|
"classes will be in front of the *handler*\\s, unless the *handler*\\s "
|
|
"contain them, instances of them or subclasses of them: :class:`ProxyHandler` "
|
|
"(if proxy settings are detected), :class:`UnknownHandler`, :class:"
|
|
"`HTTPHandler`, :class:`HTTPDefaultErrorHandler`, :class:"
|
|
"`HTTPRedirectHandler`, :class:`FTPHandler`, :class:`FileHandler`, :class:"
|
|
"`HTTPErrorProcessor`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:111
|
|
msgid ""
|
|
"If the Python installation has SSL support (i.e., if the :mod:`ssl` module "
|
|
"can be imported), :class:`HTTPSHandler` will also be added."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:114
|
|
msgid ""
|
|
"Beginning in Python 2.3, a :class:`BaseHandler` subclass may also change "
|
|
"its :attr:`handler_order` attribute to modify its position in the handlers "
|
|
"list."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:118
|
|
msgid "The following exceptions are raised as appropriate:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:123
|
|
msgid ""
|
|
"The handlers raise this exception (or derived exceptions) when they run into "
|
|
"a problem. It is a subclass of :exc:`IOError`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:128
|
|
msgid ""
|
|
"The reason for this error. It can be a message string or another exception "
|
|
"instance (:exc:`socket.error` for remote URLs, :exc:`OSError` for local "
|
|
"URLs)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:135
|
|
msgid ""
|
|
"Though being an exception (a subclass of :exc:`URLError`), an :exc:"
|
|
"`HTTPError` can also function as a non-exceptional file-like return value "
|
|
"(the same thing that :func:`urlopen` returns). This is useful when handling "
|
|
"exotic HTTP errors, such as requests for authentication."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:142
|
|
msgid ""
|
|
"An HTTP status code as defined in `RFC 2616 <http://www.faqs.org/rfcs/"
|
|
"rfc2616.html>`_. This numeric value corresponds to a value found in the "
|
|
"dictionary of codes as found in :attr:`BaseHTTPServer.BaseHTTPRequestHandler."
|
|
"responses`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:148
|
|
msgid ""
|
|
"The reason for this error. It can be a message string or another exception "
|
|
"instance."
|
|
msgstr ""
|
|
"La raison de cette erreur. Il peut s'agir d'un message textuel ou d'une "
|
|
"autre instance d'exception."
|
|
|
|
#: ../Doc/library/urllib2.rst:151
|
|
msgid "The following classes are provided:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:156
|
|
msgid "This class is an abstraction of a URL request."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:158
|
|
msgid "*url* should be a string containing a valid URL."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:160
|
|
msgid ""
|
|
"*data* may be a string specifying additional data to send to the server, or "
|
|
"``None`` if no such data is needed. Currently HTTP requests are the only "
|
|
"ones that use *data*; the HTTP request will be a POST instead of a GET when "
|
|
"the *data* parameter is provided. *data* should be a buffer in the "
|
|
"standard :mimetype:`application/x-www-form-urlencoded` format. The :func:"
|
|
"`urllib.urlencode` function takes a mapping or sequence of 2-tuples and "
|
|
"returns a string in this format."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:168
|
|
msgid ""
|
|
"*headers* should be a dictionary, and will be treated as if :meth:"
|
|
"`add_header` was called with each key and value as arguments. This is often "
|
|
"used to \"spoof\" the ``User-Agent`` header value, which is used by a "
|
|
"browser to identify itself -- some HTTP servers only allow requests coming "
|
|
"from common browsers as opposed to scripts. For example, Mozilla Firefox "
|
|
"may identify itself as ``\"Mozilla/5.0 (X11; U; Linux i686) Gecko/20071127 "
|
|
"Firefox/2.0.0.11\"``, while :mod:`urllib2`'s default user agent string is ``"
|
|
"\"Python-urllib/2.6\"`` (on Python 2.6)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:176
|
|
msgid ""
|
|
"The final two arguments are only of interest for correct handling of third-"
|
|
"party HTTP cookies:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:179
|
|
msgid ""
|
|
"*origin_req_host* should be the request-host of the origin transaction, as "
|
|
"defined by :rfc:`2965`. It defaults to ``cookielib.request_host(self)``. "
|
|
"This is the host name or IP address of the original request that was "
|
|
"initiated by the user. For example, if the request is for an image in an "
|
|
"HTML document, this should be the request-host of the request for the page "
|
|
"containing the image."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:185
|
|
msgid ""
|
|
"*unverifiable* should indicate whether the request is unverifiable, as "
|
|
"defined by RFC 2965. It defaults to ``False``. An unverifiable request is "
|
|
"one whose URL the user did not have the option to approve. For example, if "
|
|
"the request is for an image in an HTML document, and the user had no option "
|
|
"to approve the automatic fetching of the image, this should be true."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:194
|
|
msgid ""
|
|
"The :class:`OpenerDirector` class opens URLs via :class:`BaseHandler`\\ s "
|
|
"chained together. It manages the chaining of handlers, and recovery from "
|
|
"errors."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:200
|
|
msgid ""
|
|
"This is the base class for all registered handlers --- and handles only the "
|
|
"simple mechanics of registration."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:206
|
|
msgid ""
|
|
"A class which defines a default handler for HTTP error responses; all "
|
|
"responses are turned into :exc:`HTTPError` exceptions."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:212
|
|
msgid "A class to handle redirections."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:217
|
|
msgid "A class to handle HTTP Cookies."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:222
|
|
msgid ""
|
|
"Cause requests to go through a proxy. If *proxies* is given, it must be a "
|
|
"dictionary mapping protocol names to URLs of proxies. The default is to read "
|
|
"the list of proxies from the environment variables :envvar:"
|
|
"`<protocol>_proxy`. If no proxy environment variables are set, then in a "
|
|
"Windows environment proxy settings are obtained from the registry's Internet "
|
|
"Settings section, and in a Mac OS X environment proxy information is "
|
|
"retrieved from the OS X System Configuration Framework."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:230
|
|
msgid "To disable autodetected proxy pass an empty dictionary."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:234
|
|
msgid ""
|
|
"``HTTP_PROXY`` will be ignored if a variable ``REQUEST_METHOD`` is set; see "
|
|
"the documentation on :func:`~urllib.getproxies`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:240
|
|
msgid "Keep a database of ``(realm, uri) -> (user, password)`` mappings."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:245
|
|
msgid ""
|
|
"Keep a database of ``(realm, uri) -> (user, password)`` mappings. A realm "
|
|
"of ``None`` is considered a catch-all realm, which is searched if no other "
|
|
"realm fits."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:252 ../Doc/library/urllib2.rst:277
|
|
msgid ""
|
|
"This is a mixin class that helps with HTTP authentication, both to the "
|
|
"remote host and to a proxy. *password_mgr*, if given, should be something "
|
|
"that is compatible with :class:`HTTPPasswordMgr`; refer to section :ref:"
|
|
"`http-password-mgr` for information on the interface that must be supported."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:261 ../Doc/library/urllib2.rst:286
|
|
msgid ""
|
|
"Handle authentication with the remote host. *password_mgr*, if given, should "
|
|
"be something that is compatible with :class:`HTTPPasswordMgr`; refer to "
|
|
"section :ref:`http-password-mgr` for information on the interface that must "
|
|
"be supported."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:269 ../Doc/library/urllib2.rst:294
|
|
msgid ""
|
|
"Handle authentication with the proxy. *password_mgr*, if given, should be "
|
|
"something that is compatible with :class:`HTTPPasswordMgr`; refer to "
|
|
"section :ref:`http-password-mgr` for information on the interface that must "
|
|
"be supported."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:302
|
|
msgid "A class to handle opening of HTTP URLs."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:307
|
|
msgid ""
|
|
"A class to handle opening of HTTPS URLs. *context* has the same meaning as "
|
|
"for :class:`httplib.HTTPSConnection`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:310
|
|
msgid "*context* added."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:316
|
|
msgid "Open local files."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:321
|
|
msgid "Open FTP URLs."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:326
|
|
msgid ""
|
|
"Open FTP URLs, keeping a cache of open FTP connections to minimize delays."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:331
|
|
msgid "A catch-all class to handle unknown URLs."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:336 ../Doc/library/urllib2.rst:936
|
|
msgid "Process HTTP error responses."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:342
|
|
msgid "Request Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:344
|
|
msgid ""
|
|
"The following methods describe all of :class:`Request`'s public interface, "
|
|
"and so all must be overridden in subclasses."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:350
|
|
msgid ""
|
|
"Set the :class:`Request` data to *data*. This is ignored by all handlers "
|
|
"except HTTP handlers --- and there it should be a byte string, and will "
|
|
"change the request to be ``POST`` rather than ``GET``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:357
|
|
msgid ""
|
|
"Return a string indicating the HTTP request method. This is only meaningful "
|
|
"for HTTP requests, and currently always returns ``'GET'`` or ``'POST'``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:363
|
|
msgid "Return whether the instance has a non-\\ ``None`` data."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:368
|
|
msgid "Return the instance's data."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:373
|
|
msgid ""
|
|
"Add another header to the request. Headers are currently ignored by all "
|
|
"handlers except HTTP handlers, where they are added to the list of headers "
|
|
"sent to the server. Note that there cannot be more than one header with the "
|
|
"same name, and later calls will overwrite previous calls in case the *key* "
|
|
"collides. Currently, this is no loss of HTTP functionality, since all "
|
|
"headers which have meaning when used more than once have a (header-specific) "
|
|
"way of gaining the same functionality using only one header."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:384
|
|
msgid "Add a header that will not be added to a redirected request."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:391
|
|
msgid ""
|
|
"Return whether the instance has the named header (checks both regular and "
|
|
"unredirected)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:399
|
|
msgid "Return the URL given in the constructor."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:404
|
|
msgid "Return the type of the URL --- also known as the scheme."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:409
|
|
msgid "Return the host to which a connection will be made."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:414
|
|
msgid "Return the selector --- the part of the URL that is sent to the server."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:419
|
|
msgid ""
|
|
"Return the value of the given header. If the header is not present, return "
|
|
"the default value."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:425
|
|
msgid ""
|
|
"Return a list of tuples (header_name, header_value) of the Request headers."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:430
|
|
msgid ""
|
|
"Prepare the request by connecting to a proxy server. The *host* and *type* "
|
|
"will replace those of the instance, and the instance's selector will be the "
|
|
"original URL given in the constructor."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:437
|
|
msgid ""
|
|
"Return the request-host of the origin transaction, as defined by :rfc:"
|
|
"`2965`. See the documentation for the :class:`Request` constructor."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:443
|
|
msgid ""
|
|
"Return whether the request is unverifiable, as defined by RFC 2965. See the "
|
|
"documentation for the :class:`Request` constructor."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:450
|
|
msgid "OpenerDirector Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:452
|
|
msgid ":class:`OpenerDirector` instances have the following methods:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:457
|
|
msgid ""
|
|
"*handler* should be an instance of :class:`BaseHandler`. The following "
|
|
"methods are searched, and added to the possible chains (note that HTTP "
|
|
"errors are a special case)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:461
|
|
msgid ""
|
|
":samp:`{protocol}_open` --- signal that the handler knows how to open "
|
|
"*protocol* URLs."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:464
|
|
msgid ""
|
|
":samp:`http_error_{type}` --- signal that the handler knows how to handle "
|
|
"HTTP errors with HTTP error code *type*."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:467
|
|
msgid ""
|
|
":samp:`{protocol}_error` --- signal that the handler knows how to handle "
|
|
"errors from (non-\\ ``http``) *protocol*."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:470
|
|
msgid ""
|
|
":samp:`{protocol}_request` --- signal that the handler knows how to pre-"
|
|
"process *protocol* requests."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:473
|
|
msgid ""
|
|
":samp:`{protocol}_response` --- signal that the handler knows how to post-"
|
|
"process *protocol* responses."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:479
|
|
msgid ""
|
|
"Open the given *url* (which can be a request object or a string), optionally "
|
|
"passing the given *data*. Arguments, return values and exceptions raised are "
|
|
"the same as those of :func:`urlopen` (which simply calls the :meth:`open` "
|
|
"method on the currently installed global :class:`OpenerDirector`). The "
|
|
"optional *timeout* parameter specifies a timeout in seconds for blocking "
|
|
"operations like the connection attempt (if not specified, the global default "
|
|
"timeout setting will be used). The timeout feature actually works only for "
|
|
"HTTP, HTTPS and FTP connections)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:494
|
|
msgid ""
|
|
"Handle an error of the given protocol. This will call the registered error "
|
|
"handlers for the given protocol with the given arguments (which are protocol "
|
|
"specific). The HTTP protocol is a special case which uses the HTTP response "
|
|
"code to determine the specific error handler; refer to the :meth:`http_error_"
|
|
"\\*` methods of the handler classes."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:500
|
|
msgid ""
|
|
"Return values and exceptions raised are the same as those of :func:`urlopen`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:502
|
|
msgid "OpenerDirector objects open URLs in three stages:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:504
|
|
msgid ""
|
|
"The order in which these methods are called within each stage is determined "
|
|
"by sorting the handler instances."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:507
|
|
msgid ""
|
|
"Every handler with a method named like :samp:`{protocol}_request` has that "
|
|
"method called to pre-process the request."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:510
|
|
msgid ""
|
|
"Handlers with a method named like :samp:`{protocol}_open` are called to "
|
|
"handle the request. This stage ends when a handler either returns a non-\\ :"
|
|
"const:`None` value (ie. a response), or raises an exception (usually :exc:"
|
|
"`URLError`). Exceptions are allowed to propagate."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:515
|
|
msgid ""
|
|
"In fact, the above algorithm is first tried for methods named :meth:"
|
|
"`default_open`. If all such methods return :const:`None`, the algorithm is "
|
|
"repeated for methods named like :samp:`{protocol}_open`. If all such "
|
|
"methods return :const:`None`, the algorithm is repeated for methods named :"
|
|
"meth:`unknown_open`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:521
|
|
msgid ""
|
|
"Note that the implementation of these methods may involve calls of the "
|
|
"parent :class:`OpenerDirector` instance's :meth:`~OpenerDirector.open` and :"
|
|
"meth:`~OpenerDirector.error` methods."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:525
|
|
msgid ""
|
|
"Every handler with a method named like :samp:`{protocol}_response` has that "
|
|
"method called to post-process the response."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:532
|
|
msgid "BaseHandler Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:534
|
|
msgid ""
|
|
":class:`BaseHandler` objects provide a couple of methods that are directly "
|
|
"useful, and others that are meant to be used by derived classes. These are "
|
|
"intended for direct use:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:541
|
|
msgid "Add a director as parent."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:546
|
|
msgid "Remove any parents."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:548
|
|
msgid ""
|
|
"The following attributes and methods should only be used by classes derived "
|
|
"from :class:`BaseHandler`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:553
|
|
msgid ""
|
|
"The convention has been adopted that subclasses defining :meth:"
|
|
"`protocol_request` or :meth:`protocol_response` methods are named :class:`"
|
|
"\\*Processor`; all others are named :class:`\\*Handler`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:560
|
|
msgid ""
|
|
"A valid :class:`OpenerDirector`, which can be used to open using a different "
|
|
"protocol, or handle errors."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:566
|
|
msgid ""
|
|
"This method is *not* defined in :class:`BaseHandler`, but subclasses should "
|
|
"define it if they want to catch all URLs."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:569
|
|
msgid ""
|
|
"This method, if implemented, will be called by the parent :class:"
|
|
"`OpenerDirector`. It should return a file-like object as described in the "
|
|
"return value of the :meth:`open` of :class:`OpenerDirector`, or ``None``. It "
|
|
"should raise :exc:`URLError`, unless a truly exceptional thing happens (for "
|
|
"example, :exc:`MemoryError` should not be mapped to :exc:`URLError`)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:575
|
|
msgid "This method will be called before any protocol-specific open method."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:581 ../Doc/library/urllib2.rst:632
|
|
#: ../Doc/library/urllib2.rst:645 ../Doc/library/urllib2.rst:734
|
|
msgid "(\"protocol\" is to be replaced by the protocol name.)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:583
|
|
msgid ""
|
|
"This method is *not* defined in :class:`BaseHandler`, but subclasses should "
|
|
"define it if they want to handle URLs with the given *protocol*."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:586
|
|
msgid ""
|
|
"This method, if defined, will be called by the parent :class:"
|
|
"`OpenerDirector`. Return values should be the same as for :meth:"
|
|
"`default_open`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:592
|
|
msgid ""
|
|
"This method is *not* defined in :class:`BaseHandler`, but subclasses should "
|
|
"define it if they want to catch all URLs with no specific registered handler "
|
|
"to open it."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:596
|
|
msgid ""
|
|
"This method, if implemented, will be called by the :attr:`parent` :class:"
|
|
"`OpenerDirector`. Return values should be the same as for :meth:"
|
|
"`default_open`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:603
|
|
msgid ""
|
|
"This method is *not* defined in :class:`BaseHandler`, but subclasses should "
|
|
"override it if they intend to provide a catch-all for otherwise unhandled "
|
|
"HTTP errors. It will be called automatically by the :class:"
|
|
"`OpenerDirector` getting the error, and should not normally be called in "
|
|
"other circumstances."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:608
|
|
msgid ""
|
|
"*req* will be a :class:`Request` object, *fp* will be a file-like object "
|
|
"with the HTTP error body, *code* will be the three-digit code of the error, "
|
|
"*msg* will be the user-visible explanation of the code and *hdrs* will be a "
|
|
"mapping object with the headers of the error."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:613
|
|
msgid ""
|
|
"Return values and exceptions raised should be the same as those of :func:"
|
|
"`urlopen`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:619
|
|
msgid ""
|
|
"*nnn* should be a three-digit HTTP error code. This method is also not "
|
|
"defined in :class:`BaseHandler`, but will be called, if it exists, on an "
|
|
"instance of a subclass, when an HTTP error with code *nnn* occurs."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:623
|
|
msgid "Subclasses should override this method to handle specific HTTP errors."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:625
|
|
msgid ""
|
|
"Arguments, return values and exceptions raised should be the same as for :"
|
|
"meth:`http_error_default`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:634
|
|
msgid ""
|
|
"This method is *not* defined in :class:`BaseHandler`, but subclasses should "
|
|
"define it if they want to pre-process requests of the given *protocol*."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:637
|
|
msgid ""
|
|
"This method, if defined, will be called by the parent :class:"
|
|
"`OpenerDirector`. *req* will be a :class:`Request` object. The return value "
|
|
"should be a :class:`Request` object."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:647
|
|
msgid ""
|
|
"This method is *not* defined in :class:`BaseHandler`, but subclasses should "
|
|
"define it if they want to post-process responses of the given *protocol*."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:650
|
|
msgid ""
|
|
"This method, if defined, will be called by the parent :class:"
|
|
"`OpenerDirector`. *req* will be a :class:`Request` object. *response* will "
|
|
"be an object implementing the same interface as the return value of :func:"
|
|
"`urlopen`. The return value should implement the same interface as the "
|
|
"return value of :func:`urlopen`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:660
|
|
msgid "HTTPRedirectHandler Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:664
|
|
msgid ""
|
|
"Some HTTP redirections require action from this module's client code. If "
|
|
"this is the case, :exc:`HTTPError` is raised. See :rfc:`2616` for details "
|
|
"of the precise meanings of the various redirection codes."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:671
|
|
msgid ""
|
|
"Return a :class:`Request` or ``None`` in response to a redirect. This is "
|
|
"called by the default implementations of the :meth:`http_error_30\\*` "
|
|
"methods when a redirection is received from the server. If a redirection "
|
|
"should take place, return a new :class:`Request` to allow :meth:"
|
|
"`http_error_30\\*` to perform the redirect to *newurl*. Otherwise, raise :"
|
|
"exc:`HTTPError` if no other handler should try to handle this URL, or return "
|
|
"``None`` if you can't but another handler might."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:681
|
|
msgid ""
|
|
"The default implementation of this method does not strictly follow :rfc:"
|
|
"`2616`, which says that 301 and 302 responses to ``POST`` requests must not "
|
|
"be automatically redirected without confirmation by the user. In reality, "
|
|
"browsers do allow automatic redirection of these responses, changing the "
|
|
"POST to a ``GET``, and the default implementation reproduces this behavior."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:690
|
|
msgid ""
|
|
"Redirect to the ``Location:`` or ``URI:`` URL. This method is called by the "
|
|
"parent :class:`OpenerDirector` when getting an HTTP 'moved permanently' "
|
|
"response."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:696
|
|
msgid ""
|
|
"The same as :meth:`http_error_301`, but called for the 'found' response."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:701
|
|
msgid ""
|
|
"The same as :meth:`http_error_301`, but called for the 'see other' response."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:706
|
|
msgid ""
|
|
"The same as :meth:`http_error_301`, but called for the 'temporary redirect' "
|
|
"response."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:713
|
|
msgid "HTTPCookieProcessor Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:717
|
|
msgid ":class:`HTTPCookieProcessor` instances have one attribute:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:722
|
|
msgid "The :class:`cookielib.CookieJar` in which cookies are stored."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:728
|
|
msgid "ProxyHandler Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:736
|
|
msgid ""
|
|
"The :class:`ProxyHandler` will have a method :samp:`{protocol}_open` for "
|
|
"every *protocol* which has a proxy in the *proxies* dictionary given in the "
|
|
"constructor. The method will modify requests to go through the proxy, by "
|
|
"calling ``request.set_proxy()``, and call the next handler in the chain to "
|
|
"actually execute the protocol."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:746
|
|
msgid "HTTPPasswordMgr Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:748
|
|
msgid ""
|
|
"These methods are available on :class:`HTTPPasswordMgr` and :class:"
|
|
"`HTTPPasswordMgrWithDefaultRealm` objects."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:754
|
|
msgid ""
|
|
"*uri* can be either a single URI, or a sequence of URIs. *realm*, *user* and "
|
|
"*passwd* must be strings. This causes ``(user, passwd)`` to be used as "
|
|
"authentication tokens when authentication for *realm* and a super-URI of any "
|
|
"of the given URIs is given."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:762
|
|
msgid ""
|
|
"Get user/password for given realm and URI, if any. This method will return "
|
|
"``(None, None)`` if there is no matching user/password."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:765
|
|
msgid ""
|
|
"For :class:`HTTPPasswordMgrWithDefaultRealm` objects, the realm ``None`` "
|
|
"will be searched if the given *realm* has no matching user/password."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:772
|
|
msgid "AbstractBasicAuthHandler Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:777
|
|
msgid ""
|
|
"Handle an authentication request by getting a user/password pair, and re-"
|
|
"trying the request. *authreq* should be the name of the header where the "
|
|
"information about the realm is included in the request, *host* specifies the "
|
|
"URL and path to authenticate for, *req* should be the (failed) :class:"
|
|
"`Request` object, and *headers* should be the error headers."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:783
|
|
msgid ""
|
|
"*host* is either an authority (e.g. ``\"python.org\"``) or a URL containing "
|
|
"an authority component (e.g. ``\"http://python.org/\"``). In either case, "
|
|
"the authority must not contain a userinfo component (so, ``\"python.org\"`` "
|
|
"and ``\"python.org:80\"`` are fine, ``\"joe:password@python.org\"`` is not)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:792
|
|
msgid "HTTPBasicAuthHandler Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:797 ../Doc/library/urllib2.rst:808
|
|
#: ../Doc/library/urllib2.rst:833 ../Doc/library/urllib2.rst:844
|
|
msgid "Retry the request with authentication information, if available."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:803
|
|
msgid "ProxyBasicAuthHandler Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:814
|
|
msgid "AbstractDigestAuthHandler Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:819
|
|
msgid ""
|
|
"*authreq* should be the name of the header where the information about the "
|
|
"realm is included in the request, *host* should be the host to authenticate "
|
|
"to, *req* should be the (failed) :class:`Request` object, and *headers* "
|
|
"should be the error headers."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:828
|
|
msgid "HTTPDigestAuthHandler Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:839
|
|
msgid "ProxyDigestAuthHandler Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:850
|
|
msgid "HTTPHandler Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:855
|
|
msgid ""
|
|
"Send an HTTP request, which can be either GET or POST, depending on ``req."
|
|
"has_data()``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:862
|
|
msgid "HTTPSHandler Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:867
|
|
msgid ""
|
|
"Send an HTTPS request, which can be either GET or POST, depending on ``req."
|
|
"has_data()``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:874
|
|
msgid "FileHandler Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:879
|
|
msgid ""
|
|
"Open the file locally, if there is no host name, or the host name is "
|
|
"``'localhost'``. Change the protocol to ``ftp`` otherwise, and retry opening "
|
|
"it using :attr:`parent`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:887
|
|
msgid "FTPHandler Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:892
|
|
msgid ""
|
|
"Open the FTP file indicated by *req*. The login is always done with empty "
|
|
"username and password."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:899
|
|
msgid "CacheFTPHandler Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:901
|
|
msgid ""
|
|
":class:`CacheFTPHandler` objects are :class:`FTPHandler` objects with the "
|
|
"following additional methods:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:907
|
|
msgid "Set timeout of connections to *t* seconds."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:912
|
|
msgid "Set maximum number of cached connections to *m*."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:918
|
|
msgid "UnknownHandler Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:923
|
|
msgid "Raise a :exc:`URLError` exception."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:929
|
|
msgid "HTTPErrorProcessor Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:938
|
|
msgid "For 200 error codes, the response object is returned immediately."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:940
|
|
msgid ""
|
|
"For non-200 error codes, this simply passes the job on to the :samp:"
|
|
"`{protocol}_error_code` handler methods, via :meth:`OpenerDirector.error`. "
|
|
"Eventually, :class:`urllib2.HTTPDefaultErrorHandler` will raise an :exc:"
|
|
"`HTTPError` if no other handler handles the error."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:948
|
|
msgid "Process HTTPS error responses."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:950
|
|
msgid "The behavior is same as :meth:`http_response`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:956
|
|
msgid "Examples"
|
|
msgstr "Exemples"
|
|
|
|
#: ../Doc/library/urllib2.rst:958
|
|
msgid ""
|
|
"In addition to the examples below, more examples are given in :ref:`urllib-"
|
|
"howto`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:961
|
|
msgid ""
|
|
"This example gets the python.org main page and displays the first 100 bytes "
|
|
"of it::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:970
|
|
msgid ""
|
|
"Here we are sending a data-stream to the stdin of a CGI and reading the data "
|
|
"it returns to us. Note that this example will only work when the Python "
|
|
"installation supports SSL. ::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:981
|
|
msgid "The code for the sample CGI used in the above example is::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:988
|
|
msgid "Use of Basic HTTP Authentication::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:1002
|
|
msgid ""
|
|
":func:`build_opener` provides many handlers by default, including a :class:"
|
|
"`ProxyHandler`. By default, :class:`ProxyHandler` uses the environment "
|
|
"variables named ``<scheme>_proxy``, where ``<scheme>`` is the URL scheme "
|
|
"involved. For example, the :envvar:`http_proxy` environment variable is "
|
|
"read to obtain the HTTP proxy's URL."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:1008
|
|
msgid ""
|
|
"This example replaces the default :class:`ProxyHandler` with one that uses "
|
|
"programmatically-supplied proxy URLs, and adds proxy authorization support "
|
|
"with :class:`ProxyBasicAuthHandler`. ::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:1020
|
|
msgid "Adding HTTP headers:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:1022
|
|
msgid "Use the *headers* argument to the :class:`Request` constructor, or::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:1031
|
|
msgid ""
|
|
":class:`OpenerDirector` automatically adds a :mailheader:`User-Agent` header "
|
|
"to every :class:`Request`. To change this::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib2.rst:1039
|
|
msgid ""
|
|
"Also, remember that a few standard headers (:mailheader:`Content-Length`, :"
|
|
"mailheader:`Content-Type` and :mailheader:`Host`) are added when the :class:"
|
|
"`Request` is passed to :func:`urlopen` (or :meth:`OpenerDirector.open`)."
|
|
msgstr ""
|