rewrite-testing

The rewrite-testing module publishes 9 recipes across 3 categories.

testing

Recipes

Convert parameterized types to raw types

io.arconia.rewrite.testing.ConvertToRawType

Converts all parameterized usages of a specified Java class to their raw type. Only exact type matches are converted; subclasses and implementations are not affected.

Table 1. Options
Name Type Required Description

fullyQualifiedTypeName

String

yes

The fully qualified name of the Java class whose parameterized types should be converted to raw types. Only exact matches of this type will be converted; subclasses and implementations are not affected.
Example: org.testcontainers.postgresql.PostgreSQLContainer

Example

Before
import java.util.ArrayList;

class Demo {
    ArrayList<String> items;
}
After
import java.util.ArrayList;

class Demo {
    ArrayList items;
}

testing › junit

Composite recipes

Migrate to JUnit 6.x

io.arconia.rewrite.testing.junit.UpgradeJUnit_6

Migrate a Java application to the latest JUnit 6.x release.

Tags: junit

Recipes applied

  • Add Gradle dependency (org.openrewrite.gradle.AddDependency)

  • Remove a Gradle or Maven dependency (org.openrewrite.java.dependencies.RemoveDependency ×4)

  • Upgrade Gradle or Maven dependency versions (org.openrewrite.java.dependencies.UpgradeDependencyVersion ×2)

  • Upgrade Maven plugin version (org.openrewrite.maven.UpgradePluginVersion ×2)

  • Change type (org.openrewrite.java.ChangeType ×2)

  • Remove annotation (org.openrewrite.java.RemoveAnnotation)

  • Remove annotation attribute (org.openrewrite.java.RemoveAnnotationAttribute)

  • Delete property by key (org.openrewrite.properties.DeleteProperty ×2)

  • Change method name (org.openrewrite.java.ChangeMethodName ×3)

Example

Before
plugins {
    id "java-library"
}

repositories {
    mavenCentral()
}

dependencies {
    testImplementation "org.junit.jupiter:junit-jupiter"
}
After
plugins {
    id "java-library"
}

repositories {
    mavenCentral()
}

dependencies {
    testImplementation "org.junit.jupiter:junit-jupiter"

    testRuntimeOnly "org.junit.platform:junit-platform-launcher"
}

testing › testcontainers

Composite recipes

Migrate Testcontainers CassandraContainer to the 2.x package

io.arconia.rewrite.testing.testcontainers.MigrateCassandraContainer_2

Moves org.testcontainers.containers.CassandraContainer to org.testcontainers.cassandra.CassandraContainer along with its supporting types (CassandraDatabaseDelegate, CassandraQueryWaitStrategy), and converts parameterised usages of the container to raw types.

Tags: testcontainers

Recipes applied

Migrate Testcontainers KafkaContainer to the Apache replacement

io.arconia.rewrite.testing.testcontainers.MigrateKafkaContainer_2

Migrates org.testcontainers.containers.KafkaContainer to org.testcontainers.kafka.KafkaContainer, rewriting any confluentinc/cp-kafka image into apache/kafka-native:latest and inserting an inline note pointing teams that want to stay on Confluent to ConfluentKafkaContainer.

Tags: testcontainers

Recipes applied

Migrate Testcontainers LocalStackContainer to the 2.x package and API

io.arconia.rewrite.testing.testcontainers.MigrateLocalStackContainer_2

Migrates the legacy org.testcontainers.containers.localstack.LocalStackContainer to org.testcontainers.localstack.LocalStackContainer. Rewrites Service enum constants into the plain string names expected by withServices(String…​), collapses getEndpointOverride(…​) into the unified no-arg getEndpoint(), and expands bare-tag constructor arguments into full image names so the 2.x constructor pulls the right image.

Tags: testcontainers

Recipes applied

Migrate to Testcontainers 2.x

io.arconia.rewrite.testing.testcontainers.UpgradeTestcontainers_2

Migrate a Java application to the latest Testcontainers 2.x release.

Tags: testcontainers

Recipes applied

Example

Before
import org.testcontainers.containers.PostgreSQLContainer;

class Demo {
    PostgreSQLContainer<?> postgresContainer = new PostgreSQLContainer<>("postgres:latest");

    PostgreSQLContainer<?> container() {
        return postgresContainer;
    }
}
After
import org.testcontainers.postgresql.PostgreSQLContainer;

class Demo {
    PostgreSQLContainer postgresContainer = new PostgreSQLContainer("postgres:latest");

    PostgreSQLContainer container() {
        return postgresContainer;
    }
}

Replace LocalStackContainer.Service enum constants with string literals

io.arconia.rewrite.testing.testcontainers.MigrateLocalStackServiceEnum_2

Rewrites references to the legacy org.testcontainers.containers.localstack.LocalStackContainer.Service enum constants into the plain string names expected by the Testcontainers 2.x withServices(String…​) API.

Tags: testcontainers

Recipes applied

  • Replace constant with literal value (org.openrewrite.java.ReplaceConstant ×22)

Recipes

Change the image name passed to a Testcontainers container

io.arconia.rewrite.testing.testcontainers.ChangeContainerImageName

Rewrites the image argument of a Testcontainers container constructor when the original image starts with oldImagePrefix. Supports a string literal, DockerImageName.parse(…​) (including chained calls on the parsed instance), and the deprecated new DockerImageName(…​) (one- and two-arg) forms. Non-literal image arguments (e.g. references to constants) are left untouched. When comment is set, a block comment with that text is inserted inline before each rewritten constructor call.

Table 2. Options
Name Type Required Description

containerType

String

yes

Fully qualified name of the container class whose constructor’s image argument should be rewritten.
Example: org.testcontainers.containers.KafkaContainer

oldImagePrefix

String

yes

Literal prefix matched via String.startsWith against the image string passed to the container constructor.
Example: confluentinc/cp-kafka

newImageName

String

yes

Image name (without tag) used to replace the matched image name.
Example: apache/kafka-native

newImageTag

String

no

Image tag used to replace the matched image’s tag. When omitted, the original tag is preserved (and the result has no tag if the original had none).
Example: latest

comment

String

no

Optional block comment inserted inline before each rewritten constructor call. Useful for surfacing a migration note (e.g. suggesting an alternative API). Must not contain */.
Example: To keep using Confluent, switch to ConfluentKafkaContainer.

Example

Before
import org.testcontainers.containers.KafkaContainer;

class Demo {
    KafkaContainer kafka = new KafkaContainer("confluentinc/cp-kafka:7.0");
}
After
import org.testcontainers.containers.KafkaContainer;

class Demo {
    KafkaContainer kafka = new KafkaContainer("apache/kafka-native:latest");
}

Migrate LocalStackContainer bare-version constructor argument

io.arconia.rewrite.testing.testcontainers.MigrateLocalStackImageArg

Rewrites new LocalStackContainer("<tag>") calls — where the string is a bare tag (no /) — into new LocalStackContainer("localstack/localstack:<tag>"). The 1.x constructor treated a single string as a tag; the 2.x constructor expects a full image name.

Example

Before
import org.testcontainers.containers.localstack.LocalStackContainer;

class Demo {
    LocalStackContainer localstack = new LocalStackContainer("0.11.2");
}
After
import org.testcontainers.containers.localstack.LocalStackContainer;

class Demo {
    LocalStackContainer localstack = new LocalStackContainer("localstack/localstack:0.11.2");
}