Skip to content

README.md

Latest commit

 

History

History
45 lines (33 loc) · 1.26 KB

README.md

File metadata and controls

45 lines (33 loc) · 1.26 KB
Raw

Testcontainers LocalStack AWS testing module

Testcontainers module for the Atlassian's LocalStack, 'a fully functional local AWS cloud stack'.

Usage example

Running LocalStack as a stand-in for AWS S3 during a test:

public class SomeTest {

    @Rule
    public LocalStackContainer localstack = new LocalStackContainer()
            .withServices(S3);
    
    @Test
    public void someTestMethod() {
        AmazonS3 s3 = AmazonS3ClientBuilder
                        .standard()
                        .withEndpointConfiguration(localstack.getEndpointConfiguration(S3))
                        .withCredentials(localstack.getDefaultCredentialsProvider())
                        .build();
        
                s3.createBucket("foo");
                s3.putObject("foo", "bar", "baz");

Dependency information

Replace VERSION with the latest version available on Maven Central.

Maven

<dependency>
    <groupId>org.testcontainers</groupId>
    <artifactId>localstack</artifactId>
    <version>VERSION</version>
</dependency>

Gradle

compile group: 'org.testcontainers', name: 'localstack', version: 'VERSION'