awstestutil

README

Package cloudeng.io/aws/awstestutil

import cloudeng.io/aws/awstestutil

Package awsutil provides support for testing AWS packages and applications.

Functions

Func AWSTestMain

func AWSTestMain(m *testing.M, service **AWS, opts ...Option)

Func DefaultAWSConfig

func DefaultAWSConfig() aws.Config

Func SkipAWSTests

func SkipAWSTests(t *testing.T)

Types

Type AWS

type AWS struct {
	// contains filtered or unexported fields
}

Functions

func NewLocalAWS(opts ...Option) *AWS

Methods

func (a *AWS) EC2(cfg aws.Config) *ec2.Client

func (a *AWS) KMS(cfg aws.Config) *kms.Client

func (a *AWS) S3(cfg aws.Config) *s3.Client

func (a *AWS) SESV2(cfg aws.Config) *sesv2.Client

func (a *AWS) SecretsManager(cfg aws.Config) *secretsmanager.Client

func (a *AWS) Start() error

func (a *AWS) Stop() error

func (a *AWS) URL() string

Type Option

type Option func(o *Options)

Functions

func WithDebug(log io.Writer) Option

func WithEC2() Option

func WithKMS() Option

func WithS3() Option

func WithS3Tree(dir string) Option

WithS3Tree configures the local S3 instance with the contents of the specified directory. The first level of directories under dir are used as bucket names, the second and deeper levels as prefixes and objects within those buckets etc.

func WithSES() Option

func WithSecretsManager() Option

Type Options

type Options struct {
	// contains filtered or unexported fields
}

Type Service

type Service string

Constants

S3, SecretsManager, SES

S3 Service = Service(localstack.S3)
SecretsManager Service = Service(localstack.SecretsManager)
SES Service = Service(localstack.SES)

Documentation

Overview

Package awsutil provides support for testing AWS packages and applications.

Index

• func AWSTestMain(m *testing.M, service **AWS, opts ...Option)
• func DefaultAWSConfig() aws.Config
• func SkipAWSTests(_ *testing.T)
• type AWS
  • func NewLocalAWS(opts ...Option) *AWS
  • func (a *AWS) EC2(cfg aws.Config) *ec2.Client
  • func (a *AWS) KMS(cfg aws.Config) *kms.Client
  • func (a *AWS) S3(cfg aws.Config) *s3.Client
  • func (a *AWS) SESV2(cfg aws.Config) *sesv2.Client
  • func (a *AWS) SecretsManager(cfg aws.Config) *secretsmanager.Client
  • func (a *AWS) Start() error
  • func (a *AWS) Stop() error
  • func (a *AWS) URL() string
• type Option
  • func WithDebug(log io.Writer) Option
  • func WithEC2() Option
  • func WithKMS() Option
  • func WithS3() Option
  • func WithS3Tree(dir string) Option
  • func WithSES() Option
  • func WithSecretsManager() Option
• type Options
• type Service

Functions

func AWSTestMain

func AWSTestMain(m *testing.M, service **AWS, opts ...Option)

func DefaultAWSConfig

func DefaultAWSConfig() aws.Config

func SkipAWSTests

func SkipAWSTests(_ *testing.T)

Types

type AWS

type AWS struct {
	// contains filtered or unexported fields
}

func NewLocalAWS

func NewLocalAWS(opts ...Option) *AWS

func (*AWS) EC2

func (a *AWS) EC2(cfg aws.Config) *ec2.Client

func (*AWS) KMS

func (a *AWS) KMS(cfg aws.Config) *kms.Client

func (*AWS) S3

func (a *AWS) S3(cfg aws.Config) *s3.Client

func (*AWS) SESV2

func (a *AWS) SESV2(cfg aws.Config) *sesv2.Client

func (*AWS) SecretsManager

func (a *AWS) SecretsManager(cfg aws.Config) *secretsmanager.Client

func (*AWS) Start

func (a *AWS) Start() error

func (*AWS) Stop

func (a *AWS) Stop() error

func (*AWS) URL

func (a *AWS) URL() string

type Option

type Option func(o *Options)

func WithDebug

func WithDebug(log io.Writer) Option

func WithEC2

func WithEC2() Option

func WithKMS

func WithKMS() Option

func WithS3

func WithS3() Option

func WithS3Tree

func WithS3Tree(dir string) Option

WithS3Tree configures the local S3 instance with the contents of the specified directory. The first level of directories under dir are used as bucket names, the second and deeper levels as prefixes and objects within those buckets etc.

func WithSES

func WithSES() Option

func WithSecretsManager

func WithSecretsManager() Option

type Options

type Options struct {
	// contains filtered or unexported fields
}

type Service

type Service string

const (
	S3             Service = Service(localstack.S3)
	SecretsManager Service = Service(localstack.SecretsManager)
	SES            Service = Service(localstack.SES)
)