download

Documentation

Index

• func Download(d Downloader) (io.ReadCloser, error)
• func SaveTo(ctx *log.Context, d Downloader, dst string, mode os.FileMode) (int64, error)
• func WithRetries(ctx *log.Context, d Downloader, sf SleepFunc) (io.ReadCloser, error)
• type Downloader
  • func NewBlobDownload(accountName, accountKey string, blob blobutil.AzureBlobRef) Downloader
  • func NewURLDownload(url string) Downloader
• type SleepFunc

Functions

func Download

func Download(d Downloader) (io.ReadCloser, error)

Download retrieves a response body and checks the response status code to see if it is 200 OK and then returns the response body. It issues a new request every time called. It is caller's responsibility to close the response body.

func SaveTo

func SaveTo(ctx *log.Context, d Downloader, dst string, mode os.FileMode) (int64, error)

SaveTo uses given downloader to fetch the resource with retries and saves the given file. Directory of dst is not created by this function. If a file at dst exists, it will be truncated. If a new file is created, mode is used to set the permission bits. Written number of bytes are returned on success.

func WithRetries

func WithRetries(ctx *log.Context, d Downloader, sf SleepFunc) (io.ReadCloser, error)

WithRetries retrieves a response body using the specified downloader. Any error returned from d will be retried (and retrieved response bodies will be closed on failures). If the retries do not succeed, the last error is returned.

It sleeps in exponentially increasing durations between retries.

Types

type Downloader

type Downloader interface {
	// GetRequest returns a new GET request for the resource.
	GetRequest() (*http.Request, error)
}

Downloader describes a method to download files.

func NewBlobDownload

func NewBlobDownload(accountName, accountKey string, blob blobutil.AzureBlobRef) Downloader

NewBlobDownload creates a new Downloader for a blob hosted in Azure Blob Storage.

func NewURLDownload

func NewURLDownload(url string) Downloader

NewURLDownload creates a new downloader with the provided URL

type SleepFunc

type SleepFunc func(d time.Duration)

SleepFunc pauses the execution for at least duration d.

var (
	// ActualSleep uses actual time to pause the execution.
	ActualSleep SleepFunc = time.Sleep
)