Anteater Maven Plugin

The Anteater Maven Plugin integrates the Anteater framework into your Maven build with two goals:

ae:run — launch the Anteater desktop application (GUI)
ae:do — execute one or more Anteater recipes from the command line (CLI)

Use ae:run for interactive development and exploration; use ae:do for automation and headless execution.

Getting started

Prerequisites

Java 8+ (java -version)
Apache Maven (mvn -version)
An Anteater-enabled project (or use sample projects):
- https://github.com/ganteater/ae-maven-sample
- https://github.com/ganteater/recipes

Add the plugin to your project

Add the plugin to your project’s pom.xml:

<build>
  <plugins>
    <plugin>
      <groupId>com.ganteater</groupId>
      <artifactId>ae-maven-plugin</artifactId>
      <version>${ae.version}</version>
      <configuration>
        ...
      </configuration>
      <dependencies>
        <!--
        Add additional Anteater plugins to extend functionality.
        See available plugins: https://ganteater.com/ae-plugins/
        -->
        ...
        <!-- Required 3rd Party Dependencies -->
        ...
      </dependencies>
    </plugin>
  </plugins>
</build>

Usage

Launch the desktop application (`ae:run`)

mvn ae:run

Run recipes via CLI (`ae:do`)

Run one or more recipes by name:

mvn ae:do -Drecipes=<recipe_name_1>,<recipe_name_2>

Example:

mvn ae:do -Drecipes=example-recipe.recipe

Pass additional parameters as needed:

mvn ae:do -Drecipes=example-recipe.recipe -DconfigName=<Configuration_Name>

Running without a Maven project

Invoke the plugin directly via coordinates (no pom.xml required):

mvn com.ganteater:ae-maven-plugin:1.2.4:run

Tips

Ensure your recipe files are located where your Anteater configuration expects them.
When a recipe fails, Maven will print error output to help diagnose the issue.