drivers

type Connector interface {
	// Connect creates a connection to a dagger instance.
	//
	// Connect can be called multiple times during attempts to establish a
	// connection - but a connector can choose to block this call until
	// previously returned connections have been closed.
	Connect(ctx context.Context) (net.Conn, error)

	// If available, a unique identifier for the engine, otherwise empty string.
	EngineID() string
}

type DaggerCloudConnector struct {
	EngineSpec cloud.EngineSpec
}

type Driver interface {
	// Available returns true if the driver backend is running and available for use.
	Available(ctx context.Context) (bool, error)

	// Provision creates any underlying resources for a driver, and returns a
	// Connector that can connect to it.
	Provision(ctx context.Context, url *url.URL, opts *DriverOpts) (Connector, error)

	// ImageLoader returns an optional associated image loader - not all
	// drivers will have this!
	ImageLoader(ctx context.Context) imageload.Backend
}

type DriverOpts struct {
	DaggerCloudToken string
	GPUSupport       string
	Module           string
	Function         string
	ExecCmd          []string
	ClientID         string
	CloudAuth        *auth.Cloud
}

type Scheme struct {
	// Scheme is the key that the driver registry uses.
	Scheme string
	// Value is the form to write after `--engine=`.
	Value string
	// Note explains the value when the syntax alone is not enough.
	Note string
	// Group titles a set of related values in the help topic.
	Group string
	// Primary marks a value that the short flag usage names.
	Primary bool
	// Deprecated marks a value that remains for compatibility. Help and
	// completion leave these out; the help topic still lists them.
	Deprecated bool
}