fetchurl

README

fetchurl

Simple caching server for URLs with a hash.

Documentation

Index

• Variables
• type FetchOptions
• type Fetcher
  • func NewFetcher(client *http.Client) *Fetcher
  • func (f *Fetcher) Fetch(ctx context.Context, opts FetchOptions) error
• type HTTPStatusError
  • func (e *HTTPStatusError) Error() string

Variables

var (
	// ErrUnsupportedAlgorithm is returned when the requested hash algorithm is not supported.
	ErrUnsupportedAlgorithm = errors.New("unsupported algorithm")

	// ErrHashMismatch is returned when the downloaded content does not match the expected hash.
	ErrHashMismatch = errors.New("hash mismatch")

	// ErrPartialWrite is returned when data was already written to Out before a failure occurred,
	// making fallback to another source unsafe.
	ErrPartialWrite = errors.New("partial write")

	// ErrAllSourcesFailed is returned when no server or direct source could provide the content.
	ErrAllSourcesFailed = errors.New("all sources failed")
)

Types

type FetchOptions

type FetchOptions struct {
	Algo string
	Hash string
	URLs []string
	Out  io.Writer
}

type Fetcher

type Fetcher struct {
	Client  *http.Client
	Servers []string
}

func NewFetcher

func NewFetcher(client *http.Client) *Fetcher

func (*Fetcher) Fetch

func (f *Fetcher) Fetch(ctx context.Context, opts FetchOptions) error

type HTTPStatusError

type HTTPStatusError struct {
	StatusCode int
}

HTTPStatusError is returned when a source responds with a non-200 status code.

func (*HTTPStatusError) Error

func (e *HTTPStatusError) Error() string