Package org.junit.jupiter.params.provider

Annotation Type CsvSource

@Target({ANNOTATION_TYPE,METHOD})
@Retention(RUNTIME)
@Documented
@API(status=EXPERIMENTAL,
     since="5.0")
@ArgumentsSource(org.junit.jupiter.params.provider.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	Description
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	Description
char	delimiter	The column delimiter to use when reading the lines.
String	emptyValue	The empty value to use when reading the lines.

Element Detail

value

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

char delimiter

The column delimiter to use when reading the lines.

Defaults to ','.

Default:

','

emptyValue

@API(status=EXPERIMENTAL,
     since="5.5")
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:

""