[3.15] gh-82151: Update and improve urlsplit docstring (GH-152985) (#153154)

gh-82151: Update and improve urlsplit docstring (GH-152985)

(cherry picked from commit ad54b91b9f)

Co-authored-by: Pranav Choudhary <chaudharyypranav@gmail.com>
Co-authored-by: idomic <michael.ido@gmail.com>
Co-authored-by: Senthil Kumaran <senthil@python.org>
This commit is contained in:
Miss Islington (bot)
2026-07-07 02:24:44 +02:00
committed by GitHub
parent 78e9fdb78f
commit 017e4e9bb8
+10 -5
View File
@@ -60,11 +60,16 @@ or on combining URL components into a URL string.
*missing_as_none* is true.
Not defined component are represented an empty string (by default) or
``None`` if *missing_as_none* is true.
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:
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.
Additionally, the netloc property is broken down into these additional
attributes added to the returned object: username, password, hostname, and
port.
Percent-encoded sequences are not decoded.
For example:
.. doctest::
:options: +NORMALIZE_WHITESPACE