From ef862d613a609ea1b1acd452583dd27a68e5afaa Mon Sep 17 00:00:00 2001 From: Senthil Kumaran Date: Mon, 6 Jul 2026 17:24:20 -0700 Subject: [PATCH] [3.14] gh-82151: Update and improve urlsplit docstring (#152985) (#153155) gh-82151: Update and improve urlsplit docstring (#152985) Slightly improved wording for % escapes. Consistent with rest of the doc. --------- (cherry picked from commit ad54b91b9fa4c5d12f155bb09138dff21a2bdec3) Co-authored-by: Pranav Choudhary Co-authored-by: idomic --- Doc/library/urllib.parse.rst | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) diff --git a/Doc/library/urllib.parse.rst b/Doc/library/urllib.parse.rst index f893039c9ac8..82f31c6bcf53 100644 --- a/Doc/library/urllib.parse.rst +++ b/Doc/library/urllib.parse.rst @@ -56,11 +56,18 @@ or on combining URL components into a URL string. :class:`SplitResult` or :class:`SplitResultBytes`. This corresponds to the general structure of a URL: ``scheme://netloc/path?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: + Each tuple item is a string, possibly empty. + + 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 -- 2.47.3