s3facade

package

v0.0.0-...-a5f7211 Latest Latest Go to latest Published: Apr 19, 2024 License: Apache-2.0 Imports: 5 Imported by: 1

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Because AWS SDK has so much ceremony..

This section is empty.

This section is empty.

func CredentialsFromEnv() (*credentials.Credentials, error)

pretty much same as AWS's credentials.NewEnvCredentials(), except this fails fast instead of when S3 operations are first called

type BucketContext struct {
	Name *string // pointer because all S3 operations take it as such
	S3   *s3.S3
}

func Bucket(
	bucket string,
	obtainCredentials CredentialsObtainer,
	region string,
) (*BucketContext, error)

giving nil "credentials" is supported, if you want the automatic procedure

func BucketWithConfig(bucket string, config *aws.Config) (*BucketContext, error)

type CredentialsObtainer func() (*credentials.Credentials, error)

this abstraction so we support immediate validation of credentials, unlike AWS's API

func Credentials(creds *credentials.Credentials) CredentialsObtainer

adapter for making from AWS's Credentials