awsdouble

README

AWSDouble

Generated Test Doubles for aws-sdk-go

Implements the complete iface.API interfaces as test doubles

API methods can be stubbed, mocked, spied on or faked

Default Fakes

Default fake implementations are supplied for

• actionWithContext() , returns ctx.Canceled if the context is canceled at the time the call is invoked
• actionPages() - repeatedly calls action paginating as per real requests
• WaitUntilwaiter - repeatedly calls the underlying action methods as per real waiters

This allows the basic action methods to be stubbed without regard for whether the system under test is using the context, pagination or waiter methods on the API.

Default Return Values

Default return values for stubs on the basic action methods that return (**action*Output, error) is a pointer to an empty struct, and a nil error.

For methods beginning with "Poll" the default return values are randomly delayed by 10ms to simulate a long poll

Timewarp

The double has a Timewarp function with the same signature as time.After. The default timewarp is to sleep for exactly 10ms regardless of the duration called in.

This means a waiter that has default of 20s between calls, will execute with actually 10ms between calls.

To test a waiter is waiting for the expected amount of time, use something like fakeclock

Documentation

Overview

Package service contains automatically generated AWS clients.

Index

• func AssertAwsInt64Equals(t *testing.T, prefix string, actual *int64, expected int64)
• func AssertAwsStringEquals(t *testing.T, prefix string, actual *string, expected string)
• func DefaultTimeWarp(_ time.Duration) <-chan time.Time
• func WithTimeWarp(ctx context.Context, warp Timewarp) context.Context
• type AWSTestDouble
  • func NewDouble(t dbl.T, forInterface interface{}, configurator ...func(c *AWSTestDouble)) *AWSTestDouble
  • func (d *AWSTestDouble) DefaultReturnValues(m dbl.Method) dbl.ReturnValues
  • func (d AWSTestDouble) Paginate(operationName string, paginators map[string]*request.Paginator, in interface{}, ...) error
  • func (d AWSTestDouble) PaginateWithContext(operationName string, paginators map[string]*request.Paginator, ...) error
  • func (d *AWSTestDouble) SetTimewarp(tw Timewarp)
  • func (d *AWSTestDouble) WaitUntil(waiterName string, waiters map[string]*Waiter, in interface{}) error
  • func (d *AWSTestDouble) WaitWithContext(waiterName string, waiters map[string]*Waiter, ctx context.Context, ...) error
• type Timewarp
  • func (tw Timewarp) SleepWithContext(ctx context.Context, duration time.Duration) error
• type Waiter

Functions

func AssertAwsInt64Equals

func AssertAwsInt64Equals(t *testing.T, prefix string, actual *int64, expected int64)

func AssertAwsStringEquals

func AssertAwsStringEquals(t *testing.T, prefix string, actual *string, expected string)

func DefaultTimeWarp

func DefaultTimeWarp(_ time.Duration) <-chan time.Time

This makes every duration wait for 10 ms

func WithTimeWarp

func WithTimeWarp(ctx context.Context, warp Timewarp) context.Context

Inject a Timewarp function into context

Types

type AWSTestDouble

type AWSTestDouble struct {
	*dbl.TestDouble
	//Replace this with a fakeclock implementation, otherwise default is that all sleeps are 10ms
	Timewarp
}

func NewDouble

func NewDouble(t dbl.T, forInterface interface{}, configurator ...func(c *AWSTestDouble)) *AWSTestDouble

Called by service specific doubles

func (*AWSTestDouble) DefaultReturnValues

func (d *AWSTestDouble) DefaultReturnValues(m dbl.Method) dbl.ReturnValues

func (AWSTestDouble) Paginate

func (d AWSTestDouble) Paginate(operationName string, paginators map[string]*request.Paginator, in interface{}, pager interface{}) error

func (AWSTestDouble) PaginateWithContext

func (d AWSTestDouble) PaginateWithContext(operationName string, paginators map[string]*request.Paginator, ctx context.Context, in interface{}, pager interface{}, options ...request.Option) error

func (*AWSTestDouble) SetTimewarp

func (d *AWSTestDouble) SetTimewarp(tw Timewarp)

func (*AWSTestDouble) WaitUntil

func (d *AWSTestDouble) WaitUntil(waiterName string, waiters map[string]*Waiter, in interface{}) error

func (*AWSTestDouble) WaitWithContext

func (d *AWSTestDouble) WaitWithContext(waiterName string, waiters map[string]*Waiter, ctx context.Context, in interface{}, wOptions ...request.WaiterOption) error

type Timewarp

type Timewarp func(d time.Duration) <-chan time.Time

Replacement for time.After - eg if you are using a fake clock

func (Timewarp) SleepWithContext

func (tw Timewarp) SleepWithContext(ctx context.Context, duration time.Duration) error

type Waiter

type Waiter struct {
	request.Waiter
	OperationName string
}