offline

离线下载

这个模块提供了一些和离线下载有关的函数

p115client.tool.offline.offline_iter(client: str | PathLike | P115Client | P115OpenClient, /, page_start: int = 1, page_stop: int = -1, cooldown: float = 0, raise_for_update: bool = False, use_open_api: bool = False, *, async_: Literal[False] = False, **request_kwargs) → Iterator[dict]

p115client.tool.offline.offline_iter(client: str | PathLike | P115Client | P115OpenClient, /, page_start: int = 1, page_stop: int = -1, cooldown: float = 0, raise_for_update: bool = False, use_open_api: bool = False, *, async_: Literal[True], **request_kwargs) → AsyncIterator[dict]

遍历任务列表，获取任务信息

Tip

在逐页拉取的间隔期间，任务列表可能发生变化，可能导致重复和遗漏：

1. 新增任务，特别是状态为进行中

2. 删除任务

3. 曾经取得的进行中的任务，变为完成

Parameters:

• client – 115 客户端或 cookies

• page_start – 开始页数

• page_stop – 结束页数（不含），如果 <= 0，则不限

• cooldown – 接口调用冷却时间，单位：秒

• raise_for_update – 当列表发生更新时，是否报错退出

• use_open_api – 是否使用 open api

• async – 是否异步

• request_kwargs – 其它请求参数

Returns:

迭代器，返回任务信息

p115client.tool.offline.offline_restart_iter(client: str | PathLike | P115Client, /, predicate: None | Callable[[dict], bool] = None, *, async_: Literal[False] = False, **request_kwargs) → Iterator[dict]

p115client.tool.offline.offline_restart_iter(client: str | PathLike | P115Client, /, predicate: None | Callable[[dict], bool] = None, *, async_: Literal[True], **request_kwargs) → AsyncIterator[dict]

重试任务：重试那些因为空间不足而转存失败的任务

Parameters:

• client – 115 客户端或 cookies

• predicate – 断言，用于筛选

• async – 是否异步

• request_kwargs – 其它请求参数

Returns:

迭代器，逐个任务返回执行重试后的响应