Maya

Maya (/ˈmɑːjə/, माया), literally "illusion" or "magic". In Vedic texts it connotes a "magic show, an illusion where things appear to be present, but are not what they seem".

This project provides classes for easier integration testing, simulating external environment.

features

SQS emulator
- Standard and FIFO queues support
- SqsMessageSender for publishing messages from tests.

Installation

Add a dependency to your project.

Gradle:

dependencies {
    testImplementation("com.github.kpavlov.maya:maya:${latestVersion}")
}

Maven:

<dependency>
  <groupId>com.github.kpavlov.maya</groupId>
  <artifactId>maya</artifactId>
  <version>${latestVersion}</version>
</dependency>

Local SQS Simulator

LocalSqs starts local SQS server using ElasticMQ Docker container.

Make sure that docker daemon is running on your machine.

It can be customized by creating configuration file and storing it in the test classpath. Configuration parameters are described here.

// Create and start local SQS Server
val sqs = LocalSqs(configPath="sqs-queues.conf")
sqs.start()

// Create SQS client connected to local SQS server
val sqsClient = SqsAsyncClient.builder()
    .endpointOverride(URI.create(sqs.endpointUrl()))
    .region(Region.US_EAST_1)
    .build()

// Create SqsMessageSender for Standard SQS Queue
val sender = SqsMessageSender<String>(
    sqsClient, 
    queueName = "test-queue",
    messageEncoder = identity()
)

// Send message to Standard queue
val messageId = sender.sendMessageAsync("Hello, World!").await()

// Create SqsMessageSender for Standard SQS Queue
val fifoSender = SqsMessageSender<String>(
    sqsClient,
    queueName = "test-queue.fifo",
    messageEncoder = Function.identity() ,
    messageGroupIdExtractor = { it.substring(0, 5) },
    messageDeduplicationIdExtractor = { it.hashCode().toString() }
)

// Send message to FIFO queue
val messageId = fifoSender.sendMessageAsync("Hello, FIFO World!").await()

// run some tests...

sqs.stop()

It is recommended to start SQS server only once before running all tests. With JUnit5 you should run it in java static initializer, to make sure it is started before all tests in all classes.

Playground for Vault Integration

Vault Lab This is playground for spring-booter to test integrating with Vault the Hashi-Corp product. Secret-Engines that are available now: Transit :

1 Apr 6, 2022

API for a library using Kotlin, Spring-boot and covered by test

Library API This API is to create Books and be able to borrow from them I'm using: Spring Boot version 2.5.6 Kotlin 1.5.31 Java 11 I'm implementing us