python-docs-fr/library/urllib.parse.po

# Copyright (C) 2001-2018, Python Software Foundation
# For licence information, see README file.
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-07-23 14:38+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
"Language: fr\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#: library/urllib.parse.rst:2
msgid ":mod:`urllib.parse` --- Parse URLs into components"
msgstr ""

#: library/urllib.parse.rst:7
msgid "**Source code:** :source:`Lib/urllib/parse.py`"
msgstr "**Code source :** :source:`Lib/urllib/parse.py`"

#: 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 ""

#: 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``, ``rtsps``, ``rtspu``, "
"``sftp``, ``shttp``, ``sip``, ``sips``, ``snews``, ``svn``, ``svn+ssh``, "
"``telnet``, ``wais``, ``ws``, ``wss``."
msgstr ""

#: 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 ""

#: library/urllib.parse.rst:35
msgid "URL Parsing"
msgstr ""

#: 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 ""

#: library/urllib.parse.rst:42
msgid ""
"Parse a URL into six components, returning a 6-item :term:`named 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 into 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 ""

#: library/urllib.parse.rst:75
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 ""

#: library/urllib.parse.rst:94
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 ""

#: library/urllib.parse.rst:99
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 ""

#: library/urllib.parse.rst:104
msgid ""
"The return value is a :term:`named tuple`, which means that its items can be "
"accessed by index or as named attributes, which are:"
msgstr ""

#: library/urllib.parse.rst:297 library/urllib.parse.rst:410
msgid "Attribute"
msgstr "Attribut"

#: library/urllib.parse.rst:297 library/urllib.parse.rst:410
msgid "Index"
msgstr "Index"

#: library/urllib.parse.rst:297 library/urllib.parse.rst:410
msgid "Value"
msgstr "Valeur"

#: library/urllib.parse.rst:297 library/urllib.parse.rst:410
msgid "Value if not present"
msgstr ""

#: library/urllib.parse.rst:299
msgid ":attr:`scheme`"
msgstr ":attr:`scheme`"

#: library/urllib.parse.rst:299 library/urllib.parse.rst:412
msgid "0"
msgstr "0"

#: library/urllib.parse.rst:299
msgid "URL scheme specifier"
msgstr ""

#: library/urllib.parse.rst:299
msgid "*scheme* parameter"
msgstr ""

#: library/urllib.parse.rst:301
msgid ":attr:`netloc`"
msgstr ":attr:`netloc`"

#: library/urllib.parse.rst:301 library/urllib.parse.rst:414
msgid "1"
msgstr "1"

#: library/urllib.parse.rst:301
msgid "Network location part"
msgstr ""

#: library/urllib.parse.rst:114 library/urllib.parse.rst:119
#: library/urllib.parse.rst:301 library/urllib.parse.rst:305
#: library/urllib.parse.rst:412 library/urllib.parse.rst:414
msgid "empty string"
msgstr ""

#: library/urllib.parse.rst:303
msgid ":attr:`path`"
msgstr ":attr:`path`"

#: library/urllib.parse.rst:303
msgid "2"
msgstr "2"

#: library/urllib.parse.rst:303
msgid "Hierarchical path"
msgstr ""

#: library/urllib.parse.rst:116
msgid ":attr:`params`"
msgstr ":attr:`params`"

#: library/urllib.parse.rst:305
msgid "3"
msgstr "3"

#: library/urllib.parse.rst:116
msgid "Parameters for last path element"
msgstr ""

#: library/urllib.parse.rst:305
msgid ":attr:`query`"
msgstr ":attr:`query`"

#: library/urllib.parse.rst:307
msgid "4"
msgstr "4"

#: library/urllib.parse.rst:305
msgid "Query component"
msgstr ""

#: library/urllib.parse.rst:307 library/urllib.parse.rst:414
msgid ":attr:`fragment`"
msgstr ":attr:`fragment`"

#: library/urllib.parse.rst:121
msgid "5"
msgstr "5"

#: library/urllib.parse.rst:307 library/urllib.parse.rst:414
msgid "Fragment identifier"
msgstr ""

#: library/urllib.parse.rst:309
msgid ":attr:`username`"
msgstr ":attr:`username`"

#: library/urllib.parse.rst:309
msgid "User name"
msgstr ""

#: library/urllib.parse.rst:125 library/urllib.parse.rst:129
#: library/urllib.parse.rst:311 library/urllib.parse.rst:315
msgid ":const:`None`"
msgstr ":const:`None`"

