client

type Client struct {
	// contains filtered or unexported fields
}

type Destination interface {
	io.Writer
	Delete() error
}

type ErrDecodeFailed struct {
	File string
	Err  error
}

type ErrDownloadFailed struct {
	File string
	Err  error
}

type ErrInvalidURL struct {
	URL string
}

type ErrLatestSnapshot struct {
	Version int
}

type ErrMetaTooLarge struct {
	Name    string
	Size    int64
	MaxSize int64
}

type ErrMissingRemoteMetadata struct {
	Name string
}

type ErrNotFound struct {
	File string
}

type ErrUnknownTarget struct {
	Name string
}

type ErrWrongSize struct {
	File     string
	Actual   int64
	Expected int64
}

type HTTPRemoteOptions struct {
	MetadataPath string
	TargetsPath  string
	UserAgent    string
	Retries      *HTTPRemoteRetries
}

type HTTPRemoteRetries struct {
	Delay time.Duration
	Total time.Duration
}

type LocalStore interface {
	// GetMeta returns top-level metadata from local storage. The keys are
	// in the form `ROLE.json`, with ROLE being a valid top-level role.
	GetMeta() (map[string]json.RawMessage, error)

	// SetMeta persists the given top-level metadata in local storage, the
	// name taking the same format as the keys returned by GetMeta.
	SetMeta(name string, meta json.RawMessage) error
}

type RemoteStore interface {
	// GetMeta downloads the given metadata from remote storage.
	//
	// `name` is the filename of the metadata (e.g. "root.json")
	//
	// `err` is ErrNotFound if the given file does not exist.
	//
	// `size` is the size of the stream, -1 indicating an unknown length.
	GetMeta(name string) (stream io.ReadCloser, size int64, err error)

	// GetTarget downloads the given target file from remote storage.
	//
	// `path` is the path of the file relative to the root of the remote
	//        targets directory (e.g. "/path/to/file.txt").
	//
	// `err` is ErrNotFound if the given file does not exist.
	//
	// `size` is the size of the stream, -1 indicating an unknown length.
	GetTarget(path string) (stream io.ReadCloser, size int64, err error)
}