Skip to content

URL operators

commons.url_operators

Functions:

Name Description
set_query_param

Add or update a query parameter in a URL.
remove_query_param

Remove a query parameter from a URL.

set_query_param 

set_query_param(url: str, name: str, value: str) -> str

Add or update a query parameter in a URL.

Works with both absolute and relative URLs. If the parameter already exists, its value is replaced.

Source code in src/commons/url_operators.py 
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
def set_query_param(url: str, name: str, value: str) -> str:
    """
    Add or update a query parameter in a URL.

    Works with both absolute and relative URLs.
    If the parameter already exists, its value is replaced.
    """
    parsed = urlparse(url)
    params = parse_qs(parsed.query, keep_blank_values=True)
    params[name] = [value]
    new_query = urlencode(params, doseq=True)
    return urlunparse(parsed._replace(query=new_query))

remove_query_param 

remove_query_param(url: str, name: str) -> str

Remove a query parameter from a URL.

Works with both absolute and relative URLs. If the parameter does not exist, the URL is returned unchanged.

Source code in src/commons/url_operators.py 
18
19
20
21
22
23
24
25
26
27
28
29
def remove_query_param(url: str, name: str) -> str:
    """
    Remove a query parameter from a URL.

    Works with both absolute and relative URLs.
    If the parameter does not exist, the URL is returned unchanged.
    """
    parsed = urlparse(url)
    params = parse_qs(parsed.query, keep_blank_values=True)
    params.pop(name, None)
    new_query = urlencode(params, doseq=True)
    return urlunparse(parsed._replace(query=new_query))