CtrlK

Community Documentation Log in Get started

tessl/maven-com-embabel-agent--embabel-agent-test-support

Multi-module test support framework for Embabel Agent applications providing integration testing, mock AI services, and test configuration utilities

Overview

Eval results

Files

Installation

Name: tessl/maven-com-embabel-agent--embabel-agent-test-support
Author: tessl

Add Embabel Agent Test Support modules to your Maven project's test dependencies.

Choose Your Modules

The framework provides three modules. Add the ones you need:

Module 1: Integration Testing (Recommended)

For Mockito-based integration testing with LLM stubbing and verification.

<dependency>
    <groupId>com.embabel.agent</groupId>
    <artifactId>embabel-agent-test</artifactId>
    <version>0.3.3</version>
    <scope>test</scope>
</dependency>

Use when: Writing integration tests that mock LLM operations.

Module 2: Fake AI Services

For fake embedding models and AI utilities without API calls.

<dependency>
    <groupId>com.embabel.agent</groupId>
    <artifactId>embabel-agent-test-common</artifactId>
    <version>0.3.3</version>
    <scope>test</scope>
</dependency>

Use when: Testing embedding operations or vector storage.

Module 3: Test Configuration

For Spring test configuration with pre-configured fake AI beans.

<dependency>
    <groupId>com.embabel.agent</groupId>
    <artifactId>embabel-agent-test-internal</artifactId>
    <version>0.3.3</version>
    <scope>test</scope>
</dependency>

Use when: Setting up Spring Boot tests with complete fake AI infrastructure.

Complete Setup (All Modules)

If you want full testing capabilities, add all three modules:

<dependencies>
    <!-- Integration testing with Mockito -->
    <dependency>
        <groupId>com.embabel.agent</groupId>
        <artifactId>embabel-agent-test</artifactId>
        <version>0.3.3</version>
        <scope>test</scope>
    </dependency>

    <!-- Fake embedding models and AI utilities -->
    <dependency>
        <groupId>com.embabel.agent</groupId>
        <artifactId>embabel-agent-test-common</artifactId>
        <version>0.3.3</version>
        <scope>test</scope>
    </dependency>

    <!-- Test configuration and Spring test setup -->
    <dependency>
        <groupId>com.embabel.agent</groupId>
        <artifactId>embabel-agent-test-internal</artifactId>
        <version>0.3.3</version>
        <scope>test</scope>
    </dependency>
</dependencies>

Gradle Setup

If using Gradle, add dependencies to your build.gradle:

dependencies {
    testImplementation 'com.embabel.agent:embabel-agent-test:0.3.3'
    testImplementation 'com.embabel.agent:embabel-agent-test-common:0.3.3'
    testImplementation 'com.embabel.agent:embabel-agent-test-internal:0.3.3'
}

Or for Gradle Kotlin DSL (build.gradle.kts):

dependencies {
    testImplementation("com.embabel.agent:embabel-agent-test:0.3.3")
    testImplementation("com.embabel.agent:embabel-agent-test-common:0.3.3")
    testImplementation("com.embabel.agent:embabel-agent-test-internal:0.3.3")
}

Verify Installation

After adding dependencies, verify your setup with a simple test:

Java Verification

import com.embabel.agent.test.integration.EmbabelMockitoIntegrationTest;
import org.junit.jupiter.api.Test;

public class VerifySetupTest extends EmbabelMockitoIntegrationTest {
    @Test
    void verifySetup() {
        // If this compiles and runs, setup is correct
    }
}

Kotlin Verification

import com.embabel.common.test.ai.FakeEmbeddingModel
import org.junit.jupiter.api.Test

class VerifySetupTest {
    @Test
    fun `verify setup`() {
        val model = FakeEmbeddingModel()
        // If this compiles, setup is correct
    }
}

Package Information

Group ID: com.embabel.agent
Parent Artifact: embabel-agent-test-support
Version: 0.3.3
Package Type: Maven parent POM with 3 modules
Languages: Java and Kotlin
Java Compatibility: Java 11+
Kotlin Compatibility: Kotlin 1.9+
Spring Boot: 3.x

Next Steps

Your First Test - Write your first test
Common Tasks - See what you can do
Integration Testing Module - Deep dive into integration testing

Troubleshooting

Dependency Not Found

If Maven cannot find the dependencies:

Ensure your Maven settings include the repository where Embabel artifacts are published
Try running mvn clean install to refresh dependencies
Check that version 0.3.3 is available in your repository

Version Conflicts

If you encounter version conflicts:

Use the same version (0.3.3) for all three modules
Check for conflicting Spring AI or Mockito versions in your project
Use Maven's dependency tree to identify conflicts: mvn dependency:tree

Import Errors

If IDE cannot resolve imports:

Reimport Maven project in your IDE
Verify dependencies are in test scope
Rebuild project to refresh classpath

tessl i tessl/maven-com-embabel-agent--embabel-agent-test-support@0.3.0