From: Pranav Choudhary Date: Mon, 6 Jul 2026 03:19:17 +0000 (+0530) Subject: gh-82151: Update and improve urlsplit docstring (#152985) X-Git-Url: http://git.ipfire.org/gitweb/index.cgi?a=commitdiff_plain;h=ad54b91b9fa4c5d12f155bb09138dff21a2bdec3;p=thirdparty%2FPython%2Fcpython.git gh-82151: Update and improve urlsplit docstring (#152985) * gh-82151: Update and improve urlsplit docstring Co-authored-by: idomic * Slightly improved wording for % escapes. Consistent with rest of the doc. --------- Co-authored-by: idomic Co-authored-by: Senthil Kumaran --- diff --git a/Doc/library/urllib.parse.rst b/Doc/library/urllib.parse.rst index ef48addaba03..3ce20311c42c 100644 --- a/Doc/library/urllib.parse.rst +++ b/Doc/library/urllib.parse.rst @@ -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