#: library/urllib.parse.rst:311
msgid ":attr:`password`"
msgstr ":attr:`password`"

#: library/urllib.parse.rst:311
msgid "Password"
msgstr ""

#: library/urllib.parse.rst:313
msgid ":attr:`hostname`"
msgstr ":attr:`hostname`"

#: library/urllib.parse.rst:313
msgid "Host name (lower case)"
msgstr ""

#: library/urllib.parse.rst:315
msgid ":attr:`port`"
msgstr ":attr:`port`"

#: library/urllib.parse.rst:315
msgid "Port number as integer, if present"
msgstr ""

#: library/urllib.parse.rst:319
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 ""

#: library/urllib.parse.rst:323
msgid ""
"Unmatched square brackets in the :attr:`netloc` attribute will raise a :exc:"
"`ValueError`."
msgstr ""

#: library/urllib.parse.rst:326
msgid ""
"Characters in the :attr:`netloc` attribute that decompose under NFKC "
"normalization (as used by the IDNA encoding) into any of ``/``, ``?``, "
"``#``, ``@``, or ``:`` will raise a :exc:`ValueError`. If the URL is "
"decomposed before parsing, no error will be raised."
msgstr ""

#: library/urllib.parse.rst:145
msgid ""
"As is the case with all named tuples, the subclass has a few additional "
"methods and attributes that are particularly useful. One such method is :"
"meth:`_replace`. The :meth:`_replace` method will return a new ParseResult "
"object replacing specified fields with new values."
msgstr ""

#: library/urllib.parse.rst:164
msgid ""
":func:`urlparse` does not perform validation.  See :ref:`URL parsing "
"security <url-parsing-security>` for details."
msgstr ""

#: library/urllib.parse.rst:167
msgid "Added IPv6 URL parsing capabilities."
msgstr ""

#: library/urllib.parse.rst:170
msgid ""
"The fragment is now parsed for all URL schemes (unless *allow_fragment* is "
"false), in accordance with :rfc:`3986`.  Previously, an allowlist of schemes "
"that support fragments existed."
msgstr ""

#: library/urllib.parse.rst:340
msgid ""
"Out-of-range port numbers now raise :exc:`ValueError`, instead of returning :"
"const:`None`."
msgstr ""

#: library/urllib.parse.rst:344
msgid ""
"Characters that affect netloc parsing under NFKC normalization will now "
"raise :exc:`ValueError`."
msgstr ""

#: library/urllib.parse.rst:186
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 ""

#: library/urllib.parse.rst:236
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 ""

#: library/urllib.parse.rst:242
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 ""

#: library/urllib.parse.rst:246
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 ""

#: library/urllib.parse.rst:250
msgid ""
"The optional argument *max_num_fields* is the maximum number of fields to "
"read. If set, then throws a :exc:`ValueError` if there are more than "
"*max_num_fields* fields read."
msgstr ""

#: library/urllib.parse.rst:254
msgid ""
"The optional argument *separator* is the symbol to use for separating the "
"query arguments. It defaults to ``&``."
msgstr ""

#: library/urllib.parse.rst:212
msgid ""
"Use the :func:`urllib.parse.urlencode` function (with the ``doseq`` "
"parameter set to ``True``) to convert such dictionaries into query strings."
msgstr ""

#: library/urllib.parse.rst:260
msgid "Add *encoding* and *errors* parameters."
msgstr ""

#: library/urllib.parse.rst:263
msgid "Added *max_num_fields* parameter."
msgstr ""

#: library/urllib.parse.rst:266
msgid ""
"Added *separator* parameter with the default value of ``&``. Python versions "
"earlier than Python 3.10 allowed using both ``;`` and ``&`` as query "
"parameter separator. This has been changed to allow only a single separator "
"key, with ``&`` as the default separator."
msgstr ""

#: library/urllib.parse.rst:232
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 ""

#: library/urllib.parse.rst:257
msgid ""
"Use the :func:`urllib.parse.urlencode` function to convert such lists of "
"pairs into query strings."
msgstr ""

#: library/urllib.parse.rst:275
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 ""

#: library/urllib.parse.rst:284
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-item :term:`named tuple`::"
msgstr ""

#: library/urllib.parse.rst:406
msgid ""
"The return value is a :term:`named tuple`, its items can be accessed by "
"index or as named attributes:"
msgstr ""

