Examples on Verifyica

Simple Tests

Mon, 01 Jan 0001 00:00:00 +0000

Basic test patterns using sequential argument execution.

Sequential Argument Test

Sequential execution processes one argument at a time.

Example Code

package org.verifyica.examples.simple;

import java.util.ArrayList;
import java.util.Collection;
import org.verifyica.api.Verifyica;

public class SequentialArgumentTest {

 @Verifyica.ArgumentSupplier
 public static Object arguments() {
 Collection<String> collection = new ArrayList<>();

 for (int i = 0; i < 10; i++) {
 collection.add("string-" + i);
 }

 return collection;
 }

 @Verifyica.Prepare
 public void prepare() {
 // Called once before all arguments
 System.out.println("prepare()");
 }

 @Verifyica.BeforeAll
 public void beforeAll(String argument) {
 System.out.println("beforeAll() argument [" + argument + "]");
 }

 @Verifyica.BeforeEach
 public void beforeEach(String argument) {
 System.out.println("beforeEach() argument [" + argument + "]");
 }

 @Verifyica.Test
 public void test1(String argument) {
 System.out.println("test1() argument [" + argument + "]");
 }

 @Verifyica.Test
 public void test2(String argument) {
 System.out.println("test2() argument [" + argument + "]");
 }

 @Verifyica.Test
 public void test3(String argument) {
 System.out.println("test3() argument [" + argument + "]");
 }

 @Verifyica.AfterEach
 public void afterEach(String argument) {
 System.out.println("afterEach() argument [" + argument + "]");
 }

 @Verifyica.AfterAll
 public void afterAll(String argument) {
 System.out.println("afterAll() argument [" + argument + "]");
 }

 @Verifyica.Conclude
 public void conclude() {
 // Called once after all arguments
 System.out.println("conclude()");
 }
}

Execution Flow

For 10 arguments, the execution flow is:

Parallel Tests

Mon, 01 Jan 0001 00:00:00 +0000

Examples using parallel execution to run multiple arguments concurrently.

Parallel Argument Test

Parallel execution processes multiple arguments simultaneously.

Example Code

package org.verifyica.examples.simple;

import java.util.ArrayList;
import java.util.Collection;
import org.verifyica.api.Verifyica;

public class ParallelArgumentTest {

 @Verifyica.ArgumentSupplier(parallelism = 2)
 public static Object arguments() {
 Collection<String> collection = new ArrayList<>();

 for (int i = 0; i < 10; i++) {
 collection.add("string-" + i);
 }

 return collection;
 }

 @Verifyica.Prepare
 public void prepare() {
 System.out.println("prepare()");
 }

 @Verifyica.BeforeAll
 public void beforeAll(String argument) {
 System.out.println("beforeAll() argument [" + argument + "]");
 }

 @Verifyica.BeforeEach
 public void beforeEach(String argument) {
 System.out.println("beforeEach() argument [" + argument + "]");
 }

 @Verifyica.Test
 public void test1(String argument) {
 System.out.println("test1() argument [" + argument + "]");
 }

 @Verifyica.Test
 public void test2(String argument) {
 System.out.println("test2() argument [" + argument + "]");
 }

 @Verifyica.Test
 public void test3(String argument) {
 System.out.println("test3() argument [" + argument + "]");
 }

 @Verifyica.AfterEach
 public void afterEach(String argument) {
 System.out.println("afterEach() argument [" + argument + "]");
 }

 @Verifyica.AfterAll
 public void afterAll(String argument) {
 System.out.println("afterAll() argument [" + argument + "]");
 }

 @Verifyica.Conclude
 public void conclude() {
 System.out.println("conclude()");
 }
}

Key Difference from Sequential

The only change from sequential execution is the parallelism parameter:

Interceptor Examples

Mon, 01 Jan 0001 00:00:00 +0000

Examples demonstrating how to use ClassInterceptor to hook into test lifecycle events.

ClassInterceptor Example

Interceptors allow you to inject custom logic around test lifecycle phases.

Custom Interceptor Implementation

package org.verifyica.examples.interceptor;

import java.lang.reflect.Method;
import org.verifyica.api.ArgumentContext;
import org.verifyica.api.ClassInterceptor;
import org.verifyica.api.EngineContext;

public class CustomClassInterceptor2 implements ClassInterceptor {

 @Override
 public void initialize(EngineContext engineContext) throws Throwable {
 System.out.println("initialize()");
 }

 @Override
 public void preTest(ArgumentContext argumentContext, Method testMethod) {
 System.out.println("preTest() test class [" +
 argumentContext.getClassContext().getTestClass().getSimpleName() +
 "] test method [" + testMethod.getName() + "]");
 }

 @Override
 public void postTest(ArgumentContext argumentContext, Method testMethod, Throwable throwable)
 throws Throwable {
 System.out.println("postTest() test class [" +
 argumentContext.getClassContext().getTestClass().getSimpleName() +
 "] test method [" + testMethod.getName() + "]");

 rethrow(throwable);
 }

 @Override
 public void destroy(EngineContext engineContext) throws Throwable {
 System.out.println("destroy()");
 }
}

Test Class Using Interceptor

package org.verifyica.examples.interceptor;

import java.util.ArrayList;
import java.util.Collection;
import org.verifyica.api.ClassInterceptor;
import org.verifyica.api.Verifyica;

public class ClassInterceptorTest {

 @Verifyica.ClassInterceptorSupplier
 public static Collection<ClassInterceptor> classInterceptors() {
 Collection<ClassInterceptor> collections = new ArrayList<>();
 collections.add(new CustomClassInterceptor2());
 return collections;
 }

 @Verifyica.ArgumentSupplier
 public static Object arguments() {
 Collection<String> collection = new ArrayList<>();

 for (int i = 0; i < 10; i++) {
 collection.add("string-" + i);
 }

 return collection;
 }

