Go SDK

Install and use the fakecloud SDK for Go tests.

Install

go get github.com/faiscadev/fakecloud/sdks/go

Go 1.21+.

Initialize

import fakecloud "github.com/faiscadev/fakecloud/sdks/go"

fc := fakecloud.New("http://localhost:4566")

Sub-clients are accessed via methods: fc.SES(), fc.SNS(), fc.Lambda(), etc.

Top-level

fc.SES()

fc.SNS()

fc.SQS()

fc.Events()

fc.Scheduler()

fc.Glue()

fc.S3()

fc.Lambda()

fc.RDS()

fc.ElastiCache()

fc.Athena()

fc.ECR()

fc.DynamoDB()

fc.SecretsManager()

fc.Cognito()

fc.ApiGatewayV2()

fc.StepFunctions()

fc.Bedrock()

fc.BedrockAgent() / fc.BedrockAgentRuntime()

fc.ECS()

fc.ELBv2()

fc.Route53()

fc.ACM()

fc.Logs()

fc.ApplicationAutoScaling()

fc.Organizations()

fc.SSM()

fc.KMS()

fc.WAFv2()

fc.CloudFront()

Error handling

Methods return *fakecloud.APIError on non-2xx responses:

_, err := fc.Cognito().ConfirmUser(ctx, fakecloud.ConfirmUserRequest{
    UserPoolID: "pool-1",
    Username:   "nobody",
})
if err != nil {
    var apiErr *fakecloud.APIError
    if errors.As(err, &apiErr) {
        fmt.Println(apiErr.StatusCode) // 404
        fmt.Println(apiErr.Body)
    }
}

Example: end-to-end test

package main_test

import (
    "context"
    "testing"

    "github.com/aws/aws-sdk-go-v2/aws"
    "github.com/aws/aws-sdk-go-v2/config"
    "github.com/aws/aws-sdk-go-v2/service/sqs"
    fakecloud "github.com/faiscadev/fakecloud/sdks/go"
)

func TestAppPublishesToSQS(t *testing.T) {
    ctx := context.Background()
    fc := fakecloud.New("http://localhost:4566")
    if err := fc.Reset(ctx); err != nil {
        t.Fatal(err)
    }

    cfg, _ := config.LoadDefaultConfig(ctx,
        config.WithRegion("us-east-1"),
        config.WithCredentialsProvider(aws.AnonymousCredentials{}),
    )
    sqsClient := sqs.NewFromConfig(cfg, func(o *sqs.Options) {
        o.BaseEndpoint = aws.String("http://localhost:4566")
    })

    _, err := sqsClient.SendMessage(ctx, &sqs.SendMessageInput{
        QueueUrl:    aws.String("http://localhost:4566/000000000000/my-queue"),
        MessageBody: aws.String("hello"),
    })
    if err != nil {
        t.Fatal(err)
    }

    messages, err := fc.SQS().GetMessages(ctx)
    if err != nil {
        t.Fatal(err)
    }
    if len(messages.Messages) != 1 {
        t.Fatalf("expected 1 message, got %d", len(messages.Messages))
    }
    if messages.Messages[0].Body != "hello" {
        t.Fatalf("expected body 'hello', got %q", messages.Messages[0].Body)
    }
}

Source

• sdks/go
• Source README — always-current method list