#: library/urllib.parse.rst:331
msgid ""
"Following some of the `WHATWG spec`_ that updates RFC 3986, leading C0 "
"control and space characters are stripped from the URL. ``\\n``, ``\\r`` and "
"tab ``\\t`` characters are removed from the URL at any position."
msgstr ""

#: library/urllib.parse.rst:337
msgid ""
":func:`urlsplit` does not perform validation.  See :ref:`URL parsing "
"security <url-parsing-security>` for details."
msgstr ""

#: library/urllib.parse.rst:348
msgid "ASCII newline and tab characters are stripped from the URL."
msgstr ""

#: library/urllib.parse.rst:351
msgid ""
"Leading WHATWG C0 control and space characters are stripped from the URL."
msgstr ""

#: library/urllib.parse.rst:358
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 ""

#: library/urllib.parse.rst:367
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 ""

#: library/urllib.parse.rst:376
msgid ""
"The *allow_fragments* argument has the same meaning and default as for :func:"
"`urlparse`."
msgstr ""

#: library/urllib.parse.rst:381
msgid ""
"If *url* is an absolute URL (that is, it starts with ``//`` or ``scheme://"
"``), the *url*'s hostname and/or scheme will be present in the result.  For "
"example:"
msgstr ""

#: library/urllib.parse.rst:390
msgid ""
"If you do not want that behavior, preprocess the *url* with :func:`urlsplit` "
"and :func:`urlunsplit`, removing possible *scheme* and *netloc* parts."
msgstr ""

#: library/urllib.parse.rst:396
msgid "Behavior updated to match the semantics defined in :rfc:`3986`."
msgstr ""

#: library/urllib.parse.rst:401
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 ""

#: library/urllib.parse.rst:412
msgid ":attr:`url`"
msgstr ":attr:`url`"

#: library/urllib.parse.rst:412
msgid "URL with no fragment"
msgstr ""

#: library/urllib.parse.rst:417
msgid ""
"See section :ref:`urlparse-result-object` for more information on the result "
"object."
msgstr ""

#: library/urllib.parse.rst:420
msgid "Result is a structured object rather than a simple 2-tuple."
msgstr ""

#: library/urllib.parse.rst:425
msgid ""
"Extract the url from a wrapped URL (that is, a string formatted as ``<URL:"
"scheme://host/path>``, ``<scheme://host/path>``, ``URL:scheme://host/path`` "
"or ``scheme://host/path``). If *url* is not a wrapped URL, it is returned "
"without changes."
msgstr ""

#: library/urllib.parse.rst:433
msgid "URL parsing security"
msgstr ""

#: library/urllib.parse.rst:435
msgid ""
"The :func:`urlsplit` and :func:`urlparse` APIs do not perform **validation** "
"of inputs.  They may not raise errors on inputs that other applications "
"consider invalid.  They may also succeed on some inputs that might not be "
"considered URLs elsewhere.  Their purpose is for practical functionality "
"rather than purity."
msgstr ""

#: library/urllib.parse.rst:441
msgid ""
"Instead of raising an exception on unusual input, they may instead return "
"some component parts as empty strings. Or components may contain more than "
"perhaps they should."
msgstr ""

#: library/urllib.parse.rst:445
msgid ""
"We recommend that users of these APIs where the values may be used anywhere "
"with security implications code defensively. Do some verification within "
"your code before trusting a returned component part.  Does that ``scheme`` "
"make sense?  Is that a sensible ``path``?  Is there anything strange about "
"that ``hostname``?  etc."
msgstr ""

#: library/urllib.parse.rst:451
msgid ""
"What constitutes a URL is not universally well defined.  Different "
"applications have different needs and desired constraints.  For instance the "
"living `WHATWG spec`_ describes what user facing web clients such as a web "
"browser require. While :rfc:`3986` is more general.  These functions "
"incorporate some aspects of both, but cannot be claimed compliant with "
"either.  The APIs and existing user code with expectations on specific "
"behaviors predate both standards leading us to be very cautious about making "
"API behavior changes."
msgstr ""

#: library/urllib.parse.rst:462
msgid "Parsing ASCII Encoded Bytes"
msgstr ""

#: library/urllib.parse.rst:464
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 ""

#: library/urllib.parse.rst:470
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 ""

#: library/urllib.parse.rst:474
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 ""

#: library/urllib.parse.rst:479
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 ""

