Getting Started on Verifyica

Installation

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

Overview

Verifyica is available on Maven Central and can be added to your project using Maven. You need to add two dependencies:

verifyica-api - Contains annotations and API classes
verifyica-engine - The JUnit Platform based TestEngine implementation

Maven

Add the following dependencies to your pom.xml:

<dependencies>
 
 <!-- Verifyica API (compile scope for annotations) -->
 <dependency>
 <groupId>org.verifyica</groupId>
 <artifactId>verifyica-api</artifactId>
 <version>1.0.6</version>
 </dependency>

 <!-- Verifyica Engine (test scope) -->
 <dependency>
 <groupId>org.verifyica</groupId>
 <artifactId>verifyica-engine</artifactId>
 <version>1.0.6</version>
 <scope>test</scope>
 </dependency>

</dependencies>

Maven Surefire Configuration

Configure the Maven Surefire plugin to ignore Verifyica tests (they will be run by the Verifyica Maven Plugin):

Quick Start

Sun, 15 Feb 2026 00:00:00 +0000

This guide will walk you through creating and running your first Verifyica test.

Your First Test

Create a new test class with the following code:

package com.example.tests;

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

public class MyFirstTest {

 // Arguments are tested in parallel by default
 @Verifyica.ArgumentSupplier
 public static Object arguments() {
 Collection<String> collection = new ArrayList<>();
 for (int i = 0; i < 5; i++) {
 collection.add("argument-" + i);
 }
 return collection;
 }

 @Verifyica.BeforeAll
 public void beforeAll(String argument) {
 System.out.println("Setting up for: " + argument);
 }

 @Verifyica.Test
 public void testWithArgument(String argument) {
 System.out.println("Testing with: " + argument);
 assert argument != null;
 assert argument.startsWith("argument-");
 }

 @Verifyica.AfterAll
 public void afterAll(String argument) {
 System.out.println("Cleaning up: " + argument);
 }
}

Understanding the Test

Let’s break down what’s happening:

Your First Test

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

This guide provides a comprehensive walkthrough of creating Verifyica tests, explaining each component in detail.

Test Class Structure

A Verifyica test class is a plain Java class with annotated methods. Unlike JUnit Jupiter tests that use @Test on every test method, Verifyica tests use several annotations to define the complete lifecycle.

Basic Structure

package com.example.tests;

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

public class MyFirstTest {

 // Arguments are tested in parallel by default
 @Verifyica.ArgumentSupplier
 public static Object arguments() {
 Collection<String> collection = new ArrayList<>();
 for (int i = 0; i < 5; i++) {
 collection.add("argument-" + i);
 }
 return collection;
 }

 /**
 * The actual test.
 */
 @Verifyica.Test
 public void testWithArgument(String argument) {
 System.out.println("Testing with: " + argument);
 assert argument != null;
 assert argument.startsWith("argument-");
 }
}

Required Elements

A minimal Verifyica test requires: