bucket

type Bucket interface {
	// Upload File(s) to the bucket.
	//
	// Implementor must check if File.Data() implements io.Closer and call Close() on it after the upload is complete.
	//
	// Whether the upload is successful or not, the implementor must call File.Close() on all files received.
	//
	// UploadResult.File must be filled with File of the same index and UploadResult.Error must be filled with error if
	// upload operation fails.
	//
	// The number of UploadResult must be the same as the number of files in the parameter.
	Upload(ctx context.Context, files []File) []UploadResult
}

type File interface {
	Data() io.Reader
	Filename() string
	ContentType() string
	Read(p []byte) (n int, err error)
	Pretext() string
	Size() int
	Close() error
}

type FileOption interface {
	// contains filtered or unexported methods
}

type FileOptionFunc func(*file)

type LengthHint interface {
	Len() int
}

type UploadResult struct {
	// The URL of the uploaded file, if successful.
	URL string
	// The file instance used to upload the file.
	// The body of this file may have already been garbage collected.
	// So do not consume this file content again and only use the remaining metadata.
	File File
	// If Error is not nil, the upload is considered failed.
	Error error
}