#: library/urllib.parse.rst:490
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 ""

#: library/urllib.parse.rst:494
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 ""

#: library/urllib.parse.rst:499
msgid "URL parsing functions now accept ASCII encoded byte sequences"
msgstr ""

#: library/urllib.parse.rst:506
msgid "Structured Parse Results"
msgstr ""

#: library/urllib.parse.rst:508
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 ""

#: library/urllib.parse.rst:516
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 ""

#: library/urllib.parse.rst:521
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 ""

#: library/urllib.parse.rst:525
msgid ""
"The result of this method remains unchanged if passed back through the "
"original parsing function:"
msgstr ""

#: library/urllib.parse.rst:538
msgid ""
"The following classes provide the implementations of the structured parse "
"results when operating on :class:`str` objects:"
msgstr ""

#: library/urllib.parse.rst:543
msgid ""
"Concrete class for :func:`urldefrag` results containing :class:`str` data. "
"The :meth:`encode` method returns a :class:`DefragResultBytes` instance."
msgstr ""

#: library/urllib.parse.rst:551
msgid ""
"Concrete class for :func:`urlparse` results containing :class:`str` data. "
"The :meth:`encode` method returns a :class:`ParseResultBytes` instance."
msgstr ""

#: library/urllib.parse.rst:557
msgid ""
"Concrete class for :func:`urlsplit` results containing :class:`str` data. "
"The :meth:`encode` method returns a :class:`SplitResultBytes` instance."
msgstr ""

#: library/urllib.parse.rst:562
msgid ""
"The following classes provide the implementations of the parse results when "
"operating on :class:`bytes` or :class:`bytearray` objects:"
msgstr ""

#: library/urllib.parse.rst:567
msgid ""
"Concrete class for :func:`urldefrag` results containing :class:`bytes` data. "
"The :meth:`decode` method returns a :class:`DefragResult` instance."
msgstr ""

#: library/urllib.parse.rst:575
msgid ""
"Concrete class for :func:`urlparse` results containing :class:`bytes` data. "
"The :meth:`decode` method returns a :class:`ParseResult` instance."
msgstr ""

#: library/urllib.parse.rst:583
msgid ""
"Concrete class for :func:`urlsplit` results containing :class:`bytes` data. "
"The :meth:`decode` method returns a :class:`SplitResult` instance."
msgstr ""

#: library/urllib.parse.rst:591
msgid "URL Quoting"
msgstr ""

#: library/urllib.parse.rst:593
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 ""

#: library/urllib.parse.rst:601
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 a URL. The optional "
"*safe* parameter specifies additional ASCII characters that should not be "
"quoted --- its default value is ``'/'``."
msgstr ""

#: library/urllib.parse.rst:653 library/urllib.parse.rst:682
msgid "*string* may be either a :class:`str` or a :class:`bytes` object."
msgstr ""

#: library/urllib.parse.rst:609
msgid ""
"Moved from :rfc:`2396` to :rfc:`3986` for quoting URL strings. \"~\" is now "
"included in the set of unreserved characters."
msgstr ""

#: library/urllib.parse.rst:613
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 ""

#: library/urllib.parse.rst:621
msgid ""
"Note that ``quote(string, safe, encoding, errors)`` is equivalent to "
"``quote_from_bytes(string.encode(encoding, errors), safe)``."
msgstr ""

#: library/urllib.parse.rst:624
msgid "Example: ``quote('/El Niño/')`` yields ``'/El%20Ni%C3%B1o/'``."
msgstr ""

#: library/urllib.parse.rst:629
msgid ""
"Like :func:`quote`, but also replace spaces with 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 ""

#: library/urllib.parse.rst:634
msgid "Example: ``quote_plus('/El Niño/')`` yields ``'%2FEl+Ni%C3%B1o%2F'``."
msgstr ""

#: library/urllib.parse.rst:639
msgid ""
"Like :func:`quote`, but accepts a :class:`bytes` object rather than a :class:"
"`str`, and does not perform string-to-bytes encoding."
msgstr ""

#: library/urllib.parse.rst:642
msgid "Example: ``quote_from_bytes(b'a&\\xef')`` yields ``'a%26%EF'``."
msgstr ""

#: library/urllib.parse.rst:648
msgid ""
"Replace ``%xx`` escapes with 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 ""

