s3file

type Options struct {
	// ServerSideEncryption allows you to set the `ServerSideEncryption` value to use when
	// uploading files (e.g.  "AES256")
	ServerSideEncryption string
}

type SessionProvider interface {
	// Get returns AWS sessions that can be used to perform in.S3IAMAction on
	// s3://{in.bucket}/{in.key}.
	//
	// s3file maintains an internal cache keyed by *session.Session that is only pruned
	// occasionally. Get() is called for every S3 operation so it should be very fast. Caching
	// (that is, reusing *session.Session whenever possible) is strongly encouraged.
	//
	// Get() must return >= 1 session, or error. If > 1, the S3 operation will be tried
	// on each session in unspecified order until it succeeds.
	//
	// Note: Some implementations will not need SessionProviderInput and can just ignore it.
	//
	// TODO: Consider passing chan<- *session.Session (implementer sends and then closes)
	// so s3file can try credentials as soon as they're available.
	Get(_ context.Context, in SessionProviderInput) ([]*session.Session, error)
}

type SessionProviderInput struct {
	// S3IAMAction is an action name from this list:
	// https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazons3.html
	//
	// Note: There is no `s3:` prefix.
	//
	// Note: This is different from the notion of "action" in the S3 API documentation:
	// https://docs.aws.amazon.com/AmazonS3/latest/API/API_Operations.html
	// Some names, like GetObject, appear in both; others, like HeadObject, do not.
	S3IAMAction string
	// Bucket and Key describe the API operation to be performed, if applicable.
	Bucket, Key string
}