cloud.localstack.docker

Class LocalstackDockerTestRunner

java.lang.Object

org.junit.runner.Runner

org.junit.runners.ParentRunner<org.junit.runners.model.FrameworkMethod>

org.junit.runners.BlockJUnit4ClassRunner

cloud.localstack.docker.LocalstackDockerTestRunner

All Implemented Interfaces:

org.junit.runner.Describable, org.junit.runner.manipulation.Filterable, org.junit.runner.manipulation.Sortable

public class LocalstackDockerTestRunner
extends org.junit.runners.BlockJUnit4ClassRunner

JUnit test runner that automatically pulls and runs the latest localstack docker image and then terminates when tests are complete. Having docker installed is a prerequisite for this test runner to execute. If docker is not installed in one of the default locations (C:\program files\docker\docker\resources\bin\, usr/local/bin or usr/bin) then use the DOCKER_LOCATION environment variable to specify the location. Since ports are dynamically allocated, the external port needs to be resolved based on the default localstack port. The hostname defaults to localhost, but in some environments that is not sufficient, so the HostName can be specified by using the LocalstackDockerProperties annotation with an IHostNameResolver.

Author:

Alan Bevier

Constructor Summary

Constructors

Constructor and Description
LocalstackDockerTestRunner(Class<?> klass)

Method Summary

Modifier and Type	Method and Description
static String	endpointForPort(int port)
static String	endpointForService(String serviceName)
static String	getEndpointAPIGateway()
static String	getEndpointCloudFormation()
static String	getEndpointCloudWatch()
static String	getEndpointDynamoDB()
static String	getEndpointDynamoDBStreams()
static String	getEndpointElasticsearch()
static String	getEndpointElasticsearchService()
static String	getEndpointFirehose()
static String	getEndpointKinesis()
static String	getEndpointLambda()
static String	getEndpointRedshift()
static String	getEndpointRoute53()
static String	getEndpointS3()
static String	getEndpointSES()
static String	getEndpointSNS()
static String	getEndpointSQS()
static String	getEndpointSSM()
static Container	getLocalStackContainer()
void	run(org.junit.runner.notification.RunNotifier notifier)

Methods inherited from class org.junit.runners.BlockJUnit4ClassRunner

collectInitializationErrors, computeTestMethods, createTest, describeChild, getChildren, getTestRules, isIgnored, methodBlock, methodInvoker, possiblyExpectingExceptions, rules, runChild, testName, validateConstructor, validateFields, validateInstanceMethods, validateNoNonStaticInnerClass, validateOnlyOneConstructor, validateTestMethods, validateZeroArgConstructor, withAfters, withBefores, withPotentialTimeout

Methods inherited from class org.junit.runners.ParentRunner

childrenInvoker, classBlock, classRules, createTestClass, filter, getDescription, getName, getRunnerAnnotations, getTestClass, runLeaf, setScheduler, sort, validatePublicVoidNoArgMethods, withAfterClasses, withBeforeClasses

Methods inherited from class org.junit.runner.Runner

testCount

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

LocalstackDockerTestRunner

public LocalstackDockerTestRunner(Class<?> klass)
                           throws org.junit.runners.model.InitializationError

Throws:

org.junit.runners.model.InitializationError

Method Detail

getLocalStackContainer

public static Container getLocalStackContainer()

run

public void run(org.junit.runner.notification.RunNotifier notifier)

Overrides:

run in class org.junit.runners.ParentRunner<org.junit.runners.model.FrameworkMethod>

getEndpointS3

public static String getEndpointS3()

getEndpointKinesis

public static String getEndpointKinesis()

getEndpointLambda

public static String getEndpointLambda()

getEndpointDynamoDB

public static String getEndpointDynamoDB()

getEndpointDynamoDBStreams

public static String getEndpointDynamoDBStreams()

getEndpointAPIGateway

public static String getEndpointAPIGateway()

getEndpointElasticsearch

public static String getEndpointElasticsearch()

getEndpointElasticsearchService

public static String getEndpointElasticsearchService()

getEndpointFirehose

public static String getEndpointFirehose()

getEndpointSNS

public static String getEndpointSNS()

getEndpointSQS

public static String getEndpointSQS()

getEndpointRedshift

public static String getEndpointRedshift()

getEndpointSES

public static String getEndpointSES()

getEndpointRoute53

public static String getEndpointRoute53()

getEndpointCloudFormation

public static String getEndpointCloudFormation()

getEndpointCloudWatch

public static String getEndpointCloudWatch()

getEndpointSSM

public static String getEndpointSSM()

endpointForService

public static String endpointForService(String serviceName)

endpointForPort

public static String endpointForPort(int port)