artifact

type Artifact struct {
	// Name is the name of the artifact
	Name string

	// Repository is the repository of the source
	// e.g. the helm repository or the github repository
	Repository string

	// Branch is the branch of the source
	Branch string

	// Tag is the tag of the source
	Tag string

	// CommitHash is the commit hash of the source
	CommitHash string

	// Version is the version of the source
	// e.g. the version of the helm chart or github release
	Version string

	// URL is the URL of the source
	URL string

	// AssetName is the file name of the asset to be downloaded
	// typically used for archives
	AssetName string

	// RelativePath is a subdirectory relative to the souce root directory that is
	// used for the basis in the component. Leading slashes are removed.
	// e.g. 'my/path' in the checkout of git URL
	// 'https://github.com/my/repo.git' would use 'my/path' as the directory
	// where the source is found
	RelativePath string

	// BaseDir is the directory where the artifact is stored
	// It does not include the directory for the artifact itself
	BaseDir string
}

type Downloader interface {
	// Download downloads a file from the given URL to the given destination
	Download(url, dest string) (int64, error)
}

type PullResult struct {
	// Dir is the directory where the artifact was pulled to
	Dir string

	// If the puller discovers a version, it will be stored here
	Version string
}