下载类

type Client struct {
	// HTTPClient 指定了在文件传输过程中与远程服务器通信所使用的 http.Client。
	// md5:18f90ae2438c3d95
	HTTPClient HTTPClient

	// UserAgent 指定将设置为此客户端的所有请求的头中的 User-Agent 字符串。
	//
	// 可以在每个请求的头中覆盖 User-Agent 字符串。
	// md5:416ff171bdbaf067
	HTTP_UA string

	// BufferSize 指定了用于传输所有请求文件的缓冲区的大小（以字节为单位）。较大的缓冲区可能会提高吞吐量，但会消耗更多内存，并导致传输进度统计更新更不频繁。每个请求的BufferSize可以在每个Request对象上重写。默认值：32KB。
	// md5:76d8523deca24178
	X缓冲区大小 int
}

type HTTPClient interface {
	Do(req *http.Request) (*http.Response, error)
}

type Hook func(*Response) error

type RateLimiter interface {
	WaitN(ctx context.Context, n int) (err error)
}

type Request struct {
	// Label是一个任意字符串，可以用来将Request标记为一个用户友好的名称。
	// md5:48c76f58a675938f
	X名称 string

	// Tag 是一个任意的接口，可以用来将请求与其他数据相关联。
	// md5:cca083a2da336d7a
	Tag interface{}

	// HTTPRequest 指定了要发送到远程服务器以启动文件传输的HTTP请求。它包括URL、协议版本、HTTP方法、请求头和身份验证等请求配置信息。
	// md5:8b29a36ebccc4fbf
	Http协议头 *http.Request

	// Filename 指定了文件传输将在本地存储的位置。如果 Filename 为空或是一个目录，将使用 Content-Disposition 头部或请求 URL 来解析实际的文件名。
	//
	// 空字符串表示文件传输将存储在当前工作目录下。
	// md5:b2487dc28865af4e
	X文件名 string

	// SkipExisting 指定如果目标路径已经存在，应该返回 ErrFileExists 错误。不会检查已存在的文件是否完整。
	// md5:fcfcc6296df94857
	X跳过已存在文件 bool

	// NoResume 指定在不尝试恢复任何现有文件的情况下，部分下载将被重新启动。如果下载已经完整完成，它将不会被重新启动。
	// md5:5d7097b2011a8aed
	X不续传 bool

	// NoStore 指定 grab 不应将内容写入本地文件系统。相反，下载的内容将存储在内存中，仅可通过 Response.Open 或 Response.Bytes 访问。
	// md5:b250d7f0915c2e35
	X不写入本地文件系统 bool

	// NoCreateDirectories 指定在给定的Filename路径中，任何缺失的目录不应该自动创建，如果它们尚不存在的话。
	// md5:f9491a6bdafa1a03
	X不自动创建目录 bool

	// IgnoreBadStatusCodes 指定grab应该接受远程服务器返回的任何状态码。否则，grab期望响应状态码在200（跟随重定向后）范围内。
	// md5:0cfc61395f3c8fda
	X忽略错误状态码 bool

	// IgnoreRemoteTime 指定 grab 不应尝试将本地文件的时间戳设置为与远程文件匹配。
	// md5:4b121c28c096e635
	X忽略远程时间 bool

	// Size 指定如果已知的话，文件传输的预期大小。如果服务器响应的大小与预期不符，
	// 传输将被取消并返回 ErrBadLength 错误。
	// md5:4d6feeb012ab2e19
	X预期文件大小 int64

	// BufferSize 指定了用于传输请求文件的缓冲区的字节数。更大的缓冲区可能会提高吞吐量，但会消耗更多内存，并减少传输进度统计信息的更新频率。如果配置了速率限制器，BufferSize 应远低于速率限制。默认值：32KB。
	// md5:c943b23cdf634593
	X缓冲区大小 int

	// RateLimiter 用于限制下载的传输速率。给定的 Request.BufferSize 决定了RateLimiter将多久被查询一次。
	// md5:86949911252236b7
	X速率限制器 RateLimiter

	// BeforeCopy 是用户提供的回调函数，它在请求开始下载之前立即被调用。如果 BeforeCopy 返回错误，请求将被取消，并且相同的错误将返回在响应对象中。
	// md5:865a949d97572fb2
	X传输开始之前回调 Hook

	// AfterCopy 是用户提供的回调，它在请求下载完成后立即调用，但在校验和验证和关闭之前。此钩子仅在传输成功时调用。如果 AfterCopy 返回错误，请求将被取消，并在 Response 对象上返回相同的错误。
	// md5:9e8a840d6dbbf503
	X传输完成之后回调 Hook
	// contains filtered or unexported fields
}

type Response struct {
	// 提交以获取此响应的请求。 md5:75fc5e8790cf3c19
	X下载参数 *Request

	// HTTPResponse 表示从 HTTP 请求接收到的 HTTP 响应。
	//
	// 响应体不应该被使用，因为它会被 grab 消费并关闭。
	// md5:de050e04bc066b54
	HTTP响应 *http.Response

	// Filename 指定了文件传输在本地存储中的路径。
	// md5:2739dccaf6d8bae1
	X文件名 string

	// Start 指定文件传输开始的时间。 md5:0b7ef91daaa881e6
	X传输开始时间 time.Time

	// End 指定文件传输完成的时间。
	//
	// 在传输完成之前，此函数将返回零值。
	// md5:22aad30fb1342e5f
	X传输完成时间 time.Time

	// CanResume 指定远程服务器已宣布它可以恢复以前的下载，因为已设置 "Accept-Ranges: bytes" 头。
	// md5:d5b949adac4b5a26
	CanResume bool

	// DidResume 指定文件传输恢复了先前未完成的传输。
	// md5:9e59c01300744b13
	DidResume bool

	// Done 在传输完成时关闭，无论是成功还是出现错误。可以通过 Response.Err 获取错误信息。
	// md5:a87b182e4efaa89f
	Done chan struct{}
	// contains filtered or unexported fields
}

type StatusCodeError int