Package de.cuioss.test.generator.junit.parameterized

package de.cuioss.test.generator.junit.parameterized

JUnit 5 Parameterized Test Support for TypedGenerator

This package provides JUnit 5 extensions that enable seamless integration of TypedGenerator instances with JUnit 5's parameterized testing framework. These extensions allow developers to use TypedGenerator implementations to generate test data for parameterized tests.

This package extends the functionality provided in the parent package de.cuioss.test.generator.junit by adding specific support for JUnit 5's parameterized testing features.

Common Parameters

All annotations in this package support the following common parameters:

• count - Specifies the number of test instances to generate. This controls how many test invocations will occur with different generated values. Defaults to 1 in most annotations.
• seed - An optional seed value for reproducible tests. When specified (not -1), this seed will be used for the generator instead of the seed managed by GeneratorControllerExtension. This is useful for tests that need specific generated values regardless of the global seed configuration.

Available Annotations

The package provides the following annotations for different use cases:

• TypeGeneratorSource - Uses a TypedGenerator implementation directly via its class.
• TypeGeneratorMethodSource - Uses a method that returns a configured TypedGenerator instance.
• TypeGeneratorFactorySource - Uses a factory class with a static method to create a TypedGenerator instance.
• CompositeTypeGeneratorSource - Combines multiple TypedGenerator implementations to generate combinations of values.

Integration with JUnit 5

These annotations are designed to be used with JUnit 5's @ParameterizedTest annotation. They provide ArgumentsProvider implementations that generate test arguments from TypedGenerator instances.

For detailed usage examples, refer to the documentation of each annotation.

Since:

2.0

Author:

Oliver Wolff

See Also:

• TypedGenerator
• ParameterizedTest
• EnableGeneratorController
• GeneratorSeed
• GeneratorControllerExtension

Related Packages

Package	Description
de.cuioss.test.generator.junit	Provides JUnit 5 integration for the CUI test generator framework.

Class	Description
AbstractTypedGeneratorArgumentsProvider	Abstract base class for TypedGenerator-based ArgumentsProviders.
CompositeTypeGeneratorArgumentsProvider	Implementation of ArgumentsProvider that provides arguments from multiple TypedGenerator instances for parameterized tests annotated with CompositeTypeGeneratorSource.
CompositeTypeGeneratorSource	@CompositeTypeGeneratorSource is an ArgumentsSource that provides access to values from multiple TypedGenerator implementations for parameterized tests, generating combinations of values.
GeneratorsSource	@GeneratorsSource is a variant of TypeGeneratorFactorySource that always uses Generators as the factory class for creating TypedGenerator instances for parameterized tests.
GeneratorsSourceArgumentsProvider	Implementation of ArgumentsProvider that provides arguments from a TypedGenerator created by the Generators utility class for parameterized tests annotated with GeneratorsSource.
GeneratorType	Enum representing all available generator types from the Generators class.
TypeGeneratorArgumentsProvider	Implementation of ArgumentsProvider that provides arguments from a TypedGenerator for parameterized tests annotated with TypeGeneratorSource.
TypeGeneratorFactoryArgumentsProvider	Implementation of ArgumentsProvider that provides arguments from a TypedGenerator created by a factory class for parameterized tests annotated with TypeGeneratorFactorySource.
TypeGeneratorFactorySource	@TypeGeneratorFactorySource is an ArgumentsSource that provides access to values from a TypedGenerator created by a factory class for parameterized tests.
TypeGeneratorMethodArgumentsProvider	Implementation of ArgumentsProvider that provides arguments from a TypedGenerator returned by a method for parameterized tests annotated with TypeGeneratorMethodSource.
TypeGeneratorMethodSource	@TypeGeneratorMethodSource is an ArgumentsSource that provides access to values from a TypedGenerator returned by a factory method for parameterized tests.
TypeGeneratorSource	@TypeGeneratorSource is an ArgumentsSource that provides access to values from a TypedGenerator implementation for parameterized tests.