This document describes the current stable version of Kombu (4.2). For development docs, go here.
URL Utilities - kombu.utils.url
¶
URL Utilities.
-
kombu.utils.url.
as_url
(scheme, host=None, port=None, user=None, password=None, path=None, query=None, sanitize=False, mask=u'**')[source]¶ Generate URL from component parts.
-
kombu.utils.url.
maybe_sanitize_url
(url, mask=u'**')[source]¶ Sanitize url, or do nothing if url undefined.
-
kombu.utils.url.
safequote
(s)¶ quote(‘abc def’) -> ‘abc%20def’
Each part of a URL, e.g. the path info, the query, etc., has a different set of reserved characters that must be quoted.
RFC 2396 Uniform Resource Identifiers (URI): Generic Syntax lists the following reserved characters.
- reserved = “;” | “/” | “?” | “:” | “@” | “&” | “=” | “+” |
- “$” | “,”
Each of these characters is reserved in some component of a URL, but not necessarily in all of them.
By default, the quote function is intended for quoting the path section of a URL. Thus, it will not encode ‘/’. This character is reserved, but in typical usage the quote function is being called on a path where the existing slash characters are used as reserved characters.
-
class
kombu.utils.url.
urlparts
(scheme, hostname, port, username, password, path, query)¶ -
hostname
¶ Alias for field number 1
-
password
¶ Alias for field number 4
-
path
¶ Alias for field number 5
-
port
¶ Alias for field number 2
-
query
¶ Alias for field number 6
-
scheme
¶ Alias for field number 0
-
username
¶ Alias for field number 3
-