fetch

type Archive struct {
	URLs        []string
	Integrity   string
	StripPrefix string
	Patches     []Patch

	// Fprint should be a hash computed from information that is enough to distinguish this archive fetch from
	// others. It will be used as the name of the shared repo directory.
	// The field is not called Fingerprint to avoid conflict with the method name.
	Fprint string
}

type Fetcher interface {
	// Fetch performs the fetch and returns the absolute path to the local directory where the fetched contents can be
	// accessed.
	// If vendorDir is non-empty, we're operating in vendoring mode; Fetch should make the contents available under
	// vendorDir if appropriate. Otherwise, Fetch is free to place the contents wherever.
	Fetch(vendorDir string) (string, error)

	// Fingerprint returns a fingerprint of the fetched contents. When the fingerprint changes, it's a signal that the
	// repo should be re-fetched. Note that the fingerprint need not necessarily be calculated from the actual bytes of
	// fetched contents.
	Fingerprint() string

	// AppendPatches appends an extra set of patches to the Fetcher. This can return an error if, for example, this
	// Fetcher doesn't support patches.
	AppendPatches(patches []Patch) error
}

type Git struct {
	Repo    string
	Commit  string
	Patches []Patch
}

type LocalPath struct {
	Path string
}

type Patch struct {
	PatchFile  string
	PatchStrip int
}

type Wrapper struct {
	Archive   *Archive   `json:",omitempty"`
	Git       *Git       `json:",omitempty"`
	LocalPath *LocalPath `json:",omitempty"`
}