A JUnit 5 (Jupiter) Extension that manages the lifecycle of an ActorSystem.

This is the JUnit 5 counterpart of ActorSystemResource which uses JUnit 4's org.junit.rules.ExternalResource. It implements BeforeEachCallback and AfterEachCallback to create and terminate the ActorSystem around each test method.

Usage with @RegisterExtension:

@RegisterExtension
ActorSystemExtension systemExtension = new ActorSystemExtension("MyTest", ConfigFactory.empty());

Or use it indirectly through JUnitJupiterRouteTest.

JUnit Jupiter route test base class. Extend this class to write HTTP route tests using JUnit Jupiter annotations (@Test, @BeforeEach, @AfterEach, etc.).

The ActorSystem is managed automatically via ActorSystemExtension. Override additionalConfig to provide custom configuration.

Example usage:

import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;

public class MyRouteTest extends JUnitJupiterRouteTest {
    @Test
    public void testHello() {
        testRoute(get(() -> complete("hello")))
            .run(HttpRequest.GET("/"))
            .assertStatusCode(StatusCodes.OK);
    }
}

A RouteTest that uses JUnit Jupiter assertions. ActorSystem and Materializer lifecycle is managed via ActorSystemExtension, the JUnit Jupiter equivalent of org.junit.rules.ExternalResource.

This is the JUnit Jupiter counterpart of JUnitRouteTest. Migrate your tests from extends JUnitRouteTest to extends JUnitJupiterRouteTest to use JUnit Jupiter annotations and assertions.

A base class to create route tests for testing libraries. An implementation needs to provide code to provide and shutdown an pekko.actor.ActorSystem, pekko.stream.Materializer, and scala.concurrent.ExecutionContextExecutor.

See JUnitRouteTest for an example of a concrete implementation.

A wrapped route that has a run method to run a request through the underlying route to create a TestResponse.

A TestRoute is created by deriving a test class from the concrete RouteTest implementation for your testing framework (like JUnitRouteTest for JUnit) and then using its testRoute method to wrap a route with testing support.

A wrapper for route results.

To support the testkit API, a third-party testing library needs to implement this class and provide implementations for the abstract assertion methods.

A WSProbe is a probe that implements a Flow[Message, Message, Unit] for testing websocket code.

Requesting elements is handled automatically.

A RouteTest that uses JUnit assertions. ActorSystem and Materializer are provided as an org.junit.rules.ExternalResource and their lifetime is automatically managed.