urlsplit
- urlsplit(urlstring, scheme=None, allow_fragments=True, *, missing_as_none=False)
Parse a URL into 5 components: <scheme>://<netloc>/<path>?<query>#<fragment> The result is a named 5-tuple with fields corresponding to the above. It is either a SplitResult or SplitResultBytes object, depending on the type of the url parameter. The username, password, hostname, and port sub-components of netloc can also be accessed as attributes of the returned object. The scheme argument provides the default value of the scheme component when no scheme is found in url. If allow_fragments is False, no attempt is made to separate the fragment component from the previous component, which can be either path or query. Note that % escapes are not expanded.
© Python Software Foundation. PSF License Version 2 · Official docs ↗
Changed in 3.2, 3.3, 3.6, 3.8, 3.10, 3.12, 3.15
- 3.2: Added IPv6 URL parsing capabilities.
- 3.3: The fragment is now parsed for all URL schemes (unless allow_fragments is false), in accordance with RFC 3986. Previously, an allowlist of schemes that support fragments existed.
- 3.6: Out-of-range port numbers now raise ValueError, instead of returning None.
- 3.8: Characters that affect netloc parsing under NFKC normalization will now raise ValueError.
- 3.10: ASCII newline and tab characters are stripped from the URL.
- 3.12: Leading WHATWG C0 control and space characters are stripped from the URL.
- 3.15: Added the missing_as_none parameter.
1 Example
>>> from urllib.parse import urlsplit >>> urlsplit("scheme://netloc/path?query#fragment") SplitResult(scheme='scheme', netloc='netloc', path='/path', query='query', fragment='fragment') >>> o = urlsplit("http://docs.python.org:80/3/library/urllib.parse.html?" ... "highlight=params#url-parsing") >>> o SplitResult(scheme='http', netloc='docs.python.org:80', path='/3/library/urllib.parse.html', query='highlight=params', fragment='url-parsing') >>> o.scheme 'http' >>> o.netloc 'docs.python.org:80' >>> o.hostname 'docs.python.org' >>> o.port 80 >>> o._replace(fragment="").geturl() 'http://docs.python.org:80/3/library/urllib.parse.html?highlight=params' >>> urlsplit("http://docs.python.org?") SplitResult(scheme='http', netloc='docs.python.org', path='', query='', fragment='') >>> urlsplit("http://docs.python.org?", missing_as_none=True) SplitResult(scheme='http', netloc='docs.python.org', path='', query='', fragment=None)
from the Python docs