remote

type Acquirer interface {
	Acquire(ctx context.Context, request Request, opts Options) (Result, error)
}

type Credentials struct {
	Username    string
	Password    string
	BearerToken string
}

type DefaultAcquirer struct {
	Client   *http.Client
	MaxBytes int64
}

type GitCredentials struct {
	Username          string
	Password          string
	BearerToken       string
	SSHPrivateKeyPath string
	SSHPrivateKey     string
	SSHPassphrase     string
	SSHKnownHostsPath string
}

type Options struct {
	CacheDir       string
	Offline        bool
	Refresh        bool
	ForbiddenRoots []string
	Credentials    Credentials
	GitCredentials GitCredentials
}

type Request struct {
	URL      string
	Kind     RequestKind
	RepoURL  string
	Revision string
}

type RequestKind string

type Result struct {
	Path      string
	URL       string
	Revision  string
	FromCache bool
	// Release releases any read lock or temporary resource associated with Path.
	// Callers that receive a non-nil Release must call it exactly once after they
	// finish copying from Path. Release implementations must be idempotent so
	// defensive double-calls are harmless.
	Release func()
}