cloud

type AWSComputeProperties struct {
	FilterTags map[string]string
}

type AWSStorageProperties struct {
	Region string

	// size of block when uploading
	// blocks to a blob concurrently
	BlockSize int64

	// Concurrency
	UploadConcurrency   int
	DownloadConcurrency int
}

type AzureStorageProperties struct {

	// size of block when
	// appending to a blob
	AppendBlockSize int
	// size of block when uploading
	// blocks to a blob concurrently
	PutBlockSize int64
}

type Compute interface {

	// Properties that customize the behavior of
	// the Compute API such as search filters.
	SetProperties(props interface{})

	// Retreives a compute instance.
	GetInstance(name string) (ComputeInstance, error)

	// Retrieves instances having the given ids
	GetInstances(ids []string) ([]ComputeInstance, error)

	// Returns a list of all compute instances
	// within this cloud compute context
	ListInstances() ([]ComputeInstance, error)
}

type ComputeInstance interface {
	ID() string
	Name() string
	PublicIP() string
	PublicDNS() string

	// Returns the instance's run state
	State() (InstanceState, error)

	// Start the instance.
	Start() error

	// Restart the instance
	Restart() error

	// Stop the instance
	Stop() error

	// Tests connectivity on a
	// given TCP port accepts
	CanConnect(port int) bool
}

type GoogleComputeProperties struct {
	Region,
	Zone string

	// timeout for start/stop operations
	OpTimeout time.Duration

	FilterLabels map[string]string
}

type GoogleStorageProperties struct {
	Region string

	// size of block when uploading
	// blocks to a blob concurrently
	BlockSize int
}

type InstanceState int

type Storage interface {
	SetProperties(props interface{})

	// Creates a storage instance. In the case of AWS S3
	// or Google cloud storage this will be a bucket. For
	// Azure this would be a blob container.
	NewInstance(name string) (StorageInstance, error)

	// Returns a list of all storage instance within
	// this cloud storage context
	ListInstances() ([]StorageInstance, error)
}

type StorageInstance interface {
	Name() string
	Delete() error

	ListObjects(path string) ([]string, error)
	DeleteObject(path string) error

	Upload(name, contentType string, data io.Reader, size int64) error
	UploadFile(name, contentType, path string) error

	Download(name string, data io.Writer) error
	DownloadFile(name, path string) error
}