148 lines
4.1 KiB
Python
148 lines
4.1 KiB
Python
# -*- coding:utf-8 -*-
|
|
from pathlib import Path
|
|
from typing import Union, Literal, Optional
|
|
|
|
from DrissionPage import SessionOptions
|
|
from DrissionPage._base.base import BasePage
|
|
from requests import Session
|
|
|
|
from .drissionGet import DrissionGet
|
|
|
|
FILE_EXISTS = Literal['add', 'skip', 'rename', 'overwrite', 'a', 's', 'r', 'o']
|
|
|
|
|
|
class Setter(object):
|
|
_owner: DrissionGet = ...
|
|
|
|
def __init__(self, owner: DrissionGet):
|
|
"""
|
|
:param owner: DrissionGet对象
|
|
"""
|
|
...
|
|
|
|
@property
|
|
def if_file_exists(self) -> FileExists:
|
|
"""返回用于设置文件同名策略的对象"""
|
|
...
|
|
|
|
def log(self, path: Union[str, Path, None] = 'DrissionGet_log.csv', failed_only: bool = False) -> Setter:
|
|
"""设置下载完成日志
|
|
:param path: 日志文件路径,为None或False不记录
|
|
:param failed_only: 是否只记录失败任务
|
|
:return: Setter对象自己
|
|
"""
|
|
...
|
|
|
|
def show_msg(self, on_off: bool = True, failed_only: bool = False) -> Setter:
|
|
"""设置是否打印下载信息
|
|
:param on_off: bool代表开关
|
|
:param failed_only: 是否只显示失败任务,此设置仅多线程任务时生效
|
|
:return: Setter对象自己
|
|
"""
|
|
...
|
|
|
|
def driver(self, driver: Union[Session, BasePage, SessionOptions]) -> Setter:
|
|
"""设置驱动
|
|
:param driver: Session对象或DrissionPage的页面对象
|
|
:return: Setter对象自己
|
|
"""
|
|
...
|
|
|
|
def roads(self, num: int) -> Setter:
|
|
"""设置可同时运行的线程数
|
|
:param num: 线程数量
|
|
:return: Setter对象自己
|
|
"""
|
|
...
|
|
|
|
def retry(self, times: int) -> Setter:
|
|
"""设置连接失败时重试次数
|
|
:param times: 重试次数
|
|
:return: Setter对象自己
|
|
"""
|
|
...
|
|
|
|
def interval(self, seconds: float) -> Setter:
|
|
"""设置连接失败时重试间隔
|
|
:param seconds: 连接失败时重试间隔(秒)
|
|
:return: Setter对象自己
|
|
"""
|
|
...
|
|
|
|
def timeout(self, seconds: float) -> Setter:
|
|
"""设置连接超时时间
|
|
:param seconds: 超时时间(秒)
|
|
:return: Setter对象自己
|
|
"""
|
|
...
|
|
|
|
def save_path(self, path: Union[str, Path]) -> Setter:
|
|
"""设置文件保存路径
|
|
:param path: 文件路径,可以是str或Path
|
|
:return: Setter对象自己
|
|
"""
|
|
...
|
|
|
|
def split(self, on_off: bool = True) -> Setter:
|
|
"""设置大文件是否分块下载
|
|
:param on_off: bool代表开关
|
|
:return: Setter对象自己
|
|
"""
|
|
...
|
|
|
|
def block_size(self, size: Union[str, int]) -> Setter:
|
|
"""设置分块大小
|
|
:param size: 单位为字节,可用'K'、'M'、'G'为单位,如'50M'
|
|
:return: Setter对象自己
|
|
"""
|
|
...
|
|
|
|
def proxies(self, http: str = None, https: str = None) -> Setter:
|
|
"""设置代理地址及端口,例:'127.0.0.1:1080'
|
|
:param http: http代理地址及端口
|
|
:param https: https代理地址及端口
|
|
:return: Setter对象自己
|
|
"""
|
|
...
|
|
|
|
def encoding(self, encoding: Optional[str]) -> Setter:
|
|
"""设置编码
|
|
:param encoding: 编码名称,传入None取消之前的设置
|
|
:return: Setter对象自己
|
|
"""
|
|
...
|
|
|
|
|
|
class FileExists(object):
|
|
"""用于设置存在同名文件时处理方法"""
|
|
_setter: Setter = ...
|
|
|
|
def __init__(self, setter: Setter):
|
|
"""
|
|
:param setter: Setter对象
|
|
"""
|
|
...
|
|
|
|
def __call__(self, mode: FILE_EXISTS) -> Setter:
|
|
"""设置文件存在时的处理方式
|
|
:param mode: 'skip', 'rename', 'overwrite', 'add', 's', 'r', 'o', 'a'
|
|
:return: Setter 对象
|
|
"""
|
|
...
|
|
|
|
def skip(self) -> Setter:
|
|
"""设为跳过"""
|
|
...
|
|
|
|
def rename(self) -> Setter:
|
|
"""设为重命名,文件名后加序号"""
|
|
...
|
|
|
|
def overwrite(self) -> Setter:
|
|
"""设为覆盖"""
|
|
...
|
|
|
|
def add(self) -> Setter:
|
|
"""设为追加"""
|
|
...
|