Skip to main content

Install SHAFT

Requirements​

  • SHAFT Engine: 10.2.20260612
  • Java: 25
  • Maven: 3.9+

Generate a project​

mvn archetype:generate \
  "-DarchetypeGroupId=io.github.shafthq" \
  "-DarchetypeArtifactId=testng-archetype" \
  "-DarchetypeVersion=10.1.20260331" \
  "-DinteractiveMode=false" \
  "-DgroupId=com.example" \
  "-DartifactId=shaft-demo"

The generated project includes a test runner, configuration, sample test, and reporting setup. Run it with:

cd shaft-demo
mvn test

Add SHAFT to an existing project​

Import the BOM once, then add the required engine without a separate version:

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>io.github.shafthq</groupId>
      <artifactId>shaft-bom</artifactId>
      <version>10.2.20260612</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>io.github.shafthq</groupId>
    <artifactId>shaft-engine</artifactId>
  </dependency>
</dependencies>

Add optional modules only when the matching capability is used. See the module map before adding providers.

Verify the installation​

mvn test-compile

For an existing uppercase SHAFT_ENGINE dependency, use the automated upgrade guide instead of mixing legacy and modular artifacts.