source

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

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

type Options struct {
	Branch string // Branch override for remote repository sources.
	SubDir string // Subdirectory to use inside the source.
}

type ReadableSource interface {
	Source

	// ReadFile reads a file relative to the source root.
	ReadFile(path string) ([]byte, error)

	// ListFiles lists files matching a glob pattern relative to the source root.
	ListFiles(pattern string) ([]string, error)

	// Resolve normalizes a relative path inside the source.
	Resolve(base, rel string) string
}

type Source interface {
	// Prepare returns a local readable directory for the source content.
	Prepare() (string, error)

	// Cleanup releases temporary resources such as cloned repositories.
	Cleanup() error

	// Type returns the source type identifier, for example "local" or "github".
	Type() string
}