forked from AFPy/python-docs-fr
796 lines
28 KiB
Plaintext
796 lines
28 KiB
Plaintext
# 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"
|
|
"POT-Creation-Date: 2017-05-27 19:40+0200\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"
|
|
"Language: fr\n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=UTF-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
|
|
#: ../Doc/library/urllib.parse.rst:2
|
|
msgid ":mod:`urllib.parse` --- Parse URLs into components"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:7
|
|
msgid "**Source code:** :source:`Lib/urllib/parse.py`"
|
|
msgstr "**Code source :** :source:`Lib/urllib/parse.py`"
|
|
|
|
#: ../Doc/library/urllib.parse.rst:18
|
|
msgid ""
|
|
"This module defines a standard interface to break Uniform Resource Locator "
|
|
"(URL) strings up in components (addressing scheme, network location, path "
|
|
"etc.), to combine the components back into a URL string, and to convert a "
|
|
"\"relative URL\" to an absolute URL given a \"base URL.\""
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:23
|
|
msgid ""
|
|
"The module has been designed to match the Internet RFC on Relative Uniform "
|
|
"Resource Locators. It supports the following URL schemes: ``file``, ``ftp``, "
|
|
"``gopher``, ``hdl``, ``http``, ``https``, ``imap``, ``mailto``, ``mms``, "
|
|
"``news``, ``nntp``, ``prospero``, ``rsync``, ``rtsp``, ``rtspu``, ``sftp``, "
|
|
"``shttp``, ``sip``, ``sips``, ``snews``, ``svn``, ``svn+ssh``, ``telnet``, "
|
|
"``wais``, ``ws``, ``wss``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:30
|
|
msgid ""
|
|
"The :mod:`urllib.parse` module defines functions that fall into two broad "
|
|
"categories: URL parsing and URL quoting. These are covered in detail in the "
|
|
"following sections."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:35
|
|
msgid "URL Parsing"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:37
|
|
msgid ""
|
|
"The URL parsing functions focus on splitting a URL string into its "
|
|
"components, or on combining URL components into a URL string."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:42
|
|
msgid ""
|
|
"Parse a URL into six components, returning a 6-tuple. This corresponds to "
|
|
"the general structure of a URL: ``scheme://netloc/path;parameters?"
|
|
"query#fragment``. Each tuple item is a string, possibly empty. The "
|
|
"components are not broken up in smaller parts (for example, the network "
|
|
"location is a single string), and % escapes are not expanded. The delimiters "
|
|
"as shown above are not part of the result, except for a leading slash in the "
|
|
"*path* component, which is retained if present. For example:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:62
|
|
msgid ""
|
|
"Following the syntax specifications in :rfc:`1808`, urlparse recognizes a "
|
|
"netloc only if it is properly introduced by '//'. Otherwise the input is "
|
|
"presumed to be a relative URL and thus to start with a path component."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:78
|
|
msgid ""
|
|
"The *scheme* argument gives the default addressing scheme, to be used only "
|
|
"if the URL does not specify one. It should be the same type (text or bytes) "
|
|
"as *urlstring*, except that the default value ``''`` is always allowed, and "
|
|
"is automatically converted to ``b''`` if appropriate."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:83
|
|
msgid ""
|
|
"If the *allow_fragments* argument is false, fragment identifiers are not "
|
|
"recognized. Instead, they are parsed as part of the path, parameters or "
|
|
"query component, and :attr:`fragment` is set to the empty string in the "
|
|
"return value."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:88 ../Doc/library/urllib.parse.rst:212
|
|
#: ../Doc/library/urllib.parse.rst:300
|
|
msgid ""
|
|
"The return value is actually an instance of a subclass of :class:`tuple`. "
|
|
"This class has the following additional read-only convenience attributes:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:92 ../Doc/library/urllib.parse.rst:216
|
|
#: ../Doc/library/urllib.parse.rst:304
|
|
msgid "Attribute"
|
|
msgstr "Attribut"
|
|
|
|
#: ../Doc/library/urllib.parse.rst:92 ../Doc/library/urllib.parse.rst:216
|
|
#: ../Doc/library/urllib.parse.rst:304
|
|
msgid "Index"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:92 ../Doc/library/urllib.parse.rst:216
|
|
#: ../Doc/library/urllib.parse.rst:304
|
|
msgid "Value"
|
|
msgstr "Valeur"
|
|
|
|
#: ../Doc/library/urllib.parse.rst:92 ../Doc/library/urllib.parse.rst:216
|
|
#: ../Doc/library/urllib.parse.rst:304
|
|
msgid "Value if not present"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:94 ../Doc/library/urllib.parse.rst:218
|
|
msgid ":attr:`scheme`"
|
|
msgstr ":attr:`scheme`"
|
|
|
|
#: ../Doc/library/urllib.parse.rst:94 ../Doc/library/urllib.parse.rst:218
|
|
#: ../Doc/library/urllib.parse.rst:306
|
|
msgid "0"
|
|
msgstr "0"
|
|
|
|
#: ../Doc/library/urllib.parse.rst:94 ../Doc/library/urllib.parse.rst:218
|
|
msgid "URL scheme specifier"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:94 ../Doc/library/urllib.parse.rst:218
|
|
msgid "*scheme* parameter"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:96 ../Doc/library/urllib.parse.rst:220
|
|
msgid ":attr:`netloc`"
|
|
msgstr ":attr:`netloc`"
|
|
|
|
#: ../Doc/library/urllib.parse.rst:96 ../Doc/library/urllib.parse.rst:220
|
|
#: ../Doc/library/urllib.parse.rst:308
|
|
msgid "1"
|
|
msgstr "1"
|
|
|
|
#: ../Doc/library/urllib.parse.rst:96 ../Doc/library/urllib.parse.rst:220
|
|
msgid "Network location part"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:96 ../Doc/library/urllib.parse.rst:98
|
|
#: ../Doc/library/urllib.parse.rst:100 ../Doc/library/urllib.parse.rst:103
|
|
#: ../Doc/library/urllib.parse.rst:105 ../Doc/library/urllib.parse.rst:220
|
|
#: ../Doc/library/urllib.parse.rst:222 ../Doc/library/urllib.parse.rst:224
|
|
#: ../Doc/library/urllib.parse.rst:226 ../Doc/library/urllib.parse.rst:306
|
|
#: ../Doc/library/urllib.parse.rst:308
|
|
msgid "empty string"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:98 ../Doc/library/urllib.parse.rst:222
|
|
msgid ":attr:`path`"
|
|
msgstr ":attr:`path`"
|
|
|
|
#: ../Doc/library/urllib.parse.rst:98 ../Doc/library/urllib.parse.rst:222
|
|
msgid "2"
|
|
msgstr "2"
|
|
|
|
#: ../Doc/library/urllib.parse.rst:98 ../Doc/library/urllib.parse.rst:222
|
|
msgid "Hierarchical path"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:100
|
|
msgid ":attr:`params`"
|
|
msgstr ":attr:`params`"
|
|
|
|
#: ../Doc/library/urllib.parse.rst:100 ../Doc/library/urllib.parse.rst:224
|
|
msgid "3"
|
|
msgstr "3"
|
|
|
|
#: ../Doc/library/urllib.parse.rst:100
|
|
msgid "Parameters for last path element"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:103 ../Doc/library/urllib.parse.rst:224
|
|
msgid ":attr:`query`"
|
|
msgstr ":attr:`query`"
|
|
|
|
#: ../Doc/library/urllib.parse.rst:103 ../Doc/library/urllib.parse.rst:226
|
|
msgid "4"
|
|
msgstr "4"
|
|
|
|
#: ../Doc/library/urllib.parse.rst:103 ../Doc/library/urllib.parse.rst:224
|
|
msgid "Query component"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:105 ../Doc/library/urllib.parse.rst:226
|
|
#: ../Doc/library/urllib.parse.rst:308
|
|
msgid ":attr:`fragment`"
|
|
msgstr ":attr:`fragment`"
|
|
|
|
#: ../Doc/library/urllib.parse.rst:105
|
|
msgid "5"
|
|
msgstr "5"
|
|
|
|
#: ../Doc/library/urllib.parse.rst:105 ../Doc/library/urllib.parse.rst:226
|
|
#: ../Doc/library/urllib.parse.rst:308
|
|
msgid "Fragment identifier"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:107 ../Doc/library/urllib.parse.rst:228
|
|
msgid ":attr:`username`"
|
|
msgstr ":attr:`username`"
|
|
|
|
#: ../Doc/library/urllib.parse.rst:107 ../Doc/library/urllib.parse.rst:228
|
|
msgid "User name"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:107 ../Doc/library/urllib.parse.rst:109
|
|
#: ../Doc/library/urllib.parse.rst:111 ../Doc/library/urllib.parse.rst:113
|
|
#: ../Doc/library/urllib.parse.rst:228 ../Doc/library/urllib.parse.rst:230
|
|
#: ../Doc/library/urllib.parse.rst:232 ../Doc/library/urllib.parse.rst:234
|
|
msgid ":const:`None`"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:109 ../Doc/library/urllib.parse.rst:230
|
|
msgid ":attr:`password`"
|
|
msgstr ":attr:`password`"
|
|
|
|
#: ../Doc/library/urllib.parse.rst:109 ../Doc/library/urllib.parse.rst:230
|
|
msgid "Password"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:111 ../Doc/library/urllib.parse.rst:232
|
|
msgid ":attr:`hostname`"
|
|
msgstr ":attr:`hostname`"
|
|
|
|
#: ../Doc/library/urllib.parse.rst:111 ../Doc/library/urllib.parse.rst:232
|
|
msgid "Host name (lower case)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:113 ../Doc/library/urllib.parse.rst:234
|
|
msgid ":attr:`port`"
|
|
msgstr ":attr:`port`"
|
|
|
|
#: ../Doc/library/urllib.parse.rst:113 ../Doc/library/urllib.parse.rst:234
|
|
msgid "Port number as integer, if present"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:117 ../Doc/library/urllib.parse.rst:238
|
|
msgid ""
|
|
"Reading the :attr:`port` attribute will raise a :exc:`ValueError` if an "
|
|
"invalid port is specified in the URL. See section :ref:`urlparse-result-"
|
|
"object` for more information on the result object."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:121 ../Doc/library/urllib.parse.rst:242
|
|
msgid ""
|
|
"Unmatched square brackets in the :attr:`netloc` attribute will raise a :exc:"
|
|
"`ValueError`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:124
|
|
msgid "Added IPv6 URL parsing capabilities."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:127
|
|
msgid ""
|
|
"The fragment is now parsed for all URL schemes (unless *allow_fragment* is "
|
|
"false), in accordance with :rfc:`3986`. Previously, a whitelist of schemes "
|
|
"that support fragments existed."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:132 ../Doc/library/urllib.parse.rst:245
|
|
msgid ""
|
|
"Out-of-range port numbers now raise :exc:`ValueError`, instead of returning :"
|
|
"const:`None`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:139
|
|
msgid ""
|
|
"Parse a query string given as a string argument (data of type :mimetype:"
|
|
"`application/x-www-form-urlencoded`). Data are returned as a dictionary. "
|
|
"The dictionary keys are the unique query variable names and the values are "
|
|
"lists of values for each name."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:144 ../Doc/library/urllib.parse.rst:173
|
|
msgid ""
|
|
"The optional argument *keep_blank_values* is a flag indicating whether blank "
|
|
"values in percent-encoded queries should be treated as blank strings. A true "
|
|
"value indicates that blanks should be retained as blank strings. The "
|
|
"default false value indicates that blank values are to be ignored and "
|
|
"treated as if they were not included."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:150 ../Doc/library/urllib.parse.rst:179
|
|
msgid ""
|
|
"The optional argument *strict_parsing* is a flag indicating what to do with "
|
|
"parsing errors. If false (the default), errors are silently ignored. If "
|
|
"true, errors raise a :exc:`ValueError` exception."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:154 ../Doc/library/urllib.parse.rst:183
|
|
msgid ""
|
|
"The optional *encoding* and *errors* parameters specify how to decode "
|
|
"percent-encoded sequences into Unicode characters, as accepted by the :meth:"
|
|
"`bytes.decode` method."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:158
|
|
msgid ""
|
|
"Use the :func:`urllib.parse.urlencode` function (with the ``doseq`` "
|
|
"parameter set to ``True``) to convert such dictionaries into query strings."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:163 ../Doc/library/urllib.parse.rst:190
|
|
msgid "Add *encoding* and *errors* parameters."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:169
|
|
msgid ""
|
|
"Parse a query string given as a string argument (data of type :mimetype:"
|
|
"`application/x-www-form-urlencoded`). Data are returned as a list of name, "
|
|
"value pairs."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:187
|
|
msgid ""
|
|
"Use the :func:`urllib.parse.urlencode` function to convert such lists of "
|
|
"pairs into query strings."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:196
|
|
msgid ""
|
|
"Construct a URL from a tuple as returned by ``urlparse()``. The *parts* "
|
|
"argument can be any six-item iterable. This may result in a slightly "
|
|
"different, but equivalent URL, if the URL that was parsed originally had "
|
|
"unnecessary delimiters (for example, a ``?`` with an empty query; the RFC "
|
|
"states that these are equivalent)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:205
|
|
msgid ""
|
|
"This is similar to :func:`urlparse`, but does not split the params from the "
|
|
"URL. This should generally be used instead of :func:`urlparse` if the more "
|
|
"recent URL syntax allowing parameters to be applied to each segment of the "
|
|
"*path* portion of the URL (see :rfc:`2396`) is wanted. A separate function "
|
|
"is needed to separate the path segments and parameters. This function "
|
|
"returns a 5-tuple: (addressing scheme, network location, path, query, "
|
|
"fragment identifier)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:252
|
|
msgid ""
|
|
"Combine the elements of a tuple as returned by :func:`urlsplit` into a "
|
|
"complete URL as a string. The *parts* argument can be any five-item "
|
|
"iterable. This may result in a slightly different, but equivalent URL, if "
|
|
"the URL that was parsed originally had unnecessary delimiters (for example, "
|
|
"a ? with an empty query; the RFC states that these are equivalent)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:261
|
|
msgid ""
|
|
"Construct a full (\"absolute\") URL by combining a \"base URL\" (*base*) "
|
|
"with another URL (*url*). Informally, this uses components of the base URL, "
|
|
"in particular the addressing scheme, the network location and (part of) the "
|
|
"path, to provide missing components in the relative URL. For example:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:270
|
|
msgid ""
|
|
"The *allow_fragments* argument has the same meaning and default as for :func:"
|
|
"`urlparse`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:275
|
|
msgid ""
|
|
"If *url* is an absolute URL (that is, starting with ``//`` or ``scheme://"
|
|
"``), the *url*'s host name and/or scheme will be present in the result. For "
|
|
"example:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:284
|
|
msgid ""
|
|
"If you do not want that behavior, preprocess the *url* with :func:`urlsplit` "
|
|
"and :func:`urlunsplit`, removing possible *scheme* and *netloc* parts."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:290
|
|
msgid "Behaviour updated to match the semantics defined in :rfc:`3986`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:295
|
|
msgid ""
|
|
"If *url* contains a fragment identifier, return a modified version of *url* "
|
|
"with no fragment identifier, and the fragment identifier as a separate "
|
|
"string. If there is no fragment identifier in *url*, return *url* "
|
|
"unmodified and an empty string."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:306
|
|
msgid ":attr:`url`"
|
|
msgstr ":attr:`url`"
|
|
|
|
#: ../Doc/library/urllib.parse.rst:306
|
|
msgid "URL with no fragment"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:311
|
|
msgid ""
|
|
"See section :ref:`urlparse-result-object` for more information on the result "
|
|
"object."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:314
|
|
msgid "Result is a structured object rather than a simple 2-tuple."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:320
|
|
msgid "Parsing ASCII Encoded Bytes"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:322
|
|
msgid ""
|
|
"The URL parsing functions were originally designed to operate on character "
|
|
"strings only. In practice, it is useful to be able to manipulate properly "
|
|
"quoted and encoded URLs as sequences of ASCII bytes. Accordingly, the URL "
|
|
"parsing functions in this module all operate on :class:`bytes` and :class:"
|
|
"`bytearray` objects in addition to :class:`str` objects."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:328
|
|
msgid ""
|
|
"If :class:`str` data is passed in, the result will also contain only :class:"
|
|
"`str` data. If :class:`bytes` or :class:`bytearray` data is passed in, the "
|
|
"result will contain only :class:`bytes` data."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:332
|
|
msgid ""
|
|
"Attempting to mix :class:`str` data with :class:`bytes` or :class:"
|
|
"`bytearray` in a single function call will result in a :exc:`TypeError` "
|
|
"being raised, while attempting to pass in non-ASCII byte values will "
|
|
"trigger :exc:`UnicodeDecodeError`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:337
|
|
msgid ""
|
|
"To support easier conversion of result objects between :class:`str` and :"
|
|
"class:`bytes`, all return values from URL parsing functions provide either "
|
|
"an :meth:`encode` method (when the result contains :class:`str` data) or a :"
|
|
"meth:`decode` method (when the result contains :class:`bytes` data). The "
|
|
"signatures of these methods match those of the corresponding :class:`str` "
|
|
"and :class:`bytes` methods (except that the default encoding is ``'ascii'`` "
|
|
"rather than ``'utf-8'``). Each produces a value of a corresponding type that "
|
|
"contains either :class:`bytes` data (for :meth:`encode` methods) or :class:"
|
|
"`str` data (for :meth:`decode` methods)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:348
|
|
msgid ""
|
|
"Applications that need to operate on potentially improperly quoted URLs that "
|
|
"may contain non-ASCII data will need to do their own decoding from bytes to "
|
|
"characters before invoking the URL parsing methods."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:352
|
|
msgid ""
|
|
"The behaviour described in this section applies only to the URL parsing "
|
|
"functions. The URL quoting functions use their own rules when producing or "
|
|
"consuming byte sequences as detailed in the documentation of the individual "
|
|
"URL quoting functions."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:357
|
|
msgid "URL parsing functions now accept ASCII encoded byte sequences"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:364
|
|
msgid "Structured Parse Results"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:366
|
|
msgid ""
|
|
"The result objects from the :func:`urlparse`, :func:`urlsplit` and :func:"
|
|
"`urldefrag` functions are subclasses of the :class:`tuple` type. These "
|
|
"subclasses add the attributes listed in the documentation for those "
|
|
"functions, the encoding and decoding support described in the previous "
|
|
"section, as well as an additional method:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:374
|
|
msgid ""
|
|
"Return the re-combined version of the original URL as a string. This may "
|
|
"differ from the original URL in that the scheme may be normalized to lower "
|
|
"case and empty components may be dropped. Specifically, empty parameters, "
|
|
"queries, and fragment identifiers will be removed."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:379
|
|
msgid ""
|
|
"For :func:`urldefrag` results, only empty fragment identifiers will be "
|
|
"removed. For :func:`urlsplit` and :func:`urlparse` results, all noted "
|
|
"changes will be made to the URL returned by this method."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:383
|
|
msgid ""
|
|
"The result of this method remains unchanged if passed back through the "
|
|
"original parsing function:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:396
|
|
msgid ""
|
|
"The following classes provide the implementations of the structured parse "
|
|
"results when operating on :class:`str` objects:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:401
|
|
msgid ""
|
|
"Concrete class for :func:`urldefrag` results containing :class:`str` data. "
|
|
"The :meth:`encode` method returns a :class:`DefragResultBytes` instance."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:409
|
|
msgid ""
|
|
"Concrete class for :func:`urlparse` results containing :class:`str` data. "
|
|
"The :meth:`encode` method returns a :class:`ParseResultBytes` instance."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:415
|
|
msgid ""
|
|
"Concrete class for :func:`urlsplit` results containing :class:`str` data. "
|
|
"The :meth:`encode` method returns a :class:`SplitResultBytes` instance."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:420
|
|
msgid ""
|
|
"The following classes provide the implementations of the parse results when "
|
|
"operating on :class:`bytes` or :class:`bytearray` objects:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:425
|
|
msgid ""
|
|
"Concrete class for :func:`urldefrag` results containing :class:`bytes` data. "
|
|
"The :meth:`decode` method returns a :class:`DefragResult` instance."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:433
|
|
msgid ""
|
|
"Concrete class for :func:`urlparse` results containing :class:`bytes` data. "
|
|
"The :meth:`decode` method returns a :class:`ParseResult` instance."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:441
|
|
msgid ""
|
|
"Concrete class for :func:`urlsplit` results containing :class:`bytes` data. "
|
|
"The :meth:`decode` method returns a :class:`SplitResult` instance."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:449
|
|
msgid "URL Quoting"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:451
|
|
msgid ""
|
|
"The URL quoting functions focus on taking program data and making it safe "
|
|
"for use as URL components by quoting special characters and appropriately "
|
|
"encoding non-ASCII text. They also support reversing these operations to "
|
|
"recreate the original data from the contents of a URL component if that task "
|
|
"isn't already covered by the URL parsing functions above."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:459
|
|
msgid ""
|
|
"Replace special characters in *string* using the ``%xx`` escape. Letters, "
|
|
"digits, and the characters ``'_.-'`` are never quoted. By default, this "
|
|
"function is intended for quoting the path section of URL. The optional "
|
|
"*safe* parameter specifies additional ASCII characters that should not be "
|
|
"quoted --- its default value is ``'/'``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:465 ../Doc/library/urllib.parse.rst:531
|
|
msgid "*string* may be either a :class:`str` or a :class:`bytes`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:467
|
|
msgid ""
|
|
"The optional *encoding* and *errors* parameters specify how to deal with non-"
|
|
"ASCII characters, as accepted by the :meth:`str.encode` method. *encoding* "
|
|
"defaults to ``'utf-8'``. *errors* defaults to ``'strict'``, meaning "
|
|
"unsupported characters raise a :class:`UnicodeEncodeError`. *encoding* and "
|
|
"*errors* must not be supplied if *string* is a :class:`bytes`, or a :class:"
|
|
"`TypeError` is raised."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:475
|
|
msgid ""
|
|
"Note that ``quote(string, safe, encoding, errors)`` is equivalent to "
|
|
"``quote_from_bytes(string.encode(encoding, errors), safe)``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:478
|
|
msgid "Example: ``quote('/El Niño/')`` yields ``'/El%20Ni%C3%B1o/'``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:483
|
|
msgid ""
|
|
"Like :func:`quote`, but also replace spaces by plus signs, as required for "
|
|
"quoting HTML form values when building up a query string to go into a URL. "
|
|
"Plus signs in the original string are escaped unless they are included in "
|
|
"*safe*. It also does not have *safe* default to ``'/'``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:488
|
|
msgid "Example: ``quote_plus('/El Niño/')`` yields ``'%2FEl+Ni%C3%B1o%2F'``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:493
|
|
msgid ""
|
|
"Like :func:`quote`, but accepts a :class:`bytes` object rather than a :class:"
|
|
"`str`, and does not perform string-to-bytes encoding."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:496
|
|
msgid "Example: ``quote_from_bytes(b'a&\\xef')`` yields ``'a%26%EF'``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:502
|
|
msgid ""
|
|
"Replace ``%xx`` escapes by their single-character equivalent. The optional "
|
|
"*encoding* and *errors* parameters specify how to decode percent-encoded "
|
|
"sequences into Unicode characters, as accepted by the :meth:`bytes.decode` "
|
|
"method."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:507 ../Doc/library/urllib.parse.rst:521
|
|
msgid "*string* must be a :class:`str`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:509
|
|
msgid ""
|
|
"*encoding* defaults to ``'utf-8'``. *errors* defaults to ``'replace'``, "
|
|
"meaning invalid sequences are replaced by a placeholder character."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:513
|
|
msgid "Example: ``unquote('/El%20Ni%C3%B1o/')`` yields ``'/El Niño/'``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:518
|
|
msgid ""
|
|
"Like :func:`unquote`, but also replace plus signs by spaces, as required for "
|
|
"unquoting HTML form values."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:523
|
|
msgid "Example: ``unquote_plus('/El+Ni%C3%B1o/')`` yields ``'/El Niño/'``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:528
|
|
msgid ""
|
|
"Replace ``%xx`` escapes by their single-octet equivalent, and return a :"
|
|
"class:`bytes` object."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:533
|
|
msgid ""
|
|
"If it is a :class:`str`, unescaped non-ASCII characters in *string* are "
|
|
"encoded into UTF-8 bytes."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:536
|
|
msgid "Example: ``unquote_to_bytes('a%26%EF')`` yields ``b'a&\\xef'``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:542
|
|
msgid ""
|
|
"Convert a mapping object or a sequence of two-element tuples, which may "
|
|
"contain :class:`str` or :class:`bytes` objects, to a percent-encoded ASCII "
|
|
"text string. If the resultant string is to be used as a *data* for POST "
|
|
"operation with the :func:`~urllib.request.urlopen` function, then it should "
|
|
"be encoded to bytes, otherwise it would result in a :exc:`TypeError`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:549
|
|
msgid ""
|
|
"The resulting string is a series of ``key=value`` pairs separated by ``'&'`` "
|
|
"characters, where both *key* and *value* are quoted using the *quote_via* "
|
|
"function. By default, :func:`quote_plus` is used to quote the values, which "
|
|
"means spaces are quoted as a ``'+'`` character and '/' characters are "
|
|
"encoded as ``%2F``, which follows the standard for GET requests "
|
|
"(``application/x-www-form-urlencoded``). An alternate function that can be "
|
|
"passed as *quote_via* is :func:`quote`, which will encode spaces as ``%20`` "
|
|
"and not encode '/' characters. For maximum control of what is quoted, use "
|
|
"``quote`` and specify a value for *safe*."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:559
|
|
msgid ""
|
|
"When a sequence of two-element tuples is used as the *query* argument, the "
|
|
"first element of each tuple is a key and the second is a value. The value "
|
|
"element in itself can be a sequence and in that case, if the optional "
|
|
"parameter *doseq* is evaluates to ``True``, individual ``key=value`` pairs "
|
|
"separated by ``'&'`` are generated for each element of the value sequence "
|
|
"for the key. The order of parameters in the encoded string will match the "
|
|
"order of parameter tuples in the sequence."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:567
|
|
msgid ""
|
|
"The *safe*, *encoding*, and *errors* parameters are passed down to "
|
|
"*quote_via* (the *encoding* and *errors* parameters are only passed when a "
|
|
"query element is a :class:`str`)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:571
|
|
msgid ""
|
|
"To reverse this encoding process, :func:`parse_qs` and :func:`parse_qsl` are "
|
|
"provided in this module to parse query strings into Python data structures."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:574
|
|
msgid ""
|
|
"Refer to :ref:`urllib examples <urllib-examples>` to find out how urlencode "
|
|
"method can be used for generating query string for a URL or data for POST."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:577
|
|
msgid "Query parameter supports bytes and string objects."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:580
|
|
msgid "*quote_via* parameter."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:590
|
|
msgid ":rfc:`3986` - Uniform Resource Identifiers"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:587
|
|
msgid ""
|
|
"This is the current standard (STD66). Any changes to urllib.parse module "
|
|
"should conform to this. Certain deviations could be observed, which are "
|
|
"mostly for backward compatibility purposes and for certain de-facto parsing "
|
|
"requirements as commonly observed in major browsers."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:593
|
|
msgid ":rfc:`2732` - Format for Literal IPv6 Addresses in URL's."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:593
|
|
msgid "This specifies the parsing requirements of IPv6 URLs."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:597
|
|
msgid ":rfc:`2396` - Uniform Resource Identifiers (URI): Generic Syntax"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:596
|
|
msgid ""
|
|
"Document describing the generic syntactic requirements for both Uniform "
|
|
"Resource Names (URNs) and Uniform Resource Locators (URLs)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:600
|
|
msgid ":rfc:`2368` - The mailto URL scheme."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:600
|
|
msgid "Parsing requirements for mailto URL schemes."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:605
|
|
msgid ":rfc:`1808` - Relative Uniform Resource Locators"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:603
|
|
msgid ""
|
|
"This Request For Comments includes the rules for joining an absolute and a "
|
|
"relative URL, including a fair number of \"Abnormal Examples\" which govern "
|
|
"the treatment of border cases."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:607
|
|
msgid ":rfc:`1738` - Uniform Resource Locators (URL)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/urllib.parse.rst:608
|
|
msgid "This specifies the formal syntax and semantics of absolute URLs."
|
|
msgstr ""
|