org.junit.jupiter.params.provider

Annotation Type CsvSource

@Target(value={ANNOTATION_TYPE,METHOD})
 @Retention(value=RUNTIME)
 @Documented
 @API(status=EXPERIMENTAL,
     since="5.0")
 @ArgumentsSource(value=CsvArgumentsProvider.class)
public @interface CsvSource

@CsvSource is an ArgumentsSource which reads comma-separated values (CSV) from one or more supplied CSV lines.

The supplied values will be provided as arguments to the annotated @ParameterizedTest method.

Since:

5.0

See Also:

CsvFileSource, ArgumentsSource, ParameterizedTest

Required Element Summary

Required Elements

Modifier and Type	Required Element and Description
java.lang.String[]	value The CSV lines to use as source of arguments; must not be empty.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
char	delimiter The column delimiter to use when reading the lines.
java.lang.String	emptyValue The empty value to use when reading the lines.

Element Detail

value

public abstract java.lang.String[] value

The CSV lines to use as source of arguments; must not be empty.

Each value corresponds to a line in a CSV file and will be split using the specified delimiter.

delimiter

public abstract char delimiter

The column delimiter to use when reading the lines.

Defaults to ','.

Default:

44

emptyValue

@API(status=EXPERIMENTAL,
     since="5.5")
public abstract java.lang.String emptyValue

The empty value to use when reading the lines.

This value replaces quoted empty strings read from the input.

Defaults to "".

Since:

5.5

Default:

""