# Copyright (C) 2001-2016, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2018-06-28 15:29+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \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:81 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:86 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:91 ../Doc/library/urllib.parse.rst:215 #: ../Doc/library/urllib.parse.rst:303 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:95 ../Doc/library/urllib.parse.rst:219 #: ../Doc/library/urllib.parse.rst:307 msgid "Attribute" msgstr "Attribut" #: ../Doc/library/urllib.parse.rst:95 ../Doc/library/urllib.parse.rst:219 #: ../Doc/library/urllib.parse.rst:307 msgid "Index" msgstr "" #: ../Doc/library/urllib.parse.rst:95 ../Doc/library/urllib.parse.rst:219 #: ../Doc/library/urllib.parse.rst:307 msgid "Value" msgstr "Valeur" #: ../Doc/library/urllib.parse.rst:95 ../Doc/library/urllib.parse.rst:219 #: ../Doc/library/urllib.parse.rst:307 msgid "Value if not present" msgstr "" #: ../Doc/library/urllib.parse.rst:97 ../Doc/library/urllib.parse.rst:221 msgid ":attr:`scheme`" msgstr ":attr:`scheme`" #: ../Doc/library/urllib.parse.rst:97 ../Doc/library/urllib.parse.rst:221 #: ../Doc/library/urllib.parse.rst:309 msgid "0" msgstr "0" #: ../Doc/library/urllib.parse.rst:97 ../Doc/library/urllib.parse.rst:221 msgid "URL scheme specifier" msgstr "" #: ../Doc/library/urllib.parse.rst:97 ../Doc/library/urllib.parse.rst:221 msgid "*scheme* parameter" msgstr "" #: ../Doc/library/urllib.parse.rst:99 ../Doc/library/urllib.parse.rst:223 msgid ":attr:`netloc`" msgstr ":attr:`netloc`" #: ../Doc/library/urllib.parse.rst:99 ../Doc/library/urllib.parse.rst:223 #: ../Doc/library/urllib.parse.rst:311 msgid "1" msgstr "1" #: ../Doc/library/urllib.parse.rst:99 ../Doc/library/urllib.parse.rst:223 msgid "Network location part" msgstr "" #: ../Doc/library/urllib.parse.rst:99 ../Doc/library/urllib.parse.rst:101 #: ../Doc/library/urllib.parse.rst:103 ../Doc/library/urllib.parse.rst:106 #: ../Doc/library/urllib.parse.rst:108 ../Doc/library/urllib.parse.rst:223 #: ../Doc/library/urllib.parse.rst:225 ../Doc/library/urllib.parse.rst:227 #: ../Doc/library/urllib.parse.rst:229 ../Doc/library/urllib.parse.rst:309 #: ../Doc/library/urllib.parse.rst:311 msgid "empty string" msgstr "" #: ../Doc/library/urllib.parse.rst:101 ../Doc/library/urllib.parse.rst:225 msgid ":attr:`path`" msgstr ":attr:`path`" #: ../Doc/library/urllib.parse.rst:101 ../Doc/library/urllib.parse.rst:225 msgid "2" msgstr "2" #: ../Doc/library/urllib.parse.rst:101 ../Doc/library/urllib.parse.rst:225 msgid "Hierarchical path" msgstr "" #: ../Doc/library/urllib.parse.rst:103 msgid ":attr:`params`" msgstr ":attr:`params`" #: ../Doc/library/urllib.parse.rst:103 ../Doc/library/urllib.parse.rst:227 msgid "3" msgstr "3" #: ../Doc/library/urllib.parse.rst:103 msgid "Parameters for last path element" msgstr "" #: ../Doc/library/urllib.parse.rst:106 ../Doc/library/urllib.parse.rst:227 msgid ":attr:`query`" msgstr ":attr:`query`" #: ../Doc/library/urllib.parse.rst:106 ../Doc/library/urllib.parse.rst:229 msgid "4" msgstr "4" #: ../Doc/library/urllib.parse.rst:106 ../Doc/library/urllib.parse.rst:227 msgid "Query component" msgstr "" #: ../Doc/library/urllib.parse.rst:108 ../Doc/library/urllib.parse.rst:229 #: ../Doc/library/urllib.parse.rst:311 msgid ":attr:`fragment`" msgstr ":attr:`fragment`" #: ../Doc/library/urllib.parse.rst:108 msgid "5" msgstr "5" #: ../Doc/library/urllib.parse.rst:108 ../Doc/library/urllib.parse.rst:229 #: ../Doc/library/urllib.parse.rst:311 msgid "Fragment identifier" msgstr "" #: ../Doc/library/urllib.parse.rst:110 ../Doc/library/urllib.parse.rst:231 msgid ":attr:`username`" msgstr ":attr:`username`" #: ../Doc/library/urllib.parse.rst:110 ../Doc/library/urllib.parse.rst:231 msgid "User name" msgstr "" #: ../Doc/library/urllib.parse.rst:110 ../Doc/library/urllib.parse.rst:112 #: ../Doc/library/urllib.parse.rst:114 ../Doc/library/urllib.parse.rst:116 #: ../Doc/library/urllib.parse.rst:231 ../Doc/library/urllib.parse.rst:233 #: ../Doc/library/urllib.parse.rst:235 ../Doc/library/urllib.parse.rst:237 msgid ":const:`None`" msgstr "" #: ../Doc/library/urllib.parse.rst:112 ../Doc/library/urllib.parse.rst:233 msgid ":attr:`password`" msgstr ":attr:`password`" #: ../Doc/library/urllib.parse.rst:112 ../Doc/library/urllib.parse.rst:233 msgid "Password" msgstr "" #: ../Doc/library/urllib.parse.rst:114 ../Doc/library/urllib.parse.rst:235 msgid ":attr:`hostname`" msgstr ":attr:`hostname`" #: ../Doc/library/urllib.parse.rst:114 ../Doc/library/urllib.parse.rst:235 msgid "Host name (lower case)" msgstr "" #: ../Doc/library/urllib.parse.rst:116 ../Doc/library/urllib.parse.rst:237 msgid ":attr:`port`" msgstr ":attr:`port`" #: ../Doc/library/urllib.parse.rst:116 ../Doc/library/urllib.parse.rst:237 msgid "Port number as integer, if present" msgstr "" #: ../Doc/library/urllib.parse.rst:120 ../Doc/library/urllib.parse.rst:241 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:124 ../Doc/library/urllib.parse.rst:245 msgid "" "Unmatched square brackets in the :attr:`netloc` attribute will raise a :exc:" "`ValueError`." msgstr "" #: ../Doc/library/urllib.parse.rst:127 msgid "Added IPv6 URL parsing capabilities." msgstr "" #: ../Doc/library/urllib.parse.rst:130 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:135 ../Doc/library/urllib.parse.rst:248 msgid "" "Out-of-range port numbers now raise :exc:`ValueError`, instead of returning :" "const:`None`." msgstr "" #: ../Doc/library/urllib.parse.rst:142 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:147 ../Doc/library/urllib.parse.rst:176 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:153 ../Doc/library/urllib.parse.rst:182 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:157 ../Doc/library/urllib.parse.rst:186 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:161 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:166 ../Doc/library/urllib.parse.rst:193 msgid "Add *encoding* and *errors* parameters." msgstr "" #: ../Doc/library/urllib.parse.rst:172 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:190 msgid "" "Use the :func:`urllib.parse.urlencode` function to convert such lists of " "pairs into query strings." msgstr "" #: ../Doc/library/urllib.parse.rst:199 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:208 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:255 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:264 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:273 msgid "" "The *allow_fragments* argument has the same meaning and default as for :func:" "`urlparse`." msgstr "" #: ../Doc/library/urllib.parse.rst:278 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:287 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:293 msgid "Behaviour updated to match the semantics defined in :rfc:`3986`." msgstr "" #: ../Doc/library/urllib.parse.rst:298 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:309 msgid ":attr:`url`" msgstr ":attr:`url`" #: ../Doc/library/urllib.parse.rst:309 msgid "URL with no fragment" msgstr "" #: ../Doc/library/urllib.parse.rst:314 msgid "" "See section :ref:`urlparse-result-object` for more information on the result " "object." msgstr "" #: ../Doc/library/urllib.parse.rst:317 msgid "Result is a structured object rather than a simple 2-tuple." msgstr "" #: ../Doc/library/urllib.parse.rst:323 msgid "Parsing ASCII Encoded Bytes" msgstr "" #: ../Doc/library/urllib.parse.rst:325 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:331 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:335 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:340 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:351 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:355 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:360 msgid "URL parsing functions now accept ASCII encoded byte sequences" msgstr "" #: ../Doc/library/urllib.parse.rst:367 msgid "Structured Parse Results" msgstr "" #: ../Doc/library/urllib.parse.rst:369 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:377 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:382 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:386 msgid "" "The result of this method remains unchanged if passed back through the " "original parsing function:" msgstr "" #: ../Doc/library/urllib.parse.rst:399 msgid "" "The following classes provide the implementations of the structured parse " "results when operating on :class:`str` objects:" msgstr "" #: ../Doc/library/urllib.parse.rst:404 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:412 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:418 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:423 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:428 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:436 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:444 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:452 msgid "URL Quoting" msgstr "" #: ../Doc/library/urllib.parse.rst:454 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:462 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:468 ../Doc/library/urllib.parse.rst:538 msgid "*string* may be either a :class:`str` or a :class:`bytes`." msgstr "" #: ../Doc/library/urllib.parse.rst:470 msgid "" "Moved from :rfc:`2396` to :rfc:`3986` for quoting URL strings. \"~\" is now " "included in the set of reserved characters." msgstr "" #: ../Doc/library/urllib.parse.rst:474 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:482 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:485 msgid "Example: ``quote('/El Niño/')`` yields ``'/El%20Ni%C3%B1o/'``." msgstr "" #: ../Doc/library/urllib.parse.rst:490 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:495 msgid "Example: ``quote_plus('/El Niño/')`` yields ``'%2FEl+Ni%C3%B1o%2F'``." msgstr "" #: ../Doc/library/urllib.parse.rst:500 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:503 msgid "Example: ``quote_from_bytes(b'a&\\xef')`` yields ``'a%26%EF'``." msgstr "" #: ../Doc/library/urllib.parse.rst:509 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:514 ../Doc/library/urllib.parse.rst:528 msgid "*string* must be a :class:`str`." msgstr "" #: ../Doc/library/urllib.parse.rst:516 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:520 msgid "Example: ``unquote('/El%20Ni%C3%B1o/')`` yields ``'/El Niño/'``." msgstr "" #: ../Doc/library/urllib.parse.rst:525 msgid "" "Like :func:`unquote`, but also replace plus signs by spaces, as required for " "unquoting HTML form values." msgstr "" #: ../Doc/library/urllib.parse.rst:530 msgid "Example: ``unquote_plus('/El+Ni%C3%B1o/')`` yields ``'/El Niño/'``." msgstr "" #: ../Doc/library/urllib.parse.rst:535 msgid "" "Replace ``%xx`` escapes by their single-octet equivalent, and return a :" "class:`bytes` object." msgstr "" #: ../Doc/library/urllib.parse.rst:540 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:543 msgid "Example: ``unquote_to_bytes('a%26%EF')`` yields ``b'a&\\xef'``." msgstr "" #: ../Doc/library/urllib.parse.rst:549 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:556 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:566 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:574 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:578 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:581 msgid "" "Refer to :ref:`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:584 msgid "Query parameter supports bytes and string objects." msgstr "" #: ../Doc/library/urllib.parse.rst:587 msgid "*quote_via* parameter." msgstr "" #: ../Doc/library/urllib.parse.rst:597 msgid ":rfc:`3986` - Uniform Resource Identifiers" msgstr "" #: ../Doc/library/urllib.parse.rst:594 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:600 msgid ":rfc:`2732` - Format for Literal IPv6 Addresses in URL's." msgstr "" #: ../Doc/library/urllib.parse.rst:600 msgid "This specifies the parsing requirements of IPv6 URLs." msgstr "" #: ../Doc/library/urllib.parse.rst:604 msgid ":rfc:`2396` - Uniform Resource Identifiers (URI): Generic Syntax" msgstr "" #: ../Doc/library/urllib.parse.rst:603 msgid "" "Document describing the generic syntactic requirements for both Uniform " "Resource Names (URNs) and Uniform Resource Locators (URLs)." msgstr "" #: ../Doc/library/urllib.parse.rst:607 msgid ":rfc:`2368` - The mailto URL scheme." msgstr "" #: ../Doc/library/urllib.parse.rst:607 msgid "Parsing requirements for mailto URL schemes." msgstr "" #: ../Doc/library/urllib.parse.rst:612 msgid ":rfc:`1808` - Relative Uniform Resource Locators" msgstr "" #: ../Doc/library/urllib.parse.rst:610 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:614 msgid ":rfc:`1738` - Uniform Resource Locators (URL)" msgstr "" #: ../Doc/library/urllib.parse.rst:615 msgid "This specifies the formal syntax and semantics of absolute URLs." msgstr ""