String Kit¤

懶人字串解析，包含從讀取行、解析 URL、漂亮印出 JSON 等。

string_kit ¤

random_string(length: int = 16, digits: bool = True) -> str

生成隨機字串

PARAMETER	DESCRIPTION
`length`	字串的長度，預設為16 TYPE: `int` DEFAULT: `16`
`digits`	是否包含數字，預設為True TYPE: `bool` DEFAULT: `True`

RETURNS	DESCRIPTION
`str`	隨機字串

print_json(dictionary: dict[Any, Any], indent: int = 4) -> None

以格式化的 JSON 字串印出解碼後的字典

PARAMETER	DESCRIPTION
`dictionary`	輸入的字典，將會被解碼並印出 TYPE: `dict[Any, Any]`
`indent`	格式化 JSON 時的縮排空格數（預設為4） TYPE: `int` DEFAULT: `4`

RETURNS	DESCRIPTION
`None`	None

read_file_from_url(url: str, **kwargs: Any) -> str

從 URL 取得內容並以字串形式回傳

PARAMETER	DESCRIPTION
`url`	要取得內容的 URL TYPE: `str`
`kwargs`	傳遞給 requests.get() 的額外關鍵字參數 TYPE: `Any` DEFAULT: `{}`

RETURNS	DESCRIPTION
`str`	從 URL 取得的內容，作為字串回傳 TYPE: `str`

read_file_lines(source: str, encoding: str = DEFAULT_CODEC) -> list[str]

從檔案或 URL 讀取每一行並回傳為字串的列表

PARAMETER	DESCRIPTION
`source`	要讀取的檔案路徑或 URL TYPE: `str`
`encoding`	用來讀取檔案的字元編碼（預設為 DEFAULT_CODEC） TYPE: `str` DEFAULT: `DEFAULT_CODEC`

RETURNS	DESCRIPTION
`list[str]`	list[str]: 來自檔案或 URL 的每一行字串，已移除尾端換行符號

若來源為 URL，則會使用 HTTP 請求取得內容若來源為檔案路徑，則會直接讀取檔案若來源既不是有效的檔案路徑，也不是 URL，則會回傳空列表

write_file_lines(file_path: str, content: list[str]) -> None

將字串列表寫入檔案，每個字串佔一行

PARAMETER	DESCRIPTION
`file_path`	檔案的路徑，內容將被寫入此檔案 TYPE: `str`
`content`	要寫入檔案的字串列表 TYPE: `list[str]`

RETURNS	DESCRIPTION
`None`	None

add_page_num(url: str, page: int, page_tag: str = 'page') -> str

在 URL 中加入或更新頁碼

PARAMETER	DESCRIPTION
`url`	原始 URL TYPE: `str`
`page`	要加入或更新的頁碼 TYPE: `int`
`page_tag`	頁面查詢參數的名稱 TYPE: `str` DEFAULT: `'page'`

RETURNS	DESCRIPTION
`str`	更新後的 URL，包含指定的頁碼 TYPE: `str`

remove_page_num(url: str, page_tag: str = 'page') -> str

從 URL 中移除頁碼參數

remove_query_params(url: str) -> str

移除指定 URL 的查詢參數

update_query_param(url: str, param: str, value: str) -> str

更新 URL 中特定查詢參數的值

Examples:

Update the 'hl' query parameter:

updated_url = update_query_param('https://example.com?hl=en', 'hl', 'fr')
print(updated_url)
# Output: https://example.com?hl=fr

Update the 'user' query parameter:

updated_url = update_query_param('https://example.com?user=123', 'user', '456')
print(updated_url)
# Output: https://example.com?user=456