fetch

type Artifact struct {
	Body        io.ReadCloser
	Size        int64 // -1 if unknown
	ContentType string
	ETag        string
}

type ArtifactInfo struct {
	URL       string
	Filename  string
	Integrity string // sha256-... or sha512-...
	Size      int64  // Zero when the registry does not publish a size.
}

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

type FetchObservation struct {
	RequestedURL string
	FinalURL     string
	ResponseTime time.Duration // Time until the final response headers arrived.
	StatusCode   int
	Headers      http.Header // Allow-listed response headers only.
	DeclaredSize int64
	MediaType    string
	ByteCount    int64
	Digests      map[string]string
	Complete     bool
}

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

type FetcherInterface interface {
	Fetch(ctx context.Context, url string) (*Artifact, error)
	FetchWithHeaders(ctx context.Context, url string, headers http.Header) (*Artifact, error)
	Head(ctx context.Context, url string) (size int64, contentType string, err error)
}

type ObservedArtifact struct {
	*Artifact
	Observation *FetchObservation
}

type Option func(*Fetcher)

type Registry interface {
	Ecosystem() string
	FetchVersions(ctx context.Context, name string) ([]registries.Version, error)
	URLs() client.URLBuilder
}

type ResolveOptions struct {
	Filename  string
	Integrity string
	// Qualifiers are PURL qualifiers. Those in selectionQualifiers pick among
	// the artifacts a registry lists for a version; an artifact that does not
	// record a qualifier is not ruled out by it. repository_url and channel
	// choose the registry, which is up to the caller, and are ignored here.
	Qualifiers map[string]string
}

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

type ResolverOption func(*Resolver)