#: library/urllib.parse.rst:655
msgid ""
"*encoding* defaults to ``'utf-8'``. *errors* defaults to ``'replace'``, "
"meaning invalid sequences are replaced by a placeholder character."
msgstr ""

#: library/urllib.parse.rst:659
msgid "Example: ``unquote('/El%20Ni%C3%B1o/')`` yields ``'/El Niño/'``."
msgstr ""

#: library/urllib.parse.rst:661
msgid ""
"*string* parameter supports bytes and str objects (previously only str)."
msgstr ""

#: library/urllib.parse.rst:669
msgid ""
"Like :func:`unquote`, but also replace plus signs with spaces, as required "
"for unquoting HTML form values."
msgstr ""

#: library/urllib.parse.rst:672
msgid "*string* must be a :class:`str`."
msgstr ""

#: library/urllib.parse.rst:674
msgid "Example: ``unquote_plus('/El+Ni%C3%B1o/')`` yields ``'/El Niño/'``."
msgstr ""

#: library/urllib.parse.rst:679
msgid ""
"Replace ``%xx`` escapes with their single-octet equivalent, and return a :"
"class:`bytes` object."
msgstr ""

#: library/urllib.parse.rst:684
msgid ""
"If it is a :class:`str`, unescaped non-ASCII characters in *string* are "
"encoded into UTF-8 bytes."
msgstr ""

#: library/urllib.parse.rst:687
msgid "Example: ``unquote_to_bytes('a%26%EF')`` yields ``b'a&\\xef'``."
msgstr ""

#: library/urllib.parse.rst:693
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 ""

#: library/urllib.parse.rst:700
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 ""

#: library/urllib.parse.rst:710
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* 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 ""

#: library/urllib.parse.rst:718
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 ""

#: library/urllib.parse.rst:722
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 ""

#: library/urllib.parse.rst:725
msgid ""
"Refer to :ref:`urllib examples <urllib-examples>` to find out how the :func:"
"`urllib.parse.urlencode` method can be used for generating the query string "
"of a URL or data for a POST request."
msgstr ""

#: library/urllib.parse.rst:729
msgid "*query* supports bytes and string objects."
msgstr ""

#: library/urllib.parse.rst:732
msgid "*quote_via* parameter."
msgstr ""

#: library/urllib.parse.rst:740
msgid "`WHATWG`_ -  URL Living standard"
msgstr ""

#: library/urllib.parse.rst:739
msgid ""
"Working Group for the URL Standard that defines URLs, domains, IP addresses, "
"the application/x-www-form-urlencoded format, and their API."
msgstr ""

#: library/urllib.parse.rst:746
msgid ":rfc:`3986` - Uniform Resource Identifiers"
msgstr ""

#: library/urllib.parse.rst:743
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 ""

#: library/urllib.parse.rst:749
msgid ":rfc:`2732` - Format for Literal IPv6 Addresses in URL's."
msgstr ""

#: library/urllib.parse.rst:749
msgid "This specifies the parsing requirements of IPv6 URLs."
msgstr ""

#: library/urllib.parse.rst:753
msgid ":rfc:`2396` - Uniform Resource Identifiers (URI): Generic Syntax"
msgstr ""

#: library/urllib.parse.rst:752
msgid ""
"Document describing the generic syntactic requirements for both Uniform "
"Resource Names (URNs) and Uniform Resource Locators (URLs)."
msgstr ""

#: library/urllib.parse.rst:756
msgid ":rfc:`2368` - The mailto URL scheme."
msgstr ""

#: library/urllib.parse.rst:756
msgid "Parsing requirements for mailto URL schemes."
msgstr ""

#: library/urllib.parse.rst:761
msgid ":rfc:`1808` - Relative Uniform Resource Locators"
msgstr ""

#: library/urllib.parse.rst:759
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 ""

#: library/urllib.parse.rst:763
msgid ":rfc:`1738` - Uniform Resource Locators (URL)"
msgstr ""

#: library/urllib.parse.rst:764
msgid "This specifies the formal syntax and semantics of absolute URLs."
msgstr ""

#: library/urllib.parse.rst:9
msgid "WWW"
msgstr ""

#: library/urllib.parse.rst:9
msgid "World Wide Web"
msgstr ""

#: library/urllib.parse.rst:9
msgid "URL"
msgstr ""

#: library/urllib.parse.rst:9
msgid "parsing"
msgstr ""

#: library/urllib.parse.rst:9
msgid "relative"
msgstr ""