 @Verifyica.Prepare
 public void prepare() {
 System.out.println("prepare()");
 }

 @Verifyica.BeforeAll
 public void beforeAll(String argument) {
 System.out.println("beforeAll() argument [" + argument + "]");
 }

 @Verifyica.BeforeEach
 public void beforeEach(String argument) {
 System.out.println("beforeEach() argument [" + argument + "]");
 }

 @Verifyica.Test
 public void test1(String argument) {
 System.out.println("test1() argument [" + argument + "]");
 }

 @Verifyica.Test
 public void test2(String argument) {
 System.out.println("test2() argument [" + argument + "]");
 }

 @Verifyica.Test
 public void test3(String argument) {
 System.out.println("test3() argument [" + argument + "]");
 }

 @Verifyica.AfterEach
 public void afterEach(String argument) {
 System.out.println("afterEach() argument [" + argument + "]");
 }

 @Verifyica.AfterAll
 public void afterAll(String argument) {
 System.out.println("afterAll() argument [" + argument + "]");
 }

 @Verifyica.Conclude
 public void conclude() {
 System.out.println("conclude()");
 }
}

Execution Flow

With the interceptor active, execution for each test method follows:

TestContainers Examples

Mon, 01 Jan 0001 00:00:00 +0000

Examples demonstrating how to integrate Verifyica with TestContainers for container-based testing.

Nginx Container Test

This example shows testing multiple Nginx versions in parallel using TestContainers.

Test Environment Class

The NginxTestEnvironment implements Argument<T> to provide test data:

package org.verifyica.examples.testcontainers.nginx;

import java.time.Duration;
import org.testcontainers.containers.Network;
import org.testcontainers.containers.NginxContainer;
import org.testcontainers.utility.DockerImageName;
import org.verifyica.api.Argument;

public class NginxTestEnvironment implements Argument<NginxTestEnvironment> {

 private final String dockerImageName;
 private NginxContainer<?> nginxContainer;

 public NginxTestEnvironment(String dockerImageName) {
 this.dockerImageName = dockerImageName;
 }

 @Override
 public String getName() {
 return dockerImageName;
 }

 @Override
 public NginxTestEnvironment getPayload() {
 return this;
 }

 public void initialize(Network network) {
 nginxContainer = new NginxContainer<>(DockerImageName.parse(dockerImageName))
 .withNetwork(network)
 .withStartupTimeout(Duration.ofSeconds(30));

 try {
 nginxContainer.start();
 } catch (Exception e) {
 nginxContainer.stop();
 throw e;
 }
 }

 public boolean isRunning() {
 return nginxContainer.isRunning();
 }

 public NginxContainer<?> getNginxContainer() {
 return nginxContainer;
 }

 public void destroy() {
 if (nginxContainer != null) {
 nginxContainer.stop();
 nginxContainer = null;
 }
 }
}

Test Class

package org.verifyica.examples.testcontainers.nginx;

import static org.assertj.core.api.Assertions.assertThat;

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.net.URI;
import java.net.URLConnection;
import java.util.stream.Stream;
import org.testcontainers.containers.Network;
import org.verifyica.api.Verifyica;
import org.verifyica.api.util.CleanupExecutor;

public class NginxTest {

 private final ThreadLocal<Network> networkThreadLocal = new ThreadLocal<>();

 @Verifyica.ArgumentSupplier(parallelism = Integer.MAX_VALUE)
 public static Stream<NginxTestEnvironment> arguments() throws IOException {
 return Stream.of(
 new NginxTestEnvironment("nginx:1.25"),
 new NginxTestEnvironment("nginx:1.24"),
 new NginxTestEnvironment("nginx:1.23")
 );
 }

 @Verifyica.BeforeAll
 public void initializeTestEnvironment(NginxTestEnvironment nginxTestEnvironment) {
 System.out.println("[" + nginxTestEnvironment.getName() +
 "] initialize test environment ...");

 Network network = Network.newNetwork();
 network.getId();

 networkThreadLocal.set(network);
 nginxTestEnvironment.initialize(network);

 assertThat(nginxTestEnvironment.isRunning()).isTrue();
 }

 @Verifyica.Test
 @Verifyica.Order(1)
 public void testGet(NginxTestEnvironment nginxTestEnvironment) throws Throwable {
 System.out.println("[" + nginxTestEnvironment.getName() +
 "] testing testGet() ...");

 int port = nginxTestEnvironment.getNginxContainer().getMappedPort(80);

 String content = doGet("http://localhost:" + port);

 assertThat(content).contains("Welcome to nginx!");
 }

 @Verifyica.AfterAll
 public void destroyTestEnvironment(NginxTestEnvironment nginxTestEnvironment)
 throws Throwable {
 System.out.println("[" + nginxTestEnvironment.getName() +
 "] destroy test environment ...");

 new CleanupExecutor()
 .addTask(nginxTestEnvironment::destroy)
 .addTaskIfPresent(networkThreadLocal::get, Network::close)
 .addTask(networkThreadLocal::remove)
 .throwIfFailed();
 }

 private static String doGet(String url) throws Throwable {
 StringBuilder result = new StringBuilder();
 URLConnection connection = URI.create(url).toURL().openConnection();

 try (BufferedReader reader = new BufferedReader(
 new InputStreamReader(connection.getInputStream()))) {
 String line;
 while ((line = reader.readLine()) != null) {
 result.append(line);
 }
 }

 return result.toString();
 }
}

Key Patterns

Unlimited Parallelism

@Verifyica.ArgumentSupplier(parallelism = Integer.MAX_VALUE)

This allows all Nginx versions to be tested concurrently, significantly reducing total test time.