Skip to content

Overview

JUnit Converters is a collection of ready-to-use argument converters designed to streamline parameterized testing in the JUnit Framework.

It uses the framework's explicit argument conversion mechanism to provide converters for common data types and patterns. This simplifies the process of transforming input arguments into the types required by the test, allowing you to write clear test cases without clutter.

Compatibility

JUnit Converters is based on the JUnit Framework 5 and requires Java 8 or higher.

Compatibility is also guaranteed with the JUnit Framework 6.

Getting Started

JUnit Converters

<dependency>
  <groupId>io.github.scordio</groupId>
  <artifactId>junit-converters</artifactId>
  <version>${junit-converters.version}</version>
  <scope>test</scope>
</dependency>

testImplementation("io.github.scordio:junit-converters:${junitConvertersVersion}")

Converters

The following converters are available:

  • @Base64: decodes Base64 instances into byte arrays
  • @Bytes: converts strings or numbers into byte arrays
  • @Hex: decodes hexadecimal strings into byte arrays
  • @SpringConversion: converts instances using the Spring Framework type conversion

Do you have in mind another converter for your use case? Raise an issue!