urlmethod

自定义常用 URL 方法

attributeGGithubSrcURL

= ''

attributeGPluginMarketURL

= ''

attributeKB

= 1024

attributeMB

= 1024 * KB

funcset_global_github_src_url(url)

paramurlstr

Returns

None

funcget_global_github_src_url()

Returns

None

funcget_fastest_github_mirror()

Returns

None

funcdownload_file_urls(download_url2dst) -> None

从给定的URL并发下载文件到指定的目标路径。

Args: download_url2dst (List[Tuple[str, str]]): 包含多个元组的列表，每个元组包含：

url (str): 要下载的文件的URL。
dst (str): 下载的文件将保存的目标路径。

Returns: None

paramdownload_url2dstlist[tuple[str, str]]

Returns

None

funcgithubdownloadurl_to_rawurl(url) -> str

将 GitHub 下载链接转换为原始链接

Args: url (str): 原始链接

Returns: str: 原始链接

paramurlstr

Returns

str

funcprogress_bar(current, total, length=20, color1='§f', color2='§b') -> str

执行进度条

Args: current (float | int): 当前进度值 total (float | int): 总进度值 length (int): 进度条长度. color1 (str): 进度条颜色 1. color2 (str): 进度条颜色 2.

Returns: str: 格式化后的进度条字符串

paramcurrentfloat

paramtotalfloat

paramlengthfloat

= 20

paramcolor1str

= '§f'

paramcolor2str

= '§b'

Returns

str

funcdownload_progress_bar(current_bytes, total_bytes, speed=0) -> None

构建下载进度条

Args: current_bytes (int): 当前已下载的字节数 total_bytes (int): 文件总字节数 speed ( float): 下载速度.

paramcurrent_bytesint

paramtotal_bytesint

paramspeedfloat

= 0

Returns

None

funcpretty_kb(n) -> str

将字节数转换为可读性更好的字符串表示形式

Args: n (float): 字节数

Returns: str: 可读性更好的字符串表示形式

paramnfloat

Returns

str

funcis_common_text_file(url_path) -> bool

判断是否为常见的文本文件.

Args: url_path (str): 文件路径

Returns: bool: 是否为常见的文本文件

paramurl_pathstr

Returns

bool

funcget_file_size(url) -> int | None

获取文件大小 (不安全的, 有可能无法获取到正确大小)

Args: url (str): 网址

Returns: Union[int, None]: 文件大小（单位：字节）

paramurlstr

Returns

int | None

funcdownload_file_chunk(url, start_byte, end_byte, save_dir) -> int

下载文件的代码块

Args: url (str): 文件的 URL 地址 start_byte (int): 下载的起始字节位置 end_byte (int): 下载的结束字节位置 save_dir (str): 文件保存的目录

Returns: int: 已下载的字节数

paramurlstr

paramstart_byteint

paramend_byteint

paramsave_dirstr

Returns

int

funcdownload_file_singlethreaded(url, save_dir) -> None

下载单个文件

Args: url (str): 文件的 URL 地址 save_dir (str): 文件保存的目录 ignore_warnings (bool, optional): 是否忽略警告

paramurlstr

paramsave_dirstr

Returns

None

funcdownload_unknown_file(url, save_dir) -> None

下载未知文件

Args: url (str): 文件的 URL 地址 save_dir (str): 文件保存的目录

paramurlstr

paramsave_dirstr

Returns

None

functest_site_latency(urls, timeout) -> list[tuple[str, float]]

测试网站延迟

Args: Da (dict): 包含 URL 和镜像 URL 的字典: {"url": ..., "m}

Returns: list: 按延迟排序的 URL 和延迟时间的元组列表

paramurlstuple[str, ...]

paramtimeoutfloat

Returns

list[tuple[str, float]]

funcmeasure_latencyt(url, timeout) -> float

测量延迟

Args: url (str): 网址

Raises: ValueError: 无效的网址

Returns: float: 延迟时间

paramurlstr

paramtimeoutfloat

Returns

float

funcget_free_port(start=2000, end=65535) -> int

获取空闲端口号

Args: start (int, optional): 起始端口号. end (int, optional): 结束端口号.

Raises: Exception: 未找到空闲端口

Returns: int: 空闲端口号

paramstartint

= 2000

paramendint

= 65535

Returns

int

funccheck_update() -> None

检查更新

Returns

None

funcget_newest_dependency_commit(mirror_src) -> str

获取最新的 commit

Args: mirror_src (str): like "https://ghproxy.com"

parammirror_srcstr

Returns

str